ActiveStorage Overview --Rails guide (history:7-1更新)

如何attach一个或多个文件到一个记录.has_many_attach()方法。
如何删除一个附加的文件。 purge方法
如何连接到一个附加的文件。url_for()
如何使用variants来转化image。 ⚠️Variant／Variation模块
如何generate一个文件代表无图像的文件，如PDF,或者video。⚠️忽略了。
如何从浏览器发送一个文件上传到一个存储服务storage service, 通过你的应用服务 direct_upload: true方法，另外还增加了JavaScript event⚠️
在测试期间如何clear储存的文件⚠️我用的是参考书上的方法。
如何implement 支持为额外的储存服务。⚠️还需要看帖子。

教程视频：

step by step 的网页，包括还未掌握的云存储，和服务器相关步骤：

https://afreshcup.com/home/2017/07/23/activestorage-samples

1.什么是ActiveStorage?

Active Storage上传文件到一个云存储服务如AmazonS3. 并且附加这件文件到Active Record objects。它基于本地磁盘服务，可以用于开发和测试以及支持镜像文件给次级服务用于备份和迁移。

使用Active Storage，一个程序可以转化文件通过ImageMagick上传。以及生成文件代表无图像的文件，如PDF,或者video，以及提取元数据从任意文件。

2. Setup

ActiveStorage使用2个数据表储存文件。

运行rails active_storage:install 生成这2个数据表。

如果在本地开发，在config/environments/development.rb中，

config.active_storage.service = :local #默认已经设置了。

声明Active Storage 服务在config/storage.yml中。为了让你的程序使用云服务，需要提供一个名字和必须的配置。如amazon的配置：

本地和测试是默认的。

test:

service: Disk

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

local:

service: Disk

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

amazon:

service: S3

access_key_id: <%= Rails.application.credentials.dig(:aws, :access_key_id) %>

secret_access_key: <%= Rails.application.credentials.dig(:aws, :secret_access_key) %>

region: us-east-1

bucket: your_own_bucket

你需要告诉Active Storage使用那个server。设定:

Rails.application.config.active_storage.service

因为每个环境使用的服务不一样。所以推荐提前在环境中设置好。比如要在开发环境使用前面案例的disk 服务，你需要在config/environments/development.rb设置:

config.active_storage.service = :local #默认已经设置了。

如果在production中，使用AmazonS3服务，配置config/environments/production.rb:

config.active_storage.service = :amazon

当然还要读更多的信息关于内置服务适配器adapters（如Disk和S3）和它们需要的配置。

2.1Disk Service

声明 disk服务，在config/storage.yml中，默认已有了。

2.2 Amazon S3 Service

同样需要在config/storage.yml中设置。

另外需要下载他的gem：gem 'aws-sdk-s3', require: false

(主流的云服务都有gem)具体的都需要看相关文档。

其他Microsoft， Google（都需要下载gem）

2.5 Mirror Service

通过定义一个镜像服务，你可以持有多个云服务在异步下。

当一个文件上传或删除，它就通过了所以的镜像服务。

在产品环境中，镜像服务之间能够通过一个迁移来使用。

你开业开始镜像一个新的服务，拷贝现存的文件从旧服务到新服务，然后把所有的放在新服务上

Define each of the services you'd like to use as described above and reference them from a mirrored service.（不懂⚠️）

s3_west_coast:

service: S3

access_key_id: ""

secret_access_key: ""

region: ""

bucket: ""

s3_east_coast:

service: S3

access_key_id: ""

secret_access_key: ""

region: ""

bucket: ""

production:

service: Mirror

primary: s3_east_coast

mirrors:

- s3_west_coast

文件们从主服务被服务。

3 Attaching Files to Records

3.1 has_one_attached

可以参考https://www.cnblogs.com/chentianwei/p/9169049.html的写法：

在创建一个对象时，不添加关联。之后再使用:

@user.avatar.attach(params[:user][:avatar]) 来附加一个文件。

或者也可以通过参数限制方法user_params直接创建：

def create

user = User.create!(user_params)

session[:user_id] = user.id

redirect_to root_path

end

private

def user_params

params.require(:user).permit(:email_address, :password, :avatar)

end

调用avatar.attached?可以确定对象是否有了一个文件，返回true/false

3.2 has_many_attached macro宏命令

一对多的关系。一条记录可以附加多个文件。假如有一个message有多个images:

has_many_attached :images, dependent:false #记录删除但附加文件不会删除。

class MessagesController < ApplicationController

def create

message = Message.create!(message_params)

redirect_to message

end

private

def message_params

params.require(:message).permit(:title, :content, images: [])

end

⚠️，如果使用has_many, 注意传的是一个数组，

更新：（7-1）

在views/_form.html.slim中，用form_for:

div.form-group

= f.label :images

= f.file_field :images, multiple: true, class:"form-control"

就会在web, products/new中显示一个上传框：choose files，⚠️是files，这样就可以上传多个文件了。✌️

全代码：

h2 后台，产品目录

- @products.each do |product|

li = link_to product.title, admin_product_path(product)

- if product.avatar.attached?

li = link_to image_tag(url_for(product.avatar), size: "100"), rails_blob_path(product.avatar, disposition:"attachment")

- if product.images.attached?

- product.images.each do |image|

- if image.variable?

li = link_to image_tag(image.variant(resize: "400x400")), rails_blob_path(image, disposition:"attachment")

p = image.filename

- elsif image.previewable?

li = image_tag image.preview(resize: "200x200")

- else

li = image.filename

备注：product.avatar.variable? =>true; product.avatar.image? =>true；

图片既是image也是variable.

更新 7-2

假设@post有一个image

file_field(:image, accept: 'image/png,image/gif,image/jpeg')

:accept - If set to one or multiple mime-types, the user will be suggested a filter when choosing a file. You still need to set up model validations.

问题：如何设置validations。验证上传文件的格式。自定义？

使用“how to validate uploaded file type in rails 5.2”进行google search

得到2018年的搜索记录。看第一条。
看相关的网页：

https://stackoverflow.com/questions/48158770/activestorage-file-attachment-validation

https://github.com/rails/rails/issues/31656 (还没有看。)

在product.rb中

validate :must_type

def must_type

if avatar.attached?

if avatar.blob.byte_size > 10

errors[:base] << "#{avatar.blob.filename.to_s}太大，请选择小于10mb的文件。"

avatar.purge

elsif !avatar.blob.content_type.match(/^image\//)

# 使用in?(%w(image/png image/jepg))也可以。

errors[:base] << '非法文件格式，只支持图片格式。'

avatar.purge

end

#if images.attached? 后面的代码大同小异，多images一个循环。

end

在views/../_form.html.slim中添加file_field的时候，需要添加accept特性

= f.file_field :avatar, class:"form-control", accept: "image/jpg, image/jpeg, image/png, image/gif"

4 Removing Files

purge: 把文件从storage中清除。

可以从数据库直接删除：

ActiveStorage::Blob.find(

巴特西

ActiveStorage Overview --Rails guide (history:7-1更新)

3 Attaching Files to Records

最新文章

热门文章