FTP Storage for Paperclip
Allow Paperclip attachments to be stored on FTP servers.
Status
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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Authors
- Sebastian Röbke
- and other friendly contributors
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.