(PECL yaconf >= 1.0.0)
Yaconf::get — Recupera un valor de configuración por su nombre
Recupera el valor de configuración almacenado bajo
name. Los nombres emplean la notación de punto
para recorrer las claves anidadas: "app" hace
referencia al archivo app.ini analizado por
completo, "app.name" a una clave dentro de él y, desde
Yaconf 1.2.0, "users.database.master" a una clave del
archivo database.ini situado en el subdirectorio
users/. La notación de punto admite hasta 64 niveles
de anidamiento.
name
El nombre de configuración a buscar, empleando la notación de punto
para recorrer las claves anidadas, por ejemplo
"app.name", "app.features.1"
o, desde Yaconf 1.2.0, "users.database.master"
para los archivos en subdirectorios.
default
El valor a devolver cuando no se encuentra
name. Si se omite, se devuelve null.
El valor de configuración almacenado, un string o un
array, cuando name existe; en caso
contrario, default (o null si no se indicó
ningún valor por defecto).
Los ejemplos siguientes suponen los dos archivos mostrados a
continuación, situados en el directorio configurado con
yaconf.directory.
; app.ini name="shop" ; valor escalar debug=0 ; número features[]="checkout" ; entradas de array, ambas notaciones features.1="wishlist"
; users/database.ini, en un subdirectorio (Yaconf 1.2.0+) master="192.168.0.10" replica="192.168.0.20"
Ejemplo #1 Ejemplo de Yaconf::get()
<?php
// recupera un archivo analizado completo como un array
var_dump(Yaconf::get("app"));
// la notación de punto recorre las claves anidadas
var_dump(Yaconf::get("app.name")); // string(4) "shop"
var_dump(Yaconf::get("app.features.1")); // string(8) "wishlist"
// desde 1.2.0: los archivos en subdirectorios quedan bajo el espacio de
// nombres del nombre del directorio
var_dump(Yaconf::get("users.database.master")); // string(12) "192.168.0.10"
// cuando la clave no existe, se devuelve el valor por defecto
var_dump(Yaconf::get("app.missing")); // NULL
var_dump(Yaconf::get("app.missing", "fallback")); // string(8) "fallback"
?>