PHP Development

Using Zed for Modern PHP Development

Configure Zed for PHP with its language extension, PHP language server, project runtime, and terminal-based development tools.

Zed’s PHP experience is built around language extensions and language-server integration rather than a PHP-only IDE model.

This guide focuses on a plain PHP workflow and can be adapted to framework-based projects where the same tools apply.

Install Zed and PHP support

Install Zed from its official distribution and add the PHP extension through the editor’s extension interface. PHP support requires a PHP executable available in PATH. Verify it with php -v before opening the project.

Choose a language server

Zed’s PHP documentation describes Phpactor as a default language-server option and also documents alternatives such as Intelephense. Select one server and follow its installation and configuration requirements. Avoid configuring multiple competing servers for the same workspace unless the documentation explains how to switch between them.

Open the Composer project root

Open the directory containing composer.json. Install dependencies with composer install and verify PSR-4 autoload mappings. Give the language server time to index the project and review its logs if completion or diagnostics do not appear.

Use terminal-based project tooling

Run PHP linting, Composer scripts, PHPUnit, PHPStan, and formatting tools from the integrated terminal. Keep the commands in Composer scripts or project documentation so they are not tied to one editor.

Evaluate debugging requirements

Zed supports debugging through the Debug Adapter Protocol, but the availability and configuration of a PHP adapter can depend on the current extension ecosystem. Verify the current PHP debugging support before making it a team requirement. Do not assume that installing the PHP syntax extension automatically configures Xdebug.

Practical verification checklist

  • Confirm the editor uses the intended PHP 8.4 executable.
  • Open the repository root and verify Composer dependencies.
  • Run PHP linting and the project’s automated tests.
  • Check that editor diagnostics match command-line results.
  • Keep local credentials and production data out of the workspace.

Conclusion

Zed is worth evaluating for developers who prefer a modern, fast editor and language-server workflow. Validate PHP completion, refactoring, and debugging against a real project before replacing an established IDE.

Official documentation

Share this page Help other developers discover this resource.