如何使用PHP为Contabo对象存储生成预签名URL

Contabo对象存储100%兼容S3 v4协议，不需要手动实现签名逻辑，也不需要依赖Cyberduck等外部工具，直接调整AWS PHP SDK的配置即可直接复用S3预签名能力，步骤如下：

• 首先通过Composer安装AWS SDK for PHP：
  composer require aws/aws-sdk-php
• 初始化适配Contabo的S3客户端，核心是替换接入端点、开启路径风格寻址，示例代码：

require 'vendor/autoload.php';
use Aws\S3\S3Client;

$s3 = new S3Client([
    'version' => 'latest',
    'region'  => '替换为你的存储桶所属区域，例如eu-central-1',
    'endpoint' => '替换为你所属区域的Contabo对象存储接入地址，例如欧盟区为https://eu2.contabostorage.com',
    'credentials' => [
        'key'    => '你的Contabo对象存储Access Key',
        'secret' => '你的Contabo对象存储Secret Key',
    ],
    'use_path_style_endpoint' => true, // 必开项，Contabo不支持虚拟主机风格寻址，这是多数AWS适配代码在Contabo上报错的核心原因
]);

• 调用SDK内置方法生成预签名URL，以生成文件下载/访问链接为例：

// 构造获取对象的命令
$cmd = $s3->getCommand('GetObject', [
    'Bucket' => '你的存储桶名称',
    'Key'    => '文件在桶内的完整路径，例如docs/2024/report.pdf'
]);
// 设置链接有效期，示例为2小时，可根据需求自行调整
$presigned = $s3->createPresignedRequest($cmd, '+2 hours');
$presignedUrl = (string)$presigned->getUri();

生成的$presignedUrl即可直接使用，不需要额外加工。

补充说明：如果需要生成允许上传的预签名URL，只需要把命令中的GetObject替换为PutObject即可，其余逻辑完全一致。

常见报错排查 #

• 访问链接返回403 SignatureDoesNotMatch：优先检查use_path_style_endpoint是否开启、endpoint地址和区域是否和桶所属区域匹配、AK/SK是否填写正确且拥有对应桶的操作权限。
• 不要尝试手动编写签名逻辑：S3 v4签名对字符串编码、参数排序、时间戳格式、签名头范围的要求非常严格，手动实现很容易出现细节错误，SDK的签名实现经过大规模生产验证，对所有兼容S3协议的存储服务（包括Contabo）都能正常适配。

内容的提问来源于stack exchange，提问作者Carmelo Campos