当前位置：首页 > news >正文

帝国CMS阿里云OSS插件

news 2026/6/13 8:31:03

插件介绍

Wayne OSS插件，将网站附件上传至阿里云OSS对象存储，减轻服务器存储与带宽压力。上传、删除、缩略图生成全流程自动同步，本地附件一键批量迁移至OSS，无缝集成帝国CMS 7.5/8.0。

功能特点

附件直传OSS：后台上传、编辑器上传时直接写入OSS
删除双向同步：删除文章/附件时自动删除OSS对应文件，避免垃圾文件占用空间
缩略图自动同步：帝国CMS生成缩略图/水印图后自动同步至OSS，无需手动处理
批量迁移：分批将存量数据同步至OSS并替换数据库记录
CDN加速：支持配置自定义CDN域名，全站附件地址自动替换为CDN地址
保留本地备份：可配置上传后是否保留本地文件，灵活切换
版本兼容：自动识别帝国CMS 7.5/8.0
连接测试：后台一键测试OSS连通性，验证配置正确性
CDN域名：支持CDN域名加速

安装步骤

操作前请务必备份数据库及程序文件。

前置准备

阿里云 OSS 准备
- 已开通阿里云 OSS 服务，并创建好 Bucket
- 已获取 AccessKey ID 和 AccessKey Secret
- 如果需要 CDN 加速，已在阿里云 CDN 控制台配置好加速域名并指向 OSS Bucket
初始化
- 解压下载的 ZIP 包
- 将e/extend/empire_oss/目录上传到站点的e/extend/下
- 手动访问你的站点/e/extend/empire_oss/install.php进行安装
- 在e/extend/empire_oss/core/config.php文件头部的$ak和$sk变量中填入 AccessKey ID 与 AccessKey Secret

覆盖安装

如果没有修改过zip包相关的程序文件，可以复制e覆盖即可

手动安装

如果修改过zip包相关的程序文件，需要对照以下修改点手动修改：

文件 1：e/class/connect.php

① 文件头部（第 214 行之前）— 插件自动载入

在//--------------- 数据库 ---------------之前，插入一行：

@include_once ECMS_PATH.'e/extend/empire_oss/index.php';

② DoTranFile 函数（第 5618 行）— 文件移动后同步至OSS

在函数末尾return $r之前（FileServer 块之后），插入：

$r = emposs_sync::file($r);

说明：DoTranFile是帝国CMS核心上传函数，此处注入后可确保所有本地上传（编辑器上传、后台附件上传、批量上传）自动同步至OSS，无需在其他调用方重复注入。

③ DoTranUrl 函数（第 5833 行）— 远程下载文件后同步至OSS

在函数末尾return $r之前（FileServer 块之后），插入：

$r = emposs_sync::file($r);

④ ecom_DoTranFile 函数（第 5777 行）— 普通上传文件同步至OSS

在return 1之前，插入：

$ossR = array('yname' => $r['yname']); emposs_sync::file($ossR);

⑤ DoDelFile 函数（第 5921 行）— 删除本地文件时同步删除OSS文件

在DelFiletext($delfile)之前，插入：

emposs_sync::delete($fspath['filepath'].$path.$r['filename']);

文件 2：e/class/gd.php

⑥ ResizeImage 函数（第 5 行）— OSS文件不存在时从OSS拉回本地

在函数体首行之后，插入：

if(!file_exists($big_image_name) && class_exists('emposs_sync')) {$big_image_name = emposs_sync::ensureLocal($big_image_name);}

⑦ ResizeImage 函数 — 生成的缩略图同步至OSS

该函数有两个正常出口（第 43 行和第 98 行），在每处return $returnr之前，分别插入：

if(class_exists('emposs_sync')){$__r=emposs_sync::file(array('yname'=>$new_name.$func_exname));if(!empty($__r['url'])){$returnr['oss_url']=$__r['url'];}}

文件 3：e/class/functions.php

⑧ GetFpicToTpic 函数（第 1397 行）— 标题图片URL替换为OSS/CDN地址

在“缩略图”分支中$firsttitlepic=$fspath['fileurl'].$rpath."small".$insertfile.$sfiler['filetype'];之后，插入：

if(!empty($sfiler['oss_url'])) { $firsttitlepic=$sfiler['oss_url']; }

在“非缩略图”分支中$firsttitlepic=$fspath['fileurl'].$rpath.$picr['filename'];之后，插入：

$firsttitlepic = emposs_sync::ossUrl($firsttitlepic);

修改完成后，进入帝国CMS后台 → 插件管理 → Wayne OSS插件，完成配置即可使用。

配置步骤

进入后台 →插件→Wayne OSS插件

填写阿里云OSS参数：

配置项	说明
启用插件	勾选后生效
OSS服务商	选择"阿里云OSS"
Bucket	OSS Bucket名称
Endpoint	Endpoint域名
CDN域名	可选
CName绑定	Endpoint为自定义域名时勾选
保留本地备份	勾选后上传不会删除本地文件