nette/database 3.2.4

Author: dg

database/bg/configuration.texy

@@ -49,10 +49,10 @@ database:
 sqlmode: # (string)
 
 # само за MySQL: set SET NAMES
-charset: # (string) по подразбиране е 'utf8mb4' ('utf8' преди v5.5.3)
+charset: # (string) по подразбиране е 'utf8mb4'
 
 # само за MySQL: преобразува TINYINT(1) в bool
-supportBooleans: # (bool) по подразбиране е false
+convertBoolean: # (bool) по подразбиране е false
 
 # връща колони с дати като неизменни обекти (от версия 3.2.1)
 newDateTime: # (bool) по подразбиране е false

database/bg/core.texy

@@ -348,3 +348,95 @@ $id = $database->transaction(function ($database) {
 Както можете да видите, методът `transaction()` връща стойността на обратната връзка.
 
 Функцията Transaction() също може да бъде вложена, което опростява прилагането на независими хранилища.
+
+
+Отражение .[#toc-reflection]
+============================
+
+Nette Database предоставя инструменти за интроспекция на структурата на базата данни чрез класа [api:Nette\Database\Reflection]. Този клас ви позволява да извличате информация за таблици, колони, индекси и външни ключове. Можете да използвате отразяването, за да генерирате схеми, да създавате гъвкави приложения, които работят с бази данни, или да изграждате общи инструменти за бази данни.
+
+Можете да получите обект за отразяване от инстанция за връзка с база данни:
+
+```php
+$reflection = $database->getReflection();
+```
+
+
+Работа с таблици .[#toc-working-with-tables]
+--------------------------------------------
+
+С помощта на отразяването можете да правите итерации по всички таблици в базата данни:
+
+```php
+// Избройте имената на всички таблици
+foreach ($reflection->tables as $tableName => $table) {
+ echo $tableName . "\n";
+}
+
+// Проверете дали дадена таблица съществува
+if ($reflection->hasTable('users')) {
+ echo "The 'users' table exists";
+}
+
+// Извличане на определена таблица
+$table = $reflection->getTable('users');
+```
+
+
+Информация за колоната .[#toc-column-information]
+-------------------------------------------------
+
+За всяка таблица можете да получите подробна информация за нейните колони:
+
+```php
+// Итерация над всички колони
+foreach ($table->columns as $column) {
+ echo "Column: " . $column->name . "\n";
+ echo "Type: " . $column->nativeType . "\n";
+ echo "Nullable: " . ($column->nullable ? 'Yes': 'No') . "\n";
+ echo "Default value: " . ($column->default ?? 'None') . "\n";
+ echo "Primary key: " . ($column->primary ? 'Yes': 'No') . "\n";
+ echo "Auto-increment: " . ($column->autoIncrement ? 'Yes': 'No') . "\n";
+}
+
+// Извличане на конкретна колона
+$idColumn = $table->getColumn('id');
+```
+
+
+Индекси и първични ключове .[#toc-indexes-and-primary-keys]
+-----------------------------------------------------------
+
+Отражението предоставя информация за индексите и първичните ключове:
+
+```php
+$listColumnNames = fn(array $columns) => implode(', ', array_map(fn($col) => $col->name, $columns));
+
+// Списък на всички индекси
+foreach ($table->indexes as $index) {
+ echo "Index: " . ($index->name ?? 'Unnamed') . "\n";
+ echo "Columns: " . $listColumnNames($index->columns) . "\n";
+ echo "Unique: " . ($index->unique ? 'Yes': 'No') . "\n";
+ echo "Primary key: " . ($index->primary ? 'Yes': 'No') . "\n";
+}
+
+// Извличане на първичния ключ
+if ($table->primaryKey) {
+ echo "Primary key: " . $listColumnNames($table->primaryKey->columns) . "\n";
+}
+```
+
+
+Чужди ключове .[#toc-foreign-keys]
+----------------------------------
+
+Можете също така да получите информация за чуждите ключове:
+
+```php
+foreach ($table->foreignKeys as $fk) {
+ echo "Foreign key: " . ($fk->name ?? 'Unnamed') . "\n";
+ echo "Local columns: " . $listColumnNames($fk->localColumns) . "\n";
+ echo "References table: {$fk->foreignTable->name}\n";
+ echo "References columns: " . $listColumnNames($fk->foreignColumns) . "\n";
+}
+```

database/cs/configuration.texy

@@ -49,10 +49,10 @@ database:
 sqlmode: # (string)
 
 # pouze MySQL: nastaví SET NAMES
-charset: # (string) výchozí je 'utf8mb4' ('utf8' před verzí 5.5.3)
+charset: # (string) výchozí je 'utf8mb4'
 
 # pouze MySQL: převádí TINYINT(1) na bool
-supportBooleans: # (bool) výchozí je false
+convertBoolean: # (bool) výchozí je false
 
 # vrací sloupce s datem jako immutable objekty (od verze 3.2.1)
 newDateTime: # (bool) výchozí je false

database/cs/core.texy

@@ -348,3 +348,95 @@ $id = $database->transaction(function ($database) {
 Jak vidíte, metoda `transaction()` vrací návratovou hodnotu callbacku.
 
 Volání `transaction()` může být i zanořeno, což zjednodušuje implementaci nezávislých repozitářů.
+
+
+Reflexe .{data-version:3.2.1}
+=============================
+
+Nette Database poskytuje nástroje pro introspekci databázové struktury pomocí třídy [api:Nette\Database\Reflection]. Ta umožňuje získávat informace o tabulkách, sloupcích, indexech a cizích klíčích. Reflexi můžete využít ke generování schémat, vytváření flexibilních aplikací pracujících s databází nebo obecných databázových nástrojů.
+
+Objekt reflexe získáme z instance připojení k databázi:
+
+```php
+$reflection = $database->getReflection();
+```
+
+
+Práce s tabulkami
+-----------------
+
+Pomocí reflexe můžeme procházet všechny tabulky v databázi:
+
+```php
+// Výpis názvů všech tabulek
+foreach ($reflection->tables as $tableName => $table) {
+ echo $tableName . "\n";
+}
+
+// Ověření existence tabulky
+if ($reflection->hasTable('users')) {
+ echo "Tabulka users existuje";
+}
+
+// Získání konkrétní tabulky
+$table = $reflection->getTable('users');
+```
+
+
+Informace o sloupcích
+---------------------
+
+Pro každou tabulku můžeme získat detailní informace o jejích sloupcích:
+
+```php
+// Procházení všech sloupců
+foreach ($table->columns as $column) {
+ echo "Sloupec: " . $column->name . "\n";
+ echo "Typ: " . $column->nativeType . "\n";
+ echo "Může být NULL: " . ($column->nullable ? 'Ano' : 'Ne') . "\n";
+ echo "Výchozí hodnota: " . ($column->default ?? 'Není') . "\n";
+ echo "Je primární klíč: " . ($column->primary ? 'Ano' : 'Ne') . "\n";
+ echo "Je auto-increment: " . ($column->autoIncrement ? 'Ano' : 'Ne') . "\n";
+}
+
+// Získání konkrétního sloupce
+$idColumn = $table->getColumn('id');
+```
+
+
+Indexy a primární klíče
+-----------------------
+
+Reflection poskytuje informace o indexech a primárních klíčích:
+
+```php
+$vypisNazvySloupcu = fn(array $columns) => implode(', ', array_map(fn($col) => $col->name, $columns));
+
+// Výpis všech indexů
+foreach ($table->indexes as $index) {
+ echo "Index: " . ($index->name ?? 'Nepojmenovaný') . "\n";
+ echo "Sloupce: " . $vypisNazvySloupcu($index->columns) . "\n";
+ echo "Je unikátní: " . ($index->unique ? 'Ano' : 'Ne') . "\n";
+ echo "Je primární klíč: " . ($index->primary ? 'Ano' : 'Ne') . "\n";
+}
+
+// Získání primárního klíče
+if ($table->primaryKey) {
+ echo "Primární klíč: " . $vypisNazvySloupcu($table->primaryKey->columns) . "\n";
+}
+```
+
+
+Cizí klíče
+----------
+
+Můžeme také získat informace o cizích klíčích:
+
+```php
+foreach ($table->foreignKeys as $fk) {
+ echo "Cizí klíč: " . ($fk->name ?? 'Nepojmenovaný') . "\n";
+ echo "Lokální sloupce: " . $vypisNazvySloupcu($fk->localColumns) . "\n";
+ echo "Odkazuje na tabulku: {$fk->foreignTable->name}\n";
+ echo "Odkazuje na sloupce: " . $vypisNazvySloupcu($fk->foreignColumns) . "\n";
+}
+```

database/cs/explorer.texy

@@ -339,6 +339,7 @@ Database Explorer umí chytře escapovat parametry a identifikátory. Pro správ
 | `$row = $table->fetch()` | Vrátí další řádek výsledku
 | `$array = $table->fetchPairs($key, $value)` | Vrátí všechny výsledky jako asociativní pole
 | `$array = $table->fetchPairs($value)` | Vrátí všechny řádky jako asociativní pole
+| `$array = $table->fetchPairs($callable)` | Callback vrací `[$value]` nebo `[$key, $value]`
 | `count($table)` | Vrátí počet řádků výsledku
 
 

database/de/configuration.texy

@@ -49,10 +49,10 @@ database:
 sqlmode: # (string)
 
 # nur MySQL: setzt SET NAMES
-charset: # (string) Standardwert ist 'utf8mb4' ('utf8' vor v5.5.3)
+charset: # (string) Standardwert ist 'utf8mb4'
 
 # nur MySQL: wandelt TINYINT(1) in bool um
-supportBooleans: # (bool) standardmäßig false
+convertBoolean: # (bool) standardmäßig false
 
 # Gibt Datumsspalten als unveränderliche Objekte zurück (seit Version 3.2.1)
 newDateTime: # (bool) standardmäßig false

database/de/core.texy

@@ -348,3 +348,95 @@ $id = $database->transaction(function ($database) {
 Wie Sie sehen können, gibt die Methode `transaction()` den Rückgabewert des Callbacks zurück.
 
 Die Transaktion() kann auch verschachtelt werden, was die Implementierung unabhängiger Repositories vereinfacht.
+
+
+Reflexion .[#toc-reflection]
+============================
+
+Nette Database bietet mit der Klasse [api:Nette\Database\Reflection] Werkzeuge für die Introspektion der Datenbankstruktur. Mit dieser Klasse können Sie Informationen über Tabellen, Spalten, Indizes und Fremdschlüssel abrufen. Sie können Reflection verwenden, um Schemata zu generieren, flexible Anwendungen zu erstellen, die mit Datenbanken arbeiten, oder allgemeine Datenbank-Tools zu entwickeln.
+
+Sie können ein Reflection-Objekt von einer Datenbankverbindungsinstanz abrufen:
+
+```php
+$reflection = $database->getReflection();
+```
+
+
+Arbeiten mit Tabellen .[#toc-working-with-tables]
+-------------------------------------------------
+
+Mit Hilfe von Reflection können Sie über alle Tabellen in der Datenbank iterieren:
+
+```php
+// Auflisten der Namen aller Tabellen
+foreach ($reflection->tables as $tableName => $table) {
+ echo $tableName . "\n";
+}
+
+// Prüfen, ob eine Tabelle existiert
+if ($reflection->hasTable('users')) {
+ echo "The 'users' table exists";
+}
+
+// Abrufen einer bestimmten Tabelle
+$table = $reflection->getTable('users');
+```
+
+
+Informationen zur Säule .[#toc-column-information]
+--------------------------------------------------
+
+Für jede Tabelle können Sie detaillierte Informationen über ihre Spalten erhalten:
+
+```php
+// Iterieren über alle Spalten
+foreach ($table->columns as $column) {
+ echo "Column: " . $column->name . "\n";
+ echo "Type: " . $column->nativeType . "\n";
+ echo "Nullable: " . ($column->nullable ? 'Yes': 'No') . "\n";
+ echo "Default value: " . ($column->default ?? 'None') . "\n";
+ echo "Primary key: " . ($column->primary ? 'Yes': 'No') . "\n";
+ echo "Auto-increment: " . ($column->autoIncrement ? 'Yes': 'No') . "\n";
+}
+
+// Eine bestimmte Spalte abrufen
+$idColumn = $table->getColumn('id');
+```
+
+
+Indizes und Primärschlüssel .[#toc-indexes-and-primary-keys]
+------------------------------------------------------------
+
+Reflection bietet Informationen zu Indizes und Primärschlüsseln:
+
+```php
+$listColumnNames = fn(array $columns) => implode(', ', array_map(fn($col) => $col->name, $columns));
+
+// Alle Indizes auflisten
+foreach ($table->indexes as $index) {
+ echo "Index: " . ($index->name ?? 'Unnamed') . "\n";
+ echo "Columns: " . $listColumnNames($index->columns) . "\n";
+ echo "Unique: " . ($index->unique ? 'Yes': 'No') . "\n";
+ echo "Primary key: " . ($index->primary ? 'Yes': 'No') . "\n";
+}
+
+// Abrufen des Primärschlüssels
+if ($table->primaryKey) {
+ echo "Primary key: " . $listColumnNames($table->primaryKey->columns) . "\n";
+}
+```
+
+
+Ausländische Schlüssel .[#toc-foreign-keys]
+-------------------------------------------
+
+Sie können auch Informationen über Fremdschlüssel erhalten:
+
+```php
+foreach ($table->foreignKeys as $fk) {
+ echo "Foreign key: " . ($fk->name ?? 'Unnamed') . "\n";
+ echo "Local columns: " . $listColumnNames($fk->localColumns) . "\n";
+ echo "References table: {$fk->foreignTable->name}\n";
+ echo "References columns: " . $listColumnNames($fk->foreignColumns) . "\n";
+}
+```

database/el/configuration.texy

@@ -49,10 +49,10 @@ database:
 sqlmode: # (string)
 
 # μόνο MySQL: ορίζει SET NAMES
-charset: # (string) προεπιλογή 'utf8mb4' ('utf8' πριν την έκδοση v5.5.3)
+charset: # (string) προεπιλογή 'utf8mb4'
 
 # μόνο MySQL: μετατρέπει το TINYINT(1) σε bool
-supportBooleans: # (bool) προεπιλογή σε false
+convertBoolean: # (bool) προεπιλογή σε false
 
 # επιστρέφει τις στήλες ημερομηνίας ως αμετάβλητα αντικείμενα (από την έκδοση 3.2.1)
 newDateTime: # (bool) με προεπιλογή false