はてなブックマーク

詳細 利用可能な全てのオプションと使用方法の詳細については、Gemfileのマニュアルを参照してください。 Gemfile GemfileはRubyGemサーバのURLとして、少なくとも1つのGem供給元(source)を必要とします。 bundle initを実行することで、デフォルトでrubygems.orgをsourceとしたGemfileを作成します。 可能であれば、httpsを使用してrubygems.orgサーバーへの接続をSSLによって証明されたものにしてください。 source 'https://rubygems.org' Bundler 1.7では推奨されませんが、複数のグローバルなsource行を追加することが可能です。 それらが最初から最後まで検索されることになります。 一部のGemのsource(供給元)は、ユーザー名とパスワードを必要とします。 bundle co

グループの使用 依存性をグループ化する事で、グループ全体でオペレーションが実行出来るようになります。 # これらのGemは:defaultグループになります。 gem 'nokogiri' gem 'sinatra' gem 'wirble', :group => :development group :test do gem 'faker' gem 'rspec' end group :test, :development do gem 'capybara' gem 'rspec-rails' end gem 'cucumber', :group => [:cucumber, :test] リストで指定されたグループのGemを除いた、全てのGemをインストールします。 除外されないグループのいずれか1つに属しているGemであれば、そのGemはインストールされます。 $ bundle in

現在のbundleのコンテキストで、スクリプトを実行します。 文法 bundle exec [--keep-file-descriptors] command 説明 このコマンドは、Rubyプログラムで必要とされるGemfile(5)内で指定されている全てのGemを利用可能にして、 そのコマンドを実行します。 基本的に、もしrspec spec/my_spec.rbのように何らかのコマンドを実行し、 Gemfile(5)内のGemを使用して、 bundle install(1)を通してインストールしたいのであれば、 bundle exec rspec spec/my_spec.rbとして実行するべきです。 bundle execは、シェルの$PATH上で利用可能な実行ファイルを必要としないことに注意して下さい。 オプション --keep-file-descriptors Ruby 2.0で

2.2 スキーマの規約 Activeレコードは、DBテーブルのカラムのために、カラム用の命名規則を使用します。 外部キー これらのフィールド名は、(単数形テーブル名)_idと命名すべきです。(例: item_id、order_id) このフィールドは、モデルで関連性を作成した際にActiveレコードを探す対象になります。 主キー デフォルトでActiveレコードはidと名付けられた数値型のカラムをテーブルの主キーとして使用します。 Railsのマイグレーションを使用してテーブルを作成した場合、このカラムは自動的に生成されます。 また、Activeレコードインスタンスに、追加機能を作成するカラム名も存在します。 created_at レコードが初めて作成される際に、自動的に現在の日時を取得して登録します。 updated_at レコードが更新される度に、自動的に現在の日時を取得して登録・更新

