創建 Rails 項目
創建一個普通的 Rails 項目，可以直接使用以下命令:
|
1
|
rails new blog |
但在國內因為連接 RubyGems 的速度太慢，而 Rails 默認在構建完項目結構后，會使用 bundle 命令從 RubyGems 下載安裝依賴包。最后會因為網絡問題而卡死。所以需要使用 --skip-bundle 參數跳過執行 bundle 這一步。然后使用國內的 Gems 鏡像源來完成后面依賴包的安裝。國內推薦的源是 Ruby China 提供的: https://gems.ruby-china.org/。
最后整理步驟如下：
創建項目:
|
1
|
rails new blog --skip-bundle |
修改項目目錄中的 Gemfile 文件，修改第一行中 source 后面引號中的內容值為：https://gems.ruby-china.org/
最后在項目目錄中執行: bundle install 完成安裝依賴包。
至此，一個標準的 Rails 項目骨架創建完成。
配置 Rails 項目
默認情況下，已經可以使用生成好的項目骨架來開始開發項目，但根據實際需求，還是需要對一些配置進行調整。比如時區，或使用 MySQL 等。
設置時區
默認 Rails 使用的是 UTC 時區，如果項目只是在國內使用，這會導致數據跟時間相關的值都會比國內的時間晚 8 個小時。所以如果非國際性項目，可以把時區固定到國內。
打開項目目錄中 config/application.rb 文件。去掉 config.time_zone 配置項前的注釋，然后修改配置項的值為 Beijing，最后添加一行新的配置:
|
1
|
config.active_record.default_timezone = :local |
使用 MySQL
默認 Rails 使用的是 sqlite 數據庫，如果要使用 MySQL，還需要安裝 MySQL 的程序包。并修改數據庫默認配置。
打開項目目錄中的 Gemfile 文件，添加一個全局的依賴包 mysql2，格式如下:
|
1
|
gem 'mysql2' |
然后執行: bundle install 安裝依賴包。
接下來打開 config/database.yml 文件，修改 development 區塊的配置如下格式:
|
1
2
3
4
5
6
|
development: adapter: mysql2 database: blog username: root password: host: 127.0.0.1 |
創建 Rails 文檔
對于已經熟練掌握了 Rails 的老手來說，這一步并不是必須的。但對于像我這樣的新手，經常會需要去翻翻手冊來尋求幫助，把文檔搬到本地，省去了在沒有網絡或網速太慢時的煩惱。Rails 提供了命令，可以在項目中生成 Rails 的本地手冊和 API 文檔。
首先需要添加一個依賴包: redcarpet。打開項目中的 Gemfile 文件，因為只是在本地環境下使用，所以不用加入到全局依賴，找到文件底部的 development 配置塊，添加到這里就行了，格式如下:
|
1
|
gem 'redcarpet', '~> 3.1.2' |
然后執行: bundle install 安裝包。
使用如下命令生成 Rails 幫助文檔和 API 文檔:
|
1
2
|
rake doc:guidesrake doc:rails |
命令完成后，文檔會生成到 doc 目錄。
在 Rails 中創建自定義命令
開發 Web 應用時，難免會遇到需要編寫在終端執行的命令腳本。比如說要從一個很大的文本中導入數據。在 Rails 中完成這個事情相當簡單，下面是一個示例。
首先是創建腳本文件。在 Rails 項目的 lib/tasks 目錄中創建一個 hello.rake 的文件。文件內容如下:
|
1
2
3
4
5
|
namespace :hello do task :world do puts "Hello, World!" endend |
這樣就完成了一個簡單的打招呼腳本，要運行這個腳本，需要使用 rake 命令:
|
1
|
rake hello:world |
默認情況下，腳本命令并沒有引入 Rails 的項目模塊。如果需要引入也很簡單！比如我想要和項目中的所有客戶打個招呼：
|
1
2
3
4
5
6
7
8
9
10
|
namespace :hello do # ... task :customers => :environment do for customer in Customer.all puts sprintf("hello, %s", customer.name) end endend |
如果你的項目中剛好有 Customer 模塊，而剛好又存在 name 字段，那就可以執行 rake hello:customers 來驗證效果了。對比第一個任務，這里添加了 => :environment 這段代碼，正是它實現了引入項目環境依賴的功能。是不是很簡單?
