Документация Laravel 8.x

Вольный перевод репозитория документации laravel/docs ветка 8.x на русский язык.

Ссылка на лицензию оригинала документации laravel/docs.

Перевод документации пополняется по мере обращения к соответствующим разделам, либо приоритет отдается файлам с наименьшим весом. Тем не менее, раздел Пакеты имеет наименьший приоритет.

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

Перед чтением документации ознакомьтесь с соглашением по переводу.

Содержание документации

Разделы, помеченные галочками, уже имеют актуализированные переводы полностью на русском языке.

• Пролог

  • Примечания к релизу
  • Руководство по обновлению
  • Рекомендации по участию

• Начало

  • Установка
  • Конфигурирование
  • Структура каталогов
  • Стартовые комплекты
  • Развертывание

• Архитектурные концепции

  • Жизненный цикл запроса
  • Контейнер служб
  • Поставщики служб
  • Фасады

• Основы

  • Маршрутизация
  • Посредники
  • Предотвращение атак CSRF
  • Контроллеры
  • HTTP-запросы
  • HTTP-ответы
  • HTML-шаблоны
  • Шаблонизатор Blade
  • Генерация URL-адресов
  • HTTP-сессия
  • Валидация
  • Обработка ошибок
  • Логирование

• Углубленное изучение

  • Консоль Artisan
  • Широковещание
  • Кеш приложения
  • Коллекции
  • Компиляция исходников (Mix)
  • Контракты
  • События
  • Файловое хранилище
  • Глобальные помощники
  • HTTP-клиент
  • Локализация
  • Почтовые отправления
  • Уведомления
  • Разработка пакетов
  • Очереди
  • Планирование задач

• Безопасность

  • Аутентификация
  • Авторизация
  • Подтверждение адреса электронной почты
  • Шифрование
  • Хеширование
  • Сброс пароля

• База данных

  • Начало работы
  • Построитель запросов
  • Постраничная навигация
  • Миграции
  • Наполнение
  • Redis

• Eloquent ORM

  • Начало работы
  • Отношения
  • Коллекции
  • Мутаторы и типизация
  • Ресурсы API
  • Сериализация

• Тестирование

  • Начало работы
  • Тесты HTTP
  • Консольные тесты
  • Браузерные тесты
  • База данных
  • Имитация

• Пакеты

  • Breeze
    Легковесная реализация аутентификации Laravel для ознакомления с функционалом. Включает простые шаблоны Blade, стилизованные с помощью Tailwind CSS. Содержит маршруты для публикации.
  • Cashier (Stripe)
  • Cashier (Paddle)
  • Dusk
  • Envoy
  • Fortify
    Серверная реализация аутентификации Laravel. Не содержит никаких шаблонов. Используется в Laravel Jetstream.
  • Homestead
  • Horizon
  • Jetstream
    Красиво оформленный каркас приложений. Включает в себя Fortify и Sanctum.
  • Passport
  • Sail
  • Sanctum
    Легкая система аутентификации для SPA (одностраничных приложений), мобильных приложений и простых API на основе токенов. Управление токенами API, аутентификация сессии. Не содержит никаких шаблонов. Используется в Laravel Jetstream.
  • Scout
  • Socialite
    Аутентификация через провайдеров OAuth: Facebook, Twitter, LinkedIn, Google, GitHub, GitLab, и Bitbucket.
  • Telescope
  • Valet
• Документация API

Соглашения по переводу

В русской раскладке используются двойные кавычки в формате «слово».

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

