Contents
Ruby on Rails初心者向けプロジェクト作成のステップバイステップガイド
Ruby on Railsを初めて使う初心者にとって、プロジェクトの作成は「手順が複雑で戸惑う」ことがよくあります。本記事では、ゼロからプロジェクトを作成する際の具体的な流れを解説し、Ruby on Rails 初心者 プロジェクト作成 手順に沿った実践的なガイドラインを提供します。
開発環境の準備
Ruby on Railsを動かすには、まず開発環境が整っている必要があります。OSごとにインストール手順が異なりますが、以下の方法で導入可能です。共通部分と各OS固有の手順を明確に分けることで読みやすさを向上させます。
共通インストール手順（全OSで適用）
- Rubyのインストール
- パッケージマネージャーや公式サイトから導入します。
-
バージョン確認
bash
ruby -v -
Railsのインストール
bash
gem install rails
OSごとのインストール手順
Macユーザーの場合
- Homebrewをインストールしていない場合は、公式サイト（https://brew.sh/）からインストールします。
- Rubyをインストール:
bash
brew install ruby
注意: 実行後は
rails -vで動作確認してください。
Windowsユーザーの場合
- RubyInstallerからRubyをダウンロードし、インストーラーを実行します。
- 環境変数PATHに追加し、
gem install railsでRailsを導入します。
注意: パッケージマネージャー（Chocolateyなど）の利用も可能です。
Linuxユーザー（例：Ubuntu）の場合
-
Rubyをインストール:
bash
sudo apt update && sudo apt install ruby-full -
Railsのバージョン確認とインストール:
bash
rails -v
gem install rails
例:
rails new my_appでプロジェクト初期化ができます。
プロジェクトの作成
新規プロジェクトを作成するには、rails newコマンドを使用します。これにより、標準的なディレクトリ構造と基本ファイルが自動生成されます。
新規プロジェクト作成コマンドの実行方法
-
任意の場所でターミナルを開き、以下のコマンドを入力します:
bash
rails new my_app -
my_appという名前のディレクトリが生成されます。このディレクトリ内に移動します:
bash
cd my_app
プロジェクトの基本構造
生成されたプロジェクトのディレクトリ構造は以下の通りです。
| ディレクトリ | 役割 |
|---|---|
app/ |
アプリケーションの本体（モデル、ビュー、コントローラーなど） |
config/ |
設定ファイルやルーティング設定が格納される |
db/ |
データベース関連のファイルが保存される |
lib/ |
カスタムライブラリやユーティリティが配置される |
public/ |
静的ファイル（画像、CSSなど）を格納する |
MVCの基本構造
Ruby on RailsはMVC（モデル・ビュー・コントローラー）アーキテクチャに基づいています。各コンポーネントの役割と配置場所を理解することで、プロジェクトの流れが見えてきます。
モデル・ビュー・コントローラーの役割
| コンポーネント | 役割 |
|---|---|
| モデル（Model） | データベースとやり取りし、ビジネスロジックを処理する |
| ビュー（View） | ユーザーに表示されるHTMLやテンプレートを管理する |
| コントローラー（Controller） | リクエストを受け取り、モデルとビューを仲介して処理を行う |
- モデルファイル: app/models/以下
- ビューファイル: app/views/以下
- コントローラー:
app/controllers/以下
例：ユーザー情報管理用のモデルは
User、対応するビューはusers/show.html.erb、コントローラーはUsersControllerと名付けられます。
データベースマイグレーション
Railsではデータベース設計を「マイグレーション」としてファイル形式で管理できます。これにより、バージョン管理やチームでの共有が容易になります。
マイグレーションファイルの作成と実行フロー
-
マイグレーションファイルを作成:
bash
rails generate migration CreatePosts title:string body:text -
生成されたファイルは
db/migrate/以下に保存されます。 -
upメソッドでテーブルを 생성、downメソッドで削除します。 -
マイグレーション実行:
bash
rails db:migrate
標準フィールド：
created_atとupdated_atは自動で追加され、それぞれレコードの作成時刻と更新時刻を記録します。
ルーティング設定
ルーティングは「URLがどのコントローラーのアクションにアクセスするか」を定義します。Railsではconfig/routes.rbでルートを設定します。
routes.rbでのルート定義方法
resources :postsという記述により、以下の7つのルートが自動生成されます:
ruby
resources :posts
| HTTPメソッド | URL | アクション |
|---|---|---|
| GET | /posts | index |
| GET | /posts/new | new |
| POST | /posts | create |
| GET | /posts/:id | show |
| GET | /posts/:id/edit | edit |
| PATCH/PUT | /posts/:id | update |
| DELETE | /posts/:id | destroy |
まとめ：
resources :モデル名で、CRUD操作に必要なルートを一括で定義できます。
CRUD機能の実装
ここでは簡単な「掲示板アプリケーション」を作成し、CRUD（作成・読み取り・更新・削除）機能を体験します。
簡単な掲示板アプリケーションの作成例
-
モデル作成
bash
rails generate model Post title:string body:text -
データベースマイグレーション
bash
rails db:migrate -
コントローラー生成
bash
rails generate controller Posts index show new create edit update destroy -
ビュー作成
app/views/posts/index.html.erbに一覧表示のHTMLを記述します。-
同様に
show.html.erb、new.html.erbなどを作成し、各アクションとリンクさせます。 -
ルーティング設定
ruby
resources :posts
ローカルサーバーの起動
プロジェクトが完成したら、ローカルで動作確認をします。Railsは内蔵サーバーを使用して簡単に開発できます。
rails serverの実行とブラウザでの確認手順
-
ターミナルで以下を実行:
bash
rails server -
デフォルトでは
localhost:3000にアクセス可能です。 - ブラウザで
http://localhost:3000を開き、作成した掲示板アプリケーションが正常に表示されるか確認します。
停止方法：ターミナルで
Ctrl+Cを押すことでサーバーを終了できます。
まとめ
Ruby on Railsの学習では、環境構築からプロジェクト作成までの一連の手順を理解することが重要です。以下に要点を整理します。
- 開発環境準備: OSごとにインストール手順があり、共通部分と個別処理を分けることで効率化が可能。
- MVC構造: モデル（データ）、ビュー（表示）、コントローラー（処理）の役割を明確に区別する。
- マイグレーション: データベース設計をコードで管理し、チーム開発にも対応可能。
- ルーティング設定:
resourcesメソッドを使用してCRUD操作に対応するルートを一括生成。 - ローカル環境での動作確認は、プロジェクト完成のサインであり、学習効果を高める。
実際に手を動かしてRuby on Railsプロジェクトを作成し、実践的なスキルを身につけてください。