使用 Composer 进行包的发布涉及几个步骤,包括准备包、配置 composer.json
文件、登录 Packagist 以及执行发布命令。以下是详细的步骤指南:
1. 准备你的包
确保你的包已经按照 PSR-4 自动加载标准进行了组织,并且有一个清晰的目录结构。例如:
src/ YourPackage/ YourPackage.php composer.json README.md LICENSE
2. 配置 composer.json
在你的 composer.json
文件中,确保有以下配置:
{ "name": "your-vendor-name/your-package-name", "description": "A brief description of your package", "type": "library", "require": { // 依赖的其他包 }, "autoload": { "psr-4": { "YourVendorName\\YourPackageName\\": "src/" } }, "license": "MIT", "authors": [ { "name": "Your Name", "email": "your.email@example.com" } ], "minimum-stability": "dev", "prefer-stable": true }
3. 登录 Packagist
你需要一个 Packagist 账户来发布你的包。访问 Packagist 并注册一个账户。然后,使用 Composer 登录:
composer login
输入你的 Packagist 用户名和密码。
4. 发布包
在项目根目录下运行以下命令来发布你的包:
composer publish
这个命令会将你的包发布到 Packagist。如果你只想发布特定的文件或目录,可以使用 --classmap-authoritative
选项来确保 Composer 使用最新的类映射:
composer publish --classmap-authoritative
5. 验证发布
发布完成后,你可以访问 Packagist 并搜索你的包名,确认它已经成功发布。
6. 更新包
如果你需要更新包,可以修改 composer.json
文件并再次运行 composer publish
命令。如果你希望发布新版本,可以增加版本号并再次运行 composer publish
。
注意事项
- 确保你的包名在 Packagist 上是唯一的。
- 在发布之前,最好先在本地测试你的包,确保它按预期工作。
- 如果你希望包是私有的,可以在 Packagist 上创建一个私有仓库,并在
composer.json
中指定仓库地址。
通过以上步骤,你应该能够成功地使用 Composer 发布你的 PHP 包。