Yaconf::__debug_info

(PECL yaconf >= 1.1.0)

Yaconf::__debug_info — Inspecte la façon dont une valeur de configuration est stockée

Description

public static function Yaconf::__debug_info(string $name): ?array

Retourne des informations de débogage sur la valeur stockée sous name : l'adresse mémoire de la valeur stockée et si la valeur réside toujours dans le bloc de stockage compacté de Yaconf.

Avertissement

Cette méthode existe uniquement pour la suite de tests de Yaconf, qui l'utilise pour vérifier que l'extension fonctionne correctement. Ne pas l'utiliser dans du code de production, et ne pas se fier au format de sa sortie : le tableau retourné peut changer à tout moment.

Liste de paramètres

name: Le nom de configuration à inspecter, en utilisant la même notation pointée que Yaconf::get().

Valeurs de retour

Un tableau avec quatre entrées lorsque la configuration existe, null sinon :

key — le nom recherché.
address — l'adresse mémoire de la valeur stockée. Les valeurs sont stockées comme des chaînes internées ou des tableaux immuables, donc cette adresse reste constante jusqu'au rechargement de la configuration.
val — la valeur stockée elle-même.
changed — false tant que les données de la valeur résident dans le bloc de stockage compacté, ce qui signifie que le système d'exploitation n'a pas eu besoin de copier la page (la copie-sur-écriture s'applique toujours) ; true lorsque la valeur a été réallouée en dehors du bloc.

Exemples

Exemple #1 Exemple avec Yaconf::__debug_info()

<?php
// supposant que app.ini contient name="shop"
var_dump(Yaconf::__debug_info("app.name"));
/*
array(4) {
  ["key"]=>
  string(8) "app.name"
  ["address"]=>
  string(14) "0x7f8b1c0a3d20"
  ["val"]=>
  string(4) "shop"
  ["changed"]=>
  bool(false)
}
*/

var_dump(Yaconf::__debug_info("app.missing")); // NULL
?>

Voir aussi

Yaconf::get() - Récupère une valeur de configuration par son nom
Yaconf::has() - Vérifie si une valeur de configuration existe