如何为私有Composer仓库配置Webhook以实现自动更新_Satis或Private Packagist的自动化包索引-composer-PHP中文网

如何为私有Composer仓库配置Webhook以实现自动更新_Satis或Private Packagist的自动化包索引

穿越時空

发布： 2025-12-01 15:42:07

原创

809人浏览过

配置私有Composer仓库Webhook可实现代码提交后自动更新包索引。1. Webhook由GitHub等平台在推送时触发，向公网可访问的URL发送POST请求。2. 使用Satis时需编写接收脚本（如webhook.php），验证签名后执行satis build命令生成静态仓库。3. 脚本部署在Web目录并限制访问，Git平台配置对应URL、密钥及触发事件。4. Private Packagist可直接使用其提供的Webhook地址，实现近乎实时的自动同步。5. 建议启用签名验证、记录日志、避免硬编码敏感信息以提升安全性与稳定性。完成后开发者只需composer update即可拉取最新包。

如何为私有composer仓库配置webhook以实现自动更新_satis或private packagist的自动化包索引

为私有Composer仓库配置Webhook，可以实现在代码提交或包版本更新时自动触发Satis或Private Packagist的索引更新。这样能确保你的私有PHP包始终在镜像仓库中保持最新状态，无需手动运行构建命令。

1. 理解Webhook的作用机制

当你的Git仓库（如GitHub、GitLab或Bitbucket）发生推送事件（如push新tag或commit），会向预设的URL发送一个HTTP POST请求。这个URL指向你部署的接收脚本，脚本接收到通知后执行Satis生成或触发Private Packagist同步。

关键点：

Webhook由代码托管平台发起
目标URL需可公网访问（如使用内网需配合ngrok等工具）
接收端需验证请求来源以确保安全

2. 配置Satis自动化索引更新

如果你使用Satis自建静态包仓库，可通过以下步骤实现自动构建：

步骤一：编写Webhook接收脚本

示例：webhook.php

<?php
$payload = json_decode(file_get_contents('php://input'), true);

// 可选：验证签名或IP来源
$secret = 'your-webhook-secret';
$signature = $_SERVER['HTTP_X_HUB_SIGNATURE_256'] ?? '';
if (!hash_equals('sha256=' . hash_hmac('sha256', file_get_contents('php://input'), $secret), $signature)) {
    http_response_code(403);
    exit('Invalid signature');
}

// 执行satis build
exec('/usr/bin/php /path/to/satis/bin/satis build /path/to/satis.json /path/to/output', $output, $returnCode);

if ($returnCode !== 0) {
    error_log('Satis build failed: ' . implode("\n", $output));
}
?>

登录后复制

步骤二：部署并保护脚本路径