Skip to main content
subagent CX Codex

php-pro · voltagent/awesome-codex-subagents — Codex subagent: PHP development and debugging

php-pro — a subagent for PHP code: analyzes application logic, handles framework integration, debugs runtime errors, and evolves server code safely. Use it when you need deep PHP expertise, not just syntax.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/php-pro.toml
Open on GitHub

What php-pro does

php-pro treats a PHP application as a running system, not as text. It maps execution boundaries first: request entry point, state flow, external dependencies. Then it identifies root causes or design gaps before proposing changes.

It concentrates on production behavior: input validation at boundaries, error handling consistency, database transaction safety, autoloading and namespace resolution, PHP version compatibility. It recommends the smallest coherent fixes that solve the problem without breaking surrounding code.

It validates directly: behavior on valid input and edge cases, write consistency under partial failure, namespace resolution in touched modules, error surface stability for callers. It flags what must be checked on the server before deployment and notes remaining risks.

What it helps with

  • trace request logic and data flow through the application
  • locate a bug in PHP code and understand why it occurs
  • change code safely without breaking adjacent functionality
  • integrate with a framework or library correctly
  • verify error handling and boundary cases

Example prompts for the agent

  • Why does /api/users return an empty array when the database has records?
  • Debug the PDOException thrown on insert to the orders table.
  • Add result caching to the user query without touching other code.

How to install php-pro

Manually: put the files in place

.codex/agents/php-pro.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about php-pro

How do I install php-pro in Codex?

Create a file .codex/agents/php-pro.toml at the project root. Codex will load it the next time you open the workspace.

What does php-pro do?

It analyzes a PHP application as an executable system: maps execution boundaries, finds root causes of errors, proposes minimal fixes that preserve existing behavior, and verifies input validation, error handling, database safety, and PHP version compatibility.

When should I use php-pro instead of a general PHP assistant?

Use php-pro when bugs hide in edge cases, data flow between modules, or runtime behavior. For quick syntax snippets or simple code fragments, a general assistant is enough.

Source text

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

Similar subagents

All subagents for Backend and APIs →

php-pro by other authors comes first.

php-pro VoltAgent Community php-pro — a Claude Code subagent for PHP 8.3+, Laravel, and Symfony projects requiring strict typing, PHPStan level 9 checks, and async patterns. CX Codex 2,019installs php-pro Seth Hobson php-pro writes idiomatic PHP 8+ code focused on low memory usage. Employs generators, SPL data structures, and native standard library features. CX Codex 2,019installs php-development Mindrally php-development is a Claude Code skill that guides PHP 8.1+ code with PSR-12, SOLID, strict typing and PHPUnit tests. Generated files begin with declare(strict_types=1). CX Codex +1 1,100installs php-best-practices php-community php-best-practices — a 51-rule guide for reviewing PHP 8.0–8.5 code against PSR standards, SOLID principles, and strict typing. Helps audit classes and adopt modern syntax. CX Codex +1 3,900installs spatie-laravel-php Spatie spatie-laravel-php applies Spatie guidelines and PSR-12 standards when generating, refactoring, or reviewing Laravel PHP files and Blade templates. CX Codex +1 1,400installs php-code-review-expert Giuseppe Trisciuoglio php-code-review-expert reviews PHP 8.3+, Laravel, and Symfony changes for security flaws, ORM issues, and type errors while discarding low-confidence noise. CX Codex ★ 372repo stars php-software-architect-expert Giuseppe Trisciuoglio php-software-architect-expert is a Claude Code subagent that examines PHP architecture. Invoke it for Clean Architecture reviews, DDD modeling, or decisions about code structure. CX Codex ★ 372repo stars php-mcp-server-generator official github php-mcp-server-generator generates a PHP MCP server project with tools, resources, prompts, and tests. Use it when you need a structured starting point for a PHP-based MCP server. CX Codex +1 8,900installs

From the same set176

The whole set →
rails-expert rails-expert traces Rails changes from request entry point to persistence and response. Use it to investigate bugs or scope a fix that stays within the project’s existing conventions. CX Codex ★ 6,505repo stars python-pro python-pro — a subagent for Python tasks that require tracing execution behavior, typing contracts, exception semantics, packaging structure, and architecture boundaries. Finds root causes instead of surface fixes. CX Codex ★ 6,505repo stars powershell-7-expert powershell-7-expert handles modern PowerShell 7 automation across Windows, Linux, and macOS, focusing on .NET tooling, pipeline contracts, and CI jobs. CX Codex ★ 6,505repo stars powershell-5.1-expert The powershell-5.1-expert subagent handles Windows PowerShell 5.1 work, including .NET Framework interop, legacy remoting, and administration scripts. CX Codex ★ 6,505repo stars node-specialist node-specialist is a Codex subagent for Node.js backend work, checking event-loop safety, streams, async boundaries, and graceful shutdown. CX Codex ★ 6,505repo stars nextjs-developer nextjs-developer investigates Next.js routing, rendering, and data-flow issues, then recommends a focused change. Use it when server/client boundaries or deployment behavior matter. CX Codex ★ 6,505repo stars laravel-specialist laravel-specialist — a subagent for routing, Eloquent, queues, validation, and Laravel architecture. Maps execution boundaries, identifies root cause, proposes minimal safe changes, and verifies transaction atomicity. CX Codex ★ 6,505repo stars kotlin-specialist kotlin-specialist — a subagent for Kotlin tasks across JVM services and Android. Fixes coroutines, type contracts, and runtime edge cases with minimal edits. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open