psalm/psalm-plugin-laravel

说明与用途

**项目简介**
psalm/psalm-plugin-laravel 是为 Laravel 项目提供的 Psalm 静态分析插件，内置安全扫描规则，可在开发阶段自动发现代码中的潜在安全漏洞和类型错误。

**价值**

• **提升代码安全**：通过预置的安全检查（如 SQL 注入、XSS、CSRF 等），帮助团队在提交前拦截高危缺陷。
• **降低维护成本**：静态分析在 CI 中即可运行，避免了后期调试和补丁的高昂成本。
• **与 Laravel 深度集成**：插件直接读取 Laravel 的容器、路由和模型定义，提供框架感知的分析结果，准确率远高于通用 PHP 静态分析工具。

**典型接入方式**

1. **Composer 安装**

   composer require --dev psalm/psalm-plugin-laravel

1. **在项目根目录生成 Psalm 配置**（若已有可跳过）

   vendor/bin/psalm --init

1. **在 psalm.xml 中启用插件**（插件会自动注册）或手动添加：

   <plugins>
       <pluginClass>Psalm\LaravelPlugin\Plugin</pluginClass>
   </plugins>

1. **CI 集成**（GitHub Actions、GitLab CI 等）

   - name: Run Psalm with Laravel plugin
     run: vendor/bin/psalm --output-format=github

通过上述步骤即可在每次提交或合并请求时自动执行安全扫描。

**生产可用性**

• **活跃度**：截至 2026‑06‑25 最近一次提交，项目仍在维护；GitHub ★334、Fork 78，社区活跃。
• **生态兼容**：基于 PHP，支持 Laravel 8/9/10，兼容现有的 Psalm 版本。
• **成熟度**：插件已在多个开源 Laravel 项目中使用，具备稳定的错误报告和修复路径。
• **风险**：需自行审查许可证（MIT）以及项目的安全审计报告；建议在生产环境前进行一次内部评估。

综合来看，psalm/psalm-plugin-laravel 已具备足够的成熟度和社区支持，可直接在生产级 Laravel 项目中作为 CI 静态安全检测的核心组件使用。

实际用途

psalm/psalm-plugin-laravel helps add AI capability without starting from a blank model stack.

• prototype AI features
• build RAG or agent workflows
• evaluate model tooling

限制与审查说明

High for an OSS candidate: recent activity, adoption, and ecosystem signals are strong enough for a serious pilot.