如何将WordPress远程附件存储到腾讯云对象存储COS上

WordPress / 更新于 / 55 条评论 /

WordPress 是使用 PHP 语言开发的博客平台，用户可以在支持 PHP 和 MySQL 数据库的服务器上架设属于自己的网站，也可以把 WordPress 当作一个内容管理系统（CMS）来使用。

WordPress 功能强大、扩展性强，这主要得益于其插件众多，易于扩充功能，基本上一个完整网站该有的功能，通过其第三方插件都能实现所有功能。

简介

这篇文章我们来介绍一下通过使用插件实现远程附件功能，将 WordPress 的媒体库附件存储在腾讯云COS上

腾讯云 COS 具有高扩展性、低成本、可靠和安全等特点，将媒体库附件保存在 COS 上有以下好处：

  • 附件将拥有更高的可靠性；
  • 用户查看图片附件时将直连 COS 服务器，不占用您服务器的下行带宽/流量，用户访问速度更快；
  • 可配合腾讯云 CDN 进一步提升用户查看图片附件的速度，优化网站访问速度。

准备工作

1. 搭建 WordPress 博客平台

  • 可以在 WordPress 官方页面 下载 WordPress 的最新版并查看安装指南
  • 或者在安装服务器系统时在镜像市场中选择预装 WordPress博客平台 的 CVM 镜像

2. 创建一个公有读私有写的存储桶，存储桶的地域建议与运行 WordPress 博客平台的 CVM 的地域相同，创建详情请参见 创建存储桶 文档

3. 在存储桶列表中找到刚刚创建的存储桶，并单击配置管理

sync-qcloud-cos-1

4. 单击左侧的基础配置，查看访问域名并记录

sync-qcloud-cos-2

5. 访问 WordPress 后台，访问插件-安装插件页面 /wp-admin/plugin-install.php，安装插件

  • 从 Github 或 WordPress Plugins 下载最新 releases 源码，通过 WordPress 后台上传安装，或者直接将源码上传到 WordPress 插件目录 wp-content/plugins，然后在后台启用
  • 后台搜索Sync QCloud COS进行安装（推荐使用）

配置Sync Qcloud COS插件

1. 在 WordPress 后台管理左侧导航栏设置下腾讯云COS设置，点击进入设置页面，配置说明见下表

配置项 配置值
存储桶名称 创建存储桶时自定义的名称
存储桶地域 创建存储桶时所选择的地域
APP ID 开发商 APPID，创建存储桶时名称后的ID
SecretID 前往「云 API 密钥」进行获取
SecretKey 前往「云 API 密钥」进行获取
不上传缩略图 勾选后不会上传对应的缩略图文件，建议不勾选
不在本地保留备份 勾选后不会在本地保留原文件，建议不勾选
本地文件夹 本地保存路径，例wp-content/uploads
不在本地保留备份 勾选后不会在本地保留原文件，建议不勾选
URL前缀 COS访问域名/本地文件夹，例https://media-10000000.cos.ap-shanghai.myqcloud.com/wp-content/uploads

2. 填写完成后点击保存更新即可

3. 测试上传一个新文件，查看附件详情，查看附件图片的 URL，确认附件图片的 URL 指向腾讯云 COS

sync-qcloud-cos-3

如果以上是成功的，那么就需要同步旧资源到COS存储桶当中，可以使用COSCMD或者COS Migration，否则后台无法正常预览旧资源；同步完成以后，可以开启回源设置，参考下文的设置回源。

扩展

1. 使用 CDN 加速访问

存储桶如果需要配置 CDN 加速，可参见 CDN 加速配置 文档

在插件设置中将URL前缀修改为默认 CDN 加速域名或自定义加速域名即可

2. 替换数据库中的资源地址

如果不是新创建的站点，数据库当中必定是旧的资源链接地址，我们需要替换一下，插件提供了替换功能，在首次替换前记得备份

旧域名填写原资源域名，如https://qq52o.me/
新域名填写现在的资源域名，如https://img.qq52o.me/

3. 设置跨域访问

在文章中引用对应的资源链接，控制台会提示跨域的错误 No 'Access-Control-Allow-Origin' header is present on the requested resource. 原因是没有添加 header

需要你的 COS 源的 CDN 中添加 HTTP Header 配置

Access-Control-Allow-Origin:*

或者只允许你自己的域名

Access-Control-Allow-Origin:https://qq52o.me

在存储桶的基础设置中设置 跨域访问CORS，详细请查看对应文档 设置跨域访问

