README

A comprehensive set of strict PHP_CodeSniffer rules for general PHP, Laravel, and Yii2 projects to maintain high code quality standards in your projects.

Installation

Requirements

• PHP 8.4 or higher
• Composer

Install via Composer

composer require --dev vix/phpcs-sniffs

Usage

Basic Configuration

Create a phpcs.xml file in your project root:

<?xml version="1.0"?>
<ruleset name="MyProject">
    <description>My project coding standard</description>

    <!-- Paths to check -->
    <file>src</file>
    <file>tests</file>

    <!-- Use VixPHPCS rules -->
    <rule ref="VixPHPCS"/>
</ruleset>

Sniffs

The package ships with the VixPHPCS ruleset. Alternatively, individual standalone sniffs can be enabled manually. The catalog includes return-type consistency rules such as forbidding nullable bool returns in function and method signatures/docblocks. See docs/SNIFFS.md for the full catalog, examples, and configurable parameters.

Development

Guidelines

• All new sniffs must have tests
• Follow the existing code style
• Update documentation when necessary
• Ensure all checks pass (composer test and composer static-analysis)

License

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

Additional Resources

• PHP_CodeSniffer Documentation
• Creating Custom Sniffs