Guides.rubyonrails.org

1 コマンド ラインの基本

Rails を毎日使用する上で絶対に欠かせないコマンドがいくつかあります。

• rails console
• rails server
• rake
• rails generate
• rails dbconsole
• rails new app_name

これらのコマンドを順番に見ていき、単純なRailsアプリケーションを作ってみましょう。

1.1 rails new

最初に行うことは、Railsのインストール後にrails newコマンドを実行して新しいRailsアプリケーションを作成することです。

$ rails new commandsapp create create README.rdoc create .gitignore create Rakefile create config.ru create Gemfile create app ... create tmp/cache create tmp/pids create vendor/plugins create vendor/plugins/.gitkeep

Rails は、この小さなコマンドのために膨大な量のものをセットアップしてくれます!

1.2 rails server

railsサーバーコマンドは、RubyにバンドルされているWEBrickという小さなWebサーバーを起動します。 Web ブラウザからアプリケーションにアクセスするときはいつでもこれを使用します。

これ以上何もしなくても、rails server は新しいピカピカの Rails アプリを実行します:

わずか 3 つのコマンドで、ポート 3000 でリッスンする Rails サーバーを作成しました。 ブラウザでhttp://localhost:3000を開くと、基本的なRailsアプリが動作しているのがわかると思います。 デフォルトの開発環境は -e で変更できます。

$ rails server -e production -p 4000

-bオプションはRailsを指定したipにバインドします。 -dオプションを渡すと、サーバをデーモンとして実行できます。 rails generate を単独で実行すると、利用可能なジェネレータのリストが表示されます。

また、ジェネレータコマンドを呼び出すために “g” という別名を使用することもできます: rails g.

ジェネレーターを使用すると、ボイラープレート コード、つまりアプリが動作するために必要なコードを書くことによって、大量の時間を節約できます。

コントローラー ジェネレーターを使用して独自のコントローラーを作ってみましょう。 しかし、どのようなコマンドを使用すればよいのでしょうか。 ジェネレーターに尋ねてみましょう:

The controller generator is expecting parameters in the form of generate controller ControllerName action1 action2.The controller generator is expecting parameters in the form of generate controller ControllerName action1 action2.The controller generator is expecting parameters in the form of generate controller controllerName action1 action2. hello というアクションを持つ Greetings コントローラを作成しましょう。 たくさんのディレクトリがアプリケーションにあることを確認し、コントローラー ファイル、ビュー ファイル、機能テスト ファイル、ビュー用ヘルパー、JavaScript ファイル、およびスタイルシート ファイルを作成しました。rb):

class GreetingsController < ApplicationController def hello @message = "Hello, how are you today?" endend

次に、メッセージを表示するビュー (app/views/greetings/hello.html.erb):

<h1>A Greeting for You!</h1><p><%= @message %></p>

rails server を使用して、サーバーを立ち上げます。

$ rails server=> Booting WEBrick...

URL は http://localhost:3000/greetings/hello.

Rails にはデータモデル用のジェネレータも付属しています。

ただし、モデルを直接生成するのではなく (これは後で行います)、足場をセットアップしてみましょう。 Rails における scaffold とは、モデル、そのモデルのためのデータベース マイグレーション、それを操作するコントローラ、データを表示および操作するビュー、および上記のそれぞれに対するテスト スイートの完全なセットです。

ここでは、プレイするビデオ ゲームの最高得点を記録する「HighScore」という単純なリソースを設定することにしましょう。

ジェネレーターは、モデル、コントローラー、ヘルパー、レイアウト、機能テストおよびユニット テスト、スタイルシートのディレクトリが存在することを確認し、ビュー、コントローラー、モデルおよび HighScore のデータベース移行 (high_scores テーブルとフィールドの作成) を行い、リソース用のルートとすべての新しいテストの世話をします。

マイグレーションでは、データベースのスキーマを変更するために、マイグレーション、つまり、いくつかの Ruby コード (あの 20100209025147_create_high_scores.rb に住んでいる) を実行することが要求されます。 どのデータベース？ rake db:migrateコマンドを実行すると、Railsが作成してくれるsqlite3データベースです。 Rakeについてもう少し詳しく説明します。

Railsが作ってくれたインターフェースを見てみましょう。

$ rails server

