Skip to content

xing/paperclip-storage-ftp

Repository files navigation

FTP Storage for Paperclip

Allow Paperclip attachments to be stored on FTP servers.

Status

Build Status Coverage Status Gem Version

Installation

Add this line to your application's Gemfile:

gem "paperclip-storage-ftp"

And then execute:

$ bundle

Or install it manually:

$ gem install paperclip-storage-ftp

Usage

Somewhere in your code:

require "paperclip/storage/ftp"

In your model:

class User < ActiveRecord::Base
  has_attached_file :avatar, {
    # Choose the FTP storage backend
    :storage => :ftp,

    # Set where to store the file on the FTP server(s).
    # This supports Paperclip::Interpolations.
    :path => "/path_on_ftp_server/:attachment/:id/:style/:filename",

    # The full URL of where the attachment is publicly accessible.
    # This supports Paperclip::Interpolations.
    :url => "/url_prefix/:attachment/:id/:style/:filename",

    # The list of FTP servers to use
    :ftp_servers => [
      {
        :host     => "ftp1.example.com",
        :user     => "foo",
        :password => "bar"
      },
      # Add more servers if needed
      {
        :host     => "ftp2.example.com",
        :user     => "foo",
        :password => "bar",
        :port     => 2121, # optional, 21 by default
        :passive  => true  # optional, false by default
      }
    ],

    # Optional socket connect timeout (in seconds).
    # This only limits the connection phase, once connected
    # this option is of no more use.
    :ftp_connect_timeout => 5, # optional, nil by default (OS default timeout)

    # Optional flag to skip dead servers.
    # If set to true and the connection to a particular server cannot be
    # established, the connection error will be ignored and the files will
    # not be uploaded to that server.
    # If set to false and the connection to a particular server cannot be established,
    # a SystemCallError will be raised (Errno::ETIMEDOUT, Errno::ENETUNREACH, etc.).
    :ftp_ignore_failing_connections => true, # optional, false by default

    # Optional flag to keep empty parent directories when deleting files.
    :ftp_keep_empty_directories => true # optional, false by default
  }
end

Changelog

1.2.8

  • Handle possible ftp error when uploading to empty remote dir #28

1.2.7

  • Reduce number of FTP commands for creating directories #27

1.2.6

  • New option :ftp_keep_empty_directories to disable the removal of empty parent directories when deleting files (introduced in 1.2.2). See usage example above.
  • Fix missing log lines in logjam. This only affects apps that use logjam_agent.

1.2.5

  • Ignore ftp error when deleting an non-existing file #29

1.2.4

  • Avoid unnecessary connection to server(s) when there are no files to be written or deleted #26

1.2.3

  • Rescue FTPPermError exception during file_exists? #22

1.2.2

  • Remove empty parent directories after image deletion #21

1.2.1

  • Raise Paperclip::Storage::Ftp::NoServerAvailable error when using :ftp_ignore_failing_connections => true but all servers are down
  • Avoid connecting to all servers for operations that just need one

1.2.0

  • New options :ftp_connect_timeout and :ftp_ignore_failing_connections. See usage example above.

1.1.0

Mostly performance enhancements

  • Use one thread per server to upload assets to multiple servers in parallel #10
  • Avoid excessive reconnects to reduce overall upload time
  • Close connnection immediately after being used

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Authors

You can find out more about our work on our dev blog.

Copyright (c) 2015 XING AG

Released under the MIT license. For full details see LICENSE included in this distribution.