MediaWiki 开发环境

1. MediaWiki 开发环境

MediaWiki 是一个基于 PHP 的开源 维基软件，被维基百科及众多其他网站使用。对于希望修改、扩展或创建基于 MediaWiki 的维基系统的开发者来说，搭建一个合适的开发环境至关重要。本文旨在为初学者提供一个详尽的 MediaWiki 开发环境搭建指南，涵盖了必要的工具、配置和最佳实践。

为什么需要独立的开发环境？

直接在生产服务器上进行开发是非常危险的。任何错误都可能导致网站宕机或数据损坏。一个独立的开发环境可以：

隔离风险：开发者可以在不影响生产环境的情况下进行实验和测试。
方便调试：开发环境通常更容易配置调试工具，以便快速定位和修复问题。
版本控制：独立的开发环境允许开发者使用 版本控制系统（如 Git）来管理代码更改。
协作开发：多个开发者可以并行工作，而不会相互干扰。

开发环境搭建方法

搭建 MediaWiki 开发环境有多种方法，以下介绍几种常用的：

1. 本地开发环境 (推荐)

这是最常见的开发环境搭建方式，直接在你的电脑上安装必要的软件。

操作系统： Linux, macOS 或 Windows 都可以。建议使用 Linux 或 macOS，因为它们更接近生产环境，并且更方便使用命令行工具。
Web 服务器： Apache 或 Nginx 是常用的 Web 服务器。 Apache 更易于配置，而 Nginx 性能更高。
PHP： MediaWiki 需要 PHP 7.4 或更高版本。确保安装了必要的 PHP 扩展，例如 MySQLi、GD、mbstring 和 curl。
数据库： MySQL 或 MariaDB 是常用的数据库系统。
Composer： PHP 的依赖管理工具，用于安装 MediaWiki 及其扩展。

详细步骤（以 Linux 为例）:

1. 安装 Apache: `sudo apt update && sudo apt install apache2` 2. 安装 MySQL: `sudo apt install mysql-server` (配置 MySQL 用户和密码) 3. 安装 PHP 及必要的扩展: `sudo apt install php libapache2-mod-php php-mysql php-gd php-mbstring php-curl` 4. 安装 Composer: 下载并安装 Composer (https://getcomposer.org/) 5. 下载 MediaWiki: 从 MediaWiki 官网下载最新版本 (https://www.mediawiki.org/wiki/Download) 6. 解压 MediaWiki: `tar -xzf MediaWiki-*.tar.gz` 7. 配置 Web 服务器: 创建一个虚拟主机配置文件，指向 MediaWiki 的目录。 8. 运行 MediaWiki 安装程序: 通过浏览器访问你的虚拟主机，按照安装程序的提示进行配置。

2. 虚拟机 (VirtualBox, VMware)

使用虚拟机可以创建一个与生产环境类似的开发环境，而无需修改你的主机系统。

虚拟机软件： VirtualBox (免费) 或 VMware (商业)
操作系统：选择与生产环境相同的操作系统。
安装步骤：在虚拟机中安装 Web 服务器、PHP、数据库和 Composer，然后按照上述本地开发环境的步骤安装 MediaWiki。

3. Docker

Docker 是一种容器化技术，可以创建一个轻量级、可移植的开发环境。

Docker 镜像：可以在 Docker Hub 上找到现成的 MediaWiki 镜像，或者自定义一个镜像。
Docker Compose：用于定义和运行多容器的 Docker 应用。
安装步骤：创建一个 Docker Compose 文件，配置 MediaWiki 容器、数据库容器和 Web 服务器容器，然后使用 `docker-compose up` 命令启动环境。