Skip to content

Commit

Permalink
Use spelled out connection variable name in other translations
Browse files Browse the repository at this point in the history
  • Loading branch information
ravage84 committed Mar 27, 2020
1 parent 374dc09 commit 55629da
Show file tree
Hide file tree
Showing 5 changed files with 105 additions and 105 deletions.
42 changes: 21 additions & 21 deletions fr/orm/database-basics.rst
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,7 @@ avant, ou retourner la connexion connue existante::

use Cake\Datasource\ConnectionManager;

$conn = ConnectionManager::get('default');
$connection = ConnectionManager::get('default');

La tentative de chargement de connexions qui n'existent pas va lancer une
exception.
Expand All @@ -321,7 +321,7 @@ nouvelles connexions qui ne sont pas défines dans votre fichier de
configuration::

ConnectionManager::config('my_connection', $config);
$conn = ConnectionManager::get('my_connection');
$connection = ConnectionManager::get('my_connection');

Consultez le chapitre sur la :ref:`configuration <database-configuration>`
pour plus d'informations sur les données de configuration utilisées lors de
Expand Down Expand Up @@ -658,15 +658,15 @@ selon le type de résultats que vous souhaitez en retour. La méthode la plus
basique est ``query()`` qui vous permet de lancer des requêtes SQL déjà
complètes::

$stmt = $conn->query('UPDATE posts SET published = 1 WHERE id = 2');
$stmt = $connection->query('UPDATE posts SET published = 1 WHERE id = 2');

.. php:method:: execute($sql, $params, $types)
La méthode ``query`` n'accepte pas de paramètres supplémentaires. Si vous
avez besoin de paramètres supplémentaires, vous devrez utiliser la méthode
``execute()``, ce qui permet aux placeholders d'être utilisés::

