feat(ci): add scripts to quickly check and fix code styles (#8469)

Author: bshaffer

CONTRIBUTING.md

@@ -106,16 +106,35 @@ Please note that because Datastore and Firestore cannot be active in the same pr
 $ export GOOGLE_CLOUD_PHP_FIRESTORE_TESTS_KEY_PATH='/path/to/keyfile.json'
 ```
 
-## Coding Style
+### Coding Style
 
 Please follow the established coding style in the library. Google Cloud PHP follows the [PSR-2](https://www.php-fig.org/psr/psr-2/) Coding Style.
+This is enforced using both [PHP CS Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer) and [PHP Code Sniffer](https://github.com/squizlabs/PHP_CodeSniffer).
 
-You can check your code against these rules by running PHPCS with the proper ruleset, like this:
+You can run both of these checks using the `style-check` composer script:
 
 ```sh
-$ composer style
+$ composer style-check
 ```
 
+If these changes look correct, you can automatically fix the issues by running this command:
+
+```sh
+$ composer style-fix
+```
+
+### Static Analysis
+
+Run PHPStan for static analysis with the following command.
+
+```sh
+$ composer phpstan
+```
+
+Any errors here will have to be fixed manually.
+
+**NOTE**: PHP CS Fixer does not check for or fix line lengths or trailing whitespace, which is the primary reason we use both libraries.
+
 ## Owlbot
 
 This repository is using OwlBot for copying code from the generated library in

composer.json

@@ -2,6 +2,19 @@
     "name": "google/cloud",
     "type": "library",
     "description": "Google Cloud Client Library",
+    "scripts": {
+        "style-check": [
+            "vendor/bin/php-tools cs-fixer googleapis/google-cloud-php --ref $(git rev-parse --abbrev-ref HEAD)",
+            "vendor/bin/phpcs --standard=phpcs-ruleset.xml -p"
+        ],
+        "style-fix": [
+            "vendor/bin/php-tools cs-fixer googleapis/google-cloud-php --ref $(git rev-parse --abbrev-ref HEAD) --flags \"\"",
+            "vendor/bin/phpcbf --standard=phpcs-ruleset.xml -p"
+        ],
+        "phpstan": [
+            "dev/sh/static-analysis"
+        ]
+    },
     "keywords": [
         "google apis client",
         "google api client",
@@ -64,7 +77,8 @@
         "phpspec/prophecy-phpunit": "^2.1",
         "kreait/firebase-php": "^6.9",
         "psr/log": "^2.0||^3.0",
-        "dg/bypass-finals": "^1.7"
+        "dg/bypass-finals": "^1.7",
+        "squizlabs/php_codesniffer": "3.*"
     },
     "replace": {
         "google/access-context-manager": "1.0.4",