Поддержка Laravel 8
- Отчеты об ошибках
- Вопросы поддержки
- Обсуждение разработки ядра
- В каком отделении?
- Скомпилированные активы
- Уязвимости безопасности
- Laravel Coding Style
- Нормы поведения
Отчеты об ошибках
Чтобы стимулировать активное сотрудничество, Laravel настоятельно практикует запросы на развитие, а не только отчеты об ошибках. «Отчеты об ошибках» также могут быть отправлены в форме запроса на развитие, содержащего неудачный код.
Однако, если вы отправляете отчет об ошибке, ваша проблема должна содержать заголовок и четкое описание проблемы. Вы также должны включить как можно больше относящейся к запросу информации и образец кода, демонстрирующий проблему. Цель отчета об ошибке - упростить для вас и окружающих воспроизведение ошибки и разработку исправления.
Помните, что отчеты об ошибках создаются в надежде, что другие, у кого возникла такая же проблема, смогут сотрудничать с вами в ее решении. Не ожидайте, что в отчете об ошибке будет автоматически отображаться какая-либо активность или что другие попытаются ее исправить. Создание отчета об ошибке помогает вам и другим начать путь к устранению проблемы. Если вы хотите внести свой вклад, вы можете помочь, исправив все ошибки, перечисленные в средствах отслеживания проблем.
Исходный код Laravel находится на GitHub, и для каждого проекта Laravel есть репозитории:
- Laravel Application
- Laravel Art
- Laravel Documentation
- Laravel Dusk
- Laravel Cashier Stripe
- Laravel Cashier Paddle
- Laravel Echo
- Laravel Envoy
- Laravel Framework
- Laravel Homestead
- Laravel Homestead Build Scripts
- Laravel Horizon
- Laravel Jetstream
- Laravel Passport
- Laravel Sanctum
- Laravel Scout
- Laravel Socialite
- Laravel Telescope
- Laravel Website
Вопросы поддержки
Трекеры проблем Laravel GitHub не предназначены для предоставления помощи или поддержки Laravel. Вместо этого используйте один из следующих каналов:
Обсуждение разработки ядра
Вы можете предлагать новые функции или улучшения существующего поведения Laravel на доске задач Laravel Ideas. Если вы предлагаете новую функцию, пожалуйста, будьте готовы реализовать по крайней мере часть кода, который потребуется для завершения функции.
Неформальное обсуждение ошибок, новых функций и реализации существующих функций происходит на канале #internals сервера Laravel Discord. Тейлор Отвелл, сопровождающий Laravel, обычно присутствует на канале в будние дни с 8:00 до 17:00 (UTC-06:00 или Америка/Чикаго) и время от времени присутствует на канале.
В каком отделении?
Все исправления ошибок следует отправлять в последнюю стабильную ветку или в текущую ветку LTS. Исправления ошибок никогда не следует отправлять в ветку master, если они не исправляют функции, существующие только в следующем выпуске.
Незначительные функции, полностью обратно совместимые с текущим выпуском, могут быть отправлены в последнюю стабильную ветку.
Основные новые функции всегда следует отправлять в master ветку, которая содержит предстоящий выпуск.
Если вы не уверены, относится ли ваша функция к основной или второстепенной, спросите Тейлора Отвелла на канале #internals сервера Laravel Discord.
Скомпилированные активы
Если вы отправляете изменение, которое повлияет на скомпилированный файл, например, на большинство файлов в resources/css или resources/js репозитория laravel/laravel, не фиксируйте скомпилированные файлы. Из-за их большого размера они не могут быть реально рассмотрены сопровождающим. Это может быть использовано как способ внедрения вредоносного кода в Laravel. Чтобы предотвратить это, все скомпилированные файлы будут сгенерированы и зафиксированы сопровождающими Laravel.
Уязвимости безопасности
Если вы обнаружите уязвимость безопасности в Laravel, отправьте электронное письмо Тейлору Отвеллу по адресу taylor@laravel.com. Все уязвимости безопасности будут незамедлительно устранены.
Laravel Coding Style
Laravel следует стандарту кодирования PSR-2 и стандарту автозагрузки PSR-4.
PHPDoc
Ниже приведен пример действующего блока документации Laravel. Обратите внимание, что за атрибутом @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 после объединения запросов на добавление. Это позволяет нам сосредоточиться на содержании статьи, а не на стиле кода.
Нормы поведения
Кодекс поведения Laravel является производным от Ruby code of conduct. О любых нарушениях кодекса поведения можно сообщить Тейлору Отвеллу (taylor@laravel.com):
- Участники будут терпимо относиться к противоположным взглядам.
- Участники должны гарантировать, что их язык и действия не содержат личных нападок и пренебрежительных личных замечаний.
- Интерпретируя слова и действия других, участники всегда должны исходить из добрых намерений.
- Не допускается поведение, которое можно обоснованно считать преследованием.
