PHP Formatter PHP-CS-Fixer

A lightweight VS Code extension that formats PHP files using PHP-CS-Fixer. Zero dependencies, auto-discovers your config and executable.

Features

• Formats PHP files on demand or on save
• Auto-discovers vendor/bin/php-cs-fixer or falls back to global installation
• Auto-discovers .php-cs-fixer.php or .php-cs-fixer.dist.php config files
• Multi-root workspace support
• Workspace Trust support for security
• Minimal footprint (~4 KB bundled)

Requirements

• PHP-CS-Fixer installed locally or globally
• PHP available in your PATH

Install PHP-CS-Fixer

# Local installation (recommended)
composer require --dev friendsofphp/php-cs-fixer

# Global installation
composer global require friendsofphp/php-cs-fixer

Quick Start

1. Install this extension from the VS Code Marketplace
2. Install PHP-CS-Fixer via Composer
3. Create a .php-cs-fixer.php config file in your project root
4. Set this extension as your default PHP formatter:

{
  "[php]": {
    "editor.defaultFormatter": "muuvmuuv.vscode-just-php-cs-fixer",
    "editor.formatOnSave": true
  }
}

Configuration

Setting	Default	Description
php-cs-fixer.executable	Auto-detect	Path to PHP-CS-Fixer executable
php-cs-fixer.config	Auto-detect	Path to config file
php-cs-fixer.allow-risky	false	Allow risky rules

Example Configuration

{
  "php-cs-fixer.executable": "vendor/bin/php-cs-fixer",
  "php-cs-fixer.config": ".php-cs-fixer.php",
  "php-cs-fixer.allow-risky": true,
  "[php]": {
    "editor.defaultFormatter": "muuvmuuv.vscode-just-php-cs-fixer",
    "editor.formatOnSave": true
  }
}

Example PHP-CS-Fixer Config

Create a .php-cs-fixer.php file in your project root:

<?php

$finder = PhpCsFixer\Finder::create()
    ->in(__DIR__)
    ->exclude('vendor');

return (new PhpCsFixer\Config())
    ->setRules([
        '@PSR12' => true,
        '@Symfony' => true,
    ])
    ->setFinder($finder);

Why This Extension?

Other PHP formatting extensions tend to be complex, bundle PHP-CS-Fixer themselves, or include HTML formatting that conflicts with PHP-CS-Fixer. This extension:

• Does one thing well - runs PHP-CS-Fixer
• Has zero runtime dependencies
• Uses your PHP-CS-Fixer installation and config
• Works seamlessly with other extensions like Intelephense

Troubleshooting

Formatting not working?

1. Open the Output panel (View > Output)
2. Select "PHP-CS-Fixer" from the dropdown
3. Check the logs for errors

Common Issues

Issue	Solution
Executable not found	Install via composer require --dev friendsofphp/php-cs-fixer or set php-cs-fixer.executable
Config not found	Create .php-cs-fixer.php in project root or set php-cs-fixer.config
Untrusted workspace	Grant workspace trust or configure settings at user level

Development

# Install dependencies
npm install

# Build
npm run compile

# Watch mode
npm run dev

# Run tests
npm test

# Package
npm run package

License

GPLv3

---

The PHP-CS-Fixer logo is © Fabien Potencier