PHPStanBear: Add PHPStanBear

Introduce PHPStanBear
Checks the code with ``phpstan analyze``.
Closes coala#1426

bears/php/PHPStanBear.py

@@ -0,0 +1,44 @@
+import os
+
+from coalib.bearlib.abstractions.Linter import linter
+
+
+@linter(executable='phpstan',
+        output_format='regex',
+        output_regex=r'(?P<line>\d+)  (?P<message>.*)')
+class PHPStanBear:
+    """
+    Checks the code with ``phpstan analyze``.
+    This can run it on multiple files and folders.
+    See <https://github.com/phpstan/phpstan> for more information.
+    """
+    LANGUAGES = {'PHP'}
+    AUTHORS = {'The coala developers'}
+    AUTHORS_EMAILS = {'[email protected]'}
+    LICENSE = 'AGPL-3.0'
+    CAN_DETECT = {'Syntax', 'Unused Code', 'Variable Misuse',
+                  'Undefined Element', 'Missing Import', 'Spelling'}
+
+    @staticmethod
+    def create_arguments(filename, file,
+                         config_file,
+                         phpstan_level: str='0',
+                         phpstan_config: str=''):
+        """
+        :param phpstan_config:
+            path to a custom configuration file.
+            When using a custom project config file,
+            phpstan_level is set to 1
+            (as default value 0 does not apply here).
+        :param phpstan_level:
+            To set rule levels.
+            0 is the loosest and 4 is the strictest.
+            See <https://github.com/phpstan/phpstan> for more information.
+        """
+        args = ('analyse',)
+        if phpstan_config:
+            phpstan_level = '1'
+            args += ('--level='+phpstan_level, '-c '+phpstan_config, filename,)
+        else:
+            args += ('--level='+phpstan_level, filename,)
+        return args

tests/php/PHPStanBearTest.py

@@ -0,0 +1,36 @@
+import os
+from queue import Queue
+from shutil import which
+from unittest.case import skipIf
+
+from bears.php.PHPStanBear import PHPStanBear
+from coalib.testing.LocalBearTestHelper import LocalBearTestHelper
+from coalib.settings.Section import Section
+
+
+@skipIf(which('phpstan') is None, 'PHPStan is not installed')
+class PHPStanTest(LocalBearTestHelper):
+
+    def setUp(self):
+        self.section = Section('test section')
+        self.uut = PHPStanBear(self.section, Queue())
+        self.test_file1 = os.path.join(os.path.dirname(__file__),
+                                       'test_files',
+                                       'phplint_test1.php')
+        self.test_file2 = os.path.join(os.path.dirname(__file__),
+                                       'test_files',
+                                       'phplint_test2.php')
+
+    def test_run(self):
+        # Test a file with errors and warnings
+        self.check_validity(
+            self.uut,
+            [],
+            self.test_file1,
+            valid=False)
+
+        # Test a file without any issues
+        self.check_validity(
+            self.uut,
+            [],
+            self.test_file2)