Guide all'installazione

Installazione di Composer e impostazioni di PHP

Spieghiamo come installare PHP con le estensioni giuste, gestire le dipendenze con Composer e costruire una struttura di progetto ordinata con l'autoloading PSR-4.

Aurora YazılımRedazione 6 min di lettura
Composer Setup and PHP Settings
Come si installa Composer?

Per l'installazione di Composer, PHP deve prima essere installato e funzionante nel terminale. Su Windows, l'installer Composer-Setup.exe da getcomposer.org trova PHP e lo aggiunge al PATH. Su macOS e Linux, si scarica composer.phar con i comandi di installazione del sito e lo si sposta in /usr/local/bin/composer. Se composer --version restituisce una versione, l'installazione è completata; le dipendenze si installano con composer install.

Cos'è Composer e perché ne avete bisogno?

Composer è il gestore di dipendenze per i progetti PHP. Scarica le librerie di cui il progetto ha bisogno, con versioni compatibili, e permette di gestirle da un unico file. Composer sta a PHP come npm sta a JavaScript e pip a Python.

Il secondo grande contributo di Composer è l'autoloading. Invece di scrivere decine di righe require, si include un solo file; le classi vengono caricate automaticamente nel momento in cui servono. I moderni framework PHP come Laravel e Symfony sono costruiti su Composer fin dalle fondamenta.

Le librerie sono pubblicate in un repository pubblico chiamato Packagist. Composer sceglie i pacchetti adatti da questo repository in base alle regole di versione nel vostro file composer.json e li installa tutti nella cartella vendor.

File / cartellaFinalitàIncluso in Git?
composer.jsonDipendenze, regole di versione, impostazioni di autoloadSì
composer.lockLa versione esatta di ogni pacchetto installatoSì (nelle applicazioni)
vendor/Pacchetti scaricati e file di autoloadNo

Installare PHP: Windows, macOS, Linux

Composer è un programma PHP, quindi PHP deve prima funzionare da riga di comando. Se sul vostro computer è installato XAMPP, potete usare il PHP al suo interno; i dettagli sono nella nostra guida all'installazione di XAMPP. Se volete installare un PHP autonomo, seguite i passaggi per il vostro sistema operativo.

bashVerificare PHP
php -v # Installed extensions php -m # The php.ini file in use php --ini

PHP su Windows

Scaricate lo zip x64 Thread Safe dell'ultima versione stabile da windows.php.net ed estraetelo in una cartella dal percorso breve come C:\php. Create una copia del file php.ini-development nella cartella con il nome php.ini e aggiungete la cartella C:\php al PATH di sistema.

In php.ini, abilitate le estensioni necessarie a Composer e alla maggior parte dei pacchetti rimuovendo il punto e virgola all'inizio della riga:

iniphp.ini (Windows)
; estensioni abilitate extension_dir = "ext" extension=curl extension=fileinfo extension=mbstring extension=openssl extension=pdo_mysql extension=zip

PHP su macOS e Linux

Su macOS basta un solo comando con Homebrew. Su Ubuntu e Debian, installate il pacchetto PHP da riga di comando insieme alle estensioni più usate e allo strumento unzip; Composer ha bisogno di unzip o dell'estensione zip per estrarre i pacchetti.

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

Installazione di Composer passo dopo passo

Il modo più semplice su Windows è l'installer Composer-Setup.exe su getcomposer.org. L'installer trova php.exe sul vostro computer, segnala le impostazioni mancanti e aggiunge il comando composer al PATH. Dopo l'installazione, chiudete e riaprite i terminali aperti.

Su macOS e Linux, Composer si installa con il comando di quattro righe presente nella pagina di download. Uno di questi comandi verifica l'hash di sicurezza del file scaricato e cambia a ogni release; copiate quindi sempre i comandi nella loro forma attuale dalla pagina ufficiale. L'installazione crea un file composer.phar nella cartella in cui vi trovate; spostandolo in una posizione globale, potete eseguirlo digitando composer da qualsiasi punto.

