本ガイドでは、コントローラの動作と、アプリケーションのリクエストサイクルにおけるコントローラの役割について解説します。 このガイドの内容: コントローラを経由するリクエストの流れを理解する コントローラに渡されるパラメータを制限する方法 セッションやcookieにデータを保存する理由とその方法 リクエストの処理中にフィルタを使ってコードを実行する方法 Action Controller組み込みのHTTP認証機能 ユーザーのブラウザにデータを直接ストリーミング送信する方法 機密性の高いパラメータをフィルタしてログに出力されないようにする方法 リクエスト処理中に発生する可能性のある例外の取り扱い 組み込みのヘルスチェックエンドポイントをロードバランサーやアップタイムモニタで活用する方法 1 コントローラの役割 Action Controllerは、MVCアーキテクチャの「C」に相当します。リク

本ガイドでは、キャッシュを導入してRailsアプリケーションを高速化する方法を解説します。 「キャッシュ（caching）」とは、リクエスト・レスポンスのサイクルの中で生成されたコンテンツを保存しておき、次回同じようなリクエストが発生したときのレスポンスでそのコンテンツを再利用することを指します。 多くの場合、キャッシュはアプリケーションのパフォーマンスを効果的に増大するのに最適な方法です。キャッシュを導入することで、単一サーバーや単一データベースのWebサイトでも、数千ユーザーの同時接続による負荷に耐えられるようになります。 Railsには、すぐ利用できるキャッシュ機能がいくつも用意されています。本ガイドでは、それぞれの機能について目的を解説します。Railsのキャッシュ機能を使いこなすことで、応答時間の低下や高額なサーバー使用料に悩まされずに、Railsアプリケーションが数百万ビューを

本ガイドでは、キャッシュを導入してRailsアプリケーションを高速化する方法を解説します。 「キャッシュ（caching）」とは、リクエスト・レスポンスのサイクルの中で生成されたコンテンツを保存しておき、次回同じようなリクエストが発生したときのレスポンスでそのコンテンツを再利用することを指します。 多くの場合、キャッシュはアプリケーションのパフォーマンスを効果的に増大するのに最適な方法です。キャッシュを導入することで、単一サーバーや単一データベースのWebサイトでも、数千ユーザーの同時接続による負荷に耐えられるようになります。 Railsには、すぐ利用できるキャッシュ機能がいくつも用意されています。本ガイドでは、それぞれの機能について目的を解説します。Railsのキャッシュ機能を使いこなすことで、応答時間の低下や高額なサーバー使用料に悩まされずに、Railsアプリケーションが数百万ビューを

Active SupportはRuby on Railsのコンポーネントであり、Ruby言語の拡張やユーティリティを提供します。 Active Supportは言語レベルで基本部分を底上げして豊かなものにし、Railsアプリケーションの開発とRuby on Railsそれ自体の開発に役立てるべく作られています。 このガイドの内容: コア拡張機能（Core Extensions）について すべての拡張機能を読み込む方法 必要な拡張機能だけを利用する方法 Active Supportが提供する拡張機能一覧

このガイドはActive Recordモデルにファイルを添付する方法について説明します。 本ガイドの内容: あるレコードに1個または複数のファイルを添付する方法 添付ファイルを削除する方法 添付ファイルへのリンク方法 バリアントを利用して画像を変形する方法 PDFや動画などの非画像ファイルの内容を代表するプレビュー画像の生成方法 ブラウザからストレージサービスに直接ファイルをアップロードする方法 テスト中に保存したファイルをクリーンアップする方法 追加のストレージサービスをサポートするための実装方法 1 Active Storageについて Active Storageは、Amazon S3、Google Cloud Storage、Microsoft Azure Storageなどのクラウドストレージサービスへのファイルのアップロードや、ファイルをActive Recordオブジェクトに

通常のRubyプログラムでは、使いたいクラスやモジュールを定義したファイルを明示的に読み込みます。たとえば、以下のコントローラではApplicationControllerクラスやPostクラスを参照しており、通常はこれらに対してrequire呼び出しを行います。 # Railsではこのように書かないこと require "application_controller" require "post" # Railsではこのように書かないこと class PostsController < ApplicationController def index @posts = Post.all end end Railsは、必要に応じてクラスやモジュールを開発者の代わりに自動読み込み（autoload）します。これが可能になるのは、RailsがセットアップするいくつかのZeitwerkローダーのお

