Ruby on Rails 5.1 릴리스 노트

1 Rails 5.1로 업그레이드하기

기존 애플리케이션을 업그레이드하는 경우, 업그레이드하기 전에 좋은 테스트 커버리지를 갖는 것이 좋습니다. 또한, Rails 5.1로 업데이트하기 전에 Rails 5.0으로 먼저 업그레이드하고 애플리케이션이 예상대로 작동하는지 확인하십시오. 업그레이드할 때 주의해야 할 사항은 Upgrading Ruby on Rails 가이드에서 확인할 수 있습니다.

2 주요 기능

2.1 Yarn 지원

Pull Request

Rails 5.1은 Yarn을 통해 npm에서 JavaScript 종속성을 관리할 수 있습니다. 이를 통해 React, VueJS 또는 다른 npm 라이브러리와 같은 라이브러리를 쉽게 사용할 수 있습니다. Yarn 지원은 자산 파이프라인과 통합되어 모든 종속성이 Rails 5.1 앱과 원활하게 작동합니다.

2.2 선택적 Webpack 지원

Pull Request

Rails 앱은 새로운 Webpacker 젬을 사용하여 JavaScript 자산 번들러인 Webpack과 더 쉽게 통합할 수 있습니다. Webpack 통합을 활성화하려면 새로운 애플리케이션을 생성할 때 --webpack 플래그를 사용하십시오.

이는 이미지, 글꼴, 소리 및 기타 자산에 대해 계속해서 사용할 수 있는 자산 파이프라인과 완전히 호환됩니다. 자산 파이프라인을 통해 일부 JavaScript 코드를 관리하고 다른 코드를 Webpack을 통해 처리할 수도 있습니다. 이 모든 것은 기본적으로 활성화된 Yarn에 의해 관리됩니다.

이전 버전의 Rails에서는 data-remote, data-confirm 및 기타 Rails의 Unobtrusive JavaScript 기능을 제공하기 위해 jQuery가 기본적으로 필요했습니다. 이제는 UJS가 일반적인 JavaScript를 사용하도록 다시 작성되어 jQuery가 필요하지 않습니다. 이 코드는 이제 Action View 내부에 rails-ujs로 제공됩니다.

필요한 경우에는 여전히 jQuery를 사용할 수 있지만, 기본적으로는 필요하지 않습니다.

2.4 시스템 테스트

Pull Request

Rails 5.1은 시스템 테스트라는 형태로 Capybara 테스트를 작성하는 데 내장된 지원을 제공합니다. 이제 Capybara 및 데이터베이스 클리닝 전략을 구성할 필요가 없습니다. Rails 5.1은 Chrome에서 테스트를 실행하기 위한 래퍼를 제공하며, 실패 스크린샷과 같은 추가 기능도 제공합니다.

2.5 암호화된 비밀

Pull Request

Rails는 이제 sekrets 젬에서 영감을 받아 애플리케이션 비밀을 안전하게 관리할 수 있게 되었습니다.

bin/rails secrets:setup을 실행하여 새로운 암호화된 비밀 파일을 설정할 수 있습니다. 이는 또한 저장소 외부에 저장되어야 하는 마스터 키를 생성합니다. 비밀 자체는 암호화된 형태로 리비전 컨트롤 시스템에 안전하게 체크인할 수 있습니다.

비밀은 프로덕션에서 RAILS_MASTER_KEY 환경 변수나 키 파일에 저장된 키를 사용하여 복호화됩니다.

2.6 매개변수화된 메일러

Pull Request

메일러 클래스의 모든 메소드에 사용되는 공통 매개변수를 지정하여 인스턴스 변수, 헤더 및 기타 공통 설정을 공유할 수 있도록 합니다.

class InvitationsMailer < ApplicationMailer
  before_action { @inviter, @invitee = params[:inviter], params[:invitee] }
  before_action { @account = params[:inviter].account }

  def account_invitation
    mail subject: "#{@inviter.name} invited you to their Basecamp (#{@account.name})"
  end
end

InvitationsMailer.with(inviter: person_a, invitee: person_b)
                 .account_invitation.deliver_later

