Версія фреймворка: 8.x

Керівництво по Contribution

Звіти про помилки

Щоб заохотити активну співпрацю, Laravel настійно заохочує запити на виклик, а не лише повідомлення про помилки. "Звіти про помилки" також можуть надсилатися у формі запиту на вилучення, що містить невдалий тест.

Однак, якщо ви подаєте звіт про помилку, ваша проблема повинна містити заголовок та чіткий опис проблеми. Ви також повинні включити якомога більше відповідної інформації та зразок коду, який демонструє проблему. Мета звіту про помилку - полегшити для себе - та інших - відтворення помилки та розробку виправлення.

Пам’ятайте, звіти про помилки створюються з надією, що люди з такою ж проблемою зможуть співпрацювати з вами над її вирішенням. Не чекайте, що звіт про помилку автоматично побачить будь-яку активність або що інші перескочать, щоб виправити це. Створення звіту про помилку допомагає собі та іншим почати шлях виправлення проблеми. Якщо ви хочете чіп, ви можете допомогти, виправившибудь-які помилки, перелічені в наших програмах відстеження.

Вихідний код Laravel управляється на GitHub, і для кожного з проектів Laravel є сховища:

Питання підтримки

Трекери випусків GitHub Laravel не призначені для надання допомоги або підтримки Laravel. Натомість використовуйте один із таких каналів:

Основна дискусія щодо розвитку

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

Неформальна дискусія щодо помилок, нових функцій та впровадження існуючих функцій відбувається в#internalsканалСервер Laravel Discord. Тейлор Отуелл, співробітник Laravel, зазвичай присутній на каналі в робочі дні з 8:00 до 17:00 (UTC-06: 00 або Америка / Чикаго), а спорадично присутній на каналі в інший час.

Яка гілка?

Всівиправлення помилок слід надсилати до останньої стабільної гілки або допоточна філія LTS. Виправлення помилок повинно відбуватисяніколивідправити доmaster, якщо вони не виправлять функції, які існують лише у майбутньому випуску

Неповнолітніособливості, які єповністю назад суміснийз поточним випуском може бути відправлений в останню стабільну гілку.

Майорнові функції завжди слід надсилати доmaster, що містить майбутній випуск.

Якщо ви не впевнені, чи відповідає ваша функція мажору чи мінору, будь ласка, запитайте Тейлора Отуелла в#internalsканалСервер Laravel Discord.

Compiled Assets

Якщо ви подаєте зміну, яка вплине на скомпільований файл, такий як більшість файлів уresources/cssабоresources/jsзlaravel/laravelсховище, не фіксуйте компільовані файли. Через їх великі розміри, вони не можуть бути реально перевірені супроводжуючим. Це можна використати як спосіб ін’єкції шкідливого коду в Laravel. Для того, щоб оборонно запобігти цьому, всі скомпільовані файли будуть генеруватися та фіксуватися супровідниками Laravel.

Уразливості безпеки

Якщо ви виявили вразливість системи безпеки в Laravel, надішліть електронний лист Тейлору Отуеллу за адресоюtaylor@laravel.com. Усі уразливості системи безпеки будуть негайно усунені.

Стиль кодування

Laravel слідує заPSR-2стандарт кодування таPSR-4стандарт автоматичного завантаження.

PHPDoc

Below is an example of a valid Laravel documentation block. Note that the @paramза атрибутом слідують два пробіли, тип аргументу, ще два пробіли і, нарешті, ім'я змінної:

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

StyleCI

Не хвилюйтеся, якщо ваш стиль коду не ідеальний!StyleCIавтоматично об’єднає будь-які виправлення стилів у сховище Laravel після об’єднання запитів на витягування. Це дозволяє зосередитись на змісті внеску, а не на стилі коду.

Норми поведінки

The Laravel code of conduct is derived from the Ruby code of conduct. Any violations of the code of conduct may be reported to Taylor Otwell (taylor@laravel.com):

  • Participants will be tolerant of opposing views.
  • Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
  • When interpreting the words and actions of others, participants should always assume good intentions.
  • Behavior that can be reasonably considered harassment will not be tolerated.