使用PHP为Google Cloud Storage创建Pub/Sub通知的相关问题

需求可行性确认 #

完全可以实现，Google Cloud Storage（GCS）原生支持配置事件通知规则，当存储桶内发生指定对象事件时，会自动推送消息到绑定的Pub/Sub主题，你部署在GKE的图像处理函数只需订阅该主题即可拉取触发通知。

现有代码问题 #

你当前编写的代码无法实现通知创建逻辑：$bucket->notification($notification_id)方法的作用是获取存储桶下已存在的通知实例，而非创建新通知。

通知ID相关说明 #

• 通知ID不需要你手动指定，GCS会在通知创建成功后自动生成唯一的ID值返回
• 若你强制传入自定义ID，且该ID已被同存储桶下的其他通知占用，创建请求会直接返回冲突错误，不会覆盖原有通知配置

正确创建代码示例 #

首先需要完成两项前置配置：

• 提前创建好用于接收通知的Pub/Sub主题
• 为GCS官方服务账号 service-<你的项目数字ID>@gs-project-accounts.iam.gserviceaccount.com 授予该Pub/Sub主题的Pub/Sub发布者角色，否则GCS没有权限推送消息到主题
  正确的PHP创建代码如下：

$client = new StorageClient([
    'projectId' => '<你的项目ID>',
    'keyFile' => '<密钥文件内容或路径>'
]);

$bucketName = '<你的存储桶名称>';
// 替换为你的Pub/Sub主题完整资源名
$pubsubTopic = 'projects/<你的项目ID>/topics/<你的Pub/Sub主题名称>';

$notificationParams = [
    // 指定触发通知的事件类型，OBJECT_FINALIZE对应新文件上传完成事件
    'eventTypes' => ['OBJECT_FINALIZE'],
    // 指定载荷格式为完整JSON元数据
    'payloadFormat' => 'JSON_API_V1',
    // 可选配置：仅触发指定前缀/后缀的对象事件，如下示例仅触发jpg格式文件上传
    // 'suffix' => '.jpg',
    // 'prefix' => 'upload/images/'
];

$bucket = $client->bucket($bucketName);
// 调用createNotification方法创建新通知
$notification = $bucket->createNotification($pubsubTopic, $notificationParams);

// 创建成功后可获取自动生成的通知ID
$generatedNotificationId = $notification->id();

载荷内容说明 #

你选择的JSON_API_V1格式下，Pub/Sub消息的data字段为Base64编码的对象完整元数据，解码后结构与GCS JSON API返回的对象资源结构完全一致，可直接获取文件名、文件大小、上传时间、自定义元数据等所有信息，满足图像处理逻辑的参数需求。

内容的提问来源于stack exchange，提问作者Andy Wallace