Εργασία με το NEON
Το NEON είναι μια γλώσσα σειριοποίησης δεδομένων κατανοητή από τον άνθρωπο. Χρησιμοποιείται στο Nette για αρχεία διαμόρφωσης. Η Nette\Neon\Neon είναι μια στατική κλάση για την εργασία με το NEON.
Εξοικειωθείτε με τη μορφή NEON και δοκιμάστε την.
Όλα τα παραδείγματα προϋποθέτουν τη δημιουργία ενός ψευδωνύμου:
use Nette\Neon\Neon;
Εγκατάσταση
Μπορείτε να κατεβάσετε και να εγκαταστήσετε τη βιβλιοθήκη χρησιμοποιώντας το Composer:
composer require nette/neon
Μπορείτε να ελέγξετε για σφάλματα σύνταξης στα αρχεία *.neon
χρησιμοποιώντας την εντολή κονσόλας neon-lint
:
vendor/bin/neon-lint <path>
encode (mixed $value, bool $blockMode=false,
string $indentation="\t"
): string
Επιστρέφει το $value
μετατραπέν σε NEON. Ως παράμετρο $blockMode
,
μπορείτε να περάσετε true, το οποίο θα δημιουργήσει έξοδο πολλαπλών
γραμμών. Η παράμετρος $indentation
καθορίζει τους χαρακτήρες που
χρησιμοποιούνται για την εσοχή (η προεπιλογή είναι tab).
Neon::encode($value); // Returns $value converted to NEON
Neon::encode($value, true); // Returns $value converted to multi-line NEON
Η μέθοδος encode()
ρίχνει μια Nette\Neon\Exception
σε περίπτωση
σφάλματος.
try {
$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
// exception handling
}
decode (string $neon): mixed
Μετατρέπει ένα string από NEON σε PHP.
Επιστρέφει scalars, arrays, ημερομηνίες ως αντικείμενα DateTimeImmutable και entities ως αντικείμενα Nette\Neon\Entity.
Neon::decode('hello: world'); // Returns the array ['hello' => 'world']
Η μέθοδος decode()
ρίχνει μια Nette\Neon\Exception
σε περίπτωση
σφάλματος.
try {
$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
// exception handling
}
decodeFile (string $file): mixed
Μετατρέπει το περιεχόμενο ενός αρχείου από NEON σε PHP και αφαιρεί οποιοδήποτε BOM.
Neon::decodeFile('config.neon');
Η μέθοδος decodeFile()
ρίχνει μια Nette\Neon\Exception
σε περίπτωση
σφάλματος.