Ruby on Rails 指南 (v8.0.0)

這些是基於 v8.0.0 的 Rails 8.0 新指南。這些指南旨在讓您立即使用 Rails 產生生產力，並幫助您了解所有組件如何組合在一起。

早期版本的指南：Rails 7.1、Rails 7.0、Rails 6.1、Rails 6.0、Rails 5.2、Rails 5.1、Rails 5.0、Rails 4.2、Rails 4.1、Rails 4.0、Rails 3.2、Rails 3.1、Rails 3.0 和 Rails 2.3。

: Rails 指南也提供 Kindle 版本。; 標有此圖示的指南目前正在開發中，不會在指南索引選單中顯示。雖然仍然有用，但可能包含不完整的信息甚至錯誤。您可以透過檢閱它們並發布您的意見和更正來提供幫助。

由此開始

Rails 入門: 您需要了解的一切，以安裝 Rails 並建立您的第一個應用程式。

模型

Active Record 基礎: Active Record 允許您的模型與應用程式的資料庫互動。本指南將引導您開始使用 Active Record 模型並將資料持久化到資料庫中。
Active Record 遷移: 遷移是 Active Record 的一項功能，允許您隨著時間推移演進您的資料庫結構描述。遷移不是用純 SQL 寫入結構描述修改，而是允許您使用 Ruby DSL 來描述對資料表的變更。
Active Record 驗證: 驗證用於確保僅將有效資料儲存到您的資料庫中。本指南將教導您如何在資料進入資料庫之前，使用 Active Record 的驗證功能驗證物件的狀態。
Active Record 回呼: 回呼使得可以在建立、更新、銷毀等物件時撰寫程式碼。本指南將教導您如何掛鉤 Active Record 物件的這個物件生命週期。
Active Record 關聯: 在 Active Record 中，關聯是兩個 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 輔助方法。
Action View 表單輔助方法: HTML 表單由於需要處理表單控制項命名及其眾多屬性，因此寫入和維護可能很快變得繁瑣。Rails 通過提供用於產生表單標記的視圖輔助方法來消除這種複雜性。

控制器

Action Controller 概觀: Action Controller 是 Rails 中 Web 請求的核心。本指南涵蓋控制器的工作原理，以及它們如何適應您應用程式的請求週期。它包括會話、篩選器、Cookie、資料串流以及處理請求引發的例外狀況等主題。
由外而內的 Rails 路由: Rails 路由器會識別 URL 並將其分派到控制器的動作。本指南涵蓋 Rails 路由的使用者介面功能。如果您想了解如何在您自己的 Rails 應用程式中使用路由，請從這裡開始。

其他組件

Active Support 核心擴展: Active Support 提供 Ruby 語言擴展和公用程式。它豐富了 Ruby 語言，用於開發 Rails 應用程式，以及 Ruby on Rails 本身的開發。
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 將 WebSocket 與您 Rails 應用程式的其餘部分整合在一起。它允許以與您 Rails 應用程式其餘部分相同的樣式和形式用 Ruby 撰寫即時功能。本指南說明 Action Cable 的工作原理，以及如何使用 WebSocket 來建立即時功能。

深入探討

Rails 國際化 (I18n) API: 本指南涵蓋如何將國際化新增到您的應用程式。您的應用程式將能夠將內容翻譯成不同的語言、變更複數規則、使用每個國家/地區的正確日期格式等等。
測試 Rails 應用程式: 這是一個關於 Rails 中各種測試設施的相當全面的指南。它涵蓋從「什麼是測試？」到整合測試的所有內容。請盡情享用。
保護 Rails 應用程式安全: 本指南描述 Web 應用程式中常見的安全問題以及如何使用 Rails 避免這些問題。
Rails 應用程式中的錯誤回報: 本指南介紹管理 Ruby on Rails 應用程式中發生的錯誤的方法。
偵錯 Rails 應用程式: 本指南描述如何偵錯 Rails 應用程式。它涵蓋實現這一目標的不同方式，以及如何了解您的程式碼「幕後」發生的情況。
設定 Rails 應用程式: 本指南涵蓋 Rails 應用程式的基本設定。
Rails 命令列: 有一些命令對於您日常使用 Rails 至關重要。本指南涵蓋 Rails 提供的命令列工具。
資源管道: 資源管道提供了一個框架，用於連接和縮小或壓縮 JavaScript、CSS 和影像資源。它還增加了使用其他語言和預處理器（例如 CoffeeScript、Sass 和 ERB）編寫這些資源的能力。
在 Rails 中使用 JavaScript: 本指南說明如何使用導入映射或 jsbundling-rails 在 Rails 應用程式中包含 JavaScript，並涵蓋在 Rails 中使用 Turbo 的基礎知識。
Rails 初始化過程: 正在進行中; 本指南說明 Rails 中初始化過程的內部機制。這是一份非常深入的指南，建議進階 Rails 開發人員閱讀。
自動載入與重新載入: 本指南說明自動載入和重新載入常數的工作方式。
Rails 快取概觀: 本指南簡介如何使用快取來加速您的 Rails 應用程式。
Active Support 檢測: 正在進行中; 本指南說明如何使用 Active Support 內的檢測 API 來測量 Rails 和其他 Ruby 程式碼內的事件。
將 Rails 用於純 API 應用程式: 本指南說明如何有效地使用 Rails 開發 JSON API 應用程式。
調整效能以進行部署: 本指南涵蓋部署生產 Ruby on Rails 應用程式的效能和並行組態。

