Οδηγοί εγκατάστασης

Εγκατάσταση Composer και ρυθμίσεις PHP

Εξηγούμε πώς να εγκαταστήσετε το PHP με τις σωστές επεκτάσεις, να διαχειριστείτε τις εξαρτήσεις με το Composer και να χτίσετε μια τακτοποιημένη δομή έργου με PSR-4 autoloading.

Aurora YazılımΣυντακτική ομάδα 6 λεπτά ανάγνωσης
Composer Setup and PHP Settings
Πώς εγκαθίσταται το Composer;

Για την εγκατάσταση του Composer, πρέπει πρώτα να έχει εγκατασταθεί το PHP και να λειτουργεί στο τερματικό. Στα Windows, το πρόγραμμα εγκατάστασης Composer-Setup.exe από το getcomposer.org βρίσκει το PHP και το προσθέτει στο PATH. Σε macOS και Linux, κατεβάζετε το composer.phar με τις εντολές εγκατάστασης του ιστότοπου και το μετακινείτε στο /usr/local/bin/composer. Αν η εντολή composer --version επιστρέφει έκδοση, η εγκατάσταση έχει ολοκληρωθεί· οι εξαρτήσεις εγκαθίστανται με composer install.

Τι είναι το Composer και γιατί το χρειάζεστε;

Το Composer είναι ο διαχειριστής εξαρτήσεων για έργα PHP. Κατεβάζει τις βιβλιοθήκες που χρειάζεται το έργο σας, με συμβατές εκδόσεις, και σας επιτρέπει να τις διαχειρίζεστε από ένα μόνο αρχείο. Το Composer είναι για το PHP ό,τι το npm για τη JavaScript και το pip για την Python.

Δεύτερη μεγάλη προσφορά του Composer είναι το autoloading. Αντί να γράφετε δεκάδες γραμμές require, συμπεριλαμβάνετε ένα μόνο αρχείο· οι κλάσεις φορτώνονται αυτόματα τη στιγμή που χρειάζονται. Τα σύγχρονα PHP frameworks όπως το Laravel και το Symfony χτίζονται πάνω στο Composer εξαρχής.

Οι βιβλιοθήκες δημοσιεύονται σε ένα δημόσιο αποθετήριο που ονομάζεται Packagist. Το Composer επιλέγει κατάλληλα πακέτα από αυτό το αποθετήριο σύμφωνα με τους κανόνες εκδόσεων στο αρχείο composer.json και τα εγκαθιστά όλα στον φάκελο vendor.

Αρχείο / φάκελοςΣκοπόςΜπαίνει στο Git;
composer.jsonΕξαρτήσεις, κανόνες εκδόσεων, ρυθμίσεις autoloadΝαι
composer.lockΗ ακριβής έκδοση κάθε εγκατεστημένου πακέτουΝαι (στις εφαρμογές)
vendor/Πακέτα που κατέβηκαν και αρχεία autoloadΌχι

Εγκατάσταση PHP: Windows, macOS, Linux

Το Composer είναι πρόγραμμα PHP, επομένως το PHP πρέπει πρώτα να λειτουργεί στη γραμμή εντολών. Αν έχετε εγκατεστημένο το XAMPP στον υπολογιστή σας, μπορείτε να χρησιμοποιήσετε το PHP που περιέχει· λεπτομέρειες υπάρχουν στον οδηγό μας εγκατάσταση XAMPP. Αν θέλετε να εγκαταστήσετε αυτόνομο PHP, ακολουθήστε τα βήματα για το λειτουργικό σας σύστημα.

bashΈλεγχος του PHP
php -v # Εγκατεστημένες επεκτάσεις php -m # Το αρχείο php.ini που χρησιμοποιείται php --ini

PHP στα Windows

Κατεβάστε το zip x64 Thread Safe της τρέχουσας σταθερής έκδοσης από το windows.php.net και αποσυμπιέστε το σε σύντομο φάκελο όπως C:\php. Δημιουργήστε αντίγραφο του αρχείου php.ini-development στον φάκελο με όνομα php.ini και προσθέστε τον φάκελο C:\php στο PATH του συστήματος.

Στο php.ini, ενεργοποιήστε τις επεκτάσεις που χρειάζονται το Composer και τα περισσότερα πακέτα, αφαιρώντας το ερωτηματικό στην αρχή της γραμμής:

