查看“安装MW：初始化配置”的源代码

[[category:MediaWiki]]

== 下载 ==
关于新的MediaWiki文件下载：
* 可以在服务器安装git后直接拉取GitHub的相关项目分支[https://github.com/wikimedia/mediawiki GitHub的MediaWiki项目地址]。但是对于服务器链接Github不方便的还是算了。
* 通过下载到各种方式（git、下载release包）到本地，再通过Xftp等工具上传到Server。如果不是服务器不能联网或要替换文件重新打包，则显得多余。
* 通过包的Linux的包管理工具拉取（<code>wget -P /www/wwwroot/ https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.0-rc.3.tar.gz</code>）。

关于获取MediaWiki的站点：
* [https://github.com/wikimedia/mediawiki GitHub:MediaWiki]
* [https://releases.wikimedia.org/mediawiki/ MediaWiki Releases]
* [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-September/000258.html MediaWiki消息站点]：发布时间会早一点。

注意：
# 通过<code>git clone</code>或download code zip的时候，子模块可能不能下载下拉，需要<code>git submodule update</code>或单独去download那些（对应分支）子模块的代码，子模块的信息在<code>.gitmodules</code>文件中。
# 下载或拉取发布包，若为核心包（如：mediawiki-core-1.35.0-rc.3.tar.gz）则包内不包含扩展。

== 更新 ==
 注意：
 
 '''更新'''：小版本的更新（如1.34.0 → 1.34.2），一般直接更新就可以了，不需要对服务器的基础支持相关进行安装或升级。
 '''升级'''：大版本的升级（1.34.2 → 1.35.0），要注意新版本的'''系统需求'''（如：PHP版本、PHP插件等），以及“'''两个 LTS 之间的版本才能之间升级'''”（否则，需要升级到一个LTS，再升级到第二个LTS）。
 
 （更新之前，维护一下“[[站点日志]]”，记录一下新版本的系统需求、特性，养成习惯）

* 系统需求可以通过'''宝塔面板'''完成。
*: 如：PHP 更新、PHP 插件安装（<span style="color: blue">'''fileinfo'''、'''opcache'''、'''memcached'''、'''Intl'''</span>）、删除 PHP 禁用的函数（<span style="color: blue">'''proc_open'''、'''symlink'''、'''putenv'''</span>）等。

=== 文件备份 ===
包括：
# 配置文件：<span style="color: blue">'''LocalSettings.php'''</span>；
#* 如果修改过<span style="color: green">'''数据库配置'''</span>，则需要在配置文件中更新。
# 上传文件夹：<span style="color: blue">'''./images'''</span>；
# 扩展文件夹：<span style="color: blue">'''./extensions'''</span>；
#* 部分扩展可能也需要更新（最好都重新下载更新一遍）。
# 修改过的内容；
#: 如：includes/defaultSettings.php。
# 添加过的内容。
#: 如：<span style="color: blue">'''logo'''</span>（位于“<span style="color: green">'''./resources/assets'''</span>”）、skins[皮肤]、vendor[依赖] 等。

=== 文件替换 ===
步骤：
# 解压安装包：
#:<syntaxhighlight lang="bash" highlight="">
tar -zxvf mediawiki-1.35.0-rc.2.tar.gz

# 或

unzip mediawiki-REL1_35.zip -d /www/wwwroot/
</syntaxhighlight>
#*（把不需要的内容删除）
# 移除旧版本；
#: <syntaxhighlight lang="bash" highlight="">
rm -rf wiki.eijux.com/
</syntaxhighlight>
#*（可以保留需要备份的内容）
# 安装文件替换：
#: <syntaxhighlight lang="bash" highlight="">
# 移动
mv -f mediawiki-1.35.0-rc.2/* wiki.eijux.com/

# 复制
yes|cp -rf mediawiki-REL1_35/* wiki.eijux.com/
</syntaxhighlight>
# 替换备份文件。
# 更新网站文件归属及读写权限：
#: <syntaxhighlight lang="bash" highlight="">
# 文件归属者、组
chown -Rf www:www wiki.eijux.com/*

# 文件权限
chmod -Rf 775 wiki.eijux.com/*
</syntaxhighlight>

=== 执行升级 ===
 文件替换之后，也能直接访问 MediaWiki，但是使用时（涉及查找的操作和页面）可能出现错误：
 
     [[File:MediaWiki：数据错误.png|800px]]

'''步骤：'''
# 访问安装页面：<big>'''[http://wiki.eijux.com/mw-config/index.php http://wiki.eijux.com/mw-config/index.php]'''</big>；
# 依次完成安装过程。
#* 升级密钥：“'''LocalSettings.php'''”中的“<span style="color: blue">'''$wgUpgradeKey'''</span>”）。

== 问题 ==

=== 站点路径的问题： ===
站点目录结构的不同，则配置文件的 <code><span style="color: blue">'''$wgScriptPath'''</span></code> 配置不同，网站的访问路径不同：
* 如果站点目录为 <code>"/www/wwwroot/wiki.eijux.com/wiki"</code>：
*: LocalSettings.PHP的配置为：<code>$wgScriptPath = ""</code>；
*: 网站的访问路径为：<code>http://wiki.eijux.com/index.php?title=%E9%A6%96%E9%A1%B5</code>
* 如果站点目录为 <code>"/www/wwwroot/wiki.eijux.com/wiki"</code>：
*: LocalSettings.PHP的配置为：<code>$wgScriptPath = "/wiki"</code>；
*: 网站的访问路径为：<code>http://wiki.eijux.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5</code>