vcl_hit subroutine is executed when an object has been found in the cache and is available to be delivered to the client.
A hit in cache usually, but not always, means that the object is fresh; that is, it is within the TTL set by the origin or within the
vcl_fetch subroutine. In cases where the object is stale, but is configured with a positive
beresp.stale_while_revalidate time that has yet to expire, this will still be considered a hit and will trigger a background fetch to repopulate the cache asynchronously. A stale object may also trigger a hit if the backend is considered sick; that is, it has a healthcheck configured, the healthcheck is consistently failing, and the object is configured with a
beresp.stale_if_error time which has not expired.
hit subroutine should
return(deliver) to deliver the object. It is also possible to
return(pass), ignoring the hit and instructing Fastly to fetch from the backend anyway. The exception statements
error may both be used in
hit is executed on a fetch node as a result of clustering.
To see this subroutine in the context of the full VCL flow, see using VCL.
Tokens available in this subroutine
The following limited-scope VCL functions and variables are available for use in this subroutine (those in bold are available only in this subroutine):
User contributed notes
We welcome comments that add use cases, ideas, tips, and caveats. All comments will be moderated before publication. To post support questions, visit our support center and we'll find you the help you need.