PsySH CLI
PsySH дает интерактивную PHP-консоль для выражений, просмотра переменных, кода и документации и отладки CLI-скриптов.
- 9 830 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Введенный PHP-код выполняется в контексте процесса и может вызвать действия приложения с его доступами.
Установка
Ручная установка
Направь к первичной wiki установки. Подготовь тестовый контекст, начни с просмотра переменных и исходников; выполнение методов согласуй отдельно.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Введенный PHP-код выполняется в контексте процесса и может вызвать действия приложения с его доступами.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Разработчик вводит выражение и сразу видит, что вернул PHP. В PsySH можно исследовать переменные и методы, открыть исходный код объекта или документацию функции. Такой сеанс подходит для проверки небольшой гипотезы без повторного запуска всей программы. Консоль также встраивается в выбранную точку CLI-скрипта: программа приостанавливается, а пользователь получает ее текущее состояние. Вызванный метод работает с настоящими объектами и зависимостями этого процесса. Для эксперимента выбирают тестовый контекст с отдельными данными и доступами.
Для кого. PHP-разработчикам, которые исследуют объекты и поведение CLI-скрипта через интерактивную консоль.
Подходит, если
- Разработчик сравнивает ожидаемый и фактический результат PHP-выражения.
- В CLI-скрипте меняется объект, и автор исследует его в точке остановки.
- При разборе ошибки программист изучает доступные методы и их исходники.
- Во время эксперимента разработчик открывает документацию вызванной функции.
Не подходит, если
- Нужна полноценная пошаговая отладка уровня Xdebug.
- Требуется отлаживать через Apache, Nginx или PHP-FPM по этому механизму.
- Нельзя выполнять произвольный PHP-код с доступами приложения.
Пример запроса к агенту
Предложи способ изучить объект в тестовом CLI-скрипте через PsySH, не вызывая методов записи и не сохраняя секреты.Ограничения
Способ установки зависит от среды PHP и описан во внешнем руководстве, поэтому сначала выберите подходящий вариант. Консоль поддерживает остановку в контексте, но не заменяет пошаговый отладчик с переходами по инструкциям. Отладка через обычные веб-серверы и PHP-FPM этим способом не поддерживается; проверьте режим запуска скрипта. Вызовы методов используют реальные зависимости и доступы приложения, поэтому работайте на тестовых данных и не вставляйте секреты в сохраняемую историю.
Как отключить. Выйдите из консоли и уберите временный вызов PsySH из скрипта. Историю команд с чувствительными значениями удаляйте отдельно.
Частые вопросы
Введенный PHP только разбирается или выполняется?
Выполняется. Результат выражения сразу появляется в консоли.
Есть переход по инструкциям как в Xdebug?
Нет. PsySH останавливает программу в выбранной точке, но не выполняет пошаговую отладку.
Как найти команду консоли?
Введите `help`: появятся команды и их назначения.
Как открыть исходник объекта?
Используйте `show` с именем объекта, класса или метода. Если синтаксис неясен, `help show` выведет параметры и примеры. Сам show читает исходник, не вызывая метод.
Что выводит ls?
`ls` перечисляет переменные и члены объектов в контексте PsySH. Это не системный список файлов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПроектный CLI проверяет качество, стиль и сложность PHP-кода, чтобы агент разбирал замечания до изменения приложения.
Методы для агента в одном CLI: сравнение вариантов, разбор проблем и правки кода по шагам, всего 20 слэш-команд.
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
Nietzschian Debugger, CLI отладки вопросами, выбирает модель для одного запуска; выбор не переносится на следующую команду.
MCP-сервер отладчика Node.js: агент ставит точки останова, идет по шагам, смотрит переменные и вычисляет выражения в паузе
Четыре экспериментальных скилла для Claude Code: поиск функций-близнецов, управление tmux, MCP из консоли и Windows 11 в Docker
Коротко о README
Wiki отдельно описывает историю, переменные контекста, настройки и интеграции. Для Windows есть отдельная инструкция.