Download the PHP package sirbrillig/phpcs-import-detection without Composer

On this page you can find all versions of the php package sirbrillig/phpcs-import-detection. 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 phpcs-import-detection

ImportDetection

A set of phpcs sniffs to look for unused or unimported symbols.

This adds a sniff which shows warnings if a symbol (function, constant, class) is used and is not defined directly, imported explicitly, nor has its namespace imported.

[!WARNING] PHP 8 changed how use statements are tokenized, leading to this bug which basically breaks this sniff. This sniff also has fairly poor performance. I don't have time with my current work to continue to refactor this sniff at the moment and I wouldn't recommend it until at least that issue is fixed. If anyone wants to work on improvements, feel free to open a PR!

When code is moved around, it can be problematic if classes which are used in a relative or global context get moved to a different namespace. In those cases it's better if the classes use their fully-qualified namespace, or if they are imported explicitly using use (in which case they can be detected by a linter like this one). These warnings should help when refactoring code to avoid bugs.

It also detects imports which are not being used.

For example:

Note: This sniff is a lightweight syntax checker providing a scan of the current file and it doesn't know what other files might have defined. Therefore it will warn you about implicitly imported symbols even if they're in the same namespace. It's safe to import something from the same namespace and can even improve readability, but if you'd prefer to scan multiple files, I suggest using static analysis tools like psalm or phpstan.

Installation

To use these rules in a project which is set up using composer, we recommend using the phpcodesniffer-composer-installer library which will automatically use all installed standards in the current project with the composer type phpcodesniffer-standard when you run phpcs.

Configuration

When installing sniff standards in a project, you edit a phpcs.xml file with the rule tag inside the ruleset tag. The ref attribute of that tag should specify a standard, category, sniff, or error code to enable. It’s also possible to use these tags to disable or modify certain rules. The official annotated file explains how to do this.

Sniff Codes

There are two sniff codes that are reported by this sniff. Both are warnings.

In any given file, you can use phpcs comments to disable these sniffs. For example, if you have a global class called MyGlobalClass which you don't want to import, you could use it like this:

For a whole file, you can ignore a sniff like this:

For a whole project, you can use the phpcs.xml file to disable these sniffs or modify their priority. For example, to disable checks for unused imports, you could use a configuration like this:

Ignoring Symbol Patterns

Oftentimes there might be global symbols that you want to use without importing or using a fully-qualified path.

(Remember that function call resolution first searches the current namespace, then the global namespace, but constant and class resolution only searches the current namespace! You still have to import things like Exception or use the fully-qualified \Exception.)

You can ignore certain patterns by using the ignoreUnimportedSymbols config option. It is a regular expression. Here is an example for some common WordPress symbols:

Despite the name, you can also use the ignoreUnimportedSymbols pattern to ignore specific unused imports.

Ignoring Global Symbols in Global Namespace

If a file is in the global namespace, then sometimes it may be unnecessary to import functions that are also global. If you'd like to ignore global symbol use in the global namespace, you can enable the ignoreGlobalsWhenInGlobalScope option, like this:

Ignoring WordPress Patterns

A common use-case is to ignore all the globally available WordPress symbols. Rather than trying to come up with a pattern to ignore them all yourself, you can set the config option ignoreWordPressSymbols which will ignore as many of them as it knows about. For example:

Usage

Most editors have a phpcs plugin available, but you can also run phpcs manually. To run phpcs on a file in your project, just use the command-line as follows (the -s causes the sniff code to be shown, which is very important for learning about an error).

See Also


All versions of phpcs-import-detection with dependencies

PHP Build Version
Package Version
Requires php Version ^7.0 || ^8.0
squizlabs/php_codesniffer Version ^3.5.8
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 sirbrillig/phpcs-import-detection contains the following files

Loading the files please wait ....