Shrine 开源项目教程

Shrine 开源项目教程

shrineGas-efficient contract for distributing any amount of any ERC20 token to a weighted list of addresses of arbitrary size.项目地址:https://gitcode.com/gh_mirrors/shrin/shrine

项目介绍

Shrine 是一个用于文件上传的 Ruby 库，提供了灵活的插件系统，使得文件上传过程可以轻松定制和扩展。它支持多种存储后端，包括本地文件系统、Amazon S3 等，并且可以与各种 Ruby 框架（如 Rails、Sinatra）无缝集成。

项目快速启动

安装

首先，将 Shrine 添加到你的 Gemfile 中：

gem 'shrine'

然后运行 bundle install。

配置

创建一个初始化文件 config/initializers/shrine.rb：

require "shrine"
require "shrine/storage/file_system"

Shrine.storages = {
  cache: Shrine::Storage::FileSystem.new("public", prefix: "uploads/cache"),
  store: Shrine::Storage::FileSystem.new("public", prefix: "uploads/store"),
}

Shrine.plugin :activerecord
Shrine.plugin :cached_attachment_data
Shrine.plugin :restore_cached_data

模型设置

在你的模型中添加附件：

class Photo < ApplicationRecord
  include ImageUploader::Attachment(:image)
end

上传器

创建一个上传器 app/uploaders/image_uploader.rb：

class ImageUploader < Shrine
  plugin :validation_helpers

  Attacher.validate do
    validate_max_size 5*1024*1024, message: "is too large (max is 5 MB)"
    validate_mime_type_inclusion %w[image/jpeg image/png image/gif]
  end
end

表单

在你的表单中添加文件上传字段：

<%= form_for @photo do |f| %>
  <%= f.hidden_field :image, value: @photo.cached_image_data %>
  <%= f.file_field :image %>
  <%= f.submit %>
<% end %>

应用案例和最佳实践

应用案例

Shrine 可以用于各种需要文件上传的场景，例如：

• 用户头像上传
• 产品图片管理
• 文档存储系统

最佳实践

• 使用云存储：推荐使用 Amazon S3 等云存储服务，以提高可靠性和可扩展性。
• 插件系统：充分利用 Shrine 的插件系统，根据需求定制功能。
• 验证和处理：在上传器中进行文件验证和处理，确保上传的文件符合要求。

典型生态项目

Shrine 可以与以下项目结合使用，以构建更强大的文件上传和管理系统：

• Active Storage：Rails 官方的文件上传解决方案，可以与 Shrine 结合使用。
• CarrierWave：另一个流行的 Ruby 文件上传库，可以作为 Shrine 的替代方案。
• Refile：简单易用的文件上传库，适合小型项目。

通过这些模块的介绍和示例，你可以快速上手并深入了解 Shrine 开源项目。

shrineGas-efficient contract for distributing any amount of any ERC20 token to a weighted list of addresses of arbitrary size.项目地址:https://gitcode.com/gh_mirrors/shrin/shrine