Підручник Ruby on Rails для початківців із проектом і прикладом

Його створив Девід Хайнемейєр Хассон, відомий як DHH. Це один із найвпливовіших і популярних інструментів для створення веб-додатків. Його використовують деякі улюблені сайти, такі як Airbnb, Github, Shopify тощо.

Чому Rails?

Ось плюси та переваги використання Rails:

• Rails упаковано як камінь Ruby, і ви можете використовувати його для створення різноманітних програм.
• Це дозволяє створювати звичайні веб-програми, програми електронної комерції, системи керування вмістом тощо.
• Rails — це фреймворк із повним стеком, який містить усе необхідне для створення веб-додатку, керованого базою даних, за допомогою шаблону Model-View-Controller.
• Це означає, що всі рівні створено для бездоганної роботи разом із меншою кількістю коду. Він вимагає менше рядків коду, ніж інші фреймворки.

Як завантажити та встановити Ruby на Windows

Процес встановлення залежатиме від вашої операційної системи. Ви пройдете інсталяцію Ruby на Windows, Mac та Linux.

Крок 1) Завантажте Rubyinstaller
Найпростіший спосіб інсталювати Ruby на вашому Windows на комп’ютері через інсталятор Ruby, який можна завантажити за адресою https://rubyinstaller.org/.

Все, що вам потрібно зробити, це запустити завантажений інсталятор.

Крок 2) Натисніть на завантажений інсталятор
Double-клацніть завантажений інсталятор "rubyinstaller-2.4.1-2-x64.exe".

Крок 3) Прийміть ліцензію
Виберіть перемикач «Я приймаю ліцензію» та натисніть кнопку «Далі». Це повинно привести вас до наступного малюнка нижче:

Крок 4) Поставте перші два прапорці
Позначте перші два прапорці, щоб спростити виконання сценаріїв Ruby.

Натисніть кнопку «Встановити», щоб розпочати встановлення. Після завершення інсталяції ви повинні побачити малюнок нижче.

Крок 5) Натисніть кнопку Готово
Не знімайте прапорець, який встановлює MSYS2. Натисніть «Готово», щоб завершити інсталяцію, і відобразиться вікно командного рядка, показане на малюнку нижче.

Крок 6) Встановлює MSYS2
На цьому кроці встановлюється MSYS2, платформа для створення, яка містить менеджер пакетів для легкого встановлення пакетів Windows.

Натисніть Enter, щоб інсталювати всі компоненти, оскільки всі вони потрібні для роботи в середовищі розробки Ruby on Rails. Windows.

Встановлення рейок

У вас повинен бути встановлений Ruby з попереднього розділу, а тепер ви збираєтеся встановити Rails. Ви можете встановити Rails за допомогою пакета з RailsInstaller, але проблема полягає в тому, що ви не отримуєте останню версію необхідних пакетів.

Якщо у вас уже встановлено останню версію Ruby та базовий набір необхідних RubyGems і розширень. Все, що вам зараз потрібно зробити, це виконати таку команду в командному рядку, щоб отримати Rails у вашій системі: 'gem install rails.'

Вам також потрібно буде встановити Node.js якщо у вас його ще немає, оскільки деякі бібліотеки, від яких залежить Rails, вимагають a Javascript час виконання для правильної роботи. Ви можете отримати вузол за адресою https://nodejs.org.

Це більш поширений і бажаний підхід до розробки Windows. Спільнота Rails використовує a Windows Підсистема для Linux, яка забезпечує середовище GNU/Linux із інструментами командного рядка, утилітами та звичайними програмами безпосередньо на Windows.

Встановлення Ruby на Mac

На вашому Mac уже попередньо встановлено Ruby. Однак попередньо встановлена ​​версія може бути старою, тому вам потрібно буде встановити нову/останню версію.

Найпростіший спосіб зробити це за допомогою менеджера пакетів, наприклад Homebrew. Можливо, спочатку потрібно встановити Homebrew, виконавши наведену нижче команду в терміналі.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)

Це відобразить попередження та попросить вас ввести пароль. Введіть свій пароль Mac (ви не побачите символів під час введення). Просто натисніть «Enter», коли закінчите вводити пароль. Потім запустіть цю просту команду Homebrew, щоб установити Ruby на вашому Mac.

brew install ruby

А також запустіть цю команду:

echo "export PATH="/usr/local/bin:/usr/local/sbin:$PATH >> ~/.bash_profile

