Improve cache-file-descriptors.conf doc

Closes #203
This commit is contained in:
Léo Colombaro 2018-12-02 17:23:44 +01:00 committed by GitHub
parent df23e0ba8c
commit df4be14a73
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 11 deletions

View File

@ -2,21 +2,29 @@
# | Cache file-descriptors | # | Cache file-descriptors |
# ---------------------------------------------------------------------- # ----------------------------------------------------------------------
# This tells Nginx to cache open file handles, "not found" errors, metadata about files and their permissions, etc. # This tells nginx to cache open file handles, "not found" errors and
# metadata about files and their permissions.
# #
# The upside of this is that Nginx can immediately begin sending data when a popular file is requested, # Based on these cached metadata, nginx can immediately begin sending
# and will also know to immediately send a 404 if a file is missing on disk, and so on. # data when a popular file is requested, and will also know to
# immediately send a 404 if a file is missing on disk, and so on.
# #
# However, it also means that the server won't react immediately to changes on disk, which may be undesirable. # (!) It also means that the server won't react immediately to changes
# on disk, which may be undesirable.
# As only metadata are cached, edited files may be troncated until
# the cache is refreshed.
# https://github.com/h5bp/server-configs-nginx/issues/203
# #
# In the below configuration, inactive files are released from the cache after 20 seconds, whereas # In the below configuration, inactive files are released from the cache
# active (recently requested) files are re-validated every 30 seconds. # after 20 seconds, whereas active (recently requested) files are
# re-validated every 30 seconds.
# Descriptors will not be cached unless they are used at least 2 times
# within 20 seconds (the inactive time).
# A maximum of the 1000 most recently used file descriptors can be
# cached at any time.
# #
# Descriptors will not be cached unless they are used at least 2 times within 20 seconds (the inactive time). # Production servers with stable file collections will definitely want
# # to enable the cache.
# A maximum of the 1000 most recently used file descriptors can be cached at any time.
#
# Production servers with stable file collections will definitely want to enable the cache.
# #
# https://nginx.org/en/docs/http/ngx_http_core_module.html#open_file_cache # https://nginx.org/en/docs/http/ngx_http_core_module.html#open_file_cache