# php-pro

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

- субагент · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 у репозитория
- Автор: VoltAgent
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/02-language-specialists/php-pro.toml
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/voltagent-php-pro

## Что делает

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

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

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

## Установка

### Codex (родная платформа)

**Вручную: положить файлы**
- Файл: `.codex/agents/php-pro.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/php-pro.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/php-pro.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/02-language-specialists/php-pro.toml

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

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

## Похожие
- [php-development](https://affpapa.org/nevibecode/skills/php-development.md) — скилл · 1100 установок
- [php-best-practices](https://affpapa.org/nevibecode/skills/php-best-practices.md) — скилл · 3900 установок
- [spatie-laravel-php](https://affpapa.org/nevibecode/skills/spatie-laravel-php.md) — скилл · 1400 установок
- [php-code-review-expert](https://affpapa.org/nevibecode/agents/php-code-review-expert.md) — субагент · ★ 372 у репозитория
- [php-software-architect-expert](https://affpapa.org/nevibecode/agents/php-software-architect-expert.md) — субагент · ★ 372 у репозитория
- [php-mcp-server-generator](https://affpapa.org/nevibecode/skills/php-mcp-server-generator.md) — скилл · 8900 установок

## Другие версии с тем же именем
- [php-pro · voltagent](https://affpapa.org/nevibecode/agents/voltagent-community-php-pro.md) — 2019 установок
- [php-pro · wshobson](https://affpapa.org/nevibecode/agents/php-pro.md) — 2019 установок

Из того же набора: [voltagent/awesome-codex-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-codex-subagents.md) — 176 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