iniphp.ini (Windows)
; Ενεργοποίηση των απαραίτητων επεκτάσεων της PHP για το Composer και τα περισσότερα πακέτα ; Ενεργοποίηση των απαραίτητων επεκτάσεων της PHP για το Composer και τα περισσότερα πακέτα extension_dir = "ext" extension=curl extension=fileinfo extension=mbstring extension=openssl extension=pdo_mysql extension=zip

PHP σε macOS και Linux

Στο macOS αρκεί μία εντολή με το Homebrew. Σε Ubuntu και Debian, εγκαταστήστε το πακέτο γραμμής εντολών του PHP μαζί με τις συχνά χρησιμοποιούμενες επεκτάσεις και το εργαλείο unzip· το Composer χρειάζεται το unzip ή την επέκταση zip κατά την αποσυμπίεση των πακέτων.

bashmacOS
brew install php
bashUbuntu / Debian
sudo apt update sudo apt install php-cli php-mbstring php-xml php-curl php-zip unzip

Εγκατάσταση Composer βήμα προς βήμα

Ο ευκολότερος τρόπος στα Windows είναι το πρόγραμμα εγκατάστασης Composer-Setup.exe στο getcomposer.org. Το πρόγραμμα εγκατάστασης βρίσκει το php.exe στον υπολογιστή σας, αναφέρει τις ρυθμίσεις που λείπουν και προσθέτει την εντολή composer στο PATH. Μετά την εγκατάσταση, κλείστε και ανοίξτε ξανά τα ανοιχτά τερματικά.

Σε macOS και Linux, το Composer εγκαθίσταται με την εντολή τεσσάρων γραμμών της σελίδας λήψης. Μία από αυτές τις εντολές επαληθεύει το hash ασφαλείας του αρχείου που κατεβάζετε και αλλάζει σε κάθε έκδοση· γι' αυτό αντιγράφετε πάντα τις εντολές στην τρέχουσα μορφή τους από την επίσημη σελίδα. Η εγκατάσταση δημιουργεί ένα αρχείο composer.phar στον φάκελο όπου βρίσκεστε· αν το μετακινήσετε σε καθολική θέση, μπορείτε να το εκτελείτε πληκτρολογώντας composer από οπουδήποτε.

bashmacOS / Linux (προσθέστε τη γραμμή επαλήθευσης hash από την επίσημη σελίδα)
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" # (η γραμμή επαλήθευσης hash της επίσημης σελίδας) php composer-setup.php php -r "unlink('composer-setup.php');" # Μετακίνηση στο καθολικό επίπεδο sudo mv composer.phar /usr/local/bin/composer
bashΕπαλήθευση
# Επαλήθευση composer --version composer diagnose

composer install και βασικές εντολές

Σε ένα νέο έργο, το composer init δημιουργεί το composer.json μέσω διαδραστικών ερωτήσεων. Αν έχετε κλωνοποιήσει ένα υπάρχον έργο, αρκεί να εκτελέσετε composer install: το Composer εγκαθιστά τις ακριβείς εκδόσεις που υπάρχουν στο αρχείο composer.lock.

Το composer require προσθέτει ένα νέο πακέτο και ενημερώνει τα composer.json και composer.lock. Το composer update αναβαθμίζει στις νεότερες εκδόσεις εντός του επιτρεπόμενου εύρους εκδόσεων, γι' αυτό πρέπει να χρησιμοποιείται συνειδητά μέσα σε ομάδα.

  • Ο κανόνας έκδοσης ^2.0 επιτρέπει όλες τις εκδόσεις μέσα στη σειρά 2.x και δεν περνά στην 3.0.
  • Μοιραστείτε το αρχείο composer.lock· όλοι στην ομάδα και ο διακομιστής εγκαθιστούν τις ίδιες εκδόσεις.
  • Μην κάνετε commit τον φάκελο vendor στο Git· προσθέστε τον στο .gitignore.
bashΣυχνά χρησιμοποιούμενες εντολές του Composer
# Δημιουργία νέου αρχείου έργου composer init # Προσθήκη πακέτου composer require guzzlehttp/guzzle # Πακέτο που χρειάζεται μόνο για ανάπτυξη composer require --dev phpunit/phpunit # Εγκατάσταση σύμφωνα με το αρχείο lock composer install # Ενημέρωση εκδόσεων composer update composer outdated # Αφαίρεση πακέτου και λίστα πακέτων composer remove guzzlehttp/guzzle composer show

Έλεγχος ασφαλείας

