Ruby on Rails ガイド

ここから始めてください

Railsのはじめ方: 最初のアプリケーションを作成するためにRailsをインストールするために必要なすべての情報。

モデル

Active Recordの基礎: Active Recordは、モデルがアプリケーションのデータベースとやり取りすることを可能にします。このガイドでは、Active Recordモデルとデータベースへの永続性の開始方法について説明します。
Active Record Migrations: マイグレーションはActive Recordの機能であり、データベースのスキーマを時間とともに進化させることができます。純粋なSQLではなく、マイグレーションを使用することで、RubyのDSLを使ってテーブルの変更を記述することができます。
Active Recordのバリデーション: バリデーションは、データベースに保存されるのは有効なデータのみであることを保証するために使用されます。このガイドでは、Active Recordのバリデーション機能を使用して、オブジェクトがデータベースに保存される前の状態を検証する方法を教えます。
Active Record コールバック: コールバックは、オブジェクトが作成されたとき、更新されたとき、破棄されたときなどに実行されるコードを記述することができるようにします。このガイドでは、Active Recordオブジェクトのライフサイクルにフックする方法を教えます。
Active Recordの関連付け: Active Recordでは、関連付けは2つのActive Recordモデル間の接続です。このガイドでは、Active Recordが提供するすべての関連付けについて説明します。
Active Record クエリインターフェース: Active Recordは、データベースのレコードを検索するために生のSQLを使用する代わりに、同じ操作を行うためのより良い方法を提供します。このガイドでは、Active Recordを使用してデータベースからデータを取得するさまざまな方法について説明します。
Active Modelの基礎: Active Modelは、Action Packと統合されるプレーンなRubyオブジェクトを作成することができますが、データベースの永続性にはActive Recordは必要ありません。Active Modelはまた、Railsフレームワークの外部で使用するためのカスタムORMの構築もサポートしています。このガイドでは、Active Modelクラスの使用を開始するために必要なすべての情報を提供します。

ビュー

Action Viewの概要: Action Viewは、WebのレスポンスのためのHTMLを生成する責任を持っています。このガイドでは、Action Viewの紹介を提供します。
Railsにおけるレイアウトとレンダリング: このガイドでは、Action ControllerとAction Viewの基本的なレイアウト機能について説明します。レンダリングやリダイレクト、content_forブロックの使用、パーシャルの操作などが含まれます。
アクションビューヘルパー: Action Viewには、日付のフォーマットや画像へのリンク、コンテンツのサニタイズやローカライズなど、さまざまなことを処理するためのヘルパーがあります。このガイドでは、より一般的なAction Viewヘルパーのいくつかを紹介します。
Action Viewフォームヘルパー: HTMLフォームは、フォームコントロールの名前付けとその多くの属性を処理する必要があるため、書くことやメンテナンスすることが面倒になることがあります。Railsは、フォームマークアップを生成するためのビューヘルパーを提供することで、この複雑さを排除します。

コントローラー

Action Controllerの概要: アクションコントローラーは、RailsにおけるWebリクエストの中核です。このガイドでは、コントローラーの動作方法やアプリケーションのリクエストサイクルへの組み込み方法について説明します。セッション、フィルター、クッキー、データストリーミング、リクエストによって発生した例外の処理など、さまざまなトピックをカバーしています。
外部からのRailsルーティング: RailsのルーターはURLを認識し、それらをコントローラーのアクションにディスパッチします。このガイドでは、Railsのルーティングのユーザー向けの機能について説明します。自分自身のRailsアプリケーションでルーティングを使用する方法を理解したい場合は、ここから始めてください。

他のコンポーネント

