本地开发快速入门

本页是使用PHP和Composer为MediaWiki设置本地开发的快速入门指南。

此工作流仅适用于本地开发。 要为公共网站提供服务，请参阅Manual:安装要求 。

安装前置条件

MediaWiki需要PHP 7.4.3+和Composer 2。

Linux

在Ubuntu 22+或Debian 11+上，使用APT。

sudo apt install -y php php-intl php-mbstring php-xml php-apcu php-curl php-sqlite3 composer

在Ubuntu 20上，从APT安装PHP，但需要从getcomposer.org/download安装Composer。

sudo apt install -y php php-intl php-mbstring php-xml php-apcu php-curl php-sqlite3

在Fedora 35+上，使用DNF。

sudo dnf install -y php composer

在Arch Linux上，使用pacman安装所需的软件包。

sudo pacman -S php composer --noconfirm

Mac

使用Homebrew安装所需的软件包。

brew install php composer

Windows

您可以选择使用适用于Linux的Windows子系统并按照本页的Linux说明进行操作。 或者，要直接在Windows上安装MediaWiki，请使用Chocolatey安装所需的软件包。

choco install -y php composer

要加载所需的PHP扩展，请编辑您的php.ini文件，并取消注释以下行。 若要查找php.ini的位置，请运行php --ini，然后查找已加载的配置文件。

extension:fileinfo
extension:intl
extension:pdo_sqlite
extension:zip

克隆MediaWiki

使用Git克隆MediaWiki核心存储库和默认皮肤。

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki 
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git mediawiki/skins/Vector
cd mediawiki

克隆MediaWiki需要几分钟时间。 在您等待期间，创建一个维基媒体开发者帐户 （如果您还没有）。

安装依赖

在MediaWiki的根目录中，使用Composer安装MediaWiki的依赖项。

composer update

安装MediaWiki

使用PHP内置的SQLite数据库安装MediaWiki。

composer mw-install:sqlite

启动服务器

启动PHP的内置Web服务器，并在浏览器中打开localhost:4000以查看您的MediaWiki实例。 要以管理员 身份登录，请使用用户名Admin和密码adminpassword。

composer serve

下一步

• Take a tour of the MediaWiki codebase – 通过了解入口点和顶级目录来熟悉MediaWiki的核心代码。
• Run unit tests – MediaWiki使用PHPUnit框架对PHP代码进行单元和集成测试。阅读文档以运行测试并查找有关编写测试的信息。
• Install extensions – 添加扩展，例如可视化编辑器 和Echo ，到您的开发环境中。 请参阅Manual:开发扩展 了解扩展的工作原理。
• Debug your code – 了解如何使用XDebug配置调试辅助工具，并逐步调试MediaWiki代码。
• Submit a patch – 探索合適的首次Bug 和配置SSH访问权限 到维基媒体Gerrit提交补丁。