如何创建一个自己的composer包并发布

冰火之心
发布: 2025-10-28 23:48:02
原创
982人浏览过
创建Composer包需先组织代码并遵循PSR-4规范,编写含正确命名空间和依赖的composer.json,初始化Git并打标签,提交仓库到Packagist,最后通过composer require安装;后续应维护README、测试和语义化版本。

如何创建一个自己的composer包并发布

想让自己的 PHP 代码被别人通过 Composer 轻松引入?创建并发布一个 Composer 包其实并不复杂。只要按步骤来,几分钟就能搞定。

1. 准备你的包代码

新建一个目录,比如 my-awesome-package,然后在里面组织好你的 PHP 代码。

例如:

/my-awesome-package
├── src/
│ └── Calculator.php
├── composer.json
└── README.md

你的类要遵循 PSR-4 自动加载规范。比如在 src/Calculator.php 中:

<?php

namespace MyNameAwesomePackage;

class Calculator
{
public function add($a, $b)
{
return $a + $b;
}
}

2. 编写 composer.json 文件

这是最关键的一步。根目录下创建 composer.json,内容如下:

{
"name": "your-vendor-name/awesome-package",
"description": "A simple calculator package",
"type": "library",
"license": "MIT",
"authors": [
{
"name": "Your Name",
"email": "you@example.com"
}
],
"require": {
"php": "^7.4 || ^8.0"
},
"autoload": {
"psr-4": {
"MyName\AwesomePackage\": "src/"
}
},
"minimum-stability": "stable",
"prefer-stable": true
}

注意替换以下字段:

  • name:格式是 vendor/package-name,vendor 可以是你的 GitHub 用户名或公司名
  • namespace:确保和 autoload 里的命名空间一致
  • require:声明依赖的 PHP 版本或其他包

3. 初始化 Git 并打标签

Composer 包通常托管在 GitHub 上,并通过 Git 标签管理版本。

执行命令:

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourname/awesome-package.git
git push -u origin main

然后打一个版本标签:

自由画布
自由画布

百度文库和百度网盘联合开发的AI创作工具类智能体

自由画布73
查看详情 自由画布
git tag v1.0.0
git push origin v1.0.0

以后每次更新可以打 v1.1.0、v2.0.0 等标签。

4. 发布到 Packagist

Packagist 是 Composer 的默认包仓库。

访问 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19,登录后点击右上角「Submit」。

填入你 GitHub 仓库的 URL,比如:
https://github.com/yourname/awesome-package

点击「Check」然后「Submit」。

提交后,别人就可以用下面命令安装了:

composer require your-vendor-name/awesome-package

你还可以在 GitHub 设置 Webhook,让 Packagist 在你推送新标签时自动更新。

5. 后续维护建议

  • 保持 README.md 清晰,写明安装和使用方法
  • 为代码写单元测试(推荐用 PHPUnit)
  • 遵守语义化版本规范(SemVer)打标签
  • 考虑添加 LICENSE 文件(如 MIT)

基本上就这些。从写代码到发布,整个过程清晰简单。只要你有 GitHub 和 Packagist 账号,随时都能把自己的工具分享出去。

以上就是如何创建一个自己的composer包并发布的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号