Guida Tutorial - Come gestire le dipendenze con Composer

Introduzione

Composer è un software libero per la gestione delle dipendenze in PHP, scritto in PHP, che permette di installare e aggiornare le librerie esterne in modo molto semplice. Composer crea una cartella "vendor" all'interno della cartella principale del progetto, non richiedendo alcuna installazione di sistema.

La gestione delle dipendenze è una parte essenziale di qualsiasi progetto di sviluppo software e Composer è uno strumento popolare che semplifica il processo di gestione delle dipendenze in PHP. Questa guida fornirà un approfondimento su come utilizzare Composer per gestire le dipendenze in un progetto PHP.Annuncio

Installare composer

Innanzitutto, dovrai installare Composer sul tuo sistema. Questo in genere può essere fatto scaricando il programma di installazione di Composer dal sito Web ufficiale ( https://getcomposer.org/download/ ) o semplicemente eseguendo i seguenti comandi sul tuo sistema:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" 

Una volta installato, puoi eseguire il comando composer nel tuo terminale:

composer 

Gestire i pacchetti con Composer

Installare i pacchetti

Una volta installato Composer, puoi usarlo per installare i pacchetti per i tuoi progetti PHP. Per installare un pacchetto, puoi utilizzare il comando composer require seguito dal nome e dalla versione del pacchetto. Ad esempio, per installare la versione 2.0 del pacchetto "mypackage" , eseguire il seguente comando:

# Syntax
composer require mypackage

Questo comando aggiungerà il pacchetto alle dipendenze del tuo progetto e lo scaricherà nella cartella del fornitore . Ad esempio, per installare l'ultimo pacchetto phpunit/phpunit, digitare:

composer require phpunit/phpunit 

È inoltre possibile definire la versione specifica del pacchetto da installare:

composer require phpunit/phpunit=9.5.28 

Il compositore consente inoltre di installare un pacchetto da un repository specifico specificando l'URL del repository dopo il nome del pacchetto:

composer require mypackage:2.0 git://github.com/myuser/mypackage.git  

Rimuovere i pacchetti

Per rimuovere un pacchetto dal tuo progetto, puoi utilizzare il comando composer remove seguito dal nome del pacchetto. Ad esempio, per rimuovere il pacchetto "mypackage", dovresti eseguire il seguente comando:

# Syntax
composer remove mypackage

Questo comando rimuoverà il pacchetto dalle dipendenze del tuo progetto e lo eliminerà dalla cartella vendor.

Aggiornare i pacchetti

Se devi aggiornare un pacchetto all'ultima versione, puoi usare il comando composer update seguito dal nome del pacchetto. Ad esempio, per aggiornare il pacchetto "mypackage" all'ultima versione, dovresti eseguire il seguente comando:

# Syntax
composer update mypackage

Questo comando aggiornerà il pacchetto all'ultima versione, come specificato nel file composer.json.

Puoi anche aggiornare tutti i pacchetti nel tuo progetto eseguendo il comando composer update senza specificare un nome di pacchetto.

È importante notare che quando installi o aggiorni i pacchetti utilizzando Composer, potrebbe anche installare o aggiornare altri pacchetti da cui dipende il pacchetto che stai installando o aggiornando. Questa è nota come catena di dipendenza ed è importante esserne consapevoli durante l'installazione o l'aggiornamento dei pacchetti.

Usare composer.json

Successivamente, dovrai creare un file composer.json alla radice del tuo progetto. Questo file conterrà le dipendenze per il tuo progetto, insieme a eventuali opzioni di configurazione aggiuntive. La struttura di base del file composer.json è simile alla seguente:

{
    "require": {
        "package/name": "version"
    }
}

Ad esempio, per richiedere la versione 2.0 del pacchetto denominato "mypackage", il file composer.json avrà il seguente aspetto:

{
    "require": {
        "mypackage": "2.0"
    }
}

Una volta creato il file composer.json , puoi usare il comando composer install per installare le dipendenze per il tuo progetto. Questo comando esaminerà il file composer.json e scaricherà e installerà i pacchetti specificati e le relative dipendenze in una directory del fornitore.

Puoi anche utilizzare il comando composer update per aggiornare le tue dipendenze all'ultima versione. Questo comando esaminerà il file composer.json e aggiornerà tutti i pacchetti alla versione più recente o a una versione specifica, se specificata.

Gestire la versione del pacchetto in base all'ambiente

Composer consente inoltre di specificare versioni diverse di un pacchetto per ambienti diversi. Ad esempio, è possibile specificare che un pacchetto deve essere della versione x in sviluppo e della versione y in produzione. Questo viene fatto utilizzando la chiave "require-dev" nel file composer.json:

{
    "require": {
        "mypackage": "2.0"
    },
    "require-dev": {
        "mypackage": "3.0"
    }
}

Composer fornisce anche un modo per caricare automaticamente le dipendenze, che viene eseguito creando un file di caricamento automatico utilizzando il comando  composer dump-autoload. Questo file di caricamento automatico viene utilizzato per caricare automaticamente le classi dalle dipendenze, quindi non è necessario includerle manualmente nel codice.

Trovare i pacchetti obsoleti

Infine, è importante tenere traccia delle dipendenze e delle relative versioni e assicurarsi che siano aggiornate. Composer fornisce il comando composer outdated che elenca i pacchetti con aggiornamenti disponibili e il comando composer show --outdated che mostra la versione installata e l'ultima versione disponibile. È importante verificare regolarmente la presenza di aggiornamenti e aggiornarli per garantire che l'applicazione utilizzi le versioni più recenti e più sicure delle dipendenze.

composer show --outdated  

Conclusione

In conclusione, Composer è un potente strumento per la gestione delle dipendenze nei progetti PHP. Fornisce un modo semplice ed elegante per gestire le dipendenze ed è uno strumento vitale per qualsiasi sviluppatore PHP. Con Composer puoi gestire facilmente versioni, dipendenze e caricamento automatico, risparmiando tempo e riducendo la complessità del tuo progetto. Inoltre, fornisce molte funzionalità e comandi per automatizzare e gestire le tue dipendenze, rendendolo uno strumento indispensabile per lo sviluppo PHP.