先执行 composer init 或直接 composer require jaybizzle/crawler-detect 创建 composer.json；引入 vendor/autoload.php 并用全限定名 Jaybizzle\CrawlerDetect\CrawlerDetect；检测时需手动传入 $_SERVER['HTTP_USER_AGENT'] 等字段；Laravel 中应绑定为单例复用实例。
直接安装 CrawlerDetect 库会报错：找不到 composer.json
如果你在项目根目录直接运行 composer require jaybizzle/crawler-detect 却提示 No composer.json found in the current directory，说明你还没初始化 Composer 环境。这不是库的问题，而是本地缺少基础配置。
解决方法很简单，先执行：composer init（按提示填完基本信息，或一路回车用默认值）
或者更直接地：composer require jaybizzle/crawler-detect 会在没有 composer.json 时自动创建它 —— 前提是你当前目录可写、且 Composer 已全局安装。
- 确保当前用户对项目目录有写权限，否则
composer.json和vendor/写不进去 - 别在系统根目录或
/usr下试，容易权限失败 - 如果用 Docker，确认容器内已安装 Composer，并挂载了正确的项目路径
require_once 引入 vendor/autoload.php 后仍提示 Class 'Jaybizzle\CrawlerDetect\CrawlerDetect' not found
这是典型的自动加载失败，常见于没正确引入 Composer 自动加载器，或命名空间拼写错误。
检查三点：
- 确保你在使用类之前，已执行 require_once 'vendor/autoload.php';（路径必须准确，不能漏掉 vendor/）
- 类名必须完整：不是 CrawlerDetect，而是 Jaybizzle\CrawlerDetect\CrawlerDetect
- 如果用 PHP 7.4+，别忘了 use 语句，否则要写全限定名
- 推荐写法：
require_once 'vendor/autoload.php'; use Jaybizzle\CrawlerDetect\CrawlerDetect; <p>$detector = new CrawlerDetect();
- 如果项目用了框架（如 Laravel），通常不需要手动 require，但也要确认
composer dump-autoload是否执行过 - 运行
composer show jaybizzle/crawler-detect可验证是否真装进去了
检测结果始终返回 false，即使传入明显是爬虫的 User-Agent
CrawlerDetect 默认只检查 User-Agent 字符串，但很多真实请求还带 Referer 或 X-Forwarded-For，而库默认不读这些 —— 它不会自动从 $_SERVER 取值，得你手动传。
正确做法是显式传入要检测的字段：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 最简方式：
$detector = new CrawlerDetect(); $result = $detector->isCrawler($_SERVER['HTTP_USER_AGENT'] ?? ''); // 必须自己取
- 支持多字段检测：
$ua = $_SERVER['HTTP_USER_AGENT'] ?? ''; $referer = $_SERVER['HTTP_REFERER'] ?? ''; $result = $detector->isCrawler($ua, $referer);
- 注意：空字符串、null 或未设置的
$_SERVER键会导致检测跳过对应字段，不会报错但会降级判断 - 测试时别用 curl -A "Googlebot" 直接发请求，某些环境会过滤掉 UA，建议用 Postman 或写个简单 PHP 脚本模拟
在 Laravel 中使用时，为什么每次请求都 new CrawlerDetect() 性能很差？
因为 CrawlerDetect 构造函数会加载并解析内置的正则规则数组（约 2000+ 条），重复实例化等于反复做解析，CPU 和内存开销明显。
应该复用实例，Laravel 里最稳妥的方式是绑定为单例：
- 在
AppServiceProvider::register()中加：$this->app->singleton('crawler-detect', function ($app) { return new \Jaybizzle\CrawlerDetect\CrawlerDetect(); }); - 然后 anywhere 都能用：
$detector = app('crawler-detect'); if ($detector->isCrawler(request()->userAgent())) { ... } - 别把它塞进 config 文件或静态属性里 —— 规则数组是私有的，无法通过配置修改，硬缓存反而可能因版本升级失效
- 如果并发高、内存敏感，可以考虑把规则数组提前序列化缓存（但官方不推荐自行改动内部结构）
实际用的时候，最常卡住的是 User-Agent 没取对、autoload 没引好、或者以为 new 一次无所谓结果压测时 CPU 突增——这些点比算法本身更影响落地效果。
