Permalink
Browse files

Merge pull request #10747 from javan/patch-1

Add note about upgrading custom routes from `put` to `patch`.
  • Loading branch information...
2 parents 17a1132 + 03dbd8a commit 051228699d05b2781b298cfde02714a8f7a8bf46 @dhh dhh committed Jun 3, 2013
Showing with 18 additions and 0 deletions.
  1. +18 −0 guides/source/upgrading_ruby_on_rails.md
@@ -41,6 +41,24 @@ So, in Rails 4 both `PUT` and `PATCH` are routed to update. We recommend
switching to `PATCH` as part of your upgrade process if possible, as it's more
likely what you want.
+Note, when using `form_for` to update a resource in conjunction with a custom route,
+you'll need to update your route to explicity match the `patch` verb:
+
+```erb
+<%= form_for [ :update_name, @user ] do |f| %>
+ ...
+<% end %>
+```
+
+```ruby
+resources :users do
+ # Rails 3
+ put :update_name, on: :member
+ # Rails 4
+ patch :update_name, on: :member
+end
+```
+
For more on PATCH and why this change was made, see [this post](http://weblog.rubyonrails.org/2012/2/25/edge-rails-patch-is-the-new-primary-http-method-for-updates/)
on the Rails blog.

0 comments on commit 0512286

Please sign in to comment.