php怎么集成腾讯云cos_php如何上传文件到腾讯云对象存储-php教程-PHP中文网

“SignatureDoesNotMatch”错误主因是系统时间偏移超15分钟或region不匹配；需校准NTP时间、确认密钥有效、初始化时严格匹配Bucket地域；大文件须用upload方法分片上传，中文key需URL编码，上线前检查HTTPS/TLS及内网endpoint配置。

php怎么集成腾讯云cos_php如何上传文件到腾讯云对象存储

cos\_php SDK 安装后 `putObject` 报错 “SignatureDoesNotMatch”

这基本是签名失效或时间偏移导致的，不是密钥填错了——腾讯云 COS 要求本地系统时间与 NTP 时间误差不超过 15 分钟。SDK 默认用本地时间生成签名，一旦差太多，服务端直接拒收。

先执行 ntpdate -q pool.ntp.org（Linux/macOS）或检查 Windows 时间服务是否启用
确认 SecretId 和 SecretKey 是「访问管理 > API 密钥管理」里新建的，不是旧账号的遗留密钥（旧密钥可能被禁用或权限不足）
初始化 CosClient 时别漏掉 region 参数，比如广州是 ap-guangzhou，写成 gz 或空字符串都会触发签名校验失败

上传大文件（>5MB）时卡住或内存爆掉

直接用 putObject 传大文件会把整个文件读进内存再发请求，PHP 内存限制一到就 Fatal error: Allowed memory size exhausted。必须切片上传。

改用 uploadPart + initiateMultipartUpload + completeMultipartUpload 流程，SDK 已封装为 upload 方法（注意不是 putObject）
调用 $cosClient->upload($bucket, $key, $localFilePath) 即可自动分片，SDK 默认按 5MB/片，支持断点续传
如果必须手动控制分片大小，传入 ['partSize' => 10 * 1024 * 1024]（10MB），但别设太小（

上传后文件在控制台显示乱码或无法预览

本质是 ContentType 没设对，浏览器不知道怎么解析内容。COS 不会自动识别文件类型，全靠你传的 Content-Type 头。

腾讯云通用票据识别（高级版）

腾讯云通用票据识别高级版(VatInvoiceOCR)接口调用技能。当用户需要识别发票图片中增值税专用发票、增值税普通发票、增值税电子专票、增值税电子普票、电子发票（普通/增值税专用）的全字段信息时,应使用此技能。支持识别发票图片中的发票代码、发票号码、开票日期、合计金额、校验码、税率、合计税额、价税合计、购买方...

下载

上传时显式指定 ContentType：putObject 的 $options 数组里加 'ContentType' => 'image/jpeg'
常见类型别硬背：图片用 mime_content_type($filePath) 动态获取；JSON 文件必须是 application/json，不是 text/plain
中文文件名要 URL 编码后再作为 $key，否则控制台列表里显示为 %E4%BD%A0%E5%A5%BD.jpg 是正常现象，不影响访问，但别在 key 里混用未编码的中文和特殊符号（如 \、?）

本地测试 OK，上线后 `putObject` 一直超时

大概率是服务器出方向被拦截了——腾讯云 COS 的 endpoint 域名（如 cos.ap-guangzhou.myqcloud.com）走的是 HTTPS，需要确保 PHP 的 cURL 支持 TLS 1.2+，且没被公司防火墙或安全组策略屏蔽。

用 curl -I https://cos.ap-guangzhou.myqcloud.com 在服务器终端直连测试，看是否能通
检查 PHP 是否禁用了 allow_url_fopen 或 cURL 扩展未启用（php -m | grep curl）
如果用的是内网 COS（如 CVM 和 COS 同地域），把 endpoint 换成内网地址 cos-internal.ap-guangzhou.myqcloud.com，延迟更低且不走公网流量

最常被忽略的一点：COS 的 Bucket 名称必须全局唯一，且创建时选的地域（region）和代码里初始化客户端时填的 region 必须完全一致，字母大小写都不能错——比如控制台建的是 ap-beijing，代码写了 ap-beiJing，上传永远 403 或超时。