手册:安装 MediaWiki
MediaWiki 可以通过内置的 Web 安装脚本完成安装。 参阅安装要求 和 快速安装指南 获得准备环境来运行安装脚本的详细信息 .
如果没有 Apache, PHP 和 MySQL/MariaDB 的使用经验的话,安装 MediaWiki 可能会很吃力。 因此更多的用户可能会考虑使用 MediaWiki 托管服务 或者 预先配置的软件包.
下载 MediaWiki 软件
网页浏览器
从 official download page下载MediaWiki tar文件 Generally, if you're using a production environment, you want to be running the latest stable release, which is mediawiki-1.38.1.tar.gz.
Command line (*nix machine)
在 *nix 系统上下载 MediaWiki 当前的稳定版本 1.38.1, 可以通过以下命令完成:
wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.1.tar.gz
或者使用 cURL:
curl -O https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.1.tar.gz
下载的文件是 .tar.gz
格式,所以在使用前需要先从压缩文件中提取。
可以在本地提取并上传到服务器,或者上传压缩包然后在服务器上提取,或者直接在服务器上下载并提取.
在Windows上,这通常由7-Zip(免费)、WinZip、WinRAR或IZArc(免费)来完成。
Linux 和 macOS 系统上可以通过这个命令来提取:
tar -xf mediawiki-*.tar.gz
chown
命令来修改文件的所有者,否则那些文件的所有者会是默认的 #1000。
开发者
为了即时跟踪最近的更改,开发者们请通过 Git 下载来建立本地存储库。
同时需要通过Composer 安装必要的依赖。
上传文件到你的服务器
如果尚未将文件上载到Web服务器,请立即执行此操作。
通过以下方式将文件上传到Web服务器的Web目录:
- 直接复制解压的文件夹或
- 使用FTP客户端,如FileZilla(开源软件、Windows、OSX和Linux)或Cyberduck(OSX)。
- by using cPanel File Manager (see below)
如果您的上传工具有“将文件名更改为小写”选项,则必须禁用此选项。
如果您安装了Apache,则会在httpd.conf
文件中指定正确的目录(它是DocumentRoot指令,通常是/var/www/
或<apache-folder>/htdocs
)。
注意:这在Ubuntu 14.04 与Apache 2.4.7的中发生了变化,其中Apache服务器设置和目录的主要配置文件是/etc/apache2/apache2.conf
。
如果您使用的是Linux或Unix服务器,则可以将文件复制到服务器上的任何目录,然后从Web服务器的Web目录中为该文件夹创建管道连接。
将上传的文件夹重命名为您希望在URL中拥有的任何内容。
如果您的Web服务器以http://localhost
运行,例如,重命名为/w/
目录意味着你将在http://localhost/w/index.php
访问你的wiki。
如果您希望将其用作缩短URL的话,不要使用/wiki/
。
(并且在运行安装脚本之前不要设置短URL。)
index.php
时,Linux服务器可能会显示“500 Internal server Error”。 这可能是一个权限错误,可以通过在将目录更改为“w”后在SSH中运行以下命令来更改文件和目录权限时解决:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
此(重命名)文件夹现在将被称为<MediaWiki-folder>
。
cPanel File Manager
cPanel is a popular interface used by many web hosts. This method is efficient because the files are uncompressed on the server itself.
- Navigate to the directory where you want your wiki folder.
- Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
- Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
- Confirm that the mediawiki-1.xx.x folder is present.
- Delete the tar.gz file.
- Rename the mediawiki-1.xx.x folder to w.
创建数据库
如果您已有数据库服务器并且知道它的root密码,则MediaWiki安装脚本可以为您创建新数据库。 如果是这种情况,您可以跳到下面的运行安装脚本部分。 如果您不知道root密码,例如,如果您在托管服务器上,则必须立即创建新数据库。 目前,您必须使用SQLite、MariaDB、MySQL或PostgreSQL来存储Wiki的实际内容。 If you're unsure which database to choose, use MariaDB as it is the one best supported by MediaWiki.
SQLite
SQLite是一个独立的数据库库,它将数据库内容存储在一个文件中。
如果 PHP 中启用了pdo-sqlite
模块,那么没有什么其他步骤需要做的。
在安装页面上,您需要选择数据库名称(可以是任何内容)和SQLite数据库目录。 对于数据库目录,安装程序将尝试使用文档根目录之外的子目录,并在需要时创建它。 如果此目录不安全(例如Web可读),请手动更改它以避免Web上的每个人都可以访问它。
MariaDB/MySQL
MediaWiki将询问您是否有数据库和用户名,如果它们尚不存在,将尝试创建它们。 如果从MediaWiki这样做是不可能的,你可以使用各种控制面板,如PhpMyAdmin,这些控制面板通常可以从共享主机获得,或者你可以使用SSH登录到您的主机并在MySQL提示符下键入命令。 请参阅相应的文档。 或者,与您的主机提供商联系,让他们为您创建一个帐户。
CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
如果您的数据库未在与Web服务器相同的服务器上运行,则需要提供相应的Web服务器主机名,以下示例中的mediawiki.example.com,如下:
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
PostgreSQL
如果您使用的是PostgreSQL,则需要为您创建数据库和用户,或者只是为配置表单提供具有“超级用户”权限的PostgreSQL用户的名称。 通常,这是名为postgres的数据库用户。
这是完成大部分设置的一种方法。 这用于类Unix系统。 在这个例子中,我们将创建一个名为wikidb的数据库,由名为wikiuser的用户拥有。 从命令行,作为postgres用户,执行以下步骤。
createuser -S -D -R -P -E wikiuser (然后输入密码) createdb -O wikiuser wikidb
或者作为超级用户(默认postgres)在数据库提示符下执行以下命令:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;
注意使用PostgreSQL运行MediaWiki时已知问题的列表。
启动安装脚本
完成上述所有步骤后,您可以通过浏览器中的index.php通过Web浏览器完成安装:查看手册:初始配置 中提到的说明。
安装工具将提示您下载LocalSettings.php文件,并将其另存为LocalSettings.php-path。
或者,您可以运行命令行安装程序或CLI:php maintenance/install.php
添加适当的配置参数。
Further steps
These are optional but make your site look so much better.
保持最新!
安装后,请确保您及时了解版本,并确保您的服务器安全!
安装助理
- 阅读有关安装和配置的常见问题。
- 与MediaWiki开发人员、系统管理员和用户聊天:#mediawiki connect
- mediawiki-l邮件列表是要求支持的高流量列表。
参见
- 手册:页面自定义 - 列出MediaWiki消息链接到的Wiki页面,您需要创建这些页面或编辑消息。
- 手冊:組態MediaWiki - 用于链接到更高级的配置。
- 手册:短链接 - 用于具有更多用户友好的URL到文章页面。
- 手册:Wiki农场 - 使用单组MediaWiki文件设置MediaWiki的多个实例。
- Help:模板
- 手册:备份一个维基
- Manual:Moving a wiki
- Manual:Restoring a wiki from backup
- 手冊:更新