Installer CodeIgniter 4 avec Composer : prérequis et configuration

Avant de créer un projet CodeIgniter 4, vérifiez la version du framework et celle de PHP qu’elle prend en charge. La documentation actuelle exige PHP 8.2 ou plus pour les versions récentes. Un projet existant sous CodeIgniter 4.6 et PHP 8.1 demande une migration planifiée et testée. Composer et App Starter sont le point de départ habituel.

Vérifier PHP, extensions et Composer

Exécutez les commandes pour PHP en ligne de commande et celui du serveur web. intl et mbstring sont indispensables ; json fait partie de PHP moderne. Activez le pilote MySQL, curl ou gd/imagick selon les fonctions utilisées. Composer doit satisfaire les exigences du paquet. La compatibilité historique de certaines versions avec PHP 8.1 ne suffit pas pour une installation récente.

php -v
php -m
composer --version

Choisir la méthode

App Starter fournit le squelette et gère le framework dans vendor par Composer. Un téléchargement manuel officiel est possible sans Composer, mais les mises à jour nécessitent de lire les notes et comparer les fichiers du projet. Ne modifiez pas system ; gardez votre code dans app et suivez le guide de migration.

Créer le projet App Starter

Depuis le dossier parent, créez le projet puis lancez le serveur intégré uniquement pour le développement. Composer résout une version compatible avec les contraintes du paquet et votre PHP : vérifiez celle installée. Le serveur intégré ne remplace pas un serveur de production.

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

Comprendre les dossiers

app contient votre code, public est la seule racine web, writable reçoit journaux et cache, tests les tests et vendor les dépendances et le cœur du framework. Pointer le serveur vers la racine du projet risque d’exposer code et configuration. Dans une installation manuelle, system se trouve directement dans le projet.

Configurer .env

Copiez env en .env, puis renseignez app.baseURL, l’environnement et les identifiants seulement si vous utilisez une base. Vérifiez les clés de votre version. Gardez .env hors du dépôt et de public. En production, choisissez CI_ENVIRONMENT=production, une URL adaptée et des droits d’écriture limités.

cp env .env

Configurer le serveur web

Dirigez Apache DocumentRoot ou Nginx root vers project-root/public. php spark serve est destiné aux essais locaux. Vérifiez HTTPS, URL, droits de writable et l’impossibilité d’accéder à .env, app et vendor par HTTP.

Déployer et mettre à niveau

Conservez composer.lock et lancez composer install --no-dev sur le serveur pour installer les versions figées sans dépendances de développement. Utilisez composer update en développement pour modifier volontairement les versions, lisez le guide de migration, testez et déployez lockfile et adaptations de app/public. install et update ont des rôles différents.

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

Sources officielles

Prérequis : https://codeigniter4.github.io/CodeIgniter4/intro/requirements.html ; Composer : https://codeigniter4.github.io/CodeIgniter4/installation/installing_composer.html ; installation manuelle : https://codeigniter4.github.io/CodeIgniter4/installation/installing_manual.html .