Щоб встановити цю установку Ruby як Ruby за замовчуванням для запуску у вашій системі, а не попередньо встановлений Ruby.

Щоб переконатися, що інсталяція пройшла успішно, ви можете запустити наступне в терміналі

ruby --version

це виведе номер версії Ruby, яку ви встановили. Вихід буде виглядати приблизно так

ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-darwin18]

Встановлення Ruby на Ubuntu (Linux)

Найпростіший спосіб інсталювати Ruby на вашому Ubuntu система через відповідний менеджер пакетів. Вам потрібно виконати наступні команди в терміналі, щоб інсталювати останню версію Ruby Ubuntu сховища.

• оновлення sudo apt – Це оновить значення за замовчуванням Ubuntu сховища
• sudo apt install ruby-full – Він завантажить і встановить останню версію Ruby

Щоб переконатися, що інсталяція пройшла успішно, ви можете виконати наступне "ruby –версія", це надрукує версію Ruby, яку ви встановили.

Встановлення Rails на Ubuntu (Linux)

Ви повинні виконати наведені нижче кроки, щоб успішно встановити Rails на вашій машині Linux.

Крок 1) Оновіть менеджер дорогоцінних каменів комп’ютера, запустивши 'gem update – system' у терміналі або командному рядку.

Крок 2) прогін 'gem install rails' щоб інсталювати останню версію Rails на вашому комп’ютері.

Крок 3) Вам слід інсталювати gem-пакет для легкого керування залежностями gem-додатків Rails. бігти "gem install bundler" щоб отримати його.

Два принципи Rails

Rails дотримується основних принципів проектування програмного забезпечення та заохочує вас також використовувати ці принципи.

Два найпоширеніші:

• Не повторюйтеся (DRY) – це змусить вас писати стислий, послідовний і підтримуваний код.
• Convention over Configuration – Rails попередньо налаштовано на використання розумних параметрів за замовчуванням, які відповідають найбільш поширеному використанню. Це пришвидшує розробку вашої програми, а також має менше коду для обслуговування.

Rails – Структури файлів проекту

Завдяки тому, що Rails тепер встановлено у вашій системі, ви можете створити додаток Rails! У цьому підручнику Ruby on Rails ми дізнаємося про приклади Ruby on Rails і про те, як створити додаток зі списком завдань. Виконайте наступну команду 'rails new todo_app' у вашому терміналі, щоб створити програму.

Ця команда створює каталог під назвою 'todo_app' у поточному каталозі з базовою структурою папок веб-програми Rails, як показано на малюнку нижче:

Ви пройдете основні каталоги в цьому прикладі Ruby on Rails.

додаток – Цей каталог групує за допомогою різних підкаталогів для інтерфейсу користувача/макета (перегляди та допоміжні засоби), контролера (файли контролерів) і моделей (бізнес/логіка програми).

додаток/контролери – У цьому каталозі зберігаються файли контролера, які використовуються Rails для обробки запитів від клієнта.

додаток/активи – Містить статичні файли, які потрібні для інтерфейсу програми, згруповані в папки відповідно до їх типу – JavaScript файли, зображення та таблиці стилів.

додаток/помічники – Цей підкаталог містить допоміжні функції, які роблять вашу модель програми, представлення та логіку контролера зосередженими, маленькими та незавантаженими.

додаток/моделі – Це містить файли

які моделюють базу даних вашої програми. Класи моделі дуже спрощують роботу з базою даних.

додаток/перегляди – Це файли шаблонів/макетів, з якими взаємодіє користувач вашої програми. Шаблони є комбінацією HTML і даних із бази даних.

bin – Він містить сценарії Rails, які запускають вашу програму. Він також може містити інші сценарії, які ви використовуєте для налаштування та оновлення програми.

Конфігурація – Тут містяться конфігураційні файли – database.yml, environment.rb, routes.rbтощо, які потрібно запустити вашій програмі.

БД – Цей каталог містить файли/сценарії, які використовуються для керування базою даних програми.

lib – Цей каталог містить розширений модуль для вашої програми.

журнал – Він містить файли журналів – server.log, development.log, test.log і production.logтощо, які використовуються для налагодження чи моніторингу вашої програми.

аудиторія - Цей каталог містить статичні файли та скомпільовані ресурси, такі як файли HTML, Javascript файли, зображення та таблиці стилів.

