Per creare un PDF, utilizzare la funzione “Stampa” in fondo alla pagina.
PHP Composer è un gestore di pacchetti per PHP che ti aiuta a integrare moduli di codice esterni (librerie) nei tuoi progetti. Composer si assicura automaticamente che tutti i programmi di background necessari per questi moduli (le cosiddette dipendenze) siano scaricati nella versione corretta.
In questa guida ti spieghiamo come scaricare e installare Composer sul tuo spazio web IONOS e come avviarlo per la prima volta.
Requisiti
- Hai già un pacchetto di web hosting IONOS con accesso SSH
Se il tuo pacchetto non supporta l'accesso SSH, puoi passare a un altro contratto di web hosting.
Note importanti sull'esecuzione dei comandi
Per poter utilizzare Composer sul tuo spazio web, devi eseguire gli script PHP tramite la riga di comando (PHP CLI). Prima di copiare i comandi contenuti in questa guida, è fondamentale osservare questi due punti:
1. La tua versione PHP attiva (IMPORTANTE)
I seguenti esempi di codice utilizzano X.X. Devi necessariamente sostituire X.X in tutti i comandi che contengono l'espressione phpX.X con la versione PHP che utilizzi per il tuo progetto web (ad esempio, php8.3 o php8.4).
Importante
Se utilizzi una versione sbagliata, Composer potrebbe scaricare blocchi di codice incompatibili che, nel peggiore dei casi, potrebbero causare malfunzionamenti del tuo sito web.
2. La data del tuo contratto
La struttura esatta del comando dipende anche da quando hai ordinato il tuo contratto di web hosting. Tutti i comandi di queste istruzioni sono quindi forniti in due varianti:
- Contratti fino al 17/09/2025: è necessaria l'aggiunta del suffisso -cli (esempio per PHP 8.4: php8.4-cli).
- Contratti dal 18/09/2025: non è necessario aggiungere il suffisso (esempio per PHP 8.4: php8.4).
Nota bene
Non utilizzare il semplice comando php senza un numero di versione, altrimenti lo script verrà eseguito con una versione PHP non aggiornata. Un elenco completo di tutte le versioni PHP disponibili si trova nell'articolo PHP-CLI: eseguire script PHP tramite riga di comando.
Guida passo-passo
Passo 1: stabilire la connessione SSH
Avvia il tuo client SSH e collegati al tuo spazio web. Le istruzioni per i vari sistemi operativi si trovano nella categoria Configurare e gestire l'accesso SSH del Centro Assistenza.
Suggerimento
Non appena viene stabilita la connessione, visualizzerai la finestra di input del tuo terminale. Per evitare errori di digitazione, è meglio copiare i comandi dalle caselle di codice seguenti e incollarli nel terminale. Premi il tasto Invio dopo ogni comando per eseguirlo.
Passo 2: preparare la directory di installazione
La directory in cui viene installato Composer dipende dal contratto.
Contratti fino al 17/09/2025:
Per i contratti più vecchi, la tua home directory(~) coincide con la directory htdocs. Questa serve da “document root”, ossia da directory principale del tuo sito web. Ciò significa che, in linea di principio, i file contenuti in questa directory sono accessibili a chiunque via Internet.
Per motivi di sicurezza, è quindi opportuno creare una sottodirectory separata per Composer e proteggerla da accessi esterni con un file .htaccess. Il comando seguente crea la cartella e blocca immediatamente l'accesso tramite browser web:
mkdir ~/composer
echo "Require all denied" > ~/composer/.htaccess
cd ~/composer
Importante
Senza il file .htaccess, composer.phar sarebbe potenzialmente accessibile tramite browser. Assicurati che il file .htaccess sia effettivamente presente nella directory.
Contratti dal 18/09/2025:
Per i contratti più recenti, la home directory non è accessibile al pubblico. Entra nella tua home directory:
cd ~
Passo 3: scaricare il file di installazione di Composer
Scarica il file di installazione dal sito ufficiale di Composer.
Contratti fino al 17/09/2025:
phpX.X-cli -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
Contratti dal 18/09/2025:
phpX.X -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
Passo 4: verificare il checksum (controllo di sicurezza)
Confronta il checksum (chiamato anche "impronta digitale") del file scaricato. Ciò garantisce che il file non sia stato danneggiato o manipolato durante il trasferimento e che si tratti del file originale. Poiché il checksum cambia a ogni aggiornamento, recuperiamo l'hash attuale in modo automatico dall'infrastruttura di Composer.
Esegui le due righe una dopo l'altra:
Contratti fino al 17/09/2025:
EXPECTED_CHECKSUM="$(phpX.X-cli -r 'copy("https://composer.github.io/installer.sig", "php://stdout");')"
phpX.X-cli -r "if (hash_file('sha384', 'composer-setup.php') === '$EXPECTED_CHECKSUM') { echo 'Installer Verified'; } else { echo 'Installer Corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
Contratti dal 18/09/2025:
EXPECTED_CHECKSUM="$(phpX.X -r 'copy("https://composer.github.io/installer.sig", "php://stdout");')"
phpX.X -r "if (hash_file('sha384', 'composer-setup.php') === '$EXPECTED_CHECKSUM') { echo 'Installer Verified'; } else { echo 'Installer Corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
Nota bene
Se nel terminale appare il messaggio Installer Verified il file è sicuro e si può procedere con l'installazione. Se appare Installer Corrupt, il file è stato eliminato automaticamente perché difettoso o compromesso. In questo caso, scarica nuovamente il file.
Passo 5: installare Composer
Esegui il file di installazione.
Contratti fino al 17/09/2025:
phpX.X-cli composer-setup.php
Contratti dal 18/09/2025:
phpX.X composer-setup.php
Dopo l'installazione, il file composer.phar si trova nella directory in cui ti sei spostato nel passaggio 2. L'estensione .phar sta per PHP Archive: puoi immaginarlo come un file di programma eseguibile per PHP.
Passo 6: rimuovere il file di installazione (pulizia)
Il file composer-setup.php non è più necessario. Per mantenere pulito il tuo spazio web, ti consigliamo di eliminarlo.
Contratti fino al 17/09/2025:
phpX.X-cli -r "unlink('composer-setup.php');"
Contratti dal 18/09/2025:
phpX.X -r "unlink('composer-setup.php');"
Passo 7: verificare l'installazione
Verifica l'installazione eseguendo direttamente Composer. Assicurarti di essere nella directory in cui si trova composer.phar (vedi il passo 2).
Contratti fino al 17/09/2025:
phpX.X-cli composer.phar
Contratti dal 18/09/2025:
phpX.X composer.phar
Come risultato, verrà visualizzata una panoramica di tutti i comandi Composer disponibili.
Passo 8: impostare un alias (scorciatoia) (opzionale)
Per evitare di dover sempre accedere a Composer con il percorso completo del file, puoi creare un cosiddetto alias. Si tratta di una scorciatoia personalizzata per la riga di comando.
Utilizza il seguente comando per inserire l'abbreviazione composer in modo permanente nel tuo file di configurazione personale (.bash_profile):
Contratti fino al 17/09/2025:
echo "alias composer='phpX.X-cli ~/composer/composer.phar'" >> ~/.bash_profile
Contratti dal 18/09/2025:
echo "alias composer='phpX.X ~/composer.phar'" >> ~/.bash_profile
Questo alias diventerà attivo automaticamente al tuo prossimo accesso SSH. Per attivarlo immediatamente nella finestra corrente, ricarica la configurazione con questo comando:
source ~/.bash_profile
Il comando composer è quindi sufficiente per avviare Composer da qualsiasi directory.
Controllare il risultato
L'installazione è riuscita se dopo l'esecuzione di Composer compare un elenco dei comandi disponibili e la versione di Composer installata.
Per mantenere aggiornato Composer, utilizza il comando di self-update. Se hai configurato l'alias come descritto al punto 8, puoi usare composer self-update. Altrimenti, esegui il comando direttamente nella directory di installazione:
Contratti fino al 17/09/2025:
phpX.X-cli composer.phar self-update
Contratti dal 18/09/2025:
phpX.X composer.phar self-update
Risoluzione dei problemi
Il terminale mostra il messaggio di errore "command not found" (o "comando non trovato")
Probabilmente hai copiato il comando alla lettera, includendo il segnaposto (ad esempio phpX.X-cli). Sostituisci la X.X nel comando con la versione PHP effettiva del tuo progetto web (ad esempio php8.2-cli o php8.4-cli) ed esegui nuovamente il comando.Il comando "composer" non è stato trovato
La scorciatoia composer è disponibile solo se hai configurato l'alias al punto 8. Utilizza il comando cat ~/.bash_profileper verificare se l'alias è stato inserito correttamente. Successivamente, accedi nuovamente tramite SSH o esegui source ~/.bash_profile per caricare le modifiche. Senza un alias, devi accedere a Composer direttamente tramite il comando PHP CLI e composer.phar (vedere il passaggio 8).Il checksum non corrisponde ("Installer Corrupt")
Il file scaricato era difettoso o compromesso ed è eliminato automaticamente. Esegui nuovamente i passi 3 (download) e 4 (verifica).Messaggi di errore PHP durante l'esecuzione di Composer
Assicurati di non aver accidentalmente utilizzato la versione PHP sbagliata nel comando. Devi specificare l'esatta versione PHP utilizzata dal tuo progetto web (vedi la sezione "Note importanti sull'esecuzione dei comandi"). Verifica inoltre di utilizzare il comando PHP CLI corretto per la data del tuo contratto(-cli per i contratti più vecchi).