linkchecker 是 python 工具，非 composer 可安装的 php 包，须用 pip 在虚拟环境中安装；php 项目中需通过安全进程调用并处理其局限性。
LinkChecker 不是 Composer 可直接安装的 PHP 包，它是一个独立的 Python 命令行工具，强行用 composer require 会失败——这是最常踩的第一个坑。
为什么 Composer install linkchecker 失败？
因为 LinkChecker 是 Python 编写的开源项目（GitHub 主页为 wummel/linkchecker），没有 composer.json，也不发布到 Packagist。运行 composer require linkchecker/linkchecker 或类似命令时，Composer 会返回 Could not find package 错误。
常见误操作包括：
- 在
composer.json中手动添加非 PHP 包的仓库地址 - 试图用
composer global require安装 Python 工具 - 混淆了 PHP 的
spatie/broken-links-detector等替代方案
正确安装 LinkChecker 的方式
必须通过 Python 包管理器安装，且推荐使用虚拟环境隔离依赖：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保系统已安装 Python 3.7+ 和
pip - 运行
python3 -m venv linkchecker-env创建独立环境 - 激活后执行
pip install linkchecker（注意：包名是linkchecker，不是LinkChecker） - 验证安装：
linkchecker --version应输出类似LinkChecker 10.2.0
若遇到 command not found，检查 linkchecker-env/bin/ 是否在 $PATH 中，或直接调用完整路径：./linkchecker-env/bin/linkchecker。
PHP 项目中调用 LinkChecker 的安全方式
不能把 Python 工具当 PHP 函数用，需通过进程调用并严格控制输入输出：
- 用
escapeshellarg()包裹待检测 URL，防止 shell 注入 - 限制超时和并发数，例如：
linkchecker --ignore-url='.*\.pdf$' --check-extern --timeout=10 --ignore-url='https?://localhost.*' --ignore-url='https?://127\.0\.0\.1.*' $url - 捕获
STDERR判断是否出错，STDOUT解析 JSON 输出需加--output=json - 避免在 Web 请求中同步调用——高延迟或网络问题会导致 PHP 进程卡死，应改用队列或异步任务
真正难的不是跑通命令，而是处理重定向链、JavaScript 渲染页面、登录态保护链接、以及大量 403/429 响应的语义判断——这些 LinkChecker 本身不解决，得靠你补逻辑。