тест – У цьому каталозі зберігаються тестові файли, які ви пишете для перевірки функціональності програми.

tmp – Цей каталог містить тимчасові файли, такі як файли кешу та pid.

постачальник – Цей каталог містить сторонні бібліотеки.

Gemfile – Цей файл визначає основні вимоги до gem для запуску веб-додатку. Ви можете згрупувати дорогоцінні камені в розробку, тестування або виробництво, і Rails знатиме, коли включити кожен камінь.

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

Readme.md – Ви використовуєте цей файл, щоб надати важливу інформацію про свою програму, наприклад, що робить програма, як встановити та запустити програму.

Rakefile – Цей файл містить різні визначення завдань rake, які допомагають автоматизувати повсякденні завдання адміністрування вашої програми.

config.ru – Це файл конфігурації Rack, який надає інтерфейс веб-серверу для запуску програми.

Змініть каталог на 'todo_app' каталог Rails створено та запущено 'rails server' щоб запустити програму. Тип localhost: 3000 в адресному рядку веб-переглядача ви повинні побачити малюнок нижче, якщо все пройшло добре.

Це домашня сторінка вашої програми за умовчанням, і ви зміните це в наступному розділі цього підручника Ruby on Rails. Ви можете зупинити сервер, натиснувши "Ctrl-C".

Rails – генеруйте команди

Команда Rails generate використовує шаблони для створення безлічі корисних речей у вашій програмі. Ви можете використовувати ці генератори, щоб заощадити багато часу.

Це допомагає шляхом написання шаблонного коду, коду, необхідного для роботи вашої веб-програми. Ви можете бігти "генерувати рейки" у командному рядку або терміналі, щоб переглянути список доступних генераторів, як показано нижче:

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

Ви будете використовувати команду rails generate scaffold для автоматичного створення моделі, представлення та контролера для програми зі списком завдань, яку ви створюєте. бігти'рейки генерують scaffold todo_list title:string description: text' у вашому терміналі (переконайтеся, що ви все ще перебуваєте в каталозі todo_app).

Це створить повний веб-інтерфейс CRUD (створення, читання, оновлення та видалення) для таблиці TodoLists.

Ще одна корисна команда, яку слід знати "рейки руйнують", це змінює будь-що "рейки генерують..." робить.

Рейки – маршрутизація

Система маршрутизації Rails, rails router, обробляє всі вхідні запити до вашої веб-програми. Він робить це шляхом перевірки URL-адреси вхідних запитів, а потім зіставляє кожен запит із дією контролера, відповідальною за його обробку, використовуючи спеціальний синтаксис, указаний у файлі маршрутів (config / routes.rb).

Файл маршрутів допомагає контролювати кожен аспект URL-адреси вашої веб-програми. Rails за замовчуванням використовує дизайн RESTful, заснований на архітектурному стилі REST, який забезпечує відображення між дієсловами HTTP та запитами (URL) на дії контролера.

Файл маршрутів було згенеровано під час запуску "рейки нові" у попередньому розділі цього посібника. Продовжуючи програму Todo, яку ви створюєте, виконайте наступне'rails db:migrate' (незабаром ви дізнаєтеся, що це робить)

У командному рядку переконайтеся, що ви все ще перебуваєте в корені програми (каталог todo_app).

Потім знову запустіть сервер за допомогою 'rails server'. Тип http://localhost:3000/todo_lists/ у вашому браузері та натисніть Enter. Ви повинні повернути веб-сторінку, як показано на малюнку нижче прикладу Ruby on Rails:

Це подання списків Todo, створене командою scaffold, і ним керує дія індексу TodoListsController.

Додайте список завдань, клацнувши «Новий список справ» на сторінці. Ви повинні отримати сторінку, як показано нижче:

Зверніть увагу, що URL-адресу змінено на http://localhost:3000/todo_lists/new. Це сторінка для створення нового списку завдань, і вона керується новим методом/дією TodoListsController.

Введіть назву й опис списку завдань у форму та натисніть кнопку «Створити список завдань». URL-адреса має змінитися на http://localhost:3000/todo_lists/1, показано на малюнку нижче прикладу коду Ruby on Rails:

Це сторінка відображення списку завдань, і нею керує метод/дія TodoListsController. Якщо повернутися до http://localhost:3000/todo_lists/, тепер ви повинні побачити малюнок нижче з доданим новим списком справ:

