sdc-build-wp 4.1.0 → 4.1.2

package/vendor/phpcsstandards/phpcsutils/PHPCSUtils/Utils/Variables.php

@@ -1,333 +0,0 @@
-<?php
-/**
- * PHPCSUtils, utility functions and classes for PHP_CodeSniffer sniff developers.
- *
- * @package   PHPCSUtils
- * @copyright 2019-2020 PHPCSUtils Contributors
- * @license   https://opensource.org/licenses/LGPL-3.0 LGPL3
- * @link      https://github.com/PHPCSStandards/PHPCSUtils
- */
-
-namespace PHPCSUtils\Utils;
-
-use PHP_CodeSniffer\Exceptions\RuntimeException;
-use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Util\Tokens;
-use PHPCSUtils\Internal\Cache;
-use PHPCSUtils\Tokens\Collections;
-use PHPCSUtils\Utils\Scopes;
-use PHPCSUtils\Utils\TextStrings;
-
-/**
- * Utility functions for use when examining variables.
- *
- * @since 1.0.0 The `Variables::getMemberProperties()` method is based on and inspired by
- *              the method of the same name in the PHPCS native `PHP_CodeSniffer\Files\File` class.
- *              Also see {@see \PHPCSUtils\BackCompat\BCFile}.
- */
-final class Variables
-{
-
-    /**
-     * List of PHP Reserved variables.
-     *
-     * The array keys are the variable names without the leading dollar sign, the values indicate
-     * whether the variable is a superglobal or not.
-     *
-     * The variables names are set without the leading dollar sign to allow this array
-     * to be used with array index keys as well. Think: `'_GET'` in `$GLOBALS['_GET']`.}
-     *
-     * @link https://php.net/reserved.variables PHP Manual on reserved variables
-     *
-     * @since 1.0.0
-     *
-     * @var array<string, bool>
-     */
-    public static $phpReservedVars = [
-        '_SERVER'              => true,
-        '_GET'                 => true,
-        '_POST'                => true,
-        '_REQUEST'             => true,
-        '_SESSION'             => true,
-        '_ENV'                 => true,
-        '_COOKIE'              => true,
-        '_FILES'               => true,
-        'GLOBALS'              => true,
-        'http_response_header' => false,
-        'argc'                 => false,
-        'argv'                 => false,
-
-        // Deprecated.
-        'php_errormsg'         => false,
-
-        // Removed PHP 5.4.0.
-        'HTTP_SERVER_VARS'     => false,
-        'HTTP_GET_VARS'        => false,
-        'HTTP_POST_VARS'       => false,
-        'HTTP_SESSION_VARS'    => false,
-        'HTTP_ENV_VARS'        => false,
-        'HTTP_COOKIE_VARS'     => false,
-        'HTTP_POST_FILES'      => false,
-
-        // Removed PHP 5.6.0.
-        'HTTP_RAW_POST_DATA'   => false,
-    ];
-
-    /**
-     * Retrieve the visibility and implementation properties of a class member variable.
-     *
-     * Main differences with the PHPCS version:
-     * - Removed the parse error warning for properties in interfaces.
-     *   This will now throw the same _"$stackPtr is not a class member var"_ runtime exception as
-     *   other non-property variables passed to the method.
-     * - Defensive coding against incorrect calls to this method.
-     * - Support PHP 8.0 identifier name tokens in property types, cross-version PHP & PHPCS.
-     * - The results of this function call are cached during a PHPCS run for faster response times.
-     *
-     * @see \PHP_CodeSniffer\Files\File::getMemberProperties()   Original source.
-     * @see \PHPCSUtils\BackCompat\BCFile::getMemberProperties() Cross-version compatible version of the original.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
-     * @param int                         $stackPtr  The position in the stack of the `T_VARIABLE` token
-     *                                               to acquire the properties for.
-     *
-     * @return array<string, mixed> Array with information about the class member variable.
-     *               The format of the return value is:
-     *               ```php
-     *               array(
-     *                 'scope'           => string,        // Public, private, or protected.
-     *                 'scope_specified' => boolean,       // TRUE if the scope was explicitly specified.
-     *                 'is_static'       => boolean,       // TRUE if the static keyword was found.
-     *                 'is_readonly'     => boolean,       // TRUE if the readonly keyword was found.
-     *                 'type'            => string,        // The type of the var (empty if no type specified).
-     *                 'type_token'      => integer|false, // The stack pointer to the start of the type
-     *                                                     // or FALSE if there is no type.
-     *                 'type_end_token'  => integer|false, // The stack pointer to the end of the type
-     *                                                     // or FALSE if there is no type.
-     *                 'nullable_type'   => boolean,       // TRUE if the type is preceded by the
-     *                                                     // nullability operator.
-     *               );
-     *               ```
-     *
-     * @throws \PHP_CodeSniffer\Exceptions\RuntimeException If the specified position is not a
-     *                                                      `T_VARIABLE` token.
-     * @throws \PHP_CodeSniffer\Exceptions\RuntimeException If the specified position is not a
-     *                                                      class member variable.
-     */
-    public static function getMemberProperties(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        if (isset($tokens[$stackPtr]) === false || $tokens[$stackPtr]['code'] !== \T_VARIABLE) {
-            throw new RuntimeException('$stackPtr must be of type T_VARIABLE');
-        }
-
-        if (Scopes::isOOProperty($phpcsFile, $stackPtr) === false) {
-            throw new RuntimeException('$stackPtr is not a class member var');
-        }
-
-        if (Cache::isCached($phpcsFile, __METHOD__, $stackPtr) === true) {
-            return Cache::get($phpcsFile, __METHOD__, $stackPtr);
-        }
-
-        $valid = Collections::propertyModifierKeywords() + Tokens::$emptyTokens;
-
-        $scope          = 'public';
-        $scopeSpecified = false;
-        $isStatic       = false;
-        $isReadonly     = false;
-
-        $startOfStatement = $phpcsFile->findPrevious(
-            [
-                \T_SEMICOLON,
-                \T_OPEN_CURLY_BRACKET,
-                \T_CLOSE_CURLY_BRACKET,
-                \T_ATTRIBUTE_END,
-            ],
-            ($stackPtr - 1)
-        );
-
-        for ($i = ($startOfStatement + 1); $i < $stackPtr; $i++) {
-            if (isset($valid[$tokens[$i]['code']]) === false) {
-                break;
-            }
-
-            switch ($tokens[$i]['code']) {
-                case \T_PUBLIC:
-                    $scope          = 'public';
-                    $scopeSpecified = true;
-                    break;
-                case \T_PRIVATE:
-                    $scope          = 'private';
-                    $scopeSpecified = true;
-                    break;
-                case \T_PROTECTED:
-                    $scope          = 'protected';
-                    $scopeSpecified = true;
-                    break;
-                case \T_STATIC:
-                    $isStatic = true;
-                    break;
-                case \T_READONLY:
-                    $isReadonly = true;
-                    break;
-            }
-        }
-
-        $type               = '';
-        $typeToken          = false;
-        $typeEndToken       = false;
-        $nullableType       = false;
-        $propertyTypeTokens = Collections::propertyTypeTokens();
-
-        if ($i < $stackPtr) {
-            // We've found a type.
-            for ($i; $i < $stackPtr; $i++) {
-                if ($tokens[$i]['code'] === \T_VARIABLE) {
-                    // Hit another variable in a group definition.
-                    break;
-                }
-
-                if ($tokens[$i]['code'] === \T_NULLABLE) {
-                    $nullableType = true;
-                }
-
-                if (isset($propertyTypeTokens[$tokens[$i]['code']]) === true) {
-                    $typeEndToken = $i;
-                    if ($typeToken === false) {
-                        $typeToken = $i;
-                    }
-
-                    $type .= $tokens[$i]['content'];
-                }
-            }
-
-            if ($type !== '' && $nullableType === true) {
-                $type = '?' . $type;
-            }
-        }
-
-        $returnValue = [
-            'scope'           => $scope,
-            'scope_specified' => $scopeSpecified,
-            'is_static'       => $isStatic,
-            'is_readonly'     => $isReadonly,
-            'type'            => $type,
-            'type_token'      => $typeToken,
-            'type_end_token'  => $typeEndToken,
-            'nullable_type'   => $nullableType,
-        ];
-
-        Cache::set($phpcsFile, __METHOD__, $stackPtr, $returnValue);
-        return $returnValue;
-    }
-
-    /**
-     * Verify if a given variable name is the name of a PHP reserved variable.
-     *
-     * @see \PHPCSUtils\Utils\Variables::$phpReservedVars List of variables names reserved by PHP.
-     *
-     * @since 1.0.0
-     *
-     * @param string $name The full variable name with or without leading dollar sign.
-     *                     This allows for passing an array key variable name, such as
-     *                     `'_GET'` retrieved from `$GLOBALS['_GET']`.
-     *                     > Note: when passing an array key, string quotes are expected
-     *                     to have been stripped already.
-     *                     Also see: {@see \PHPCSUtils\Utils\TextStrings::stripQuotes()}.
-     *
-     * @return bool
-     */
-    public static function isPHPReservedVarName($name)
-    {
-        if (\strpos($name, '$') === 0) {
-            $name = \substr($name, 1);
-        }
-
-        return (isset(self::$phpReservedVars[$name]) === true);
-    }
-
-    /**
-     * Verify if a given variable or array key token points to a PHP superglobal.
-     *
-     * @since 1.0.0
-     *
-     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file where this token was found.
-     * @param int                         $stackPtr  The position in the stack of a `T_VARIABLE`
-     *                                               token or of the `T_CONSTANT_ENCAPSED_STRING`
-     *                                               array key to a variable in `$GLOBALS`.
-     *
-     * @return bool `TRUE` if this points to a superglobal; `FALSE` when not.
-     *              > Note: This includes returning `FALSE` when an unsupported token has
-     *              been passed, when a `T_CONSTANT_ENCAPSED_STRING` has been passed which
-     *              is not an array index key; or when it is, but is not an index to the
-     *              `$GLOBALS` variable.
-     */
-    public static function isSuperglobal(File $phpcsFile, $stackPtr)
-    {
-        $tokens = $phpcsFile->getTokens();
-
-        if (isset($tokens[$stackPtr]) === false
-            || ($tokens[$stackPtr]['code'] !== \T_VARIABLE
-                && $tokens[$stackPtr]['code'] !== \T_CONSTANT_ENCAPSED_STRING)
-        ) {
-            return false;
-        }
-
-        $content = $tokens[$stackPtr]['content'];
-
-        if ($tokens[$stackPtr]['code'] === \T_CONSTANT_ENCAPSED_STRING) {
-            $prev = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($stackPtr - 1), null, true);
-            $next = $phpcsFile->findNext(Tokens::$emptyTokens, ($stackPtr + 1), null, true);
-            if (($prev === false || $tokens[$prev]['code'] !== \T_OPEN_SQUARE_BRACKET)
-                || ($next === false || $tokens[$next]['code'] !== \T_CLOSE_SQUARE_BRACKET)
-            ) {
-                // Not a single string array index key.
-                return false;
-            }
-
-            $pprev = $phpcsFile->findPrevious(Tokens::$emptyTokens, ($prev - 1), null, true);
-            if ($pprev === false
-                || $tokens[$pprev]['code'] !== \T_VARIABLE
-                || $tokens[$pprev]['content'] !== '$GLOBALS'
-            ) {
-                // Not accessing the `$GLOBALS` array.
-                return false;
-            }
-
-            // Strip quotes.
-            $content = TextStrings::stripQuotes($content);
-        }
-
-        return self::isSuperglobalName($content);
-    }
-
-    /**
-     * Verify if a given variable name is the name of a PHP superglobal.
-     *
-     * @since 1.0.0
-     *
-     * @param string $name The full variable name with or without leading dollar sign.
-     *                     This allows for passing an array key variable name, such as
-     *                     `'_GET'` retrieved from `$GLOBALS['_GET']`.
-     *                     > Note: when passing an array key, string quotes are expected
-     *                     to have been stripped already.
-     *                     Also see: {@see \PHPCSUtils\Utils\TextStrings::stripQuotes()}.
-     *
-     * @return bool
-     */
-    public static function isSuperglobalName($name)
-    {
-        if (\strpos($name, '$') === 0) {
-            $name = \substr($name, 1);
-        }
-
-        if (isset(self::$phpReservedVars[$name]) === false) {
-            return false;
-        }
-
-        return self::$phpReservedVars[$name];
-    }
-}

