Download, installation og brug af Composer på Ubuntu 14.04

Composer er et ekstremt populært PHP-administrationsværktøj til afhængigheder, der bruges til at gøre installation og opdateringer nemmere for projekter. Den tjekker også, hvilke andre pakker et projekt har brug for, og henter dem automatisk for dig med den korrekte version.

I dette dokument vil vi installere og begynde at bruge Composer på en Vultr Ubuntu 14.04 VPS.

Krav

• En Vultr Ubuntu 14.04 VPS.
• En almindelig bruger med Sudoadgang til denne VPS.

Installation

Afhængighedsinstallation

Først og fremmest skal vi sikre, at vores VPS har alle Composers krav installeret og fungerer.

Opdater pakkelisten.

sudo apt-get update

Dernæst skal du faktisk installere Composers krav. Du skal bruge curltil download og php5-clitil installation og brug af det. gitbruges også af Composer til download af projektkrav.

Installer kravene.

sudo apt-get install curl php5-cli git

Download og installer

Installation af Composer er meget enkel.

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

Det downloader og installerer Composer som en global kommando, kaldet composer, placeret i /usr/local/bin. Du får dette output.

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

Kør følgende for at teste installationen.

composer

Outputtet bliver som følger.

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

Usage:
 command [options] [arguments]

Brug

JSON fil

For at bruge Composer skal du bruge en fil kaldet for composer.jsonat fortælle Composer hvilke krav dit projekt har, og hvilken version af disse krav der skal installeres. Opret ikke dette manuelt for at undgå at gøre noget forkert - Composer laver filen for dig, når du tilføjer afhængigheder. Yderligere afhængigheder tilføjes også automatisk.

Eksempel på brug af komponist

Sådan bruger du Composer til afhængighedsinstallationer:

• Identificer det nødvendige bibliotek til appen.
• Find et godt open source-bibliotek på <Packagist.org>, Composers repository.
• Vælg den pakke, du ønsker.
• Bruges composer requiretil at inkludere og installere afhængigheden.

Initialiserer Slugit

Vi vil nu gennemgå denne proces med en simpel eksempelapp, som tager en sætning og gør den til en venlig streng, kaldet en snegl. Dette bruges ofte til at konvertere sidenavne til URL'er, for at gøre det nemmere at generere URL'er og stier. Vi starter med at lave en mappe til appen, kaldet slugit.

mkdir ~/slugit
cd ~/slugit

Søger på Packagist

Vi vil nu gå videre packagist.orgog finde en pakke til at hjælpe med at generere snegle. Søgning efter slugpå Packagist skulle vise nogle af disse pakker.

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

Vi skal finde en streng til slug-konverter, så det cocur/slugifyser godt ud, med mange installationer og stjerner.

Kræver en pakke

Efter at have valgt pakken, kører vi for composer requireat inkludere den som en afhængighed, genererer composer.jsonog installerer den.

composer require cocur/slugify

Som det ses i det genererede output, valgte Composer den seneste pakkeversion og brugte den. Når du tjekker ~/slugit, skulle du se 2 filer composer.lockog composer.jsonplus en mappe med navnet vendor.

composer.lock bruges til at gemme information om pakkeversioner og holde dem ved lige.

Den vendormappe bruges til at installere afhængigheder. Overlad ikke denne mappe til et Git-lager eller GitHub.

Hvis et projekt, du har downloadet, allerede indeholder composer.json , skal du bruge composer installtil at downloade dets afhængigheder.

Forstå versionsbegrænsninger

Hvis du tjekker, hvad der composer.jsoninkluderer, bør du se noget, der ligner denne blok.

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

Composer har mange forskellige formater og begrænsninger for at definere en pakkes version for at tillade fleksibilitet kombineret med stabilitet. ^før et versionsnummer gør den version til minimum og tillader alle versioner nedenfor 2.0.

Du behøver normalt ikke at ændre versionsbegrænsninger, men hvis du gør det, så tjek Composers officielle dokumentation for mere information og retningslinjer for, hvordan det hele fungerer.

Autoload-scriptet

Composer leverer et autoload-script, som gør det meget nemmere at arbejde med dine afhængigheder og navnerum.

Bare medtag vendor/autoload.phpi din PHP før enhver klasse-instansering.

Tilbage til vores slugiteksempel. Lad os oprette et testscript, kaldet example.php, ved hjælp af cocur/slugify.

vim example.php

Indsæt følgende i 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!');

Kør scriptet.

php example.php

Den udsender følgende tekst:

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

Opdatering af projektafhængigheder

For at opdatere projektafhængigheder.

composer update

Hvis der findes opdateringer og er kompatible med begrænsningen angivet i composer.json, erstatter den den tidligere version og opdaterer composer.lock.

For at opdatere et eller flere specifikke biblioteker.

composer update vendor1/package1 vendor2/package2

Konklusion

I denne tutorial gennemgik vi installation, konfiguration og et eksempel på brug af Composer til PHP-applikationsafhængighedsstyring.