Struktúra reflexió

A Nette Database eszközöket biztosít az adatbázis struktúrájának introspekciójához a Nette\Database\Reflection osztály segítségével. Ez lehetővé teszi információk lekérését táblákról, oszlopokról, indexekről és idegen kulcsokról. A reflexiót használhatja sémák generálásához, rugalmas, adatbázissal dolgozó alkalmazások létrehozásához vagy általános adatbázis-eszközök készítéséhez.

A reflexiós objektumot az adatbázis-kapcsolat példányából kapjuk meg:

$reflection = $database->getReflection();

Táblák lekérése

A $reflection->tables readonly property tartalmazza az adatbázis összes táblájának asszociatív tömbjét:

// Az összes tábla nevének kiírása
foreach ($reflection->tables as $name => $table) {
	echo $name . "\n";
}

Két további metódus is rendelkezésre áll:

// Tábla létezésének ellenőrzése
if ($reflection->hasTable('users')) {
	echo "A users tábla létezik";
}

// Visszaadja a tábla objektumot; ha nem létezik, kivételt dob
$table = $reflection->getTable('users');

Információ a tábláról

A táblát egy Table objektum reprezentálja, amely a következő readonly property-ket biztosítja:

• $name: string – tábla neve
• $view: bool – hogy nézetről van-e szó
• $fullName: ?string – a tábla teljes neve, beleértve a sémát (ha létezik)
• $columns: array<string, Column> – a tábla oszlopainak asszociatív tömbje
• $indexes: Index[] – a tábla indexeinek tömbje
• $primaryKey: ?Index – a tábla elsődleges kulcsa vagy null
• $foreignKeys: ForeignKey[] – a tábla idegen kulcsainak tömbje

Oszlopok

A tábla columns property-je az oszlopok asszociatív tömbjét adja meg, ahol a kulcs az oszlop neve, az érték pedig egy Column példány a következő property-kkel:

• $name: string – oszlop neve
• $table: ?Table – referencia az oszlop táblájára
• $nativeType: string – natív adatbázis típus
• $size: ?int – a típus mérete/hossza
• $nullable: bool – hogy az oszlop tartalmazhat-e NULL-t
• $default: mixed – az oszlop alapértelmezett értéke
• $autoIncrement: bool – hogy az oszlop auto-increment-e
• $primary: bool – hogy része-e az elsődleges kulcsnak
• $vendor: array – további, az adott adatbázis-rendszerre specifikus metaadatok

foreach ($table->columns as $name => $column) {
	echo "Oszlop: $name\n";
	echo "Típus: {$column->nativeType}\n";
	echo "Nullable: " . ($column->nullable ? 'Igen' : 'Nem') . "\n";
}

Indexek

A tábla indexes property-je az indexek tömbjét adja meg, ahol minden index egy Index példány a következő property-kkel:

• $columns: Column[] – az indexet alkotó oszlopok tömbje
• $unique: bool – hogy az index egyedi-e
• $primary: bool – hogy elsődleges kulcsról van-e szó
• $name: ?string – az index neve

A tábla elsődleges kulcsát a primaryKey property segítségével lehet lekérni, amely vagy egy Index objektumot ad vissza, vagy null-t, ha a táblának nincs elsődleges kulcsa.

// Indexek kiírása
foreach ($table->indexes as $index) {
	$columns = implode(', ', array_map(fn($col) => $col->name, $index->columns));
	echo "Index" . ($index->name ? " {$index->name}" : '') . ":\n";
	echo "  Oszlopok: $columns\n";
	echo "  Unique: " . ($index->unique ? 'Igen' : 'Nem') . "\n";
}

// Elsődleges kulcs kiírása
if ($primaryKey = $table->primaryKey) {
	$columns = implode(', ', array_map(fn($col) => $col->name, $primaryKey->columns));
	echo "Elsődleges kulcs: $columns\n";
}

Idegen kulcsok

A tábla foreignKeys property-je az idegen kulcsok tömbjét adja meg, ahol minden idegen kulcs egy ForeignKey példány a következő property-kkel:

• $foreignTable: Table – a hivatkozott tábla
• $localColumns: Column[] – a helyi oszlopok tömbje
• $foreignColumns: Column[] – a hivatkozott oszlopok tömbje
• $name: ?string – az idegen kulcs neve

// Idegen kulcsok kiírása
foreach ($table->foreignKeys as $fk) {
	$localCols = implode(', ', array_map(fn($col) => $col->name, $fk->localColumns));
	$foreignCols = implode(', ', array_map(fn($col) => $col->name, $fk->foreignColumns));

	echo "FK" . ($fk->name ? " {$fk->name}" : '') . ":\n";
	echo "  $localCols -> {$fk->foreignTable->name}($foreignCols)\n";
}