Merge branch 'master' of git://github.com/php-fig/fig-standards

phpDocumentor · Jun 5, 2015 · b55176c · b55176c
2 parents 2726c89 + d5f0642
commit b55176c
Show file tree

Hide file tree

Showing 21 changed files with 3,859 additions and 1,347 deletions.
diff --git a/accepted/PSR-7-http-message-meta.md b/accepted/PSR-7-http-message-meta.md
diff --git a/accepted/PSR-7-http-message.md b/accepted/PSR-7-http-message.md
diff --git a/accepted/fr/PSR-1-basic-coding-standard.md b/accepted/fr/PSR-1-basic-coding-standard.md
@@ -10,7 +10,7 @@ Les mots clés "DOIT", "NE DOIT PAS", "OBLIGATOIRE", "DEVRA", "NE DEVRA PAS",
 document doivent être interprétés comme décrit dans [RFC 2119][].
 
 [RFC 2119]: http://www.ietf.org/rfc/rfc2119.txt
-[PSR-0]: https://github.com/lesmyrmidons/fig-standards/accepted/fr/PSR-0.md
+[PSR-0]: https://github.com/php-fig/fig-standards/blob/master/accepted/fr/PSR-0.md
 
 1. Vue d'ensemble
 -----------
@@ -23,7 +23,7 @@ document doivent être interprétés comme décrit dans [RFC 2119][].
   constantes, etc.) *soit* causer des effets secondaires (par exemple, générer
   des sorties, modifier paramètres .ini), mais NE DOIVENT PAS faire les deux.
 
-- Les espaces de noms et les classes DOIVENT suivre [PSR-0][].
+- Les espaces de noms et les classes DOIVENT suivre [PSR-0].
 
 - Les noms des classes DOIVENT être déclarés comme `StudlyCaps`.
 

diff --git a/accepted/fr/PSR-2-coding-style-guide.md b/accepted/fr/PSR-2-coding-style-guide.md
@@ -324,7 +324,7 @@ class ClassName
 Lorsqu'elles sont présentes, les déclarations `abstract` et `final` DOIVENT
 précédés la déclaration de la visibilité.
 
-Lorsqu'elle est présente, l'a déclaration `static` DOIT venir après la
+Lorsqu'elle est présente, la déclaration `static` DOIT venir après la
 déclaration de la visibilité.
 
 ```php
@@ -415,7 +415,7 @@ mots-clés de contrôle ressemblent à des mots simples.
 ### 5.2. `switch`, `case`
 
 Une structure `switch` ressemble à ce qui suit. Notez l'emplacement des
-parenthèses, espaces et accolades, la déclaration de `case` DOIT être indenté
+parenthèses, espaces et accolades. La déclaration de `case` DOIT être indentée
 une fois par rapport à `switch` et le mot-clé `break` (ou autre mot-clé de
 terminaison) DOIT être indenté au même niveau que le corps de `case`. Il DOIT y
 avoir un commentaire comme `// no break` lorsque son omission est

diff --git a/accepted/ru/PSR-1-basic-coding-standard.md b/accepted/ru/PSR-1-basic-coding-standard.md
@@ -5,7 +5,7 @@
 стандартными, необходимыми для обеспечения высокого уровня
 технического взаимодействия между общим (разделяемым) кодом PHP.
 
-Ключевые слова «НЕОБХОДИМО» («MUST»), «НЕДОПУСТИМО» («MUST NOT»), «ТРЕБУЕТСЯ»
+Ключевые слова «НЕОБХОДИМО»/«ДОЛЖНО» («MUST»), «НЕДОПУСТИМО»/«НЕ ДОЛЖНО» («MUST NOT»), «ТРЕБУЕТСЯ»
 («REQUIRED»), «НУЖНО» («SHALL»), «НЕ ПОЗВОЛЯЕТСЯ» («SHALL NOT»), «СЛЕДУЕТ»
 («SHOULD»), «НЕ СЛЕДУЕТ» («SHOULD NOT»), «РЕКОМЕНДУЕТСЯ» («RECOMMENDED»),
 «ВОЗМОЖНО» («MAY») и «НЕОБЯЗАТЕЛЬНО» («OPTIONAL»)

diff --git a/accepted/ru/PSR-2-coding-style-guide-meta.md b/accepted/ru/PSR-2-coding-style-guide-meta.md
@@ -0,0 +1,48 @@
+PSR-2 Метадокумент
+===================
+
+1. Обзор
+----------
+
+Цель данного руководства — уменьшить когнитивное сопротивление при
+визуальном восприятии кода, написанного разными авторами. Для этого составлен
+список распространённых правил и ожиданий относительно форматирования
+PHP-кода.
+
+Представленные здесь стилистические правила получены на основе обобщения опыта
+различных проектов. При сотрудничестве разных авторов над множеством проектов,
+полезно применять единый набор руководящих принципов для этих проектов.
+Таким образом, польза данного руководства не в правилах, как таковых,
+а в их распространённости.
+
+2. Голосования
+--------
+
+- **Приёмочное голосование:** [ML](https://groups.google.com/d/msg/php-fig/c-QVvnZdMQ0/TdDMdzKFpdIJ)
+
+
+3. Список исправлений
+---------
+
+### 3.1 - Многострочные аргументы (08.09.2013)
+
+Использование одного или нескольких многострочных аргументов (например: массив или анонимная функция) не является разбиением
+списка аргументов, и, таким образом не принуждает к применению раздела 4.6. Массивы и анонимные функции могут занимать несколько строк.
+
+Следующие примеры полностью удовлетовряют PSR-2:
+
+```php
+<?php
+somefunction($foo, $bar, [
+  // ...
+], $baz);
+
+$app->get('/hello/{name}', function ($name) use ($app) { 
+    return 'Hello '.$app->escape($name); 
+});
+```
+
+### 3.2 - Расширение нескольких интерфейсов (17.10.2013)
+
+При расширении нескольких интерфейсов, со списком `extends` следует поступать так же как с `implements`, как описано в  разделе 4.1.
+