ブラウザでhttp://localhost:3000/high_scoreを開き、新しいハイスコア (スペースインベーダーで 55,160!) を作れるようになりました。

1.4 rails console

consoleコマンドによってRailsアプリケーションとコマンドラインから対話することができます。 裏を返せば、rails consoleはIRBを使用しているので、IRBを使ったことがある人ならすぐに馴染めるでしょう。 これは、コードを使った素早いアイデアのテストや、Web サイトに触れることなくサーバーサイドでデータを変更するのに便利です。

また、エイリアス “c” を使って、rails c.

もし、データを変更せずにコードをテストしたい場合は、rails console –sandbox でそれを実行することができます。

$ rails console --sandboxLoading development environment in sandbox (Rails 3.1.0)Any modifications you make will be rolled back on exitirb(main):001:0>

1.5 rails dbconsole

rails dbconsole は使用しているデータベースを特定し、そのデータベースで使用するコマンドラインインターフェースに移動します (そしてコマンドラインに与えるパラメータも特定します!)。 MySQL, PostgreSQL, SQLite, SQLite3 をサポートしています。

また、dbconsole を呼び出すために “db” というエイリアスを使うこともできます: rails db.

1.6 rails plugin

rails plugin コマンドはプラグイン管理を簡略化するものです。 プラグインは名前またはそのリポジトリURLでインストールできます。 Gitリポジトリからプラグインをインストールする場合は、Gitがインストールされている必要があります。 Subversion も同様です。

$ rails plugin install https://github.com/technoweenie/acts_as_paranoid.git+ ./CHANGELOG+ ./MIT-LICENSE......

1.7 rails runner

runner は Rails のコンテキストで非インタラクティブに Ruby コードを実行します。 例えば:

$ rails runner "Model.long_running_method"

また、runnerを呼び出すために「r」というエイリアスを使用することができます: rails r.

ランナーコマンドが動作する環境は、-eスイッチを使って指定することができます.

$ rails runner -e staging "Model.long_running_method"

1.8 rails destroy

破壊とは生成と反対のものと考えてみてください。 generate が何をしたかを把握し、それを元に戻します。

destroy コマンドを呼び出すためにエイリアス “d” を使うこともできます: rails d.

2 Rake

Rake は Ruby Make で、Unix ユーティリティ ‘make’ に代わるスタンドアロンの Ruby ユーティリティで、タスクリストを構築するのに ‘Rakefile’ と .rake ファイルを使用します。 Rails では、Rake は一般的な管理タスク、特に互いに連携した高度なタスクに使用されます。

rake –tasks と入力すると、現在のディレクトリに依存する Rake タスクの一覧を取得することができます。 各タスクには説明があり、必要なものを見つけるのに役立つはずです。

$ rake --tasks(in /home/foobar/commandsapp)rake db:abort_if_pending_migrations # Raises an error if there are pending migrationsrake db:charset # Retrieves the charset for the current environment's databaserake db:collation # Retrieves the collation for the current environment's databaserake db:create # Create the database defined in config/database.yml for the current Rails.env......rake tmp:pids:clear # Clears all files in tmp/pidsrake tmp:sessions:clear # Clears all files in tmp/sessionsrake tmp:sockets:clear # Clears all files in tmp/sockets

2.1 about

rake about は Ruby, RubyGems, Rails, Rails サブコンポーネント、アプリケーションのフォルダ、現在の Rails 環境名、アプリケーションのデータベースアダプタ、スキーマバージョンのバージョンについての情報を提供します。 ヘルプを求めるとき、セキュリティパッチが影響するかどうか確認するとき、既存の Rails インストールについて統計情報が必要なときなどに便利です。

2.2 assets

rake資産:precompileを使って app/assets の資産をプリコンパイルし、rake assets:clean でこれらのコンパイル済み資産を除去できます。 rake db:version はトラブルシューティングの際に有用で、データベースの現在のバージョンを知らせます。

Migrations に関するより詳しい情報は、Migrations ガイドにあります。 ドキュメントを削除することもできます。これは主に、組み込みプラットフォーム用の Rails アプリケーションを書く場合など、コードベースをスリム化するのに役立ちます。

$ rake notes:custom ANNOTATION=BUG(in /home/foobar/commandsapp)app/model/post.rb: * Have to fix this one before pushing!