ServiceProvider类必须实现thinkService接口，否则框架无法识别；需在register()中用bind()/singleton()绑定服务，通过composer.json的extra.think.providers声明，并运行php think service:discover生成runtime/service.php。
ServiceProvider类必须实现 thinkService 接口
不实现 thinkService 接口，框架根本不会识别这个类为服务提供者——哪怕名字叫 XXXServiceProvider 也没用。ThinkPHP 不靠命名约定自动加载，只认接口契约。
常见错误现象：php think service:discover 没反应、runtime/service.php 里没你的类、app()->make('xxx') 报错 Class not found 或 Cannot resolve。
- 必须
use thinkService; - 必须
class YourServiceProvider implements Service - 必须重写
register()方法（boot()可选） - 不能漏掉
public function register()的public修饰符，否则调用失败静默忽略
register() 里只能用 $this->app->bind() 或 singleton()
这是绑定服务到容器的唯一合法入口。别在 register() 外部 new 实例、别在构造函数里做初始化、更别试图直接改 $this->app->container 内部属性——这些操作要么无效，要么破坏容器生命周期。
使用场景：你想让 app('log_aliyun') 返回一个 AliyunLogHandler 实例，就得在 register() 里绑定：
立即学习“PHP免费学习笔记（深入）”；
$this->app->singleton('log_aliyun', function ($app) {
return new AliyunLogHandler($app->config->get('log.aliyun'));
});
-
bind()：每次app('xxx')都新建实例 -
singleton()：首次调用时创建，后续复用同一实例（推荐用于日志、数据库连接等有状态对象） - 闭包参数必须是
$app，不是$container或$this；里面访问配置要用$app->config->get()，不是config()函数（后者在 provider 初始化阶段可能未就绪）
composer.json 的 extra.think.providers 必须精确声明
ThinkPHP 只扫描 vendor/ 下所有包的 composer.json，提取 extra.think.providers 字段。字段缺失、路径拼错、大小写不一致、反斜杠没转义，都会导致服务提供者被完全跳过。
正确写法（以 vendor/test/svs 包为例）：
"extra": {
"think": {
"providers": ["Test\Svs\SvsServiceProvider"]
}
}
- 命名空间必须和 PHP 文件中
namespace完全一致（包括大小写） - 反斜杠在 JSON 中需写成双反斜杠
\或用正斜杠/（ThinkPHP 兼容两种） - 值必须是字符串数组，不能是单个字符串，也不能是空数组
- 执行
composer dump-autoload后，确认该类能被class_exists('Test\Svs\SvsServiceProvider')返回true
service:discover 命令必须手动运行且检查 runtime/service.php
这个命令不是“可选优化”，而是服务提供者生效的强制开关。它把所有 extra.think.providers 收集起来，写进 runtime/service.php ——框架启动时只读这个缓存文件，不重新扫描 composer.json。
容易踩的坑：
- 没在项目根目录（含
think脚本）下执行命令，导致找不到命令或写错路径 - 执行后
runtime/service.php为空或不存在，说明扫描失败（优先检查 composer.json 格式、extra 层级、类是否存在） - 修改了
composer.json但忘了再跑一次php think service:discover，缓存还是旧的 - 开发期图省事跳过这步，转而手动加到
config/app.php的providers数组——这能绕过发现机制，但上线部署时若依赖自动发现，就会出问题
最常被忽略的一点：服务提供者里的逻辑（比如读配置、实例化第三方 SDK）可能依赖其他已注册服务，但 register() 阶段部分服务尚未启动，此时应把依赖延迟到 boot() 中处理，而不是硬塞在 register() 里。