$stmt = $conn->execute(
$stmt = $connection->execute(
'UPDATE posts SET published = ? WHERE id = ?',
[1, 2]
);
Expand All @@ -676,7 +676,7 @@ placeholders sont des chaînes de valeur. Si vous avez besoin de lier des types
spécifiques de données, vous pouvez utiliser leur nom de type abstrait lors
de la création d'une requête::

$stmt = $conn->execute(
$stmt = $connection->execute(
'UPDATE posts SET published_date = ? WHERE id = ?',
[new DateTime('now'), 2],
['date', 'integer']
Expand All @@ -690,7 +690,7 @@ la plus flexible de créer des requêtes est d'utiliser :doc:`/orm/query-builder
Cette approche vous permet de construire des requêtes expressives complexes sans
avoir à utiliser une plateforme SQL spécifique::

$query = $conn->newQuery();
$query = $connection->newQuery();
$query->update('posts')
->set(['published' => true])
->where(['id' => 2]);
Expand All @@ -701,7 +701,7 @@ de base de données jusqu'à ce que la méthode ``execute()`` soit appelée, ou
que la requête soit itérée. Itérer une requête va d'abord l'exécuter et ensuite
démarrer l'itération sur l'ensemble des résultats::

$query = $conn->newQuery();
$query = $connection->newQuery();
$query->select('*')
->from('posts')
->where(['published' => true]);
Expand All @@ -724,20 +724,20 @@ vous fassiez des transactions de base de données. La façon la plus basique de
faire des transactions est avec les méthodes ``begin``, ``commit`` et
``rollback``, qui correspondent à leurs équivalents SQL::

$conn->begin();
$conn->execute('UPDATE posts SET published = ? WHERE id = ?', [true, 2]);
$conn->execute('UPDATE posts SET published = ? WHERE id = ?', [false, 4]);
$conn->commit();
$connection->begin();
$connection->execute('UPDATE posts SET published = ? WHERE id = ?', [true, 2]);
$connection->execute('UPDATE posts SET published = ? WHERE id = ?', [false, 4]);
$connection->commit();

.. php:method:: transactional(callable $callback)
En plus de cette interface, les instances de connexion fournissent aussi la
méthode ``transactional`` ce qui simplifie la gestion des appels
begin/commit/rollback::

$conn->transactional(function ($conn) {
$conn->execute('UPDATE posts SET published = ? WHERE id = ?', [true, 2]);
$conn->execute('UPDATE posts SET published = ? WHERE id = ?', [false, 4]);
$connection->transactional(function ($connection) {
$connection->execute('UPDATE posts SET published = ? WHERE id = ?', [true, 2]);
$connection->execute('UPDATE posts SET published = ? WHERE id = ?', [false, 4]);
});

En plus des requêtes basiques, vous pouvez exécuter des requêtes plus complexes
Expand Down Expand Up @@ -770,14 +770,14 @@ fournies en les liant à lui. Alors que ``prepare()`` retourne une requête
incomplète::

// Les requêtes à partir de execute auront des valeurs leur étant déjà liées.
$stmt = $conn->execute(
$stmt = $connection->execute(
'SELECT * FROM articles WHERE published = ?',
[true]
);

// Les Requêtes à partir de prepare seront des paramètres pour les placeholders.
// Vous avez besoin de lier les paramètres avant d'essayer de l'exécuter.
$stmt = $conn->prepare('SELECT * FROM articles WHERE published = ?');
$stmt = $connection->prepare('SELECT * FROM articles WHERE published = ?');

Une fois que vous avez préparé une requête, vous pouvez lier les données
supplémentaires et l'exécuter.
Expand All @@ -792,7 +792,7 @@ lier des données supplémentaires. Vous pouvez lier plusieurs valeurs en une
fois en utilisant la méthode ``bind``, ou lier les éléments individuels
en utilisant ``bindValue``::

$stmt = $conn->prepare(
$stmt = $connection->prepare(
'SELECT * FROM articles WHERE published = ? AND created > ?'
);

Expand All @@ -809,7 +809,7 @@ en utilisant ``bindValue``::
Lors de la création de requêtes, vous pouvez aussi utiliser les clés nommées
de tableau plutôt que des clés de position::

$stmt = $conn->prepare(
$stmt = $connection->prepare(
'SELECT * FROM articles WHERE published = :published AND created > :created'
);

Expand Down Expand Up @@ -885,10 +885,10 @@ connexion en définissant l'option ``log`` à ``true``. Vous pouvez changer le
log de requête à la volée, en utilisant ``logQueries``::

// Active les logs des requêtes.
$conn->logQueries(true);
$connection->logQueries(true);

// Stoppe les logs des requêtes
$conn->logQueries(false);
$connection->logQueries(false);

Quand les logs des requêtes sont activés, les requêtes sont enregistrées dans
:php:class:`Cake\\Log\\Log` en utilisant le niveau de 'debug', et le scope
Expand Down Expand Up @@ -940,7 +940,7 @@ identifiers, vous pouvez l'activer en utilisant le paramètre
``quoteIdentifiers`` dans votre :ref:`database-configuration`. Vous pouvez
aussi activer cette fonctionnalité à la volée::

$conn->getDriver()->enableAutoQuoting();
$connection->getDriver()->enableAutoQuoting();

Quand elle est activée, l'identifier quoting va entrainer des requêtes
supplémentaires traversales qui convertissent tous les identifiers en objets
Expand Down
42 changes: 21 additions & 21 deletions ja/orm/database-basics.rst
Original file line number Diff line number Diff line change
Expand Up @@ -280,7 +280,7 @@ BigBoxesTable と、コントローラー BigBoxesController は、全て自動

use Cake\Datasource\ConnectionManager;

$conn = ConnectionManager::get('default');
$connection = ConnectionManager::get('default');

存在しない接続をロードしようとしたら、例外を throw します。

Expand All @@ -291,7 +291,7 @@ BigBoxesTable と、コントローラー BigBoxesController は、全て自動
コネクションを生成することができます。 ::

ConnectionManager::config('my_connection', $config);
$conn = ConnectionManager::get('my_connection');
$connection = ConnectionManager::get('my_connection');

コネクション生成時の設定についての詳細は :ref:`database-configuration` を参照してください。

Expand Down Expand Up @@ -610,14 +610,14 @@ CakePHP のデータベース抽象化レイヤは、PDO とネイティブド
いくつかあります。
もっとも基本的な方法は、完全な SQL クエリーの実行を可能にする ``query()`` です。 ::

$stmt = $conn->query('UPDATE articles SET published = 1 WHERE id = 2');
$stmt = $connection->query('UPDATE articles SET published = 1 WHERE id = 2');

.. php:method:: execute($sql, $params, $types)
``query()`` メソッドは追加パラメーターを受け付けません。もし追加パラメーターが必要なら、
プレースホルダーを使用可能な ``execute()`` メソッドを使用します。 ::

$stmt = $conn->execute(
$stmt = $connection->execute(
'UPDATE articles SET published = ? WHERE id = ?',
[1, 2]
);
Expand All @@ -626,7 +626,7 @@ CakePHP のデータベース抽象化レイヤは、PDO とネイティブド
もし特定の型にバインドする必要があるなら、クエリーを生成する時に型名を指定することが
できます。 ::

$stmt = $conn->execute(
$stmt = $connection->execute(
'UPDATE articles SET published_date = ? WHERE id = ?',
[new DateTime('now'), 2],
['date', 'integer']
Expand All @@ -640,7 +640,7 @@ CakePHP のデータベース抽象化レイヤは、PDO とネイティブド
この方法では、プラットフォーム固有の SQL を使用することなく、複雑で表現力豊かなクエリーを
構築することができます。 ::

$query = $conn->newQuery();
$query = $connection->newQuery();
$query->update('articles')
->set(['published' => true])
->where(['id' => 2]);
Expand All @@ -650,7 +650,7 @@ CakePHP のデータベース抽象化レイヤは、PDO とネイティブド
送信されず、メソッド呼び出し後に順次処理されます。
最初に送信してから、順次結果セットを作成します。 ::

$query = $conn->newQuery();
$query = $connection->newQuery();
$query->select('*')
->from('articles')
->where(['published' => true]);
Expand All @@ -672,19 +672,19 @@ CakePHP のデータベース抽象化レイヤは、PDO とネイティブド
トランザクション操作の最も基本的な方法は、SQL構文と同じような ``begin()`` ,
``commit()`` , ``rollback()`` を使用するものです。 ::

$conn->begin();
$conn->execute('UPDATE articles SET published = ? WHERE id = ?', [true, 2]);
$conn->execute('UPDATE articles SET published = ? WHERE id = ?', [false, 4]);
$conn->commit();
$connection->begin();
$connection->execute('UPDATE articles SET published = ? WHERE id = ?', [true, 2]);
$connection->execute('UPDATE articles SET published = ? WHERE id = ?', [false, 4]);
$connection->commit();

.. php:method:: transactional(callable $callback)
このコネクションインスタンスへのインターフェースに加えて、さらに begin/commit/rollback を
簡単にハンドリングする ``transactional()`` メソッドが提供されています。 ::

$conn->transactional(function ($conn) {
$conn->execute('UPDATE articles SET published = ? WHERE id = ?', [true, 2]);
$conn->execute('UPDATE articles SET published = ? WHERE id = ?', [false, 4]);
$connection->transactional(function ($connection) {
$connection->execute('UPDATE articles SET published = ? WHERE id = ?', [true, 2]);
$connection->execute('UPDATE articles SET published = ? WHERE id = ?', [false, 4]);
});

基本的なクエリーに加えて、 :doc:`/orm/query-builder` または :doc:`/orm/table-objects` の
Expand Down Expand Up @@ -717,14 +717,14 @@ CakePHP のデータベース抽象化レイヤは、PDO とネイティブド
それに対して ``prepare()`` は不完全なステートメントを返します。 ::

// execute は指定された値でバインドして SQL ステートメントを実行します。
$stmt = $conn->execute(
$stmt = $connection->execute(
'SELECT * FROM articles WHERE published = ?',
[true]
);

// prepare はプレースホルダーのための準備をします。
// 実行する前にパラメーターをバインドする必要があります。
$stmt = $conn->prepare('SELECT * FROM articles WHERE published = ?');
$stmt = $connection->prepare('SELECT * FROM articles WHERE published = ?');

SQL 文を準備したら、あなたは追加のデータをバインドし、それを実行することができます。

Expand All @@ -737,7 +737,7 @@ SQL 文を準備したら、あなたは追加のデータをバインドし、
あなたは ``bind()`` メソッドを使って一度に複数の値をバインドする事も、
``bindValue`` を使って1項目ずつバインドする事もできます。 ::

$stmt = $conn->prepare(
$stmt = $connection->prepare(
'SELECT * FROM articles WHERE published = ? AND created > ?'
);

Expand All @@ -754,7 +754,7 @@ SQL 文を準備したら、あなたは追加のデータをバインドし、
ステートメントを作成する時には、項目の通し番号ではなく、項目名の配列をキーに
使用することもできます。 ::

$stmt = $conn->prepare(
$stmt = $connection->prepare(
'SELECT * FROM articles WHERE published = :published AND created > :created'
);

Expand Down Expand Up @@ -829,10 +829,10 @@ SQL 文を準備したら、あなたは追加のデータをバインドし、
また、 ``logQueries`` を使って実行中にクエリーログを切り替えることができます。 ::

// クエリーログを有効
$conn->logQueries(true);
$connection->logQueries(true);

// クエリーログを停止
$conn->logQueries(false);
$connection->logQueries(false);

クエリーログを有効にしていると、 'debug' レベルで 'queriesLog' スコープで
:php:class:`Cake\\Log\\Log` にクエリーをログ出力します。
Expand Down Expand Up @@ -879,7 +879,7 @@ Web リクエストの時に便利です。 ::
引用符を使うことができます。
また、実行時にこの機能を有効にすることもできます。 ::

$conn->getDriver()->enableAutoQuoting();
$connection->getDriver()->enableAutoQuoting();

有効にすると、引用識別子は 全ての識別子を ``IdentifierExpression`` オブジェクトに
変換するトラバーサルが発生する原因になります。
Expand Down
Loading

0 comments on commit 55629da

Please sign in to comment.