Install now

Installation¶

When developing on multiple projects or with team of developers, it is highly recommended to install PHP CS Fixer as direct dependency per project and not globally on your machine. This will ensure each team member is using version of the tool expected by given project.

PHP needs to be a minimum version of PHP 7.4.

Composer¶

Fresh installation¶

To install PHP CS Fixer, install Composer and issue the following command:

composer require --dev friendsofphp/php-cs-fixer
## or when facing conflicts in dependencies:
composer require --dev php-cs-fixer/shim

Upgrade¶

composer upgrade friendsofphp/php-cs-fixer
## or
composer upgrade php-cs-fixer/shim

Docker¶

You can use pre-built Docker images to run php-cs-fixer.

docker run -it --rm -v $(pwd):/code ghcr.io/php-cs-fixer/php-cs-fixer:${FIXER_VERSION:-3-php8.3} fix src

$FIXER_VERSION used in example above is an identifier of a release you want to use, which is based on Fixer and PHP versions combined. There are different tags for each Fixer’s SemVer level and PHP version with syntax <php-cs-fixer-version>-php<php-version>. For example:

3.66.1-php7.4
3.66-php8.0
3-php8.3

PHIVE¶

Fresh installation¶

Install PHIVE and issue the following command:

phive install php-cs-fixer

Upgrade¶

phive update php-cs-fixer

GitHub Action (Docker)¶

To integrate PHP CS Fixer as check into a GitHub Action step, you can use a configuration like this:

- name: PHP-CS-Fixer
  uses: docker://ghcr.io/php-cs-fixer/php-cs-fixer:3-php8.3
    with:
      args: check
      # use `check .` if your repository not having paths configured in .php-cs-fixer[.dist].php

Gitlab-CI (Docker)¶

To integrate PHP CS Fixer as check into Gitlab-CI, you can use a configuration like this:

php-cs-fixer:
  image: ghcr.io/php-cs-fixer/php-cs-fixer:${FIXER_VERSION:-3-php8.3}
  script:
    php-cs-fixer check # --format gitlab ## specify format if not using PHP_CS_FIXER_FUTURE_MODE or v4+
    # use `check .` if your repository not having paths configured in .php-cs-fixer[.dist].php

Homebrew (globally)¶

While not recommended to install the tool globally, it is possible to use homebrew as well.

Fresh installation¶

brew install php-cs-fixer

Upgrade¶

brew upgrade php-cs-fixer

Manual binary download¶

It is also possible to download the php-cs-fixer.phar file and store it somewhere on your computer.

Fresh installation¶

To do that, you can run these commands to easily access latest php-cs-fixer from anywhere on your system:

wget https://cs.symfony.com/download/php-cs-fixer-v3.phar -O php-cs-fixer
# or
curl -L https://cs.symfony.com/download/php-cs-fixer-v3.phar -o php-cs-fixer

or with specified version:

wget https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.66.0/php-cs-fixer.phar -O php-cs-fixer
# or
curl -L https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.66.0/php-cs-fixer.phar -o php-cs-fixer

then:

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

Then, just run php-cs-fixer.

Upgrade¶

sudo php-cs-fixer self-update