更多資訊請至 rubyonrails.org:

Ruby on Rails 指南 (v8.0.0)

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

早期版本的指南:Rails 7.1Rails 7.0Rails 6.1Rails 6.0Rails 5.2Rails 5.1Rails 5.0Rails 4.2Rails 4.1Rails 4.0Rails 3.2Rails 3.1Rails 3.0Rails 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 的發行說明。



回到頂端