ローカル開発クイックスタート

This page is a translated version of the page Local development quickstart and the translation is 100% complete.

このページは、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 では、PHP を APT からインストールし、Composer は getcomposer.org/download からインストールします。

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

Windows Subsystem for Linux を使用して、このページの Linux の指示に従うという選択肢があります。 Windows 上で MediaWiki を直接インストールする場合は、必要なパッケージを Chocolatey を使用してインストールします。

choco install -y php composer

必要な PHP 拡張機能を読み込むには、php.ini ファイルを編集し、以下の行をコメント解除します: php.ini の場所を見つけるには、php --ini を実行し、Loaded Configuration File を探します。

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

MediaWiki をクローンする

MediaWiki のコアリポジトリと既定の外装をクローンするには、Git を使用します。

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 の組み込みウェブサーバーを起動し、ブラウザーで localhost:4000 を開いて、MediaWiki インスタンスを確認します。管理者としてログインするには、利用者名 Admin とパスワード adminpassword を使用します。

composer serve

次のステップ

Take a tour of the MediaWiki codebase – エントリーポイントとトップレベルディレクトリについて学ぶことで、MediaWiki のコアコードを理解してください。
Run unit tests – テストを実行し、テストの記述に関する情報を見つけるために、PHPUnit フレームワークを使用して PHP コードの単体テストおよび統合テストを行うための説明文書を読んでください。
Install extensions – ビジュアルエディターや Echo などの拡張機能を開発環境に追加してします。拡張機能がどのように機能するかを学ぶには、Manual:拡張機能の開発を参照してください。
Debug your code – XDebug を使用して、デバッグ支援ツールを設定し、MediaWiki コードをステップバイステップでデバッグする方法を学んでください。
Submit a patch – 初学者が扱いやすいバグを探索し、パッチを提出するためにウィキメディア Gerrit への SSH アクセスを設定します。