Rails5.2 ActiveStorage Step by S
最近几乎所有的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定义位置,增加下面的代码:
<div class="field">
<%=form.lavel :title >
<%= form.text_field :title %>
</div>
<!--Add this-->
<div class="field">
<%= form.label :picture %>
<%= form.file_field :picture %>
</div>
<div class="action">
<%= form.submit %>
</div>
还需要在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,增加下面代码:
<tbody>
<td>..</td>
<td><%=image_tag url_for(product.picture)%></td>
你的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
更多的功能特点
ActiveStorage还有很多功能,参考官方文档。