Skip to content

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.

2.0 KB
Raw Blame

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: intelephense must 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.phpVersion via initialization to match your project.

Verify

bun ../../scripts/verify-lsp.ts path/to/file.php