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.

version: 3.x