2.7 직접 및 해결된 라우트

Pull Request

Rails 5.1은 라우팅 DSL에 resolve 및 direct라는 두 가지 새로운 메소드를 추가합니다. resolve 메소드는 모델의 다형성 매핑을 사용자 정의하는 데 사용됩니다.

resource :basket

resolve("Basket") { [:basket] }

<%= form_for @basket do |form| %>
  <!-- basket form -->
<% end %>

이렇게 하면 일반적인 /baskets/:id 대신 단수 URL /basket이 생성됩니다.

direct 메소드는 사용자 정의 URL 헬퍼를 생성할 수 있습니다.

direct(:homepage) { "https://rubyonrails.org" }

homepage_url # => "https://rubyonrails.org"

블록의 반환 값은 url_for 메소드에 대한 유효한 인수여야 합니다. 따라서 유효한 문자열 URL, 해시, 배열, Active Model 인스턴스 또는 Active Model 클래스를 전달할 수 있습니다.

direct :commentable do |model|
  [ model, anchor: model.dom_id ]
end

direct :main do
  { controller: 'pages', action: 'index', subdomain: 'www' }
end

2.8 form_for 및 form_tag의 통합 form_with

Pull Request

Rails 5.1 이전에는 HTML 폼을 처리하기 위해 두 가지 인터페이스가 있었습니다. 모델 인스턴스에 대한 form_for와 사용자 정의 URL에 대한 form_tag입니다.

Rails 5.1은 form_with를 사용하여 이러한 두 인터페이스를 결합하고 URL, 스코프 또는 모델을 기반으로 폼 태그를 생성할 수 있습니다.

URL만 사용하는 경우:

<%= form_with url: posts_path do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# 다음과 같이 생성됩니다. %>

<form action="/posts" method="post" data-remote="true">
  <input type="text" name="title">
</form>

스코프를 추가하면 입력 필드 이름에 접두사가 붙습니다:

<%= form_with scope: :post, url: posts_path do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# 다음과 같이 생성됩니다. %>

<form action="/posts" method="post" data-remote="true">
  <input type="text" name="post[title]">
</form>

모델을 사용하면 URL과 범위를 추론합니다:

<%= form_with model: Post.new do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# 다음을 생성합니다 %>

<form action="/posts" method="post" data-remote="true">
  <input type="text" name="post[title]">
</form>

기존 모델은 업데이트 폼을 만들고 필드 값을 채웁니다:

<%= form_with model: Post.first do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# 다음을 생성합니다 %>

<form action="/posts/1" method="post" data-remote="true">
  <input type="hidden" name="_method" value="patch">
  <input type="text" name="post[title]" value="<게시물 제목>">
</form>

3 호환성

다음 변경 사항은 업그레이드 시 즉시 조치가 필요할 수 있습니다.

3.1 여러 연결을 사용하는 트랜잭션 테스트

트랜잭션 테스트는 이제 모든 Active Record 연결을 데이터베이스 트랜잭션으로 래핑합니다.

테스트가 추가 스레드를 생성하고 해당 스레드가 데이터베이스 연결을 얻는 경우, 해당 연결은 이제 특별하게 처리됩니다:

스레드는 관리되는 트랜잭션 내부에 있는 단일 연결을 공유합니다. 이렇게 하면 모든 스레드가 동일한 상태의 데이터베이스를 볼 수 있으며, 가장 바깥쪽 트랜잭션을 무시합니다. 이전에는 이러한 추가 연결에서 픽스처 행을 볼 수 없었습니다.

스레드가 중첩 트랜잭션에 진입하면 격리를 유지하기 위해 일시적으로 연결의 독점적인 사용권을 얻습니다.

현재 테스트가 생성된 스레드에서 별도의 트랜잭션 외부 연결을 얻는 것에 의존하는 경우, 더 명시적인 연결 관리로 전환해야 합니다.

현재 테스트가 스레드를 생성하고 해당 스레드가 명시적인 데이터베이스 트랜잭션을 사용하면서 상호 작용하는 경우, 이 변경 사항은 교착 상태를 발생시킬 수 있습니다.

