get_cache

[chimmel]

How to utilize get_cache method? i.e., how to determine the particular cache file name/$fn argument?

[duzun]

First of all I'd like to mention that hQuery::get_cache($fn, $expire=false, $meta_only=false) is a protected method, hence used internally only.

It could be used as a stand-alone method for purposes outside hQuery, but I have no intention to expose it as a public method for reading cache contents of hQuery.

If you want to make sure contents are fetched from cache (when there is contents in cache) just use a big enough $expires option:

$result = hQuery::fromURL('http://example.com', NULL, NULL, ['expires' => PHP_INT_MAX]);

You also have to set hQuery::$cache_path before using cache, otherwise, cache is disabled.
By default hQuery::$cache_expires is one hour (3600 sec), but you can change it at any point in your code.

I could add another method for checking whether a particular request is cached or not, something like: hQuery::isExpired($url, $opt=NULL).