Rubyプログラムのための、Gemの依存性を記述するフォーマットです。 概要 文法 グローバルな供給元 (#source) Ruby (#ruby) Gem (#gem) source、git、path、group、platformsのブロック gemspec (#gemspec) sourceの優先度 概要 Gemfileには、Rubyコードを実行するために必要なGemの依存関係が記述されます。 Gemfileは、コードが含まれるディレクトリのルートに配置して下さい。 例えば、Railsアプリケーションであれば、Rakefileと同じディレクトリに配置して下さい。 文法 多くのメソッドが必要なGemを記述する際に、それを利用可能にするためのコンテキストの中で、 GemfileはRubyコードとして評価されます。 グローバルな供給元 (#source) Gemfileの先頭で、Gemfil

このサイトについて rbenvの日本語リファレンスです。 rbenvの本家サイト(英文) の内容を翻訳して作成していますが、誤訳や誤記があると思いますのでその点についてはご了承ください。 もし、誤訳などの間違いを見つけましたら、 @tomof まで教えていただければ幸いです。 rbenvを使用して、アプリケーションのRuby環境を整えましょう rbenvは、Rubyのバージョンを選択し、開発(development)環境を製品(production)環境にマッチしていることを保証するために使用します。 rbenvはBundlerによるデプロイ環境を、 Rubyのアップグレードによって損うことなく動作します。 開発環境を強力に。 単一のファイル内に、アプリケーションのRubyのバージョンを指定します。 同じチームの仲間全員で、それを共有してください。 Rubyの異なるバージョン上で、アプリケ

Gemfile内で指定された依存性のインストールを行います。 文法 説明 オプション デプロイ(--deployment)モード sudoの取り扱い インストールグループ 記憶されるオプション Gemfile.lock 保守的な更新 参照 文法 bundle install [--gemfile=GEMFILE] [--path PATH] [--system] [--without=GROUP1[ GROUP2...]] [--local] [--deployment] [--binstubs[=DIRECTORY]] [--standalone[=GROUP1[ GROUP2...]]] [--trust-policy=POLICY] [--jobs=SIZE] [--retry=TRIES] [--no-cache] [--quiet] [--clean] [--full-index

Ruby on Rails(Rails2.2から)に含まれるRuby I18n(internationalization(国際化)の略記)のgemは、 アプリケーション内で英語以外の特定の言語への変換、または複数の言語サポートの提供を簡単に行えるようにし、フレームワークを拡張してくれます。 "internationalization"(国際化)のプロセスは、通常アプリケーションから全ての文字列と、 その他のロケール(地域)固有の単位(日付けや通貨のような)を抽象化することを意味します。 "localization"(地域化)のプロセスは、翻訳を提供し、これらの単位を地域用のフォーマットにすることを意味します。 1 そのため、アプリケーションでの国際化のプロセスでは、下記の事を行う必要があります。 i18nをサポートすることを確定します。 Railsにどこでロケール辞書を見つけるか教えます。

このガイドでは、Ruby on Railsアプリケーションをデバッグするためのテクニックを紹介します。 このガイドを読むことで、次の事が学べるはずです。 デバッグの目的 テストだけでは不十分なアプリケーションの問題と課題を探しだす方法 様々なデバッグ方法 スタックトレースを分析する方法 1. デバッグのためのビューヘルパー 2. Logger 3. デバッグ用のGemを使ったデバッグ 4. メモリーリークのデバッグ 5. デバッグのためのプラグイン 6. リファレンス 1. デバッグのためのビューヘルパー デバッグ全般に共通する事の1つに変数の中身を調べることがあります。 Railsでは、下記の3つのメソッドによってそれを行います。 debug to_yaml inspect 1.1 debug debugヘルパーは、YAMLフォーマットを使ったオブジェクトを描画した<pre>タグを返しま

マイグレーションは、時間を掛けてデータベーススキームを徐々に発展させていくActiveレコードの機能です。 純粋なSQLでスキーマの編集をするより、マイグレーションはRubyのDSL(ドメイン特化言語)にテーブルへの変更を書くことで 簡単にそれを行えるようにしてくれます。 このガイドを読むことで、次の事が学べるはずです。 ジェネレーターを使用して、マイグレーションファイルを作成する方法 Activeレコードが提供するメソッドで、データベースを操作する方法 Rakeタスクでマイグレーションとスキーマを操作する方法 マイグレーションがschema.rbと、どのように関連しているか 1. マイグレーションの概要 2. マイグレーションの作成 3. マイグレーションの編集 4. マイグレーションの実行 5. 既に存在するマイグレーションの変更 6. マイグレーションでのモデルの使用 7. スキーマ

このガイドでは、Activeレコードの関連付けについて説明します。 このガイドを読むことで、次の事が学べるはずです。 Activeレコードのモデル間で関連付けを定義する方法 Activeレコードの関連付けの様々なタイプについて 関連付けを作ることによってモデルに追加されるメソッドの使用方法 1. 何故、関連付けを行うのか? 2. 関連付けのタイプ 3. チップス、テクニック、注意点 4. 関連付けレファレンスの詳細 1. 何故、関連付けを行うのか? 何故、モデル間で関連付けを行う必要があるのでしょうか？ それは、コード内での共通のオペレーションをシンプルに、また簡単にするためです。 例えば、顧客(customers)と注文(orders)のモデルを持つシンプルなRailsアプリケーションがあるとします。 それぞれの顧客は多くの注文を持ちます。 関連付けが無ければ、モデルの定義は次のようにな

このガイドでは、アプリケーションのためのRails組み込みテストについて説明します。 このガイドを読むことで、次の事が学べるはずです。 Railsでのテストの専門用語 アプリケーションのユニット、機能、統合テストの書き方について 他の一般的なテスト手法やプラグイン 1. 何故テストを書くのか? 2. テストの導入について 3. モデルのユニットテスト 4. コントローラーの機能テスト 5. 統合テスト 6. Rakeによるテスト実行 7. MiniTestについての簡単な注意 8. setupとteardown 9. Routesのテスト 10. メーラーのテスト 11. Helperのテスト 12. その他のテスト手法 1. 何故テストを書くのか? Railsは、テストを書くことを非常に簡単にしてくれます。 モデルとコントローラー作成の際に生成されたスケルトンを使って始めてみましょう。

このガイドでは、メールの送受信の機能をアプリケーションに実装するための方法と、 Action Mailerの内部構造について説明していきます。 また、開発者のメールを使用したテストについても説明します。 このガイドを読むことで、次の事が学べるはずです。 Railsアプリケーションでメールを送受信する方法 Action Mailerクラスとメールビューの生成と編集の方法 Action Mailerの環境設定方法 Action Mailerクラスのテスト方法 1. はじめに 2. メール送信 3. メール受信 4. Action Mailerコールバック 5. Action Mailerヘルパーの使用 6. Action Mailerの設定 7. メールのテスト 8. メールの傍受(?) 1. はじめに Action Mailerは、Mailerクラスとビューを使用してアプリケーションからメー

このガイドでは、RackとRailsの統合と、その他のRackコンポーネントとのインターフェースについて説明します。 このガイドを読むことで、次の事が学べるはずです。 メタル(頑丈な?)・Railsアプリケーションの作り方について RailsアプリケーションでのRackミドルウェアの使用方法について Action Packの内部ミドルウェアスタックについて カスタムミドルウェアスタックの定義方法について 1. Rackの紹介 2. Rails on Rack 3. Acton Dispatcher ミドルウェアスタック 4. リソース 1. Rackの紹介 Rackは、最小限のモジューラーと適合インターフェースを、RubyでのWebアプリケーションの開発のために提供します。 HTTPリクエストとレスポンスを、可能な限りシンプルな方法でラッピングすることで、 Webサーバ、Webフレームワー

このガイドでは、簡単にリッチなAjaxアプリケーションの構築を可能にする、 Rails組み込みのAjax/JavaScriptの機能について説明します。 このガイドを読むことで、次の事が学べるはずです。 Ajaxの基本 控えめなJavaScript Railsの組み込みヘルパーはどのように手助けしてくれるのか。 サーバーサイド上でのAjaxの扱い方について ターボリンクス(Turbolinks)Gemについて 1. Ajax入門 2. 控えめなJavaScript 3. 組み込みヘルパー 4. サーバーサイドに関する事について 5. Turbolinks 6. その他のリソースについて 1. Ajax入門 Ajaxを理解するには、始めにWebブラウザが通常何を行っているのかを知らなければいけません。 http://localhost:3000と、ブラウザのアドレスバーに打ち込んでEnter

このガイドでは、Railsアプリケーションの設定と利用可能な機能の初期化について説明します。 このガイドを読むことで、次の事が学べるはずです。 Railsアプリケーションの動作を適合させる方法 アプリケーション開始時に追加コードを実行する方法 1. 初期化コードの置き場所 2. Railsの前にコードを実行する 3. Railsコンポーネントの構築 4. Rails環境の設定 5. 初期化ファイルの使用 6. イベントの初期化 7. データベースのプーリング 1. 初期化コードの置き場所 Railsは初期化コードの配置をするにあたり、標準で4つの場所を提供します。 config/application.rb 環境特有の設定ファイル Initializers Initializers後 2. Railsの前にコードを実行する 稀なケースですが、アプリケーションがRailsが読み込まれる前に幾

このガイドでは、Railsルーティング(経路)のユーザー向けの機能について説明します。 このガイドを読むことで、次の事が学べるはずです。 routes.rb内コードの解釈の仕方について resourceful(推奨)な、またはmatchメソッドを使用した独自のルーティングの組み立て方について 何のパラメータをアクションが受け取る事を期待するのか routeヘルパーを使用したパスとURLの自動生成の方法について 制約やRackエンドポイントのような高度なテクニックについて 1. Railsルーターの目的 2. Resourceルーティング: Railsデフォルト 3. 非Resourcefulルート 4. Resourcefulルートのカスタマイズ 5. ルートの検証とテスト 1. Railsルーターの目的 RailsルーターはURLを解析し、それぞれをコントローラーのアクションに遷移させま

Ruby STUDIO Rails 4 Railsガイド Rails入門 Rails入門(Rails 3) Activeレコードの基本 DBマイグレーション Activeレコードの検証 Activeレコードのコールバック Activeレコードの関連付け Activeレコードのクエリーインターフェース Railsによるレイアウトと描画 フォームヘルパー Actionコントローラーの概要 Railsのルーティング Acitiveサポートの拡張 Railsの多言語対応 Action Mailerの基本 Railsのテスト Railsのセキュリティ Railsのデバッグ Railsの設定 Railsのコマンドライン アセットパイプライン RailsでのjavaScriptについて Rack上のRails Railsガイド Rails入門 Rails入門(Rails 3) Activeレコードの基本

このガイドでは、アセットパイプラインについて説明します。 このガイドを読むことで、次の事が学べるはずです。 アセットパイプラインとは何か、何が出来るのか アプリケーションのアセットの適切な構成について アセットパイプラインを使用するメリット パイプラインにプリプロセッサを追加する方法 アセットをgemパッケージにする方法 1. アセットパイプラインとは? 2. アセットパイプラインの使用方法 3. 開発環境での使用 4. 本環境での使用 5. パイプラインのカスタマイズ 6. アセットのキャッシュストア 7. Gemにアセットを追加する方法 8. ライブラリまたはGemのプリプロセッサの作成 9. 古いバージョンのRailsからのアップグレード 1. アセットパイプラインとは? アセットパイプラインは、javaScriptとCSSの連結・圧縮をフレームワークとつなぎ合わせる機能を提供します

Webアプリケーション内のフォームは、ユーザー入力にとって欠かせないインターフェースです。 ただし、フォームのマークアップ構築とメンテナンスは、フォームのコントローラー名とそれらの多すぎる属性のため、 すぐに冗長になりがちです。 Railsはこれらの複雑さを、ビューヘルパーのためのフォームのマークアップ生成を提供することで回避します。 ただし、それらは異なるユースケースを持つため、 これらを使用する前に開発者はこの同じようなヘルパーメソッドについての全ての違いを知っていおく必要があります。 このガイドを読むことで、次の事が学べるはずです。 アプリケーション内に、検索フォームとそれに類似した一般的なフォームを、特定のモデルを表さずに作成する方法について。 特定のデータベースレコードの作成と編集のためのモデルが中心となるフォームの作成方法について。 複数タイプのデータから、セレクトボックスの作

Active Supportは、Ruby言語拡張、ユーティリティ、その他横断的に関わりがあるものの提供を請け負うRuby on Railsのコンポーネントです。 これは、Railsアプリケーションの開発者とRuby on Rails自体の開発者の両方に対して、言語レベルで基板部分をより豊かにしてくれます。 このガイドを読むことで、次の事が学べるはずです。 Core拡張とは何か どのようにして全ての拡張を読み込むのか 必要とする拡張だけをcherry-pick(狙ったものだけを取得)する方法 Active Supportが提供する拡張とは何か 1. Core拡張の読み込み方法 2. 全てのObjectの拡張 3. Moduleの拡張 4. Classの拡張 5. Stringの拡張 6. Numericの拡張 7. Integerの拡張 8. BigDecimalの拡張 9. Enumera

このマニュアルでは、Webアプリケーションの一般的なセキュリティ問題と、それをRailsで回避するための方法について説明していきます。 以下の事について学んでいきましょう。 セキュリティの主要な対策について Railsのセッションの取り扱いと、よくある攻撃方法について サイトにアクセスするだけで、セキュリティ問題になる可能性(CSRF)について ファイルを取り扱う場合、管理画面を提供する場合などに注意を払うべき事柄について ログイン・ログアウトのユーザー管理方法とその攻撃方法について 攻撃者が最も好むインジェクション攻撃の方法について 1. はじめに 2. セッション 3. クロスサイト・リクエスト・フォージェリ(CSRF) 4. リダイレクトとファイル 5. イントラネットと管理者のセキュリティ 6. ユーザー管理 7. インジェクション 8. デフォルトヘッダー 9. セキュアな環境

このサイトについて Railsの情報を翻訳しています。 現在は、Ruby on Rails GuidesのGuide Index内の内容を翻訳したものを、 こちらで公開していますが、誤訳や誤記があると思いますのでその点についてはご了承ください。 もし、誤訳などの間違いを見つけましたら、 @tomof まで教えていただければ幸いです。 Back to top

Ruby on Rails Guidesの内容を翻訳して作成したガイドです。 誤訳や誤記があると思いますのでその点についてはご了承ください。 もし、誤訳などの間違いを見つけましたら、 @tomof まで教えていただければ幸いです。 訳注:Rails4の「Getting Start」からは、scaffold(スキャフォールド)の説明がとり除かれたようです。 これは、おそらくscaffoldを使用することで、かえって初心者の理解を妨げる要因になると考えられてのことだと思われます。 scaffoldの事が知りたければ、Rails入門(Rails 3)を参照してください。 Railsの入門ガイドです。 このガイドを読むことで、次の事が学べるはずです。 Railsのインストールし、Railsアプリケーションのプロジェクト生成、データベース接続 Railsアプリケーションの一般的なレイアウトについて