安裝 Rails 開發環境
Give someone a program, you frustrate them for a day; teach them how to program, you frustrate them for a lifetime. - David Leinweber
在這一章中,我們將介紹如何安裝Ruby on Rails的開發環境。開發Rails的環境需要:
- Ruby 2.2.2以上版本或JRuby,本書使用2.4.0。
- 資料庫系統,Rails預設使用SQLite可以作為新手開發練習之用,正式上線環境則推薦使用MySQL或PostgreSQL。
- Ruby on Rails,本書適用5.0+版本。
JRuby與Ruby最大的差異在於一些需要編譯的RubyGem套件:有些因為效能要求而用C語言撰寫的RubyGem在JRuby上不一定能夠安裝使用。所幸這些多半都有替代的套件可以使用,但不在本書介紹範圍。
以上差不多就是最基本的開發需求。如果需要部署到正式上線環境,則至少還需要一個專門的網站伺服器(Apache或Nginx等),我們會在佈署一章再詳細說明。接下來我們會根據不同作業系統來說明如何安裝Rails開發環境。
作業系統
Ruby可以運行在Windows、Linux、Mac OS X、BSD和Solaris上。雖然Rails可以在Windows上執行,但是有些套件只有支援Unix-like作業系統,以及Ruby程式在Unix-like系統上執行起來也比較快速及穩定。這是因為絕大多數的Ruby和Rails開發人員都是使用Mac和Linux系統。
Unix-like泛指各種傳統的Unix系統,比如FreeBSD、OpenBSD、Solaris,以及各種與Unix類似的系統,例如Linux、Mac OS X等等。有的是自由軟體,有的是商業軟體,但都相當程度地保留了原始Unix系統的特性,以及有許多相似之處。
因此,Rails的正式上線環境中都會強烈建議使用Unix-like作業系統。作為開發人員,擁有良好使用者介面、底層又與Unix類似的Mac作業系統就變成了首選的開發平台,大部分的專業Ruby工作者,也都是使用Mac電腦。不過,使用Windows的朋友也別太擔心,本書的內容大致適用,入門學習應該沒問題。只是如果讀者的每日工作就是進行Web網站開發,那麼我會建議您考慮使用Mac OS系統或試試Ubuntu Desktop作業系統。和學習Ruby一樣,從 Windows轉換到頭來Mac也是非常有趣的事情,可以獲得不少樂趣。
這是使用開源軟體需要考慮的因素:開源軟體是靠社群維護的,因此較多人使用的主流平台(作業系統、資料庫等)就會支援較佳,而越少人用的平台就會地雷較多。
資料庫
Rails支援的資料庫包括SQLite3、MySQL、Postgres、IBM DB2、Oracle和SQL Server等。除了安裝資料庫軟體,我們也需要安裝搭配的Ruby函式庫(稱作Adapter或Driver)。作為新手的單機練習,使用SQLite就可以了,本章會先介紹SQLite的安裝方式。附錄則會介紹如何安裝MySQL和PostgreSQL。
開發環境
命令列視窗
有許多工作需要透過指令列介面CLI (Command Line Interface)完成,像是安裝套件、執行rails指令、執行測試等等。雖然有一些GUI圖型介面工具可以輔助,但是到頭來你會發現還是直接在指令列輸入最快最可靠,發生問題的時候也容易除錯。
Mac OS下要進入命令列視窗,請打開Go->Utilities中的Terminal,或是筆者推薦可以安裝iTerm2。Ubuntu Desktop下是Applications->Accessories下的Terminal。Windows則是「開始->附屬應用程式」中的「命令提示字元」。
Unix-like的指令和Windows的指令很多是不同的,以下是一些常用的指令:
用途 | Unix-like | Windows |
---|---|---|
移動所在目錄 | cd XXX | cd XXX |
移動到上一層目錄 | cd .. | cd .. |
顯示目前所在目錄 | pwd | cd |
顯示目前目錄的檔案 | ls | dir |
刪除檔案 | rm XXX | erase XXX |
刪除目錄 | rmdir XXX | rmdir XXX |
建立目錄 | mkdir XXX | mkdir XXX |
另外,在輸入檔名或目錄名時,可以按tab來自動完成。
不熟稔CLI的話,建議可以閱讀The designer’s guide to the OSX command prompt和The Command Line Crash Course進行惡補。
開發軟體
在開始寫點程式之前,讓我們先介紹一下有什麼推薦的編輯器。相較於靜態語言如C++、Java喜歡功能豐富的IDE(Integrated Development Environment)軟體,動態語言雖然也有一些IDE軟體,但是更多人比較偏好簡單的文字編輯器(Editor)加上命令列視窗就可以打遍天下。這是因為對表達能力強的動態語言來說,IDE提供的自動產生程式碼、編譯程式、複雜的瀏覽功能等等都不是這麼需要。
Editor文字編輯器
- Sublime Text (Windows、Linux、Mac平台)
- ATOM (Windows、Linux、Mac平台)
- Vim
IDE軟體
無論用什麼編輯器,請注意檔案的格式要儲存成UTF-8,無BOM(byte-order mark)表頭。
版本控制系統
版本控制系統可以保存所有的程式變更,記錄誰改變什麼、在什麼時候、因為什麼原因,是團隊開發不可或缺的協同工具。Ruby社群普遍使用Git這套分散式版本控制系統。雖然學習Rails不必要學會Git,但是因為Rails本身以及絕大部分的相關套件都是使用Git版本控制系統、並放在GitHub上。所以你最好還是安裝有Git並學會基本的操作。關於Git的介紹請參考附錄。
安裝Ruby及資料庫
以下是分別在Mac OSX、Ubuntu Desktop作業系統上,安裝Ruby最快速方便的方式。在上手Rails的開發之後,可以再參考附錄,依需求安裝不同開發環境。
Mac OS X
我們使用Homebrew這套工具來管理MacOS上的套件,這可以方便安裝一些常用的工具軟體,例如Git、MySQL,甚至是Memcached、Elasticsearch、Redis、MongoDB等等都可以透過Homebrew安裝。本書的Mac安裝步驟中會使用到Homebrew,它的安裝步驟是執行:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
過程中會跳出一個視窗詢問是否安裝XCode的命令列開發者工具(Command Line Tools),請選擇安裝。如果沒有的話,請手動執行 xcode-select --install
這個指令。
完成後回到命令列繼續Homebrew的安裝。
Mac OS雖然內建了Ruby,卻是比較舊的版本,這裡我們透過Homebrew安裝最新版的Ruby:
$ brew install ruby
完成之後輸入以下指令可以看到安裝的版本:
$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-darwin16]
Windows
請至RubyInstaller下載Ruby安裝包,如果Windows是64位元則下載(x64)的版本。安裝過程中請點選將Ruby加入可執行的路徑(Add Ruby executables to your PATH)。
我們開發用的SQLite3資料庫函式庫在Windows上不支援Ruby 2.2的版本,請下載2.1的版本。(2015-06-09 的實驗結果,後來有沒有支援不清楚)
安裝成功之後,打開「附屬應用程式」的「命令提示字元」,輸入以下指令可以看到安裝的版本:
$ ruby -v
ruby 2.1.5p273 (2014-11-13 revision 48405) [x64-mingw32]
另外,有一些RubyGems套件會需要編譯動作,所以還需要Development Kit。請下載DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe 或64位元的DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe,解壓縮放在C:\DevKit下,接著在「命令提示字元」中進入這個目錄,輸入以下指令:
$ cd C:\DevKit
$ ruby dk.rb init
$ ruby dk.rb install
另一種在Windows開發的方式則是使用虛擬機器(Virtual Machine),例如用VirtualBox來跑Ubuntu Desktop Edition,或是使用Cygwin來提供Unix-like環境。如此就可以避開Windows上的種種地雷。
RubyGems簡介
RubyGems是Ruby的套件管理系統,讓你輕易安裝及管理Ruby函式庫。你可以在RubyGems上找到所有的Ruby開源套件。另外,讀者如果想找Ruby或Rails有哪些好用的套件,也可以瀏覽看看The Ruby Toolbox,這個站依照套件的熱門程度排序,非常方便。
常用指令
gem -v 告訴你 RubyGems 的版本
gem update --system 升級RubyGems的版本
gem install gem_name 安裝某個套件
gem list 列出安裝的套件
gem update gem_name 更新最新版本
gem update 更新所有你安裝的Gems
gem install -v x.x.x gemname 安裝特定版本
gem uninstall gem_name 反安裝
執行
gem install gem_name
的時候,它會在安裝完之後,自動產生此套件的RDoc和ri文件。不過有鑑於目前網路發達,往往直接 Google或是在套件官網就可以查詢到文件,所以其實不太需要在本地端機器產生文件,況且安裝的時間耗時又佔硬碟空間。要省略這個步驟,有兩種方式:
每次安裝時,加上以下參數:
$ gem install gem_name --no-ri --no-rdoc
或是新增一個~/.gemrc
檔案內容如下,預設就不產生文件:
gem: --no-ri --no-rdoc
安裝Ruby on Rails
$ gem install rails --no-ri --no-rdoc
為了節省安裝時間可不安裝文件檔,這裡加上--no-ri
跟--no-rdoc
參數。安裝完成之後,輸入rails -v
你應該會看到Rails 5.1.0。
使用者Windows的朋友可能需要手動安裝,請參考 INSTALLING USING UPDATE PACKAGES
中國大陸地區的朋友如果碰到網路連線問題(你懂的),請改使用RubyGems鏡像- Ruby China。