Files
php-doc-ru/install/composer.xml
2024-11-27 08:28:58 +03:00

52 lines
3.3 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3678a6db126048bf052180c85577daab044759aa Maintainer: malferov Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="install.composer" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="chunk:false">
<title>Установка пакетного менеджера Composer и сторонних пакетов</title>
<sect1 xml:id="install.composer.intro">
<title>Знакомство с пакетным менеджером Composer</title>
<simpara>
&link.composer; — пакетный менеджер, который управляет зависимостями
одних программных компонентов PHP-приложения от других.
Composer помогает определять, а затем устанавливать и обновлять
сторонние пакеты кода для проекта. Менеджер поддерживает встроенный
<link linkend="language.oop5.autoload">механизм автозагрузки PHP-классов</link>,
управляет репозиториями наподобие <link xlink:href="&url.packagist;">Packagist</link>,
в которых хранятся PHP-пакеты, придерживается единообразной структуры проекта
и соглашения о кодировании.
</simpara>
<simpara>
Примером работы с пакетным менеджером Composer могло бы быть PHP-приложение или сайт,
которому потребовались уникальные идентификаторы <abbrev>UUID</abbrev>,
тогда разработчик мог бы определить и установить через менеджер зависимостей пакет Бена Рэмси (Ben Ramsey) —
<link xlink:href="&url.packagist.package;ramsey/uuid"><literal>ramsey/uuid</literal></link>,
который генерирует разнотипные UUID-идентификаторы
по стандарту <link xlink:href="&url.rfc;4122">RFC 4122</link> и умеет работать с такими идентификаторами.
</simpara>
<simpara>
Вкратце, для установки пакета в проекте создают файл
<literal>composer.json</literal>, затем через пакетный менеджер Composer устанавливают
последнюю версию пакета и включают в проект скрипт автозагрузки классов, который входит в Composer,
чтобы сделать пакет доступным для кода. Подробнее о работе с менеджером зависимостей Composer
рассказывает документация на сайте менеджера
в главе <link xlink:href="&url.composer;doc/01-basic-usage.md">Basic Usage</link>.
</simpara>
<example>
<title>
Пример файла <literal>composer.json</literal>, который запрашивает один пакет
</title>
<programlisting role="javascript">
<![CDATA[
{
"require": {
"ramsey/uuid": "^4.7"
}
}
]]>
</programlisting>
</example>
</sect1>
</chapter>