http_cache_last_modified
(PECL pecl_http >= 0.1.0)
http_cache_last_modified — Caching by last modification
Description
$timestamp_or_expires
] )Attempts to cache the sent entity by its last modification date.
If the supplied argument is greater than 0, it is handled as timestamp and will be sent as date of last modification. If it is 0 or omitted, the current time will be sent as Last-Modified date. If it's negative, it is handled as expiration time in seconds, which means that if the requested last modification date is not between the calculated timespan, the Last-Modified header is updated and the actual body will be sent.
A log entry will be written to the cache log if the INI setting http.log.cache is set and the cache attempt was successful.
Note: This function may be used in conjunction with http_send_data(), http_send_file() and http_send_stream().
Parameters
-
timestamp_or_expires -
Unix timestamp
Return Values
Returns FALSE or exits on success with 304 Not Modified if the entity is cached.
See the INI setting
http.force_exit for what "exits" means.
Examples
Example #1 A http_cache_last_modified() example
Caching for 5 seconds.
<?php
http_cache_last_modified(-5);
printf("%s\n", http_date());
?>
See Also
- http_cache_etag() - Caching by ETag
- the HttpResponse class if you are using PHP 5.1.0 and above
- http_cache_etag
- http_cache_last_modified
- http_chunked_decode
- http_deflate
- http_inflate
- http_build_cookie
- http_date
- http_get_request_body_stream
- http_get_request_body
- http_get_request_headers
- http_match_etag
- http_match_modified
- http_match_request_header
- http_support
- http_negotiate_charset
- http_negotiate_content_type
- http_negotiate_language
- ob_deflatehandler
- ob_etaghandler
- ob_inflatehandler
- http_parse_cookie
- http_parse_headers
- http_parse_message
- http_parse_params
- http_persistent_handles_clean
- http_persistent_handles_count
- http_persistent_handles_ident
- http_get
- http_head
- http_post_data
- http_post_fields
- http_put_data
- http_put_file
- http_put_stream
- http_request_body_encode
- http_request_method_exists
- http_request_method_name
- http_request_method_register
- http_request_method_unregister
- http_request
- http_redirect
- http_send_content_disposition
- http_send_content_type
- http_send_data
- http_send_file
- http_send_last_modified
- http_send_status
- http_send_stream
- http_throttle
- http_build_str
- http_build_url
Коментарии
Please note that calling this function automatically sends also following header:
Cache-Control: private, must-revalidate, max-age=0
If you want to modify the Cache-Control header as well, you must send it *after* calling http_cache_last_modified().