1 本ガイドの前提条件 本ガイドは、Railsアプリケーションを構築したいと考えているRails初心者を対象にしています。読者にRailsの経験があることは前提としていません。 Railsとは、プログラミング言語「Ruby」の上で動作するWebアプリケーションフレームワークです。ただしプログラミング経験がまったくない人がいきなりRailsを学ぼうとすると、かなり大変な作業になるでしょう。オンラインで学べる洗練されたコンテンツはたくさんあるので、その中から以下をご紹介します。 プログラミング言語Ruby公式Webサイト プログラミング学習コンテンツまとめ いずれもよくできていますが中には古いものもあり、たとえば通常のRails開発で見かけるような最新の構文がカバーされていない可能性もあります。 2 Railsとは何か Railsとは、プログラミング言語「Ruby」で書かれたWebアプリケーシ

このガイドの内容: API専用アプリケーションを支援するRailsの機能 Railsの起動時にブラウザ向け機能をオフにする方法 ミドルウェアの選定 コントローラで使うモジュールの選定 1 APIアプリケーションについて 従来、Railsの「API」というと、プログラムからアクセスできるAPIをWebアプリケーションに追加することを指すのが通例でした。たとえば、GitHubが提供するAPI はカスタムクライアントから利用できます。 近年、さまざまなクライアント側フレームワークが登場したことによって、Railsで構築したバックエンドサーバ―を他のWebアプリケーションとネイティブアプリケーションの間で共有する手法が増えてきました。 たとえば、Twitterは自社のWebアプリケーションで パブリックAPI を利用しています。このWebアプリケーションは、JSONリソースを消費するだけの静的サイ

Webアプリケーションのフォームは、ユーザー入力を扱うための重要なインターフェイスです。しかしフォームのマークアップは、フォームのコントロールの命名法や大量の属性を扱わなければならず、作成もメンテナンスも退屈な作業になりがちです。そこでRailsでは、フォームのマークアップを生成するビューヘルパーを提供し、こうした煩雑な作業を行わずに済むようにしました。しかし現実にはさまざまなユースケースがあるため、開発者はこれらを実際に使う前に、これらのよく似たヘルパーメソッド群にどのような違いがあるのかをすべて把握しておく必要があります。 このガイドの内容: 検索フォーム、および特定のモデルを表さない一般的なフォームの作成法 特定のデータベースレコードの作成編集を行なう、モデル中心のフォーム作成法 複数の種類のデータからセレクトボックスを生成する方法 Railsが提供する日付時刻関連ヘルパー ファイル

このガイドでは、Active Recordで複数のデータベースを利用する方法について説明します。 このガイドの内容: アプリケーションで複数のデータベースをセットアップする方法 コネクションの自動切り替えの仕組み 複数のデータベースにおける水平シャーディングの利用方法 サポートされている機能と現在進行中の機能 アプリケーションが人気を得て利用されるようになってくると、新しいユーザーやユーザーのデータをサポートするためにアプリケーションをスケールする必要が生じてきます。アプリケーションをスケールする方法の1つが、データベースレベルでのスケールでしょう。Railsが複数のデータベース（Multiple Databases）をサポートするようになったので、すべてのデータを1箇所に保存する必要はありません。 現時点でサポートされている機能は以下のとおりです。 複数の「writer」データベースと、

本ガイドは、アプリケーションをテストするためにRailsに組み込まれているメカニズムについて解説します。 このガイドの内容: Railsテスティング用語 アプリケーションに対する単体テスト、機能テスト、結合テスト、システムテスト（system test）の実施 その他の著名なテスティング方法とプラグインの紹介 1 Railsアプリケーションでテストを作成する理由 Railsでは、テストをきわめて簡単に作成できます。テストの作成は、モデルやコントローラを作成する時点でテストコードのスケルトンを作成することから始まります。 Railsのテストが作成されていれば、後はそれを実行するだけで、特に大規模なリファクタリングを行なう際にコードが期待どおりに動作していることを即座に確認できます。 Railsのテストはブラウザのリクエストをシミュレートできるので、ブラウザを手動で操作せずにアプリケーションの

マイグレーション（migration）はActive Recordの機能の1つであり、データベーススキーマが長期にわたって進化を安定して繰り返せるようにするための仕組みです。マイグレーション機能のおかげで、スキーマ変更を生SQLで記述せずに、Rubyで作成されたマイグレーション用のDSL（ドメイン固有言語）を用いてテーブルの変更を簡単に記述できます。 このガイドの内容: マイグレーション作成で利用できるジェネレータ Active Recordが提供するデータベース操作用メソッド群の解説 マイグレーション実行とスキーマ更新用のrailsタスクの解説 マイグレーションとスキーマファイルschema.rbの関係 1 マイグレーションの概要 マイグレーションは、データベーススキーマの継続的な変更（英語）を、統一的かつ簡単に行なうための便利な手法です。マイグレーションではRubyのDSLが使われてい

