Απαιτήσεις
Εγκατάσταση
Χρήση
συμπέρασμα
Το Composer είναι ένα εξαιρετικά δημοφιλές εργαλείο διαχείρισης PHP για εξαρτήσεις, που χρησιμοποιείται για να διευκολύνει την εγκατάσταση και τις ενημερώσεις για έργα. Ελέγχει επίσης ποια άλλα πακέτα χρειάζεται ένα έργο και τα αποκτά αυτόματα για εσάς, με τη σωστή έκδοση.
Σε αυτό το έγγραφο, θα εγκαταστήσουμε και θα αρχίσουμε να χρησιμοποιούμε το Composer σε ένα Vultr Ubuntu 14.04 VPS.
Απαιτήσεις
- Ένα Vultr Ubuntu 14.04 VPS.
- Τακτικός χρήστης με
Sudoπρόσβαση σε αυτό το VPS.
Εγκατάσταση
Εγκατάσταση εξάρτησης
Πρώτα απ 'όλα, πρέπει να διασφαλίσουμε ότι το VPS μας έχει εγκαταστήσει και λειτουργεί με επιτυχία όλες τις απαιτήσεις του Composer.
Ενημερώστε τη λίστα πακέτων.
sudo apt-get update
Στη συνέχεια, εγκαταστήστε πραγματικά τις απαιτήσεις του Composer. Θα χρειαστείτε curlγια τη λήψη και php5-cliγια την εγκατάσταση και τη χρήση του. gitχρησιμοποιείται επίσης από το Composer για λήψεις απαιτήσεων έργου.
Εγκαταστήστε τις απαιτήσεις.
sudo apt-get install curl php5-cli git
Λήψη και εγκατάσταση
Η εγκατάσταση του Composer είναι πολύ απλή.
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
Αυτό κατεβάζει και εγκαθιστά το Composer ως καθολική εντολή, που ονομάζεται composer, που βρίσκεται στο /usr/local/bin. Θα λάβετε αυτό το αποτέλεσμα.
#!/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
Εκτελέστε τα παρακάτω για να δοκιμάσετε την εγκατάσταση.
composer
Η έξοδος θα είναι η εξής.
______
/ ____/___ ____ ___ ____ ____ ________ _____
/ / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 1.0-dev (9859859f1082d94e546aa75746867df127aa0d9e) 2015-08-17 14:57:00
Usage:
command [options] [arguments]
Χρήση
αρχείο JSON
Για να χρησιμοποιήσετε το Composer, χρειάζεστε ένα αρχείο που καλείται composer.jsonγια να ενημερώσει το Composer ποιες απαιτήσεις έχει το έργο σας και ποια έκδοση αυτών των απαιτήσεων να εγκαταστήσει. Μην το δημιουργείτε με μη αυτόματο τρόπο για να αποφύγετε να κάνετε κάτι λανθασμένο - Το Composer δημιουργεί το αρχείο για εσάς όταν προσθέτετε εξαρτήσεις. Πρόσθετες εξαρτήσεις προστίθενται επίσης αυτόματα.
Παράδειγμα χρήσης συνθέτη
Για να χρησιμοποιήσετε το Composer για εγκαταστάσεις εξάρτησης:
- Προσδιορίστε τη βιβλιοθήκη που απαιτείται για την εφαρμογή.
- Βρείτε μια καλή βιβλιοθήκη ανοιχτού κώδικα στο <Packagist.org>, το αποθετήριο του Composer.
- Επιλέξτε το πακέτο που θέλετε.
- Χρησιμοποιήστε το
composer requireγια να συμπεριλάβετε και να εγκαταστήσετε την εξάρτηση.
Εκκίνηση του Slugit
Τώρα θα προχωρήσουμε σε αυτή τη διαδικασία με ένα απλό παράδειγμα εφαρμογής, η οποία θα πάρει μια πρόταση και θα την κάνει μια φιλική συμβολοσειρά, που ονομάζεται γυμνοσάλιαγκος. Χρησιμοποιείται συχνά για τη μετατροπή ονομάτων σελίδων σε διευθύνσεις URL, για να διευκολύνεται η δημιουργία διευθύνσεων URL και διαδρομών. Θα ξεκινήσουμε δημιουργώντας έναν φάκελο για την εφαρμογή, που ονομάζεται slugit.
mkdir ~/slugit
cd ~/slugit
Αναζήτηση στο Packagist
Θα συνεχίσουμε τώρα packagist.orgκαι θα βρούμε ένα πακέτο που θα σας βοηθήσει να δημιουργήσετε γυμνοσάλιαγκες. Η αναζήτηση slugστο Packagist θα πρέπει να εμφανίζει μερικά από αυτά τα πακέτα.
easy-slug/easy-slug, muffin/slug, ddd/slug, zelenin/slug, webcastle/slug, anomaly/slug-field_type
Πρέπει να βρούμε έναν μετατροπέα συμβολοσειράς σε γυμνοσάλιαγκο, οπότε cocur/slugifyφαίνεται καλό, με πολλές εγκαταστάσεις και αστέρια.
Απαιτείται πακέτο
Αφού επιλέξουμε το πακέτο, τρέχουμε composer requireνα το συμπεριλάβουμε ως εξάρτηση, να δημιουργήσουμε composer.jsonκαι να το εγκαταστήσουμε.
composer require cocur/slugify
Όπως φαίνεται στην έξοδο που δημιουργήθηκε, ο Composer επέλεξε την πιο πρόσφατη έκδοση πακέτου και τη χρησιμοποίησε. Κάνοντας έλεγχο ~/slugit, θα πρέπει να δείτε 2 αρχεία composer.lockκαι composer.json, συν έναν φάκελο με το όνομα vendor.
composer.lock χρησιμοποιείται για την αποθήκευση πληροφοριών σχετικά με τις εκδόσεις πακέτων και τη διατήρηση των ίδιων.
Ο vendorφάκελος χρησιμοποιείται για την εγκατάσταση των εξαρτήσεων. Μην δεσμεύσετε αυτόν τον φάκελο σε αποθετήριο Git ή GitHub.
Εάν ένα έργο που έχετε κατεβάσει περιέχει ήδη composer.json, χρησιμοποιήστε το composer installγια λήψη των εξαρτήσεων του.
Κατανόηση των περιορισμών έκδοσης
Εάν ελέγξετε τι composer.jsonπεριλαμβάνει, θα πρέπει να δείτε κάτι παρόμοιο με αυτό το μπλοκ.
{
"require": {
"cocur/slugify": "^1.2"
}
}
Το Composer έχει πολλές διαφορετικές μορφές και περιορισμούς, για να ορίσει την έκδοση ενός πακέτου, για να επιτρέπει ευελιξία σε συνδυασμό με σταθερότητα. ^προτού ένας αριθμός έκδοσης κάνει αυτήν την έκδοση την ελάχιστη και επιτρέπει όλες τις παρακάτω εκδόσεις 2.0.
Κανονικά δεν χρειάζεται να αλλάξετε τους περιορισμούς έκδοσης, αλλά αν το κάνετε, ελέγξτε την επίσημη τεκμηρίωση του Composer για περισσότερες πληροφορίες και οδηγίες σχετικά με το πώς όλα λειτουργούν.
Το σενάριο αυτόματης φόρτωσης
Το Composer παρέχει ένα σενάριο αυτόματης φόρτωσης, το οποίο διευκολύνει πολύ την εργασία με τις εξαρτήσεις και τους χώρους ονομάτων σας.
Απλώς συμπεριλάβετε vendor/autoload.phpστην PHP σας πριν από οποιαδήποτε δημιουργία κλάσης.
Επιστροφή στο slugitπαράδειγμά μας . Ας δημιουργήσουμε ένα δοκιμαστικό σενάριο, που ονομάζεται example.php, χρησιμοποιώντας cocur/slugify.
vim example.php
Βάλτε τα παρακάτω στο 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!');
Εκτελέστε το σενάριο.
php example.php
Θα βγάλει το ακόλουθο κείμενο:
hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it
Ενημέρωση εξαρτήσεων έργου
Για να ενημερώσετε τις εξαρτήσεις του έργου.
composer update
Εάν βρεθούν ενημερώσεις και είναι συμβατές με τον περιορισμό που δίνεται στο composer.json, θα αντικαταστήσει την προηγούμενη έκδοση και θα ενημερώσει composer.lock.
Για να ενημερώσετε μία ή περισσότερες συγκεκριμένες βιβλιοθήκες.
composer update vendor1/package1 vendor2/package2
συμπέρασμα
Σε αυτό το σεμινάριο, εξετάσαμε την εγκατάσταση, τη ρύθμιση παραμέτρων και ένα παράδειγμα χρήσης του Composer για τη διαχείριση εξαρτήσεων εφαρμογών PHP.