先查自动发现是否生效,Laravel 5.5+ 默认启用但依赖包的composer.json含"extra": {"laravel": {"dont-discover": []}},否则需手动注册服务提供者或执行php artisan package:discover。

Composer安装Laravel扩展后类找不到?先查自动发现是否生效
绝大多数“装了但用不了”的问题,根源不在命令本身,而在 Laravel 的自动发现(Auto-Discovery)机制是否触发或被绕过。Laravel 5.5+ 默认启用该机制,但前提是扩展包的 composer.json 中声明了 "extra": {"laravel": {"dont-discover": []}} —— 如果包没写、你手动加了 "dont-discover": ["*"],或者项目里禁用了发现(如某些定制化部署脚本),composer require 就只是下载文件,不注册服务提供者。
常见错误现象:Class 'LaravelSanctumSanctumServiceProvider' not found、php artisan sanctum:install 命令不存在、Facade 类无法解析。
- 运行
composer show laravel/sanctum,确认输出中包含extra.laravel.dont-discover字段且值为空数组或未出现该字段 - 检查项目根目录下
composer.json是否含"dont-discover": ["*"]—— 有则删掉,或改为["some/package"]排除特定包 - 若仍不生效,手动在
config/app.php的'providers'数组末尾追加对应类,例如:LaravelSanctumSanctumServiceProvider::class
ThinkPHP 6/8 扩展装完不能直接 new Captcha()?服务提供者注册是硬门槛
ThinkPHP 的扩展不是“下载即用”,它依赖 Service Provider 注册容器绑定和事件监听。即使 composer require topthink/think-captcha 成功执行,use thinkcaptchaCaptcha 仍会报错,大概率是服务提供者没加载。
ThinkPHP 6/8 支持自动发现,但仅限于包自身声明了 "extra": {"think-service-provider": "think\captcha\CaptchaService"},且你的 composer.json 没禁用该机制(默认不禁用)。
立即学习“PHP免费学习笔记(深入)”;
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
- 打开
config/app.php,确认'providers'数组中已存在thinkcaptchaCaptchaService::class(注意不是Captcha类本身) - 若无,手动添加;若不确定类名,查看该扩展的
src/目录下是否有*Service.php文件,类名通常与文件名一致 - 部分扩展(如
topthink/think-queue)还需额外配置:在config/下新建queue.php,内容参考扩展文档,否则启动队列时直接抛异常
为什么 php artisan vendor:publish 总是找不到 provider?路径和命名必须完全匹配
这个命令失败几乎全是字符串匹配问题——不是逻辑错,是拼写错。Laravel 要求传入的 --provider 参数必须与服务提供者类的完整命名空间和大小写**一字不差**,且该类必须已存在于 vendor/ 中并被自动加载器识别。
常见错误现象:Provider not found、No publishable resources for tag [config]、命令执行后 config/ 目录下空空如也。
- 先运行
composer dump-autoload -o,确保新安装包的类已写入自动加载映射 - 用
composer show spatie/laravel-permission查看其源码路径,再进vendor/spatie/laravel-permission/src/确认服务提供者类名(通常是PermissionServiceProvider.php) - 执行命令时,务必复制类名全称:例如
php artisan vendor:publish --provider="SpatiePermissionPermissionServiceProvider"—— 注意首字母大写、反斜杠方向、无多余空格 - 如果包支持多标签(如
config、migrations),可加--tag=config精确指定,避免发布无关文件
国内网络下 Composer 安装卡住或超时?镜像源和协议设置必须同步生效
单纯改 repo.packagist 镜像源不够,Composer 2.x 默认强制 HTTPS,而部分国内镜像(尤其是旧版 phpcomposer.com)已停服或不支持 HTTPS,会导致 composer require 卡在 “Loading composer repositories” 或报 Connection refused。
当前稳定可用的组合是:阿里云镜像 + 关闭 secure-http(仅限内网或可信环境)。
- 全局设置镜像:运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 关闭 HTTPS 强制要求(必要步骤):
composer config -g secure-http false—— 否则阿里云镜像会重定向到 HTTPS,而旧客户端可能不兼容 - 验证是否生效:运行
composer config -g -l | grep repo,输出应含repo.packagist和secure-http两行 - 临时单次安装可加
-vvv查看真实请求地址,确认是否走镜像而非 packagist.org
composer dump-autoload 和 php artisan config:clear 这两个命令的执行时机。它们不解决安装问题,但决定“装完之后能不能立刻用”。尤其当服务提供者注册、Facade 绑定或配置文件发布完成后,跳过这两步,90% 的“找不到类”“配置不生效”问题都会复现。


















