Accediendo a variables globales en el marco del trabajo Laravel
El uso adecuado de variables globales es esencial para que un proyecto sea mantenido de manera eficaz. En el contexto de un proyecto desarrollado con Laravel, es importante conocer las prácticas recomendadas para definir, acceder y modificar estas variables de entorno o datos de configuración compartidos.
Las variable globales en Laravel suelen almacenarse en archivos de configuración dentro de la carpeta ‘config’ o como variables de entorno en el archivo ‘.env’. Estos valores pueden incluir información sensible, como las credenciales de acceso a la base de datos, APIs, entre otros.
Cómo definir una variable global en Laravel
Antes de entender cómo se llaman las variables de entorno o global, es necesario saber cómo definirla. Para crear una nueva variable global que pueda ser accesible a lo largo de toda la aplicación Laravel, se puede ubicar una clave y su correspondiente valor en el archivo .env. Por ejemplo:
APP_LOCALE=es
Este ejemplo incluye la definición de una variable de entorno llamada APP_LOCALE que define el idioma por defecto de la aplicación.
Además, se pueden crear archivos de configuración dentro del directorio ‘config’. Por ejemplo, si se desea almacenar variables globales relacionadas con una funcionalidad de la aplicación se crearía un archivo de configuración:
<?php
return [
'variable_personalizada' => env('VARIABLE_PERSONALIZADA', 'valorPorDefecto'),
];
En este caso, se utiliza la función env() de Laravel, la cual chequea si la misma clave que se le pasa como primer argumento existe en el archivo .env, si no existe, utilizará el valor por defecto que se pasa como segundo argumento.
Es primordial destacar aquí la importancia de no copiar directamente información sensible dentro de los archivos de código fuente, siempre deben referenciarse desde .env para una mayor seguridad.
Acceso a variables globales o de configuración
Una vez definidas, la variable global de Laravel puede ser llamada utilizando la función helper config(). Esta función accede al valor correspondiente a una clave definida en los archivos de configuración:
$locale = config('app.locale');
El código anterior hará la búsqueda de una clave ‘locale’ dentro del archivo ‘config/app.php’. Asimismo, si la variable fue definida en .env, se podría acceder a ella de similar manera:
$localeDesdeEnv = env('APP_LOCALE');
La función env() obtiene el valor de la variable global directamente desde el archivo .env, lo que es útil en escenarios donde aún no está disponible la configuración cargada o durante el arranque temprano de la aplicación.
Resulta muy importante conocer la diferencia entre el uso de config() y env(). Mientras que config() es la forma recomendada para acceder a las variables durante la ejecución de tu aplicación, la función env() está pensada para usarse primordialmente dentro de los archivos de configuración.
Modificación de variables globales de Laravel
En algunos escenarios, puede ser necesario modificar el valor de las variables globales. Por supuesto, los valores almacenados en el archivo .env no deben ser modificados en tiempo de ejecución, ya que estos son normalmente parte de la configuración del entorno y no deberían cambiar. Sin embargo, se puede cambiar una configuración de la aplicación en tiempo de ejecución utilizando el método config():
config(['app.locale' => 'en']);
Aquí se está cambiando el valor de la configuración ‘locale’ del archivo ‘app’. Es importante tener en cuenta que estos cambios son temporales y estarán vigentes solo durante la petición actual o ejecución del script.
Modificar estas variables globales dinámicamente debe hacerse con sumo cuidado y solo en circunstancias donde sea absolutamente necesario, ya que modifica la configuración global del entorno dejándolo en un estado impredecible.
Buenas prácticas al manejar variables globales en Laravel
Cuidar la integridad y estructura de las variables de configuración es vital para la sustentabilidad de los proyectos de software. Algunas recomendaciones son:
- Evitar el uso abusivo de las variables de entorno. Estas están pensadas para definir el comportamiento de la aplicación bajo diferentes entornos, no para controlar la lógica de negocio o estados durante la ejecución.
- Las variables globales deberían ser inmutables durante la ejecución, cambios dinámicos podrían complicar el rastreo de errores y comportamientos inesperados.
- Para datos que pueden variar con seguridad y no forman parte de la configuración de entornos, es recomendable usar otros mecanismos como bases de datos, caché, o el almacenamiento de sesiones.
- Asegurarse de no exponer datos sensibles. El archivo .env y los valores de configuración no deben ser accesibles desde el cliente o incluidos en el control de versión.