edge
เพิ่มเติมที่ rubyonrails.org: เพิ่มเติมเกี่ยวกับ Ruby on Rails

คู่มือ Ruby on Rails (75b9e4f)

นี่คือ คู่มือ Edge ที่อ้างอิงจาก main@75b9e4f

หากคุณกำลังมองหาคู่มือสำหรับเวอร์ชันที่เสถียร โปรดตรวจสอบที่ https://guides.rubyonrails.org แทน

คู่มือสำหรับเวอร์ชันก่อนหน้า: 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

ทุกอย่างที่คุณต้องรู้เพื่อติดตั้ง Rails และสร้างแอปพลิเคชันครั้งแรกของคุณ

โมเดล

พื้นฐานของ Active Record

Active Record ช่วยให้โมเดลของคุณสามารถทำงานร่วมกับฐานข้อมูลของแอปพลิเคชันได้ คู่มือนี้จะช่วยให้คุณเริ่มต้นกับโมเดล Active Record และการบันทึกข้อมูลลงในฐานข้อมูล

Active Record Migrations

การย้ายข้อมูลเป็นคุณสมบัติของ Active Record ที่ช่วยให้คุณสามารถพัฒนาโครงสร้างฐานข้อมูลของคุณได้ตลอดเวลา แทนที่จะเขียนการปรับเปลี่ยนโครงสร้างของฐานข้อมูลในรูปแบบ SQL สามารถใช้ migrations เพื่อใช้ Ruby DSL เพื่ออธิบายการเปลี่ยนแปลงในตารางของคุณได้

การตรวจสอบความถูกต้องของ Active Record

การตรวจสอบความถูกต้อง (validations) ถูกใช้เพื่อให้มั่นใจว่าข้อมูลที่ถูกต้องเท่านั้นที่จะถูกบันทึกลงในฐานข้อมูลของคุณ คู่มือนี้จะสอนคุณวิธีการตรวจสอบสถานะของอ็อบเจกต์ก่อนที่จะเข้าสู่ฐานข้อมูล โดยใช้คุณสมบัติการตรวจสอบของ Active Record

Active Record Callbacks

การเรียกใช้งานย่อยทำให้เป็นไปได้ที่จะเขียนโค้ดที่จะทำงานเมื่อมีการสร้างวัตถุ อัปเดต ทำลาย เป็นต้น คู่มือนี้สอนวิธีการเชื่อมต่อกับวัตถุในรอบชีวิตของวัตถุ Active Record

การเชื่อมต่อ Active Record Associations

ใน Active Record การสัมพันธ์คือการเชื่อมต่อระหว่างโมเดล Active Record สองตัวกัน คู่มือนี้จะกล่าวถึงการสัมพันธ์ทั้งหมดที่ Active Record มีให้

อินเตอร์เฟซการค้นหา Active Record

แทนที่จะใช้ SQL แบบเชิงรุกในการค้นหาเร็คคอร์ดในฐานข้อมูล Active Record จะให้วิธีที่ดีกว่าในการดำเนินการเดียวกัน คู่มือนี้จะอธิบายวิธีการเรียกดูข้อมูลจากฐานข้อมูลโดยใช้ Active Record ในวิธีที่แตกต่างกันไป

พื้นฐานของ Active Model

Active Model ช่วยให้คุณสร้างวัตถุ Ruby ที่เป็นเพียงวัตถุธรรมดาที่ผสมผสานกับ Action Pack แต่ไม่ต้องการ Active Record สำหรับการจัดเก็บข้อมูลในฐานข้อมูล Active Model ยังช่วยในการสร้าง ORM ที่กำหนดเองสำหรับการใช้งานนอกเฟรมเวิร์กเรลส์ คู่มือนี้จะให้ข้อมูลทั้งหมดที่คุณต้องการเพื่อเริ่มต้นใช้งานคลาส Active Model

มุมมอง

ภาพรวมของ Action View

