Ruby on Rails 가이드

여기에서 시작하세요.

레일즈 시작하기: 레일스를 설치하고 첫 번째 애플리케이션을 생성하는 데 필요한 모든 것을 알려드리겠습니다.

모델들

액티브 레코드 기본 사항: Active Record는 모델이 애플리케이션의 데이터베이스와 상호작용할 수 있게 해줍니다. 이 가이드는 Active Record 모델과 데이터베이스에 대한 지속성을 시작하는 데 도움이 될 것입니다.
Active Record Migrations: 마이그레이션은 Active Record의 기능으로, 데이터베이스 스키마를 시간이 지남에 따라 진화시킬 수 있게 해줍니다. 순수한 SQL로 스키마 수정을 작성하는 대신, 마이그레이션은 루비 DSL을 사용하여 테이블에 대한 변경 사항을 설명할 수 있게 해줍니다.
Active Record 유효성 검사: 유효성 검사는 데이터베이스에 유효한 데이터만 저장되도록 하는 데 사용됩니다. 이 가이드는 Active Record의 유효성 검사 기능을 사용하여 데이터베이스에 들어가기 전에 객체의 상태를 검증하는 방법을 가르쳐줍니다.
Active Record 콜백: 콜백은 객체가 생성, 업데이트, 삭제 등이 발생할 때마다 실행될 코드를 작성할 수 있게 해줍니다. 이 가이드는 Active Record 객체의 객체 생명주기에 훅을 걸어서 이를 활용하는 방법을 가르쳐줍니다.
Active Record 연관 관계: 액티브 레코드에서는 연관성이란 두 개의 액티브 레코드 모델 간의 연결을 말합니다. 이 가이드는 액티브 레코드에서 제공하는 모든 연관성을 다룹니다.
Active Record 쿼리 인터페이스: Active Record는 데이터베이스 레코드를 찾기 위해 원시 SQL을 사용하는 대신, 더 나은 방법을 제공합니다. 이 가이드는 Active Record를 사용하여 데이터베이스에서 데이터를 검색하는 다양한 방법을 다룹니다.
액티브 모델 기본 사항: Active Model은 Action Pack과 통합되는 일반적인 루비 객체를 생성할 수 있게 해줍니다. 그러나 데이터베이스 영속성을 위해 Active Record가 필요하지 않습니다. Active Model은 또한 Rails 프레임워크 외부에서 사용하기 위한 사용자 정의 ORM을 구축하는 데 도움을 줍니다. 이 안내서는 Active Model 클래스를 사용하기 위해 필요한 모든 정보를 제공합니다.

견해

Action View 개요: Action View는 웹 응답을 위한 HTML을 생성하는 역할을 담당합니다. 이 가이드는 Action View에 대한 소개를 제공합니다.
레일스에서의 레이아웃과 렌더링: 이 안내서는 Action Controller와 Action View의 기본 레이아웃 기능을 다룹니다. 렌더링과 리다이렉팅, content_for 블록 사용, 그리고 파셜(partial) 작업에 대해 알려줍니다.
액션 뷰 헬퍼: 액션 뷰는 날짜 형식 지정 및 이미지 링크, 콘텐츠의 살균 및 로컬라이징 등 모든 것을 처리하기 위한 도우미를 가지고 있습니다. 이 가이드는 몇 가지 일반적인 액션 뷰 도우미를 소개합니다.
Action View Form Helpers: HTML 양식은 양식 컨트롤의 이름과 여러 속성을 처리해야 하기 때문에 작성 및 유지 관리가 번거로워질 수 있습니다. Rails는 양식 마크업을 생성하기 위한 뷰 헬퍼를 제공함으로써 이 복잡성을 제거합니다.

컨트롤러

Action Controller 개요: 액션 컨트롤러는 레일즈에서 웹 요청의 핵심입니다. 이 가이드는 컨트롤러가 어떻게 작동하며 어떻게 애플리케이션의 요청 주기에 통합되는지에 대해 다룹니다. 세션, 필터, 쿠키, 데이터 스트리밍 및 요청으로 인해 발생하는 예외 처리 등 다양한 주제를 포함하고 있습니다.
밖에서 안으로의 Rails 라우팅: 레일스 라우터는 URL을 인식하고 컨트롤러의 액션으로 전달합니다. 이 가이드는 레일스 라우팅의 사용자 인터페이스 기능을 다룹니다. 자신의 레일스 애플리케이션에서 라우팅을 사용하는 방법을 이해하고 싶다면, 여기에서 시작하세요.