이 새로운 동작에서 제외되는 쉬운 방법은 해당 테스트 케이스에서 트랜잭션 테스트를 비활성화하는 것입니다.

4 Railties

자세한 변경 사항은 Changelog를 참조하십시오.

4.1 제거 사항

사용되지 않는 config.static_cache_control 제거. (commit)
사용되지 않는 config.serve_static_files 제거. (commit)
사용되지 않는 파일 rails/rack/debugger 제거. (commit)
사용되지 않는 작업 제거: rails:update, rails:template, rails:template:copy, rails:update:configs 및 rails:update:bin. (commit)
routes 작업을 위한 CONTROLLER 환경 변수 제거. (commit)
rails new 명령에서 -j (--javascript) 옵션 제거. (Pull Request)

4.2 주목할만한 변경 사항

모든 환경에서 로드되는 config/secrets.yml에 공유 섹션 추가. (commit)
config/secrets.yml 구성 파일은 이제 모든 키를 심볼로 로드합니다. (Pull Request)
기본 스택에서 jquery-rails 제거. Action View와 함께 제공되는 rails-ujs가 기본 UJS 어댑터로 포함됩니다. (Pull Request)
새로운 앱에서 yarn binstub과 package.json을 사용하여 Yarn 지원 추가. (Pull Request)
--webpack 옵션을 통해 새로운 앱에서 Webpack 지원을 추가하고 이를 rails/webpacker 젬에 위임합니다. (Pull Request)
새로운 앱을 생성할 때, --skip-git 옵션이 제공되지 않으면 Git 저장소를 초기화합니다. (Pull Request)
config/secrets.yml.enc에 암호화된 비밀을 추가합니다. (Pull Request)
rails initializers에서 railtie 클래스 이름을 표시합니다. (Pull Request)

5 Action Cable

자세한 변경 사항은 Changelog를 참조하십시오.

5.1 주목할만한 변경 사항

cable.yml에서 Redis 및 이벤트 기반 Redis 어댑터에 channel_prefix 지원을 추가하여 동일한 Redis 서버를 여러 애플리케이션에서 사용할 때 이름 충돌을 피합니다. (Pull Request)
데이터를 브로드캐스트하기 위한 ActiveSupport::Notifications 훅을 추가합니다. (Pull Request)

6 Action Pack

자세한 변경 사항은 Changelog를 참조하십시오.

6.1 제거된 사항

ActionDispatch::IntegrationTest 및 ActionController::TestCase 클래스의 #process, #get, #post, #patch, #put, #delete, #head에서 키워드가 아닌 인수를 지원하는 기능을 제거했습니다. (Commit, Commit)
ActionDispatch::Callbacks.to_prepare 및 ActionDispatch::Callbacks.to_cleanup를 제거했습니다. (Commit)
컨트롤러 필터와 관련된 메서드를 제거했습니다. (Commit)
render에서 :text 및 :nothing 지원을 제거했습니다. (Commit, Commit)
ActionController::Parameters에서 HashWithIndifferentAccess 메서드를 호출하는 기능을 제거했습니다. (Commit)

6.2 폐지 예정 사항

config.action_controller.raise_on_unfiltered_parameters를 폐지 예정으로 지정했습니다. Rails 5.1에서는 어떠한 효과도 없습니다. (Commit)

6.3 주목할만한 변경 사항

라우팅 DSL에 direct 및 resolve 메서드를 추가했습니다. (Pull Request)
응용 프로그램에서 시스템 테스트를 작성하기 위한 새로운 ActionDispatch::SystemTestCase 클래스를 추가했습니다. (Pull Request)

7 Action View

자세한 변경 사항은 Changelog를 참조하십시오.

7.1 제거된 사항

ActionView::Template::Error의 #original_exception을 제거했습니다. (commit)
strip_tags에서 encode_special_chars 옵션을 제거했습니다. (Pull Request)

7.2 폐지 예정 사항

Erubis ERB 핸들러를 Erubi로 대체하기 위해 Erubis ERB 핸들러를 폐지 예정으로 지정했습니다. (Pull Request)

7.3 주목할만한 변경 사항

