К основному содержанию
субагент CX Codex

php-pro · voltagent/awesome-codex-subagents — субагент для Codex: PHP-разработка и отладка

Субагент php-pro для работы с PHP-кодом: помогает разобраться в логике приложения, интегрировать фреймворки, отладить runtime-ошибки и безопасно менять серверный код. Подходит, когда нужна глубокая экспертиза в PHP, а не просто синтаксис.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/php-pro.toml
Открыть на GitHub

Что делает php-pro

php-pro анализирует PHP-приложение как работающую систему, а не как текст. Сначала отображает границы выполнения: откуда приходит запрос, как движется состояние, какие зависимости снаружи. Потом ищет корневую причину проблемы или пробел в архитектуре, прежде чем менять код.

Фокусируется на том, что реально работает в production: валидация на входе, обработка ошибок, безопасность БД и транзакции, автозагрузка и namespace-ы, совместимость с версией PHP проекта. Предлагает самые маленькие правки, которые решают проблему и не сломают окружающий код.

Проверяет всё, что может: поведение на корректных данных и граничные случаи, консистентность записей при сбоях, разрешение namespace-ов, стабильность ошибок для вызывающего кода. Честно говорит, что нужно проверить на сервере перед деплоем, и какие риски остались.

Какие задачи решает

  • разобраться в логике обработки запроса и потока данных
  • найти баг в PHP-коде и понять, почему он происходит
  • безопасно изменить код, не сломав то, что работает рядом
  • настроить интеграцию с фреймворком или библиотекой
  • проверить обработку ошибок и граничные случаи

Примеры запросов агенту

  • Почему в /api/users возвращается пустой массив, хотя в БД есть данные?
  • Помогите отладить исключение PDOException при вставке в таблицу orders.
  • Нужно добавить кэширование результатов запроса, не трогая остальной код.

Как установить php-pro

Вручную: положить файлы

.codex/agents/php-pro.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о php-pro

Как установить php-pro в Codex?

Создай файл .codex/agents/php-pro.toml в корне проекта. Codex подхватит конфиг при следующей загрузке рабочей папки.

Что делает php-pro?

Анализирует PHP-приложение как исполняемую систему: отображает границы выполнения, ищет корневые причины ошибок, предлагает минимальные правки, которые не сломают существующий код. Проверяет валидацию данных, обработку ошибок, безопасность БД и совместимость с PHP-версией проекта.

Когда нужен php-pro, а когда обычный PHP-ассистент?

php-pro помогает, когда ошибка скрывается в граничных случаях, в потоке данных между модулями или в runtime-поведении. Если нужен просто синтаксис или быстрый фрагмент кода, подойдёт и встроенный помощник.

Исходный текст

php-pro.toml · MIT
# php-pro

Use when a task needs PHP expertise for application logic, framework integration, runtime debugging, or server-side code evolution.

Own PHP tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- clear application-layer boundaries and predictable control flow
- input validation and sanitization at request boundaries
- error handling consistency across exceptions and return values
- database interaction safety and transaction semantics
- autoloading/namespacing correctness in touched modules
- runtime compatibility with project PHP version constraints
- incremental fixes that preserve established framework/runtime patterns

Quality checks:
- verify behavior for valid input and at least one invalid edge case
- confirm database writes are consistent under partial failure conditions
- check autoloading and namespace resolution for changed classes
- ensure response/error surfaces remain stable for callers
- call out deployment/runtime assumptions requiring environment checks

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not apply broad stylistic or architectural rewrites while fixing scoped behavior unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — php-pro от других авторов.

php-pro VoltAgent Community Субагент php-pro для работы с PHP 8.3+, Laravel и Symfony с акцентом на строгую типизацию, проверку PHPStan девятого уровня и асинхронные шаблоны. CX Codex 2 019установок php-pro Seth Hobson Субагент php-pro помогает писать быстрый и типобезопасный код на PHP 8+. Использует генераторы, структуры SPL и возможности стандартной библиотеки без лишних внешних пакетов. CX Codex 2 019установок php-development Mindrally Скилл php-development для Claude Code, Codex, Cursor и других агентов, который задаёт стиль PHP 8+ с типизацией, PSR-12 и SOLID. Генерирует код с declare(strict_types=1), PHPDoc-блоками и prepared statements. CX Codex +1 1 100установок php-best-practices php-community Скилл php-best-practices для Claude Code содержит 51 правило проверки PHP 8.0–8.5 по PSR, SOLID и строгой типизации. Используется при код-ревью и рефакторинге классов. CX Codex +1 3 900установок spatie-laravel-php Spatie Скилл spatie-laravel-php настраивает правила кодинга Spatie и PSR-12 для задач по созданию, рефакторингу и ревью PHP-кода или шаблонов Blade в проектах на Laravel. CX Codex +1 1 400установок php-code-review-expert Giuseppe Trisciuoglio Субагент php-code-review-expert проверяет код на PHP 8.3+, Laravel и Symfony. Находит уязвимости, проблемы с типами и ошибки в ORM, отсеивая сомнительные замечания. CX Codex ★ 372звёзд репо php-software-architect-expert Giuseppe Trisciuoglio php-software-architect-expert — субагент для Claude Code, который разбирает архитектуру PHP-проектов. Его подключают для проверки Clean Architecture, DDD и решений по структуре кода. CX Codex ★ 372звёзд репо php-mcp-server-generator официальный github Скилл php-mcp-server-generator для GitHub Copilot генерирует PHP-проект MCP-сервера с инструментами, ресурсами, промптами и тестами. Собирает основу сервера под свои задачи. CX Codex +1 8 900установок

Из того же набора176

Весь набор →
rails-expert Субагент rails-expert для Codex разбирает изменения в Ruby on Rails — от маршрута и модели до ответа клиенту. Ищет причины ошибок и предлагает небольшие правки без перестройки архитектуры. CX Codex ★ 6 505звёзд репо python-pro Субагент python-pro для задач, где нужно разбираться в поведении Python кода на исполнение, типизацию, тестирование и архитектуру пакетов. Работает с точными границами входа-выхода, а не общими рекомендациями. CX Codex ★ 6 505звёзд репо powershell-7-expert Субагент powershell-7-expert помогает писать надёжные скрипты на PowerShell 7 для Linux, macOS и Windows, настраивать пайплайны и интеграцию с .NET. CX Codex ★ 6 505звёзд репо powershell-5.1-expert Субагент powershell-5.1-expert помогает разбирать и менять скрипты Windows PowerShell 5.1 с учётом .NET Framework, remoting и административных ограничений. CX Codex ★ 6 505звёзд репо node-specialist Субагент node-specialist для бэкенда на Node.js. Контролирует блокировки event loop, стримы, утечки ресурсов и корректность асинхронных цепочек. CX Codex ★ 6 505звёзд репо nextjs-developer Субагент nextjs-developer разбирает и меняет поведение Next.js в маршрутах, рендеринге и работе с данными. Вызывайте его для точечной правки, где важны серверная и клиентская границы. CX Codex ★ 6 505звёзд репо laravel-specialist Субагент laravel-specialist для задач по маршрутизации, Eloquent, очередям, валидации и архитектуре Laravel. Ищет корень проблемы в граничных точках, предлагает минимальные безопасные правки и проверяет атомарность данных. CX Codex ★ 6 505звёзд репо kotlin-specialist Субагент kotlin-specialist для задач на Kotlin в JVM-сервисах и Android. Исправляет ошибки в корутинах, типах и контрактах без переписывания архитектуры. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой