Ruby on Rails新手迁移PHP应用：选类还是模块？

嘿，作为刚接触Rails的开发者，从PHP转过来确实会有不少概念上的调整，我来帮你理清楚这个问题～

首先得先明确Rails里**类（Class）和模块（Module）**的核心区别，再结合你的PHP场景来选：

• 模块不能被实例化，主要用来封装可复用的无状态逻辑、常量，或者做命名空间隔离；
• 类可以被实例化，适合需要维护状态（比如保存特定变量、上下文数据）的场景。

接下来对应你的common.php场景分情况讨论：

情况1：common.php里是无状态的工具方法/依赖聚合 #

如果原文件里大多是通用工具函数（比如格式化字符串、参数验证），或者只是用来聚合RPCClient和User的调用（比如暴露一些全局可调用的方法），那**模块（Module）**是更合适的选择。

就像PHP里的静态工具类或全局函数集合，Rails的模块可以直接通过类方法调用，不需要实例化，示例代码如下：

# app/modules/common.rb
module Common
  # 引入依赖（对应PHP里的require）
  require_relative '../models/user'
  require_relative '../services/rpc_client'

  # 无状态工具方法
  def self.format_phone(phone)
    phone.gsub(/[^0-9]/, '')
  end

  # 封装RPCClient的调用
  def self.call_rpc(method, params)
    rpc_client.call(method, params)
  end

  # 封装User的通用操作
  def self.current_user_name
    User.current&.name || 'Guest'
  end

  private
  # 懒加载RPCClient实例，避免重复初始化
  def self.rpc_client
    @rpc_client ||= RPCClient.new
  end
end

之后在控制器、模型里直接调用：

# 控制器里的示例
def index
  @formatted_phone = Common.format_phone(params[:phone])
  @rpc_response = Common.call_rpc('get_data', { id: 123 })
end

情况2：common.php里需要维护实例状态 #

如果原文件里的变量是和请求上下文绑定的（比如每个请求的用户信息、RPCClient的连接状态需要随场景变化），那**类（Class）或者Rails里常用的服务对象（Service Object）**更合适。

比如你需要在不同请求里传入不同的User实例，或者RPCClient需要自定义配置，类可以通过实例变量保存状态，示例如下：

# app/services/common_service.rb
class CommonService
  attr_reader :user, :rpc_client

  # 通过初始化参数注入依赖，更易测试和扩展
  def initialize(user: User.current, rpc_client: RPCClient.new)
    @user = user
    @rpc_client = rpc_client
  end

  # 依赖实例状态的方法
  def user_permission_check(permission)
    @user.has_permission?(permission)
  end

  def call_rpc_with_user_context(method)
    @rpc_client.call(method, user_id: @user.id)
  end
end

使用时实例化并传入上下文：

# 控制器里的示例
def update
  common_service = CommonService.new(user: current_user)
  if common_service.user_permission_check('edit_data')
    response = common_service.call_rpc_with_user_context('update_data')
    # 处理响应
  end
end

额外的Rails最佳实践提示 #

1. 避免全局变量：PHP里的全局共享变量在Rails里尽量不要用，推荐通过类方法（比如User.current）或实例变量传递上下文；
2. 目录结构：无状态模块放在app/modules，服务类/业务类放在app/services或app/models；
3. 依赖注入：尽量通过初始化参数传入依赖（比如上面示例里的user:和rpc_client:），而不是硬编码，这样代码更易测试和维护。

内容的提问来源于stack exchange，提问作者Rishabh Shukla