Rails вдалося відобразити різні запити (URL-адреси) на відповідну дію TodoListsController, використовуючи визначення маршруту в config/routes.rb.

Якщо ви поглянете на цей файл, ви побачите один рядок 'resources: todo_lists', це спосіб Rails за замовчуванням для написання спокійних маршрутів. Цей єдиний рядок створює сім маршрутів, які відображаються на контролер TodoLists.

Згідно з угодою, кожна дія контролера також відображається на певну операцію CRUD (Створення, читання, оновлення та видалення) у базі даних.

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

Рейки – види

Рівень перегляду є одним із компонентів парадигми MVC і відповідає за генерацію відповіді HTML для кожного запиту до вашої програми. Rails за замовчуванням використовує ERB (Embedded Ruby), яка є потужною системою шаблонів для Ruby.

ERB робить написання шаблонів простим і зручним для обслуговування завдяки поєднанню звичайного тексту з кодом Ruby для заміни змінних і керування потоком. Шаблон ERB має розширення .html, .erb або .erb.

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

Тег зі знаком рівності '<%= %>' вказує на те, що вбудований код є виразом і що результат коду має бути замінений рендерером, коли він рендерить шаблон.

Інший тег без знака рівності '<% %>' вказує рендереру, що результат коду не слід замінювати/друкувати під час рендерингу шаблону.

Кожен контролер у вашій програмі Rails має відповідний підкаталог додаток/перегляди, а кожна дія/метод у контролері має відповідний файл .html і .erb у цьому каталозі.

Подивіться на додаток/перегляди програми Todo, яку ви створюєте. Ви знайдете підкаталог під назвою 'todo_lists' у цьому підкаталозі .html.erb файли з іменами, що відповідають діям/методам у TodoLists контролера.

Rails – ActiveRecord, Active Record Pattern і ORM

ActiveRecord — це реалізація Ruby шаблону Active Record, який є простим шаблоном, де клас представляє таблицю, а екземпляр класу — рядок у цьому класі.

ActiveRecord у народі називають ORM (Object Relational Mapping), технікою, яка дозволяє вам керувати базою даних за допомогою мови, яка вам найбільш зручна. Він агностик баз даних, тому ви можете легко перемикатися між базами даних (наприклад SQLite, MySQL, PostgreSQL, SQL Server, Oracleтощо). Цей набір більше відповідає вимогам вашої програми з тим самим кодом/логікою.

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

Для цього вам просто потрібно ввести «TodoList.all» а Active Record надає вам масив, заповнений об’єктами TodoList, з якими ви можете грати як завгодно.

Все, що вам потрібно зробити, це налаштувати правильну конфігурацію config / database.yml, і Active Record розгляне всі відмінності між різними системами баз даних. Тому, коли ви переходите з одного на інший, вам не потрібно думати про це.

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

Rails множить імена класів ваших моделей, щоб знайти відповідну таблицю бази даних. Отже, для класу TodoList ActiveRecord створить таблицю бази даних під назвою TodoLists.

Рейки – міграції

Rails migration — це просто сценарій, який ви використовуєте для редагування бази даних програми. Він використовується для налаштування або зміни бази даних і дозволяє уникнути ручного написання коду SQL для цього.

Він використовує Ruby для визначення змін у схемі бази даних і дає можливість використовувати контроль версій для підтримки синхронізації бази даних.

Rails Migrations використовує Ruby Domain Specific Language (DSL). Це діє як абстракція та дає можливість використовувати або змінювати систему бази даних відповідно до ваших вимог.

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

Rails – асоціації ActiveRecord

Зв'язок між двома моделями ActiveRecord називається асоціацією. Асоціація значно полегшує виконання операцій над різними записами у вашому коді. Його можна розділити на чотири категорії: –

Один до одного: – Це означає, що запис містить точно один екземпляр іншої моделі. Хорошим прикладом є профіль користувача. Користувач має тільки один профіль. Це використовує має _один keyword.

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

Багато до багатьох: – Цей зв’язок дещо складніший, і ActiveRecord пропонує два способи його обробки. Використовуючи has_and_belongs_to_many та має багато, який дає вам доступ до відношення, визначеного в окремій таблиці.

Поліморфний один до багатьох:- Це більш розширена асоціація, доступна вам у Rails. Ви можете використовувати його для визначення моделі, яка може належати до багатьох різних моделей в одній асоціації.