Action View มีหน้าที่ในการสร้าง HTML สำหรับการตอบสนองของเว็บไซต์ คู่มือนี้จะให้คำแนะนำเบื้องต้นเกี่ยวกับ Action View

การจัดเลย์และการเรนเดอร์ใน Rails

คู่มือนี้เป็นการอธิบายเกี่ยวกับคุณสมบัติพื้นฐานของ Action Controller และ Action View ซึ่งรวมถึงการเรนเดอร์และการเปลี่ยนเส้นทาง การใช้บล็อก content_for และการทำงานกับ partials

Action View Helpers

Action View มีตัวช่วยสำหรับการจัดการทุกอย่างตั้งแต่การจัดรูปแบบวันที่และการเชื่อมโยงไปยังรูปภาพ ไปจนถึงการทำให้เนื้อหาเป็นปลอดภัยและการแปลภาษาสถานที่ คู่มือนี้จะแนะนำเครื่องมือ Action View บางอย่างที่ใช้บ่อยมากกว่านี้

Action View Form Helpers

ฟอร์ม HTML สามารถกลายเป็นงานที่น่าเบื่อและยากในการเขียนและบำรุงรักษาเนื่องจากต้องจัดการการตั้งชื่อและแอตทริบิวต์ของควบคุมฟอร์มในจำนวนมาก แต่ Rails ก็กำจัดความซับซ้อนนี้ด้วยการ提供เครื่องมือช่วยในการสร้างมาร์กอัปฟอร์ม

คอนโทรลเลอร์

ภาพรวมของ Action Controller

Action Controllers เป็นส่วนหลักของการร้องขอเว็บใน Rails คู่มือนี้จะอธิบายถึงวิธีการทำงานของคอนโทรลเลอร์และวิธีการนำมาใช้ในรอบการร้องขอของแอปพลิเคชันของคุณ มันรวมถึงเซสชัน ฟิลเตอร์ คุกกี้ การสตรีมข้อมูล และการจัดการกับข้อยกเว้นที่เกิดขึ้นจากการร้องขอ รวมถึงหัวข้ออื่น ๆ อีกมากมาย

การเชื่อมต่อ URL กับโค้ด

เราสามารถใช้ Rails router เพื่อรับรู้ URL และส่งต่อไปยัง action ของ controller ได้ คู่มือนี้จะอธิบายเกี่ยวกับคุณสมบัติที่เกี่ยวข้องกับการเรียกใช้งานของผู้ใช้ในการเรียกใช้งาน Rails routing หากคุณต้องการเข้าใจวิธีการใช้งาน routing ในแอปพลิเคชัน Rails ของคุณเอง คุณสามารถเริ่มต้นที่นี่

องค์ประกอบอื่น ๆ

ส่วนขยายของ Active Support Core

Active Support ให้การเพิ่มเติมให้กับภาษา Ruby และเครื่องมือต่างๆ ซึ่งเพิ่มความสมบูรณ์ให้กับภาษา Ruby สำหรับการพัฒนาแอปพลิเคชัน Rails และสำหรับการพัฒนา Ruby on Rails ด้วยตัวเอง

พื้นฐานของ Action Mailer

คู่มือนี้จะให้คุณทราบทุกสิ่งที่คุณต้องการเพื่อเริ่มส่งอีเมลจากแอปพลิเคชันของคุณ และรายละเอียดภายในของ Action Mailer อีกด้วย

พื้นฐานของ Action Mailbox

คู่มือนี้อธิบายวิธีการใช้ Action Mailbox เพื่อรับอีเมล์

ภาพรวมของ Action Text

คู่มือนี้อธิบายวิธีการใช้ Action Text เพื่อจัดการเนื้อหา Rich Text

พื้นฐานของ Active Job

