首先安装PHPCS和PHPStan作为开发依赖，接着配置phpcs.xml和phpstan.neon定义检查规则，然后在composer.json中添加lint、phpcs、phpstan等脚本命令，最后通过composer lint运行检查或结合Git钩子实现提交前自动检测，提升代码质量与团队协作效率。

在PHP项目开发中，保持代码质量至关重要。通过将PHPCS（PHP Code Sniffer）和PHPStan集成到Composer Scripts中，可以在日常开发流程中自动执行静态分析，帮助团队及早发现潜在问题。这种方式无需依赖外部CI工具即可在本地运行检查，提升协作效率。

安装PHPCS与PHPStan

首先需要通过Composer将代码质量工具作为开发依赖安装：

安装完成后，项目根目录下会多出vendor/bin/phpcs和vendor/bin/phpstan两个可执行文件。接下来配置它们的行为方式。

配置PHPCS规则

创建phpcs.xml或phpcs.xml.dist文件定义编码规范。例如使用PSR-12标准并指定扫描目录：

    
    src/
    tests/
    

这样PHPCS就知道检查哪些文件以及遵循什么规则。

配置PHPStan基础级别

添加phpstan.neon配置文件来启用基本的静态分析：

parameters:
    level: 5
    paths:
        - src/
        - tests/

PHPStan的level从0到9，数字越高检查越严格。从level 5开始是大多数项目的合理选择。

定义Composer Scripts

打开composer.json，在scripts部分添加自定义命令：

"scripts": {
    "lint": [
        "@phpcs",
        "@phpstan"
    ],
    "phpcs": "phpcs",
    "phpstan": "phpstan analyse --no-progress"
}

现在可以通过以下命令统一执行检查：

该命令会依次运行PHPCS和PHPStan。如果任一工具报错，进程将中断，确保问题不会被忽略。

结合Git钩子实现自动化

进一步提升体验的方式是结合git hooks，在提交代码前自动运行检查。可使用composer install时自动配置：

或者手动在.git/hooks/pre-commit中加入：

#!/bin/sh
composer lint
if [ $? -ne 0 ]; then
  echo "代码质量检查失败，请修复后再提交。"
  exit 1
fi

赋予执行权限后，每次提交都会触发检查。

基本上就这些。通过简单配置，就能让代码质量工具融入日常开发节奏，减少人为疏漏，提升项目健壮性。不复杂但容易忽略。