Skip to content

Commit

Permalink
x
Browse files Browse the repository at this point in the history
  • Loading branch information
dg committed Dec 26, 2024
1 parent c0ac708 commit b4d54ed
Show file tree
Hide file tree
Showing 8 changed files with 29 additions and 31 deletions.
2 changes: 1 addition & 1 deletion database/cs/@left-menu.texy
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Databáze
********
- [Úvod |guide]
- [Direct SQL]
- [SQL přístup]
- [Explorer]
- [Transakce |transactions]
- [Výjimky |exceptions]
Expand Down
8 changes: 4 additions & 4 deletions database/cs/direct-sql.texy
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
Direct SQL
**********
SQL přístup
***********

.[perex]
S Nette Database můžete pracovat dvěma způsoby - buď přímo psát SQL dotazy (Direct přístup), nebo nechat SQL generovat automaticky ([Explorer přístup|explorer]). Direct přístup vám pomůže s bezpečným sestavováním dotazů, ale zachovává vám plnou kontrolu nad jejich podobou.
Nette Database nabízí dvě cesty: můžete psát SQL dotazy sami (SQL přístup), nebo je nechat generovat automaticky (viz [Explorer |explorer]). SQL přístup vám dává plnou kontrolu nad dotazy a přitom zajišťuje jejich bezpečné sestavení.

.[note]
Informace o vytvoření připojení a konfiguraci najdete na [samostatné stránce |guide#Připojení a konfigurace].
Detaily k připojení a konfiguraci databáze najdete v kapitole [Připojení a konfigurace |guide#Připojení a konfigurace].


Základní dotazování
Expand Down
5 changes: 3 additions & 2 deletions database/cs/explorer.texy
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Database Explorer

<div class=perex>

S Nette Database můžete pracovat dvěma způsoby - buď nechat SQL dotazy generovat automaticky (Explorer přístup), nebo je psát sami ([Direct přístup|direct-sql]). Explorer zásadním způsobem zjednodušuje přístup k datům. Stará se o práci se vztahy mezi tabulkami, takže se můžete soustředit na logiku vaší aplikace.
Explorer nabízí intuitivní a efektivní způsob práce s databází. Stará se automaticky o vazby mezi tabulkami a optimalizaci dotazů, takže se můžete soustředit na svou aplikaci. Funguje ihned bez nastavování. Pokud potřebujete plnou kontrolu nad SQL dotazy, můžete využít [SQL přístup |sql way].

- Práce s daty je přirozená a snadno pochopitelná
- Generuje optimalizované SQL dotazy, které načítají pouze potřebná data
Expand All @@ -12,7 +12,8 @@ S Nette Database můžete pracovat dvěma způsoby - buď nechat SQL dotazy gene

</div>

Práce s Explorerem začíná voláním metody `table()` nad objektem [api:Nette\Database\Explorer] (informace o vytvoření připojení a konfiguraci najdete na [samostatné stránce |guide#Připojení a konfigurace]):

S Explorerem začnete voláním metody `table()` objektu [api:Nette\Database\Explorer] (detaily k připojení najdete v kapitole [Připojení a konfigurace |guide#Připojení a konfigurace]):

```php
$books = $explorer->table('book'); // 'book' je jméno tabulky
Expand Down
10 changes: 4 additions & 6 deletions database/cs/guide.texy
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,7 @@ Nette Database
**************

.[perex]
Nette Database je výkonná a elegantní databázová vrstva pro PHP, která vyniká svou jednoduchostí použití a chytrými funkcemi. Nevyžaduje žádnou složitou konfiguraci nebo generování entit, s Nette Database můžete začít pracovat okamžitě.

S Nette Database můžete pracovat dvěma způsoby:
Nette Database je výkonná a elegantní databázová vrstva pro PHP s důrazem na jednoduchost a chytré funkce. Nabízí dva způsoby práce s databází - [Explorer] pro rychlý vývoj aplikací, nebo [SQL přístup |sql way] pro přímou práci s dotazy.

<div class="grid gap-3">
<div>
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion database/en/@left-menu.texy
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Database
********
- [Getting Started |guide]
- [Direct SQL]
- [SQL Way]
- [Explorer]
- [Transactions]
- [Exceptions]
Expand Down
8 changes: 4 additions & 4 deletions database/en/direct-sql.texy
Original file line number Diff line number Diff line change
@@ -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
Expand Down
5 changes: 3 additions & 2 deletions database/en/explorer.texy
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Database Explorer

<div class=perex>

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
Expand All @@ -12,7 +12,8 @@ With Nette Database, you can work in two ways: either let SQL queries be generat

</div>

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
Expand Down
20 changes: 9 additions & 11 deletions database/en/guide.texy
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<div class="grid gap-3">
<div>


[Direct SQL]
============
[SQL way]
=========
- Safe, parameterized queries
- Precise control over the structure of SQL queries
- Ideal for writing complex queries with advanced functions
Expand All @@ -22,8 +20,8 @@ With Nette Database, you can work in two ways:
<div>


[Explorer]
==========
[Explorer way|explorer]
=======================
- Fast development without writing SQL
- Intuitive handling of relationships between tables
- Automatic query optimization
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -100,7 +98,7 @@ foreach ($result as $author) {
}
```

[Explorer Approach|explorer] - Automatic SQL Generation
[Explorer way|explorer] - Automatic SQL Generation

```php
// Insert a record
Expand All @@ -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.

Expand Down

0 comments on commit b4d54ed

Please sign in to comment.