Active Job เป็นเฟรมเวิร์กสำหรับประกาศงานที่ทำงานในพื้นหลังและทำให้เราสามารถเรียกใช้งานในคิวที่หลากหลายได้ คู่มือนี้จะให้ข้อมูลทั้งหมดที่คุณต้องการเพื่อเริ่มต้นสร้างงานในพื้นหลัง นำเข้าในคิว และประมวลผลงานในพื้นหลัง

ภาพรวมของ Active Storage

Active Storage ช่วยให้สามารถอัปโหลดไฟล์ไปยังบริการเก็บข้อมูลในคลาวด์ และสามารถแปลงไฟล์และสกัดเมตาดาต้าได้ คู่มือนี้จะอธิบายวิธีการแนบไฟล์กับโมเดล Active Record ของคุณ

ภาพรวมของ Action Cable

Action Cable รวม WebSockets กับแอปพลิเคชัน Rails ของคุณเข้าด้วยกัน มันช่วยให้คุณสามารถเขียนคุณลักษณะแบบเรียลไทม์ในรูปแบบและรูปแบบเดียวกับส่วนอื่น ๆ ของแอปพลิเคชัน Rails ของคุณ คู่มือนี้อธิบายวิธีการทำงานของ Action Cable และวิธีใช้ WebSockets เพื่อสร้างคุณลักษณะแบบเรียลไทม์

Webpacker

คู่มือนี้จะแสดงวิธีการติดตั้งและใช้งาน Webpacker เพื่อแพ็คเกจ JavaScript, CSS และทรัพยากรอื่น ๆ สำหรับส่วนของไคลเอ็นต์ในแอปพลิเคชัน Rails ของคุณ

การขุดลึกขึ้นไปอีก

API การระบุภาษาสากล (I18n) ของ Rails

คู่มือนี้เป็นการแนะนำวิธีการเพิ่มระบบการรองรับภาษาต่างประเทศในแอปพลิเคชันของคุณ แอปพลิเคชันของคุณจะสามารถแปลเนื้อหาเป็นภาษาต่างๆ ปรับเปลี่ยนกฎการเปลี่ยนรูปคำพหูพจน์ ใช้รูปแบบวันที่ที่ถูกต้องสำหรับแต่ละประเทศ และอื่นๆ อีกมากมาย

การทดสอบแอปพลิเคชัน Rails

นี่เป็นคู่มือที่ครอบคลุมทั้งหมดเกี่ยวกับสถานที่ทดสอบต่าง ๆ ใน Rails อย่างละเอียดอ่อน มันครอบคลุมทุกอย่างตั้งแต่ 'ทดสอบคืออะไร?' ถึงการทดสอบการรวมกัน ขอให้สนุกนะคะ

การรักษาความปลอดภัยในแอปพลิเคชัน Rails

คู่มือนี้อธิบายปัญหาความปลอดภัยที่พบบ่อยในแอปพลิเคชันเว็บและวิธีการป้องกันด้วย Rails

การรายงานข้อผิดพลาดในแอปพลิเคชัน Rails

คู่มือนี้นำเสนอวิธีการจัดการข้อยกเว้นที่เกิดขึ้นในแอปพลิเคชัน Ruby on Rails

การแก้ปัญหาในแอปพลิเคชัน Rails

คู่มือนี้อธิบายวิธีการแก้บั๊กในแอปพลิเคชัน Rails โดยครอบคลุมวิธีการต่าง ๆ ในการทำเช่นนี้และวิธีการเข้าใจว่าเกิดอะไรขึ้น "ในหลังจากที่เราเขียนโค้ด"

การกำหนดค่าแอปพลิเคชัน Rails

คู่มือนี้เป็นการครอบคลุมการตั้งค่าพื้นฐานสำหรับแอปพลิเคชัน Rails

คำสั่ง Rails Command Line

มีคำสั่งหลายอย่างที่สำคัญอย่างแน่นอนสำหรับการใช้งานประจำวันของคุณใน Rails คู่มือนี้จะอธิบายเครื่องมือบรรทัดคำสั่งที่ Rails จัดหาให้

ท่องทางทรัพยากร (Asset Pipeline)

