Захтеви
Инсталација
Употреба
Закључак
Цомпосер је изузетно популаран ПХП алат за управљање зависностима, који се користи да олакша инсталацију и ажурирања за пројекте. Такође проверава који су други пакети потребни пројекту и аутоматски их добија за вас, са исправном верзијом.
У овом документу ћемо инсталирати и почети да користимо Цомпосер на Вултр Убунту 14.04 ВПС.
Захтеви
- Вултр Убунту 14.04 ВПС.
- Обичан корисник са
Sudoприступом том ВПС-у.
Инсталација
Инсталација зависности
Пре свега, морамо да обезбедимо да наш ВПС има све захтеве Цомпосер-а да су успешно инсталирани и да раде.
Ажурирајте листу пакета.
sudo apt-get update
Затим инсталирајте Цомпосер-ове захтеве. Биће вам потребно curlза преузимање, као и php5-cliза инсталацију и коришћење. gitтакође користи Цомпосер за преузимање захтева пројекта.
Инсталирајте захтеве.
sudo apt-get install curl php5-cli git
Преузети и инсталирати
Инсталација Цомпосер-а је веома једноставна.
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=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]
Употреба
ЈСОН фајл
Да бисте користили Цомпосер, потребна вам је датотека која се зове composer.jsonЦомпосер да каже које захтеве има ваш пројекат и коју верзију тих захтева да инсталира. Не креирајте ово ручно да не бисте урадили нешто погрешно - Цомпосер прави датотеку за вас када додате зависности. Додатне зависности се такође аутоматски додају.
Пример употребе композитора
Да бисте користили Цомпосер за инсталације зависности:
- Идентификујте библиотеку потребну за апликацију.
- Пронађите добру библиотеку отвореног кода на <Пацкагист.орг>, складишту Композитора.
- Изаберите пакет који желите.
- Користите
composer requireза укључивање и инсталирање зависности.
Иницијализација Слугит-а
Сада ћемо проћи кроз овај процес са једноставном апликацијом за пример, која ће узети реченицу и учинити је пријатељским низом, који се зове пуж. Ово се често користи за претварање назива страница у УРЛ адресе, како би се олакшало генерисање УРЛ-ова и путања. Почећемо тако што ћемо направити фасциклу за апликацију под називом slugit.
mkdir ~/slugit
cd ~/slugit
Претраживање на Пацкагист-у
Сада ћемо наставити packagist.orgи пронаћи пакет који ће помоћи у генерисању пужева. Претраживање slugна Пацкагист-у би требало да покаже неке од ових пакета.
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
Као што се види у генерисаном резултату, Цомпосер је изабрао најновију верзију пакета и користио је. Проверавањем ~/slugit, требало би да видите 2 датотеке composer.lockи composer.json, плус фасциклу под називом vendor.
composer.lock се користи за чување информација о верзијама пакета и њихово задржавање истим.
vendorИменик се користи да инсталира зависности. Не урезујте ову фасциклу у Гит спремиште или ГитХуб.
Ако пројекат који сте преузели већ садржи composer.json , користите composer installза преузимање његових зависности.
Разумевање ограничења верзије
Ако проверите шта composer.jsonукључује, требало би да видите нешто слично овом блоку.
{
"require": {
"cocur/slugify": "^1.2"
}
}
Цомпосер има много различитих формата и ограничења да би дефинисао верзију пакета, да би омогућио флексибилност у комбинацији са стабилношћу. ^пре него што број верзије учини ту верзију минималном и дозвољава све верзије испод 2.0.
Обично не бисте требали да мењате ограничења верзије, али ако то учините, погледајте Цомпосерову званичну документацију за више информација и упутства о томе како све то функционише.
Скрипта за аутоматско учитавање
Цомпосер обезбеђује скрипту за аутоматско учитавање, што знатно олакшава рад са вашим зависностима и именским просторима.
Само укључите vendor/autoload.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
Закључак
У овом водичу прошли смо кроз инсталацију, конфигурисање и пример коришћења Цомпосер-а за управљање зависношћу ПХП апликације.