다른 구성 요소

Active Support Core Extensions: Active Support는 루비 언어 확장과 유틸리티를 제공합니다. 이는 루비 언어를 더욱 풍부하게 만들어 레일스 애플리케이션 및 루비 온 레일즈 자체의 개발에 사용됩니다.
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은 웹소켓을 Rails 애플리케이션의 나머지 부분과 통합합니다. 이를 통해 실시간 기능을 Rails 애플리케이션의 나머지 부분과 동일한 스타일과 형식으로 루비로 작성할 수 있습니다. 이 안내서에서는 Action Cable이 작동하는 방식과 웹소켓을 사용하여 실시간 기능을 만드는 방법을 설명합니다.
Webpacker: 이 가이드는 웹팩을 설치하고 사용하는 방법을 보여줄 것입니다. 웹팩은 JavaScript, CSS 및 기타 에셋을 Rails 애플리케이션의 클라이언트 측에 패키징하는 데 사용됩니다.

더 깊이 파고들기

Rails Internationalization (I18n) API: 이 가이드는 애플리케이션에 국제화를 추가하는 방법을 다룹니다. 애플리케이션은 다른 언어로 콘텐츠를 번역하고, 복수화 규칙을 변경하며, 각 국가에 맞는 올바른 날짜 형식을 사용할 수 있게 될 것입니다.
Rails 애플리케이션 테스트: 이것은 레일즈에서 다양한 테스트 시설에 대한 상당히 포괄적인 안내서입니다. '테스트란 무엇인가?'에서부터 통합 테스트까지 모든 것을 다룹니다. 즐겨보세요.
Rails 애플리케이션 보안: 이 가이드는 웹 애플리케이션에서 흔히 발생하는 보안 문제와 Rails를 사용하여 이를 피하는 방법을 설명합니다.
Rails 애플리케이션에서의 오류 보고: 이 가이드는 루비 온 레일즈 애플리케이션에서 발생하는 예외를 관리하는 방법을 소개합니다.
Rails 애플리케이션 디버깅: 이 가이드는 Rails 애플리케이션의 디버깅 방법을 설명합니다. 이는 이를 달성하는 다양한 방법과 코드 "뒷면"에서 무슨 일이 일어나고 있는지 이해하는 방법을 다룹니다.
레일즈 애플리케이션 구성: 이 가이드는 Rails 애플리케이션의 기본 구성 설정을 다룹니다.
레일스 커맨드 라인: 레일즈의 일상적인 사용에 절대적으로 중요한 몇 가지 명령어가 있습니다. 이 가이드는 레일즈에서 제공하는 명령 줄 도구에 대해 다룹니다.
자산 파이프라인: 자산 파이프라인은 JavaScript, CSS 및 이미지 자산을 연결하고 압축 또는 압축하는 프레임워크를 제공합니다. 또한 CoffeeScript, Sass 및 ERB와 같은 다른 언어 및 전처리기로 이러한 자산을 작성할 수 있는 기능도 추가됩니다.
JavaScript을 사용하는 Rails 작업: 이 가이드는 Rails 애플리케이션에서 JavaScript를 포함하기 위해 import maps 또는 jsbundling-rails를 사용하는 방법을 설명하며, Rails에서 Turbo를 사용하는 기본 사항을 다룹니다.
레일즈 초기화 프로세스: 이 가이드는 Rails의 초기화 프로세스 내부를 설명합니다. 이는 매우 깊이 있는 가이드이며 고급 Rails 개발자에게 추천됩니다.
자동로드 및 상수 다시로드: 이 가이드는 상수의 자동로딩과 다시로딩이 어떻게 작동하는지에 대해 문서화합니다 (Zeitwerk 모드).
클래식에서 Zeitwerk로의 전환 HOWTO: 이 가이드는 Rails 애플리케이션을 `classic` 모드에서 `zeitwerk` 모드로 마이그레이션하는 방법을 문서화합니다.
Rails에서의 캐싱: 개요: 이 가이드는 캐싱을 사용하여 Rails 애플리케이션의 속도를 높이는 방법에 대한 소개입니다.
Active Support Instrumentation: 이 가이드는 Active Support 내의 instrumentation API를 사용하여 Rails 및 기타 Ruby 코드 내에서 이벤트를 측정하는 방법을 설명합니다.
API 전용 애플리케이션을 위해 Rails 사용하기: 이 가이드는 JSON API 애플리케이션을 개발하기 위해 Rails를 효과적으로 사용하는 방법을 설명합니다.
Active Record와 PostgreSQL: 이 가이드는 Active Record의 PostgreSQL 특정 사용법을 다룹니다.
Active Record을 사용한 여러 개의 데이터베이스: 이 가이드는 애플리케이션에서 여러 개의 데이터베이스를 사용하는 방법을 다룹니다.
Active Record 암호화: 이 가이드는 Active Record를 사용하여 데이터베이스 정보를 암호화하는 방법을 다룹니다.

