实战教学：Composer使用之从零构建自己的PHP类库-composer-PHP中文网

composer autoload配置必须严格匹配psr-4规范：命名空间末尾带反斜杠、路径相对于composer.json、目录结构与命名空间完全一致；require-dev中声明phpunit，autoload-dev中配置测试路径，并执行composer dump-autoload --dev生效。

实战教学：composer使用之从零构建自己的php类库

composer 不是“装个包就完事”的工具——它本质是 PHP 类库的契约系统。你发布一个类库，别人能顺利 require 它、自动加载它、升级它、不被命名冲突搞崩，全靠 composer.json 里那几行配置是否写对。错一处，下游项目就报 Class not found 或 Could not find package。

怎么写对 composer.json 的 autoload 配置

autoload 是类库能被正确加载的核心。PSR-4 是唯一推荐方案，别用 classmap 或 files 做主加载方式（除非极特殊场景）。

必须严格匹配目录结构：比如 "MyLibrary\Utils\": "src/Utils/" 表示所有 MyLibrary\Utils* 类，都从 src/Utils/ 下找文件
命名空间末尾要带反斜杠 \，漏掉会静默失败（MyLibrary\Utils ≠ MyLibrary\Utils\）
路径必须是相对于 composer.json 所在位置的相对路径，不能写成 ./src/Utils/ 或绝对路径
如果类文件在 src/Utils/StringHelper.php，那它的命名空间必须是 MyLibrary\Utils，类名必须是 StringHelper，三者缺一不可

验证方法：改完 composer.json 后运行 composer dump-autoload -o，再在测试脚本里 new MyLibrary\Utils\StringHelper()，不报错才算通过。

为什么 require-dev 里的 phpunit 不能写进 require

require 是生产环境依赖，require-dev 是开发期依赖。把 phpunit 放进 require 会导致：

所有使用你类库的项目，不管要不要测试，都被强制安装 PHPUnit
可能引发版本冲突：laravel/framework 和 phpunit/phpunit 对 PHP 版本要求不同，下游项目升级时容易卡死
类库体积虚增，Composer install 时间变长，CI 构建更慢

正确做法是只在 require-dev 中声明 "phpunit/phpunit": "^10.5"，并在 autoload-dev 中补充测试类路径（如 "MyLibrary\Tests\": "tests/"），这样 composer install --no-dev 就完全不碰测试代码。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

发布前必须检查的 3 个关键点

类库写完、测试跑通，不代表能发出去。以下三点任一出错，Packagist 接收失败或用户无法安装：

name 字段格式必须是 vendor/package（如 myorg/string-helper），不能带下划线或大写字母，且 vendor 名需与 Packagist 账号一致
autoload 和 autoload-dev 的路径必须真实存在，且 composer dump-autoload -o 不报 warning
根目录下必须有 README.md 和 composer.json，否则 Packagist 拒绝同步（不是报错，是直接忽略你的 GitHub hook）

发布命令只有两步：git tag -a v1.0.0 -m "first release" → git push origin v1.0.0。Packagist 监听 tag 自动抓取，不需要手动提交。

本地开发时如何实时测试类库效果

别等发版才测。用 path 仓库类型把本地类库“软链接”进测试项目：

在测试项目的 composer.json 的 repositories 里加：
```
{
"type": "path",
"url": "../my-library"
}
```
然后 composer require myorg/string-helper:dev-main（注意用 dev-main，不是 1.0.0）
修改 my-library 源码后，无需 composer update，直接刷新测试脚本即可生效
这种方式绕过 Packagist，也不走 zip 包解压，所有改动实时可见，是调试 autoload 和接口兼容性的最快路径