Active Supportコア拡張機能: Active Supportは、Ruby言語の拡張機能やユーティリティを提供します。これにより、Railsアプリケーションの開発やRuby on Rails自体の開発において、Ruby言語を豊かにすることができます。
Action Mailerの基本: このガイドでは、アプリケーションからメールを送信するために必要なすべての情報と、Action Mailerの内部について説明します。
Action Mailboxの基本: このガイドでは、Action Mailboxを使用してメールを受信する方法について説明しています。
Action Textの概要: このガイドでは、リッチテキストコンテンツを扱うためにAction Textを使用する方法について説明しています。
Active Jobの基本: Active Jobは、バックグラウンドジョブを宣言し、さまざまなキューのバックエンドで実行するためのフレームワークです。このガイドでは、バックグラウンドジョブの作成、エンキュー、実行に必要なすべての情報を提供します。
Active Storageの概要: Active Storageは、クラウドストレージサービスへのファイルのアップロード、アップロードの変換、メタデータの抽出を容易にします。このガイドでは、Active Recordモデルにファイルを添付する方法について説明します。
Action Cableの概要: Action CableはWebSocketsをRailsアプリケーションの他の部分と統合します。これにより、リアルタイムの機能をRailsアプリケーションの他の部分と同じスタイルと形式でRubyで記述することができます。このガイドでは、Action Cableの動作方法とWebSocketsを使用してリアルタイムの機能を作成する方法について説明します。
Webpacker: このガイドでは、Webpackerをインストールして使用する方法を説明します。Webpackerは、RailsアプリケーションのクライアントサイドにおけるJavaScript、CSS、その他のアセットをパッケージ化するためのツールです。

深く掘り下げる

Rails国際化（I18n）API: このガイドでは、アプリケーションに国際化を追加する方法について説明します。アプリケーションは、異なる言語にコンテンツを翻訳したり、複数形のルールを変更したり、各国の正しい日付形式を使用したりすることができます。
Railsアプリケーションのテスト: これはRailsのさまざまなテスト施設についての包括的なガイドです。テストとは何かから統合テストまで、すべてを網羅しています。お楽しみください。
Railsアプリケーションのセキュリティ確保: このガイドでは、ウェブアプリケーションにおける一般的なセキュリティの問題と、Railsを使用してそれらを回避する方法について説明します。
Railsアプリケーションにおけるエラーレポート: このガイドでは、Ruby on Railsアプリケーションで発生する例外を管理する方法について紹介します。
Railsアプリケーションのデバッグ: このガイドでは、Railsアプリケーションのデバッグ方法について説明します。さまざまな方法と、コードの「裏側」で何が起こっているかを理解する方法についてカバーしています。
Railsアプリケーションの設定: このガイドでは、Railsアプリケーションの基本的な設定について説明します。
Railsコマンドライン: Railsの日常的な使用には、いくつかのコマンドが絶対に重要です。このガイドでは、Railsが提供するコマンドラインツールについて説明します。
アセットパイプライン: アセットパイプラインは、JavaScript、CSS、および画像アセットを連結し、圧縮または圧縮するためのフレームワークを提供します。また、CoffeeScript、Sass、ERBなどの他の言語やプリプロセッサでこれらのアセットを書くこともできる機能も追加されています。
RailsでJavaScriptを使用する: このガイドでは、import mapsやjsbundling-railsを使用して、RailsアプリケーションにJavaScriptを含める方法について説明し、RailsでTurboを使用する基本的な操作についてもカバーしています。
Railsの初期化プロセス: このガイドは、Railsの初期化プロセスの内部について説明しています。非常に詳細なガイドであり、上級のRails開発者におすすめです。
自動読み込みと定数の再読み込み: このガイドは、オートロードと定数のリロードがどのように機能するかを文書化しています（Zeitwerkモード）。
ClassicからZeitwerkへの移行のHOWTO: このガイドでは、Railsアプリケーションを「classic」モードから「zeitwerk」モードに移行する方法について説明します。
Railsでのキャッシュ：概要: このガイドは、キャッシュを使用してRailsアプリケーションの高速化を行うための入門です。
アクティブサポートインストゥルメンテーション: このガイドでは、Active Support内の計測APIを使用して、Railsや他のRubyコード内のイベントを計測する方法について説明します。
API専用アプリケーションに対してRailsを使用する方法: このガイドでは、JSON APIアプリケーションを効果的に開発するためにRailsをどのように使用するかを説明します。
Active RecordとPostgreSQL: このガイドは、Active RecordのPostgreSQL固有の使用方法について説明しています。
複数のデータベースをActive Recordで使用する: このガイドでは、アプリケーションで複数のデータベースを使用する方法について説明します。
Active Recordの暗号化: このガイドでは、Active Recordを使用してデータベース情報を暗号化する方法について説明します。

