Composer è il principale strumento per la gestione delle dipendenze nei progetti PHP. Permette di installare e aggiornare librerie, framework e pacchetti attraverso il file composer.json.

In questa guida vedremo come installare Composer globalmente su un server VPS Linux utilizzando una connessione SSH. Al termine della procedura sarà possibile eseguire il comando composer da qualsiasi cartella del server.

Requisiti necessari

Prima di iniziare, assicurati di avere:

• un server VPS Linux;
• accesso SSH al server;
• PHP CLI installato;
• un utente con permessi sudo;
• una connessione a Internet attiva sul server.

Le versioni recenti di Composer richiedono almeno PHP 7.2.5. Se il server utilizza una versione molto vecchia di PHP, potrebbe essere necessario installare Composer 2.2 LTS. È comunque consigliabile aggiornare PHP a una versione ancora supportata.

1. Collegarsi al VPS tramite SSH

Apri il terminale del computer e collegati al server utilizzando il seguente comando:

ssh utente@indirizzo-ip

Sostituisci utente con il nome dell’utente SSH e indirizzo-ip con l’indirizzo IP pubblico del VPS. Per esempio:

ssh root@192.0.2.10

Alla prima connessione potrebbe essere richiesto di confermare l’impronta digitale del server. Successivamente dovrai inserire la password oppure utilizzare la chiave SSH configurata.

2. Controllare la versione di PHP

Verifica che PHP sia disponibile anche da riga di comando:

php -v

Se PHP è correttamente installato, il terminale mostrerà la versione in uso. Puoi inoltre controllare dove si trova l’eseguibile:

which php

Se il comando php non viene riconosciuto, su Ubuntu o Debian puoi installare PHP CLI con:

sudo apt update
sudo apt install php-cli unzip -y

Su AlmaLinux, Rocky Linux o altre distribuzioni compatibili con RHEL, il comando può essere:

sudo dnf install php-cli unzip -y

3. Scaricare il programma di installazione di Composer

Spostati in una cartella temporanea o nella directory del tuo utente:

cd /tmp

Scarica quindi lo script ufficiale di Composer:

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

Il file composer-setup.php verrà salvato nella cartella corrente.

4. Verificare l’integrità dell’installer

Prima di eseguire uno script scaricato da Internet è buona norma verificarne l’integrità. I seguenti comandi recuperano automaticamente la firma SHA-384 pubblicata da Composer e la confrontano con quella del file scaricato:

EXPECTED_CHECKSUM="$(php -r 'copy("https://composer.github.io/installer.sig", "php://stdout");')"
ACTUAL_CHECKSUM="$(php -r "echo hash_file('sha384', 'composer-setup.php');")"

if [ "$EXPECTED_CHECKSUM" != "$ACTUAL_CHECKSUM" ]; then
    >&2 echo 'ERRORE: installer non valido'
    rm composer-setup.php
    exit 1
fi

echo 'Installer verificato correttamente'

Se compare il messaggio Installer verificato correttamente, puoi procedere. Evita di copiare da vecchie guide un checksum fisso, perché la firma dell’installer può cambiare nel tempo.

5. Installare Composer globalmente

Per rendere Composer disponibile da qualsiasi directory, installalo direttamente in /usr/local/bin con il nome composer:

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Se l’operazione viene completata correttamente, il terminale mostrerà un messaggio simile a:

Composer successfully installed to: /usr/local/bin/composer

Questa modalità evita di dover digitare ogni volta php composer.phar.

6. Eliminare il file temporaneo

Dopo l’installazione puoi rimuovere lo script di setup:

php -r "unlink('composer-setup.php');"

In alternativa:

rm composer-setup.php

7. Verificare l’installazione

Controlla che Composer sia disponibile globalmente:

composer --version

Puoi eseguire anche una diagnostica della configurazione:

composer diagnose

Se entrambi i comandi funzionano senza errori, l’installazione è terminata.

Installazione senza permessi root

Se non disponi di sudo, puoi installare Composer esclusivamente per il tuo utente:

mkdir -p "$HOME/.local/bin"
php composer-setup.php --install-dir="$HOME/.local/bin" --filename=composer

Se la cartella non è già inclusa nella variabile PATH, aggiungila:

export PATH="$HOME/.local/bin:$PATH"

Per rendere permanente la modifica, inserisci la stessa riga nel file ~/.bashrc oppure nel file di configurazione della shell utilizzata.

Come aggiornare Composer

Quando viene pubblicata una nuova versione stabile, Composer può essere aggiornato con:

sudo composer self-update

Se Composer è stato installato nella cartella personale, normalmente non è necessario utilizzare sudo:

composer self-update

Come utilizzare Composer in un progetto PHP

Raggiungi la cartella del progetto:

cd /var/www/miosito

Se il progetto contiene già un file composer.json, installa le dipendenze con:

composer install

Composer leggerà le dipendenze richieste e creerà la cartella vendor. Su un server di produzione è generalmente preferibile utilizzare:

composer install --no-dev --optimize-autoloader

Il parametro --no-dev esclude i pacchetti destinati allo sviluppo, mentre --optimize-autoloader ottimizza il caricamento delle classi.

Errori comuni durante l’installazione

Il comando php non viene trovato

PHP CLI non è installato oppure il suo percorso non è presente nel PATH. Installa il pacchetto php-cli previsto dalla distribuzione Linux.

Permission denied in /usr/local/bin

L’utente non dispone dei permessi necessari. Ripeti il comando con sudo oppure installa Composer in $HOME/.local/bin.

Estensioni PHP mancanti

Alcuni progetti richiedono estensioni come curl, mbstring, xml o zip. Su Ubuntu e Debian possono essere installate con:

sudo apt install php-curl php-mbstring php-xml php-zip -y

Non eseguire Composer come root

Per le normali operazioni di un progetto è preferibile utilizzare l’utente proprietario dei file del sito. L’esecuzione come root può generare problemi di sicurezza o assegnare permessi errati a file e cartelle.

Conclusione

Per installare Composer su un VPS occorre collegarsi tramite SSH, verificare PHP, scaricare e controllare l’installer ufficiale e installare l’eseguibile in /usr/local/bin/composer. Dopo la verifica con composer --version, il gestore delle dipendenze sarà utilizzabile da qualsiasi directory del server.

Per comandi e requisiti sempre aggiornati è consigliabile consultare la pagina ufficiale per il download di Composer e la documentazione ufficiale per Linux e Unix.