parallel-lint 是一个支持多进程、递归扫描、彩色输出的 PHP 语法检查 CLI 工具；它弥补了原生 php -l 单文件、无并行、不递归、难解析等缺陷，专为 CI 和大项目优化。
parallel-lint 是什么，为什么不用 php -l 逐个扫文件
它不是 Composer 插件，而是一个独立 CLI 工具，但通过 Composer 安装最方便。原生 php -l 只能单文件检查、不递归、无并行、没颜色输出、报错格式难 parse——这些在 CI 或大项目里全是硬伤。parallel-lint 用多进程跑 php -l，支持目录递归、跳过 vendor、彩色高亮、失败时返回非零退出码，CI 脚本里直接用 || exit 1 就能卡住流程。
用 Composer 全局安装还是项目本地安装
推荐项目本地安装（composer require --dev php-parallel-lint/php-parallel-lint），原因很实际：
- 不同项目 PHP 版本可能不同，
parallel-lint对 PHP 版本有要求（如 v1.4+ 需 PHP 8.0+），全局装一个版本容易和某个项目不兼容 - CI 环境通常从
composer install开始，本地 dev 和 CI 行为一致，不会出现“我本地能跑，CI 报 command not found” - 团队协作时，
composer.json明确声明了 lint 工具依赖，新人拉代码后composer install就到位，不用额外文档写“还要手动装 global”
运行时常见报错和绕过方式
最常遇到的是 ParseError 或 PHP Parse error: syntax error 卡在某个文件，但你确认语法没问题——大概率是该文件用了当前 PHP 版本不支持的语法（比如 PHP 7.4 的箭头函数，却在 PHP 7.3 环境下跑 parallel-lint）。
这时别急着改代码，先确认执行环境：
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
which php和php -v，确保不是系统自带低版本 PHP 在干扰 - 用
parallel-lint --php-version 8.1 ./src显式指定目标 PHP 版本（它会模拟该版本做语法解析） - 跳过明显不需检查的路径：
parallel-lint --exclude vendor --exclude tests/Feature ./ - 如果某文件含短标签
且服务器关闭了short_open_tag，加--short-tags参数让它按短标签解析
怎么集成进 composer scripts 和 Git Hook
加到 composer.json 的 scripts 里，是最轻量的自动化方式：
"scripts": {
"lint": "parallel-lint --colors --progress ./src ./tests"
}
之后直接 composer lint 就能跑。想更进一步卡住提交，放进 .git/hooks/pre-commit（注意给执行权限）：
#!/bin/sh if ! composer lint; then echo "❌ PHP 语法检查失败，请修复后再提交" exit 1 fi
注意：Git Hook 里不要用 vendor/bin/parallel-lint 绝对路径，因为不同人 vendor 目录位置可能不同；统一走 composer lint，靠 Composer 自动 resolve 命令最稳。
真正麻烦的是混合了旧代码和新语法的项目——parallel-lint 默认严格检查所有文件，但你可能暂时不想修十年前写的 mysql_connect() 文件。这时候得靠 --exclude 列表或拆成多个命令分批处理，别指望一个参数全搞定。
