Pobieranie, instalowanie i korzystanie z Composer na Ubuntu 14.04

• Wymagania
• Instalacja
• Stosowanie
• Wniosek

Composer to niezwykle popularne narzędzie do zarządzania PHP dla zależności, które ułatwia instalację i aktualizację projektów. Sprawdza również, jakich innych pakietów potrzebuje projekt, i automatycznie uzyskuje je dla Ciebie w odpowiedniej wersji.

W tym dokumencie zainstalujemy i zaczniemy używać Composer na Vultr Ubuntu 14.04 VPS.

Wymagania

• Vultr Ubuntu 14.04 VPS.
• Zwykły użytkownik z Sudodostępem do tego VPS.

Instalacja

Instalacja zależności

Przede wszystkim musimy upewnić się, że nasz VPS ma wszystkie wymagania Kompozytora pomyślnie zainstalowane i działa.

Zaktualizuj listę pakietów.

sudo apt-get update

Następnie zainstaluj wymagania Composer. Będziesz potrzebował curldo pobrania oraz php5-cliinstalacji i użytkowania. gitjest również używany przez Composer do pobierania wymagań projektu.

Zainstaluj wymagania.

sudo apt-get install curl php5-cli git

Ściągnij i zainstaluj

Instalacja Composer jest bardzo prosta.

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

To pobiera i instaluje Composer jako globalne polecenie o nazwie composer, zlokalizowane w /usr/local/bin. Otrzymasz ten wynik.

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

Uruchom następujące polecenie, aby przetestować instalację.

composer

Dane wyjściowe będą następujące.

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

Usage:
 command [options] [arguments]

Stosowanie

Plik JSON

Aby korzystać z Composer, potrzebujesz pliku o nazwie w composer.jsoncelu poinformowania Composer, jakie wymagania ma Twój projekt i jaką wersję tych wymagań zainstalować. Nie twórz tego ręcznie, aby uniknąć robienia czegoś niepoprawnie - Composer tworzy plik dla Ciebie, gdy dodajesz zależności. Dodatkowe zależności są również dodawane automatycznie.

Przykład użycia kompozytora

Aby użyć Composer do instalacji zależności:

• Zidentyfikuj bibliotekę potrzebną do aplikacji.
• Znajdź dobrą bibliotekę typu open source na <Packagist.org>, repozytorium kompozytora.
• Wybierz żądany pakiet.
• Użyj, composer requireaby dołączyć i zainstalować zależność.

Inicjalizacja Slugit

Przejdziemy teraz przez ten proces z prostą przykładową aplikacją, która weźmie zdanie i uczyni go przyjaznym ciągiem zwanym ślimakiem. Jest to często używane do konwersji nazw stron na adresy URL, aby ułatwić generowanie adresów URL i ścieżek. Zaczniemy od utworzenia folderu dla aplikacji o nazwie slugit.

mkdir ~/slugit
cd ~/slugit

Wyszukiwanie w Packagist

Teraz przejdziemy dalej packagist.orgi znajdziemy pakiet, który pomoże wygenerować ślimaki. Wyszukiwanie slugw Packagist powinno pokazać niektóre z tych pakietów.

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

Musimy znaleźć konwerter strun na ślimaki, więc cocur/slugifywygląda dobrze, z wieloma instalacjami i gwiazdami.

Wymaganie pakietu

Po wybraniu pakietu uruchamiamy go, composer requireaby uwzględnić go jako zależność, wygenerować composer.jsoni zainstalować.

composer require cocur/slugify

Jak widać na wygenerowanym wyjściu, Composer wybrał najnowszą wersję pakietu i wykorzystał ją. Sprawdzam ~/slugit, powinieneś zobaczyć 2 pliki, composer.locka composer.jsontakże folder o nazwie vendor.

composer.lock służy do przechowywania informacji o wersjach pakietów i utrzymywania ich bez zmian.

vendorFolder służy do instalowania zależności. Nie zatwierdzaj tego folderu w repozytorium Git lub GitHub.

Jeśli projekt, który pobierasz, już zawiera composer.json , użyj, composer installaby pobrać jego zależności.

Zrozumienie ograniczeń wersji

Jeśli sprawdzisz, co composer.jsonobejmuje, powinieneś zobaczyć coś podobnego do tego bloku.

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

Kompozytor ma wiele różnych formatów i ograniczeń, aby zdefiniować wersję pakietu, aby zapewnić elastyczność połączoną ze stabilnością. ^zanim numer wersji uczyni tę wersję minimalną i zezwoli na wszystkie poniższe wersje 2.0.

Zwykle nie powinieneś zmieniać ograniczeń wersji, ale jeśli to zrobisz, sprawdź oficjalną dokumentację Kompozytora, aby uzyskać więcej informacji i wskazówek, jak to wszystko działa.

Skrypt autoloadu

Composer zapewnia skrypt automatycznego ładowania, który znacznie ułatwia pracę z zależnościami i przestrzeniami nazw.

Po prostu dołącz vendor/autoload.phpdo swojego PHP przed wystąpieniem klasy.

Powrót do naszego slugitprzykładu. Utwórzmy skrypt testowy, nazywany example.php, za pomocą cocur/slugify.

vim example.php

Umieść w 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!');

Uruchom skrypt.

php example.php

Wyświetli następujący tekst:

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

Aktualizacja zależności projektu

Aby zaktualizować zależności projektu.

composer update

Jeśli zostaną znalezione aktualizacje zgodne z podanym ograniczeniem composer.json, zastąpi ono poprzednią wersję i aktualizację composer.lock.

Aby zaktualizować jedną lub więcej określonych bibliotek.

composer update vendor1/package1 vendor2/package2

Wniosek

W tym samouczku omówiliśmy instalację, konfigurację i przykład użycia Composer do zarządzania zależnościami aplikacji PHP.