配置私有Composer包自动化发布需四步:1. 正确设置composer.json的name、type、autoload等字段;2. 搭建Satis或私有Packagist实例,在satis.json中添加私有仓库地址并生成包列表;3. 使用GitHub Actions等CI工具,在推送tag时自动运行测试并更新Satis,如通过SSH触发php satis build;4. 在目标项目composer.json中添加私有仓库URL后即可require使用。关键在于确保代码质量、权限安全与流程自动化。

为私有Composer包配置自动化发布流程,核心是将版本控制、代码质量检查、包构建与分发整合到CI/CD流水线中。关键是确保每次发布都经过验证,并自动更新包仓库信息。
1. 准备私有包的composer.json
确保你的私有包根目录下的composer.json文件配置正确:
- name:格式为vendor/package-name,用于在项目中引用
- type:设为library
- autoload:配置PSR-4或PSR-0自动加载规则
- require和require-dev:明确依赖项
示例片段:
{
"name": "your-company/your-package",
"type": "library",
"autoload": {
"psr-4": {
"YourCompany\\YourPackage\\": "src/"
}
}
}2. 配置私有包仓库(如Satis或Packagist私有实例)
让其他项目能通过Composer安装你的私有包,需搭建私有仓库。常用方案包括:
- Satis:静态包生成器,适合小团队
- Packagist私有实例:功能完整,支持Webhook自动更新
以Satis为例,在服务器上配置satis.json,包含你的私有Git仓库地址:
{
"name": "My Private Packages",
"homepage": "https://packages.yourcompany.com",
"repositories": [
{ "type": "vcs", "url": "https://git.yourcompany.com/your-package" }
]
}每次发布新标签后,运行php satis build satis.json public/生成更新后的包列表。
3. 使用CI工具实现自动化发布
选择GitHub Actions、GitLab CI或Bitbucket Pipelines等工具,在推送tag时触发发布流程。
云模块_YunMOK网站管理系统采用PHP+MYSQL为编程语言,搭载自主研发的模块化引擎驱动技术,实现可视化拖拽无技术创建并管理网站!如你所想,无限可能,支持创建任何网站:企业、商城、O2O、门户、论坛、人才等一块儿搞定!永久免费授权,包括商业用途; 默认内置三套免费模板。PC网站+手机网站+适配微信+文章管理+产品管理+SEO优化+组件扩展+NEW Login界面.....目测已经遥遥领先..
以GitHub Actions为例,创建.github/workflows/publish.yml:
on:
push:
tags:
- 'v*'
jobs:
publish:
runs-on: ubuntu-latest
steps:
uses: actions/checkout@v4
name: Set up PHP uses: shivammathur/setup-php@v2 with: php-version: '8.1'
name: Install dependencies run: composer install --no-dev
name: Run tests run: vendor/bin/phpunit
name: Push to Satis server run: | ssh user@your-server "cd /path/to/satis && git pull && php bin/satis build" env: SSH_PRIVATE_KEY: ${{ secrets.SSH_PRIVATE_KEY }}
此流程会在你打tag(如v1.0.0)时自动测试并更新Satis仓库。
4. 在项目中使用私有包
在需要使用该包的项目中,修改composer.json,添加仓库源:
"repositories": [ { "type": "composer", "url": "https://packages.yourcompany.com" } ]然后正常 require 包:
composer require your-company/your-package:^1.0
基本上就这些。只要CI流程稳定,每次打tag就能自动发布新版本,团队可即时使用最新功能。关键点是权限控制和SSH密钥安全,建议使用部署密钥并限制访问范围。









