华为云OBS需用官方PHP SDK（非内置）读写文件，因所有请求须带V4签名认证；直接fopen或file_get_contents访问OBS URL会失败。安装：composer require huaweicloud/huaweicloud-sdk-php-obs；上传用putObject（小文件）或uploadFile（大文件），Body传内容/流而非路径；下载时$result['Body']是数据本身，非文件路径，大文件建议用SaveAs参数落盘。
华为云OBS对象存储怎么用PHP读写文件
PHP本身不内置华为云OBS支持，必须通过官方SDK或REST API调用。直接用fopen或file_get_contents访问OBS的URL会失败——OBS不提供匿名HTTP读写，所有请求需带签名认证。
推荐使用华为云官方PHP SDK（huaweicloud-sdk-php-obs），它封装了签名、分片上传、断点续传等细节。安装方式：
composer require huaweicloud/huaweicloud-sdk-php-obs
关键前提是：你已开通OBS服务，并在华为云控制台获取了Access Key ID和Secret Access Key（不是IAM临时Token，除非你明确走STS流程）。
PHP怎么上传文件到OBS桶（PutObject）
OBS上传不是简单POST，必须构造带V4签名的请求。SDK自动处理，但要注意几个硬性条件：
立即学习“PHP免费学习笔记（深入）”；
-
region必须准确匹配桶所在区域（如cn-north-4），填错会导致InvalidRegion错误 - 桶名（
bucketName）必须全局唯一，且不能含下划线、大写字母；路径（objectKey）支持斜杠模拟目录结构，但本质仍是扁平键名 - 本地文件大于100MB建议用
uploadFile（自动分片），小文件用putObject更轻量
最小可用示例：
$obsClient = new ObsClient([
'key' => 'your-access-key-id',
'secret' => 'your-secret-access-key',
'endpoint' => 'https://obs.cn-north-4.myhuaweicloud.com',
'region' => 'cn-north-4'
]);
$result = $obsClient->putObject([
'Bucket' => 'my-bucket-name',
'Key' => 'uploads/photo.jpg',
'Body' => file_get_contents('/tmp/photo.jpg')
]);
注意：Body参数可传字符串、资源流（fopen返回值）或SplFileObject，但不能传路径字符串——这是新手最常踩的坑。
PHP怎么从OBS下载/读取文件（GetObject）
OBS不支持直接include或require远程URL，必须先拉取内容再处理。常见误操作是把getObject返回值当文件路径用。
getObject返回的是关联数组，真实数据在['Body']字段里：
$result = $obsClient->getObject([
'Bucket' => 'my-bucket-name',
'Key' => 'logs/app-2024.log'
]);
// 正确：获取原始内容
$content = $result['Body'];
// 错误：$result['Body']不是文件路径，不能直接fopen
// $fp = fopen($result['Body'], 'r'); // 会报Warning: failed to open stream
如果文件较大（比如日志超过50MB），别一次性读进内存，改用流式处理：
$stream = $obsClient->getObject([
'Bucket' => 'my-bucket-name',
'Key' => 'big-file.zip',
'SaveAs' => '/tmp/big-file.zip' // 直接落盘
]);
此时SaveAs参数必须是可写的本地绝对路径，相对路径容易因PHP工作目录不一致导致写入失败。
为什么用OBS SDK比自己拼REST API更稳妥
华为云OBS的V4签名规则极其繁琐：要按特定顺序拼接HTTP方法、URI、查询参数、头部、payload哈希，再用密钥层层HMAC-SHA256。手动实现极易出错，典型表现是SignatureDoesNotMatch或InvalidRequest，但错误信息不提示具体哪一步错了。
SDK还帮你屏蔽了这些细节：
- 自动处理时区问题（签名时间必须用UTC）
- 对中文
Key自动URL编码，避免InvalidObjectName - 重试逻辑内置（网络抖动时自动重试3次）
- 支持HTTPS强制校验，禁用SSL验证需显式设
'ssl.certificate_authority' => false（仅测试环境）
真正麻烦的从来不是“能不能连上”，而是签名过期时间窗口（默认15分钟）、跨区域Endpoint写错、以及桶策略（Bucket Policy）没放开对应操作权限——这些都得去华为云控制台确认，光看PHP代码查不出来。
