phpcs.xml.dist

<?xml version="1.0"?>
<ruleset name="LW Firewall Coding Standards">
    <description>PHP CodeSniffer ruleset for LW Firewall plugin.</description>

    <!-- Scan these files -->
    <file>.</file>

    <!-- Exclude paths -->
    <exclude-pattern>/vendor/*</exclude-pattern>
    <exclude-pattern>/node_modules/*</exclude-pattern>
    <!-- Standalone CLI test harness, not shipped plugin runtime code -->
    <exclude-pattern>/tests/*</exclude-pattern>

    <!-- Show progress -->
    <arg value="ps"/>
    <arg name="colors"/>

    <!-- Use WordPress Coding Standards -->
    <rule ref="WordPress">
        <!-- Allow short array syntax -->
        <exclude name="Universal.Arrays.DisallowShortArraySyntax"/>
        <!-- Allow reserved keyword parameter names -->
        <exclude name="Universal.NamingConventions.NoReservedKeywordParameterNames"/>
        <!-- Allow code-like comments -->
        <exclude name="Squiz.PHP.CommentedOutCode"/>
        <!-- @phpstan-ignore directive comments end in an identifier, not punctuation -->
        <exclude name="Squiz.Commenting.InlineComment.InvalidEndChar"/>
        <!-- PSR-4 autoloading: use PascalCase filenames instead of class- prefix -->
        <exclude name="WordPress.Files.FileName.NotHyphenatedLowercase"/>
        <exclude name="WordPress.Files.FileName.InvalidClassFileName"/>
    </rule>

    <!-- WP-CLI requires $args/$assoc_args in method signatures -->
    <rule ref="Generic.CodeAnalysis.UnusedFunctionParameter">
        <exclude-pattern>/includes/CLI/*</exclude-pattern>
    </rule>

    <!-- FileStorage needs direct filesystem ops and error silencing -->
    <rule ref="WordPress.PHP.NoSilencedErrors">
        <exclude-pattern>/includes/Storage/FileStorage.php</exclude-pattern>
    </rule>
    <rule ref="WordPress.WP.AlternativeFunctions.file_system_operations_is_writable">
        <exclude-pattern>/includes/Storage/FileStorage.php</exclude-pattern>
    </rule>

    <!-- PHP Compatibility -->
    <rule ref="PHPCompatibilityWP"/>
    <config name="testVersion" value="8.2-"/>

    <!-- WordPress minimum version -->
    <config name="minimum_wp_version" value="6.0"/>

    <!-- Text domain -->
    <rule ref="WordPress.WP.I18n">
        <properties>
            <property name="text_domain" type="array">
                <element value="lw-firewall"/>
            </property>
        </properties>
    </rule>

    <!-- Prefixes -->
    <rule ref="WordPress.NamingConventions.PrefixAllGlobals">
        <properties>
            <property name="prefixes" type="array">
                <element value="lw_firewall"/>
                <element value="lw_plugins"/>
                <element value="LightweightPlugins\Firewall"/>
            </property>
        </properties>
    </rule>
</ruleset>