Метадокумент PSR-2

1. Резюме

Цель этого руководства — уменьшить когнитивные трения при сканировании кода от разных авторов. это так путем перечисления общего набора правил и ожиданий относительно того, как форматировать PHP-код.

Приведенные здесь правила стиля основаны на общих чертах различных проектов-участников. Когда разные авторы сотрудничать в нескольких проектах, это помогает иметь один набор руководящих принципов, который будет использоваться всеми теми, кто проекты. Таким образом, польза от этого руководства заключается не в самих правилах, а в возможности поделиться этими правилами.

2. Голоса

– Голосование за принятие: ML

3. Исправления

3.1 - Многострочные аргументы (08.09.2013)

Использование одного или нескольких многострочных аргументов (например, массивов или анонимных функций) не является разделение самого списка аргументов, поэтому Раздел 4.6 не применяется автоматически. Массивы и анонимы функции могут занимать несколько строк.

Следующие примеры вполне допустимы в PSR-2:

<?php
somefunction($foo, $bar, [
  // ...
], $baz);

$app->get('/hello/{name}', function ($name) use ($app) {
    return 'Hello '.$app->escape($name);
});

3.2 - Расширение нескольких интерфейсов (17.10.2013)

При расширении нескольких интерфейсов список расширений следует рассматривать так же, как и список. «орудий», как указано в Разделе 4.1.