Raw 템플릿 핸들러(기본 템플릿 핸들러)는 이제 HTML-safe 문자열을 출력합니다. (commit)
datetime_field 및 datetime_field_tag를 datetime-local 필드를 생성하도록 변경했습니다. (Pull Request)
HTML 태그에 대한 새로운 Builder 스타일 구문(tag.div, tag.br 등)을 추가했습니다. (Pull Request)
form_tag 및 form_for 사용법을 통합하기 위해 form_with를 추가했습니다. (Pull Request)
current_page?에 check_parameters 옵션을 추가했습니다. (Pull Request)

8 Action Mailer

자세한 변경 사항은 Changelog를 참조하십시오.

8.1 주목할만한 변경 사항

첨부 파일이 포함되고 본문이 인라인으로 설정된 경우 사용자 정의 콘텐츠 유형을 설정할 수 있도록 허용했습니다. (Pull Request)
default 메서드에 람다를 값으로 전달할 수 있도록 허용했습니다. (Commit)
매일러 액션 간에 공유하기 위해 메일러에 매개변수화된 호출 지원을 추가했습니다. (Commit)
메일러 액션에 대한 인자를 process.action_mailer 이벤트의 args 키 아래에 전달 인자로 전달했습니다. (Pull Request)

9 Active Record

자세한 변경 사항은 Changelog를 참조하십시오.

9.1 제거된 사항

ActiveRecord::QueryMethods#select에 인수와 블록을 동시에 전달하는 기능이 제거되었습니다. (커밋)
activerecord.errors.messages.restrict_dependent_destroy.one 및 activerecord.errors.messages.restrict_dependent_destroy.many i18n 스코프가 제거되었습니다. (커밋)
단수 및 컬렉션 관련 연관 리더에서 force-reload 인수가 제거되었습니다. (커밋)
#quote에 열을 전달하는 기능이 제거되었습니다. (커밋)
#tables에서 name 인수가 제거되었습니다. (커밋)
#tables 및 #table_exists?의 동작이 변경되어 테이블과 뷰를 반환하는 대신 테이블만 반환하도록 변경되었습니다. (커밋)
ActiveRecord::StatementInvalid#initialize 및 ActiveRecord::StatementInvalid#original_exception에서 original_exception 인수가 제거되었습니다. (커밋)
쿼리에서 클래스를 값으로 전달하는 기능이 제거되었습니다. (커밋)
LIMIT에서 쉼표를 사용하여 쿼리하는 기능이 제거되었습니다. (커밋)
#destroy_all에서 conditions 매개변수가 제거되었습니다. (커밋)
#delete_all에서 conditions 매개변수가 제거되었습니다. (커밋)
#load_schema_for 메서드가 #load_schema로 대체되었습니다. (커밋)
#raise_in_transactional_callbacks 구성이 제거되었습니다. (커밋)
#use_transactional_fixtures 구성이 제거되었습니다. (커밋)

9.2 폐지 사항

error_on_ignored_order_or_limit 플래그가 error_on_ignored_order로 대체되었습니다. (커밋)
sanitize_conditions가 sanitize_sql로 대체되었습니다. (풀 리퀘스트)
연결 어댑터에서 supports_migrations?가 폐지되었습니다. (풀 리퀘스트)
Migrator.schema_migrations_table_name이 SchemaMigration.table_name으로 대체되었습니다. (풀 리퀘스트)
인용 및 형 변환에 #quoted_id를 사용하는 것이 폐지되었습니다. (풀 리퀘스트)
#index_name_exists?에 default 인수를 전달하는 것이 폐지되었습니다. (풀 리퀘스트)

9.3 주목할만한 변경 사항

