Может войдёшь?
Черновики Написать статью Профиль

Помощь проекту

перевод документация 5.х

  1. 1. Сообщения об ошибках
  2. 2. Обсуждение разработки ядра
  3. 3. Какая ветка?
  4. 4. Уязвимости безопасности
  5. 5. Стандарты кода
    1. 5.1. PHPDoc
    2. 5.2. StyleCI
Этот перевод актуален для англоязычной документации на (ветка 5.1) и (ветка 5.0). Опечатка? Выдели и нажми Ctrl+Enter.

Сообщения об ошибках

Чтобы стимулировать активное сотрудничество, Laravel настоятельно рекомендует отправлять запросы на исправления и улучшения, а не только отчёты об ошибках. «Отчёт об ошибке» также может быть отправлен в виде запроса на улучшение, содержащего проваленный тест.

А если вы отправляете отчёт об ошибке, то ваша заявка должна содержать заголовок и понятное описание проблемы. Вам следует прикрепить как можно больше сопутствующей информации и пример кода, демонстрирующий проблему. Цель отчёта — упростить вам (и остальным) возможность воспроизвести ошибку и разработать исправление.

Помните, отчёт об ошибке создаётся с целью объединения людей, столкнувшихся с той же проблемой, для её решения. Не ждите, что отчёт автоматически приведёт к скорейшему решению, и остальные разработчики кинуться решать проблему. Создание отчёта служит началом для вас и остальных в решении проблемы.

Исходный код Laravel расположен на Github. Вот репозитории каждого из проектов Laravel:

Обсуждение разработки ядра

Вы можете предложить новую функцию или исправление существующего поведения Laravel на внутренней доске задач. Пожалуйста, когда предлагаете новую функцию, напишите хотя бы часть необходимого для её реализации кода.

Обсуждение относительно ошибок, новых функций и реализации существующих функций ведётся на канале #internals в LaraChat команды Slack. Тэйлор Отвелл, создатель Laravel, обычно присутствует на канале по будням с 8 утра до 5 вечера (по чикагскому времени UTC-06:00), а иногда и в другое время.

Какая ветка?

Все исправления ошибок должны отправляться в последнюю стабильную ветку. Исправления ошибок никогда не должны отправляться в ветку master, только если они относятся к функциям, которые есть только в следующем релизе.

Минорные функции, которые полностью обратно совместимы с текущим релизом Laravel, могут быть отправлены в последнюю стабильную ветку.

Мажорные новые функции должны всегда отправляться в ветку master, которая содержит следующий релиз Laravel.

Если вы не уверены к каким функциям относится ваша, мажорным или минорным, спросите об этом Тэйлора Отвелла на канале #internals в LaraChat команды Slack.

Уязвимости безопасности

Если вы обнаружите уязвимость в безопасности Laravel, пожалуйста, напишите об этом Тэйлору Отвеллу на taylor@laravel.com. Все уязвимости будут оперативно устранены.

Стандарты кода

Laravel следует стандарту автозагрузки PSR-4 и стандарту написания кода PSR-2.

Обратите внимание, мы упорядочиваем наши вставки по длине, а не по алфавиту.

PHPDoc

Ниже приведён пример правильного блока документации Laravel. Обратите внимание, что после атрибута PHP@param стоят два пробела, тип аргумента, ещё два пробела и в конце имя переменной:

PHP
/**
 * Register a binding with the container.
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 */
public function bind($abstract$concrete null$shared false)
{
  
//
}

StyleCI

Если ваш стиль написания кода не идеален, не волнуйтесь! StyleCI автоматически поместит в репозиторий Laravel все исправления стиля после размещения любого запроса на включение. Это позволяет нам сконцентрироваться на содержании, а не форме.

Комментарии (1)

s37dap42x
  1. Объявления пространств имён должны писаться на той же линии, что и открывающий тег <?php

Однако же в самом laravel это правило не соблюдается...

Написать комментарий

Разметка: ? ?

Авторизуйся, чтобы прокомментировать.