このマニュアルでは、Webアプリケーション全般におけるセキュリティの問題と、Railsでそれらの問題を回避する方法について説明します。 このガイドの内容: 本ガイドで取り上げられている問題に対するあらゆる対策 Railsにおけるセッションの概念、セッションに含めるべき項目、有名なセッション攻撃 Webサイトを開くだけで（CSRFによる）セキュリティ問題が発生するしくみ ファイルの取扱い上の注意、管理インターフェイスを提供する際の注意事項 ユーザーを正しく管理する（ログイン・ログアウトのしくみ、あらゆるレイヤにおける攻撃方法） 最も有名なインジェクション攻撃方法の解説 1 はじめに Webアプリケーションフレームワークは、Webアプリケーションの開発を支援するために作られました。フレームワークの中にはセキュリティを比較的高めやすいものもあります。実際のところ、あるフレームワークは他のよりも安

本章は、Rails初期化プロセスの内部について解説します。上級Rails開発者向けに推奨される、きわめて高度な内容を扱っています。 このガイドの内容: bin/rails serverの利用法 Rails初期化シーケンスのタイムライン 起動シーケンスで通常以外のファイルが必要な場所 Rails::Serverインターフェイスの定義方法と利用法

このガイドはRackのミドルウェア、urlマップ、Rack::BuilderといったRackのプロトコルや概念に関する実用的な知識を身につけていることを前提にしています。 1 Rack入門 Rackは、RubyのWebアプリケーションに対して、モジュール化された最小限のインターフェイスを提供して、インターフェイスを広範囲に使えるようにします。RackはHTTPリクエストとレスポンスを可能なかぎり簡単な方法でラッピングすることで、Webサーバー、Webフレームワーク、その間に位置するソフトウェア（ミドルウェアと呼ばれています）のAPIを1つのメソッド呼び出しの形にまとめます。 Rackに関する解説はこのガイドの範疇を超えてしまいます。Rackに関する基本的な知識が不足している場合は、下記のリソース を参照してください。 2 RailsとRack 2.1 RailsアプリケーションのRackオ

このガイドでは、Active Recordオブジェクトのライフサイクルにフックをかける方法について説明します。 このガイドの内容: Active Recordオブジェクトのライフサイクルでいつイベントが発生するか オブジェクトのライフサイクルにおけるイベントに応答するコールバックメソッドを作成する方法 コールバックで共通となる振る舞いをカプセル化する特殊なクラスの作成方法

本ガイドでは、モデルクラスを使って作業を開始するのに必要な知識について解説します。Active Modelは、Action PackやAction ViewヘルパーにプレーンなRubyオブジェクトとのやりとりを行う手段を提供します。Active Modelを用いることで、カスタムのORM (オブジェクト/リレーショナルマッパー) を作成してRailsフレームワークの外で利用できるようになります。 このガイドの内容: Active Modelの概要とActive Recordとの関係 Active Modelに含まれるさまざまなモジュール Active Modelを自分のクラスで利用する方法 1 はじめに Active Modelを理解するには、まずActive Recordについて少し知っておく必要があります。Active RecordはORM（オブジェクト/リレーショナル マッパー）の一

本ガイドでは、JavaScript機能をRailsアプリケーションに統合する方法について解説します。外部のJavaScriptパッケージを利用する場合に使えるオプションや、RailsでTurboを使う方法についても解説します。 このガイドの内容: Node.jsやYarnやJavaScriptのバンドラーを使わずにRailsを利用する方法 JavaScriptをimport maps・Bun・esbuild・Rollup・webpackでバンドルする新規Railsアプリケーションを作成する方法 Turboの概要と利用法 Railsが提供するTurbo HTMLヘルパーの利用法 1 import maps import mapsは、バージョン付けされたファイルに対応する論理名を用いてJavaScriptモジュールをブラウザで直接importできます。import mapsはRails 7から

3.1 Railsバージョンごとのデフォルト値 config.load_defaults はターゲットバージョンとそれ以前のすべてのバージョンのデフォルトの設定値を読み込みます。たとえば、config.load_defaults 6.1はバージョン6.1までの全バージョンのデフォルトを読み込みます。 ターゲットバージョンごとに関連するデフォルト値を以下に示します。値が矛盾する場合は、新しいバージョンが古いバージョンより優先されます。 3.1.1 ターゲットバージョン7.2のデフォルト値 config.active_job.enqueue_after_transaction_commit: :default config.active_record.postgresql_adapter_decode_dates: true config.active_record.validate_migr

1 デバッグに利用できるビューヘルパー 変数にどんな値が入っているかを確認する作業は何かと必要になります。Railsでは以下の3つのメソッドを利用できます。 debug to_yaml inspect 1.1 debug debugヘルパーは<pre>タグを返します。このタグの中にYAML形式でオブジェクトが出力されます。これにより、あらゆるオブジェクトを人間が読めるデータに変換できます。たとえば、以下のコードがビューにあるとします。