必须通过Composer进行包管理与集成：一、创建PSR-4规范包，配置composer.json autoload；二、用path仓库本地测试并dump-autoload；三、手动在config/app.php注册服务提供者；四、发布至Packagist并配置国内镜像；五、生产环境执行composer install --no-dev --optimize-autoloader。
如果您在ThinkPHP项目中需要引入或开发可复用的第三方功能模块，必须通过Composer进行包管理与集成。以下是具体操作步骤：
一、创建符合PSR-4规范的Composer包
开发ThinkPHP扩展包前，需确保其结构遵循PSR-4自动加载标准，使类能被框架正确识别和加载。目录结构应清晰分离源码与配置，并在composer.json中准确声明命名空间映射路径。
1、新建包目录，例如myvendor/think-sms，内部包含src/（存放核心类）、config/（可选配置文件）、composer.json（元信息文件）。
2、在composer.json中定义PSR-4自动加载规则，必须使用正斜杠结尾且路径与实际目录严格一致，例如："autoload": {"psr-4": {"myvendor\sms\": "src/"}}。
立即学习“PHP免费学习笔记（深入）”；
3、编写主服务提供者类，如src/SmsServiceProvider.php，继承thinkService并实现register()与boot()方法，用于绑定服务与配置。
二、本地测试与自动加载注册
在开发阶段，需将本地包作为路径仓库接入当前ThinkPHP项目，避免频繁发布与安装，提升调试效率。此方式依赖Composer的path repository机制，确保修改即时生效。
1、进入ThinkPHP项目根目录，执行composer config repositories.mylocal path "./packages/myvendor/think-sms"，其中./packages/...为本地包绝对或相对路径。
2、运行composer require myvendor/think-sms:dev-main，版本必须指定为dev-main或带@dev后缀，否则无法识别本地路径包。
3、执行composer dump-autoload -o生成优化后的自动加载映射，缺省此步会导致新类无法被识别。
三、服务提供者手动注册（适用于禁用自动发现场景）
当扩展包未声明extra.think-service-provider或项目中存在"dont-discover": ["*"]时，框架不会自动加载服务提供者，必须显式注册。
1、打开ThinkPHP项目中的config/app.php文件。
2、在'providers'数组末尾添加服务提供者完整类名，格式必须为双反斜杠转义的全限定类名，例如：myvendor\sms\SmsServiceProvider::class。
3、若该包提供Facade门面，还需在'facades'数组中注册别名，如'Sms' => myvendor\sms\Facades\Sms::class。
四、发布至Packagist并设置镜像源
完成本地验证后，可将包公开发布，供其他开发者通过composer require直接安装。发布前需确保包已托管至GitHub/GitLab等平台，并启用Packagist自动同步。
1、登录packagist.org，点击“Submit”按钮，填入代码仓库URL（如https://github.com/myvendor/think-sms）。
2、在仓库的composer.json中确认"name"字段格式为vendor/package（如myvendor/think-sms），名称中不得包含下划线或大写字母，仅允许小写字母、短横线和斜杠。
3、国内用户应在项目根目录执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/，避免因网络问题导致install或update失败。
五、生产环境依赖锁定与精简
部署至服务器时，需确保依赖版本完全一致且不包含开发期工具，防止环境差异引发异常。此过程依赖composer.lock与安装参数协同控制。
1、在开发机执行composer update --lock更新锁文件，记录所有依赖的确切版本号。
2、上传代码至生产环境后，在项目根目录运行composer install --no-dev --optimize-autoloader，--no-dev确保删除phpunit等开发依赖，--optimize-autoloader大幅提升类加载性能。
3、检查vendor/autoload.php是否可读，若报failed to open stream错误，说明vendor未完整部署或权限不足。
