Руководства Ruby on Rails
v8.1Ruby on Rails — это веб-фреймворк с открытым кодом, от которого программисты становятся счастливыми, код — красивым, а разработка — устойчивой и быстрой.
На этом сайте выложены переводы официального руководства по Rails. Надеемся, эти руководства позволят вам немедленно приступить к использованию Rails и помогут разобраться, что и как в нём работает.
Переводы постоянно актуализируются и добавляются. Код проекта и тексты переводов открыты и размещены на Гитхабе. Желающим помочь всегда рады! Форкайте, предлагайте изменения, вносите их, отправляйте пул-реквесты!
Это перевод Ruby on Rails Guides для версии Rails 8.1. Переводы для ранних версий доступны на Гитхабе: Rails 7.1, 7.0, 6.1, 6.0, прочие версии.
С чего начать
Модели
Это руководство поможет начать работать с моделями, сохранять в базу данных и расскажет о паттернах и библиотеке Active Record.
Миграции Active RecordКак использовать миграции Active Record, чтобы привести свою базу данных к структурированной и организованной форме.
Валидации Active RecordКак использовать валидации Active Record.
Колбэки Active RecordКак использовать колбэки (методы обратного вызова) Active Record.
Связи (ассоциации) Active RecordВсе связи, предоставленные Active Record.
Интерфейс запросов Active RecordИнтерфейс запросов к базе данных, предоставленный Active Record.
Основы Active ModelИспользование моделей классов без Active Record.
Вью
Введение в Action View.
Макеты и рендеринг в RailsОсновные возможности макетов Action Controller и Action View, включая рендеринг и перенаправление, content_for и частичные шаблоны.
Хелперы Action ViewЗнакомство с некоторыми из многих хелперов вью.
Хелперы форм в Action ViewРуководство по использованию встроенных хелперов форм.
Контроллеры
Как работают контроллеры и как они вписываются в цикл запроса. Сессии, фильтры, куки, потоковые данные, исключения.
Action Controller: продвинутые темыПродвинутые возможности Action Controller.
Роутинг в RailsОткрытые для пользователя функции роутинга. Если хотите понять, как использовать роутинг в вашем приложении на Rails, начните отсюда.
Другие компоненты
Документирует расширения ядра Ruby, определённые в Active Support.
Основы Action MailerКак использовать Action Mailer для отправки электронной почты.
Основы Action MailboxКак использовать Action Mailbox для получения электронной почты.
Обзор Action TextКак использовать Action Text для обработки содержимого обогащённого текста.
Основы Active JobВсё, что нужно, чтобы начать создавать, ставить в очередь и запускать фоновые задания.
Обзор Active StorageКак прикреплять файлы к моделям Active Record.
Обзор Action CableКак работает Action Cable и как использовать WebSockets для создания функционала в реальном времени.
Копаем глубже
Как добавить интернационализацию в ваше приложение: переводы, правила множественного числа, форматы дат.
Тестирование приложений на RailsПолное руководство по тестированию в Rails — от «Что такое тест?» до интеграционного тестирования.
Отладка приложений на RailsКак отлаживать приложения на Rails и как понять что происходит «за кулисами».
Конфигурирование приложений на RailsОсновные конфигурационные настройки для приложения на Rails.
Командная строка RailsИнструменты командной строки, предоставленные Rails.
Asset PipelineДокументирует конвейер ресурсов (asset pipeline).
Работа с JavaScript в RailsВстроенная в Rails функциональность Ajax/JavaScript.
Процесс инициализации в RailsВнутренние процессы инициализации в Rails.
Автозагрузка и перезагрузка константКак работает автозагрузка и перезагрузка констант (режим Zeitwerk).
Инструментарий Active SupportКак использовать инструменты Active Support API для отслеживания событий внутри Rails или другого кода на Ruby.
Использование Rails для API-приложенийКак эффективно использовать Rails для разработки приложения JSON API.
Запуск в продакшен
Подбор настроек приложения и инфраструктуры для оптимальной работы в продакшене.
Кэширование с Rails: ОбзорВведение в ускорение вашего приложения на Rails с помощью кэширования.
Безопасность приложений на RailsОбщие проблемы безопасности в веб-приложениях и как избежать их в Rails.
Отчёт об ошибках в приложениях RailsСпособы управления исключениями, которые случаются в приложениях Ruby on Rails.
Продвинутый Active Record
Специфика использования PostgreSQL с Active Record.
Несколько баз данных с Active RecordИспользование нескольких баз данных в вашем приложении.
Шифрование Active RecordШифрование информации в базе данных с использованием Active Record.
Составные первичные ключиИспользование составных первичных ключей в Active Record.
Расширяем Rails
Как создать плагин, расширяющий функциональность Rails.
Rails on RackИнтеграция Rails и Rack и взаимодействие с другими компонентами Rack.
Создание и настройка генераторов и шаблонов RailsПроцесс добавления нового генератора или представления альтернативного элемента для встроенного в Rails генератора.
Engine для начинающихКак написать монтируемый engine.
Треды и выполнение кода в RailsНеобходимые требования и инструменты при работе напрямую с конкурентностью в приложении Rails.
Вносим вклад в Ruby on Rails
Rails — это не «чей-то там фреймворк». Многообразие способов быть вовлечённым в продолжающуюся разработку Rails.
Рекомендации по документированию APIРекомендации для документации Ruby on Rails.
Рекомендации для руководств по Ruby on RailsРекомендации для руководств по Ruby on Rails.
Установка зависимостей для разработкиКак настроить среду для разработки ядра Ruby on Rails.
Политика поддержки версийКакие версии Ruby on Rails поддерживаются и когда ожидать новые версии.
Заметки о релизах
Как апгрейдить приложение до последних версий Ruby on Rails.
Версия 8.1 — ?Заметки о релизе Rails 8.1.
Версия 8.0 — Ноябрь 2024Заметки о релизе Rails 8.0.
Версия 7.2 — Август 2024Заметки о релизе Rails 7.2.
Версия 7.1 — Октябрь 2023Заметки о релизе Rails 7.1.
Версия 7.0 — Декабрь 2021Заметки о релизе Rails 7.0.
Версия 6.1 — Декабрь 2020Заметки о релизе Rails 6.1.
Версия 6.0 — Август 2019Заметки о релизе Rails 6.0.
Версия 5.2 — Апрель 2018Заметки о релизе Rails 5.2.
Версия 5.1 — Апрель 2017Заметки о релизе Rails 5.1.
Версия 5.0 — Июнь 2016Заметки о релизе Rails 5.0.
Версия 4.2 — Декабрь 2014Заметки о релизе Rails 4.2.
Версия 4.1 — Апрель 2014Заметки о релизе Rails 4.1.
Версия 4.0 — Июнь 2013Заметки о релизе Rails 4.0.
Версия 3.2 — Январь 2012Заметки о релизе Rails 3.2.
Версия 3.1 — Август 2011Заметки о релизе Rails 3.1.
Версия 3.0 — Август 2010Заметки о релизе Rails 3.0.