Railsの拡張

Railsプラグインの基礎: このガイドでは、Railsの機能を拡張するためのプラグインの作成方法について説明します。
Rack上のRails: このガイドでは、RailsのRackとの統合と他のRackコンポーネントとのインターフェースについて説明します。
Railsジェネレータとテンプレートの作成とカスタマイズ: このガイドでは、新しいジェネレータを拡張に追加する方法や、組み込みのRailsジェネレータの要素に代替手段を提供する方法（例えば、スキャフォールドジェネレータの代替テストスタブを提供する方法）について説明します。
エンジンを使い始める: エンジンは、ホストアプリケーションに追加の機能を提供するミニアチュアアプリケーションと考えることができます。このガイドでは、自分自身のエンジンを作成し、ホストアプリケーションと統合する方法を学びます。
Railsアプリケーションテンプレート: アプリケーションテンプレートは、新しく作成したRailsプロジェクトまたは既存のRailsプロジェクトに、ジェム、イニシャライザなどを追加するためのDSLを含むシンプルなRubyファイルです。
Railsでのスレッドとコードの実行: このガイドでは、Railsアプリケーションで直接並行処理を行う際に必要な考慮事項と利用可能なツールについて説明します。

貢献する

Ruby on Railsへの貢献: Railsは「他人のフレームワーク」ではありません。このガイドでは、Railsの進行中の開発に参加するさまざまな方法について説明しています。
APIドキュメントガイドライン: このガイドは、Ruby on RailsのAPIドキュメンテーションのガイドラインを文書化しています。
Ruby on Railsガイドライン: このガイドは、Ruby on Railsガイドのガイドラインを文書化しています。
Railsコア開発の依存関係のインストール: このガイドでは、Ruby on Railsのコア開発のための環境のセットアップ方法について説明します。

政策

Ruby on Railsのメンテナンスポリシー: 現在サポートされているRuby on Railsのバージョンと、新しいバージョンの予定はありますか。

リリースノート

Ruby on Railsのアップグレード: このガイドでは、アプリケーションを新しいバージョンのRuby on Railsにアップグレードする際に実行する手順を提供します。
Ruby on Rails 7.1 リリースノート: Rails 7.1 のリリースノート
Ruby on Rails 7.0 リリースノート: Rails 7.0 のリリースノート
Ruby on Rails 6.1 リリースノート: Rails 6.1 のリリースノート
Ruby on Rails 6.0 リリースノート: Rails 6.0のリリースノート
Ruby on Rails 5.2 リリースノート: Rails 5.2 のリリースノート
Ruby on Rails 5.1 リリースノート: Rails 5.1のリリースノート
Ruby on Rails 5.0 リリースノート: Rails 5.0のリリースノート
Ruby on Rails 4.2 リリースノート: Rails 4.2のリリースノート
Ruby on Rails 4.1 リリースノート: Rails 4.1のリリースノート
Ruby on Rails 4.0 リリースノート: Rails 4.0のリリースノート
Ruby on Rails 3.2 リリースノート: Rails 3.2 のリリースノート
Ruby on Rails 3.1 リリースノート: Rails 3.1のリリースノート
Ruby on Rails 3.0 リリースノート: Rails 3.0のリリースノート
Ruby on Rails 2.3 リリースノート: Rails 2.3のリリースノート
Ruby on Rails 2.2 リリースノート: Rails 2.2のリリースノート

フィードバック

このガイドの品質向上にご協力ください。

タイポや事実の誤りを見つけた場合は、ぜひ貢献してください。開始するには、ドキュメントへの貢献セクションを読んでください。

不完全なコンテンツや最新でない情報も見つかるかもしれません。メインのドキュメントに不足しているドキュメントを追加してください。修正済みかどうかは、まずEdge Guidesを確認してください。スタイルと規約については、Ruby on Rails Guides Guidelinesを確認してください。

修正すべき点を見つけたが、自分で修正できない場合は、問題を報告してください。

そして最後に、Ruby on Railsのドキュメントに関するあらゆる議論は、公式のRuby on Railsフォーラムで大歓迎です。

Ruby on Railsガイド（ae44dcb）