Быстрый старт для локальной разработки

Эта страница представляет собой руководство по быстрому старту в настройке локальной разработки для MediaWiki с использованием PHP и Composer.

Этот рабочий процесс подходит только для локальной разработки. Для обслуживания общедоступного сайта см. Руководство:Требования для установки .

Установка необходимых компонентов

MediaWiki требует наличия PHP 8.2.0+ и Composer 2.

Linux

На Ubuntu 22+ или Debian 12+ установите необходимые пакеты, используя APT.

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

На Fedora 36+ установите необходимые пакеты, используя DNF.

sudo dnf install php composer

На Arch Linux установите необходимые пакеты, используя pacman.

sudo pacman -S php composer

Mac

Установите необходимые пакеты, используя Homebrew, и сделайте эту версию PHP активной, создав соответствующую ссылку.

brew install php@8.2 composer
brew link --overwrite php@8.2

Если следующая команда будет выполнена успешно, она должна показать версию PHP. Если она завершится с ошибкой, то, скорее всего, ваш $PATH не настроен для поиска команд из brew.

php -v

Windows

У вас есть возможность использовать подсистему Windows для Linux (WSL) и следовать инструкциям для Linux на этой странице. Или, чтобы установить MediaWiki непосредственно в Windows, установите необходимые пакеты с помощью 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
extension:sodium

Клонирование 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 занимает несколько минут. Пока вы ждёте, если вы планируете создавать и отправлять патчи, создайте учётную запись разработчика Wikimedia , если у вас её ещё нет.

Установка зависимостей

Находясь внутри вашей директории mediawiki, созданной выше, используйте Composer для установки зависимостей MediaWiki.

composer update

Установка MediaWiki

Установите MediaWiki с использованием встроенной в PHP базы данных SQLite.

composer mw-install:sqlite

Запуск сервера

Запустите встроенный веб-сервер PHP и откройте localhost:4000 в браузере, чтобы увидеть ваш экземпляр MediaWiki. Для входа в систему как администратора используйте имя пользователя Admin и пароль adminpassword.

composer serve

Дальнейшие шаги

• Ознакомьтесь с кодовой базой MediaWiki – Ознакомьтесь с основным кодом MediaWiki, изучив точки входа и каталоги верхнего уровня.
• Запустите модульные тесты – MediaWiki использует фреймворк PHPUnit для модульного и интеграционного тестирования PHP-кода. Прочтите документацию, чтобы запустить тесты и найти информацию об их написании.
• Установите расширения – Добавьте расширения, такие как VisualEditor и Echo , в вашу среду разработки. Смотрите Руководство:Разработка расширений , чтобы узнать о том, как работают расширения.
• Отлаживайте свой код – Узнайте, как настроить средства отладки и пошагово отлаживать код MediaWiki с помощью XDebug.
• Отправьте патч – Изучите Мелкие, но раздражающие ошибки и настройте SSH-доступ к Wikimedia Gerrit, чтобы отправить патч.