Ruby on Railsのディレクトリ構成を理解する

Ruby on Railsでプロジェクトを作成すると、多くのフォルダやファイルが自動生成されます。Railsは「規約より設定」（Convention over Configuration）の原則を採用しており、ファイルを正しいディレクトリに配置することで、設定なしに自動的に機能が有効になります。この記事では、Railsプロジェクトの主要なディレクトリ構成と、各フォルダの役割を詳しく解説します。

基本的な使い方

まず、Railsプロジェクトのディレクトリ構成を確認してみましょう。プロジェクトのルートディレクトリでlsコマンドを実行します。

ls -la myapp/
# 出力例:
# app/
# config/
# db/
# lib/
# log/
# public/
# test/
# tmp/
# vendor/
# Gemfile
# Gemfile.lock
# Rakefile
# config.ru

このように、Railsはプロジェクト作成時にMVC（Model-View-Controller）パターンに基づいた明確なディレクトリ構成を自動的に構築します。それぞれのディレクトリには決まった役割があり、この構造を理解することがRails開発の第一歩です。

appディレクトリ（アプリケーションコア）

最も重要なディレクトリがapp/です。アプリケーションのメインコードはすべてこのディレクトリに配置されます。

例えば、usersというリソースを扱う場合、以下のようにファイルが配置されます。

app/
  controllers/
    users_controller.rb    # ユーザーのリクエスト処理
  models/
    user.rb                # ユーザーデータのモデル
  views/
    users/
      index.html.erb     # ユーザー一覧表示
      show.html.erb      # ユーザー詳細表示
      _form.html.erb     # フォームのパーシャル
  helpers/
    users_helper.rb        # ユーザー関連のヘルパー

configディレクトリ（設定ファイル）

アプリケーションの各種設定ファイルが格納されるディレクトリです。開発中に頻繁に編集するファイルが含まれています。

特にroutes.rbは頻繁に編集するファイルです。URLパターンとコントローラーのアクションを紐づけます。

Rails.application.routes.draw do
  root "home#index"
  resources :users
end

dbディレクトリ（データベース関連）

データベースのマイグレーションファイルやスキーマ情報が格納されます。

マイグレーションはデータベースのバージョン管理の仕組みです。以下のコマンドでマイグレーションを実行できます。

rails db:migrate

プロジェクトルートの重要ファイル

プロジェクトのルートディレクトリには、プロジェクト全体の設定に関わる重要なファイルが配置されています。

新しいgemを追加する場合は、Gemfileに記述してからbundle installを実行します。

gem 'devise'
gem 'kaminari'

bundle install

まとめ