Завантаження, встановлення та використання Composer в Ubuntu 14.04

Composer — надзвичайно популярний інструмент керування залежностями PHP, який використовується для спрощення встановлення та оновлення проектів. Він також перевіряє, які ще пакети потрібні проекту, і автоматично отримує їх для вас із правильною версією.

У цьому документі ми встановимо та почнемо використовувати Composer на Vultr Ubuntu 14.04 VPS.

Вимоги

• Vultr Ubuntu 14.04 VPS.
• Звичайний користувач з Sudoдоступом до цього VPS.

Установка

Установка залежностей

Перш за все, ми повинні переконатися, що наш VPS успішно встановлені та працюють усі вимоги Composer.

Оновити список пакетів.

sudo apt-get update

Далі фактично встановіть вимоги Composer. Вам знадобиться curlдля завантаження, а також php5-cliдля встановлення та використання. gitтакож використовується Composer для завантаження вимог проекту.

Встановіть вимоги.

sudo apt-get install curl php5-cli git

Завантажте та встановіть

Встановити Composer дуже просто.

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

Це завантажує та встановлює Composer як глобальну команду під назвою composer, розташовану в /usr/local/bin. Ви отримаєте цей вихід.

#!/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]

Використання

файл JSON

Щоб використовувати Composer, вам потрібен файл, який викликається, composer.jsonщоб повідомити Composer, які вимоги має ваш проект і яку версію цих вимог встановити. Не створюйте це вручну, щоб не робити щось неправильно - Composer створює файл за вас, коли ви додаєте залежності. Додаткові залежності також додаються автоматично.

Приклад використання Composer

Щоб використовувати Composer для встановлення залежностей:

• Визначте бібліотеку, необхідну для програми.
• Знайдіть хорошу бібліотеку з відкритим вихідним кодом на <Packagist.org>, репозиторії Composer.
• Виберіть потрібний пакет.
• Використовуйте composer requireдля включення та встановлення залежності.

Ініціалізація Slugit

Тепер ми розглянемо цей процес за допомогою простого прикладу програми, яка візьме речення і зробить його дружнім рядком, який називається slug. Це часто використовується для перетворення назв сторінок у URL-адреси, щоб полегшити створення URL-адрес і шляхів. Ми почнемо з створення папки для програми під назвою slugit.

mkdir ~/slugit
cd ~/slugit

Пошук на Packagist

Тепер ми підемо packagist.orgі знайдемо пакет, який допоможе генерувати слимаків. Пошук slugна Packagist повинен показати деякі з цих пакетів.

easy-slug/easy-slug, muffin/slug, ddd/slug, zelenin/slug, webcastle/slug, anomaly/slug-field_type

Нам потрібно знайти конвертер з рядка в slug, щоб він cocur/slugifyвиглядав добре, з багатьма установками та зірочками.

Потрібен пакет

Після вибору пакета ми запускаємо, composer requireщоб включити його як залежність, генеруємо composer.jsonта встановлюємо його.

composer require cocur/slugify

Як видно зі згенерованого результату, Composer вибрав останню версію пакета та використав її. Перевірте ~/slugit, ви повинні побачити 2 файли composer.lockта composer.json, а також папку з іменем vendor.

composer.lock використовується для зберігання інформації про версії пакетів і збереження їх незмінними.

vendorПапка використовується для установки залежностей. Не фіксуйте цю папку в репозиторії Git або GitHub.

Якщо проект, який ви завантажили, уже містить composer.json , використовуйте composer installдля завантаження його залежностей.

Розуміння обмежень версії

Якщо ви перевірте, що composer.jsonвключає, ви побачите щось схоже на цей блок.

{
    "require": {
        "cocur/slugify": "^1.2"
    }
}

Composer має багато різних форматів і обмежень, щоб визначити версію пакета, щоб забезпечити гнучкість у поєднанні зі стабільністю. ^перед тим, як номер версії зробить цю версію мінімальною та дозволить усі версії нижче 2.0.

Зазвичай вам не потрібно змінювати обмеження версії, але якщо ви це зробите, перегляньте офіційну документацію Composer для отримання додаткової інформації та вказівок щодо того, як це все працює.

Скрипт автозавантаження

Composer надає сценарій автозавантаження, який значно полегшує роботу з вашими залежностями та просторами імен.

Просто включіть vendor/autoload.phpу свій PHP перед будь-яким екземпляром класу.

Повернемося до нашого slugitприкладу. Давайте створимо тестовий сценарій під назвою example.php, використовуючи cocur/slugify.

vim example.php

Помістіть наступне в example.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 example.php

Він виведе такий текст:

hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it

Оновлення залежностей проекту

Щоб оновити залежності проекту.

composer update

Якщо оновлення будуть знайдені та сумісні з обмеженням, наведеним у composer.json, воно замінить попередню версію та оновить composer.lock.

Щоб оновити одну або кілька певних бібліотек.

composer update vendor1/package1 vendor2/package2

Висновок

У цьому підручнику ми розглянули встановлення, налаштування та приклад використання Composer для керування залежностями додатків PHP.