기본 기본 키를 BIGINT로 변경했습니다. (풀 리퀘스트)
MySQL 5.7.5+ 및 MariaDB 5.2.0+에서 가상/생성된 컬럼을 지원합니다. (커밋)
일괄 처리에서 제한을 지원하도록 추가되었습니다. (커밋)
트랜잭션 테스트는 이제 모든 Active Record 연결을 데이터베이스 트랜잭션으로 래핑합니다. (풀 리퀘스트)
mysqldump 명령어의 출력에서 주석을 기본적으로 건너뜁니다. (풀 리퀘스트)
ActiveRecord::Relation#count를 개선하여 레코드를 세는 데 블록이 전달되면 Ruby의 Enumerable#count를 사용하도록 변경되었습니다. (풀 리퀘스트)
SQL 오류를 억제하지 않기 위해 psql 명령에 "-v ON_ERROR_STOP=1" 플래그를 전달합니다. (풀 리퀘스트)
ActiveRecord::Base.connection_pool.stat을 추가했습니다. (풀 리퀘스트)
ActiveRecord::Migration에서 직접 상속하면 오류가 발생합니다. 마이그레이션이 작성된 Rails 버전을 지정하세요. (커밋)
through 연관이 모호한 반영 이름을 가지고 있을 때 오류가 발생합니다. (커밋)

10 Active Model

자세한 변경 사항은 변경 로그를 참조하세요.

10.1 제거 사항

ActiveModel::Errors에서 폐지된 메서드가 제거되었습니다. (커밋)
길이 유효성 검사기에서 :tokenizer 옵션이 폐지되었습니다. (커밋)
콜백의 반환 값이 false일 때 콜백을 중단하는 동작이 폐지되었습니다. (커밋)

10.2 주목할만한 변경 사항

모델 속성에 할당된 원래 문자열이 더 이상 잘못되게 동결되지 않습니다. (풀 리퀘스트)

11 액티브 잡

자세한 변경 사항은 Changelog를 참조하십시오.

11.1 삭제 사항

.queue_adapter에 어댑터 클래스를 전달하는 것에 대한 지원이 폐기되었습니다. (commit)
ActiveJob::DeserializationError에서 #original_exception이 폐기되었습니다. (commit)

11.2 주목할만한 변경 사항

ActiveJob::Base.retry_on 및 ActiveJob::Base.discard_on을 통해 선언적 예외 처리가 추가되었습니다. (Pull Request)
재시도가 실패한 후에 사용자 정의 로직에서 job.arguments와 같은 것에 액세스 할 수 있도록 작업 인스턴스를 제공합니다. (commit)

12 액티브 서포트

자세한 변경 사항은 Changelog를 참조하십시오.

12.1 삭제 사항

ActiveSupport::Concurrency::Latch 클래스가 제거되었습니다. (Commit)
halt_callback_chains_on_return_false가 제거되었습니다. (Commit)
반환 값이 false인 경우 콜백을 중단하는 폐기된 동작이 제거되었습니다. (Commit)

12.2 폐기 사항

최상위 HashWithIndifferentAccess 클래스가 ActiveSupport::HashWithIndifferentAccess를 선호하도록 약간 폐기되었습니다. (Pull Request)
set_callback 및 skip_callback의 :if 및 :unless 조건 옵션에 문자열을 전달하는 것이 폐기되었습니다. (Commit)

12.3 주목할만한 변경 사항

DST 변경을 통해 일관된 지속 시간 구문 분석 및 이동을 수정했습니다. (Commit, Pull Request)
Unicode를 버전 9.0.0으로 업데이트했습니다. (Pull Request)
#ago 및 #since에 대한 별칭으로 Duration#before 및 #after를 추가했습니다. (Pull Request)
현재 객체에 정의되지 않은 메소드 호출을 프록시 객체로 위임하기 위해 Module#delegate_missing_to를 추가했습니다. (Pull Request)
현재 날짜 및 시간의 전체 날짜를 나타내는 범위를 반환하는 Date#all_day를 추가했습니다. (Pull Request)
테스트를 위한 assert_changes 및 assert_no_changes 메소드를 도입했습니다. (Pull Request)
travel 및 travel_to 메소드는 이제 중첩 호출 시 예외를 발생시킵니다. (Pull Request)
DateTime#change를 usec 및 nsec를 지원하도록 업데이트했습니다. (Pull Request)

13 크레딧

Rails에 많은 시간을 투자한 많은 사람들을 위해 Rails 기여자 전체 목록을 참조하십시오. 모두에게 경의를 표합니다.

피드백

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

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

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

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

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

Chapters

피드백