Ruby: 入门指南

Ruby on Rails 入门指南

👋 欢迎来到 Stackhero 文档！

Stackhero 提供现成的 Ruby cloud 解决方案，具有众多优势，包括：

通过简单的 git push 在几秒钟内 部署您的应用程序。

使用您自己的域名，并享受 HTTPS 证书的自动配置以增强安全性。

享受 自动备份、一键更新，以及简单、透明和可预测的定价带来的安心。

通过专用私有 VM获得最佳的性能和强大的安全性。

节省时间并简化您的生活：只需 5 分钟即可试用 Stackhero 的 Ruby cloud hosting 解决方案！

欢迎阅读 Ruby on Rails 入门指南。在本指南中，您将了解这一流行的 Web 应用框架，它旨在简化和加速您的开发过程。

Ruby on Rails（通常简称为 Rails）是一个使用 Ruby 构建的服务器端 Web 应用框架。它遵循模型-视图-控制器（MVC）架构模式，并采用约定优于配置（CoC）和不要重复自己（DRY）原则。这些特性使 Rails 成为 Web 开发的强大、高效且灵活的选择。

下面，我们将引导您完成启动新 Ruby on Rails 项目的基本步骤。您将学习如何安装 Ruby 和 Rails，设置您的第一个项目，甚至构建一个简单的“Hello World”应用程序。我们还为不同的开发环境提供了额外的指导，包括使用在线平台 Stackhero Code-Hero。

理解 Ruby 和 Rails 的区别

Ruby 是一种动态的开源编程语言，类似于 PHP、JavaScript 或 Python。它强调简单性和生产力，具有易于阅读和编写的优雅语法。

Rails 是一个运行在 Ruby 上的强大服务器端 Web 应用框架。它通过提供工具和库来简化常见的开发任务，从而提供了一种结构化、标准化的构建 Web 应用的方法。

许多开发人员选择 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 文件中定义的环境变量现在将自动在您的应用程序中可用。

开发平台的环境变量