PHPCS: tweak ruleset

* Rename the ruleset to one which PHPCS will recognize automatically.
    This means you no longer need to pass the `--standard` on the command-line.
* Use the `dist` extension to allow for devs to overload the ruleset file locally and gitignore the typical overload file names which are recognized by PHPCS by default.
* Ruleset/Travis: move command-line arguments to the project ruleset.
    ... and scan all PHP files, not just the files in `src`.
* Ruleset: also scan the `phpt` test files.
* Ruleset: enable parallel scanning.
* Ruleset: set the basepath for a cleaner output report.
* Ruleset: add the PHPCS XML scheme.
* Ruleset: selectively exclude the `skip-linting.php` file for the `Generic.PHP.NoSilencedErrors` rule.

Author: jrfnl

.gitattributes

@@ -12,7 +12,6 @@
 /box.json export-ignore
 /doc export-ignore
 /phpcs.xml.dist export-ignore
-/phpcs-ruleset.xml export-ignore
 /tests export-ignore
 
 #

.gitignore

@@ -1,2 +1,4 @@
 /vendor
 composer.lock
+.phpcs.xml
+phpcs.xml

.travis.yml

@@ -28,4 +28,4 @@ script:
   - ./vendor/bin/tester -p php tests
   - ./parallel-lint --exclude vendor --exclude tests/examples --no-colors .
   - ./parallel-lint --exclude vendor --exclude tests/examples .
-  - if [[ "$SNIFF" == "1" ]]; then ./vendor/bin/phpcs --standard=phpcs-ruleset.xml -s src;fi
+  - if [[ "$SNIFF" == "1" ]]; then ./vendor/bin/phpcs;fi

phpcs-ruleset.xml renamed to phpcs.xml.dist

@@ -1,7 +1,38 @@
 <?xml version="1.0"?>
-<ruleset name="PHP-Parallel-Lint">
+<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="PHP-Parallel-Lint" xsi:noNamespaceSchemaLocation="./vendor/squizlabs/php_codesniffer/phpcs.xsd">
     <description>PHP Parallel Lint coding standard.</description>
 
+    <!--
+    #############################################################################
+    COMMAND LINE ARGUMENTS
+    https://github.com/squizlabs/PHP_CodeSniffer/wiki/Annotated-ruleset.xml
+    #############################################################################
+    -->
+
+    <file>.</file>
+
+    <!-- Exclude the Examples directory and the Composer vendor directory. -->
+    <exclude-pattern>*/tests/examples/*</exclude-pattern>
+    <exclude-pattern>*/vendor/*</exclude-pattern>
+
+    <!-- Only check PHP files. -->
+    <arg name="extensions" value="php,phpt/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"/>
+
+    <!--
+    #############################################################################
+    RULES
+    #############################################################################
+    -->
+
     <rule ref="Generic.Functions.FunctionCallArgumentSpacing"/>
     <rule ref="Generic.Functions.OpeningFunctionBraceBsdAllman"/>
     <rule ref="PEAR.Functions.FunctionDeclaration"/>
@@ -20,7 +51,9 @@
 
     <rule ref="Generic.PHP.DisallowShortOpenTag"/>
     <rule ref="Generic.PHP.LowerCaseConstant"/>
-    <rule ref="Generic.PHP.NoSilencedErrors"/>
+    <rule ref="Generic.PHP.NoSilencedErrors">
+        <exclude-pattern>/bin/skip-linting\.php$</exclude-pattern>
+    </rule>
     <rule ref="Squiz.PHP.GlobalKeyword"/>
     <rule ref="Squiz.PHP.LowercasePHPFunctions"/>
     <rule ref="Squiz.PHP.NonExecutableCode"/>