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.