Instalar CodeIgniter 4 con Composer: requisitos y configuración

Antes de iniciar un proyecto CodeIgniter 4, comprueba la versión del framework y el PHP compatible. La documentación actual exige PHP 8.2 o posterior para versiones recientes. Un proyecto existente con CodeIgniter 4.6 y PHP 8.1 necesita una migración planificada y probada, no una actualización a ciegas. Composer con App Starter es la vía habitual para empezar.

Comprueba PHP, extensiones y Composer

Ejecuta los comandos tanto para el PHP de consola que utilizará Composer como para el del servidor web. intl y mbstring son obligatorias; json forma parte del PHP moderno. Activa el controlador MySQL, curl o gd/imagick según las funciones necesarias. Composer debe satisfacer los requisitos del paquete. El antiguo soporte para PHP 8.1 no es un requisito general para una instalación actual.

php -v
php -m
composer --version

Elige el método

App Starter aporta el esqueleto y gestiona el framework dentro de vendor mediante Composer. También se puede descargar una versión oficial manualmente, pero actualizarla requiere leer los cambios y comparar archivos del proyecto. No modifiques system: deja tu código en app y sigue la guía de actualización.

Crea App Starter

Desde la carpeta superior, crea el proyecto y utiliza el servidor integrado solo en desarrollo. Composer resuelve una versión compatible con las restricciones del paquete y tu PHP; comprueba cuál se instaló. El servidor de desarrollo no sustituye al servidor web de producción.

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

Conoce las carpetas

app contiene el código, public es la única raíz web, writable alberga registros y caché, tests contiene pruebas y vendor dependencias y núcleo. Apuntar el servidor a la raíz del proyecto puede exponer configuración y código. En instalación manual, system queda dentro del proyecto.

Configura .env

Copia env a .env y establece app.baseURL, el entorno y credenciales solo si usas una base de datos. Consulta las claves reales de la versión instalada. Mantén .env fuera del repositorio y de public. En producción usa CI_ENVIRONMENT=production, URL correcta y permisos de escritura mínimos.

cp env .env

Configura el servidor web

Apunta Apache DocumentRoot o Nginx root a project-root/public. php spark serve sirve para pruebas locales, no para producción. Comprueba HTTPS, URL, permisos de writable y que .env, app y vendor no sean accesibles por HTTP.

Despliega y actualiza

Conserva composer.lock y ejecuta composer install --no-dev en el servidor para instalar versiones fijadas sin dependencias de desarrollo. Usa composer update en desarrollo para cambiar versiones de forma deliberada, lee la guía de actualización, prueba y despliega el lockfile y los cambios necesarios en app/public. install y update cumplen funciones distintas.

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

Fuentes oficiales

Requisitos: https://codeigniter4.github.io/CodeIgniter4/intro/requirements.html ; Composer: https://codeigniter4.github.io/CodeIgniter4/installation/installing_composer.html ; instalación manual: https://codeigniter4.github.io/CodeIgniter4/installation/installing_manual.html .