Rails5.2 ActiveStorage Step by Step

最近几乎所有的web应用里面存在用户上传文件的需求，

可能是一个个性的头像，一个要卖的商品图片或者一些分类的文档。

在过去的一些年里，我们几乎都在用carrierwave或者paperclip去处理Rails的上传，现在在5.2版本里面我们有另外一种方式：ActiveStorage。

什么是Active Storage?

来自他的说明文档：

Active Storage 让上传更简单，通过云服务应用文件如：Amazon S3， Google Cloud Storage or Microsoft Azure Storage，而且attach这些文件到ActiveRecords。支持一个主要服务和镜像在别的服务redundancy，他也提供磁盘服务for testing或者本地开发，但是他重点在于云存储。

ActiveStorage 是一个帮助你处理文件上传的引擎，in yourRailsApps in a very straightforward and easy way.

Set it up

让我们来创建一个rails app示例，我现在假设你已经安装了rails5.2.

rails new catalog

在你开始使用ActiveStorage前，你需要一个数据库表，运行下面的命令安装数据库迁移：

bin/rails active_storage:install

现在你创建产品model通过titlle，然后运行所有的migrations

```

bin/rails generate scaffold products title:string

bin/rails db:migrate

```

附加一个文件到model

现在，我们假设我们每个 Product对象都有一个picture。我们通过has_one_attached 方法去定义这个关系。

class Product < AppicationRecord

has_one_attached :picture

end

我们现在需要在Product定义一个字段，用户能够去指定这个要上传的文件。编辑app/views/products/_form.html.erb找到field定义位置，增加下面的代码：

<%=form.lavel :title >

<%= form.text_field :title %>

<%= form.label :picture %>

<%= form.file_field :picture %>

<%= form.submit %>

还需要在ProductController里面增加‘picture'到运行的参数。

def product_params

params.require(:product).permit(:title, :picture)

end

现在如果你启动服务，导航到/products, 点击’新增‘,输入标题和选择一个图片，你会在development.log里面看到通知：INSERT statement to the active_storate_blobs 表。

找到一些相识的日志如：

ActiveStorage::Attachment Create(0.3ms) INSERT INTO "active_Storage_attachments"("name","record_type","blob_id", "created_at") VALUES(?,?,?,?)[["name","picture"]["record_type", "Product"],["record_id", 4],{"bolb_id", 2],["created_at", "2018......."]]

显示附件

你可以通过调用url_for helper 返回这个附件的url，在我们的案例中在上传完成后显示。编辑app/views/products/index.html.erb,增加下面代码：

<%=image_tag url_for(product.picture)%>

你的scaffold会在你上传后显示这个图片。

不同的Storage Stragegies

当你在开发环境侠士，你想保持上传文件在你本地磁盘，但是当你发布时你想使用第三方服务去存储他们，比如Amaon S3，Azure Storage Service 或者Google Cloud Storage。

使用ActiveStorage处理这个非常方便。

在config/storage.yml里面声明不同的环境存储配置。比如：local环境声明’disk‘，生产环境’amazon'

local:

service: Disk

root: <%= Rails.root.join("storage")%>

amazon:

service: S3

access_key_id: AMAZONE KEY

secret_access_key: AMAZON SECRET KEY

然后，在对应的config/environments/*.rb文件里面知道storage来使用。

比如：development.rb

config.active_storate.service = :local

production.rb

config.active_storage.service = :amazon

说明：你可能需要包含额外的gem包，在Gemfile里面，要使用Amazon S3你需要包含aws-sdk-s3

gem "aws-sdk-s3", require: false