ruby on rails爬坑（三）：图片上传及显示

关注

原创最新推荐文章于 2026-09-07 11:30:18 发布 5.2k 阅读 AI 写同款· GEO 优化 ›

Rails图片上传与显示由于rails封装了表单中的file类型,从而使得它的上传和下载变的很简单，只需要调用上传的file表单对象[Tempfile]的read方法就可以轻松的得到所上传文件的二进制流。其实一般的上传文件有保存与服务器端有两种方式，一种是直接将所上传的文件内容以二进制流的形式保存在阅读详情

一，问题及思路

最近在用rails + react + mysql基本框架写一个cms + client的项目，里面涉及到了图片的上传及显示，下面简单说说思路，至于这个项目的配置部署，应该会在寒假结束总结分享一下。

rails中图片上传及显示要解决主要问题是：

图片存在哪？
图片格式大小？
客户端怎么显示图片？

因为这是个小项目，估计最多1000张图片，最多占用空间1G，所以采取相对简便的方法：图片保存在rails的public文件夹里（也就是保存在部署该项目的主机中），如果图片比较多的话，还是推荐用亚马逊云提供的服务AWS S3（理解为一个硬盘，S3提供了接口给你存取东西，安全，管理方便）。

大概的思路是，前端通过<input type="file"/>选择文件，发送ajax请求到后端的controller，controller将请求的图片数据进行大小裁剪、类型转换后保存到本地指定的文件夹，同时将路径返回，用于显示图片。

二，实践

思路比较简单，所以话不多说，直接上代码：

前端代码整合在react写的一个图片上传组件里，image_uploader.js.jsx代码如下

var ImageUploader = React.createClass({
  getInitialState: function() {
    return {
      url: this.props.url
    };
  },
  onFileSelect: function(e) {
    var that = this;
    var files = e.target.files;
    if (files.length <= 0) {
      AlertModal.showWithProps("No file selected");
      return;
    }
    var data = new FormData();
    $.each(files, function(key, value) {
      data.append('file', value);
      data.append('type', that.props.type)
    });
    this.upload(data);
  },
  upload: function(data) {
    var that = this;
    if (!data) {
      return;
    } else {
      this.refs.filebtn.disabled = true;
      $("#loading-modal").modal('show');
      $.ajax({
        url: '/missions/upload_image',
        type: 'post',
        data: data,
        processData: false,
        contentType: false
      }).done(function(res){
        console.log(res);
        that.setState({url: res.url});        
      }).fail(function(err){
        console.log(err);
        AlertModal.showWithProps("Upload Failed");
      }).always(function(){
        $("#loading-modal").modal('hide');
        that.refs.filebtn.disabled = false;
      });
    }
  },
  handleUrlChange: function(e) {
    this.setState({url: e.target.value});
  },
  render: function() {
    var form_input_name = this.props.model + "[thumb]";
    var form_input_id = this.props.model+ "_thumb";
    return (
      <div className="image-uploader-inputs row">
        <div className="col-sm-8 image-input">
          <input className="form-control" name={form_input_name} id={form_input_id} ref="urlinput" value={this.state.url || ""} onChange={this.handleUrlChange}/>
        </div>
        <div className="btn btn-primary btn-file image-input-btn">
          <input type="file" onChange={this.onFileSelect} ref="filebtn"/>
        </div>
      </div>
    );
  }
});

效果图
上面的重点在于upload函数，源码是最好的文档，如果看源码需要太多注释的话，那肯定是我写的代码质量还不够高，请批评指出。

写这个的时候遇到两个问题：

一，这个组件是用在_form.html.slim里的，这个表单是用于信息的录入的，大家对表单应该比较熟悉，既然要用在表单里，就是给这个组件作标识,标明name和id，代码片段如下（从上面的代码中截取）：

var form_input_name = this.props.model + "[thumb]";
var form_input_id = this.props.model+ "_thumb";

<input className="form-control" name={form_input_name} id={form_input_id} ref="urlinput" value={this.state.url || ""} onChange={this.handleUrlChange}/>

二，使用<input type="file"/>有一个普遍的问题，自带的UI不美观。

谷歌/百度“input file btn”会有许多解决方案，家里网速差就没细看。我的做法是把这个btn设为透明，相关的代码及css如下：

<div className="btn btn-primary btn-file image-input-btn">
  <input type="file" onChange={this.onFileSelect} ref="filebtn"/>
</div>

.image-input-btn {
    float: left;
    width: 15%;
    background-image: image-url("upload.png");
    background-size: 30px;
    background-position: center;
    background-repeat: no-repeat;
    input {
      //hide file input button
      width: inherit;
      opacity: 0;
    }
  }

接下来看看后端的代码：

def upload_image
    # => will resize later
    image_relative_path = "/assets/images/#{params[:type]}/#{Time.now.to_i}.png"
    image_path = File.expand_path(File.dirname(__FILE__) + '/../..') + "/public" + image_relative_path

    data = File.read(params[:file].path)
    img = File.new(image_path, "w+")
      if img
        img.syswrite(data)
      end
    img.close
    render json: {url: image_relative_path}
 end

代码同样简单，构建文件路径，保存文件，返回路径。因为开发进度的原因这里并没有对图片的大小和类型进行修改（为了减少数据传输量，在前端进行大小的修改比较合理），后面review这部分代码的时候会再更新这篇博客。

值得说说的是：

图片命名的问题，采用了时间戳，命名不会重复，为了方便管理，将不同类型的图片存于不同的文件夹，但是只以时间戳命名可获取的信息太少，不利于运营人员管理，后期会再仔细考虑这个问题。
存放路径问题，在后端代码里，rails能将图片存在rails项目文件夹的任何位置，但是客户端显示图片的时候，只能访问public文件夹里的内容，于是决定将图片存在public文件夹下。