忽略PHP_CodeSniffer中的代码片段

时间:2010-11-29 17:26:51

标签: php codesniffer

PHP_CodeSniffer分析时,可以忽略php文件中的部分代码?

3 个答案:

答案 0 :(得分:76)

是的,可以使用@codingStandardsIgnoreStart和@codingStandardsIgnoreEnd注释

<?php
some_code();
// @codingStandardsIgnoreStart
this_will_be_ignored();
// @codingStandardsIgnoreEnd
some_other_code();

还描述了in the documentation.

答案 1 :(得分:31)

您可以使用组合:@codingStandardsIgnoreStart@codingStandardsIgnoreEnd,也可以使用@codingStandardsIgnoreLine

示例:

<?php

command1();
// @codingStandardsIgnoreStart
command2(); // this line will be ignored by Codesniffer
command3(); // this one too
command4(); // this one too
// @codingStandardsIgnoreEnd

command6();

// @codingStandardsIgnoreLine
command7(); // this line will be ignored by Codesniffer

答案 2 :(得分:4)

在版本3.2.0之前,PHP_CodeSniffer使用不同的语法来忽略文件中的部分代码。请参阅Anti Veeranna'sMartin Vseticka's的答案。旧语法将在版本4.0中删除

PHP_CodeSniffer现在使用// phpcs:disable// phpcs:enable注释来忽略部分文件,而// phpcs:ignore则忽略一行。

现在,也可以仅禁用或启用特定的错误消息代码,嗅探,嗅探类别或整个编码标准。您应在评论后指定它们。如果需要,您可以添加一条注释,解释为什么使用--分隔符来禁用和重新启用嗅探。

<?php

/* Example: Ignoring parts of file for all sniffs */
$xmlPackage = new XMLPackage;
// phpcs:disable
$xmlPackage['error_code'] = get_default_error_code_value();
$xmlPackage->send();
// phpcs:enable

/* Example: Ignoring parts of file for only specific sniffs */
// phpcs:disable Generic.Commenting.Todo.Found
$xmlPackage = new XMLPackage;
$xmlPackage['error_code'] = get_default_error_code_value();
// TODO: Add an error message here.
$xmlPackage->send();
// phpcs:enable

/* Example: Ignoring next line */
// phpcs:ignore
$foo = [1,2,3];
bar($foo, false);

/* Example: Ignoring current line */
$foo = [1,2,3]; // phpcs:ignore
bar($foo, false);

/* Example: Ignoring one line for only specific sniffs */
// phpcs:ignore Squiz.Arrays.ArrayDeclaration.SingleLineNotAllowed
$foo = [1,2,3];
bar($foo, false);

/* Example: Optional note */ 
// phpcs:disable PEAR,Squiz.Arrays -- this isn't our code
$foo = [1,2,3];
bar($foo,true);
// phpcs:enable PEAR.Functions.FunctionCallSignature -- check function calls again
bar($foo,false);
// phpcs:enable -- this is out code again, so turn everything back on

有关更多详细信息,请参见PHP_CodeSniffer's documentation