README

PHP_CodeSniffer 是一个 PHP5 脚本，用于对 PHP、JavaScript 和 CSS 文件进行标记化，以检测违反定义的编码标准。它是确保您的代码保持清洁和一致性的重要开发工具。它还可以帮助防止开发者犯下的某些常见语义错误。

要求

PHP_CodeSniffer 需要 PHP 版本 5.1.2 或更高版本，尽管单个嗅探器可能还有额外的要求，例如外部应用程序和脚本。有关这些要求的列表，请参阅配置选项手册页面。

由于使用了垂直空白字符，SVN 预提交钩子需要 PHP 版本 5.2.4 或更高版本。

安装

安装 PHP_CodeSniffer 最简单的方法是使用 PEAR 安装程序。这将使 phpcs 命令立即可用。要使用 PEAR 安装程序安装 PHP_CodeSniffer，请首先确保您已经安装了 PEAR，然后运行以下命令

pear install PHP_CodeSniffer

如果您使用Composer，请在您的 composer.json 文件中包含对 squizlabs/php_codesniffer 的依赖项。例如

{
    "require": {
        "squizlabs/php_codesniffer": "1.*"
    }
}

然后您就可以从 vendor bin 目录运行 PHP_CodeSniffer 了

./vendor/bin/phpcs -h

您还可以下载 PHP_CodeSniffer 源代码，并直接从 GIT 检出运行 phpcs 命令

git clone git://github.com/squizlabs/PHP_CodeSniffer.git
cd PHP_CodeSniffer
php scripts/phpcs -h

文档

PHP_CodeSniffer 的文档可在PEAR 手册中找到。

有关即将推出的功能和版本的信息可在Squiz Labs 博客上找到。

贡献

如果您为 PHP_CodeSniffer 贡献了代码，请确保它符合 PEAR 编码标准，并且 PHP_CodeSniffer 单元测试仍然通过。最简单的贡献方法是检查库的检出来源，或者您自己的分支，而不是安装的 PEAR 版本。如果您这样做，可以运行以下命令来检查是否已准备好提交

cd PHP_CodeSniffer
php scripts/phpcs --ignore=*/tests/* . -n

这将不产生任何输出，表明没有 PEAR 编码标准错误。然后

phpunit tests/AllTests.php

这将不产生任何失败或错误。您可以忽略任何跳过的测试，因为这些是为外部工具而设的。

问题

可以在PEAR 错误跟踪器上提交错误报告和功能请求。