Prenos, namestitev in uporaba Composerja v Ubuntu 14.04

Composer je izjemno priljubljeno orodje za upravljanje PHP za odvisnosti, ki se uporablja za lažjo namestitev in posodobitve za projekte. Prav tako preveri, katere druge pakete potrebuje projekt, in jih samodejno pridobi namesto vas s pravilno različico.

V tem dokumentu bomo namestili in začeli uporabljati Composer na Vultr Ubuntu 14.04 VPS.

Zahteve

• Vultr Ubuntu 14.04 VPS.
• Navadni uporabnik z Sudodostopom do tega VPS.

Namestitev

Namestitev odvisnosti

Najprej moramo zagotoviti, da ima naš VPS vse Composerjeve zahteve uspešno nameščene in deluje.

Posodobite seznam paketov.

sudo apt-get update

Nato dejansko namestite Composerjeve zahteve. Potrebovali boste curlza prenos ter php5-cliza namestitev in uporabo. gitComposer uporablja tudi za prenose projektnih zahtev.

Namestite zahteve.

sudo apt-get install curl php5-cli git

Prenesite in namestite

Namestitev Composerja je zelo preprosta.

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

To prenese in namesti Composer kot globalni ukaz, imenovan composer, ki se nahaja v /usr/local/bin. Dobili boste ta izhod.

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

Zaženite naslednje, da preizkusite namestitev.

composer

Izhod bo naslednji.

   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.0-dev (9859859f1082d94e546aa75746867df127aa0d9e) 2015-08-17 14:57:00

Usage:
 command [options] [arguments]

Uporaba

JSON datoteka

Če želite uporabljati Composer, potrebujete datoteko, imenovano composer.jsonComposer, ki pove, katere zahteve ima vaš projekt in katero različico teh zahtev je treba namestiti. Tega ne ustvarjajte ročno, da ne bi naredili nečesa napačnega – Composer naredi datoteko namesto vas, ko dodate odvisnosti. Samodejno se dodajo tudi dodatne odvisnosti.

Primer uporabe skladatelja

Za uporabo Composerja za namestitve odvisnosti:

• Določite knjižnico, ki je potrebna za aplikacijo.
• Poiščite dobro odprtokodno knjižnico na <Packagist.org>, skladateljevem skladišču.
• Izberite paket, ki ga želite.
• Uporabite composer requireza vključitev in namestitev odvisnosti.

Inicializacija Slugita

Zdaj bomo šli skozi ta postopek s preprostim primerom aplikacije, ki bo vzela stavek in iz njega naredila prijazen niz, imenovan polž. To se pogosto uporablja za pretvorbo imen strani v URL-je, da se olajša ustvarjanje URL-jev in poti. Začeli bomo z izdelavo mape za aplikacijo, imenovano slugit.

mkdir ~/slugit
cd ~/slugit

Iskanje na Packagist

Zdaj bomo šli naprej packagist.orgin našli paket za pomoč pri ustvarjanju polžev. Iskanje slugna Packagist bi moralo prikazati nekatere od teh paketov.

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

Najti moramo pretvornik niza v polž, tako da cocur/slugifyizgleda dobro, z veliko namestitvami in zvezdicami.

Zahteva paket

Ko izberemo paket, ga zaženemo, composer requireda ga vključimo kot odvisnost, ustvarimo composer.jsonin ga namestimo.

composer require cocur/slugify

Kot je razvidno iz ustvarjenega rezultata, je Composer izbral najnovejšo različico paketa in jo uporabil. Če preverite ~/slugit, bi morali videti 2 datoteki composer.lockin composer.json, plus mapo z imenom vendor.

composer.lock se uporablja za shranjevanje informacij o različicah paketov in njihovo ohranjanje enakih.

vendorMapa se uporablja za namestitev odvisnosti. Te mape ne objavljajte v Git repozitorij ali GitHub.

Če projekt, ki ste ga prenesli, že vsebuje composer.json , uporabite composer installza prenos njegovih odvisnosti.

Razumevanje omejitev različice

Če preverite, kaj composer.jsonvključuje, bi morali videti nekaj podobnega temu bloku.

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

Composer ima veliko različnih formatov in omejitev, da opredeli različico paketa, da omogoči prilagodljivost skupaj s stabilnostjo. ^preden številka različice naredi to različico minimalno in dovoljuje vse spodnje različice 2.0.

Običajno vam ni treba spreminjati omejitev različice, če pa to storite, preverite uradno dokumentacijo Composer za več informacij in smernic o tem, kako vse deluje.

Skript za samodejno nalaganje

Composer ponuja skript za samodejno nalaganje, ki olajša delo z vašimi odvisnostmi in imenskimi prostori.

Samo vključite vendor/autoload.phpv svoj PHP pred vsako instanciacijo razreda.

Nazaj k našemu slugitprimeru. Ustvarimo testni skript, imenovan example.php, z uporabo cocur/slugify.

vim example.php

Vstavite naslednje 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!');

Zaženite skript.

php example.php

Izpisal bo naslednje besedilo:

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

Posodabljanje odvisnosti projekta

Za posodobitev odvisnosti projekta.

composer update

Če so najdene posodobitve in so združljive z omejitvijo, podano v composer.json, bo nadomestila prejšnjo različico in posodobila composer.lock.

Za posodobitev ene ali več določenih knjižnic.

composer update vendor1/package1 vendor2/package2

Zaključek

V tej vadnici smo šli skozi namestitev, konfiguracijo in primer uporabe Composer za upravljanje odvisnosti aplikacij PHP.