安装MW:安装与更新

来自Wikioe
Eijux讨论 | 贡献2020年9月7日 (一) 01:31的版本 (建立内容为“category:MediaWiki == 安装 == 安装需求:LAMP/LNMP(Windows等服务器亦可;本服务器采用LNMP,安装及注意与Wordpress类似),PHP7.2…”的新页面)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航 跳到搜索


安装

安装需求:LAMP/LNMP(Windows等服务器亦可;本服务器采用LNMP,安装及注意与Wordpress类似),PHP7.2.9及以上(含有Perl兼容正则表达式、含有标准PHP库、含有JSON支持)、MySQL5.5.8及以上(/MariaDB/PostgreSQL9.2+/SQLite 3.8+)。

与PHP 7.4.0至7.4.2不兼容!Oracle与Microsoft SQL Server不再被支持!


步骤:

步骤 截图
  1. 欢迎使用
  2. 语言
  3. 设置数据库
  4. wiki名称
  5. 配置选项
  6. 确认安装
  7. 安装完成
  8. 下载LocalSettings.php并上传到服务器MediaWiki根目录
  9. 修改服务器LocalSettings.php文件属性
  10. 完成安装成功访问

配置

MediaWiki的配置文件有两处:

  1. /www/wwwroot/xxx.com/includes/DefaultSettings.php : 系统默认的配置文件;
  2. /www/wwwroot/xxx.com/LocalSettings.php : 用户设置的配置文件;

主要在LocalSettings.php中进行设置和覆盖相应配置,对DefaultSettings.php只是做较少的修改

LocalSettings.php中,$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png"
更改logo的方法有两种,

  1. 替换“./resources/assets/wiki.png”为同名图片(不建议,因为更新系统时会覆盖该默认图片);
  2. 另行制定其他路径下的自定义图片,如“$wgLogo = "$wgResourceBasePath/images/logo.jpg"”。
## 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";

去除底部的power by图标

LocalSettings.php中,加入 unset($wgFooterIcons['poweredby']);

修改皮肤

LocalSettings.php中,$wgDefaultSkin = "vector";
MediaWiki的皮肤位于“./skins”中,可在网络下载并上传至服务器中(并修改皮肤文件读写权限及所有者),并在LocalSettings.php中加载皮肤(如wfLoadSkin( 'Vector' );)。

## 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' );

上传文件设定

LocalSettings中,$wgEnableUploads = true;;
MediaWiki中允许上传文件类型限制配置(默认支持'png','gif', 'jpg', 'jpeg', 'webp'),可参阅DefaultSettings.php中$wgFileExtensions的值,如:

$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp' ];

而不允许的文件类型在参数$wgFileBlacklist中设定,如:

$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' ];

登录后通过导航栏或特殊页面中的上传文件链接上传文件。用[[File:文件名]]在页面中引用文件,如果引入的是图片文件,还可以指定图片宽度([[File:Example.jpg|200px]]),加入图片说明([[File:Example.jpg|图片1]]),设置方框效果([[File:Filename.jpg|thumb]])。

修改导航栏

通过wiki地址 index.php?title=MediaWikiMediaWiki:Sidebar ),或者在搜索栏中输入“mediawiki:sidebar”,进入页面后点击编辑即可。

导航栏格式如下:

*导航栏名称一
**链接一地址|链接一名称
**链接二地址|链接二名称

*导航栏名称二
**链接一地址|链接一名称
**链接二地址|链接二名称

用户组

MediaWiki中有3个用户组:机器人/管理员/行政员,每个用户组的具体权限可通过”特殊页面” -> “用户组权限”查看;
通过首页中”创建用户”注册的用户默认不属于任何用户组;
从属于行政员用户组的用户,可通过”特殊页面” -> “用户权限管理”给其他用户分配用户组。

清除页面缓存

DefaultSettings.php中,找到参数$wgCacheEpoch,将参数值置为当前时间,可以取消全部已经缓存的页面(包括客户端和服务器端)。

/**
 * 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';