Оглавление 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Исходный вариант	Вариации перевода	Замечания
A
abilities	полномочия, компетенции
accessors	аксессоры
argument	аргумент
asset pipeline	сценарий по сборки исходников
asset	исходник
assets	исходники	Директория исходных файлов проекта для фронтенда
atomic	атомарный, неделимый
attach (a relation)	назначить (отношение)
attaching	прикрепление, присоединение
attempting	пытается
authentication	аутентификация
authorization	авторизация
auto-incrementing ID	автоинкрементный идентификатор
B
backend	серверная часть
bag, message bag, attribute bag	коллекция, коллекция сообщений, коллекция атрибутов
binding	связывание
C
cache	кеш
casting	типизация
cast type	типизатор
chain	связать (например, методы)
chaining	цепочка (например, заданий)
chunking	разбиение
clauses	выражения
сlosure	замыкание
command bus	командная шина
command line interface (CLI)	интерфейс командной строки
commit	коммит, фиксация
composer	компоновщик, конструктор	Менеджер пакетов Composer не переводится
condition	условие
conditional	кондиционный
configuration	конфигурация, конфигурирование
constraints	ограничения, условия
contract	контракт
cookie	(файл) cookie
custom	ваш, пользовательский, желаемый, собственный
customization	настройка
customizing	корректировка, изменение
D
defining	определение
deployment	развертывание
detaching	отсоединение
directory	каталог, директория
dispatch	выполнение, исполнение, запуск, направление	Прежде всего «постановка в очередь»
dump	вывод, отображение
E
eager	нетерпеливый
encrypter	шифровальщик
encryption	шифрование
environment	среда, окружение
evaluated	проанализированы
event	событие
examining	изучение, исследование, интерпретация
exit code	код выхода / возврата
experience	опыт / продуктивность / возможности / удобство (разработки или разработчика)
F
facade	фасад
factory callbacks	хуки фабрики
fake	фальсификация, фальшивка
feature	функционал, особенность
filesystem	файловое хранилище, файловая система
fired	инициировано, сработано
flash data	кратковременные данные, флеш-данные	Данные, имеющие непродолжительный срок существования
flashed to the session	записаны (краткосрочно) в сессию
flexibility	гибкость
fluent	текучий, гибкий, последовательный
force	принудительно
foreign key constraints	ограничения внешнего ключа
G
gate	шлюз (авторизации)
generating	генерация	Незаменимо словом «создание». Предполагается генерация ч.-л. с использованием команд Artisan.
given	переданный, указанный, конкретный
guard	охранник (аутентификатора)
guarding	защита
H
hashing	хеширование
helpful	полезный
helpers	помощники, глобальные вспомогательные функции
hydrated	присоединены (включены в результирующий набор)	Например, в коллекцию при использовании генераторов на основе курсоров
J
job	задание, задача
job batching	пакетная обработка заданий
L
layer over	обертка над
lazy	отложенный
listener	слушатель
load balancer	балансировщик нагрузки
localization	локализация
log	журнал
logger	регистратор
logging	логирование
loose comparisons	гибкое сравнение	Противоположное strict comparisons
M
macro	макрокоманда
macroable	макропрограммируемый
maintenance mode	режим обслуживания
making	инициализация	Например, метод фабрики make инициализирует, но не создает запись о модели в БД.
manually	самостоятельно, вручную, по требованию
mapping	сопоставление, картирование, перебор, реже итерация
mass assignment	массовое присвоение
middleware	посредник
migration	миграция
migration squashing	сжатие миграций
miscellaneous	разное
mock	подставной объект
mocking	имитация
mutator	мутатор
N
named error bag	именованные коллекции ошибок
O
observers	наблюдатели
old input	прежний ввод
on-demand	по требованию, по запросу
optional	необязательный
options	параметры
overriding	переопределение
P
pagination	постраничная навигация, пагинация
payload	информационная часть данных (HTTP-запроса)
permanently	окончательно
placeholder	заполнитель, метка-заполнитель, символ-заполнитель, заменитель
policy	политика
power	возможность	В контексте о функциональности
progress bar	индикатор выполнения
production	эксплуатация
Q
query builder	построитель запросов
query constraints	ограничения запроса
queue	очередь
queueable	поочередный, последовательный
R
rate limit	предел (лимит) частоты
rate limiting	ограничение частоты
redirect	перенаправление
redirector	перенаправитель
refreshing	обновление
reflection	рефлексия (отражение)
release	релиз, выпуск, проброс (задания в очереди)	Не уточнено.
relationships	отношения
rendered	обработанный (HTML-код)
rendering	отображение, визуализация, рендеринг
replicating	репликация, тиражирование
request	запрос
resource	ресурс	Источник информации, например, API-ресурс
resources	ресурсы	Директория исходных файлов проекта для фронтенда
response	ответ
retrieving	получение, извлечение
route	маршрут
routing	маршрутизация
S
scaffold	каркас
scaffolding	каркасное программирование	Автоматизация по написанию кода на основе заготовок
skeleton	каркас
scope	область, сфера, диапазон	То, что имеет ограничения
seeding	наполнение
sequence	последовательность, серия
serialization	сериализация
service container	контейнер служб
service providers	поставщики служб
session	сессия
schema builder	построитель схемы
shortcut	ярлык, псевдоним
slug	дружественный URI (фрагмент URL-адреса)
soft deleting	программное удаление
Sometimes you may need, Sometimes you may wish	По желанию можно (может)
source maps	карты исходников
spy on an object	наблюдать за объектом
specific	конкретный, определенный
squashing	сжатие
staging	промежуточная (стадия разработки)
statement	оператор, выражение
starter kit	стартовый комплект
strict comparisons	жесткое сравнение	Противоположное loose comparisons
stub	заглушка, заготовка	«Заготовка» может употребляться, например, относительно пустого класса с нереализованными методами, а «заглушка» – в контексте тестов.
T
terms of service	условия использования
timestamp	временная метка
type-hinting	типизация (аргументов), объявление зависимостей
toggling	переключение
V
valid	действительный, допустимый
validation	валидация, проверка
validator	валидатор
vendor	поставщик	Директория vendor с библиотеками от сторонних поставщиков
verb, HTTP	HTTP-метод
verification	подтверждение
view	шаблон, представление
W
wildcard	метасимвол подстановки
work factor	коэффициент работы
queue worker	обработчик очереди
Y
yield	дополнение, дополнять