q^idZddlmZddlmZmZddlmZmZm Z m Z m Z ddl m Z Gdde ZGdd e ZGd d eeZy ) a Cache middleware. If enabled, each Django-powered page will be cached based on URL. The canonical way to enable cache middleware is to set ``UpdateCacheMiddleware`` as your first piece of middleware, and ``FetchFromCacheMiddleware`` as the last:: MIDDLEWARE = [ 'django.middleware.cache.UpdateCacheMiddleware', ... 'django.middleware.cache.FetchFromCacheMiddleware' ] This is counter-intuitive, but correct: ``UpdateCacheMiddleware`` needs to run last during the response phase, which processes middleware bottom-up; ``FetchFromCacheMiddleware`` needs to run last during the request phase, which processes middleware top-down. The single-class ``CacheMiddleware`` can be used for some simple sites. However, if any other piece of middleware needs to affect the cache key, you'll need to use the two-part ``UpdateCacheMiddleware`` and ``FetchFromCacheMiddleware``. This'll most often happen when you're using Django's ``LocaleMiddleware``. More details about how the caching works: * Only GET or HEAD-requests with status code 200 are cached. * The number of seconds each page is stored for is set by the "max-age" section of the response's "Cache-Control" header, falling back to the CACHE_MIDDLEWARE_SECONDS setting if the section was not found. * This middleware expects that a HEAD request is answered with the same response headers exactly like the corresponding GET request. * When a hit occurs, a shallow copy of the original response object is returned from process_request. * Pages will be cached based on the contents of the request headers listed in the response's "Vary" header. * This middleware also sets ETag, Last-Modified, Expires and Cache-Control headers on the response object. )settings)DEFAULT_CACHE_ALIAScaches) get_cache_key get_max_agehas_vary_headerlearn_cache_keypatch_response_headers)MiddlewareMixinc>eZdZdZfdZedZdZdZxZ S)UpdateCacheMiddlewarea6 Response-phase cache middleware that updates the cache if the response is cacheable. Must be used as part of the two-part update/fetch cache middleware. UpdateCacheMiddleware must be the first piece of middleware in MIDDLEWARE so that it'll get called last during the response phase. ct||tj|_d|_tj |_tj|_ yN) super__init__rCACHE_MIDDLEWARE_SECONDS cache_timeout page_timeoutCACHE_MIDDLEWARE_KEY_PREFIX key_prefixCACHE_MIDDLEWARE_ALIAS cache_aliasself get_response __class__s H/var/www/eb/venv/lib/python3.12/site-packages/django/middleware/cache.pyrzUpdateCacheMiddleware.__init__DsA &%>> ">>#::c(t|jSrrrrs rcachezUpdateCacheMiddleware.cacheKd&&''rc6t|dxr |jS)N_cache_update_cache)hasattrr%)rrequestresponses r_should_update_cachez*UpdateCacheMiddleware._should_update_cacheOsw 56V7;V;VVrcpj||s|S|js|jdvr|S|js|jrt |dr|Sd|j ddvr|Sj!t| jndk(r|St|r|jdk(rzt||jjt|d r-t|j r|j#fd |Sjj%||S) zSet the cache, if needed.)i0Cookieprivatez Cache-Controlrr+r"renderc>jj|Sr)r"set)r cache_keyrtimeouts rz8UpdateCacheMiddleware.process_response..{sdjjnnY7Cr)r) streaming status_codeCOOKIEScookiesrgetrrrr r rr"r&callabler0add_post_render_callbackr2)rr'r(r4r5s` @@rprocess_responsez&UpdateCacheMiddleware.process_responseRs)(((;O   !5!5Z!GO   (3O  _b9 9O## ?"(+G,,Ax1 x++s2'7DOO4::Ix*x/H11C  y(G<r) __name__ __module__ __qualname____doc__rpropertyr"r)r> __classcell__rs@rr r :s,;((W-rr c8eZdZdZfdZedZdZxZS)FetchFromCacheMiddlewarea! Request-phase cache middleware that fetches a page from the cache. Must be used as part of the two-part update/fetch cache middleware. FetchFromCacheMiddleware must be the last piece of middleware in MIDDLEWARE so that it'll get called last during the request phase. cxt||tj|_tj |_yr)rrrrrrrrs rrz!FetchFromCacheMiddleware.__init__s+ &">>#::rc(t|jSrr r!s rr"zFetchFromCacheMiddleware.cacher#rc|jdvrd|_yt||jd|j}|d|_y|jj |}|M|jdk(r>t||jd|j}|jj |}|d|_yd|_|S)zn Check whether the page is already cached and return the cached version if available. )GETHEADFNrKr/TrL)methodr%rrr"r;)rr'r4r(s rprocess_requestz(FetchFromCacheMiddleware.process_requests >> 0*/G '"'4??ET  *.G '::>>),  & 8%& Izz~~i0H  *.G '',#r) r?r@rArBrrCr"rNrDrEs@rrGrGs&; ((rrGc$eZdZdZdfd ZxZS)CacheMiddlewarez Cache middleware that provides basic behavior for many simple sites. Also used as the hook point for the cache decorator, which is generated using the decorator-from-middleware utility. c t|| |d}|d}||_ |d}|t}||_|||_||_y#t$rY1wxYw#t$rY+wxYw)Nrr)rrrKeyErrorrrrr)rrrrkwargsrrrs rrzCacheMiddleware.__init__s &   -J! (DO  /K"1 *D   $!.D (      s"AA AA A#"A#)NN)r?r@rArBrrDrEs@rrPrPs))rrPN)rB django.confrdjango.core.cacherrdjango.utils.cacherrrr r django.utils.deprecationr r rGrPr.rrrYsN+Z!95EOEP..b )+-E )r