Configuración de parámetros base para un proyecto web en CodeIgniter 4

En este tutoriales prácticos instalaremos CodeIgniter 4, configuraremos algunas parámetros base para el proyecto web, pasaremos algunos parametros a la vista por defecto, finalmente indicaremos algunos puntos importantes para el reuso del proyecto:

Requisitos:

1. Apache 2.4.58 (Win64)
2. OpenSSL 3.1.3 
3. PHP 8.1.25
4. phpMyAdmin 5.2.1
5. CodeIgniter 4
6. XAMPP Control Panel v3.3.0
7. Visual Studio Code
8. HTML y CSS

Lo que veremos en este tutorial:

1. Creando proyectos con CodeIgniter 4
2. Configurando parámetros base del proyecto.
3. Pasando valores a la vista welcome_message.
4. Aplicando cambios para el reuso de los proyectos.
5. Conclusiones y referencias.

1. Creando proyectos con CodeIgniter 4.

La creación o instalación de los proyecto se ejecutarán de 2 formas; la primera será de forma Manualmente, es decir, se realizá la descarga desde la web oficial de CodeIgniter 4, la segunda forma será haciendo uso de Composer, se recomienda ya tener instalado Composer de lo contrario puede revisar el siguiente tutorial de Instalando Composer en Windows.

Primera forma para crear el proyecto:

1. Descargar CodeIgniter 4 del sitio oficial.
2. Descomprima el achivo zip en el directorio ..\xampp81\htdocs
3. Asigna el nombre de su preferencia (ci4_base_project_config)

Recordemos que el achivo zip también puedes descargar o clonar del repositorio de GitHub.

Segunda forma para crear el proyecto:

1. Desde linea de comandos del cmd ubica al directorio htdocs (C:\>cd C:\xampp\htdocs).
2. Ejecuta el siguiente comando composer desde el cmd (composer create-project codeigniter4/appstarter ci4_base_project_config_comp).

Recordemos que al aplicar componser el directorio system estará en el directorio vender (ci4_base_project_config_comp\vendor\codeigniter4\framework)

2. Configurando parámetros base del proyecto.

1. Configurando la url base ($baseURL) del proyecto (App.php).
2. Reemplazando la URI protocol ($uriProtocol) por defecto (App.php).
3. Reemplazando la time zone ($appTimezone) por defecto (App.php)
4. Copiando los achivos .htaccess y index.php (del directorio public a la raíz principal del proyecto).
5. Modificando el achivo index.php ('../app/Config/Paths.php' por 'app/Config/Paths.php') que se acaba de copiar.
6. Habilitando el achivo .env y configurando los parametros inciales.
1. Habilitar en entorno de trabajo CI1: CI_ENVIRONMENT = development
2. Asignar un nombre: system_name = 'Setting up CodeIgniter 4 website'
3. Asignar un nombre corto: short_name  = 'Setting up C4 website.'
4. Asignar la autoria: developer_name = 'hadsonpar'
5. Asignar la versión: system_version = '1.0.0'

3. Pasando valores a la vista welcome_message.

Para probar algunas funcionalidades de la configuración de parámetros, pasaremos algunas valores del achivo .env a la vista welcome_message:

1. Ubicamos el achivo welcome_message.php que se encuentra en el directorio Views de la raíz proyecto (..\Views\welcome_message.php ).
2. Ubicamos el bloque del div <div class="heroe"> y agregamos el siguiente código.

<h2><strong><?= env('system_name') ?> <?= env('system_version') ?>

by <a href="https://hadsonpar.com/" target="_blank"><?= env('developer_name') ?>

</a> </strong></h2>

3. Finalmente ejecutamos la aplicación para visualizar los valores de lo parámetros.

Los valores de los parámetros system_name, system_version y developer_name que se muestran en la vista.

4. Aplicando cambios para el reuso de los proyectos.

En caso de reuso o se necesita hacer uso del proyecto base se debe aplicar los siguientes cambios:

1. Modifica los paramétros del archivo App.php
1. public string $baseURL = 'http://localhost/projec_name/';
2. public string $appTimezone = 'UTC';
2. Modificar los paramétros del achivo .env
1. system_name = 'New projec name'
2. short_name  = 'Short new projec name.'
3. developer_name = 'hadsonpar'
3. Publica el nuevo proyecto o directorio en la raíz del servidor

En el caso que se realiza la publicación final del proyecto se debe modificar el parámetro CI_ENVIRONMENT de development a production que se encuentra en el achivo .env

5. Conclusiones.

En este tutorial práctico creamos nuestro proyectos manualmente y haciendo uso de composer, seguidamente configuramos nuestro parámetros necesarios para iniciar cualquier desarrollo web front-end, finalmente pasamos algunos valores a la vista welcome_message. Ambos proyectos son de gran utilidad al iniciar cualquier desarrollo web. 

5. Referencias.

• Extending the Controller
• Handling Multiple Environments

¡Que el hoy sea el presente, y que el mañana sea de nuevos retos para alcanzar el éxito!