進階 Active Record

Active Record 和 PostgreSQL: 正在進行中; 本指南涵蓋 Active Record 的 PostgreSQL 特定用法。
多個資料庫: 本指南涵蓋如何在您的應用程式中使用多個資料庫。
Active Record 加密: 正在進行中; 本指南說明如何使用 Active Record 加密您的資料庫資訊。
複合主鍵: 本指南為資料庫表格的複合主鍵介紹。

擴展 Rails

建立 Rails 外掛程式的基本知識: 正在進行中; 本指南說明如何建立外掛程式以擴展 Rails 的功能。
Rack 上的 Rails: 本指南說明 Rails 與 Rack 的整合，以及如何與其他 Rack 組件介接。
建立和自訂 Rails 生成器 & 範本: 本指南說明如何為您的擴充功能新增全新的產生器，或為內建的 Rails 產生器元素提供替代方案（例如，為 scaffold 產生器提供替代的測試存根）。
開始使用 Engines: 正在進行中; Engines 可以被視為微型應用程式，為其主機應用程式提供額外功能。在本指南中，您將學習如何建立自己的 engine 並將其與主機應用程式整合。
Rails 應用程式範本: 正在進行中; 應用程式範本是簡單的 Ruby 檔案，其中包含 DSL，用於將 gem、初始化器等新增至您新建立的 Rails 專案或現有的 Rails 專案。
Rails 中的執行緒和程式碼執行: 正在進行中; 本指南描述在 Rails 應用程式中直接使用並行時所需考量的因素和可用的工具。

貢獻

貢獻給 Ruby on Rails: Rails 不是「別人的框架」。本指南涵蓋您可以參與 Rails 持續開發的各種方式。
API 文件指南: 本指南記錄了 Ruby on Rails API 文件指南。
指南指南: 本指南記錄了 Ruby on Rails 指南指南。
安裝 Rails 核心開發相依性: 本指南說明如何設定 Ruby on Rails 核心開發的環境。

政策

維護政策: 目前支援哪些 Ruby on Rails 版本，以及何時預期會發布新版本。

版本說明

升級 Ruby on Rails: 本指南提供將您的應用程式升級到較新版本的 Ruby on Rails 時應遵循的步驟。
版本 8.0 - ?: 正在進行中; Rails 8.0 的發行說明。
7.2 版 - 2024 年 8 月: Rails 7.2 的發行說明。
7.1 版 - 2023 年 10 月: Rails 7.1 的發行說明。
7.0 版 - 2021 年 12 月: Rails 7.0 的發行說明。
6.1 版 - 2020 年 12 月: Rails 6.1 的發行說明。
6.0 版 - 2019 年 8 月: Rails 6.0 的發行說明。
5.2 版 - 2018 年 4 月: Rails 5.2 的發行說明。
5.1 版 - 2017 年 4 月: Rails 5.1 的發行說明。
5.0 版 - 2016 年 6 月: Rails 5.0 的發行說明。
4.2 版 - 2014 年 12 月: Rails 4.2 的發行說明。
4.1 版 - 2014 年 4 月: Rails 4.1 的發行說明。
4.0 版 - 2013 年 6 月: Rails 4.0 的發行說明。
3.2 版 - 2012 年 1 月: Rails 3.2 的發行說明。
3.1 版 - 2011 年 8 月: Rails 3.1 的發行說明。
3.0 版 - 2010 年 8 月: Rails 3.0 的發行說明。
2.3 版 - 2009 年 3 月: Rails 2.3 的發行說明。
2.2 版 - 2008 年 11 月: Rails 2.2 的發行說明。