Εργασία με το NEON
******************

<div class=perex>

Το NEON είναι μια γλώσσα σειριοποίησης δεδομένων κατανοητή από τον άνθρωπο. Χρησιμοποιείται στο Nette για αρχεία διαμόρφωσης. Η [api:Nette\Neon\Neon] είναι μια στατική κλάση για την εργασία με το NEON.

Εξοικειωθείτε με [τη μορφή NEON|format] και [δοκιμάστε την |https://ne-on.org].

</div>

Όλα τα παραδείγματα προϋποθέτουν τη δημιουργία ενός ψευδωνύμου:

```php
use Nette\Neon\Neon;
```


Εγκατάσταση
-----------

Μπορείτε να κατεβάσετε και να εγκαταστήσετε τη βιβλιοθήκη χρησιμοποιώντας το [Composer|best-practices:composer]:

```shell
composer require nette/neon
```

Μπορείτε να ελέγξετε για σφάλματα σύνταξης στα αρχεία `*.neon` χρησιμοποιώντας την εντολή κονσόλας `neon-lint`:

```shell
vendor/bin/neon-lint <path>
```


encode(mixed $value, bool $blockMode=false, string $indentation="\t"): string .[method]
---------------------------------------------------------------------------------------

Επιστρέφει το `$value` μετατραπέν σε NEON. Ως παράμετρο `$blockMode`, μπορείτε να περάσετε true, το οποίο θα δημιουργήσει έξοδο πολλαπλών γραμμών. Η παράμετρος `$indentation` καθορίζει τους χαρακτήρες που χρησιμοποιούνται για την εσοχή (η προεπιλογή είναι tab).

```php
Neon::encode($value); // Επιστρέφει το $value μετατραπέν σε NEON
Neon::encode($value, true); // Επιστρέφει το $value μετατραπέν σε NEON πολλαπλών γραμμών
```

Η μέθοδος `encode()` ρίχνει μια `Nette\Neon\Exception` σε περίπτωση σφάλματος.

```php
try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// χειρισμός εξαίρεσης
}
```


decode(string $neon): mixed .[method]
-------------------------------------

Μετατρέπει ένα string από NEON σε PHP.

Επιστρέφει scalars, arrays, [ημερομηνίες|format#datum] ως αντικείμενα DateTimeImmutable και [entities|format#entity] ως αντικείμενα [api:Nette\Neon\Entity].

```php
Neon::decode('hello: world'); // Επιστρέφει τον πίνακα ['hello' => 'world']
```

Η μέθοδος `decode()` ρίχνει μια `Nette\Neon\Exception` σε περίπτωση σφάλματος.

```php
try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// χειρισμός εξαίρεσης
}
```


decodeFile(string $file): mixed .[method]
-----------------------------------------

Μετατρέπει το περιεχόμενο ενός αρχείου από NEON σε PHP και αφαιρεί οποιοδήποτε BOM.

```php
Neon::decodeFile('config.neon');
```

Η μέθοδος `decodeFile()` ρίχνει μια `Nette\Neon\Exception` σε περίπτωση σφάλματος.


{{leftbar: utils:@left-menu}}