Composer安装包怎么操作 Composer组件化开发速成指南

composer require 只下载代码并更新配置文件，不自动修改自动加载规则；类找不到主因是 autoload 配置错误、路径写死或类未纳入 PSR-4 映射，需手动配置 composer.json 的 autoload 字段并运行 composer dumpautoload 生效。

直接用 composer require 装包，这个操作本身不复杂。可问题在于——很多人装完包，类还是找不到，然后就开始怀疑人生。其实不是命令不会输，而是不知道 autoload 配置该放哪、为什么这么配。下面几个坑，踩过的人估计不少。

composer require 装包后为什么类还是找不到？

问题就出在这里：composer require 只管下载代码，顺便更新 composer.json 和 composer.lock，它可不会主动帮你改自动加载规则。如果你的类不在 src/ 目录下、没声明命名空间、或者压根没进 PSR-4 映射，require 完之后照样报 Class 'xxx' not found。

• 先检查包本身有没有自动加载配置：打开 vendor/xxx/yyy/composer.json，看看有没有 "autoload" 字段。正规包一般都有，但有些特殊包（比如纯函数库）可能没有。
• 如果包没配 autoload，那就得手动加到 "files" 里：

  { "autoload": { "files": ["vendor/monolog/monolog/src/Monolog/ErrorHandler.php"] } }

• 改完之后必须运行 composer dumpautoload，否则新规则不会生效。很多人偏偏就忘了这一步。

自定义类怎么让 composer 自动加载？

别再手写 spl_autoload_register 了，也别一个个 require 文件。用 composer.json 的 autoload 字段一把统一管理，省心省力。

• PSR-4 是最推荐的方式：

  { "autoload": { "psr-4": { "App\\": "src/" } } }

  这样配置完，App\Http\Controller\Home 就自动对应 src/Http/Controller/Home.php，完全不用手动写路径。
• 如果类没有命名空间（老项目遗留下来的），可以用 "files" 列表，每行一个 PHP 文件路径，注意路径是相对于项目根目录的。
• 改完配置后立刻执行 composer dumpautoload，别指望 install 或 update 会自动触发 autoload 重建——它们不会。

本地开发组件时，require 本地目录而不是 Packagist

想边写包边测试，又不想每次改完都往 Packagist 上 publish？用 path 类型仓库就行，它让 Composer 把本地文件夹当成远程包来链接。

• 在主项目的 composer.json 里加上：

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

• 然后运行 composer require my-vendor/my-component "*" ——注意版本必须写 *，才会走 path 模式。
• 成功后，vendor/my-vendor/my-component 会变成一个符号链接，本地代码改了立即生效，不用重新 install。
• ⚠️ 提醒一下：路径必须用绝对路径或相对于主项目根目录的相对路径；Windows 下反斜杠要转义或用正斜杠，否则容易踩坑。

vendor/autoload.php 引入位置和时机

这个文件不是“建议引入”，而是整个自动加载机制的唯一入口。漏掉、放错顺序、路径写错，都会导致类加载失败，而且错误不可逆。

• 入口文件第一行就该是：require __DIR__ . '/vendor/autoload.php'; ——用 __DIR__ 确保路径稳定，比写相对路径安全得多。
• 不能放在 session_start()、header() 或者 HTML 输出之后，否则可能触发 Cannot modify header information 的错误。
• CLI 环境下 __DIR__ 的含义和 Web 环境完全一致，所以比 ./vendor/autoload.php 更可靠。
• IDE 不报错但运行报错？八成就是这行漏了，或者写在了 use 语句之后。

最后说一个容易被忽视的细节：autoload 规则只对 composer dumpautoload 之后生成的 vendor/autoload.php 生效，而这个文件本身不会被 Git 跟踪。所以团队协作时，没人提交它，但每个人都要自己跑一遍 dumpautoload，才能让本地配置真正生效。