NEON ile Çalışma
NEON, verilerin serileştirilmesi için insan tarafından okunabilir bir dildir. Nette'de yapılandırma dosyaları için kullanılır. Nette\Neon\Neon, NEON ile çalışmak için statik bir sınıftır.
NEON biçimiyle tanışın ve onu deneyin.
Tüm örnekler, bir takma adın oluşturulduğunu varsayar:
use Nette\Neon\Neon;
Kurulum
Kütüphaneyi Composer aracını kullanarak indirip kurun:
composer require nette/neon
*.neon
dosyalarındaki sözdizimi hatalarını konsol komutu neon-lint
ile kontrol edebilirsiniz:
vendor/bin/neon-lint <path>
encode (mixed $value, bool $blockMode=false,
string $indentation="\t"
): string
NEON'a dönüştürülmüş $value
değerini döndürür. $blockMode
parametresi olarak true
iletebilirsiniz, bu da çok satırlı bir çıktı oluşturur. $indentation
parametresi, girinti için kullanılan
karakterleri belirtir (varsayılan sekmedir).
Neon::encode($value); // NEON'a dönüştürülmüş $value değerini döndürür
Neon::encode($value, true); // Çok satırlı NEON'a dönüştürülmüş $value değerini döndürür
encode()
metodu bir hata durumunda Nette\Neon\Exception
fırlatır.
try {
$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
// istisna işleme
}
decode (string $neon): mixed
Bir dizeyi NEON'dan PHP'ye dönüştürür.
Skalerleri, dizileri, tarihleri DateTimeImmutable nesneleri olarak ve varlıkları Nette\Neon\Entity nesneleri olarak döndürür.
Neon::decode('hello: world'); // ['hello' => 'world'] dizisini döndürür
decode()
metodu bir hata durumunda Nette\Neon\Exception
fırlatır.
try {
$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
// istisna işleme
}
decodeFile (string $file): mixed
Bir dosyanın içeriğini NEON'dan PHP'ye dönüştürür ve varsa BOM'u kaldırır.
Neon::decodeFile('config.neon');
decodeFile()
metodu bir hata durumunda Nette\Neon\Exception
fırlatır.