首先准备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
和版本标签。只要完成一次,后续维护就很方便了。
以上就是Composer如何发布你自己的PHP包到Packagist的详细内容,更多请关注php js git json composer github ai gitlab 配置文件 php composer json for require github git gitlab https