aboutsummaryrefslogtreecommitdiffstats
path: root/lib/active_storage/disk_controller.rb
diff options
context:
space:
mode:
Diffstat (limited to 'lib/active_storage/disk_controller.rb')
-rw-r--r--lib/active_storage/disk_controller.rb12
1 files changed, 11 insertions, 1 deletions
diff --git a/lib/active_storage/disk_controller.rb b/lib/active_storage/disk_controller.rb
index 3eba86c213..9d5b52d66f 100644
--- a/lib/active_storage/disk_controller.rb
+++ b/lib/active_storage/disk_controller.rb
@@ -4,11 +4,21 @@ require "active_storage/verified_key_with_expiration"
require "active_support/core_ext/object/inclusion"
+# This controller is a wrapper around local file downloading. It allows you to
+# make abstraction of the URL generation logic and to serve files with expiry
+# if you are using the +Disk+ service.
+#
+# By default, mounting the Active Storage engine inside your application will
+# define a +/rails/blobs/:encoded_key+ route that will reference this controller's
+# +show+ action and will be used to serve local files.
+#
+# A URL for an attachment can be generated through its +#url+ method, that
+# will use the aforementioned route.
class ActiveStorage::DiskController < ActionController::Base
def show
if key = decode_verified_key
blob = ActiveStorage::Blob.find_by!(key: key)
-
+
if stale?(etag: blob.checksum)
send_data blob.download, filename: blob.filename, type: blob.content_type, disposition: disposition_param
end