首先准备PHP项目并配置composer.json,然后推送到公共Git仓库并打版本标签,接着在Packagist提交仓库URL,最后设置webhook实现自动更新。

要将你自己的 PHP 包发布到 Packagist,让其他人可以通过 Composer 安装使用,整个过程其实并不复杂。只要准备好项目、配置好 composer.json、推送到 Git 仓库,并提交到 Packagist 即可。
1. 准备你的 PHP 项目
确保你的项目结构清晰,代码组织合理。一个基本的 PHP 包通常包含以下内容:
确保代码遵循 PSR-4 自动加载标准,这样 Composer 才能正确加载类文件。
2. 配置 composer.json
根目录下的 composer.json 是关键。它定义了包名、描述、自动加载方式、依赖等信息。示例:
立即学习“PHP免费学习笔记(深入)”;
{ "name": "your-username/package-name", "description": "A simple PHP library for doing something useful", "type": "library", "license": "MIT", "authors": [ { "name": "Your Name", "email": "you@example.com" } ], "require": { "php": "^7.4 || ^8.0" }, "autoload": { "psr-4": { "YourNamespace\\": "src/" } }, "minimum-stability": "stable", "prefer-stable": true }注意: name 格式为 用户名/包名,这是你在 Packagist 上的唯一标识。
3. 推送到公共 Git 仓库
将项目推送到 GitHub、GitLab 或 Bitbucket 等公共平台。
- 创建一个新仓库(例如:https://github.com/your-username/your-package)
- 初始化 Git 并推送代码
- 打上版本标签,如
v1.0.0,Packagist 通过 Git 标签识别版本
打标签命令示例:
git tag -a v1.0.0 -m "First stable release"git push origin v1.0.0
4. 提交到 Packagist
访问 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19,登录或注册账号(支持 GitHub 登录)。
- 点击右上角 “Submit” 按钮
- 粘贴你的 Git 仓库 URL(如:https://github.com/your-username/your-package)
- 点击 “Check” 按钮,Packagist 会抓取信息并显示预览
- 确认无误后点击 “Submit”
提交成功后,你的包就会出现在 Packagist 上,别人就可以通过 composer require your-username/package-name 安装了。
5. 自动更新(可选但推荐)
为了每次你推送新标签时 Packagist 能自动同步,建议设置 webhook。
Packagist 提供了一个 webhook URL,你可以添加到 GitHub 仓库的 Webhooks 中,或者使用 Packagist 的“GitHub Hook”功能自动绑定。
这样,每次你推送新版本标签,Packagist 会自动抓取更新,无需手动刷新。
基本上就这些。发布 PHP 包到 Packagist 不复杂,但需要细心配置 composer.json 和版本标签。只要完成一次,后续维护就很方便了。











