
类型:Wiki系统
简介:基于PHP和MySQL的自由开源Wiki系统,用于构建像维基百科这样的平台。
MediaWiki的最大作用在于对知识的归档,可用于构建企业/个人知识库。在本教程中,将详细介绍如何在本地环境完成MediaWiki的安装过程,包括下载、解压、上传文件以及配置数据库等步骤。
一、下载MediaWiki软件
1、访问官方下载页面
首先,前往[MediaWiki的官方网站](https://www.mediawiki.org/)下载最新版本的MediaWiki压缩包。
2、选择稳定版本
如果在生产环境中运行MediaWiki,请选择最新的稳定版本,例如MediaWiki最新版本为1.42.1。
二、解压MediaWiki软件
1、文件格式
下载的文件通常是”.zip”或”.tar.gz”格式。
2、解压缩
(1)在Windows系统上,可以使用工具如7-Zip、WinZip、WinRAR或IZArc来解压缩文件;
(2)在Linux和macOS上,可以使用以下命令来解压:
tar -xzvf mediawiki-*.tar.gz
3、文件权限
如果使用的是root/admin权限解压缩文件,可能需要更改文件权限。可以使用以下命令修改权限:
chown -R <new_owner_user> <mediawiki_folder>
三、上传文件到网页服务器
如果尚未将文件上传到网页服务器,请执行以下步骤:
1、上传方式
可以选择以下方式上传文件:
(1)直接复制未解压的文件夹。
(2)使用FTP客户端,如FileZilla(适用于Windows、macOS和Linux)或Cyberduck(适用于Windows和macOS)。
(3)通过使用的网站托管服务软件,例如cPanel文件管理器。
2、文件名设置
确保在上传之前禁用“将文件名更改为小写”选项,以避免出现未知错误。
3、确定目录
如果使用的是Apache HTTPD web服务器,正确的目录由”httpd.conf”文件的”DocumentRoot”指令指定。默认情况下,这一目录可能为”/var/www/”或”<apache-folder>/htdocs”。
4、重新命名文件夹
根据希望在URL中使用的路径重命名上传的文件夹。例如,如果服务器运行在”http://localhost”,且希望以”/w/”作为网站目录,应使用”http://localhost/w/index.php”来访问wiki。
四、配置MediaWiki数据库
MediaWiki会在数据库中存储所需的相关数据,因此安装脚本会要求提供数据库信息。
1、创建数据库
推荐使用MariaDB/MySQL。对于PostgreSQL和SQLite的支持较有限,除非有特殊需求,一般不建议使用。
- 使用控制面板,如PhpMyAdmin;
- 使用SSH登录到主机并输入以下命令:
CREATE DATABASE my_wiki; CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password'; GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
- 如果数据库与Web服务器不在同一台机器上,请将”‘localhost'”替换为相应的Web服务器主机名。
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
2、PostgreSQL配置
如果决定使用PostgreSQL,确保系统中安装了PHP的”pdo-sqlite”模块。填写数据库名称(可以是任何内容)和PostgreSQL数据库目录。确保数据库目录不被公开访问,以防外部访问。使用PostgreSQL请创建数据库和用户,通常是名为”postgres”的超级用户。
Linux命令行中的以下命令,作为postgres用户,创建名为wikiuser的数据库用户,以及名为my_wiki的数据库,其拥有者的名称为wikiuser。
createuser -S -D -R -P -E wikiuser (然后输入数据库密码) createdb -O wikiuser my_wiki
或者作为超级用户(默认postgres)在数据库提示符下执行以下命令:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password'; CREATE DATABASE my_wiki WITH OWNER wikiuser;
五、运行MediaWiki安装脚本
在服务器上下载并解压MediaWiki后,需要运行配置脚本以完成基本设置。
1、在浏览器中运行配置脚本
假设网站地址是”http://www.example.com/”,可以通过访问”http://www.example.com/mw-config/”来启动MediaWiki的配置脚本。如果在本地计算机上进行安装,则使用”http://localhost/mw-config/”。
(1)打开浏览器并输入上述网址,将看到MediaWiki的版本信息以及一个“请先设置wiki”的链接。点击该链接以开始配置脚本。
(2)选择语言和环境检查:选择需要的语言后,配置脚本会自动进行环境检查。
(3)按照页面上的指示输入数据库连接信息,创建MediaWiki管理员账户,并设置如标志和皮肤等选项。
(4)建议为MediaWiki创建一个专用的数据库用户(而非超级用户),因为LocalSettings.php文件会以纯文本形式存储数据库用户的密码。
(5)配置脚本将填充数据库并生成配置文件LocalSettings.php。
(6)下载和放置配置文件:配置脚本完成后,下载生成的LocalSettings.php文件,并将其放置到MediaWiki的安装目录中。
(7)设置LocalSettings.php文件的权限,以确保系统用户可以读写该文件。通常建议的权限设置为”chmod600″和”chown<Web服务器所有者>”(即所有者具有读写权限,其他人无权限)。
现在可以通过输入MediaWiki的安装网址来访问Wiki。
2、命令行替代选项
如果更倾向于使用命令行安装MediaWiki,也可以运行以下命令: php maintenance/install.php
将启动命令行安装程序来完成配置过程。



