Composer

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Composer and the translation is 85% complete.

Outdated translations are marked like this.
Other languages:
English • ‎español • ‎magyar • ‎português • ‎русский • ‎中文 • ‎日本語

Composer — это менеджер зависимостей для библиотек PHP. Кроме того, он может быть использован для управления установкой расширений mediawiki (доступно начиная с MediaWiki 1.22 ). Начиная с MediaWiki 1.25 , зависимости внешних библиотек MediaWiki управляются с помощью Composer.

Установка Composer

On Unix/Linux and macOS

Существует несколько способов install Composer:

Чтобы получить последний снимок:

wget https://getcomposer.org/composer.phar

Который загружает снимок текущего Мастер и истекает через 30 дней. Есть также фраза для альфа "выпусков", такие как 1.0.0-alpha.

Пользователи OS X могут использовать Homebrew, чтобы установить composer:

brew install composer

Если это не сработает, или у Вас не установлен Homebrew, Вы можете попробовать:

php -r "readfile('https://getcomposer.org/installer');" | php

Дженкинс и распространяемые расширения используют копию Композитора которая находится в "integration/composer" git репозитории.

Когда Композитор установлен, Вы сможете запустить команды через удалённую загрузку:

php composer.phar someCommand

Вы можете переместить далеко в свой путь, поэтому он может быть использован как обычный исполняемый файл:

mv composer.phar /usr/local/bin/composer
composer someCommand

Если в "mv" команда не выполняется из-за разрешения, выполнить его снова с "sudo".

On Windows

Just download and run the installer from the download page. If you prefer manual installation, you can follow the above steps except that Windows doesn’t have wget (or APT or Homebrew) by default, and there is no /usr/local/bin directory.

Использование в Медиавики

Медиавики 1.25+ зависит от некоторых внешних библиотек, которые управляются с помощью Composer. Composer создаёт автозагрузчик на vendor/autoload.php, который включен в WebStart.php.

Composer управляет зависимостями, сгруппированными в архив дистрибутива MediaWiki и расширений, так что системным администраторам не нужно непосредственно использовать composer. В случае установки MediaWiki с помощью git, зависимости, объявленные в $IP/composer.json может быть установлен локально, запустив composer update --no-dev или mediawiki/vendor.git репозиторий может быть скопирован, чтобы получить такие же библиотеки, какие используются на сайтах Wikimedia.[1]


Использование composer-merge-plugin

Медиавики "владеет" $IP/composer.json и изменит содержимое этого файла в архиве TAR и Git управляемого обновления. Для того, чтобы разрешить при локальной установке использовать Composer для загрузки дополнительных библиотек и/или управлять расширениями с Composer, был разработан специальный плагин для Composer, названный composer-merge-plugin.[2] Этот плагин и Медиавики конфигураиция composer.json позволяет локальному развертыванию, чтобы внести необходимые дополнения и библиотеки к файлу composer.local.json внутри Медиавики корневой каталог.

composer.local.json can also be used to install Composer managed libraries that are needed by extensions that are not installed using Composer themselves. Это необходимо, только если расширения "'не"' установить из TAR-файлов, генерируемых Extension Distributor.

Чтобы включить Composer для обнаружения и обработки composer.json-файлов, которые могут быть включены в любые ваши локально установленные расширения, добавьте что-то вроде этого в $IP/composer.local.json:

{
    "extra": {
        "merge-plugin": {
            "include": [
                "extensions/*/composer.json",
                "skins/*/composer.json"
            ]
        }
    }
}

Ресурсы

Wikipedia-logo.png Wikipedia: Composer (software)

Примечания