Установка и использование Composer на Ubuntu 14.04

Published by Leave your thoughts

Composer – это популярный менеджер зависимостей PHP, который упрощает процесс установки и обновления зависимостей проекта. Composer проверяет, от каких пакетов зависит проект, а затем устанавливает все необходимые версии пакетов в соответствии с требованиями проекта.

Данное руководство поможет установить и начать работу с Composer на сервере Ubuntu 14.04.

Требования

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

Прежде чем приступить к установке Composer, нужно установить все зависимости программы.

Сначала обновите кэш менеджера пакетов:

sudo apt-get update

Теперь установите зависимости Composer. В дальнейшем понадобятся следующие пакеты:

  • curl – для загрузки Composer
  • php5-cli – для установки и запуска Composer
  • git позволяет Composer загружать зависимости проектов.

Все эти пакеты можно установить при помощи команды:

sudo apt-get install curl php5-cli git

2: Загрузка и установка Composer

Для установки Composer нужна всего одна команда:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Эта команда загрузит пакет менеджера Composer и выполнит его глобальную установку в /usr/local/bin, после чего в системе появится общедоступная команда composer. Вывод будет выглядеть так:

#!/usr/bin/env php
All settings correct for using Composer
Downloading...
Composer successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer

Чтобы убедиться в том, то установка прошла успешно, запустите:

composer

На экране должен появиться такой вывод:

  / ____/___  ____ ___  ____  ____  ________  _____
/ /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 1.0-dev (9859859f1082d94e546aa75746867df127aa0d9e) 2015-08-17 14:57:00
Usage:
command [options] [arguments]
Options:
--help (-h)           Display this help message
--quiet (-q)          Do not output any message
--verbose (-v|vv|vvv) Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
--version (-V)        Display this application version
--ansi                Force ANSI output
--no-ansi             Disable ANSI output
--no-interaction (-n) Do not ask any interactive question
--profile             Display timing and memory usage information
--working-dir (-d)    If specified, use the given directory as working directory.
. . .

Это значит, что менеджер зависимостей Composer был успешно установлен.

Также менеджер Composer можно установить индивидуально для каждого отдельного проекта. Локальный вариант установки особенно хорош в том случае, если пользователь не имеет права устанавливать программы общесистемно. Чтобы установить Composer локально, используется команда:

curl -sS https://getcomposer.org/installer | php

Она создаст файл composer.phar в текущем каталоге, который можно запустить при помощи команды:

php composer.phar [command]

3: Файл composer.json

Файл composer.json содержит информацию о зависимостях, которые должен скачать Composer для определённого проекта. Он позволяет задать необходимые версии зависимостей и исключить их нестабильные и потенциально опасные версии.

Этот файл не рекомендуется создавать вручную, поскольку при этом можно допустить ошибку в синтаксисе. Composer автоматически создаст файл composer.json после того, как вы добавите первую зависимость при помощи команды require. Остальные зависимости можно добавить с помощью этой же команды, и при этом нет необходимости вручную редактировать файл.

Процесс установки зависимостей проекта при помощи Composer состоит из следующих этапов:

  • Определение необходимых приложению библиотек.
  • Поиск подходящей открытой библиотеки в Packagist.org, официальном репозитории Composer.
  • Выбор зависимостей.
  • Запуск команды composer require, которая добавляет зависимости в файл composer.json и устанавливает пакеты.

Рассмотрим этот процесс на примере простого приложения.

Цель этого приложения — превратить заданное предложение в «понятный» URL (или slug); как правило, это приложение используется для преобразования названий страниц в URL-адреса (к примеру, обратите внимание на последний сегмент URL-адреса этого урока).

Итак, создайте каталог проекта; для примера назовём его slugify:

cd ~
mkdir slugify
cd slugify

Поиск пакетов на Packagist.org

Теперь попробуйте найти пакет, генерирующий slug-адреса, в репозитории Packagist.org. Просто  введите в поле поиска запрос slug.

Справа возле каждого результата поиска можно увидеть два счётчика. Первый показывает, сколько раз пакет был установлен; второй счётчик показывает, сколько раз пакет был отмечен на GitHub. Результат поиска можно переупорядочить согласно показателю одного из счётчиков. Конечно, пакеты с большим показателем счётчиков, как правило, более стабильны, так как они многими используются. Также важно проверить описание пакета – действительно ли это нужный пакет?

Итак, нужно найти простой конвертёр адресов. В руководстве используется пакет cocur/slugify.

Обратите внимание: Packagist указывает имя вендора и имя пакета (vendor name и package name). Каждому пакету присваивается уникальный идентификатор, или пространство имён (в том же формате, что и для репозиториев Github: vendor/package). Необходимый пакет называется cocur/slugify. Чтобы загрузить пакет автоматически, нужно указать менеджеру зависимостей пространство имён пакета.

