composer包测试与packagist集成的核心是：测试在本地及ci（如github actions）中运行，packagist仅自动同步tag触发的元数据更新；需配置phpunit、ci流程、语义化tag及自动更新开关。
为 Composer 包编写自动化测试并集成到 Packagist，核心在于：测试本身不依赖 Packagist，而是在你自己的代码仓库中完成；Packagist 只负责自动同步元数据，不运行测试。真正需要集成的是 CI（如 GitHub Actions、GitLab CI）来跑测试，并在通过后自动推送 tag 触发 Packagist 更新。
1. 在包中组织好测试（推荐 PHPUnit）
确保你的 Composer 包根目录下有标准的测试结构：
- 测试代码放在 tests/ 目录，与 src/ 平行
- 安装 PHPUnit：运行
composer require --dev phpunit/phpunit - 添加 phpunit.xml 或 phpunit.xml.dist 配置文件，指定
tests/为测试目录、src/为源码自动加载路径 - 写一个简单测试验证流程，比如
tests/ExampleTest.php中测试某个类是否可实例化
2. 配置 GitHub Actions 自动运行测试
在项目根目录新建 .github/workflows/test.yml：
- 触发条件设为
push和pull_request，覆盖main（或默认分支）和**.php文件变更 - 使用官方
actions/checkout@v4拉取代码 - 用
shivammathur/setup-php安装 PHP 和扩展（如 mbstring、xml） - 运行
composer install --no-interaction --prefer-dist - 最后执行
vendor/bin/phpunit，失败则 CI 报红
这样每次提交或 PR 都会自动验证代码质量，避免带 bug 的版本被发布。
3. 正确打 tag 并关联 Packagist
Packagist 不主动拉取代码，而是监听你仓库的 tag 推送事件：
- 确保 Packagist 项目已正确绑定你的 GitHub/GitLab 仓库（在 packagist.org 添加包时勾选 “Update automatically”）
- 发布新版本时，先提交所有变更，再打语义化版本 tag，例如：
git tag v1.0.1 && git push origin v1.0.1 - Packagist 收到 tag 推送后，会自动抓取该 commit 的
composer.json并更新包信息（包括 version、description、autoload 等） -
注意：tag 必须对应一个包含有效
composer.json的 commit，且 version 字段需匹配 tag 名（如"version": "1.0.1"或留空由 Packagist 推断）
4. 可选：添加静态分析和代码风格检查
进一步提升质量，可在 CI 中补充：
-
PHPStan：检查类型安全，运行
vendor/bin/phpstan analyse src/ tests/ -
PHP-CS-Fixer：统一代码风格，加一步
vendor/bin/php-cs-fixer fix --dry-run --diff - 这些工具都可通过
--dev安装，配置进同一份 workflow 即可
基本上就这些——测试在本地和 CI 里跑，Packagist 只管“看见 tag 就同步”，不复杂但容易忽略自动更新开关和 tag 命名规范。