package/vendor/phpcsstandards/phpcsutils/PHPCSUtils/ruleset.xml

@@ -1,4 +0,0 @@
-<?xml version="1.0"?>
-<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="PHPCSUtils" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/PHPCSStandards/PHP_CodeSniffer/master/phpcs.xsd">
-    <description>Utility methods for external PHPCS standards.</description>
-</ruleset>

package/vendor/phpcsstandards/phpcsutils/README.md

@@ -1,297 +0,0 @@
-# PHPCSUtils: A suite of utility functions for use with PHP_CodeSniffer
-
-<div aria-hidden="true">
-
-[![Latest Stable Version](https://poser.pugx.org/phpcsstandards/phpcsutils/v/stable)][phpcsutils-packagist]
-[![Release Date of the Latest Version](https://img.shields.io/github/release-date/PHPCSStandards/PHPCSUtils.svg?maxAge=1800)][phpcsutils-releases]
-:construction:
-[![Latest Unstable Version](https://img.shields.io/badge/unstable-dev--develop-e68718.svg?maxAge=2419200)](https://packagist.org/packages/phpcsstandards/phpcsutils#dev-develop)
-[![Last Commit to Unstable](https://img.shields.io/github/last-commit/PHPCSStandards/PHPCSUtils/develop.svg)](https://github.com/PHPCSStandards/PHPCSUtils/commits/develop)
-
-[![Docs website](https://github.com/PHPCSStandards/PHPCSUtils/actions/workflows/update-docs.yml/badge.svg)][phpcsutils-web]
-[![CS Build Status](https://github.com/PHPCSStandards/PHPCSUtils/actions/workflows/basics.yml/badge.svg?branch=develop)](https://github.com/PHPCSStandards/PHPCSUtils/actions/workflows/basics.yml)
-[![Test Build Status](https://github.com/PHPCSStandards/PHPCSUtils/actions/workflows/test.yml/badge.svg?branch=develop)][phpcsutils-tests-gha]
-[![Coverage Status](https://coveralls.io/repos/github/PHPCSStandards/PHPCSUtils/badge.svg?branch=develop)](https://coveralls.io/github/PHPCSStandards/PHPCSUtils?branch=develop)
-
-[![Minimum PHP Version](https://img.shields.io/packagist/php-v/phpcsstandards/phpcsutils.svg?maxAge=3600)][phpcsutils-packagist]
-[![Tested on PHP 5.4 to 8.3](https://img.shields.io/badge/tested%20on-PHP%205.4%20|%205.5%20|%205.6%20|%207.0%20|%207.1%20|%207.2%20|%207.3%20|%207.4%20|%208.0%20|%208.1%20|%208.2%20|%208.3-brightgreen.svg?maxAge=2419200)][phpcsutils-tests-gha]
-
-[![License: LGPLv3](https://poser.pugx.org/phpcsstandards/phpcsutils/license)](https://github.com/PHPCSStandards/PHPCSUtils/blob/stable/LICENSE)
-![Awesome](https://img.shields.io/badge/awesome%3F-yes!-brightgreen.svg)
-
-</div>
-
-* [Features](#features)
-* [Minimum Requirements](#minimum-requirements)
-* [Integrating PHPCSUtils in your external PHPCS standard](#integrating-phpcsutils-in-your-external-phpcs-standard)
-    - [Composer-based](#composer-based)
-    - [Non-Composer based integration](#non-composer-based-integration)
-* [Frequently Asked Questions](#frequently-asked-questions)
-* [Potential Support Questions from your End-Users](#potential-support-questions-from-your-end-users)
-* [Contributing](#contributing)
-* [License](#license)
-
-
-## Features
-
-[PHPCSUtils][phpcsutils-repo] is a set of utilities to aid developers of sniffs for [PHP_CodeSniffer] (or "PHPCS" for short).
-
-This package offers the following features:
-
-<div id="feature-list">
-
-### An ever-growing number of utility functions for use with PHP_CodeSniffer
-
-Whether you need to split an `array` into the individual items, are trying to determine which variables are being assigned to in a `list()` or are figuring out whether a function has a DocBlock, PHPCSUtils has got you covered!
-
-Includes improved versions of the PHPCS native utility functions and plenty of new utility functions.
-
-These functions are compatible with PHPCS 3.10.0 up to PHPCS `master`.
-
-### A collection of static properties and methods for often-used token groups
-
-Collections of related tokens often-used and needed for sniffs.
-These are additional "token groups" to compliment the ones available through the PHPCS native `PHP_CodeSniffer\Util\Tokens` class.
-
-### Several abstract sniff classes which your sniffs can extend
-
-These classes take most of the heavy lifting away for some frequently occurring sniff types.
-
-### Test utilities
-
-An abstract `UtilityMethodTestCase` class to support testing of your utility methods written for PHP_CodeSniffer.
-Supports PHPUnit 4.x up to 9.x.
-
-### Use the latest version of PHP_CodeSniffer native utility functions
-
-Normally to use the latest version of PHP_CodeSniffer native utility functions, you would have to raise the minimum requirements of your external PHPCS standard.
-
-Now you won't have to anymore. This package allows you to use the latest version of those utility functions in all PHP_CodeSniffer versions from PHPCS 3.10.0 and up.
-
-### Fully documented
-
-To see detailed information about all the available abstract sniffs, utility functions and PHPCS helper functions, have a read through the [extensive documentation][phpcsutils-web].
-
-</div>
-
-
-## Minimum Requirements
-
-* PHP 5.4 or higher.
-* [PHP_CodeSniffer] 3.10.0+.
-* Recommended PHP extensions for optimal functionality:
-    - PCRE with Unicode support (normally enabled by default)
-
-
-## Integrating PHPCSUtils in your external PHPCS standard
-
-### Composer-based
-
-If your external PHP_CodeSniffer standard only supports Composer-based installs, integrating PHPCSUtils is pretty straight forward.
-
-Run the following from the root of your external PHPCS standard's project:
-
-```bash
-composer config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true
-composer require phpcsstandards/phpcsutils:"^1.0"
-```
-
-No further action needed. You can start using all the utility functions, abstract sniff classes and other features of PHPCSUtils straight away.
-
-> :information_source: The PHPCSUtils package includes the [Composer PHPCS plugin].
->
-> This plugin will automatically register PHPCSUtils (and your own external standard) with PHP_CodeSniffer, so you and your users don't have to worry about this anymore.
->
-> :warning: Note: if your end-user installation instructions include instructions on adding a Composer PHPCS plugin or on manually registering your standard with PHPCS using the `--config-set installed_paths` command, you can remove those instructions as they are no longer needed.
->
-> :information_source: As of Composer 2.2, Composer will [ask for permission](https://blog.packagist.com/composer-2-2/#more-secure-plugin-execution) to allow the Composer PHPCS plugin to execute code. For the plugin to be functional, permission needs to be granted.
-> This can be done ahead of time by instructing your users to run the following command before installing your standard:
->
-> ```bash
-> composer config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true
-> ```
-
-#### Running your unit tests
-
-If your unit tests use the PHP_CodeSniffer native unit test suite, all is good.
-
-If you have your own unit test suite to test your sniffs, make sure to load the Composer `vendor/autoload.php` file in your PHPUnit bootstrap file or _as_ the PHPUnit bootstrap file.
-
-If you intend to use the test utilities provided in the `PHPCSUtils/TestUtils` directory, make sure you also load the `vendor/phpcsstandards/phpcsutils/phpcsutils-autoload.php` file in your PHPUnit bootstrap file.
-
-
-### Non-Composer based integration
-
-In this case, more than anything, you will need to update the non-Composer installation instructions for your end-users.
-
-To use a non-Composer based installation for your sniff development environment, the same instructions would apply.
-
-Your installation instructions for a non-Composer based installation will probably look similar to this:
-
-> * Install [PHP_CodeSniffer] via [your preferred method](https://github.com/PHPCSStandards/PHP_CodeSniffer#installation).
-> * Register the path to PHPCS in your system `$PATH` environment variable to make the `phpcs` command available from anywhere in your file system.
-> * Download the \[latest _YourStandardName_ release\] and unzip/untar it into an arbitrary directory.
->     You can also choose to clone the repository using git.
-> * Add the path to the directory in which you placed your copy of the _YourStandardName_ repo to the PHP_CodeSniffer configuration using the below command:
->
->    ```bash
->    phpcs --config-set installed_paths /path/to/YourStandardName
->    ```
->
->    **Warning**: :warning: The `installed_paths` command overwrites any previously set `installed_paths`. If you have previously set `installed_paths` for other external standards, run `phpcs --config-show` first and then run the `installed_paths` command with all the paths you need separated by comma's, i.e.:
->
->    ```bash
->    phpcs --config-set installed_paths /path/1,/path/2,/path/3
->    ```
-
-For things to continue working when you add PHPCSUtils to your standard, you need to replace the last bullet with this:
-
-> * **Next, download the [latest PHPCSUtils release][phpcsutils-releases] and unzip/untar it into an arbitrary directory.**
->     You can also choose to clone the repository using git.
-> * Add the path to the **directories** in which you placed your copy of the _YourStandardName_ repo **and the PHPCSUtils repo** to the PHP_CodeSniffer configuration using the below command:
->
->    ```bash
->    phpcs --config-set installed_paths /path/to/YourStandardName,/path/to/PHPCSUtils
->    ```
->
->    **Warning**: :warning: The `installed_paths` command overwrites any previously set `installed_paths`. If you have previously set `installed_paths` for other external standards, run `phpcs --config-show` first and then run the `installed_paths` command with all the paths you need separated by comma's, i.e.:
->
->    ```bash
->    phpcs --config-set installed_paths /path/1,/path/2,/path/3
->    ```
-
-#### Running your unit tests
-
-To support non-Composer based installs for running your sniff unit tests, you will need to adjust the PHPUnit `bootstrap.php` file to allow for passing an environment variable pointing to your PHPCSUtils installation.
-
-<details>
-  <summary><b>Example bootstrap code using a <code>PHPCSUtils_DIR</code> environment variable</b></summary>
-
-```php
-// Get the PHPCS dir from an environment variable.
-$phpcsUtilDir = getenv('PHPCSUtils_DIR');
-
-// This may be a Composer install.
-if ($phpcsUtilDir === false && file_exists(__DIR__ . '/vendor/autoload.php')) {
-    $vendorDir    = __DIR__ . '/vendor';
-    $phpcsUtilDir = $vendorDir . '/phpcsstandards/phpcsutils';
-
-    // Load the Composer autoload file.
-    require_once $vendorDir . '/autoload.php';
-
-    // This snippet is only needed when you use the PHPCSUtils TestUtils.
-    if (file_exists($phpcsUtilDir . '/phpcsutils-autoload.php')) {
-        require_once $phpcsUtilDir . '/phpcsutils-autoload.php';
-    }
-
-} elseif ($phpcsUtilDir !== false) {
-    $phpcsUtilDir = realpath($phpcsUtilDir);
-
-    require_once $phpcsUtilDir . '/phpcsutils-autoload.php';
-} else {
-    echo 'Uh oh... can\'t find PHPCSUtils.
-
-If you use Composer, please run `composer install`.
-Otherwise, make sure you set a `PHPCSUtils_DIR` environment variable in your phpunit.xml file
-pointing to the PHPCS directory.
-';
-
-    die(1);
-}
-```
-
-</details>
-
-Once that's done, you will need to make a small tweak to your own dev environment to get the unit tests running for a non-Composer based install:
-
-* Copy your project's `phpunit.xml.dist` file to `phpunit.xml`.
-* Add the following to the `phpunit.xml` file within the `<phpunit>` tags, replacing `/path/to/PHPCSUtils` with the path in which you installed PHPCSUtils on your local system:
-
-    ```xml
-    <php>
-        <env name="PHPCSUtils_DIR" value="/path/to/PHPCSUtils"/>
-    </php>
-    ```
-
-
-## Frequently Asked Questions
-
-<div class="faq">
-
-### Q: How does this all work without an external standard needing to register an autoloader?
-
-A: As PHPCSUtils is registered with PHPCS as an external standard and PHPCSUtils complies with the naming requirements of PHPCS, the PHPCS native autoloader will automatically take care of loading the classes used from PHPCSUtils.
-
-### Q: Does using PHPCSUtils have any effect on the PHPCS native sniffs?
-
-A: No. PHPCSUtils will only work for those sniffs which explicitly use the PHPCSUtils functionality.
-
-If your standard includes both PHPCS native sniffs as well as your own sniffs, your own sniffs can benefit from the back-compat layer offered by PHPCSUtils, as well as from the additional utility functions. However, the PHPCS native sniffs will not receive those benefits, as PHPCS itself does not use PHPCSUtils.
-
-### Q: Do the utilities work with javascript/CSS files?
-
-A: JS/CSS support will be removed from `PHP_CodeSniffer` in PHPCS 4.x.
-While at this time, some of the utilities _may_ work with JS/CSS files, PHPCSUtils does not offer formal support for JS/CSS sniffing with `PHP_CodeSniffer` and will stop any existing support once PHPCS 4.x has been released.
-
-### Q: Are all file encodings supported?
-
-A: No. The UTF-8 file encoding is the only officially supported encoding. Support for other encodings may incidentally work, but is not officially supported.
-
-> **It is recommended to advise your users to save their files as UTF-8 encoded for the best results.**
-
-Note: `PHP_CodeSniffer` 3.x defaults to UTF-8 as the expected file encoding.
-
-</div>
-
-
-## Potential Support Questions from your End-Users
-
-<div class="faq">
-
-### Q: A user reports a fatal "class not found" error for a class from PHPCSUtils
-
-1. Check that the version of PHPCSUtils the user has installed complies with the minimum version of PHPCSUtils your standard requires. If not, they will need to upgrade.
-2. If the version is correct, this indicates that the end-user does not have PHPCSUtils installed and/or registered with PHP_CodeSniffer.
-    - Please review your standard's installation instructions to make sure that PHPCSUtils will be installed when those are followed.
-    - Inform the user to install PHPCSUtils and register it with PHP_CodeSniffer.
-
----
-
-> :bulb: **Pro-tip**: if you want to prevent the fatal error and show a _friendlier_ error message instead, add `<rule ref="PHPCSUtils"/>` to your standard's `ruleset.xml` file.
->
-> With that in place, `PHP_CodeSniffer` will show a _"ERROR: the "PHPCSUtils" coding standard is not installed."_ message if PHPCSUtils is missing as soon as the ruleset loading is finished.
-
----
-
-> :bulb: **Pro-tip**: provide upgrade instructions for your end-users. For Composer-based installs, those should look like this:
->
-> ```bash
-> composer update your/cs-package --with-[all-]dependencies
-> ```
->
-> That way, when the user updates your coding standards package, they will automatically also update PHPCSUtils.
-
----
-
-</div>
-
-
-## Contributing
-
-Contributions to this project are welcome. Clone the repo, branch off from `develop`, make your changes, commit them and send in a pull request.
-
-If you are unsure whether the changes you are proposing would be welcome, please open an issue first to discuss your proposal.
-
-
-## License
-
-This code is released under the [GNU Lesser General Public License (LGPLv3)](LICENSE).
-
-
-[PHP_CodeSniffer]:       https://github.com/PHPCSStandards/PHP_CodeSniffer
-[Composer PHPCS plugin]: https://github.com/PHPCSStandards/composer-installer
-[phpcsutils-repo]:       https://github.com/PHPCSStandards/PHPCSUtils
-[phpcsutils-web]:        https://phpcsutils.com/
-[phpcsutils-packagist]:  https://packagist.org/packages/phpcsstandards/phpcsutils
-[phpcsutils-releases]:   https://github.com/PHPCSStandards/PHPCSUtils/releases
-[phpcsutils-tests-gha]:  https://github.com/PHPCSStandards/PHPCSUtils/actions/workflows/test.yml