sync-qcloud-cos-4

4. 设置回源

如果不在WordPress后台媒体库处上传资源，建议开启回源设置，详细请查看对应文档设置回源

开启之后，客户端首次访问COS源文件时，COS 发现无法命中对象时，对客户端返回 302 HTTP 状态码并跳转至回源地址对应的地址，此时对象由源站提供给客户端，保证访问。同时 COS 从源站复制该文件并保存至存储桶对应的目录中；第二次访问时 COS 直接命中对象并返回给客户端。

因为WordPress设计问题，在后台媒体库上传资源会占用文章ID，所以我一般是不在后台上传的

写在最后

项目地址：Github 支持请点Star




沈唁志，一个PHPer的成长之路！
任何个人或团体，未经允许禁止转载本文：《如何将WordPress远程附件存储到腾讯云对象存储COS上》，谢谢合作！
赞赏
alipay支付宝赞赏
wechat微信赞赏

如果给您解决燃眉之急或带来些许明朗，您可以打赏一杯咖啡或一杯香茗

55 条评论

发表评论

*

  • 大佬，按照你的教程设置保存后，会提示“此站点正遇到技术问题，请查看您的站点管理员电子邮件收件箱来获得指引”，这个怎么处理？

    回复

  • 大神好，我图片不是很多，大小也不大。设置了cdn加速域名。开始同步后就会卡死，开始没注意，网站上的大部分图片都不见了，显示为白色或者显示“暂时无法打开图片”。然后，我继续刷新后台，点击开始同步，慢慢地搞了几次卡死几次，图片回来了一半吧，但是后面一般就比较困难了，有点担心能不能显示回来

    回复

    • @喵了个咪 fpm同步卡死是正常的，浏览器一直在转圈。你可以把图片手动上传到cos，或者使用cos的命令行工具上传上去以后再替换。
      图片是不会丢失的，放心即可。

      回复

  • 您好大大，我按照您的教程设置完点保存会弹出这个
    “Error thrown Call to undefined function GuzzleHttp\_idn_uri_convert()”
    请问这是什么原因，怎么解决呢？恭候您的回复

    回复

  • Fatal error: Uncaught GuzzleHttp\Exception\RequestException: cURL error 60: SSL certificate problem: self signed certificate in certificate chain (see https://curl.haxx.se/libcurl/c/libcurl-errors.html) in……汉字

    回复

      • @沈唁 就是正常的操作……插件下载下来之后，第一次配置有用。然后我想修改媒体上传路径，就把插件禁用了。改完媒体路径之后，再次启用，填完信息之后就报错了。删了重新下载插件也没用。

        回复

        • @STBLOG 从curl官方网站http://curl.haxx.se/ca/cacert.pem，下载根证书：cacert.pem ，然后修改php.ini中加入该证书，并重启fpm服务。
          在php.ini中加入

          [SSL]
curl.cainfo = "/yourpath/cacert.pem"
openssl.cafile = "${curl.cainfo}"

  • 站长您好，我目前遇到一个问题，配置方面都按步骤来了。上传都正常，也是无法显示图片。
    打开图片就是这样的提示，这是什么原因？

    回复

  • 博主你好！我配置完成后，在wordpress后台上传图片，可以在存储桶里找到。但是图片在wordpress的媒体库里是碎的，发布到文章里也是碎的，不知道问题出在哪里。
    前缀是用的存储桶的访问域名，本地文件夹是wp-content/uploads。如能帮助，非常感谢！

    回复

  • 你好,行政官
    在文字版Admin页面激活此插件后,我不能上传图片。

    回复

  • 搞完之后为什么图片不显示了，上传新的图片也不显示

    回复

  • 这个同步历史附件..好像不太管用啊 😥 明明历史附件就2个 但是没反应

    回复

  • 您的站点遇到了致命错误，请查看您的站点的管理电子邮箱来获得指引。

    了解更多在WordPress中调试的信息。
    填写完保存的时候提示这个

    回复

  • “存储桶名称错误，可能是 XXX…”错误，可能的子用户密钥支持无效反馈。
    详见GitHub issues：https://github.com/sy-records/wordpress-qcloud-cos/issues/6。
    邮件回复可协助测试，或补充信息。开源不易，表示支持。

    回复

  • Fatal error: Uncaught Qcloud\Cos\Exception\ServiceResponseException: Cos Error Code: AccessDenied, Status Code: 403, Cos Request ID: ***********=, 汉语

    回复

  • 大佬发生了一个致命错误，1.5.1使用正常的

    回复