はじめに

Railsでコードを書いていて、ControllerやhelperでURLのクエリ文字列を組み立てる場面ってありますよね。
こうゆうとき、僕は今まで

query = { hoge: 1, fuga: 2 }
query.map{ |k,v| "#{k}=#{v}" }.join("&")

とかやってたんですけど、これだと値が配列の場合に対応してないんですよね。。。
で、もっといいやり方ないかなって探してみたら見つけたので紹介します。

Hash#to_query

Hash#to_queryはActiveSupportのHash拡張で、レシーバーのHashインスタンスから、クエリ文字列を組み立てて返してくれます。
Hash#to_paramも同様の挙動です。より正確に言うと、Hash#to_queryがHash#to_paramのエイリアスです。

実行例

require 'active_support/core_ext'

{ hoge: 1, fuga: 2 }.to_query
# => "fuga=2&hoge=1"
# 何気にアルファベット順になっているのもポイント。

{ hoge: [0,1], fuga: { piyo: 2 } }.to_query
# => "fuga%5Bpiyo%5D=2&hoge%5B%5D=0&hoge%5B%5D=1"
# 配列や入れ子のハッシュにも対応。エスケープもしてくれる。

{ id: 1, name: "hoge" }.to_query("user")
# => "user%5Bid%5D=1&user%5Bname%5D=hoge"
# 引数に文字列（Symbolでも可）を渡すと、名前空間付きになる。