Nette NEON
NEON est un langage de sérialisation de données facile à lire pour l'humain. Nette l'utilise pour les fichiers de configuration. Nette\Neon\Neon est une classe statique pour travailler avec NEON.
Faites connaissance avec le format NEON et essayez-le.
Tous les exemples supposent que l'alias suivant est défini :
use Nette\Neon\Neon;
Installation
Téléchargez et installez le paquet à l'aide de Composer :
composer require nette/neon
Vous pouvez vérifier les erreurs de syntaxe des fichiers *.neon avec la commande console
neon-lint :
vendor/bin/neon-lint [--debug] <path>
encode (mixed $value, bool $blockMode=false,
string $indentation="\t"): string
Renvoie $value converti en NEON. Vous pouvez passer true au paramètre $blockMode pour
obtenir une sortie sur plusieurs lignes. Le paramètre $indentation indique les caractères utilisés pour
l'indentation (par défaut la tabulation).
Neon::encode($value); // Returns $value converted to NEON
Neon::encode($value, true); // Returns $value converted to multiline NEON
En cas d'erreur, la méthode encode() lève Nette\Neon\Exception.
try {
$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
// Exception handling
}
decode (string $input): mixed
Convertit la chaîne NEON donnée en une valeur PHP.
Renvoie des scalaires, des tableaux, des dates sous forme d'objets DateTimeImmutable et des entités sous forme d'objets Nette\Neon\Entity.
Neon::decode('hello: world'); // Returns an array ['hello' => 'world']
En cas d'erreur, la méthode decode() lève Nette\Neon\Exception.
try {
$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
// Exception handling
}
decodeFile (string $file): mixed
Convertit le contenu d'un fichier de NEON vers PHP et supprime l'éventuel BOM.
Neon::decodeFile('config.neon');
En cas d'erreur, la méthode decodeFile() lève Nette\Neon\Exception.
Si vous passez à une version plus récente, consultez la page mise à niveau.