레일즈 확장하기

Rails 플러그인 생성 기본 사항: 이 가이드는 Rails의 기능을 확장하기 위해 플러그인을 만드는 방법을 다룹니다.
Rack의 Rails 통합: 이 가이드는 Rails와 Rack의 통합 및 다른 Rack 구성 요소와의 인터페이스에 대해 다룹니다.
레일즈 생성기 및 템플릿 생성 및 사용자 정의하기: 이 가이드는 확장 프로그램에 새로운 생성기를 추가하거나 내장된 Rails 생성기의 요소에 대한 대체 방법을 제공하는 과정을 다룹니다 (예: 스캐폴드 생성기에 대체 테스트 스텁 제공).
엔진 시작하기: 엔진은 호스트 애플리케이션에 추가 기능을 제공하는 소규모 응용 프로그램으로 간주될 수 있습니다. 이 가이드에서는 자체 엔진을 만들고 호스트 애플리케이션과 통합하는 방법을 배우게 될 것입니다.
레일즈 애플리케이션 템플릿: 응용 프로그램 템플릿은 새롭게 생성된 레일즈 프로젝트나 기존 레일즈 프로젝트에 젬, 이니셜라이저 등을 추가하기 위한 DSL이 포함된 간단한 루비 파일입니다.
스레딩과 코드 실행(Rails): 이 가이드는 Rails 애플리케이션에서 동시성을 직접 다룰 때 고려해야 할 사항과 사용 가능한 도구에 대해 설명합니다.

기여하기

루비 온 레일즈에 기여하기: 레일즈는 "다른 사람의 프레임워크"가 아닙니다. 이 안내서는 레일즈의 지속적인 개발에 참여할 수 있는 다양한 방법을 다룹니다.
API 문서 가이드라인: 이 가이드는 루비 온 레일즈 API 문서 지침을 문서화합니다.
Ruby on Rails 가이드 지침: 이 가이드는 루비 온 레일 가이드 지침을 문서화합니다.
Rails Core 개발 의존성 설치: 이 가이드는 Ruby on Rails 코어 개발을 위한 환경 설정 방법을 다룹니다.

정책들

루비 온 레일즈 유지 보수 정책: 현재 지원되는 Ruby on Rails 버전은 무엇이며, 언제 새로운 버전을 기대할 수 있을까요?

릴리스 노트