Запрос пакета

Итак, теперь точное имя пакета известно. Используйте команду composer require, чтобы добавить этот пакет в файл composer.json:

composer require cocur/slugify
Output
Using version ^1.3 for cocur/slugify
./composer.json has been created
Loading composer repositories with package information
Updating dependencies (including require-dev)
- Installing cocur/slugify (v1.3)
Downloading: 100%
Writing lock file
Generating autoload files

Как видите, Composer автоматически определяет необходимую версию пакета. Проверьте каталог проекта, теперь он содержит два файла (composer.json и composer.lock) и каталог vendor:

ls -l
Output
total 12
-rw-rw-r-- 1 8host 8host   59 Sep  9 16:22 composer.json
-rw-rw-r-- 1 8host 8host 2835 Sep  9 16:22 composer.lock
drwxrwxr-x 4 8host 8host 4096 Sep  9 16:22 vendor

Файл composer.lock используется для хранения данных о версиях установленных пакетов и обеспечивает использование одинаковых версий пакетов в случае клонирования проекта. Каталог vendor содержит зависимости проекта.

Внимание! В случае использования контроля версий не отправляйте сообщения о коммитах каталога vendor; это применимо только для файлов composer.json и composer.lock.

При установке проекта, который уже содержит файл composer.json, используйте следующую команду, чтобы установить зависимости проекта:

composer install

Ограничения версий

Файл composer.json содержит примерно такой код:

cat composer.json
{
"require": {
"cocur/slugify": "^1.3"
}
}

Обратите внимание на знак вставки (^) перед номером версии. Для определения версии пакета Composer может использовать несколько типов ограничений и форматов; эта функция позволяет следить за стабильностью проекта. Оператор ^ используется в файле composer.json для максимальной совместимости версий. В данном случае он определяет версию 1.3 как минимальную и разрешает обновления до версии 2.0.

В целом, вам не придётся особенно долго возиться с ограничениями версий в файле composer.json. Однако в некоторых ситуациях может потребоваться отредактировать ограничения вручную (например, если вышла новая версия библиотеки, но composer.json не разрешает обновиться до неё).

Эта таблица поможет разобраться в том, как работают ограничения версий Composer:

Ограничение   Значение           Некоторые допустимые версии

^1.0       >= 1.0 < 2.0        1.0, 1.2.3, 1.9.9
^1.1.0   >= 1.1.0 < 2.0     1.1.0, 1.5.6, 1.9.9
~1.0       >= 1.0 < 2.0.0     1.0, 1.4.1, 1.9.9
~1.0.0   >= 1.0.0 < 1.1     1.0.0, 1.0.4, 1.0.9
1.2.1      1.2.1      1.2.1
1.*         >= 1.0 < 2.0        1.0.0, 1.4.5, 1.9.9
1.2.*      >= 1.2 < 1.3        1.2.0, 1.2.3, 1.2.9

Примечание: Подробнее об ограничениях версий можно прочесть в документации программы.

4: Скрипт autoload

Также Composer использует скрипт autoload, который можно добавить в проект для поддержки автозагрузки. Он упрощает работу с зависимостями и определяет собственные пространства имен.

Нужно просто добавить файл vendor/autoload.php в скрипты PHP перед установкой класса.

Давайте вернёмся к тестовому приложению slugify. Создайте скрипт test.php и задайте в нём библиотеку cocur/slugify:

vim test.php
<?php
require __DIR__ . '/vendor/autoload.php';
use Cocur\Slugify\Slugify;
$slugify = new Slugify();
echo $slugify->slugify('Hello World, this is a long sentence and I need to make a slug from it!');
Запустите скрипт в командной строке:
php test.php
Он вернёт результат:
hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it

5: Обновление зависимостей проекта

Чтобы обновить зависимости проекта, используйте команду:

composer update

Эта команда проверит наличие новых версий пакетов. В случае обнаружении более новой версии, которая разрешена ограничениями версий, менеджер зависимостей установит её вместо устаревшей версии данного пакета. Все изменения будут внесены в composer.lock.

Можно также обновить несколько определённых библиотек одновременно:

composer update vendor/package vendor2/package2

Заключение

Composer – очень мощный инструмент, необходимый каждому разработчику PHP.

Этот менеджер зависимостей не только упрощает процесс управления зависимостями проекта, но и устанавливает новый уровень совместного использования пакетов PHP, разработанных сообществом.

Tags: , ,

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *


*

Можно использовать следующие HTML-теги и атрибуты: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>