ทาง asset pipeline ให้เฟรมเวิร์กเพื่อรวมและบีบอัดหรือบีบอัด JavaScript, CSS และภาพทรัพยากร นอกจากนี้ยังเพิ่มความสามารถในการเขียนทรัพยากรเหล่านี้ในภาษาและตัวประมวลผลก่อนเช่น CoffeeScript, Sass และ ERB

การทำงานกับ JavaScript ใน Rails

คู่มือนี้อธิบายวิธีการใช้ import maps หรือ jsbundling-rails เพื่อรวม JavaScript เข้ากับแอปพลิเคชัน Rails และอธิบายเกี่ยวกับพื้นฐานในการทำงานกับ Turbo ใน Rails

กระบวนการเริ่มต้น Rails

คู่มือนี้อธิบายกระบวนการเริ่มต้นภายในของ Rails โดยละเอียดมาก และแนะนำให้นักพัฒนา Rails ระดับสูงใช้งาน

การโหลดอัตโนมัติและโหลดใหม่ของค่าคงที่

คู่มือนี้เอกสารถึงวิธีการโหลดอัตโนมัติและโหลดค่าคงที่ในโหมด Zeitwerk

คู่มือการเปลี่ยนจากโหมด "classic" เป็นโหมด "zeitwerk"

คู่มือนี้เอกสารถึงวิธีการย้ายแอปพลิเคชัน Rails จากโหมด `classic` เป็นโหมด `zeitwerk`

การใช้แคชกับ Rails: ภาพรวม

คู่มือนี้เป็นการแนะนำในการเร่งความเร็วของแอปพลิเคชัน Rails ของคุณด้วยการใช้แคช

Active Support Instrumentation

คู่มือนี้อธิบายวิธีการใช้เครื่องมือ API การตรวจวัดภายใน Active Support เพื่อวัดเหตุการณ์ภายใน Rails และโค้ด Ruby อื่นๆ

การใช้ Rails สำหรับแอปพลิเคชัน API เท่านั้น

คู่มือนี้อธิบายวิธีการใช้ Rails ในการพัฒนาแอปพลิเคชัน JSON API อย่างมีประสิทธิภาพ

Active Record และ PostgreSQL

คู่มือนี้เป็นการแสดงวิธีการใช้งานของ Active Record สำหรับ PostgreSQL โดยเฉพาะ

หลายฐานข้อมูลด้วย Active Record

คู่มือนี้เป็นการแนะนำในการใช้ฐานข้อมูลหลายรายการในแอปพลิเคชันของคุณ

การเข้ารหัส Active Record

คู่มือนี้อธิบายการเข้ารหัสข้อมูลฐานข้อมูลของคุณโดยใช้ Active Record

การขยายขนาด Rails

พื้นฐานในการสร้างปลั๊กอิน Rails

คู่มือนี้เป็นการแนะนำวิธีการสร้างปลั๊กอินเพื่อเพิ่มความสามารถของ Rails

เรลส์บนแร็ก

คู่มือนี้เป็นการครอบคลุมการรวม Rails กับ Rack และการติดต่อกับคอมโพเนนต์ Rack อื่น ๆ

การสร้างและปรับแต่งเจเนอเรเตอร์และเทมเพลตใน Rails

คู่มือนี้เป็นการแนะนำกระบวนการเพิ่มเครื่องกำเนิดไฟฟ้าใหม่ในส่วนขยายของคุณหรือให้ตัวเลือกทางเลือกสำหรับองค์ประกอบของเครื่องกำเนิดไฟฟ้าใน Rails generator ที่มีอยู่ (เช่นการให้ตัวอย่างการทดสอบทางเลือกสำหรับเครื่องกำเนิดไฟฟ้า scaffold)

เริ่มต้นใช้งาน Engines