Ruby on Rails 업그레이드: 이 가이드는 애플리케이션을 루비 온 레일스의 새 버전으로 업그레이드할 때 따라야 할 단계를 제공합니다.
Ruby on Rails 7.1 릴리스 노트: Rails 7.1의 릴리스 노트입니다.
루비 온 레일즈 7.0 릴리스 노트: Rails 7.0에 대한 릴리스 노트입니다.
Ruby on Rails 6.1 릴리스 노트: Rails 6.1의 릴리스 노트입니다.
루비 온 레일즈 6.0 릴리스 노트: Rails 6.0의 릴리스 노트입니다.
루비 온 레일즈 5.2 릴리스 노트: Rails 5.2의 릴리스 노트입니다.
Ruby on Rails 5.1 릴리스 노트: Rails 5.1의 릴리스 노트입니다.
Ruby on Rails 5.0 릴리스 노트: Rails 5.0의 릴리스 노트입니다.
Ruby on Rails 4.2 릴리스 노트: Rails 4.2의 릴리스 노트입니다.
루비 온 레일즈 4.1 릴리스 노트: Rails 4.1의 릴리스 노트입니다.
루비 온 레일즈 4.0 릴리스 노트: Rails 4.0의 릴리스 노트입니다.
루비 온 레일즈 3.2 릴리스 노트: 릴스 노트 - Rails 3.2
루비 온 레일즈 3.1 릴리스 노트: 릴스 노트 - Rails 3.1
Ruby on Rails 3.0 릴리스 노트: 릴스 노트 - Rails 3.0 Rails 3.0은 2010년 8월 29일에 릴리스된 Ruby on Rails의 주요 업데이트입니다. 이 릴리스는 많은 새로운 기능과 개선 사항을 포함하고 있으며, 개발자들에게 더 나은 개발 경험을 제공합니다. 주요 변경 사항: 1. 새로운 애플리케이션 생성 방법: Rails 3.0에서는 "rails new" 명령어를 사용하여 새로운 애플리케이션을 생성할 수 있습니다. 이 명령어는 애플리케이션의 구조와 설정을 자동으로 생성해줍니다. 2. Bundler의 통합: Rails 3.0은 Bundler를 통합하여 의존성 관리를 더욱 쉽게 할 수 있도록 지원합니다. 이를 통해 애플리케이션의 필요한 젬들을 관리하고 설치할 수 있습니다. 3. Rails Engine: Rails 3.0에서는 엔진(Engine)이라는 개념이 도입되었습니다. 엔진은 독립적인 기능을 가진 마이크로 애플리케이션으로, 다른 애플리케이션에 재사용될 수 있습니다. 4. Action Mailer 개선: Rails 3.0에서는 Action Mailer가 개선되었습니다. 이제 이메일 템플릿을 더욱 쉽게 작성할 수 있으며, 다양한 이메일 기능을 더욱 효율적으로 사용할 수 있습니다. 5. ActiveRecord 개선: Rails 3.0에서는 ActiveRecord에도 여러 가지 개선 사항이 있습니다. 이제 더욱 강력한 쿼리 인터페이스를 제공하며, 데이터베이스 연결과 관련된 설정을 더욱 유연하게 할 수 있습니다. 6. 라우팅 개선: Rails 3.0에서는 라우팅 시스템이 개선되었습니다. 이제 RESTful한 라우팅을 더욱 쉽게 설정할 수 있으며, 라우팅 설정을 더욱 유연하게 할 수 있습니다. 7. 테스트 개선: Rails 3.0에서는 테스트 도구인 Test::Unit이 개선되었습니다. 이제 테스트 코드를 더욱 쉽게 작성하고 실행할 수 있으며, 테스트 커버리지를 더욱 쉽게 확인할 수 있습니다. Rails 3.0은 Ruby on Rails 개발자들에게 더욱 편리하고 강력한 개발 환경을 제공합니다. 이전 버전과의 호환성을 유지하면서도 많은 새로운 기능과 개선 사항을 제공하므로, 업그레이드를 고려해보시기 바랍니다.
루비 온 레일즈 2.3 릴리스 노트: 레일즈 2.3의 릴리스 노트입니다.
Ruby on Rails 2.2 릴리스 노트: 레일즈 2.2의 릴리스 노트입니다.

피드백

이 가이드의 품질을 개선하는 데 도움을 주시기를 권장합니다.

오타나 사실적인 오류를 발견하면 기여해주십시오. 시작하려면 문서 기여 섹션을 읽어보세요.

불완전한 내용이나 최신 정보가 아닌 내용을 발견할 수도 있습니다. 주요한 부분에 누락된 문서를 추가해주세요. Edge 가이드에서 이미 문제가 해결되었는지 확인하세요. 스타일과 규칙은 Ruby on Rails 가이드 지침을 확인하세요.

수정할 내용을 발견했지만 직접 수정할 수 없는 경우 이슈를 열어주세요.

마지막으로, Ruby on Rails 문서에 관한 모든 토론은 공식 Ruby on Rails 포럼에서 환영합니다.

Ruby on Rails 가이드 (ae44dcb)