Automatically format code to match PSR standards with PhpStorm

The user fabpot developed a tool, that automatically formats and rearranges your code according to PSR standards.

This blog post and tutorial will help you to install the tool, add it to PhpStorm and add a shortcut to perform a check to the currently opened file.

Step 1: Downloading and installing the tool

There are several ways to download and install the tool. However, I’ll show you the most easy way to do, which doesn’t require other tools like composer or homebrew to be installed.

We will use this cURL command

sudo curl -o /usr/local/bin/php-cs-fixer

to download and install the tool and then run this command

sudo chmod a+x /usr/local/bin/php-cs-fixer

to make it accessible globally.

If you prefer to install it via homebrew or composer, go to:

Make sure, that it has been installed correctly by running php-cs-fixer in your terminal

Step 2: Use it in PhpStorm

Go to PhpStorm and open the Settings/Preferences. Navigate to Tools -> External Tools and fill the form with these values

Bildschirmfoto 2015-01-29 um 10.44.09

The most important part is the part „Tool settings“

This is what you need to enter:

Program: Path to php-cs-fixer
In my example, you’ll see that I’ve installed it via composer. If you’ve installed it via cURL your path should be different

Parameters—level=all —verbose —config=sf23 fix “$FileDir$/$FileName$”
If this throws you an error youse —level=psr2 instead of —level=all

Working Directory: $ProjectFileDir$

Step 3: Setting up a shortkey combination 

Again, navigate to Settings/Preferences in PhpStorm and go to „Appearance & Behavior -> Keymap“. Search for php-cs-fixer Bildschirmfoto 2015-01-29 um 10.50.02

and assign a keyboard shortcut to the command. I used „CTRL + CMD + ]“

Now, whenever you are in a file and want the code to be formatted, simply hit the keyboard shortcut and the tool should do the rest! 🙂


It's only fair to share...Share on FacebookTweet about this on TwitterShare on RedditEmail this to someoneShare on Tumblr

7 thoughts on “Automatically format code to match PSR standards with PhpStorm

    1. Hi,

      yes, you can add a file watcher for php. Everytime you save/modify a php file the script gets executed. However, PhpStorm has autosave so you would need to disable that first.

  1. Great post, thanks!

    I first had some issues when copying the tool settings directly from the text because it does not contain double dashes and no „raw“ double quotes, so this confuses PHPStorm. After fixing this, everything works great. Besides, „–level=all“ does not seem to exist anymore, it’s called „symfony“ now; check „php-cs-fixer help fix“ for this.

    So this is what I use:
    –level=symfony –verbose –config=sf23 fix „$FileDir$/$FileName$“


  2. Pretty nice post. I just stumbled upon your weblog and wished to
    say that I have truly enjoyed surfing around your blog posts.
    In any case I’ll be subscribing to your rss feed and I
    hope you write again soon!

Leave a Comment

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.