Версия фреймворка: 5.4 5.3 4.2

Руководство по участию в разработке

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

Для активного развития, Laravel настоятельно рекомендует использовать только запросы на добавление изменений (pull requests), а не просто сообщения об ошибках (bug reports). Сообщение об ошибке так же может быть добавлено к pull request'у вместе с ошибками прохождения юнит-тестов.

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

Также помните, что отчёты об ошибках создаются в надежде, что другие пользователи с такими же проблемами смогут принять участие в их решении вместе с вами. Но не ждите, что другие всё бросят и начнут исправлять вашу проблему. Отчёт об ошибке призван помочь вам и другим начать совместную работу над решением проблемы.

Исходный код Laravel находится на GitHub, список репозиториев для каждого проекта Laravel:

Главное обсуждение разработки

Обсуждение, касающееся ошибок, новых функциональных возможностей и реализации уже существующих происходят на IRC канале #laravel-dev (Freenode). Тейлор Отвелл, главный разработчик Laravel, обычно присутствует на канале по будням с 8 утра до 5 вечера (UTC-06:00 или часовой пояс America/Chicago), иногда появляется спонтанно на канале в другое время.

IRC канал #laravel-dev открыт для всех. Мы рады всем, кто зашел на канал, не только чтобы принять участие, но и просто почитать обсуждения!

Какая ветка?

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

Незначительные улучшения, полностью обратно совместимые с текущей версией Laravel, могут быть отправлены в последнюю стабильную ветку.

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

Если вы не уверены, относится ваше улучшение к незначительным или серьёзным, пожалуйста спросите у Тэйлора Отвелла на IRC канале #laravel-dev (Freenode).

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

Если вы обнаружили уязвимость в безопасности внутри Laravel, пожалуйста отправьте e-mail Тэйлору Отвеллу на почту taylorotwell@gmail.com. Все такие уязвимости будут незамедлительно рассмотрены.

Стиль написания кода

Laravel следует PSR-0 и PSR-1 стандартам. В дополнение к ним, необходимо так же следовать следующим стандартам:

  • Декларация пространства имён (namespace) должна находиться на такой же строке, как и <?php.
  • Открывающая фигурная скобка класса { должна находиться на такой же строке, как и название класса.
  • Функции и управляющие конструкции должны использовать стиль Олмана:
    • Открывающая программная скобка должна располагаться на новой строке с тем же отступом, что и выражение, находящееся на предшествующей строке
    • Первое выражение внутри программных скобок должно располагаться на новой строке с отступом, увеличенным на 1 символ табуляции
    • Последующие выражения внутри программных скобок должны располагаться с тем же отступом, что и первое.
    • Закрывающая программная скобка должна располагается с отступом, равным отступу соответствующей ей открывающей программной скобке.
  • Для отступов используется Tab, для выравнивания пробел.