Composerin lataaminen, asentaminen ja käyttäminen Ubuntu 14.04:ssä

Composer on erittäin suosittu PHP riippuvuuksien hallintatyökalu, jota käytetään helpottamaan projektien asennusta ja päivityksiä. Se myös tarkistaa, mitä muita paketteja projekti tarvitsee, ja hankkii ne automaattisesti puolestasi oikealla versiolla.

Tässä asiakirjassa asennamme Composerin ja aloitamme sen käytön Vultr Ubuntu 14.04 VPS:ssä.

Vaatimukset

• Vultr Ubuntu 14.04 VPS.
• Tavallinen käyttäjä, jolla on Sudopääsy kyseiseen VPS:ään.

Asennus

Riippuvuusasennus

Ensinnäkin meidän on varmistettava, että VPS:llämme on kaikki Composerin vaatimukset asennettuna ja toiminnassa.

Päivitä pakettilista.

sudo apt-get update

Asenna seuraavaksi Composerin vaatimukset. Tarvitset curlsen lataamista sekä php5-clisen asentamista ja käyttöä varten. gitComposer käyttää sitä myös projektivaatimusten lataamiseen.

Asenna vaatimukset.

sudo apt-get install curl php5-cli git

lataa ja asenna

Composerin asentaminen on hyvin yksinkertaista.

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

Se lataa ja asentaa Composerin globaalina komennona nimeltä composer, joka sijaitsee /usr/local/bin. Saat tämän tulosteen.

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

Testaa asennus suorittamalla seuraava.

composer

Tulos on seuraava.

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

Usage:
 command [options] [arguments]

Käyttö

JSON-tiedosto

Composerin käyttämiseksi tarvitset tiedoston, composer.jsonjoka kertoo Composerille, mitkä vaatimukset projektillasi on ja mikä versio näistä vaatimuksista on asennettava. Älä luo tätä manuaalisesti, jotta vältyt tekemästä jotain väärin – Composer tekee tiedoston puolestasi, kun lisäät riippuvuuksia. Muita riippuvuuksia lisätään myös automaattisesti.

Esimerkki säveltäjän käytöstä

Composerin käyttäminen riippuvuusasennuksissa:

• Tunnista sovellukselle tarvittava kirjasto.
• Löydä hyvä avoimen lähdekoodin kirjasto osoitteesta <Packagist.org>, Composerin arkisto.
• Valitse haluamasi paketti.
• Käytä composer requiresisällyttämään ja asentamaan riippuvuus.

Slugitin alustus

Käymme nyt läpi tämän prosessin yksinkertaisella esimerkkisovelluksella, joka ottaa lauseen ja tekee siitä ystävällisen merkkijonon, jota kutsutaan etanaksi. Tätä käytetään usein sivujen nimien muuntamiseen URL-osoitteiksi URL-osoitteiden ja polkujen luomisen helpottamiseksi. Aloitamme tekemällä sovellukselle kansion nimeltä slugit.

mkdir ~/slugit
cd ~/slugit

Haku Packagistista

Jatkamme nyt packagist.orgetsimään pakettia etanoiden tuottamiseksi. Etsiminen slugon Packagist pitäisi näkyä näistä paketeista.

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

Meidän on löydettävä merkkijono etanamuunnin, joten se cocur/slugifynäyttää hyvältä, monilla asennuksilla ja tähdillä.

Vaatii paketin

Kun olet valinnut paketin, composer requiresisällytämme sen riippuvuutena, luomme composer.jsonja asennamme sen.

composer require cocur/slugify

Kuten luodusta tuloksesta näkyy, Composer valitsi uusimman paketin version ja käytti sitä. Kun tarkistat ~/slugit, sinun pitäisi nähdä 2 tiedostoa composer.lockja composer.json, sekä kansio nimeltä vendor.

composer.lock käytetään tallentamaan tietoja pakettiversioista ja pitämään ne ennallaan.

vendorKansiota käytetään asentaa riippuvuudet. Älä sitoa tätä kansiota Git-tietovarastoon tai GitHubiin.

Jos lataamasi projekti sisältää jo composer.json, käytä composer installsen riippuvuuksien lataamiseen.

Versiorajoitusten ymmärtäminen

Jos tarkistat, mitä composer.jsonsisältää, sinun pitäisi nähdä jotain tämän lohkon kaltaista.

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

Composerilla on monia eri muotoja ja rajoituksia paketin version määrittelemiseksi, mikä mahdollistaa joustavuuden ja vakauden. ^ennen kuin versionumero tekee siitä vähimmäisversion ja sallii kaikki alla olevat versiot 2.0.

Sinun ei normaalisti tarvitse muuttaa versiorajoituksia, mutta jos teet niin, tarkista Composerin virallisesta dokumentaatiosta lisätietoja ja ohjeita sen toimivuudesta.

Automaattinen latausskripti

Composer tarjoaa automaattilatauskomentosarjan, joka helpottaa riippuvuuksien ja nimiavaruuksien käsittelyä.

Sisällytä vendor/autoload.phpvain PHP-tiedostoosi ennen luokan ilmentymistä.

Takaisin slugitesimerkkiimme. Luodaan testiskripti, nimeltään example.php, käyttämällä cocur/slugify.

vim example.php

Laita seuraava kohtaan 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!');

Suorita skripti.

php example.php

Se tulostaa seuraavan tekstin:

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

Projektiriippuvuuksien päivittäminen

Projektiriippuvuuksien päivittäminen.

composer update

Jos päivityksiä löytyy ja ne ovat yhteensopivia kohdassa annetun rajoituksen kanssa composer.json, se korvaa edellisen version ja päivittää composer.lock.

Yhden tai useamman tietyn kirjaston päivittäminen.

composer update vendor1/package1 vendor2/package2

Johtopäätös

Tässä opetusohjelmassa kävimme läpi asennuksen, konfiguroinnin ja esimerkin Composer for PHP -sovellusten riippuvuuden hallinnasta.