Изтегляне, инсталиране и използване на 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

Сега ще преминем през този процес с просто примерно приложение, което ще вземе изречение и ще го направи приятелски низ, наречен плуг. Това се използва често за преобразуване на имена на страници в 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

Трябва да намерим преобразувател от низ към луга, така че 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 приложения.