bashmacOS / Linux (aggiungete la riga di verifica dell'hash dalla pagina ufficiale)
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" # (the hash verification line on the official page) php composer-setup.php php -r "unlink('composer-setup.php');" # Move to the global scope sudo mv composer.phar /usr/local/bin/composer
bashVerifica
composer --version composer diagnose

composer install e comandi di base

In un nuovo progetto, composer init crea composer.json tramite domande interattive. Se avete clonato un progetto esistente, basta eseguire composer install: Composer installa le versioni esatte presenti nel file composer.lock.

composer require aggiunge un nuovo pacchetto e aggiorna composer.json e composer.lock. composer update aggiorna alle versioni più recenti all'interno dell'intervallo di versioni consentito, quindi in un team va usato con consapevolezza.

  • La regola di versione ^2.0 consente tutte le versioni all'interno della 2.x e non passa alla 3.0.
  • Condividete il file composer.lock; tutti i membri del team e il server installano le stesse versioni.
  • Non includete la cartella vendor in Git; aggiungetela a .gitignore.
bashComandi Composer più usati
# Create a new project file composer init # Add a package composer require guzzlehttp/guzzle # Package needed only for development composer require --dev phpunit/phpunit # Install according to the lock file composer install # Update versions composer update composer outdated # Remove a package and list packages composer remove guzzlehttp/guzzle composer show

Audit di sicurezza

Verificate se i pacchetti che usate hanno una vulnerabilità nota con il comando composer audit. Il comando confronta le versioni nel file lock con i database aperti ed elenca i pacchetti interessati. Eseguire questo controllo dopo ogni aggiornamento e a intervalli regolari evita che una libreria obsoleta metta a rischio il vostro sito.

bash
composer audit

Script di Composer

Potete scrivere i comandi che usi più spesso nel campo scripts di composer.json, per esempio uno script test che avvia i test. Questi script si eseguono con composer run-script test o più semplicemente con composer test. In questo modo tutto il team usa lo stesso comando con gli stessi parametri e chi arriva nel progetto vede subito come viene testato.

Autoloading PSR-4

Usa Composer non solo per i pacchetti esterni, ma anche per organizzare il vostro codice. Nello standard PSR-4 ogni namespace corrisponde a una cartella; per esempio la classe App\Servis\Fatura si trova nel file src/Servis/Fatura.php.

Dopo aver aggiunto l’impostazione a composer.json, esegui il comando composer dump-autoload. Da quel momento vi basta includere vendor/autoload.php nel file di ingresso del progetto.

jsoncomposer.json (sezione 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

Installazione su un server di produzione

Un server di produzione non ha bisogno dei pacchetti di sviluppo e ottimizzare l’autoloader fa risparmiare tempo a ogni richiesta. Usa il comando qui sotto durante il deployment: --no-dev esclude gli strumenti di test e --optimize-autoloader costruisce in anticipo la mappa delle classi.

Questa piccola impostazione ha un effetto positivo sul tempo di risposta, soprattutto nei progetti con molte classi. Interventi lato server come questo rientrano nel nostro lavoro di gestione di velocità e prestazioni.

Prima del deployment è una buona abitudine eseguire in locale anche composer validate: controlla la presenza di errori di battitura in composer.json e che il file lock sia aggiornato. Così si riduce il rischio di trovarsi sul server con un’installazione a metà.

  • La versione di PHP sul server deve rispettare la regola php indicata in composer.json.
  • Se in locale usi una versione di PHP diversa, potete simulare quella del server con l’impostazione config.platform.php in composer.json.
  • Per far coincidere esattamente gli ambienti, un’opzione è anche eseguire PHP in un container; vedi la guida all’installazione di Docker.
bashInstallazione in produzione
composer install --no-dev --optimize-autoloader

Errori comuni e soluzioni

La maggior parte degli errori di Composer deriva da estensioni PHP mancanti, da una versione di PHP incompatibile e dai limiti di memoria. Il comando composer diagnose rileva da solo molti problemi.

  • Comando php non riconosciuto: la cartella di PHP non è nel PATH; aggiungila e riapri il terminale.
  • Estensione openssl mancante: abilita la riga extension=openssl in php.ini; con php --ini verifica di modificare il file php.ini giusto.
  • Estensione zip e comando unzip mancanti: su Windows abilita la riga extension=zip, su Linux installa i pacchetti php-zip e unzip.
  • Your requirements could not be resolved: il pacchetto non supporta la versione di PHP installata o la versione di un altro pacchetto. Leggi il requisito nel testo dell’errore e scegli di conseguenza la versione di PHP o del pacchetto.
  • Allowed memory size exhausted: esegui il comando come COMPOSER_MEMORY_LIMIT=-1 composer update oppure aumenta il valore di memory_limit in php.ini.

I prossimi passi con Composer

La maggior parte dei progetti PHP lavora con un database. Prima di collegare un livello database installato con Composer, potete preparare il vostro server locale con la nostra guida all’installazione di MySQL. Per altri contenuti su PHP consulta la pagina del tag php.

Una gestione delle dipendenze impostata correttamente permette di aggiornare in sicurezza nel corso degli anni un sito aziendale o un progetto di integrazione con servizi di pagamento e spedizione. Anche l’infrastruttura e-commerce di Aurora Yazılım è realizzata senza temi già pronti, con un design unico per ogni azienda.

Domande frequenti

01Devo installare Composer separatamente per ogni progetto?

No. Composer si installa una sola volta, a livello globale, sul vostro computer. Ogni progetto ha il proprio composer.json e la propria cartella vendor; i pacchetti vengono installati separatamente da un progetto all’altro. Poiché Composer conserva in una cache i pacchetti scaricati, nel secondo progetto l’installazione termina più in fretta.

02Qual è la differenza tra composer install e composer update?

composer install installa le versioni esatte indicate nel file composer.lock e non modifica il file lock. composer update cerca versioni più recenti in base alle regole di versione e aggiorna il file lock; per questo sui server si usa install.

03Posso usare Composer su un hosting condiviso?

Se il vostro provider di hosting offre l’accesso SSH, spesso sì. Se l’SSH non c’è, una soluzione è installare le dipendenze in locale con composer install --no-dev e caricare la cartella vendor tramite trasferimento file; assicurati che le versioni di PHP siano compatibili.

Una volta installato PHP con le estensioni giuste e aggiunto Composer al PATH, potete gestire le dipendenze in pochi minuti con composer install e costruire una struttura di codice ordinata con PSR-4. Se desideri un sistema basato su PHP o un’applicazione web su misura per la vostra attività, scopri le soluzioni software personalizzate di Aurora Yazılım oppure contattaci.