本地开发快速入门
本页是使用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 -i，然后查找已加载的配置文件。
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提交补丁。