Ruby: 入門指南

Ruby on Rails 入門指南

👋 歡迎來到 Stackhero 文檔！

Stackhero 提供一個即用型的 Ruby cloud 解決方案，帶來多項好處，包括：

只需一個簡單的 git push，即可在幾秒鐘內部署您的應用程式。

使用您自己的域名，並享受 HTTPS 證書的自動配置以增強安全性。

享受自動備份、一鍵更新，以及簡單、透明且可預測的定價，讓您安心無憂。

憑藉專用的私人 VM，獲得最佳的性能和強大的安全性。

節省時間並簡化您的生活：只需 5 分鐘即可嘗試 Stackhero 的 Ruby cloud hosting 解決方案！

歡迎來到 Ruby on Rails 的入門指南。在這份指南中，您將了解這個設計用來簡化和加速開發過程的熱門網頁應用框架之一。

Ruby on Rails（通常簡稱為 Rails）是一個以 Ruby 建構的伺服器端網頁應用框架。它遵循模型-視圖-控制器（MVC）架構模式，並採用約定優於配置（CoC）和不要重複自己（DRY）的原則。這些特性使 Rails 成為網頁開發中強大、高效且靈活的選擇。

以下，我們將引導您完成啟動新 Ruby on Rails 專案的基本步驟。您將學習如何安裝 Ruby 和 Rails，設置您的第一個專案，甚至建立一個簡單的 "Hello World" 應用程式。還提供了不同開發環境的額外指導，包括使用線上平台 Stackhero Code-Hero。

理解 Ruby 和 Rails 的區別

Ruby 是一種動態的開源程式語言，類似於 PHP、JavaScript 或 Python。它強調簡單性和生產力，具有易於閱讀和編寫的優雅語法。

Rails 是一個強大的伺服器端網頁應用框架，運行於 Ruby 上。它提供了一種結構化、標準化的方法來構建網頁應用，通過提供工具和庫來簡化常見的開發任務。

許多開發者選擇 Ruby on Rails 而不是單獨使用 Ruby，因為其全面的框架簡化了開發並提高了生產力。

設置 Ruby 專案

開始一個新的 Ruby 專案很簡單。按照以下步驟開始：

首先，確保您的系統上安裝了最新版本的 Ruby。您可以在終端中執行以下命令來驗證：
```
asdf install ruby latest \
  && asdf global ruby latest
```
如果您尚未安裝 asdf，需要先安裝。請參考官方 asdf 文件以獲取詳細的安裝說明。

或者，您可以使用 Stackhero Code-Hero，這是一個線上開發解決方案，所有必要的工具都已預先安裝。這個平台允許您立即開始編碼，無需手動安裝。
接下來，安裝 Rails。Rails 以 RubyGem 的形式分發，使安裝變得簡單：
```
gem install rails
```
然後，創建一個名為 my_app 的新 Rails 應用，並使用以下命令指定 Ruby 版本：
```
rails new my_app
cd my_app
asdf local ruby latest
```
要啟動 Rails 伺服器，運行以下命令：
```
bin/rails server
```
Ruby on Rails 歡迎畫面

這些步驟創建了一個新的 Ruby 專案，同時設置了適當的 Ruby 版本。這為您的應用開發奠定了堅實的基礎。

重要提示：執行 rails new 命令時，會自動為您的 Ruby 專案創建一個本地 Git 儲存庫。然而，它尚未連接到遠端版本控制服務。

為了適當的版本控制和數據安全，建議您將專案連接到 GitLab、GitHub 或 Bitbucket 等託管服務。

如果您需要儲存庫託管服務，Stackhero 提供了一個 GitLab 雲服務，只需 2 分鐘即可設置。

Stackhero Code-Hero 的特殊情況

使用像 Stackhero Code-Hero 這樣的線上開發解決方案時，您需要調整 config/environments/development.rb 文件。在最後的 end 關鍵字附近添加以下配置。將 <XXXXXX>.stackhero-network.com 替換為您的實際伺服器主機名：

config.hosts << "<XXXXXX>.stackhero-network.com"

主機配置範例

最後，使用以下命令啟動 Rails 伺服器：

bin/rails server -b 0.0.0.0

此命令確保 Rails 伺服器可以從任何 IP 地址訪問，這在通過 Stackhero Code-Hero 遠程工作時特別有用。

使用 Ruby on Rails 創建您的第一個 "hello world" 應用

讓我們來看看使用 Ruby on Rails 創建一個簡單的 "Hello World" 應用的過程。

首先，為您的應用設置一個新路由。打開 config/routes.rb 文件，並定義一個指向 hello#index 動作的根路由：
```
Rails.application.routes.draw do
  root "hello#index"
end
```
接下來，生成 Hello 控制器來管理此路由的邏輯。在終端中運行以下命令：
```
bin/rails generate controller Hello index --skip-routes
```
使用此配置，對 URL 路徑 / 的任何請求都將由 HelloController 處理。
要顯示 "Hello World" 訊息，創建一個視圖。打開 app/views/hello/index.html.erb 文件，並將任何現有內容替換為以下代碼：
```
<h1>Hello World!</h1>
```
最後，在終端中運行以下命令啟動 Rails 伺服器。然後，連接到您的開發 URL（例如，http://<XXXXXX>.stackhero-network.com:3000）以查看您的應用：
```
bin/rails server -b 0.0.0.0
```
Ruby on Rails 的第一個 "Hello World" 頁面

恭喜您。您剛剛創建了您的第一個 Ruby on Rails 應用！

管理環境變數

環境變數對於保護 API 密鑰和數據庫密碼等敏感數據至關重要。

dotenv-rails gem 提供了一種方便的方法來管理開發環境中的環境變數。以下是步驟：

在適當的組中將 gem 添加到您的 Gemfile：

# Gemfile
gem 'dotenv-rails', groups: [:development, :test]

通過運行以下命令安裝 gem：
```
bundle install
```
在專案的根目錄創建一個 .env 文件，並定義您的環境變數。例如：
```
RAILS_ENV=development
```
為了保護您的敏感數據，確保 .env 文件被排除在您的 Git 儲存庫之外。將以下行添加到您的 .gitignore：
```
echo '.env*' >> .gitignore
```

完成這些步驟後，重新啟動您的 Rails 伺服器。在 .env 文件中定義的環境變數現在將自動在您的應用中可訪問。

開發平台的環境變數