<?xml version="1.0"?>

<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="PHPCS Coding Standards for PHPCompatibility" xsi:noNamespaceSchemaLocation="https://schema.phpcodesniffer.com/phpcs.xsd">

<description>Check the code of the PHPCompatibility standard itself.</description>

<!--

<file>.</file>

<!-- Files without extension need to be explicitly requested for scan. -->

<file>./bin/generate-forbidden-names-test-files</file>

<!-- Exclude Composer vendor directory. -->

<exclude-pattern>*/vendor/*</exclude-pattern>

<!-- Only check PHP files. -->

<arg name="extensions" value="php"/>

<!-- Show progress, show the error codes for each message (source). -->

<arg value="ps"/>

<!-- Strip the filepaths down to the relevant bit. -->

<arg name="basepath" value="./"/>

<!-- Check up to 8 files simultaneously. -->

<arg name="parallel" value="8"/>

<!-- Enable caching to a fixed file. -->

<arg name="cache" value=".phpcs.cache"/>

<!--

<config name="testVersion" value="7.2-"/>

<rule ref="PHPCSDev">

<!-- To address at a later point in time. -->

<exclude name="Generic.Files.LineLength.TooLong"/>

<!-- Ignoring a number of whitespace issues around blank lines. -->

<exclude name="Squiz.WhiteSpace.FunctionSpacing.After"/>

<exclude name="Squiz.WhiteSpace.FunctionSpacing.Before"/>

<exclude name="Squiz.WhiteSpace.ControlStructureSpacing.SpacingAfterOpen"/>

<exclude name="Squiz.WhiteSpace.ControlStructureSpacing.SpacingBeforeClose"/>

<exclude name="Squiz.ControlStructures.ControlSignature.SpaceAfterCloseBrace"/>

<!-- All nice and good, but too much of a fuss for the outer array of nested arrays. -->

<exclude name="Squiz.Arrays.ArrayDeclaration.DoubleArrowNotAligned"/>

</rule>

<!-- Enforce constant visibility.

<rule ref="PSR12.Properties.ConstantVisibility">

<severity>5</severity>

</rule>

<!--

<rule ref="PSR1.Files.SideEffects.FoundWithSymbols">

<exclude-pattern>*/phpunit-bootstrap\.php</exclude-pattern>

<exclude-pattern>*/PHPCSAliases\.php</exclude-pattern>

</rule>

<!-- No need to be as strict about comment punctuation for the unit tests. -->

<rule ref="Generic.Commenting.DocComment.ShortNotCapital">

<exclude-pattern>*/PHPCompatibility/Tests/*\.php</exclude-pattern>

<exclude-pattern>*/PHPCompatibility/Util/Tests/*\.php</exclude-pattern>

</rule>

<rule ref="PHPCompatibility.Attributes.NewAttributes.PHPUnitAttributeFound">

<exclude-pattern>*/PHPCompatibility/Tests/BaseSniffTestCase\.php$</exclude-pattern>

</rule>

<!-- Disregard this rule in code which doesn't need to be tested (or rather: generates test code). -->

<rule ref="Universal.FunctionDeclarations.NoLongClosures.ExceedsMaximum">

<exclude-pattern>/bin/generate-forbidden-names-test-files$</exclude-pattern>

</rule>

</ruleset>