Installare CodeIgniter 4 con Composer: requisiti e configurazione

Per un nuovo progetto CodeIgniter 4, verifica prima la versione del framework e il PHP supportato. La documentazione corrente richiede PHP 8.2 o superiore per il framework recente; un progetto esistente con CodeIgniter 4.6 e PHP 8.1 non va aggiornato alla cieca, ma migrato con prove e guida di upgrade. Il metodo consigliato per creare una nuova applicazione è Composer con App Starter.

Verifica PHP, estensioni e Composer

Esegui i comandi sul PHP che userai per Composer e sul server web. Sono necessarie le estensioni intl e mbstring; json è parte della piattaforma PHP moderna. Per MySQL serve il driver pertinente, per HTTP curl e per immagini gd o imagick secondo la funzionalità usata. Composer deve essere compatibile con i requisiti del pacchetto scelto. Le soglie storiche di PHP 8.1 per vecchie release non sono un requisito valido per installare senza verifica il framework attuale.

php -v
php -m
composer --version

Scegli il metodo di installazione

Con Composer, App Starter gestisce la dipendenza del framework in vendor e offre la struttura iniziale. Il download manuale di un rilascio ufficiale è possibile se Composer non è disponibile, ma gli aggiornamenti richiedono di seguire il changelog e confrontare i file del progetto. Non modificare system: per una copia manuale segui le istruzioni di aggiornamento e conserva le personalizzazioni in app.

Crea il progetto con App Starter

Dalla directory che conterrà il progetto, crea lo scheletro e avvia il server integrato solo per sviluppo. L’ultima versione compatibile è risolta da Composer in base ai vincoli del pacchetto e del tuo PHP; controlla il risultato installato. Non eseguire il server di sviluppo come servizio pubblico di produzione.

composer create-project codeigniter4/appstarter project-root
cd project-root
php spark serve

Conosci le directory

app contiene l’applicazione, public è l’unica document root da esporre, writable raccoglie log e cache, tests contiene i test, vendor ospita le dipendenze e il core framework. Non puntare il web server alla radice del progetto: potresti esporre configurazione e codice. Se installi manualmente, il core system si trova nel progetto anziché in vendor.

Configura .env

Copia env in .env e imposta app.baseURL, l’ambiente e, solo se usi un database, le sue credenziali. Esamina le chiavi effettive nel file fornito dalla versione installata. Tieni .env fuori dal controllo versione e fuori da public. In produzione usa CI_ENVIRONMENT=production, un URL corretto e permessi scrivibili soltanto dove necessari.

cp env .env

Configura il web server

Imposta DocumentRoot per Apache o root per Nginx alla cartella project-root/public. La CLI php spark serve è utile per il test locale, non sostituisce una configurazione web server in produzione. Verifica URL, HTTPS, permessi della cartella writable e assenza di accesso HTTP a .env, app e vendor.

Distribuzione e aggiornamenti

Distribuisci anche composer.lock e, sul server, esegui composer install --no-dev per installare le versioni bloccate senza dipendenze di sviluppo. Per aggiornare una dipendenza usa composer update in un ambiente di sviluppo, leggi la guida di upgrade, esegui test e porta in produzione lockfile e modifiche ai file app/public necessari. composer install e composer update non hanno lo stesso scopo.

composer install --no-dev --prefer-dist --no-interaction

Riferimenti ufficiali

Requisiti: https://codeigniter4.github.io/CodeIgniter4/intro/requirements.html ; Composer: https://codeigniter4.github.io/CodeIgniter4/installation/installing_composer.html ; installazione manuale: https://codeigniter4.github.io/CodeIgniter4/installation/installing_manual.html .