MediaWiki是一套基于网络的Wiki引擎,维基媒体基金会的所有项目乃至众多wiki网站皆采用了这一软件。MediaWiki软件最初是为自由内容百科全书维基百科所开发的,今日已被一些公司机构部署为内部的知识管理和内容管理系统。----"维基百科"
作为一套内容管理系统,在使用过程中肯定需要存储大量的图片,视频,文档等资源,而将这些资源保存在第三方,通过cdn进行加速是现在常见的做法。本文将主要介绍在使用mediawiki的亚马逊AWS扩展将文件存在s3的过程中遇到的一些常见问题以及解决方案。
- 插件安装
可以进入mediawiki AWS的官方插件库进行下载安装,地址https://www.mediawiki.org/wiki/Extension:AWS
简单描述一下步骤
1.下载AWS扩展库的文件
首先你需要安装git,然后在wiki的项目目录下执行
cd /extension
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/AWS.git
2.安装AWS扩展需要的依赖
这部分工作通过composer完成,所以你需要安装composer,此时,我们还是在extension目录下,接下来执行
cd AWS/
composer install
composer require wikimedia/base-convert
3.修改wiki的配置文件
最后,我们需要对wiki的配置文件,也就是LocalSettings.php文件进行修改,如果在安装wiki时没有开启图片上传功能,则我们首先需要做以下修改
$wgEnableUploads = true;(将false改为true)
然后添加AWS的配置文件
require_once("$IP/extensions/AWS/AWS.php");
// Configure AWS credentials
$wgAWSCredentials = array(
'key' => 'you-key',
'secret' => 'your-secret',
'token' => false
);
$wgAWSRegion = 'your-region';
$wgFileBackends['s3']['containerPaths'] = array(
'dbname-local-public' => 'some_s3_bucket_1',
'dbname-local-thumb' => 'some_s3_bucket_2',
'dbname-local-deleted' => 'some_s3_bucket_3',
'dbname-local-temp' => 'some_s3_bucket_4'
);
// Make MediaWiki use Amazon S3 for file storage.
$wgLocalFileRepo = array (
'class' => 'LocalRepo',
'name' => 'local',
'backend' => 'AmazonS3',
'scriptDirUrl' => $wgScriptPath,
'scriptExtension' => $wgScriptExtension,
'url' => $wgScriptPath . '/img_auth.php',
'zones' => array(
'public' => array( 'url' => 'http://s3.your-region.amazonaws.com.cn/some_s3_bucket_1' ),
'thumb' => array( 'url' => 'http://s3.your-region.amazonaws.com.cn/some_s3_bucket_2' ),
'temp' => array( 'url' => 'http://s3.region.amazonaws.com.cn/some_s3_bucket_4' ),
'deleted' => array( 'url' => 'http://s3.region.amazonaws.com.cn/some_s3_bucket_3' )
)
);
//$wgJobTypeConf['default'] = array( 'class' => 'JobQueueAmazonSqs' );
unset($wgJobTypeConf['sqs']);
$wgShowExceptionDetails = true;
以上配置文件需要做替换的内容包括你的key、secret、region(国内是“cn-north-1”)、dbname(也就是你这个wiki的数据库名称),还有就是四个存储桶的名称,要做到一一对应。这些工作都完成之后,再打开你的wiki,点击上传图片,应该就可以将你的图片存储到s3上了。
注意以下问题
1.经过本人测试,如果需要使用AWS插件上传文件,wiki的数据库不能设置表前缀,否则会出现无法创建文件夹的报错信息。
2.所有步骤完成后,开始上传的几张图片可能会出现无法生成缩略图的情况,但是图片上传是成功的,这种情况下可以清除缓存,重新登录。