关于mediawiki使用aws上传插件的一些常见问题

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.所有步骤完成后，开始上传的几张图片可能会出现无法生成缩略图的情况，但是图片上传是成功的，这种情况下可以清除缓存，重新登录。