Conversione dei tipi

Nette Database converte automaticamente i valori restituiti dal database nei tipi PHP corrispondenti.

Data e ora

I dati temporali vengono convertiti in oggetti Nette\Utils\DateTime. Se si desidera che i dati temporali vengano convertiti in oggetti immutabili Nette\Database\DateTime, impostare l'opzione newDateTime su true nella configurazione.

$row = $database->fetch('SELECT created_at FROM articles');
echo $row->created_at instanceof DateTime; // true
echo $row->created_at->format('j. n. Y');

Nel caso di MySQL, il tipo di dati TIME viene convertito in oggetti DateInterval.

Valori booleani

I valori booleani vengono automaticamente convertiti in true o false. Per MySQL, TINYINT(1) viene convertito se impostiamo convertBoolean nella configurazione.

$row = $database->fetch('SELECT is_published FROM articles');
echo gettype($row->is_published); // 'boolean'

Valori numerici

I valori numerici vengono convertiti in int o float in base al tipo di colonna nel database:

$row = $database->fetch('SELECT id, price FROM products');
echo gettype($row->id);    // integer
echo gettype($row->price); // float

Normalizzazione personalizzata

Utilizzando il metodo setRowNormalizer(?callable $normalizer) è possibile impostare una funzione personalizzata per trasformare le righe dal database. Questo è utile, ad esempio, per la conversione automatica dei tipi di dati.

$database->setRowNormalizer(function(array $row, ResultSet $resultSet): array {
	// qui avviene la conversione dei tipi
	return $row;
});
versione: 4.0