@@ -63,9 +61,9 @@ Nette Database podporuje následující databáze:
Dva přístupy k databázi
=======================
-S Nette Database můžete pracovat dvěma způsoby - buď psaním SQL dotazů (Direct přístup), nebo nechat SQL generovat automaticky (Explorer přístup). Podívejme se, jak oba přístupy řeší stejné úkoly:
+Nette Database vám dává na výběr: můžete buď psát SQL dotazy přímo (SQL přístup), nebo je nechat generovat automaticky (Explorer). Podívejme se, jak oba přístupy řeší stejné úkoly:
-[Direct přístup|direct-sql] - SQL dotazy
+[SQL přístup|sql way] - SQL dotazy
```php
// vložení záznamu
@@ -127,7 +125,7 @@ foreach ($authors as $author) {
}
```
-Explorer přístup generuje a optimalizuje SQL dotazy automaticky. V uvedeném příkladu první přístup vygeneruje N+1 dotazů (jeden pro autory a pak jeden pro knihy každého autora), zatímco Explorer automaticky optimalizuje dotazy a provede pouze dva - jeden pro autory a jeden pro všechny jejich knihy.
+Explorer přístup generuje a optimalizuje SQL dotazy automaticky. V uvedeném příkladu SQL přístup vygeneruje N+1 dotazů (jeden pro autory a pak jeden pro knihy každého autora), zatímco Explorer automaticky optimalizuje dotazy a provede pouze dva - jeden pro autory a jeden pro všechny jejich knihy.
Oba přístupy lze v aplikaci libovolně kombinovat podle potřeby.
diff --git a/database/en/@left-menu.texy b/database/en/@left-menu.texy
index 6a9471fb6d..49af111f4b 100644
--- a/database/en/@left-menu.texy
+++ b/database/en/@left-menu.texy
@@ -1,7 +1,7 @@
Database
********
- [Getting Started |guide]
-- [Direct SQL]
+- [SQL Way]
- [Explorer]
- [Transactions]
- [Exceptions]
diff --git a/database/en/direct-sql.texy b/database/en/direct-sql.texy
index b0f683015b..1a54b91153 100644
--- a/database/en/direct-sql.texy
+++ b/database/en/direct-sql.texy
@@ -1,11 +1,11 @@
-Direct SQL
-**********
+SQL Way
+*******
.[perex]
-You can work with Nette Database in two ways: by writing SQL queries directly (Direct Access) or by letting SQL be generated automatically ([Explorer Access | explorer]). Direct Access allows you to safely build queries while keeping full control over their structure.
+You can work with Nette Database in two ways: by writing SQL queries (SQL way) or by letting SQL be generated automatically ([Explorer way |explorer]). SQL way allows you to safely build queries while keeping full control over their structure.
.[note]
-For information on creating a connection and configuring it, see the [separate page | guide#Connection and Configuration].
+See [Connection and Configuration |guide#Connection and Configuration] for details about database connection setup.
Basic Querying
diff --git a/database/en/explorer.texy b/database/en/explorer.texy
index 0916f57b63..d009ee418e 100644
--- a/database/en/explorer.texy
+++ b/database/en/explorer.texy
@@ -3,7 +3,7 @@ Database Explorer
-With Nette Database, you can work in two ways: either let SQL queries be generated automatically (Explorer approach) or write them yourself ([Direct access|direct-sql]). The Explorer significantly simplifies data access. It handles relationships between tables so you can focus on the logic of your application.
+Explorer offers an intuitive and efficient way to work with your database. It handles relationships between tables automatically, creates optimized queries, and lets you focus on your application logic. No configuration needed. For full control you can switch to the [SQL way].
- Working with data is natural and easy to understand
- Generates optimized SQL queries that fetch only the necessary data
@@ -12,7 +12,8 @@ With Nette Database, you can work in two ways: either let SQL queries be generat
-Working with the Explorer begins by calling the table() method on the [api:Nette\Database\Explorer] object (for information on creating connections and configuration, see the [dedicated page |guide#Connection and Configuration]):
+
+Working with the Explorer begins by calling the `table()` method on the [api:Nette\Database\Explorer] object (see [Connection and Configuration |guide#Connection and Configuration] for details about database connection setup):
```php
$books = $explorer->table('book'); // 'book' is the table name
diff --git a/database/en/guide.texy b/database/en/guide.texy
index 2b97f356b9..5fc9169e61 100644
--- a/database/en/guide.texy
+++ b/database/en/guide.texy
@@ -2,16 +2,14 @@ Nette Database
**************
.[perex]
-Nette Database is a powerful and elegant database layer for PHP, known for its simplicity and smart features. It requires no complex configuration or entity generation, allowing you to start working with it immediately.
-
-With Nette Database, you can work in two ways:
+Nette Database is a powerful and elegant database layer for PHP with a focus on simplicity and smart features. It offers two complementary ways to work with your data - using the [Explorer] for rapid development, or the [SQL way] for full control over queries.
-[Direct SQL]
-============
+[SQL way]
+=========
- Safe, parameterized queries
- Precise control over the structure of SQL queries
- Ideal for writing complex queries with advanced functions
@@ -22,8 +20,8 @@ With Nette Database, you can work in two ways:
-[Explorer]
-==========
+[Explorer way|explorer]
+=======================
- Fast development without writing SQL
- Intuitive handling of relationships between tables
- Automatic query optimization
@@ -63,9 +61,9 @@ Nette Database supports the following databases:
Two Approaches to Database Work
===============================
-With Nette Database, you can either write SQL queries directly (Direct approach) or let SQL be generated automatically (Explorer approach). Let’s see how both approaches solve the same tasks:
+With Nette Database, you can either write SQL queries directly (SQL way) or let SQL be generated automatically (Explorer way). Let’s see how both approaches solve the same tasks:
-[Direct Approach|direct-sql] - Writing SQL Queries
+[SQL way] - Writing SQL Queries
```php
// Insert a record
@@ -100,7 +98,7 @@ foreach ($result as $author) {
}
```
-[Explorer Approach|explorer] - Automatic SQL Generation
+[Explorer way|explorer] - Automatic SQL Generation
```php
// Insert a record
@@ -127,7 +125,7 @@ foreach ($authors as $author) {
}
```
-The Explorer approach generates and optimizes SQL queries automatically. In the example above, the Direct approach generates N+1 queries (one for authors and one for the books of each author), while the Explorer performs only two optimized queries—one for authors and another for all their books.
+The Explorer approach generates and optimizes SQL queries automatically. In the example above, the SQL way example generates N+1 queries (one for authors and one for the books of each author), while the Explorer performs only two optimized queries—one for authors and another for all their books.
You can freely combine both approaches in your application as needed.