Ruby on Railsは、Webアプリケーションを効率的に開発するためのフレームワークです。この記事では、Ruby on Railsの開発環境をセットアップし、最初のプロジェクトを作成するまでの手順を解説します。Railsを使えば、データベース連携やルーティング、テンプレートエンジンなどが最初から用意されているため、短期間でWebアプリケーションを構築できます。
前提条件
Railsを使用するには、まずRubyがインストールされている必要があります。ターミナルで以下のコマンドを実行して、Rubyがインストールされているか確認しましょう。
ruby -vバージョン番号が表示されればRubyはインストール済みです。表示されない場合は、Ruby公式サイトからインストールしてください。
Railsを快適に使うには、Ruby 3.0以上を推奨します。古いバージョンでは一部のgemが対応していない場合があります。
MSYS2のインストール(Windows環境の場合)
Windows環境でRailsを使用する場合、ネイティブ拡張のコンパイルに必要なMSYS2をインストールします。MSYS2公式サイトからインストーラーをダウンロードし、実行してください。
インストール完了後、Windowsのスタートメニューで「MSYS2」と検索し、「MSYS2 MSYS」を管理者として実行します。
基本的な使い方
MSYS2が起動したら、まずパッケージデータベースを最新の状態に更新します。
pacman -Syu更新が完了したら、Railsの依存ライブラリであるlibyamlをインストールします。
pacman -S mingw-w64-ucrt-x86_64-libyamllibyamlはYAMLファイルの解析に使用されるライブラリで、Railsの設定ファイル(database.ymlなど)の読み込みに必要です。インストールが完了したらMSYS2を閉じてかまいません。
RubyGemsとBundlerのアップデート
次に、Rubyのパッケージ管理ツールであるRubyGemsと、gem依存関係を管理するBundlerを最新版にアップデートします。コマンドプロンプトを管理者として実行し、以下のコマンドを順に実行してください。
gem update --system
gem install bundlerRubyGemsはRubyライブラリ(gem)のインストールや管理を行うツールで、BundlerはプロジェクトごとにGemfileに記載されたgemを一括管理するツールです。Railsプロジェクトでは必須のツールなので、必ずインストールしておきましょう。
Railsのインストール
RubyGemsが準備できたら、いよいよRailsをインストールします。
gem install railsインストールが完了したら、バージョンを確認しましょう。
rails -vバージョン番号が表示されればインストール成功です。
プロジェクトの作成
Railsプロジェクトを作成するには、ターミナルでプロジェクトを置きたいディレクトリに移動し、rails newコマンドを実行します。
rails new myappこのコマンドにより、myappというディレクトリが作成され、Railsアプリケーションに必要なファイルやフォルダが自動生成されます。また、Gemfileに記載されたgemも自動的にインストールされます。
エラーが発生した場合は、以下のコマンドを実行してから再度プロジェクトを作成してみてください。
gem install psych --platform=ruby -- --with-libyaml-dir=C:/msys64/mingw64データベースにPostgreSQLを使いたい場合は、オプションを指定できます。
rails new myapp --database=postgresqlサーバーの起動
プロジェクトのディレクトリに移動し、開発サーバーを起動します。
cd myapp
rails serverサーバーが起動したら、ブラウザでhttp://127.0.0.1:3000にアクセスしてください。Railsのウェルカムページが表示されれば、環境構築は完了です。
rails serverはrails sと省略して実行することもできます。サーバーを停止するにはCtrl + Cを押してください。
ポート3000が既に使用されている場合は、rails server -p 3001のように別のポート番号を指定してください。
まとめ
- Ruby on Railsを使うにはRubyのインストールが前提条件
- Windows環境ではMSYS2のセットアップが必要
gem install railsでRailsをインストールrails new プロジェクト名で新規プロジェクトを作成rails server(またはrails s)で開発サーバーを起動- ブラウザで
http://127.0.0.1:3000にアクセスして動作確認