Ruby on Rails 가이드 (8.1)

이것은 Rails 8.1의 새로운 가이드입니다. 이 가이드는 Rails로 즉시 생산성을 높이고 모든 요소가 어떻게 맞물려 있는지 이해하는 데 도움을 주기 위해 설계되었습니다.

이전 릴리스의 가이드: Rails 7.2, 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 시작하기: 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 쿼리 인터페이스: 데이터베이스 레코드를 찾기 위해 원시 SQL을 사용하는 대신, Active Record는 동일한 작업을 수행하는 더 나은 방법을 제공합니다. 이 가이드는 Active Record를 사용하여 데이터베이스에서 데이터를 검색하는 다양한 방법을 다룹니다.
Active Model 기초: Active Model을 사용하면 데이터베이스 지속성을 위해 Active Record가 필요하지 않지만 Action Pack과 통합되는 일반 Ruby 객체를 만들 수 있습니다. Active Model은 또한 Rails 프레임워크 외부에서 사용할 사용자 정의 ORM을 구축하는 데 도움이 됩니다. 이 가이드는 Active Model 클래스 사용을 시작하는 데 필요한 모든 것을 제공합니다.

뷰

Action View 개요: Action View는 웹 응답을 위한 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에서 웹 요청의 핵심입니다. 이 가이드는 컨트롤러가 어떻게 작동하고 애플리케이션의 요청 주기에 어떻게 맞는지 다룹니다. 세션, 필터, 쿠키, 데이터 스트리밍, 요청에 의해 발생한 예외 처리 등의 주제를 포함합니다.
외부에서 본 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은 WebSocket을 Rails 애플리케이션의 나머지 부분과 통합합니다. 이를 통해 실시간 기능을 Rails 애플리케이션의 나머지 부분과 동일한 스타일과 형식으로 Ruby로 작성할 수 있습니다. 이 가이드는 Action Cable이 어떻게 작동하는지, 그리고 WebSocket을 사용하여 실시간 기능을 만드는 방법을 설명합니다.

더 깊이 파고들기

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 작업하기: 이 가이드는 Rails 애플리케이션에 JavaScript를 포함시키기 위해 import maps 또는 jsbundling-rails를 사용하는 방법을 설명하고, Rails에서 Turbo를 사용하는 기본 사항을 다룹니다.
Rails 초기화 프로세스: Work in progress; 이 가이드는 Rails의 초기화 프로세스 내부를 설명합니다. 이는 매우 심도 있는 가이드이며 고급 Rails 개발자에게 권장됩니다.
자동 로딩 및 리로딩: 이 가이드는 상수의 자동 로딩 및 리로딩 작동 방식을 설명합니다.
Rails의 캐싱: 개요: 이 가이드는 캐싱을 사용하여 Rails 애플리케이션의 속도를 높이는 방법을 소개합니다.
Active Support 계측: Work in progress; 이 가이드는 Rails 및 기타 Ruby 코드 내부의 이벤트를 측정하기 위해 Active Support 내의 계측 API를 사용하는 방법을 설명합니다.
API 전용 애플리케이션을 위한 Rails 사용: 이 가이드는 JSON API 애플리케이션을 개발하기 위해 Rails를 효과적으로 사용하는 방법을 설명합니다.
배포를 위한 성능 튜닝: 이 가이드는 프로덕션 Ruby on Rails 애플리케이션을 배포하기 위한 성능 및 동시성 구성을 다룹니다.

고급 Active Record

Active Record와 PostgreSQL: Work in progress; 이 가이드는 Active Record의 PostgreSQL 특정 사용법을 다룹니다.
다중 데이터베이스: 이 가이드는 애플리케이션에서 여러 데이터베이스를 사용하는 방법을 다룹니다.
Active Record 암호화: Work in progress; 이 가이드는 Active Record를 사용하여 데이터베이스 정보를 암호화하는 방법을 다룹니다.
복합 기본 키: 이 가이드는 데이터베이스 테이블의 복합 기본 키에 대한 소개입니다.

Rails 확장하기

Rails 플러그인 생성의 기초: Work in progress; 이 가이드는 Rails의 기능을 확장하기 위한 플러그인을 구축하는 방법을 다룹니다.
Rack 위의 Rails: 이 가이드는 Rails와 Rack의 통합 및 다른 Rack 컴포넌트와의 인터페이스에 대해 다룹니다.
Rails 제너레이터 및 템플릿 생성 및 커스터마이징: 이 가이드는 확장에 새로운 제너레이터를 추가하거나 내장 Rails 제너레이터의 요소에 대한 대안을 제공하는 과정(예: 스캐폴드 제너레이터에 대한 대체 테스트 스텁 제공)을 다룹니다.
엔진 시작하기: Work in progress; 엔진은 호스트 애플리케이션에 추가 기능을 제공하는 소형 애플리케이션으로 간주될 수 있습니다. 이 가이드에서는 자신만의 엔진을 만들고 호스트 애플리케이션과 통합하는 방법을 배웁니다.
Rails 애플리케이션 템플릿: Work in progress; 애플리케이션 템플릿은 새로 생성된 Rails 프로젝트나 기존 Rails 프로젝트에 gem, 초기화 프로그램 등을 추가하기 위한 DSL을 포함하는 간단한 Ruby 파일입니다.
Rails에서의 스레딩 및 코드 실행: Work in progress; 이 가이드는 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.1 - ?: Work in progress; Rails 8.1 릴리스 노트.
버전 8.0 - 2024년 11월: 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 릴리스 노트.