CodeIgniter 4 nos proporciona la posibilidad de definir las rutas de nuestra aplicación a nuestra conveniencia haciendo uso de marcadores a la hora de especificar una ruta. Esto permite enviar y recibir parámetros a través de la URL de manera controlada y segura.
Tipos de Rutas en CodeIgniter 4
CodeIgniter 4 cuenta con dos tipos principales de enrutamiento:
Enrutamiento de Ruta Definida: Permite definir rutas específicas que están enlazadas a métodos de controladores.
Enrutamiento Automático: Permite que el sistema determine la ruta basada en los segmentos de la URL automáticamente.
En este tutorial, nos enfocaremos en el Enrutamiento de Ruta Definida y el uso de marcadores.
Definir Rutas con Marcadores
Para definir una ruta en CodeIgniter 4, usamos el archivo Routes.php ubicado en el directorio app/Config. Aquí podemos crear una instancia de la clase RouteCollection ($routes) y definir nuestras rutas con marcadores.
Micontrolador::miMetodo/$1 define el controlador y método que manejará la solicitud, pasando el parámetro capturado.
miruta es la vista a la que queremos acceder.
(:num) es un marcador que indica que el parámetro es un número entero.
Ejemplo Práctico
Paso 1: Crear el Controlador
En el directorio app/Controllers, creamos un archivo Micontrolador.php:
<?php
//usamos el espacio de nombre Controllers
namespace App\Controllers;
class Micontrolador extends BaseController
{
//creamos un metodo que recibira un parametro en este caso $parametro.
public function miMetodo($parametro)
{
//creamos un array $data con el parametro recibido.
$data['parametro']=$aparametro;
//retornamos nuestra vista junto al array $data que creamos.
return view('miVista',$data);
}
}
Paso 2: Crear la Vista
En el directorio app/Views, creamos un archivo miVista.php:
<!DOCTYPE html>
<html>
<head>
<title>CodeIgniter</title>
</head>
<body>
<h3>El parametro >
<?php
//imprimimos el parametro que recibimos desde nuestro controlador
echo $parametro;
?>
</h3>
</body>
</html>
public function miMetodo($p1,$p2)
{
//creamos un array $data con los dos parametros.
$data['p1']=$p1;
$data['p2']=$p2;
//retornamos nuestra vista junto al array $data que creamos.
return view('miVista',$data);
}
URL
http://localhost/ci/public/miruta/2/2
Tipos de Parámetros
Parámetros Alfabéticos
Pasar parámetro como cadena de caracteres alfabéticos seria de la siguiente forma
Es el marcador permite enviar múltiples parámetros y de distinto tipo a la vez, por ejemplo podríamos necesitar información de un producto por marca,color,tamaño de la siguiente forma
Podemos observar a la palabra producto como la ruta y lo que sigue después de la barra diagonal son los parámetros que recibirá el controlador abc/azul/mediano.
Por ejemplo crearemos una ruta que con el método :any procesaremos con nuestro controlador los parámetros recibidos para luego mostrarlos en la vista en el siguiente ejemplo.
Paso 1.
En nuestro controlador creamos el método showProducto()
<?php
namespace App\Controllers;
use CodeIgniter\Controller;
class Micontrolador extends BaseController
{
public function showProducto($marca=false,$color=false,$tamano=false)
{
//Retornamos nuestra vista.
$data['marca']=$marca;
$data['color']=$color;
$data['tamano']=$tamano;
return view('miVista',$data);
}
}
?>
Obtendremos en nuestro navegador el siguiente resultado
Podríamos escribir la url de esta forma y igual funcionaria porque el marcador :any permite el envió de múltiples parámetros a la vez podrían ser 1,2 o 3 parámetros, permitiendo ademas que sean de diferente tipo, por ejemplo alfabéticos, alfanuméricos o enteros.
http://localhost/ci/public/producto/abc/123/456
Como podemos observar cuando escribimos las url en nuestro navegador luego de la palabra producto enviamos 3 parámetros separados por una barra diagonal “/” los cuales recibe nuestro controlador en el método showProducto() retornando la vista y los parámetro que le brindamos a través de la url
Pero y si solo le enviamos 2 parámetros de la siguiente manera?
http://localhost/ci/public/producto/abc/azul/
Obtendríamos el siguiente resultado en el navegador,porque al definir los parámetros como false en el método showProducto() podemos enviar 1,2 o 3 parámetros y nuestra aplicación seguirá funcionando
Prueba al enviar solo un parámetro
http://localhost/ci/public/producto/abc/
El resultado seria el siguiente
Como podemos observar funciona aunque solo enviemos un parámetro.
Lista de Argumentos de Longitud Variable
Se puede pasar una lista de argumentos dinámica, siendo que necesitemos pasar un numero indeterminado de parámetros a nuestra función.
modificando el método showProducto() de la forma
<?php
namespace App\Controllers;
use CodeIgniter\Controller;
class Micontrolador extends BaseController
{
public function showProducto(...$parametros)
{
$data['parametros']=$parametros;
return view('miVista',$data);
}
}
?>
El enrutamiento es parte importante de una aplicación con CodeIgniter 4. ya que de esta manera el usuario tendrá acceso a las vistas con las vaya interactuar, donde envíe o obtenga información mediante una petición que se haya hecho usando la url en el navegador.
CodeIgniter 4 cuenta con dos tipos principales de enrutamiento:
Enrutamiento de Ruta Definida: Permite definir rutas que están enlazadas a un método específico de un controlador.
Enrutamiento Automático: Permite que el sistema determine la ruta automáticamente basado en los segmentos de la URL.
El enrutamiento de ruta definida es el que permite definir rutas que están enlazadas a un especifico método de un controlador,siendo este el tema principal de este tutorial sobre rutas en CodeIgniter 4.
Establecer reglas de enrutamiento
Un elemento crucial en el manejo de rutas en una aplicación con CodeIgniter es el archivo Routes.php, ubicado en el directorio app/Config. En este archivo se definen las rutas creando una instancia de la clase RouteCollection ($routes), permitiendo especificar criterios personalizados al crear una ruta. Podemos definir un nombre de ruta y parámetros que se pasen en la ruta utilizando marcadores de posición o expresiones regulares.
Al crear una ruta se debe especificar el método correspondiente de verbo HTTP por ejemplo GET o POST:
En la ruta definimos que el método a usar es ->get(GET) definiendo el nombre de la ruta como “inicio” que solicita al controlador Micontrolador y su método inicio definido como si se tratase de un método estático separando el nombre del controlador y el método por dos puntos dobles “::”.
Ejemplo practico
Paso 1. En el directorio app/Controllers de nuestra aplicación creamos un archivo Micontrolador.php, es importante recordar que la clase que contenga este archivo deberá ser llamada de la misma forma que el archivo .php y extendiendo de BaseController
<?php
namespace App\Controllers;
class Micontrolador extends BaseController
{
public function inicio()
{
return view('viewInicio');
}
}
?>
Paso 2. En el directorio app/Views creamos un archivo llamado viewInicio.php de la siguiente manera
Paso 3. Agregamos la siguiente linea a el archivo Routes.php ubicado en el directorio app\Config
$routes->get('inicio','Micontrolador::inicio');
Y listo nuestro primera ruta, solo colocamos en nuestro navegador la url de nuestra aplicación agregando la palabra “inicio” de manera que nos quede así http://localhost/ci/public/inicio obteniendo la vista que ah sido solicitada a través de la url.
Es muy importante al trabajar con CodeIgniter 4 comprender como se estructura de forma predeterminada nuestra aplicación en una instalación nueva.
Directorios predeterminados
luego de la Instalación de CodeIgniter 4 en la raíz de la aplicación nos encontraremos con 5 directorios, los cuales cuentan con un papel muy importante en nuestra aplicación que se estructuran de la siguiente forma.
App
El directorio App es donde reside todo el código necesario para la aplicación y cuenta con varios directorios en su interior, se estructura de la siguiente forma
Config/: directorio donde se almacenan todos los archivos de configuración esenciales para el correcto y optimo funcionamiento de la aplicación, por ejemplo los archivos App.php(archivo de configuración de la aplicación), Routes.php(archivo de configuración donde se establecen las rutas de la aplicación),Database.php(archivo de configuración donde se establece la base de datos o bases de datos a usar en la aplicación) se encuentran aquí.
Controllers/:Directorio donde se definen los controladores para la aplicación.
Database/:Almacena las migraciones de las bases de datos y los archivos semilla.
Filters/: Almacena las clases filtros que pueden ejecutarse antes y después del los controladores.
Helpers/:Almacena una colección de helpers dicho de otra forma colección de funciones independientes que pueden facilitar el trabajo del desarrollador.
Language/:Almacena el soporte para idiomas de la aplicación.
Libraries/:Una colección de clases que puede utilizar para agregar funcionalidad a su aplicación. La biblioteca en sí no es una parte central de CodeIgniter y puede eliminarse o actualizarse según sea necesario.
Models/:Almacena los modelos que funcionan con la base de datos de la aplicación.
ThirdParty/:Almacena bibliotecas de terceros que se pueden utilizar en la aplicación.
Views/: Almacena las vistas con las que interactúa el usuario.
System
Este directorio almacena los archivos que componen el propio marco del framework, si bien tiene mucha flexibilidad en cómo usa el directorio de la aplicación, los archivos en el directorio del sistema nunca deben modificarse. En su lugar tiene que ampliar las clases o crear nuevas clases para proporcionar la funcionalidad deseada.
Public
La carpeta pública contiene la parte de su aplicación web accesible al navegador, lo que impide el acceso directo a su código fuente. Contiene el archivo .htaccess principal, index.php , y cualquier recurso de aplicación que agregue, como CSS, JavaScript o imágenes.
Esta carpeta está destinada a ser la «raíz web» de su sitio y su servidor web estaría configurado para apuntar a ella.
Writable
Este directorio contiene todos los directorios necesarios para escribir durante la vida de una aplicación. Esto incluye directorios para almacenar archivos de caché, registros y cualquier carga que un usuario pueda enviar. Debe agregar aquí cualquier otro directorio en el que su aplicación deba escribir. Esto le permite mantener sus otros directorios principales sin escritura como medida de seguridad adicional.
Tests
Este directorio está configurado para contener sus archivos de prueba. el directorio _support contiene varias clases simuladas y otras utilidades que puede utilizar mientras escribe sus pruebas. No es necesario transferir este directorio a sus servidores de producción.
CodeIgniter 4 es framework MVC que sigue el patrón de arquitectura Modelo-Vista-Controlador (MVC), lo que significa que separa la lógica de la aplicación en tres componentes principales: el Modelo (la capa de acceso a datos), la Vista (la capa de presentación) y el Controlador (la capa de lógica de negocio). ademas a diferencia de otros frameworks MVC más robustos, Por lo tanto CodeIgniter es conocido por ser ligero y flexible, lo que lo hace ideal para proyectos pequeños y medianos donde la simplicidad y el rendimiento son prioritarios.
Principales características
Instalación y Configuración Sencillas: CodeIgniter es fácil de instalar y configurar. No requiere de una estructura de directorios complicada ni de una configuración tediosa. Simplemente descargas los archivos, configuras una vez tu archivo de configuración y estás listo para empezar a desarrollar.
Librerías y Helpers Incorporados: CodeIgniter proporciona una serie de librerías y helpers integrados que facilitan tareas comunes como el manejo de formularios, la validación de datos, el envío de correos electrónicos, el manejo de sesiones, la manipulación de imágenes, entre otros. Esto permite a los desarrolladores ser más productivos y escribir menos código repetitivo.
Seguridad Incorporada: La seguridad es una preocupación importante en cualquier aplicación web. CodeIgniter incluye características de seguridad integradas, como la protección contra ataques de tipo XSS (Cross-Site Scripting) y CSRF (Cross-Site Request Forgery), así como herramientas para la validación de formularios y la protección de datos sensibles.
Documentación Completa y Activa Comunidad: CodeIgniter cuenta con una documentación completa y bien estructurada que facilita el aprendizaje y la referencia para los desarrolladores. Además, tiene una comunidad activa que proporciona soporte, comparte recursos y contribuye con extensiones y mejoras al framework.
Flexibilidad y extensibilidad: Aunque CodeIgniter viene con muchas características útiles fuera de la caja, también es altamente extensible. Los desarrolladores pueden integrar fácilmente bibliotecas de terceros o crear sus propias extensiones para adaptarse a las necesidades específicas de sus proyectos.
Ejemplo Hola Mundo
Paso 1. Creamos nuestra vista, nos dirigimos a el directorio de nuestro proyecto hasta la el directorio app/Views que es donde se almacenan todas las vistas de nuestros proyectos como y creamos la un archivo holaMundo.php.
Paso 2. Creamos nuestro controlador, debemos recordar que el controlador es quien decide por así decirlo la acción que nuestra aplicación ejecutara según la petición del usuario, estos los crearemos en el directorio app/Controllers, creamos el archivo Micontrolador.php.
<?php
//usamos el espacio de nombre controllers.
namespace App\Controllers;
//
use CodeIgniter\Controller;
/**
Creamos nuestra clase con el mismo nombre del archivo Micontrolador.php y
extenderemos del BaseController.
**/
class Micontrolador extends BaseController
{
//Creamos un método publico llamado holaMundo donde retornamos la vista holaMundo.php.
public function holaMundo()
{
//Retornamos nuestra vista.
return view('holaMundo');
}
}
Paso 3. Definimos nuestra ruta y para eso editaremos nuestro archivo Routes.php que se encuentra en el directorio app/config añadiendo la siguiente línea
$routes->get('hola','Micontrolador::holaMundo');
Nuestro archivo de Routes.php nos quedara de la forma
Listo ya tenemos nuestro hola mundo con CodeIgniter 4 nos dirigimos al navegador y escribimos la url de nuestro proyecto
http://localhost/ci/public/hola
Siendo nuestro resultado final este.
Conclusion
En resumen, CodeIgniter es una opción popular para desarrolladores de PHP que buscan un framework ligero, fácil de usar y altamente funcional para construir aplicaciones web rápidas, seguras y escalables. Su enfoque en la simplicidad y la eficiencia lo hace especialmente adecuado para proyectos de tamaño mediano y pequeño.
Uno de los primeros errores que puedes encontrar al trabajar con CodeIgniter en Linux es el mensaje: “Cache unable to write to «/var/www/html/ci/writable/cache/»”. Este problema es común para los nuevos usuarios de CodeIgniter en Linux, aunque no tanto en Windows.
¿Por qué ocurre este error?
La causa principal de este error son los permisos de directorios en Linux. Dependiendo de la distribución que uses (Ubuntu, Debian, Mint, Arch, Fedora), el servidor web puede tener diferentes nombres (por ejemplo, en Fedora se llama httpd en lugar de apache).
Como Solucionarlo?
La solución es otorgar permisos de escritura y lectura al usuario del servidor web para el directorio writable de el proyecto CodeIgniter.
pero que es el usuario del servidor web?
la respuesta es «una cuenta de usuario en el sistema operativo que se utiliza para ejecutar el servicio de apache. Este usuario tiene permisos específicos y limitados para garantizar la seguridad del servidor web».
necesitamos otorgarle permisos de escritura y lectura al usuario del servidor web, del el directorio writable de nuestro proyecto de CodeIgniter,para ello lo asignaremos como el propietario del directorio writable y le concederemos los permisos de escritura y lectura.
Asignar al www-data como propietario del directorio writable
Basta con ejecutar el siguiente comando en nuestra terminal de Linux.
El comando chmodsirve para cambiar los permisos de un archivo o carpeta. Para usarlo, solo tienes que decir qué permisos quieres y a qué archivo o archivos se los quieres cambiar.con el 755 como configuración de permisos El dueño de la carpeta puede hacer lo que quiera con ella. Los demás solo pueden ver lo que hay dentro, pero no pueden añadir ni borrar archivos. Este tipo de configuración es común para carpetas que quieres compartir con otros.