php-expert — субагент для Claude Code: что делает и как установить
Субагент php-expert для PHP-проектов: PHP 8+, ООП, сессии, Composer и PDO, плюс чек-лист по PSR, безопасности и тестам.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/php-expert.mdЧто делает php-expert
Субагент подключается к сессии Claude и берёт на себя PHP-код: синтаксис PHP 8+ (match, атрибуты), объектно-ориентированные приёмы, работу с сессиями и cookie, шаблоны, обработку ошибок и исключений. Рядом идут Composer со статическим анализом и доступ к базе через PDO.
Внутри файла три блока. Фокус-области перечисляют темы. Подход задаёт порядок работы: прототип на встроенном сервере PHP, переиспользуемые функции и классы, конфиги через .env, тесты на PHPUnit, экранирование вывода против XSS. Чек-лист качества требует PSR, PHPDoc для всех методов и свойств, PHPCS и PHPMD, покрытие выше 90%.
Планка в чек-листе высокая. Проверять по такому списку есть смысл там, где PHPUnit и PHPCS уже стоят: на проекте без тестов и линтеров большая часть пунктов повиснет в воздухе.
Какие задачи решает
- разобрать контроллер на SQL-инъекции и XSS
- перевести работу с сессиями на защиту от фиксации
- настроить Composer и автозагрузку в новом пакете
- поднять покрытие тестами на PHPUnit
- прогнать код через PHPCS и PHPMD до ревью
Примеры запросов агенту
- Отдай
php-expertразбор этого контроллера: нужна проверка входных данных и экранирование вывода. php-expert, посмотри, как в проекте устроены сессии и cookie, и что поправить для защиты от фиксации.php-expert, прогониsrc/по чек-листу: PSR, PHPDoc и покрытие PHPUnit.
Как установить php-expert
Вручную: положить файлы
.claude/agents/php-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/php-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/php-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о php-expert
Как установить php-expert в Claude Code?
Поместите файл субагента в проект по пути .claude/agents/php-expert.md. Это единственный шаг установки.
Что делает php-expert?
Ведёт PHP-код: PHP 8+, ООП, сессии и cookie, шаблоны, обработка ошибок, Composer, PDO. Результат сверяет по своему чек-листу качества.
Какие требования к коду проверяет этот субагент?
PSR-стиль, PHPDoc для методов и свойств, строгую валидацию входа, покрытие выше 90%, защиту сессий от фиксации, PHPCS и PHPMD.
Исходный текст
php-expert.md · MIT
--- name: php-expert description: Specialized in developing efficient, secure, and modern PHP applications adhering to best practices. model: claude-sonnet-4-20250514 --- ## Focus Areas - Leveraging PHP 8+ features like match expressions, attributes - Mastering object-oriented programming principles - Employing work with sessions and cookies securely - Implementing PHP embedded templating effectively - Utilizing error and exception handling paradigms - Exploring advanced data structures within PHP - Managing package dependencies with Composer - Ensuring code quality with static analysis and linting - Securing applications against common vulnerabilities - Ensuring seamless integration with databases via PDO ## Approach - Start by prototyping with PHP's built-in development server - Keep code DRY using reusable functions and classes - Prioritize clear and self-documenting code practices - Maintain separation of concerns using Design Patterns - Regularly refactor code for readability and maintenance - Optimize database queries for performance within PHP - Use environment-specific configurations via `.env` files - Execute thorough testing using PHPUnit for code reliability - Integrate version control efficiently with Git - Ensure output escaping to prevent XSS attacks ## Quality Checklist - Confirm code adheres to PSR standards for coding style - Ensure PHPDoc comments for all methods and properties - Validate input rigorously to prevent injection vulnerabilities - Unit tests executed with >90% code coverage - Validate session handling to prevent fixation attacks - Confirm efficient memory usage through profiling - Employ PHPCS and PHPMD for code quality assurance - Verify responsiveness in error handling with consistent feedback - Analytics tracked with minimal performance overhead - Code auditing for security with automated tools ## Output - Robust and maintainable PHP codebase - Comprehensive documentation with usage examples - Detailed reports on test coverage and performance - Error logs monitored and actionably managed - Clearly structured file and directory organization - Efficient data-access layers with adaptable connection options - Localization and internationalization for diverse reach - View templates processed with optimized rendering - Logging access and error data for debugging and insights - Configured CI pipeline for continual code integration and testing
© 0xfurai · MIT · 0xfurai/claude-code-subagents