Теперь давайте посмотрим, как мы можем связать это с нашим приложением Rails.

Загрузка файлов

Carrierwave — замечательная жемчужина, которая упрощает загрузку файлов в Ruby. Он также хорошо взаимодействует с MiniMagick, делая нашу жизнь намного проще.

 # Gemfile

gem 'carrierwave'
gem 'carrierwave-mongoid', :require => 'carrierwave/mongoid'

ПРИМЕЧАНИЕ. Если вы используете ActiveRecord или DataMapper, конфигурации будут немного отличаться, и официальная документация Carrierwave покажет вам путь.

Пакет, чтобы получить все эти драгоценные камни:

 bundle install

Создайте наш первый загрузчик:

 #app/uploaders/image_uploader.rb

class ImageUploader < CarrierWave::Uploader::Base
  # Include RMagick or MiniMagick support:
  include CarrierWave::MiniMagick

  # Choose what kind of storage to use for this Uploader:
  storage :file
  # Override the directory where uploaded files will be stored.
  # This is a sensible default for uploaders that are meant to be mounted:
  def store_dir
    "uploads/images"
  end
end

Код здесь не требует пояснений. storage :filestore_dir

Поскольку файлы отправляются через Интернет, рекомендуется всегда фильтровать входящие файлы:

 # app/uploaders/image_uploader.rb
...
# Add a white list of extensions which are allowed to be uploaded.
# For images you might use something like this:
def extension_white_list
  %w(jpg jpeg png gif)
end
...

Этот фрагмент отфильтровывает типы файлов, отличные от указанных здесь. Это ни в коем случае не является защитой от дурака, но оно служит фильтром первого уровня против любой атаки препятствий.

Установите этот загрузчик на нашу модель изображения:

 # app/models/image.rb

class Image
  include Mongoid::Document
  include Mongoid::Timestamps
  include Mongoid::Paranoia
  include Mongoid::Attributes::Dynamic
  include Rails.application.routes.url_helpers

  mount_uploader :media, ImageUploader, mount_on: :media_filename
end

Отредактируйте файл image_uploader.rb для обработки загруженного изображения:

 # app/uploaders/image_uploader.rb

#.....
process :resize_to_fill => [200, 200]
process :convert => 'png'
#.....

Попробуйте создать новый образ из консоли Rails:

 media = File.open("/Users/test/Desktop/image/jpg")
img = Image.new(:media => media)
img.save

Загруженное изображение доступно в store_dir Однако загруженное изображение немедленно обрабатывается и перезаписывается изображением 200 × 200. У нас не будет копии исходного файла для любых будущих изменений. Чтобы избежать этого, создайте несколько версий файла.

 # app/uploaders/image_uploader.rb

#.....
version :thumb do
  process :resize_to_fit => [100, 100]
  process :convert => 'jpg'
end

version :cover   do
  process :resize_to_fit => [240, 180]
  process :convert => 'jpg'
end

#.....

Это создает 2 новые версии вместе с исходным изображением. Проверьте версии, созданные Carrierwave:

 img.media.versions[:thumb] # returns the thumb image instance
img.media.versions[:cover] # returns the cover image instance

Вы заметили, что эти изображения генерируются мгновенно? Это означает, что преобразование изображения происходит в том же потоке, и выполнение блокируется до его завершения. В производственном приложении нежелательно создавать несколько версий изображения в одном потоке. Вместо этого мы должны обращаться с этим условно.

 # app/uploaders/image_uploader/rb

#....
version :cover, :if => :is_live? do
  process :resize_to_fit => [240, 180]
  process :convert => 'jpg'
end

def is_live?(img = nil)
  @is_live
end

def is_live=(value)
  @is_live = value
end
#....

Теперь, когда мы пытаемся создать новое изображение, кавер-версия не будет сгенерирована. Мы можем вызвать это вручную, просто запустив:

 img.media.is_live = true
img.save
img.media.recreate_versions! :cover

Этот код также выполняется на переднем плане и является блокирующей операцией, но, по крайней мере, он откладывается до последнего возможного момента. Мы можем сделать это еще дальше, запустив это в фоновом режиме с помощью Resque:

 # lib/resque/image_queue.rb
class ImageQueue
  @queue = :image_queue
  def self.perform(image_id)
    image = Image.find image_id
    img.media.is_live= true
    img.save
    img.media.recreate_versions! :cover
  end
end

и поставьте в очередь:

 Resque.enqueue(ImageQueue, img.id.to_s)

Улучшение производительности

Изображения тяжелые и имеют тенденцию замедлять работу сайта. Один из способов уменьшить вес страницы — сжать эти изображения. Carrierwave Image Optimizer помогает нам сжимать наши изображения на лету без каких-либо хлопот.

Добавьте это в свой Gemfile:

 gem 'carrierwave-imageoptimizer'

И отредактируйте image_uploader

 # app/uploaders/image_uploader.rd

#.....

include CarrierWave::ImageOptimizer
process :optimize
process :quality => 100
#....

Это сжимает все изображения без каких-либо визуальных потерь. То, как это работает, заключается в удалении всей метаинформации об изображении. В среднем это уменьшает размер примерно на 20-30%.

Завершение

Обработка изображений — это огромная вертикаль, и мы едва поцарапали поверхность. С его помощью мы можем создать так много классных вещей. Надеюсь, я заинтересовался этой статьей. Пожалуйста, поделитесь своими мыслями в комментариях.