norman/friendly_id

Что это?

Ключевые возможности

• 01Генерирует слаги на основе атрибутов модели и хранит их в отдельном столбце.
• 02Позволяет методу find принимать как слаг, так и числовой первичный ключ.
• 03Хранит историю слагов, чтобы старые URL продолжали открываться.
• 04Поддерживает слаги с ограниченной областью действия, зарезервированные слова и пользовательские генераторы слагов.
• 05Поддерживает i18n для слагов.

Сценарии использования

• Создание страниц Rails, URL которых содержат название товара, пользователя или статьи вместо ID.
• Сохранение старых ссылок после изменения заголовка записи с помощью истории слагов.
• Добавление удобочитаемых постоянных ссылок в существующее приложение Rails, в котором уже есть записи.

Быстрый старт

1. 1

   Добавьте gem в Gemfile

2. 2

   Установите зависимости

   bundle install
3. 3

   Создайте файл конфигурации и миграцию FriendlyId

   rails generate friendly_id
4. 4

   Выполните миграции

   rails db:migrate

Что важно знать

• !Работает только с Ruby on Rails и моделями Active Record.
• !После добавления FriendlyId для существующих записей необходимо вручную создать слаги.

Темы

Частые вопросы

Что такое friendly_id?

Ruby-гем для Active Record, который генерирует читаемые слаги и позволяет искать модели по строке, например имени, вместо числового ID. FriendlyId — Ruby-гем для Active Record, который создает удобочитаемые URL-слаги на основе атрибутов модели. С ним URL вида /states/washington может заменить адрес с числовым первичным ключом, например /states/4323454, а метод find модели принимает оба варианта.

friendly_id можно использовать бесплатно? Какая у него лицензия?

friendly_id распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

friendly_id всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в friendly_id — 18 авг. 2026 г..

Для чего можно использовать friendly_id?

Создание страниц Rails, URL которых содержат название товара, пользователя или статьи вместо ID. Сохранение старых ссылок после изменения заголовка записи с помощью истории слагов. Добавление удобочитаемых постоянных ссылок в существующее приложение Rails, в котором уже есть записи.

Как установить friendly_id?

Добавьте gem в Gemfile Установите зависимости: bundle install Создайте файл конфигурации и миграцию FriendlyId: rails generate friendly_id Выполните миграции: rails db:migrate

Где скачать friendly_id?

Исходный код и инструкции по установке — на GitHub: https://github.com/norman/friendly_id