Índice de contenido
CodeIgniter 4 es un framework de desarrollo web de código abierto, diseñado para facilitar el desarrollo rápido y ágil de aplicaciones web en PHP. A pesar de su reducido tamaño, ofrece una gran cantidad de funcionalidades y resulta ideal para dar los primeros pasos con frameworks en PHP. Si llegaste aquí desde el capítulo anterior, ya vimos cómo trabajar con la línea de comandos en CodeIgniter 4 con Spark.
En este capítulo veremos cómo está organizado un proyecto en CodeIgniter 4, explicando el propósito de cada carpeta y archivo más relevante. Conocer bien esta estructura desde el principio es fundamental: te ahorrará tiempo buscando dónde poner cada cosa y te dará una visión clara del flujo del framework desde el primer día.
Carpeta app
Dentro de la carpeta app reside todo el código de tu aplicación, y es donde pasarás la mayor parte del tiempo de desarrollo. Viene con una estructura de subcarpetas predeterminada que funciona bien para la mayoría de los proyectos. Estas son las carpetas que la componen:
app/Config— Almacena todos los archivos de configuración del proyecto: base de datos, validaciones de formularios, correos electrónicos, filtros HTTP, rutas y mucho más. Cada aspecto del framework tiene su propio archivo de configuración en esta carpeta.app/Controllers— Los controladores determinan el flujo del programa y son uno de los tres pilares del patrón MVC. Su rol es recibir la petición HTTP, interactuar con el modelo si es necesario, y retornar la vista correspondiente al cliente.app/Database— Aquí se almacenan las migraciones de base de datos y los archivos de seeds (semillas). Las migraciones te permiten versionar la estructura de tu base de datos junto con el código, mientras que los seeds te facilitan poblarla con datos de prueba. Hablaremos de ambos en capítulos posteriores.app/Filters— Almacena clases de tipo filtro que se pueden ejecutar antes (before) o después (after) de los controladores. Son muy útiles para tareas transversales como autenticación, control de acceso o throttling de peticiones.app/Helpers— Archivos que contienen colecciones de funciones globales independientes y reutilizables. A diferencia de las clases, los helpers son simples funciones PHP que puedes llamar en cualquier parte de la aplicación sin necesidad de instanciar nada.app/Language— Aquí se definen los archivos de traducción para manejar múltiples idiomas en la aplicación. Cada idioma tiene su propia subcarpeta con los textos correspondientes.app/Libraries— Clases de utilidad específicas que no encajan en otra categoría. A diferencia de los helpers (funciones sueltas), las libraries son clases orientadas a objetos que puedes instanciar y reutilizar cuando necesitas lógica más estructurada.app/Models— Los modelos son clases que representan y gestionan la comunicación con la base de datos. Cada modelo suele corresponderse con una tabla, y a través de él defines la estructura de datos, las validaciones y las consultas. Es uno de los tres elementos del patrón MVC.app/ThirdParty— Carpeta reservada para bibliotecas de terceros que se integran manualmente en la aplicación (sin pasar por Composer).app/Views— Las vistas contienen el HTML que se muestra al cliente y representan la tercera capa del MVC. Son asignadas y renderizadas desde el controlador mediante el métodoreturn view('nombre_vista').
Carpeta system
Esta carpeta contiene el núcleo del framework: todas las clases base, librerías internas y funcionalidades sobre las que se construye CodeIgniter 4. Es la "maquinaria" interna del framework, por lo que los archivos dentro de system nunca deben modificarse directamente. Si lo haces, perderás esos cambios en cuanto actualices el framework.
En lugar de modificar esta carpeta, extiende la funcionalidad creando tus propios helpers en app/Helpers, nuevas clases en app/Libraries, o sobreescribiendo clases del core desde la carpeta app. Todos los archivos de system pertenecen al namespace CodeIgniter.
Carpeta public
La carpeta public es la única que debe ser accesible desde el navegador. Es la document root de tu servidor web, es decir, la carpeta a la que debe apuntar Apache o Nginx. Este diseño es intencional y representa una mejora de seguridad significativa respecto a CodeIgniter 3: al exponer solo esta carpeta, el resto del código fuente —incluyendo la configuración y las credenciales— queda completamente fuera del alcance del navegador.
Esta misma estrategia la adoptan otros frameworks modernos como Laravel, que también usa una carpeta public como raíz web. Dentro de ella encontrarás:
.htaccess— Reglas de reescritura de URLs para Apache (elimina elindex.phpde la URL).index.php— Punto de entrada de toda la aplicación.- Recursos estáticos: CSS, JavaScript, imágenes y cualquier archivo que necesite ser accesible directamente desde el navegador.
Configuración del servidor: Cuando despliegues tu aplicación, asegúrate de que el document root de tu servidor apunte a la carpeta
public/, y no a la raíz del proyecto. De lo contrario, expondrías archivos sensibles como.envo la carpetaapp/Config.
Otras carpetas importantes
Carpeta writable
Esta carpeta está diseñada para contener todos los archivos y directorios en los que la aplicación necesita escribir durante su ciclo de vida. Incluye:
writable/cache— Archivos de caché generados por el framework.writable/logs— Registros de errores y eventos de la aplicación.writable/uploads— Archivos subidos por los usuarios (u otra carpeta que definas para ello).writable/session— Datos de sesión cuando se usa el driver de archivos.
Mantener el resto de carpetas primarias (app, system) sin permisos de escritura es una medida de seguridad adicional que evita que un atacante pueda subir y ejecutar código malicioso en esas rutas.
Si subes imágenes a
writable/uploads, no serán visibles directamente desde el navegador, ya que solo la carpetapublic/es accesible. Más adelante veremos cómo gestionar correctamente los archivos subidos y servirlos al cliente.
Carpeta tests
Esta carpeta está configurada para albergar todos tus archivos de pruebas automatizadas. CodeIgniter 4 incluye soporte nativo para PHPUnit, por lo que puedes escribir pruebas unitarias y de integración desde el primer momento.
No es necesario desplegar esta carpeta en tus servidores de producción; solo es relevante en el entorno de desarrollo y en pipelines de integración continua (CI/CD).
Carpeta docs
Esta carpeta puede estar o no presente, dependiendo de cómo hayas obtenido el framework. Cuando existe, contiene una copia local de la guía oficial de usuario de CodeIgniter 4 en formato PDF; básicamente, es la documentación oficial del sitio web del framework empaquetada para consulta offline.
Archivos en la raíz del proyecto
Finalmente, en la raíz del proyecto encontrarás archivos de configuración globales que afectan al entorno de desarrollo y a la gestión de dependencias:
composer.json— Gestiona las dependencias PHP del proyecto y define la versión mínima requerida de PHP (8.1 o superior para CI4). Aquí también se configuran los namespaces de autoloading mediante PSR-4..env— Archivo de variables de entorno que permite configurar aspectos como el modo de la aplicación (CI_ENVIRONMENT), las credenciales de base de datos y otras claves sensibles sin hardcodearlas en el código. Por defecto viene renombrado comoenv(sin punto), por lo que deberás copiarlo y renombrarlo a.envantes de usarlo.spark— El ejecutable de la interfaz de línea de comandos de CodeIgniter 4. Se usa conphp spark [comando]para tareas como levantar el servidor de desarrollo, crear migraciones, generar controladores y mucho más.
Con esto ya tienes una visión clara y completa de cómo se organiza un proyecto en CodeIgniter 4. Entender esta estructura desde el principio te permitirá moverte con soltura por el framework y saber exactamente dónde vive cada pieza de tu aplicación.
Ahora, aprende a ejecutar tu aplicación de CodeIgniter 4 en el navegador.