Skip to content
Run the 'PHP Coding Standards Fixer' within Atom
Branch: master
Clone or download
pfefferle Merge pull request #76 from DonRichards/patch-1
Keep README example up to date
Latest commit 3b96489 Sep 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples updated `.php_cs` settings Dec 9, 2016
keymaps initial 1.0.0 Apr 15, 2015
lib Fix when the text editor is not in focus Aug 29, 2017
menus Show the context menu in php files only Feb 11, 2016
.editorconfig updated documentations Nov 6, 2015
.gitignore initial 1.0.0 Apr 15, 2015 updated changelog Aug 29, 2017 initial 1.0.0 Apr 15, 2015 Update Sep 6, 2018
package.json Prepare 4.1.1 release Aug 29, 2017
php-cs-fixer.gif initial 1.0.0 Apr 15, 2015

apm apm apm

php-cs-fixer Atom-Package

Run the "PHP Coding Standards Fixer" within your Atom Editor

This version requires the PHP-CS-Fixer >= v2.0.0!

A screenshot of your package


$ apm install php-cs-fixer

or find it in the Packages tab under settings


The package requires the "PHP Coding Standards Fixer" Cli build by SensioLabs. Minimum version required is 2.0.

Installation via Composer

$ ./composer.phar global require friendsofphp/php-cs-fixer

For other installation methods, see


ctrl-cmd-s or Php Cs Fixer: Fix in the Command Palette.

(The commands can also be found in the settings-menu of the Package)


You can configure php-cs-fixer from the Atom package manager or by editing ~/.atom/config.cson (choose Open Your Config in Atom menu).

Here's an example configuration:

  allowRisky: false # whether to run risky rules, false by default
  executablePath: "~/.composer/vendor/bin/php-cs-fixer" # the path to the `php-cs-fixer` executable
  executeOnSave: false # execute PHP CS fixer on save
  phpExecutablePath: "/usr/bin/php" # the path to the `php` executable
  rules: "-psr0,@PSR2,binary_operator_spaces,blank_line_before_return,..." # or null
  showInfoNotifications: true #show some status informations from the last "fix"


Mac OS X + brew

By @gammamatrix

To get it to work with brew, you need to cat the contents of the script installed with brew install php-cs-fixer:

Check to see where it installed

$ which php-cs-fixer

Cat the script

cat /usr/local/bin/php-cs-fixer

/usr/bin/env php -d allow_url_fopen=On -d detect_unicode=Off /usr/local/Cellar/php-cs-fixer/2.13.0/libexec/php-cs-fixer.phar $*

Paste the path for php-cs-fixer.phar in Executable Path

Go back to settings in Atom for php-cs-fixer.


FYI: "PHP executable Path" is empty for my set up. I also installed PHP with brew.

Use the keystroke: ctrl-cmd-s

I hope this helps 8)

This works for me without errors.


Support for PHP-CS-Fixer v1.x.x

The latest version of this plugin requires PHP-CS-Fixer >= v2.0.0, to use it with PHP-CS-Fixer v1.x.x, install version 3.0.0 or lower.

$ apm install php-cs-fixer@3.0.0

I have updated the plugin to 2.3.0 and it does not work any more

I had to add a new settings-parameter "PHP executable Path" to get the plugin running on Windows, so be sure to check if the new setting is configured properly.

On Windows this add-on does not work while running manually from the command line works

You probably have to add the directory of the php.exe to the PATH environment variable. You can do this in the system properties. You should configure the php-cs-fixer executable path to point to the vendor directory (e.g. C:/Users/{username}/AppData/Roaming/Composer/vendor/friendsofphp/php-cs-fixer/php-cs-fixer). For detailed information use the Java guide or this stackexchange answer.

You can’t perform that action at this time.