php.md

PHP and Symfony

The full profile installs the PHP runtime used by local Symfony projects:

• php for the Homebrew-managed PHP runtime;
• composer for PHP dependencies;
• symfony-cli/tap/symfony-cli for Symfony local tooling.

Project dependencies, quality tools, and test tools should live in each project's composer.json. This repository installs the shared runtime only.

Installation

Install the full profile:

mac setup --profile full

Or install the tools directly:

brew install php composer
brew install symfony-cli/tap/symfony-cli

Validation

Check the runtime:

php --version
php --ini
composer --version
symfony version

The mac php helper also checks the local Xdebug state without requiring you to inspect PHP configuration files manually:

Check that Composer can inspect the local platform:

composer check-platform-reqs

Run the Symfony local server from a project directory:

symfony serve

Stop local Symfony services when finished:

symfony server:stop

Project boundary

Keep these decisions inside each PHP project:

• framework version;
• Composer dependencies;
• test runner;
• static analysis level;
• coding standard;
• Rector rules;
• Xdebug and PCOV activation.

Use repository-level Homebrew only for tools that must exist before a project is cloned or bootstrapped.

Toolchain guides

Use the focused guides for project-level decisions:

• Xdebug for debugging and profiling;
• coverage for PCOV and coverage reports;
• static analysis for PHPStan;
• Pest for tests and Composer test scripts;
• coding standards for PHP-CS-Fixer and Rector;
• mutation testing for Infection.

Rollback

Remove the shared runtime tools:

brew uninstall symfony-cli
brew uninstall composer php

Project dependencies remain in each project's vendor/ directory and lock file.

---

← Docs index · Project README