Installing PHPCS globally makes PHPCS available for use from anywhere on a local machine. Following these instructions will install:
- The latest compatible version of PHPCS
- The latest release of VIP-Coding-Standards (VIPCS)
- A compatible version of the WordPress Coding Standards (WordPressCS)
- Compatible versions of other standards packages, like VariableAnalysis, PHPCSUtils and PHPCSExtra
PHPCS commands on a local machine running Windows may require different formatting than the command examples shown below.
- Before beginning installation, ensure that Composer itself is up to date:
composer self-update && composer global update
- Run the command below in a terminal. This command can be run to update an existing global installation. Verbose output in the terminal will indicate what is being installed (or updated).
composer g require --dev automattic/vipwpcs -W
phpcscommand should now be in the local machine’s PATH.
$ ls ~/.composer/vendor/bin phpcbf phpcs
- Check PHPCS to ensure it is up to date.
$ phpcs --version PHP_CodeSniffer version 3.7.2 (stable) by Squiz (http://www.squiz.net)
phpcs command does not work, the Composer bin directory on the local machine will need to be added to the
PATH environment variable. On most operating systems, the
phpcs files are located in the
On a local machine running Linux, the file path might be
~/.config/composer/vendor/bin. Verify the location of the
phpcs files on the user’s local machine, and modify the file path as needed when following the instructions below.
- Edit the local machine’s shell profile (e.g.,
~/.bashrc) and add the
PATHenvironment variable. The syntax (and the actual file that the shell loads on startup) will vary depending on the shell being used. For example, in
~/.bash_profile, add the following code to the end of the file:
- After adding and saving the
PATHenvironment variable to the shell profile, either:
- Open a new terminal window
- or source the shell profile in the existing terminal window by running:
- Run the
Last updated: December 23, 2023