เครื่องมือเครื่องยนต์สามารถถือว่าเป็นแอปพลิเคชันขนาดเล็กที่ให้ฟังก์ชันพิเศษเพิ่มเติมให้กับแอปพลิเคชันหลักของพวกเขา ในคู่มือนี้คุณจะเรียนรู้วิธีการสร้างเครื่องมือเครื่องยนต์ของคุณเองและรวมมันเข้ากับแอปพลิเคชันหลัก

เทมเพลตแอปพลิเคชัน Rails

เทมเพลตแอปพลิเคชันเป็นไฟล์ Ruby ที่เรียบง่ายที่มี DSL สำหรับเพิ่มเจมส์ เริ่มต้นการทำงาน ฯลฯ เข้ากับโปรเจค Rails ที่คุณสร้างใหม่หรือโปรเจค Rails ที่มีอยู่แล้ว

การใช้เธรดและการประมวลผลโค้ดใน Rails

คู่มือนี้อธิบายถึงข้อคิดที่จำเป็นและเครื่องมือที่ใช้ได้เมื่อทำงานโดยตรงกับความสามารถในการทำงานพร้อมกันในแอปพลิเคชัน Rails

การมีส่วนร่วม

การสนับสนุนในการพัฒนา Ruby on Rails

เรลส์ไม่ใช่ "เฟรมเวิร์กของคนอื่น" คู่มือนี้จะแสดงถึงวิธีต่างๆที่คุณสามารถมีส่วนร่วมในการพัฒนาเรลส์ได้

คู่มือเอพีไอ

เอกสารนี้เป็นคู่มือเกี่ยวกับแนวทางการเขียนเอพีไอของ Ruby on Rails

คู่มือ Ruby on Rails Guidelines

เอกสารนี้เป็นคู่มือที่เกี่ยวข้องกับแนวทางการใช้งาน Ruby on Rails guides

การติดตั้งความขึ้นอยู่กับการพัฒนา Rails Core

คู่มือนี้เป็นการแนะนำวิธีการติดตั้งสภาพแวดล้อมสำหรับการพัฒนา Ruby on Rails core

นโยบาย

นโยบายการบำรุงรักษาสำหรับ Ruby on Rails

เวอร์ชันของ Ruby on Rails ที่รองรับในปัจจุบันคือเวอร์ชันใด และเมื่อไหร่จะมีเวอร์ชันใหม่ Ruby on Rails ปัจจุบันรองรับเวอร์ชัน 6.1.x และ 6.0.x โดยทั่วไปแล้วจะมีการอัปเดตเวอร์ชันใหม่ทุกปี โดยมักจะมีการอัปเดตใหญ่ในช่วงต้นปี และการอัปเดตระหว่างปีจะเป็นการแก้ไขบั๊กและปรับปรุงคุณภาพของระบบ สำหรับเวอร์ชันใหม่ ยังไม่มีข้อมูลที่แน่ชัดเกี่ยวกับเวอร์ชันถัดไป แต่สามารถติดตามข่าวสารเกี่ยวกับการอัปเดตได้จากเว็บไซต์หลักของ 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

เรื่องเด่นใน Rails 6.0:

บันทึกการอัปเดตสำหรับ Rails 6.0

เรื่องเด่นใน Rails 5.2:

บันทึกการอัปเดตสำหรับ Rails 5.2

เนื้อหาสำคัญใน Rails 5.1:

บันทึกการอัปเดตสำหรับ Rails 5.1

เรื่องสำคัญใน Rails 5.0:

บันทึกการอัปเดตสำหรับ Rails 5.0

เนื้อหาสำคัญใน 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 เพื่อดูรูปแบบและกฎเกณฑ์

หากคุณพบข้อผิดพลาดแต่ไม่สามารถแก้ไขได้เอง กรุณา เปิดปัญหา.

และสุดท้าย การสนทนาใด ๆ เกี่ยวกับ Ruby on Rails เอกสารยินดีต้อนรับที่สุดใน เว็บบอร์ดอย่างเป็นทางการของ Ruby on Rails.