Ελέγξτε αν τα πακέτα που χρησιμοποιείτε έχουν γνωστή ευπάθεια με την εντολή composer audit. Η εντολή συγκρίνει τις εκδόσεις στο αρχείο lock με ανοιχτές βάσεις δεδομένων και απαριθμεί τα επηρεαζόμενα πακέτα. Αν εκτελείτε αυτόν τον έλεγχο μετά από κάθε ενημέρωση και ανά τακτά διαστήματα, αποτρέπετε μια παλιά βιβλιοθήκη από το να θέσει σε κίνδυνο τον ιστότοπό σας.

bash
composer audit

Scripts του Composer

Μπορείτε να γράψετε τις εντολές που χρησιμοποιείτε συχνά στο πεδίο scripts του composer.json· για παράδειγμα, ένα script test που τρέχει τα τεστ. Τα scripts αυτά εκτελούνται με composer run-script test ή απλώς με composer test. Έτσι όλη η ομάδα χρησιμοποιεί την ίδια εντολή με τις ίδιες παραμέτρους και ένας νέος προγραμματιστής βλέπει με μια ματιά πώς ελέγχεται το έργο.

Αυτόματη φόρτωση PSR-4

Χρησιμοποιήστε το Composer όχι μόνο για εξωτερικά πακέτα, αλλά και για να οργανώσετε τον δικό σας κώδικα. Στο πρότυπο PSR-4 κάθε namespace αντιστοιχεί σε έναν φάκελο· για παράδειγμα, η κλάση App\Servis\Fatura βρίσκεται στο αρχείο src/Servis/Fatura.php.

Αφού προσθέσετε τη ρύθμιση στο composer.json, εκτελέστε την εντολή composer dump-autoload. Από εκεί και πέρα αρκεί να συμπεριλάβετε το vendor/autoload.php στο αρχείο εισόδου του έργου.

jsoncomposer.json (ενότητα autoload)
{ "require": { "php": ">=8.1" }, "autoload": { "psr-4": { "App\\": "src/" } } }
phpindex.php
<?php require __DIR__ . '/vendor/autoload.php'; use App\Servis\Fatura; $fatura = new Fatura();
bash
composer dump-autoload

Εγκατάσταση σε ζωντανό διακομιστή

Ένας ζωντανός διακομιστής δεν χρειάζεται τα πακέτα ανάπτυξης, ενώ η βελτιστοποίηση του autoloader εξοικονομεί χρόνο σε κάθε αίτημα. Χρησιμοποιήστε την παρακάτω εντολή κατά το deployment· το --no-dev αφήνει έξω τα εργαλεία δοκιμών και το --optimize-autoloader δημιουργεί εκ των προτέρων τον χάρτη κλάσεων.

Αυτή η μικρή ρύθμιση επηρεάζει θετικά τον χρόνο απόκρισης, ιδίως σε έργα με πολλές κλάσεις. Βελτιώσεις στον διακομιστή όπως αυτή τις αντιμετωπίζουμε ως μέρος της εργασίας μας για τη διαχείριση ταχύτητας και απόδοσης.

Είναι επίσης καλή συνήθεια να εκτελείτε τοπικά το composer validate πριν από το deployment: ελέγχει για λάθη στο composer.json και αν το αρχείο lock είναι ενημερωμένο. Έτσι μειώνεται η πιθανότητα να βρεθείτε με μισοτελειωμένη εγκατάσταση στον διακομιστή.

  • Η έκδοση PHP του διακομιστή πρέπει να ικανοποιεί τον κανόνα php του composer.json.
  • Αν τοπικά χρησιμοποιείτε διαφορετική έκδοση PHP, μπορείτε να προσομοιώσετε την έκδοση του διακομιστή με τη ρύθμιση config.platform.php στο composer.json.
  • Για απόλυτη αντιστοιχία των περιβαλλόντων, μπορείτε επίσης να τρέξετε την PHP μέσα σε container· δείτε την εγκατάσταση Docker.
bashΕγκατάσταση σε παραγωγή
composer install --no-dev --optimize-autoloader # χωρίς πακέτα ανάπτυξης

Συνηθισμένα σφάλματα και λύσεις

