Zahtjevi
Montaža
Korištenje
Zaključak
Composer je iznimno popularan PHP alat za upravljanje ovisnostima, koji se koristi za olakšavanje instalacije i ažuriranja za projekte. Također provjerava koji su drugi paketi potrebni projektu i automatski ih dobiva za vas, s ispravnom verzijom.
U ovom dokumentu ćemo instalirati i početi koristiti Composer na Vultr Ubuntu 14.04 VPS.
Zahtjevi
- Vultr Ubuntu 14.04 VPS.
- Redovni korisnik s
Sudopristupom tom VPS-u.
Montaža
Instalacija ovisnosti
Prije svega, moramo osigurati da naš VPS ima sve zahtjeve Composer-a uspješno instalirane i funkcionalne.
Ažurirajte popis paketa.
sudo apt-get update
Zatim zapravo instalirajte Composerove zahtjeve. Trebat će vam curlza preuzimanje te php5-cliza instalaciju i korištenje. gittakođer ga koristi Composer za preuzimanja zahtjeva projekta.
Instalirajte zahtjeve.
sudo apt-get install curl php5-cli git
Preuzmite i instalirajte
Instalacija Composer je vrlo jednostavna.
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
To preuzima i instalira Composer kao globalnu naredbu pod nazivom composer, koja se nalazi u /usr/local/bin. Dobit ćete ovaj izlaz.
#!/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
Pokrenite sljedeće da testirate instalaciju.
composer
Izlaz će biti sljedeći.
______
/ ____/___ ____ ___ ____ ____ ________ _____
/ / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 1.0-dev (9859859f1082d94e546aa75746867df127aa0d9e) 2015-08-17 14:57:00
Usage:
command [options] [arguments]
Korištenje
JSON datoteka
Da biste koristili Composer, potrebna vam je datoteka composer.jsonkoja će Composeru reći koje zahtjeve ima vaš projekt i koju verziju tih zahtjeva instalirati. Nemojte ovo stvarati ručno kako biste izbjegli da nešto učinite pogrešno - Composer napravi datoteku umjesto vas kada dodate ovisnosti. Dodatne ovisnosti također se dodaju automatski.
Primjer upotrebe skladatelja
Da biste koristili Composer za instalacije ovisnosti:
- Odredite knjižnicu potrebnu za aplikaciju.
- Pronađite dobru knjižnicu otvorenog koda na <Packagist.org>, skladištu skladatelja.
- Odaberite paket koji želite.
- Koristite
composer requireza uključivanje i instalaciju ovisnosti.
Inicijalizacija Slugita
Sada ćemo proći kroz ovaj proces s jednostavnim primjerom aplikacije, koja će uzeti rečenicu i učiniti je prijateljskim nizom, koji se zove puž. Ovo se često koristi za pretvaranje naziva stranica u URL-ove kako bi se olakšalo generiranje URL-ova i puteva. Započet ćemo s izradom mape za aplikaciju pod nazivom slugit.
mkdir ~/slugit
cd ~/slugit
Pretraživanje na Packagistu
Sada ćemo nastaviti packagist.orgi pronaći paket koji će nam pomoći u stvaranju puževa. Pretraživanje slugna Packagistu bi trebalo pokazati neke od ovih paketa.
easy-slug/easy-slug, muffin/slug, ddd/slug, zelenin/slug, webcastle/slug, anomaly/slug-field_type
Moramo pronaći pretvarač niza u puževe, tako da cocur/slugifyizgleda dobro, s mnogo instalacija i zvijezda.
Potreban je paket
Nakon što odaberemo paket, pokrećemo ga composer requireda ga uključimo kao ovisnost, generiramo composer.jsoni instaliramo.
composer require cocur/slugify
Kao što se vidi u generiranom rezultatu, Composer je odabrao najnoviju verziju paketa i upotrijebio je. Provjerom ~/slugit, trebali biste vidjeti 2 datoteke composer.locki composer.json, plus mapu pod nazivom vendor.
composer.lock koristi se za pohranjivanje informacija o verzijama paketa i njihovo zadržavanje istim.
vendorMapa se koristi za instaliranje ovisnosti. Ne urezujte ovu mapu u Git repozitorij ili GitHub.
Ako projekt koji ste preuzeli već sadrži composer.json , koristite composer installza preuzimanje njegovih ovisnosti.
Razumijevanje ograničenja verzije
Ako provjerite što composer.jsonuključuje, trebali biste vidjeti nešto slično ovom bloku.
{
"require": {
"cocur/slugify": "^1.2"
}
}
Composer ima mnogo različitih formata i ograničenja kako bi definirao verziju paketa, kako bi omogućio fleksibilnost u kombinaciji sa stabilnošću. ^prije nego što broj verzije učini tu verziju minimalnom i dopušta sve donje verzije 2.0.
Obično ne biste trebali mijenjati ograničenja verzije, ali ako to učinite, provjerite Composerovu službenu dokumentaciju za više informacija i smjernice o tome kako sve funkcionira.
Skripta za automatsko učitavanje
Composer nudi skriptu za automatsko učitavanje, što znatno olakšava rad s vašim ovisnostima i imenskim prostorima.
Samo uključite vendor/autoload.phpu svoj PHP prije bilo kakve instancije klase.
Vratimo se našem slugitprimjeru. Napravimo testnu skriptu, nazvanu example.php, koristeći cocur/slugify.
vim example.php
Stavite sljedeće u 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!');
Pokrenite skriptu.
php example.php
Izdat će sljedeći tekst:
hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it
Ažuriranje ovisnosti projekta
Za ažuriranje ovisnosti projekta.
composer update
Ako se pronađu ažuriranja i kompatibilna su s ograničenjem navedenim u composer.json, zamijenit će prethodnu verziju i ažurirati composer.lock.
Za ažuriranje jedne ili više određenih knjižnica.
composer update vendor1/package1 vendor2/package2
Zaključak
U ovom vodiču prošli smo kroz instalaciju, konfiguriranje i primjer korištenja Composer za upravljanje ovisnostima PHP aplikacija.