arc-phpstan

Use phpstan to lint your PHP source code with Phabricator's arc command line tool., _(*3)

Features

phpstan generates warning messages., _(*4)

Example output:, _(*5)

>>> Lint for src/AppBundle/Foo.php:


Error  () phpstan violation
Error: AppBundle\Foo::__construct() does not
call parent constructor from AppBundle\Bar.

          33      * constructor
          34      */
>>>       35     public function __construct()
          36     {
          37         Bar::__construct();
          38         $this->property = 0;

Installation

phpstan is required. You can follow the official instructions to install and put it on your $PATH, or you can run composer install and point the bin option to vendor/bin/phpstan, as in the example below., _(*6)

Project-specific installation

You can add this repository as a git submodule. Add a path to the submodule in your .arcconfig like so:, _(*7)

{
  "load": ["path/to/arc-phpstan"]
}

Global installation

arcanist can load modules from an absolute path. But it also searches for modules in a directory up one level from itself., _(*8)

You can clone this repository to the same directory where arcanist and libphutil are located. In the end it will look like this:, _(*9)

arcanist/
arc-phpstan/
libphutil/

Your .arcconfig would look like, _(*10)

{
  "load": ["arc-phpstan"]
}

Setup

To use the linter you must register it in your .arclint file, as in this example, _(*11)

{
  "linters": {
    "phpstan": {
      "type": "phpstan",
      "include": "(\\.php$)",
      "config": "var/build/phpstan.neon", /* optional */
      "bin": "vendor/bin/phpstan", /* optional */
      "level": "0" /* optional */
    }
  }
}