Τα περισσότερα σφάλματα του Composer προέρχονται από επεκτάσεις PHP που λείπουν, από ασύμβατη έκδοση PHP και από όρια μνήμης. Η εντολή composer diagnose εντοπίζει μόνη της πολλά προβλήματα.

  • Η εντολή php δεν αναγνωρίζεται: Ο φάκελος της PHP δεν βρίσκεται στο PATH· προσθέστε τον και ανοίξτε ξανά το τερματικό.
  • Λείπει η επέκταση openssl: Ενεργοποιήστε τη γραμμή extension=openssl στο php.ini· βεβαιωθείτε με την εντολή php --ini ότι επεξεργάζεστε το σωστό αρχείο php.ini.
  • Λείπουν η επέκταση zip και η εντολή unzip: Στα Windows ενεργοποιήστε τη γραμμή extension=zip, στο Linux εγκαταστήστε τα πακέτα php-zip και unzip.
  • Your requirements could not be resolved: Το πακέτο δεν υποστηρίζει την εγκατεστημένη έκδοση PHP ή την έκδοση ενός άλλου πακέτου. Διαβάστε την απαίτηση στο κείμενο του σφάλματος και επιλέξτε ανάλογα την έκδοση PHP ή του πακέτου.
  • Allowed memory size exhausted: Αυξήστε το όριο μνήμης εκτελώντας την εντολή ως COMPOSER_MEMORY_LIMIT=-1 composer update ή ανεβάζοντας την τιμή memory_limit στο php.ini.

Επόμενα βήματα με το Composer

Τα περισσότερα έργα PHP δουλεύουν με βάση δεδομένων. Πριν συνδέσετε ένα επίπεδο βάσης δεδομένων που εγκαταστήσατε με το Composer, μπορείτε να προετοιμάσετε τον τοπικό σας διακομιστή με τον οδηγό μας εγκατάσταση MySQL. Για περισσότερο περιεχόμενο PHP, δείτε τη σελίδα της ετικέτας php.

Η σωστά στημένη διαχείριση εξαρτήσεων επιτρέπει σε μια εταιρική ιστοσελίδα ή σε ένα έργο ενσωμάτωσης που συνδέεται με υπηρεσίες πληρωμών και αποστολών να ενημερώνεται με ασφάλεια για χρόνια. Και η υποδομή ηλεκτρονικού εμπορίου της Aurora Yazılım χτίζεται χωρίς έτοιμα θέματα, με μοναδικό σχεδιασμό για κάθε εταιρεία.

Συχνές ερωτήσεις

01Πρέπει να εγκαταστήσω το Composer ξεχωριστά για κάθε έργο;

Όχι. Το Composer εγκαθίσταται μία φορά καθολικά στον υπολογιστή σας. Κάθε έργο έχει το δικό του composer.json και φάκελο vendor· τα πακέτα εγκαθίστανται ξεχωριστά για κάθε έργο. Επειδή το Composer διατηρεί τα πακέτα που κατεβάζει σε cache, η εγκατάσταση στο δεύτερο έργο ολοκληρώνεται πιο γρήγορα.

02Ποια είναι η διαφορά ανάμεσα στο composer install και στο composer update;

Το composer install εγκαθιστά τις ακριβείς εκδόσεις που αναγράφονται στο αρχείο composer.lock και δεν αλλάζει το αρχείο lock. Το composer update αναζητά νεότερες εκδόσεις σύμφωνα με τους κανόνες εκδόσεων και ενημερώνει το αρχείο lock· γι’ αυτό στους διακομιστές χρησιμοποιείται το install.

03Μπορώ να χρησιμοποιήσω το Composer σε shared hosting;

Αν η εταιρεία φιλοξενίας σας παρέχει πρόσβαση SSH, συχνά μπορεί να χρησιμοποιηθεί. Αν δεν υπάρχει SSH, μια λύση είναι να εγκαταστήσετε τις εξαρτήσεις τοπικά με composer install --no-dev και να ανεβάσετε τον φάκελο vendor με μεταφορά αρχείων· βεβαιωθείτε ότι οι εκδόσεις PHP είναι συμβατές.

Μόλις εγκαταστήσετε την PHP με τις σωστές επεκτάσεις και προσθέσετε το Composer στο PATH, μπορείτε να διαχειρίζεστε τις εξαρτήσεις μέσα σε λίγα λεπτά με το composer install και να χτίσετε μια τακτοποιημένη δομή κώδικα με το PSR-4. Αν θέλετε ένα συντηρήσιμο σύστημα βασισμένο στην PHP ή μια εφαρμογή ιστού φτιαγμένη στα μέτρα της επιχείρησής σας, γνωρίστε τις λύσεις λογισμικού κατά παραγγελία της Aurora Yazılım ή επικοινωνήστε μαζί μας.

Συνεχίστε την ανάγνωση

Σχετικά άρθρα

Όλες οι αναρτήσεις Οδηγών εγκατάστασης