php2shell-checker README

README проекта с github.com/openai/php2shell-checker. Одним файлом markdown: README.md.

PHP Version Checker

Get a version-based PHP2Shell warning from a website's PHP headers or local installation.

To install both skills, ask Codex:

$skill-installer install both skills from https://github.com/openai/php2shell-checker

Use phpcheck-server when you have server access, or phpcheck-url when you only have a URL:

$phpcheck-url check https://example.com
$phpcheck-server check the PHP version serving my site

Run directly

Check a website:

node phpcheck.js "https://example.com"

Results

Result Exit code Meaning
OK 0 Advertised version meets an upstream fixed release.
POTENTIALLY VULNERABLE 1 Advertised version is in an affected range.
UNKNOWN 3 Missing or unrecognized version, prerelease, or failed check.

Use --json for machine-readable output. patch_status is ok, potentially_vulnerable or unknown. Invalid arguments exit with code 2.

Versions below a listed upstream fix return potentially_vulnerable and exit 1. PHP 5.4–5.6, 7.0–7.4, 8.0 and 8.1 also return this warning, even with a higher patch number such as 8.1.35.

URL checks

URL mode reads X-Powered-By and Server, sends HEAD, and falls back to GET only when HEAD returns 405 or 501. It does not follow redirects or inspect response bodies. Missing or hidden PHP headers return UNKNOWN.

The upstream fixed releases are 8.2.35, 8.3.36, 8.4.27 and 8.5.12, from the October 21 PHP advisory. HTTP headers cannot tell whether the version contains a backported fix. Even OK only describes the advertised version - it doesn't verify the installation! The checker does not send exploit probes.

Contributing

OpenAI is not accepting external code contributions to this project. Bug reports and non-code feedback are welcome through GitHub issues. See CONTRIBUTING.md.

License

This project is licensed under the Apache License 2.0.

php2shell-checker (openai/php2shell-checker)

Ищем в базе…

Что это такое?Инструмент командной строки (вместе с соответствующими навыками для Codex), который проверяет по сообщённым номерам версий, работает ли PHP-сайт или локальный бинарник php с версией, уязвимой для php2shell.
Это самостоятельный CLI или для работы нужен Codex?Работает в обоих вариантах: можно запустить CLI напрямую или установить его как два навыка Codex: phpcheck-server, если у вас есть доступ к серверу, и phpcheck-url, если есть только адрес сайта.
Как проверить сайт или локальный бинарник PHP?Запустите CLI с адресом сайта или с локальным исполняемым файлом php; добавьте --json, чтобы получить вывод в машинночитаемом виде вместо обычного текста.
Нужна ли настоящая установка PHP, чтобы попробовать?Нет, тесты работают полностью на локальных поддельных HTTP-серверах и поддельном исполняемом файле php, так что для пробного запуска проверки не нужны ни установленный PHP, ни внешний сайт.
Насколько надёжен вердикт VULNERABLE или OK?Инструмент читает версию только из заголовков HTTP-ответа (X-Powered-By, Server) или из вывода 'php -v', никогда не переходит по редиректам и не проверяет тела ответов, а результат OK лишь предполагает, что более поздние исправления в этой ветке содержат исправление, а не подтверждает его.
Что на самом деле означают результаты OK, VULNERABLE и UNKNOWN?OK (код выхода 0) означает, что обнаруженный патч PHP выше встроенной границы для его ветки; VULNERABLE (код выхода 1) означает, что он равен этой границе или ниже её; UNKNOWN (код выхода 3) означает, что пригодную версию определить не удалось, например из-за скрытого заголовка или неизвестной ветки.
Означает ли результат UNKNOWN, что цель безопасна?Нет. В README прямо предупреждается, что UNKNOWN не означает, что цель исправлена, - это значит только, что проверка не смогла определить версию.
Может ли сервер скрыть или подменить свою реальную версию PHP от этой проверки?Да: инструмент опирается на заголовки вроде X-Powered-By и Server или на вывод php -v, а в README отмечено, что их можно скрыть, изменить или что на них влияют бэкпорты дистрибутивов, которые не обновляют сообщаемую версию.
Автор
openai
Размер
<0.1 MB
Звёзды
1.5K
Обновлён
КоммитOct 22
Возраст
28 д
Коммиты · 90 дней