From c9008578297ea0a46272ea6a4fb24b49678cafd1 Mon Sep 17 00:00:00 2001 From: "marc.wuerth" Date: Mon, 13 May 2024 09:46:32 +0200 Subject: [PATCH] Comment out ellipsis for better copy-paste-ability --- en/contributing/cakephp-coding-conventions.rst | 2 +- en/core-libraries/httpclient.rst | 16 ++++++++-------- en/orm/query-builder.rst | 2 +- en/orm/retrieving-data-and-resultsets.rst | 2 +- en/orm/validation.rst | 2 +- fr/core-libraries/httpclient.rst | 16 ++++++++-------- fr/orm/query-builder.rst | 2 +- fr/orm/retrieving-data-and-resultsets.rst | 12 ++++++------ fr/orm/validation.rst | 2 +- ja/contributing/cakephp-coding-conventions.rst | 2 +- ja/core-libraries/httpclient.rst | 16 ++++++++-------- ja/orm/retrieving-data-and-resultsets.rst | 2 +- ja/orm/validation.rst | 4 ++-- pt/core-libraries/httpclient.rst | 6 +++--- pt/orm/query-builder.rst | 2 +- pt/orm/retrieving-data-and-resultsets.rst | 2 +- 16 files changed, 45 insertions(+), 45 deletions(-) diff --git a/en/contributing/cakephp-coding-conventions.rst b/en/contributing/cakephp-coding-conventions.rst index 3f04fb3283..0e09182c56 100644 --- a/en/contributing/cakephp-coding-conventions.rst +++ b/en/contributing/cakephp-coding-conventions.rst @@ -265,7 +265,7 @@ Try to avoid unnecessary nesting by bailing early:: { ... if (!$success) { - throw new RuntimeException(...); + throw new RuntimeException(/* ... */); } ... diff --git a/en/core-libraries/httpclient.rst b/en/core-libraries/httpclient.rst index cdb11bcc3b..a4071cced6 100644 --- a/en/core-libraries/httpclient.rst +++ b/en/core-libraries/httpclient.rst @@ -45,9 +45,9 @@ Doing POST and PUT requests is equally simple:: ]); // Other methods as well. - $http->delete(...); - $http->head(...); - $http->patch(...); + $http->delete(/* ... */); + $http->head(/* ... */); + $http->patch(/* ... */); If you have created a PSR-7 request object you can send it using ``sendRequest()``:: @@ -502,11 +502,11 @@ is making:: There are methods to mock the most commonly used HTTP methods:: - $this->mockClientGet(...); - $this->mockClientPatch(...); - $this->mockClientPost(...); - $this->mockClientPut(...); - $this->mockClientDelete(...); + $this->mockClientGet(/* ... */); + $this->mockClientPatch(/* ... */); + $this->mockClientPost(/* ... */); + $this->mockClientPut(/* ... */); + $this->mockClientDelete(/* ... */); .. php:method:: newClientResponse(int $code = 200, array $headers = [], string $body = '') diff --git a/en/orm/query-builder.rst b/en/orm/query-builder.rst index 0762f72bdf..3e336e9b87 100644 --- a/en/orm/query-builder.rst +++ b/en/orm/query-builder.rst @@ -457,7 +457,7 @@ complex expressions:: To build complex order clauses, use a Closure to build order expressions:: $query->orderAsc(function (QueryExpression $exp, SelectQuery $query) { - return $exp->addCase(...); + return $exp->addCase(/* ... */); }); diff --git a/en/orm/retrieving-data-and-resultsets.rst b/en/orm/retrieving-data-and-resultsets.rst index 1bb8bf0b95..55264ddd4e 100644 --- a/en/orm/retrieving-data-and-resultsets.rst +++ b/en/orm/retrieving-data-and-resultsets.rst @@ -614,7 +614,7 @@ Use the ``queryBuilder`` option to customize the query when using an array:: 'Authors' => [ 'foreignKey' => false, 'queryBuilder' => function (SelectQuery $q) { - return $q->where(...); // Full conditions for filtering + return $q->where(/* ... */); // Full conditions for filtering } ] ]); diff --git a/en/orm/validation.rst b/en/orm/validation.rst index 6100fd7a0f..36dbb62c3a 100644 --- a/en/orm/validation.rst +++ b/en/orm/validation.rst @@ -573,7 +573,7 @@ those rules into re-usable classes:: // Add the custom rule use App\Model\Rule\CustomRule; - $rules->add(new CustomRule(...), 'ruleName'); + $rules->add(new CustomRule(/* ... */), 'ruleName'); By creating custom rule classes you can keep your code DRY and test your domain rules in isolation. diff --git a/fr/core-libraries/httpclient.rst b/fr/core-libraries/httpclient.rst index d12596543c..76f40a7e95 100644 --- a/fr/core-libraries/httpclient.rst +++ b/fr/core-libraries/httpclient.rst @@ -46,9 +46,9 @@ Faire des requêtes POST et PUT est tout aussi simple:: ]); // Autres méthodes. - $http->delete(...); - $http->head(...); - $http->patch(...); + $http->delete(/* ... */); + $http->head(/* ... */); + $http->patch(/* ... */); Si vous avez créé un objet de requêtes PSR-7, vous pouvez l'envoyer avec ``sendRequest()``:: @@ -515,11 +515,11 @@ requêtes faites par votre application:: Il existe des méthodes pour mocker les méthodes HTTP les plus courantes:: - $this->mockClientGet(...); - $this->mockClientPatch(...); - $this->mockClientPost(...); - $this->mockClientPut(...); - $this->mockClientDelete(...); + $this->mockClientGet(/* ... */); + $this->mockClientPatch(/* ... */); + $this->mockClientPost(/* ... */); + $this->mockClientPut(/* ... */); + $this->mockClientDelete(/* ... */); .. php:method:: newClientResponse(int $code = 200, array $headers = [], string $body = '') diff --git a/fr/orm/query-builder.rst b/fr/orm/query-builder.rst index 6459b45551..9ddaa27788 100644 --- a/fr/orm/query-builder.rst +++ b/fr/orm/query-builder.rst @@ -478,7 +478,7 @@ des expressions complexes:: Pour construire des clauses de tri complexes, utilisez une Closure:: $query->orderAsc(function (QueryExpression $exp, Query $query) { - return $exp->addCase(...); + return $exp->addCase(/* ... */); }); Limiter les Résultats diff --git a/fr/orm/retrieving-data-and-resultsets.rst b/fr/orm/retrieving-data-and-resultsets.rst index 5458c77395..02613b7dd3 100644 --- a/fr/orm/retrieving-data-and-resultsets.rst +++ b/fr/orm/retrieving-data-and-resultsets.rst @@ -582,7 +582,7 @@ définir le second argument à ``true``:: $query = $articles->find(); $query->contain(['Authors', 'Comments'], true); - + .. note:: Les noms d'association dans les appels à ``contain()`` doivent respecter la @@ -667,7 +667,7 @@ passez un tableau:: 'Authors' => [ 'foreignKey' => false, 'queryBuilder' => function (Query $q) { - return $q->where(...); // Conditions complètes pour le filtrage + return $q->where(/* ... */); // Conditions complètes pour le filtrage } ] ]); @@ -801,7 +801,7 @@ l'association et charger d'autres champs de cette même association, vous pouvez parfaitement combiner ``innerJoinWith()`` et ``contain()``. L'exemple ci-dessous filtre les Articles qui ont des Tags spécifiques et charge ces Tags:: - + $filter = ['Tags.name' => 'CakePHP']; $query = $articles->find() ->distinct($articles->getPrimaryKey()) @@ -820,9 +820,9 @@ ces Tags:: $query ->select(['country_name' => 'Countries.name']) ->innerJoinWith('Countries'); - + Sinon, vous verrez les données dans ``_matchingData``, comme cela a été - décrit ci-dessous à propos de ``matching()``. C'est un angle mort de + décrit ci-dessous à propos de ``matching()``. C'est un angle mort de ``matching()``, qui ne sait pas que vous avez sélectionné des champs. .. warning:: @@ -949,7 +949,7 @@ exemple des tables se trouvant dans deux bases de données différentes. Habituellement, vous définisser la stratégie d'une association quand vous la définissez, dans la méthode ``Table::initialize()``, mais vous pouvez changer manuellement la stratégie de façon permanente:: - + $articles->Comments->setStrategy('select'); Récupération Avec la Stratégie de Sous-Requête diff --git a/fr/orm/validation.rst b/fr/orm/validation.rst index 10038c0634..a361edac1e 100644 --- a/fr/orm/validation.rst +++ b/fr/orm/validation.rst @@ -610,7 +610,7 @@ utile de packager ces règles dans des classes réutilisables:: // Ajouter la règle personnalisée use App\Model\Rule\CustomRule; - $rules->add(new CustomRule(...), 'ruleName'); + $rules->add(new CustomRule(/* ... */), 'ruleName'); En ajoutant des classes de règles personnalisées, vous pouvez garder votre code DRY et tester vos règles de domaine isolément. diff --git a/ja/contributing/cakephp-coding-conventions.rst b/ja/contributing/cakephp-coding-conventions.rst index 4710962427..3fb88e7023 100644 --- a/ja/contributing/cakephp-coding-conventions.rst +++ b/ja/contributing/cakephp-coding-conventions.rst @@ -254,7 +254,7 @@ false を、関数呼び出しが成功したかどうかを判定できるよ { ... if (!$success) { - throw new RuntimeException(...); + throw new RuntimeException(/* ... */); } ... diff --git a/ja/core-libraries/httpclient.rst b/ja/core-libraries/httpclient.rst index 39ad5b8aa2..d635ad8bfe 100644 --- a/ja/core-libraries/httpclient.rst +++ b/ja/core-libraries/httpclient.rst @@ -49,9 +49,9 @@ POST や PUT のリクエストを実行することは、同様に簡単です ]); // 他のメソッドも同様に、 - $http->delete(...); - $http->head(...); - $http->patch(...); + $http->delete(/* ... */); + $http->head(/* ... */); + $http->patch(/* ... */); If you have created a PSR-7 request object you can send it using ``sendRequest()``:: @@ -507,11 +507,11 @@ is making:: There are methods to mock the most commonly used HTTP methods:: - $this->mockClientGet(...); - $this->mockClientPatch(...); - $this->mockClientPost(...); - $this->mockClientPut(...); - $this->mockClientDelete(...); + $this->mockClientGet(/* ... */); + $this->mockClientPatch(/* ... */); + $this->mockClientPost(/* ... */); + $this->mockClientPut(/* ... */); + $this->mockClientDelete(/* ... */); .. php:method:: newClientResponse(int $code = 200, array $headers = [], string $body = '') diff --git a/ja/orm/retrieving-data-and-resultsets.rst b/ja/orm/retrieving-data-and-resultsets.rst index 24b93cc72f..a3e94d42a0 100644 --- a/ja/orm/retrieving-data-and-resultsets.rst +++ b/ja/orm/retrieving-data-and-resultsets.rst @@ -596,7 +596,7 @@ contain に条件を渡す 'Authors' => [ 'foreignKey' => false, 'queryBuilder' => function (SelectQuery $q) { - return $q->where(...); // フィルターのための完全な条件 + return $q->where(/* ... */); // フィルターのための完全な条件 } ] ]); diff --git a/ja/orm/validation.rst b/ja/orm/validation.rst index 6b7f034af9..44519111f2 100644 --- a/ja/orm/validation.rst +++ b/ja/orm/validation.rst @@ -561,7 +561,7 @@ CakePHP は、エンティティーが保存される前に適用される「ル // カスタムルールの追加 use App\Model\Rule\CustomRule; - $rules->add(new CustomRule(...), 'ruleName'); + $rules->add(new CustomRule(/* ... */), 'ruleName'); カスタムルールクラスを作ることでコードを *重複がない状態* (訳注：DRY = Don't Repeat Yourself の訳) @@ -605,7 +605,7 @@ CakePHP の ORM は検証に二層のアプローチを使う点がユニーク public function validationCustomName($validator) { - $validator->add(...); + $validator->add(/* ... */); return $validator; } diff --git a/pt/core-libraries/httpclient.rst b/pt/core-libraries/httpclient.rst index fbe7cd3855..3b7bc2c66a 100644 --- a/pt/core-libraries/httpclient.rst +++ b/pt/core-libraries/httpclient.rst @@ -45,9 +45,9 @@ Fazer solicitações POST e PUT é igualmente simples:: ]); // Outros métodos também. - $http->delete(...); - $http->head(...); - $http->patch(...); + $http->delete(/* ... */); + $http->head(/* ... */); + $http->patch(/* ... */); Se você criou um objeto de solicitação PSR-7, pode enviá-lo usando ``sendRequest()``:: diff --git a/pt/orm/query-builder.rst b/pt/orm/query-builder.rst index 96c9002793..136532b765 100644 --- a/pt/orm/query-builder.rst +++ b/pt/orm/query-builder.rst @@ -666,7 +666,7 @@ criam novos objetos de expressão que mudam **como** as condições são combina segundo tipo de métodos são **condições**. As condições são adicionadas a uma expressão em que são alinhadas com o combinador atual. -Por exemplo, chamar ``$exp->and_(...)`` criará um novo objeto ``Expression`` que +Por exemplo, chamar ``$exp->and_(/* ... */)`` criará um novo objeto ``Expression`` que combina todas as condições que ele contém com ``AND``. Enquanto ``$exp->or_()`` criará um novo objeto ``Expression`` que combina todas as condições adicionadas a ele com ``OR``. Um exemplo de adição de condições com um objeto ``Expression`` seria:: diff --git a/pt/orm/retrieving-data-and-resultsets.rst b/pt/orm/retrieving-data-and-resultsets.rst index da92145a55..1170b8dc26 100644 --- a/pt/orm/retrieving-data-and-resultsets.rst +++ b/pt/orm/retrieving-data-and-resultsets.rst @@ -568,7 +568,7 @@ case you should use an array passing ``foreignKey`` and ``queryBuilder``:: 'Authors' => [ 'foreignKey' => false, 'queryBuilder' => function ($q) { - return $q->where(...); // Full conditions for filtering + return $q->where(/* ... */); // Full conditions for filtering } ] ]);