Ruby on Rails入門:CRUDアプリの骨格を作る手順

Ruby on Rails入門:CRUDアプリの骨格を作る手順 Ruby on Rails

こんにちは!ともです。「データをためて、一覧で見て、直したり消したりできるWebアプリ」を作ろうとすると、画面も保存の仕組みも全部自分で用意する必要があって、最初の一歩が重くなりがちです。

この記事では、Rubyのフレームワーク「Ruby on Rails(ルビーオンレイルズ)」を使い、登録・表示・編集・削除という基本操作(CRUD)の骨格を、自動生成の仕組みで一気に作ります。「決まった型に沿えば、土台はコマンドで用意できる」というRailsの考え方を体験する作例です。

フレームワーク自体が初めての場合は、先に全体像の記事で考え方を押さえておくと読みやすくなります。

フレームワークとは何か

この記事で分かること

この記事で分かること
この記事で分かること
  • Railsで作るCRUDアプリの完成形
  • 必要なものとコスト
  • RubyとRailsのインストール手順
  • 雛形を自動生成するコマンド(scaffold)の使い方
  • 画面での動作確認と、自動生成された部品の役割

完成品のイメージ:一覧・登録・編集・削除が一通りそろう

完成品のイメージ:一覧・登録・編集・削除が一通りそろう
完成品のイメージ:一覧・登録・編集・削除が一通りそろう

完成すると、メモを管理するWebアプリが手に入ります。トップにはメモの一覧が出て、新規登録の画面、1件ごとの表示画面、編集画面、削除のボタンまで一通りそろっています。登録したデータはデータベースに保存されるので、サーバーを止めても消えません。

ポイントは、この一式の多くを自分で書かないことです。Railsには「scaffold(足場)」という自動生成の仕組みがあり、データの型を指定すると、一覧・登録・編集・削除に必要なファイルの雛形をまとめて作ってくれます。まずは生成された骨格を動かし、あとから中身を読むのがRails流の入り方です。

必要なものとコスト

必要なものとコスト
必要なものとコスト

RubyもRailsも無料で公開されているオープンソースです。自分のパソコンの中で動かす範囲では、料金はかかりません。

項目内容
使うツールRuby/Ruby on Rails/SQLite(初期設定のデータベース)
料金の目安無料(約0円)
前提Mac、またはWSL2を用意したWindows/ターミナルの基本操作

バージョンの目安として、2026年11月時点でRailsの現行系列は8.1系です。Rails 8.1系にはRuby 3.2以上が必要で、実際には長く使える3.3系や3.4系を用意するのが無難です。細かなバージョンの対応は変わりやすいため、導入時に公式サイトで最新を確認してください。

言語そのものがどんな位置づけかを確認したい場合は、言語全体の記事もあわせてどうぞ。

プログラミング言語とは何か

難易度と進め方の目安

難易度と進め方の目安
難易度と進め方の目安

難易度は中くらいです。生成されるファイルが多い分、最初は「何がどこにあるか」で迷いやすくなります。ただし、書くコマンド自体は少なく、目安の所要時間は初期設定込みで1時間30分前後です。

進め方は「Rubyの導入→Railsの導入→プロジェクト作成→雛形の自動生成→データベースへの反映→動作確認」の順番です。エディタはVS Codeがあると、生成されたファイルの確認がしやすくなります。

VS Codeのインストールと初期設定

インストール・初期設定

インストール・初期設定
インストール・初期設定

Railsを使うには、先に言語のRubyを用意します。Macの場合は、バージョン管理の道具(rbenvなど)経由で入れるのが一般的です。Windowsの場合は、公式のガイドでも推奨されているWSL2(Windowsの中でLinuxを動かす仕組み)の中で用意するのが基本になります。

# バージョン管理の道具 rbenv で、Ruby 3.4系をインストールする(少し時間がかかる)
# バージョンは、パッチ版まで含めた完全な番号で指定する(数字は一例)
rbenv install 3.4.8

# このパソコン全体で使うRubyとして、入れたバージョンを指定する
rbenv global 3.4.8

# Rubyのバージョンを表示して確認する
ruby -v

Rubyが入ったら、Rails本体を入れます。Railsは「gem」という部品の形で配られています。

# Railsをインストールする(gem はRubyの部品を管理する道具)
gem install rails

# Railsのバージョンを表示して確認する
rails -v

# 新しいプロジェクトを作る(memo-app という名前のフォルダができる)
rails new memo-app

# できたプロジェクトのフォルダへ移動する
cd memo-app

これで土台ができました。プロジェクトの中には、最初からフォルダ分けされた一式が入っています。次は、この土台の上にメモ機能の骨格を自動生成します。

作り方の骨格1:scaffoldでCRUDの雛形を生成する

作り方の骨格1:scaffoldでCRUDの雛形を生成する
作り方の骨格1:scaffoldでCRUDの雛形を生成する

