The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
PHP — LSP setup
- Builtin server:
php—intelephense --stdio - Extensions:
.php - Install hint:
npm install -g intelephense
Install
Intelephense is a Node package, so Node.js (and npm) must be installed first.
- macOS:
npm install -g intelephense - Linux:
npm install -g intelephense - Windows:
npm install -g intelephense
Confirm it resolves:
command -v intelephense
Configure
Builtin — usually NO config needed (auto-resolved by extension). Configure only to set priority, init options, override extensions, or disable. Same JSON shape in every harness's project config (per-harness paths: the Configure step in SKILL.md):
{ "lsp": { "php": { "priority": 100 } } }
For builtin ids in a PROJECT config, command is supplied automatically — only set priority/initialization/extensions/disabled (a project entry drops env). env, and a fully custom (non-builtin) server with its own command, must go in your harness's USER config (see the Configure step in SKILL.md).
Initialization options (only if commonly needed)
Intelephense's premium features (rename, find-all-implementations, declaration providers, etc.) require a licence key. Supply it via initialization:
{
"lsp": {
"php": {
"initialization": {
"licenceKey": "YOUR-LICENCE-KEY"
}
}
}
}
Without a key the server runs fine in free mode.
Alternatives
- phpactor (not builtin):
phpactor language-server. Pure-PHP, no Node dependency.
Troubleshooting
- PATH:
intelephensemust be on PATH; reopen the shell after a global npm install. If missing, check that$(npm prefix -g)/bin(Windows:npm prefix -g) is on PATH. - No Node: Intelephense fails to start without Node.js. Install Node, then reinstall.
- Wrong PHP version inference: set
intelephense.environment.phpVersionviainitializationto match your project.
Verify
bun ../../scripts/verify-lsp.ts path/to/file.php