Rails – Перевірки ActiveRecord

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

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

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

Наступні методи ActiveRecord викликають перевірки під час використання або виклику для об’єктів моделі – створювати, створювати!, зберігати, зберігати!, оновлювати і оновлювати!. Ті, що з чубчиком (твори!, зберігай! і оновлення!) викликати виняток, якщо запис недійсний, а thothen't'tt't't.

Найпоширенішими помічниками перевірки ActiveRecord у вашому розпорядженні є:-

Підтвердження:– Цей помічник перевірки корисний для перевірки того, що два поля мають однаковий запис. наприклад, пароль і підтвердження пароля, він використовується разом із помічником перевірки присутності.

Присутність:– Це перевіряє, чи поле не пусте.

унікальність: забезпечує унікальне значення для поля, наприклад, імені користувача

Довжина: - Щоб застосувати обмеження на довжину символів поля

Ви також можете створити спеціальну перевірку, використовуючи метод validate і передавши йому назву спеціального методу перевірки.

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

Rails – ActionController

Контролер Rails є центром вашої веб-програми. Це полегшує та координує спілкування між користувачем, моделями та представленнями.

Ваші класи контролерів успадковуються від ApplicationController, який містить код, який можна запускати в усіх інших контролерах, і він успадковується від класу ActionController.

Контролер надає наступне для вашої програми:

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

Рейки – конфігурації

Ви можете налаштувати різні компоненти, такі як ініціалізатори, ресурси, генератори, проміжне програмне забезпечення тощо. За допомогою ініціалізаторів додатків Rails та файлів конфігурації в каталозі конфігурації. Такі файли, як config/application.rb, config/environments/development.rb і config/environments/test.rb тощо. Ви також можете налаштувати спеціальні параметри для своєї програми.

Rails – налагодження

Коли ви створите свою програму, настане час, коли вам знадобиться/потрібно буде налагодити код. Рейки полегшують це за допомогою каменю byebug. Ви можете почати сеанс налагодження, розмістивши ключове слово 'byebeg' у будь-якому місці коду програми.

Це призведе до тимчасової зупинки виконання на цьому етапі. Byebug gem надає кілька команд для використання. Найкорисніші з них:

• наступний: команда, яка дозволяє переходити до наступного рядка коду, пропускаючи всі методи, викликані виконанням поточного рядка.
• крок: це схоже на команду «наступний», але змусить вас переходити до кожної викликаної команди.
• перерву: це зупиняє виконання коду.
• продовжувати продовжує виконання коду.

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

Є файли журналів, які ви можете перевірити на наявність помилок у виробництві та обробити їх. Крім того, ви повинні дотримуватися підходу TDD (Test-driven development) під час розробки програми, щоб переконатися, що все працює належним чином перед розгортанням у виробництві.

Підсумки

• Ruby — чиста об'єктно-орієнтована мова програмування
• Ruby має елегантний синтаксис, який легко читати та писати.
• Rails — це платформа розробки, написана на Ruby, для створення веб-додатків
• Процес встановлення залежатиме від вашої операційної системи.
• Rails упаковано як камінь Ruby, і ви можете використовувати його для створення різноманітних програм.
• У цьому підручнику ви створите програму зі списком справ. Щоб створити програму, запустіть наступну команду «rails netoda'p'p'p» у своєму терміналі.
• Команда Rails generate використовує шаблони для створення безлічі корисних речей у вашій програмі.
• Система маршрутизації Rails, маршрутизатор rails допомагає вам обробляти всі вхідні запити до вашої веб-програми.
• Рівень перегляду є одним із компонентів парадигми MVC і відповідає за генерацію відповіді HTML для кожного запиту до вашої програми.
• ActiveRecord — це реалізація шаблону Active Record у Ruby.
• Rails migration — це просто сценарій, який ви використовуєте для редагування бази даних програми.
• Зв'язок між двома моделями ActiveRecord називається асоціацією.
• Перевірка допомагає переконатися, що у вас є правильні дані, оскільки робота з неправильними даними є жахливою річчю і може втрачати ваші гроші та бізнес.
• Контролер Rails допомагає вам полегшити та координувати зв’язок між користувачем, моделями та представленнями.
• Rail допомагає вам налаштувати різні компоненти, такі як ініціалізатори, активи, генератори, проміжне програмне забезпечення тощо.