怎么在Laravel项目中开发专用的Composer扩展包-composer-PHP中文网

composer init生成的composer.json缺type、autoload和require.php等关键字段：无type则laravel无法自动发现，无autoload导致类不加载，无php版本约束易引发兼容问题。

怎么在laravel项目中开发专用的composer扩展包

composer init 生成的 composer.json 缺什么关键字段

直接 composer init 生成的配置几乎不能用——它默认不设 "type"、不配 "autoload"、也不声明 Laravel 兼容的 PHP 版本。结果就是：包能装进项目，但类根本不会被自动加载，AppServiceProvider 里 app()->make() 直接报错。

"type": "laravel-package" 虽非强制，但加了才能触发 Laravel 的自动发现机制（Laravel 5.5+）
"autoload": {"psr-4": {"YourVendor\YourPackage\": "src/"}} 必须严格匹配命名空间与目录路径，src/ 是硬性约定，不能写成 lib/ 或 src/YourPackage/
"require": {"php": "^8.1"} 必须显式声明，Laravel 10+ 已弃用 PHP 8.0；若依赖 Illuminate 组件，还得加 "illuminate/support": "^10.0 || ^11.0" 并用 || 分隔多版本

服务提供者注册失败的三个常见原因

即使 composer require 成功，php artisan vendor:publish 找不到你的配置，或 artisan list 看不到自定义命令，大概率是服务提供者没真正注册进去。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

类名必须以 ServiceProvider 结尾，且文件名要完全一致（如 MyPackageServiceProvider.php），Laravel 13.2+ 会严格校验这个后缀
composer.json 中的 "extra": {"laravel": {"providers": ["YourVendor\YourPackage\MyPackageServiceProvider"]}} 是最稳的方式；如果依赖自动发现，必须确保 "type": "laravel-package" 且该类继承 IlluminateSupportServiceProvider
本地开发时改完 composer.json 后，必须运行 composer dump-autoload -o，否则 Laravel 启动时读的是旧的 autoload 静态映射

本地实时开发为什么别用 composer link

composer link 在 Laravel 10+ 和 Windows 上极易出问题：它会在 vendor/ 下建 symlink，但 Composer 的 autoload 生成逻辑有时会跳过 symlink 目录，导致类找不到；更糟的是，多次 link/unlink 容易让 vendor/composer/autoload_psr4.php 残留脏数据。

正确做法是在 Laravel 项目的 composer.json 里加 "repositories"：

"repositories": [
  {
    "type": "path",
    "url": "../my-laravel-package"
  }
]

然后执行 composer require your-vendor/your-package:@dev（注意带 @dev，否则可能拉远程稳定版）
改包代码后无需任何操作，Laravel 直接读取 symlink 目录下的最新文件——前提是你的包目录下有完整且有效的 composer.json

发布前最容易漏掉的兼容性检查点

你在本地 Laravel 11.12 上测试通过，不代表别人 composer require 就能跑。Packagist 上大量“安装成功但无法使用”的包，问题都出在这些细节上。

检查 src/ 下是否真有 Providers/ 子目录或根级 XXXServiceProvider.php ——Laravel 自动发现只扫描 src/ 及其子目录，不会进 lib/ 或 src/Support/
确认 extra.laravel.dont-discover 是空数组 []，不是 null 或未声明；Laravel 9+ 默认跳过所有未显式放行的包
如果你用了 $this->loadMigrationsFrom() 或 $this->loadViewsFrom()，确保对应路径存在且路径字符串里没拼错 __DIR__ 的相对层级（比如少写一个 ../）

实际发布时，composer.json 里漏掉 "type" 或 "autoload" 字段，比代码逻辑错误更致命——前者会让整个包在用户端“静默失效”，连报错都看不到。