查看“安装MW：安装与更新”的源代码

[[category:MediaWiki]]

== 安装 ==
安装需求：LAMP/LNMP（Windows等服务器亦可；本服务器采用LNMP，安装及注意与Wordpress类似），PHP7.2.9及以上(含有Perl兼容正则表达式、含有标准PHP库、含有JSON支持)、MySQL5.5.8及以上（/MariaDB/PostgreSQL9.2+/SQLite 3.8+）。<br/>
<blockquote>'''与PHP 7.4.0至7.4.2不兼容！Oracle与Microsoft SQL Server不再被支持！'''</blockquote><br/>
步骤：
{| class="wikitable" style="width: 100%;"
|-
! style="width: 20%;" | 步骤 
! style="width: 80%;" | 截图
|-
|
# 欢迎使用
# 语言
# 设置数据库
# wiki名称
# 配置选项
# 确认安装
# 安装完成
# 下载LocalSettings.php并上传到服务器MediaWiki根目录
# 修改服务器LocalSettings.php文件属性
# 完成安装成功访问

|
<gallery mode="slideshow">
File:1欢迎使用 MediaWiki安装.jpg|缩略图|1欢迎使用
File:2语言_MediaWiki安装.jpg|缩略图|2语言
File:3wiki名称_MediaWiki安装.png|缩略图|3wiki名称
File:4设置数据库_MediaWiki安装.png|缩略图|4设置数据库
File:5配置选项_MediaWiki安装.png|缩略图|5配置选项
File:6确认安装_MediaWiki安装.png|缩略图|6确认安装
File:7安装完成_MediaWiki安装.png|缩略图|7安装完成
File:8下载LocalSettings.php并上传到服务器MediaWiki根目录_MediaWiki安装.png|缩略图|8LocalSettings.php上传
File:9修改服务器LocalSettings.php文件属性_MediaWiki安装.png|缩略图|9修改属性
File:10完成安装成功访问_MediaWiki安装.png|缩略图|10完成安装
</gallery>
|}

== 配置 ==
MediaWiki的配置文件有两处：
# '''/www/wwwroot/xxx.com/includes/DefaultSettings.php''' ： 系统默认的配置文件；
# '''/www/wwwroot/xxx.com/LocalSettings.php''' ： 用户设置的配置文件；
主要在LocalSettings.php中进行设置和覆盖相应配置，对DefaultSettings.php只是做较少的修改<br/>

=== 修改默认logo ===
LocalSettings.php中，'''''$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png"'''''。<br/>
更改logo的方法有两种，
# 替换“./resources/assets/wiki.png”为同名图片(不建议，因为更新系统时会覆盖该默认图片)；
# 另行制定其他路径下的自定义图片，如“$wgLogo = "$wgResourceBasePath/images/logo.jpg"”。
<pre>
## The URL path to the logo.  Make sure you change this from the default,
## or else you'll overwrite your logo when you upgrade!
$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
</pre>

=== 去除底部的power by图标 ===
LocalSettings.php中，加入 '''''unset($wgFooterIcons['poweredby']);'''''。

=== 修改皮肤 ===
LocalSettings.php中，'''''$wgDefaultSkin = "vector";'''''。<br/>
MediaWiki的皮肤位于“./skins”中，可在网络下载并上传至服务器中（并修改皮肤文件读写权限及所有者），并在LocalSettings.php中加载皮肤（如'''''wfLoadSkin( 'Vector' );'''''）。
<pre>
## Default skin: you can change the default skin. Use the internal symbolic
## names, ie 'vector', 'monobook', 'timeless':
$wgDefaultSkin = "vector";

# Enabled skins.
# The following skins were automatically enabled:
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Timeless' );
wfLoadSkin( 'Vector' );
</pre>

=== 上传文件设定 ===
LocalSettings中，'''''$wgEnableUploads = true;''''';<br/>
MediaWiki中允许上传文件类型限制配置（默认支持'png','gif', 'jpg', 'jpeg', 'webp'），可参阅DefaultSettings.php中'''''$wgFileExtensions'''''的值，如：
<pre>$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp' ];</pre>
而不允许的文件类型在参数'''''$wgFileBlacklist'''''中设定，如：
<pre>
$wgFileBlacklist = [
	:# HTML may contain cookie-stealing JavaScript and web bugs
	'html', 'htm', 'js', 'jsb', 'mhtml', 'mht', 'xhtml', 'xht',
	# PHP scripts may execute arbitrary code on the server
	'php', 'phtml', 'php3', 'php4', 'php5', 'phps', 'phar',
	# Other types that may be interpreted by some servers
	'shtml', 'jhtml', 'pl', 'py', 'cgi',
	# May contain harmful executables for Windows victims
	'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' ];
</pre>
登录后通过导航栏或特殊页面中的上传文件链接上传文件。用'''''<nowiki>[[File:文件名]]</nowiki>'''''在页面中引用文件，如果引入的是图片文件，还可以指定图片宽度('''''<nowiki>[[File:Example.jpg|200px]]</nowiki>''''')，加入图片说明('''''<nowiki>[[File:Example.jpg|图片1]]</nowiki>''''')，设置方框效果('''''<nowiki>[[File:Filename.jpg|thumb]]</nowiki>''''')。<br/>

=== 修改导航栏 ===
通过wiki地址 ''index.php?title=MediaWiki''（ [http://wiki.eijux.com/index.php?title=MediaWiki:Sidebar MediaWiki:Sidebar] ）,或者在搜索栏中输入“mediawiki:sidebar”，进入页面后点击编辑即可。<br/>

导航栏格式如下：
<pre>
*导航栏名称一
**链接一地址|链接一名称
**链接二地址|链接二名称

*导航栏名称二
**链接一地址|链接一名称
**链接二地址|链接二名称
</pre>

=== 用户组 ===
MediaWiki中有3个用户组：机器人/管理员/行政员，每个用户组的具体权限可通过”特殊页面” -> “用户组权限”查看；<br/>
通过首页中”创建用户”注册的用户默认不属于任何用户组；<br/>
从属于行政员用户组的用户，可通过”特殊页面” -> “用户权限管理”给其他用户分配用户组。
=== 清除页面缓存 ===
DefaultSettings.php中,找到参数'''''$wgCacheEpoch'''''，将参数值置为当前时间，可以取消全部已经缓存的页面(包括客户端和服务器端)。
<pre>
/**
 * Set this to current time to invalidate all prior cached pages. Affects both
 * client-side and server-side caching.
 * You can get the current date on your server by using the command:
 * @verbatim
 *   date +%Y%m%d%H%M%S
 * @endverbatim
 */
$wgCacheEpoch = '20030516000000';
</pre>