答案:创建Composer包需准备标准项目结构,编写composer.json配置文件,初始化Git并推送至代码托管平台,提交仓库到Packagist,设置自动更新钩子,打标签发布版本,完成后他人可通过composer require安装使用。

创建并发布一个符合规范的 Composer 包并不复杂,只要遵循标准结构和配置流程即可。以下是具体步骤,帮助你从零开始创建一个可被他人安装使用的 PHP 包。
1. 准备项目结构
一个标准的 Composer 包需要有清晰的目录结构。基本结构如下:
your-package-name/├── src/
│ └── YourClass.php
├── tests/
│ └── YourClassTest.php
├── composer.json
├── README.md
└── LICENSE
将你的核心代码放在 src/ 目录中,测试放在 tests/,这是社区通用做法,便于他人理解和维护。
2. 编写 composer.json 文件
composer.json 是包的核心配置文件。以下是一个典型示例:
{ "name": "vendor-name/package-name", "description": "A short description of your package", "type": "library", "license": "MIT", "authors": [ { "name": "Your Name", "email": "your.email@example.com" } ], "require": { "php": "^7.4 || ^8.0" }, "autoload": { "psr-4": { "VendorName\\PackageName\\": "src/" } }, "autoload-dev": { "psr-4": { "VendorName\\PackageName\\Tests\\": "tests/" } }, "minimum-stability": "stable", "prefer-stable": true }注意替换 vendor-name、package-name 和命名空间。使用 PSR-4 自动加载确保类能被正确加载。
3. 添加版本控制(Git)
初始化 Git 仓库,并提交代码:
git initgit add .
git commit -m "Initial release"
然后推送到 GitHub、GitLab 或其他公开代码托管平台。Packagist 会从这里抓取代码。
4. 发布到 Packagist
访问 Packagist 官网 并登录(支持 GitHub 登录)。
点击右上角 “Submit” 按钮,粘贴你的仓库 URL(如:https://github.com/vendor-name/package-name),点击检查并提交。
提交后,Packagist 会自动抓取 composer.json 信息并创建包页面。
5. 设置自动更新(推荐)
为了让 Packagist 在你推送新版本时自动同步,需配置钩子:
- 在 Packagist 的包页面点击 “Manage” → “GitHub Hook”
- 点击 “Setup GitHub Automatic Update”
- 授权 Packagist 访问你的 GitHub 仓库
之后每次你打 tag 或 push 代码,Packagist 都会自动更新。
6. 打标签发布稳定版本
Composer 推荐使用语义化版本号(如 v1.0.0)。发布前打标签:
git tag v1.0.0git push origin v1.0.0
Packagist 收到 tag 后会将其作为正式版本展示,用户可通过版本约束安装。
基本上就这些。确保你的包有基本文档(README)、许可证和可运行的代码,就能让别人顺利使用。发布后,其他人就可以通过 composer require vendor-name/package-name 安装你的包了。