メモ機能の骨格は、コマンド1つで生成します。「Memo」というデータに、タイトル(文字列)と本文(テキスト)の項目を持たせる指定です。

# メモのCRUD一式(画面・処理・データの型)を自動生成する
rails generate scaffold Memo title:string body:text

# 生成されたデータの型を、データベースへ反映する
rails db:migrate

# 開発サーバーを起動する
rails server

ブラウザで http://localhost:3000/memos を開くと、メモの一覧画面が表示されます。「New memo」から登録でき、一覧から表示・編集・削除も試せます。これがCRUDの骨格です。

生成された部品のうち、中心になるのが「データの型」を表すファイル(app/models/memo.rb)です。中身はほぼ空で、「型であること」自体が役割になっています。

# メモのデータの型を表すファイル(項目の定義はデータベース側が持つ)
class Memo < ApplicationRecord
  # ここに「タイトルは必須」などの決まりを追加していく
end

画面と処理をつなぐ住所の対応表(config/routes.rb)にも、メモ用の行が自動で追加されています。

# アプリの住所(URL)と処理の対応表
Rails.application.routes.draw do
  # メモのCRUDに必要な住所一式をまとめて登録する
  resources :memos
end

「resources :memos」の1行で、一覧・表示・新規・編集・削除に必要な住所がまとめて用意されます。この「まとめて用意される」感覚が、Railsの型に沿う進め方です。

生成されたファイルは、役割ごとに置き場所が決まっています。処理を担うのは app/controllers/memos_controller.rb で、一覧・表示・登録・編集・削除の動作が最初から書かれています。画面は app/views/memos/ の中に、一覧用・表示用・入力用と分かれて置かれています。入力の枠組み(フォーム)だけは一覧・編集で共用する部品として切り出されているため、「共通部分は1か所にまとめる」という型も、生成物の時点で体現されています。どこを直せば何が変わるかは、この置き場所の対応で追えるようになっています。

作り方の骨格2:決まりを1つ足して、生成物を読む

作り方の骨格2:決まりを1つ足して、生成物を読む
作り方の骨格2:決まりを1つ足して、生成物を読む

自動生成の骨格に、決まりを1つだけ足してみます。「タイトルが空のメモは登録できない」という決まりです。app/models/memo.rb に1行追加します。

# メモのデータの型を表すファイル
class Memo < ApplicationRecord
  # タイトルが空欄のデータは、保存できないようにする決まり
  validates :title, presence: true
end

サーバーを起動し直し(開発中は自動で読み直されます)、タイトルを空にして登録してみると、エラーが表示されて保存されません。「決まりはデータの型の場所に書く」という置き場所の感覚がつかめれば、生成された他のファイルも読み解けるようになります。

生成物の読み解きは、住所の対応表(routes)→処理(app/controllers/memos_controller.rb)→画面(app/views/memos/)の順に追うのがおすすめです。ファイルの置き場所が役割ごとに決まっているため、他のRailsアプリでも同じ順番で読めます。

なお、scaffoldは学習と試作のための足場という位置づけです。実際のアプリ作りでは、生成された部品を出発点に、画面の項目を絞ったり、決まりを足したりしながら育てていきます。最初から全部を手書きするのではなく「生成されたものを読んで、直して、自分のものにする」という進め方が、Railsでは標準的な作り方です。

つまずきやすい点

つまずきやすい点
つまずきやすい点

よくあるつまずきは4つです。1つ目は、Rubyのバージョンです。Rails 8.1系はRuby 3.2以上が前提で、古いRubyではインストールが進みません。rbenv で新しいRubyを入れたのに古いまま表示される場合は、ターミナルを開き直してから確認してください。

2つ目は、Windowsでの環境です。そのままのWindowsでは詰まりやすいため、WSL2の中で進めるのが公式の案内に沿った形です。Node.jsの記事とは別物として、Linux側の環境を整える前提で読んでください。

3つ目は、データベースへの反映忘れです。scaffoldで生成したあとに db:migrate を実行しないと、「テーブルが存在しない」というエラーになります。生成と反映はセットで覚えてください。

4つ目は、生成ファイルの多さに圧倒されることです。最初から全部を読む必要はありません。住所→処理→画面の順に、動いている部分だけを追えば十分です。

まとめ

まとめ
まとめ

Railsの入門は、「RubyとRailsの導入→プロジェクト作成→scaffoldで骨格を生成→データベースへ反映→決まりを足して生成物を読む」という流れで進みます。型に沿うことで土台が短い手順でそろうのが、このフレームワークの特徴です。

「画面よりも、まず管理画面つきで一式欲しい」という場合は、Pythonの全部入りフレームワークの作例も比較してみてください。

Django入門:管理画面つきの小さなWebアプリを作る手順

生成したプロジェクトはGitで記録しておくと、骨格の変遷が残って安心です。

GitのインストールとGitHub連携の手順

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました