Skip to content

Latest commit

 

History

History
102 lines (66 loc) · 2.64 KB

README.md

File metadata and controls

102 lines (66 loc) · 2.64 KB

PHP CodeSniffer Project

This project uses PHP_CodeSniffer to ensure that your PHP code adheres to a set of coding standards.

Requirements

  • PHP 8.0 or higher
  • Composer

Installation

  1. Install PHP_CodeSniffer via Composer globally:

    composer global require squizlabs/php_codesniffer

  2. Verify the installation:

    phpcs --version

  3. Show the current PHP CodeSniffer ruleset:

    phpcs --config-show

  4. Set the moddit/phpcs as your global PHP CodeSniffer:

    composer global require moddit/phpcs # Installing this package rule set
phpcs --config-set default_standard ModditPHPCS # Updating default standard ruleset

Project ruleset

Your project needs a phpcs.xml file to instantly know which ruleset and folder to lint/format. Create or update the phpcs.xml file in the root of the project as follows. Don't forget to edit the project name and set the files to lint/format:

<?xml version="1.0"?>
<!-- @see https://pear.php.net/manual/en/package.php.php-codesniffer.annotated-ruleset.php -->
<ruleset name="Project Name"> 
    <file>app</file> <!-- For Laravel -->
    <file>wp/wp-content/themes/blue-headless/includes</file> <!-- For WordPress -->
    <rule ref="ModditPHPCS"></rule> <!-- Our ruleset name -->
</ruleset>

Usage

To check the PHP files in your project, run the following command from your global Composer packages:

phpcs

Or if the project has no phpcs.xml file in the root folder, specify the folder to lint:

phpcs ./path/to/php

Fixing Code

PHP_CodeSniffer also includes a tool to automatically fix coding standard violations. To use it, run:

phpcbf ./path/to/your/php/files

Or fix all folder files configured in the ruleset of the project's phpcs.xml:

phpcbf

IDEA Extensions

Visual Studio Code

To show phpcs.xml lint errors in Visual Studio Code, you can use the following extensions:

  • PHP CodeSniffer: This extension integrates PHP_CodeSniffer with Visual Studio Code. Including linting and error fixing based on phpcs.xml 
    ext install shevaua.phpcs

PhpStorm

To show phpcs.xml lint errors in PhpStorm, you can configure the built-in PHP CodeSniffer integration:

For more detailed instructions, refer to the PhpStorm documentation.

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss any changes.

License

This project is licensed under the MIT License. See the LICENSE file for details.