Download the PHP package best-it/php_codesniffer without Composer

On this page you can find all versions of the php package best-it/php_codesniffer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package php_codesniffer

best it PHP_CodeSniffer

Build Status Build Status Scrutinizer Code Quality Code Coverage

This package contains a default rule set and custom rules which are used in all best it projects.

Installation

Our PHP_CodeSniffer package can be installed with composer with the following command:

Please use Version 1 for PHP 7.0!

Usage

Create a PHP_CodeSniffer configuration (phpcs.xml.dist / phpcs.xml) like this:

If you want to sniff for special PHP Versions just declare a "testVersion" like:

and include

after you included our ruleset. (Don't forget to dev-require phpcompatibility/php-compatibility:^9.0.)

Execute the PHP_CodeSniffer (path can vary on your composer configuration):

We use warnings for things which a human person should check, but which must not fail an automatic build. If you want to see warnings but get successful builds, call the code sniffer with the special config option _ignore_warnings_onexit:

or, if you want the option only for a single run:

Check original docs for more info.

If you want to ignore warnings altogether, you can provide the cli argument n:

We suggest that you do not ignore warnings, but only check them in a manual pull/merge request.

Use in PHPStorm

How to use it in our favorite IDE?

/File/Settings:

  1. ... and choose our ruleset.

Used sniffs

The base for the BestIt Standard is PSR-12.

Sniff Description suppressable
BestIt.Classes.ModernClassNameReference.ClassNameReferencedViaFunctionCall You MUST use ::class instead of functions. no
BestIt.Classes.ModernClassNameReference.ClassNameReferencedViaMagicConstant You MUST use ::class instead of CLASS. no
BestIt.Commenting.ClassDoc.DocCommentUcFirst Every doc comment block SHOULD start ucfirst. no
BestIt.Commenting.ClassDoc.NoLineAfterDocComment Every doc comment block (the summary or a long description paragrah) SHOULD finish with double newline. no
BestIt.Commenting.ClassDoc.NoSummary There MUST be a summary. no
BestIt.Commenting.ClassDoc.SummaryTooLong The summary SHOULD be in one line. no
BestIt.Commenting.ConstantDoc.DocCommentUcFirst Every doc comment block SHOULD start ucfirst. no
BestIt.Commenting.ConstantDoc.NoLineAfterDocComment Every doc comment block (the summary or a long description paragrah) SHOULD finish with double newline. no
BestIt.Commenting.ConstantDoc.NoSummary There MUST be a summary. no
BestIt.Commenting.ConstantDoc.SummaryTooLong The summary SHOULD be in one line. no
BestIt.Commenting.EmptyLinesDoc.EmptyLinesFound There MUST be no redundant lines in your doc block. no
BestIt.Commenting.FunctionDoc.DocCommentUcFirst Every doc comment block SHOULD start ucfirst. no
BestIt.Commenting.FunctionDoc.NoLineAfterDocComment Every doc comment block (the summary or a long description paragrah) SHOULD finish with double newline. no
BestIt.Commenting.FunctionDoc.NoSummary There MUST be a summary. no
BestIt.Commenting.FunctionDoc.SummaryTooLong The summary SHOULD be in one line. no
BestIt.Commenting.PropertyDoc.DocCommentUcFirst Every doc comment block SHOULD start ucfirst. no
BestIt.Commenting.PropertyDoc.NoLineAfterDocComment Every doc comment block (the summary or a long description paragrah) SHOULD finish with double newline. no
BestIt.Commenting.PropertyDoc.NoSummary There MUST be a summary. no
BestIt.Commenting.PropertyDoc.SummaryTooLong The summary SHOULD be in one line. no
BestIt.Commenting.RedundantWhitespace.RedundantWhitespace There MUST be no additonal spaces around your doc tags. no
BestIt.Comparisons.EmptyArrayForComparison.EmptyArray You MUST not create an empty array, to check for an empty array. no
BestIt.Comparisons.EqualOperator.EqualOperatorFound You MUST use the "Identical" operator (===). yes
BestIt.Comparisons.ParasOfNegativeInstanceOf.ParasAroundNegativeInstanceOfMissing You MUST provide parentheses around your negative instanceof check. no
BestIt.DocTags.AuthorTag.TagContentFormatInvalid You MUST commit to your codes and give an author tag. no
BestIt.DocTags.DeprecatedTag.MissingDates The error code for the missing dates. no
BestIt.DocTags.DeprecatedTag.TagContentFormatInvalid If you provide a deprecated tag, you MUST provide it with versions since when its deprecated and when it will be removed. no
BestIt.DocTags.DisallowedClassTags.TagNotAllowed You MUST not give one of the disallowed tags in your doc comment. no
BestIt.DocTags.DisallowedConstantTags.TagNotAllowed You MUST not give one of the disallowed tags in your doc comment. no
BestIt.DocTags.DisallowedMethodTags.TagNotAllowed You MUST not give one of the disallowed tags in your doc comment. no
BestIt.DocTags.DisallowedPropertyTags.TagNotAllowed You MUST not give one of the disallowed tags in your doc comment. no
BestIt.DocTags.PackageTag.TagContentFormatInvalid You MUST provide a special tag format. no
BestIt.DocTags.PackageTag.WrongPackage If there is a namespace, you MUST provide this namespace as package tag. no
BestIt.DocTags.ParamTag.MissingDesc You SHOULD provide a description for your parameter. no
BestIt.DocTags.ParamTag.MissingType You MUST provide a type for your param tag. no
BestIt.DocTags.ParamTag.MissingVariable Your method MUST have a matching variable for your param tag. no
BestIt.DocTags.ParamTag.MissingVariables Your method MUST have parameters if there is a param tag. no
BestIt.DocTags.ParamTag.MixedType You SHOULD prevent the mixed type and try to provide native types. no
BestIt.DocTags.ParamTag.TagContentFormatInvalid You MUST provide a special tag format. no
BestIt.DocTags.RequiredClassTags.TagOccurrenceMax You MUST provide only the maximum amount of required tags. For example, only one return per method is allowed. The error is registered for every tag specifically. no
BestIt.DocTags.RequiredClassTags.TagOccurrenceMin You MUST provide the required tags. The error is registered for every tag specifically. no
BestIt.DocTags.RequiredMethodTags.TagOccurrenceMax You MUST provide only the maximum amount of required tags. For example, only one return per method is allowed. The error is registered for every tag specifically. no
BestIt.DocTags.RequiredMethodTags.TagOccurrenceMin You MUST provide the required tags. The error is registered for every tag specifically. no
BestIt.DocTags.RequiredPropertyTags.TagOccurrenceMax You MUST provide only the maximum amount of required tags. For example, only one return per method is allowed. The error is registered for every tag specifically. no
BestIt.DocTags.RequiredPropertyTags.TagOccurrenceMin You MUST provide the required tags. The error is registered for every tag specifically. no
BestIt.DocTags.TagSorting.MissingNewlineBetweenTags You SHOULD separate tag groups and the final return with a newline. yes by class
BestIt.DocTags.TagSorting.WrongTagSorting You SHOULD sort the tags by their occurrence and then alphabetically, but @return SHOULD be the last. yes by class
BestIt.DocTags.ThrowsTag.MissingThrowDescription You SHOULD provide a description your throw tag. no
BestIt.DocTags.ThrowsTag.TagContentFormatInvalid You MUST provide a special tag format. no
BestIt.DocTags.VarTag.TagContentFormatInvalid You MUST provide a type for your var tag. no
BestIt.DocTags.VersionTag.TagContentFormatInvalid If you provide a version tag, you MUST provide it in semver 2.0-Format with Major.Minor.Patch-Version . no
BestIt.Formatting.AlphabeticClassContent.SortAlphabetically You SHOULD sort you constants, methods and properties alphabetically. no
BestIt.Formatting.AlphabeticallySortedUses.IncorrectlyOrderedUses You MUST provide your imports in alphabetically order, PSR-12 compatible. no
(BestIt.Formatting.NoWhitespaceAfterClassOpening.IncorrectEmptyLinesAfterOpeningBrace There MUST be no lines after the opening brace. no
(BestIt.Formatting.NoWhitespaceAfterClassOpening.IncorrectEmptyLinesBeforeClosingBrace There MUST be no lines before the closing brace. no
BestIt.Formatting.OpenTag.LineNotEmpty The next line after the open tag MUST be empty. no
BestIt.Formatting.OpenTag.NoSpaceAfterOpenTag There MUST be whitespace after the open tag. no
BestIt.Formatting.OpenTag.OpenTagNotFirstStatement After the open tag there MUST be an empty line. no
BestIt.Formatting.ReturnTypeHintSpacingSniff.NoSpaceBetweenColonAndTypeHint There MUST be no whitespace after the return type colon.
BestIt.Formatting.ReturnTypeHintSpacingSniff.WhitespaceBeforeColon There MUST be no whitespace before the return type colon.
BestIt.Formatting.TrailingArrayComma.MissingTrailingComma You MUST add a trailing comma to your multi line arrays. no
BestIt.Formatting.TrailingCommaInDeclaration.MissingTrailingComma Enforces a trailing command in method declaration if there is a line wrap. no
BestIt.Formatting.TraitUseDeclaration.MultipleTraitsPerDeclaration You MUST provide only one "use" per Line for importing traits etc. in classes. no
BestIt.Formatting.UCVFSorting.WrongPosition You MUST sort the contents of your classes, traits, interface, etc. in the following order: T_USE, T_CONST, T_VARIABLE, T_FUNCTION. no
BestIt.Functions.FluentSetter.MustReturnThis Every setter function MUST return $this if nothing else is returned. no
BestIt.Functions.FluentSetter.NoReturnFound Your method MUST contain a return. yes
BestIt.Functions.ForbiddenFunctions.Discouraged You SHOULD not use eval. yes
BestIt.Functions.ForbiddenFunctions.DiscouragedWithAlternative You SHOULD not use alias but the original function names. yes
BestIt.Functions.MultipleReturn.MultipleReturnsFound You SHOULD only use a return per method. no
BestIt.Functions.NoNamedArguments.DisallowedNamedArgument You MUST not use named arguments. no
BestIt.Functions.NoSimplePropertyMethod.ShouldUseTypedPropertyDirectly You SHOULD use the typed property directly instead of the the simple getter-/setter-combination. yes
BestIt.Functions.TrailingCommaInCall.MissingTrailingComma You MUST append a trailing command in your multi line function calls. no
BestIt.NamingConventions.CamelCaseVariable.NotCamelCase You MUST provide your vars in camel case, lower case first. yes
BestIt.Spacing.ClassMemberSpacing.IncorrectCountOfBlankLinesBetweenMembers Class members MUST be separated with one line. no
BestIt.Spacing.ConstantSpacing.IncorrectCountOfBlankLinesAfterConstant A constant MUST be separated with one line. no
BestIt.Spacing.NamespaceSpacing.IncorrectLinesCountAfterNamespace There MUST be one line after the namespace. no
BestIt.Spacing.NamespaceSpacing.IncorrectLinesCountBeforeNamespace There MUST be one line before the namespace. no
BestIt.Spacing.PropertySpacing.IncorrectCountOfBlankLinesAfterProperty There MUST be one line after a property. no
BestIt.Spacing.SpaceAfterDeclare.GroupBlankLineFound Multiple declare-statements SHOULD be grouped without a blank line. no
BestIt.Spacing.SpaceAfterDeclare.MuchWhitespaceFound THERE MUST be just one single line after the declare statement. no
BestIt.Spacing.SpaceAfterDeclare.NoWhitespaceFound There MUST be one empty line after declare-statement. no
BestIt.Spacing.SpaceAroundConcat.MissingSpaceAroundConcat You MUST wrap your concat-dot with a whitespace char. no
BestIt.Spacing.TraitUseSpacing.IncorrectLinesCountAfterLastUse You MUST not provide additional lines after your last rait usage. no
BestIt.Spacing.TraitUseSpacing.IncorrectLinesCountBeforeFirstUse You MUST not provide additional new lines before your first trait use. no
BestIt.Spacing.TraitUseSpacing.IncorrectLinesCountBetweenUses You MUST not provide additional new lines between trait usages. no
BestIt.Spacing.UseSpacing.IncorrectLinesCountAfterLastUse There MUST be one line after the last usage. no
BestIt.Spacing.UseSpacing.IncorrectLinesCountBeforeFirstUse There MUST be one line before the first usage. no
BestIt.Spacing.UseSpacing.IncorrectLinesCountBetweenDifferentTypeOfUse There must be no line betweeen different usages. no
BestIt.Spacing.UseSpacing.IncorrectLinesCountBetweenSameTypeOfUse The MUST be no line between same usages. no
BestIt.Strings.ConcatCalculationSniff.CalculationWithoutBrackets You MUST encapsulate your calculation with brackets. no
BestIt.TypeHints.ExplicitAssertions.RequiredExplicitAssertion Use assertion instead of inline documentation comment. no
BestIt.TypeHints.PropertyTypeHint.MissingAnyTypeHint MUST have any type hint if possible. yes
BestIt.TypeHints.PropertyTypeHint.MissingNativeTypeHint MUST have a native type hint (matching the doc block.) yes
BestIt.TypeHints.ReturnTypeDeclaration.MissingReturnTypeHint Every function or method MUST have a type hint if the return annotation is valid. yes
BestIt.TypeHints.SuggestExplicitReturnType.MixedType You SHOULD not use a mixed type but an explicit native return type. yes
Generic.Formatting.SpaceAfterCast There MUST be a space after cast.
Generic.Arrays.DisallowLongArraySyntax Every array syntax MUST be in short array syntax.
SlevomatCodingStandard.Classes.ClassConstantVisibility.MissingConstantVisibility Constants MUST be marked with a visibility.
SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly.ReferenceViaFullyQualifiedName No class may be used via its FQCN. You MUST import every class!
SlevomatCodingStandard.TypeHints.DeclareStrictTypes Every file MUST have "declare(strict_types=1);" two line breaks after the opening tag. There MUST be no spaces aroung the equal-sign.
Squiz.Strings.DoubleQuoteUsage Every String MUST be wrapped with single quotes.

Development

Introduction

The code sniffer is based on a token-based sniff mechanism.

You can use the verbose-options of the code sniffer cli, to see which tokens are parsed on which position in your file. Please consult the official code sniffer tutorial to know the theory how to code a custom sniff.

The gist of this tutorial is, that you need to implement the interface _PHPCodeSniffer\Sniffs\Sniff which enforces two methods:

1. Token Registration

The register-method should return the parser token id of the tokens, which you want to sniff.

2. Process

The process-method is called with the position of your registered token in the token stack of the given file object.

best it "Helpers"

BestIt\Sniffs\AbstractSniff

We refactored our basic work into this abstract. You can use an extended api to get a cleaner api and skips simple boilerplating.

The CodeSniffer is meant to be stateless even if the sniff-classes are used as "singletons". So if you save a state in your sniff, you MUST tearDown afterwards or initialize correctly in the setUp.

BestIt\Sniffs\DocTags\AbstractTagSniff

This abstract class helps you sniff for single doc tags. Just implement the given abstract methods and you can register and sniff for a specific doc tag and check for its content till a newline.

BestIt\Sniffs\DocTags\TagContentFormatTrait

This trait is meant in addition to the AbstractTagSniff and provides you with an api, which checks the tag content automatically against a regex pattern, which leads to an error or warning with the code TagContentFormatInvalid.

BestIt\Sniffs*RegistrationTrait

We provide some traits, which make it easier, to register sniffs for class-like structures, constants, methods and properties.

Testing

Requirements

To be able to test our written sniffs ensure that composer is installed with the option --prefer-source. This is needed because we use the TestCase of the SlevomatCodingStandard.

Error code as public constant

In additional to readable/clean clode our test base requires you to provide your error codes as a public constant prefixed with CODE_ in your sniff class.

No "Test"-Namespace

Our test base expects you to provide everything in the "normal" namespace: BestIt.

Helping test traits

Token Registration

The trait BestIt\Sniffs\TestTokenRegistrationTrait helps you with testing of the registered tokens.

Public error codes

The trait BestIt\Sniffs\TestRequiredConstantsTrait helps you to test the errors codes. We suggest that you test the values as well, because they could be part of a "foreign ruleset" out of your control from your "customer." So we enforce that the constant values stay api-stable!

Default Integration Tests

The trait BestIt\Sniffs\DefaultSniffIntegrationTestTrait provides you with three tests to test the usually use cases of a sniff based on sniff-individual test files:

  1. testCorrect
  2. testErrors
  3. testWarnings
Requirements
testCorrect

Create a correct folder into your fixtures directory. Every php file in this folder will be checked against your sniff. The sniff may not populate errors and warning for a successful test!

testErrors

Create a _witherrors folder into your fixtures directory. Every php file in this folder should trigger an error in your sniff. You must provide the error structure through the file name. The file name must match the following pregex:

The file name gives information about which errors in which line should occur. Example files would be ErrorCode.1.php, ErrorCode.1,2,3.php, ErrorCode.1,2,3.fixed.php, ErrorCode(2).1,2,3.php, ErrorCode(2).1,2,3.fixed.php_. The error code must be the original code value from your sniff, the numbers after the first dot are the erroneous lines.

If you provide an additional file which is suffixed with "fixed" then this is the correct formatted file for its erroneous sibling.

testWarnings

Create a _withwarnings folder into your fixtures directory. Every php file in this folder should trigger a warning in your sniff. You must provide the warning structure through the file name. The file name must match the following pregex:

The file name gives information about which warning in which line should occur. Example files would be WarningCode.1.php, WarningCode.1,2,3.php, WarningCode.1,2,3.fixed.php, WarningCode(2).1,2,3.php, WarningCode(2).1,2,3.fixed.php_. The warning code must be the original code value from your sniff, the numbers after the first dot are the lines with warnings.

If you provide an additional file which is suffixed with "fixed" then this is the correct formatted file for its erroneous sibling.

Contributing

See CONTRIBUTING.md.

Semantic Versioning

We use semantic versioning in correlation with the style enforced by our ruleset and not directly with our source code. This means, that there could be breaking change in our code, but as long as the style is not changed heavily, then the breaking change will not be mirrored in our version number:

We optimize our versioning for the usage of the sniffer, not for the development!

TODO


All versions of php_codesniffer with dependencies

PHP Build Version
Package Version
Requires php Version >=8.0
slevomat/coding-standard Version ^8.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package best-it/php_codesniffer contains the following files

Loading the files please wait ....