interface SelfCheckingResourceInterface implements ResourceInterface

Interface for Resources that can check for freshness autonomously, without special support from external services.

Methods

string
__toString()

Returns a string representation of the Resource.

bool
isFresh(int $timestamp)

Returns true if the resource has not been updated since the given timestamp.

mixed
getResource() deprecated

Returns the tied resource.

Details

in ResourceInterface at line 32
string __toString()

Returns a string representation of the Resource.

This method is necessary to allow for resource de-duplication, for example by means of array_unique(). The string returned need not have a particular meaning, but has to be identical for different ResourceInterface instances referring to the same resource; and it should be unlikely to collide with that of other, unrelated resource instances.

Return Value

string A string representation unique to the underlying Resource

at line 29
bool isFresh(int $timestamp)

Returns true if the resource has not been updated since the given timestamp.

Parameters

int $timestamp The last time the resource was loaded

Return Value

bool True if the resource has not been updated, false otherwise

in ResourceInterface at line 57
mixed getResource() deprecated

deprecated since 2.8, to be removed in 3.0. As there are many different kinds of resource, a single getResource() method does not make sense at the interface level. You can still call getResource() on implementing classes, probably after performing a type check. If you know the concrete type of Resource at hand, the return value of this method may make sense to you.

Returns the tied resource.

Return Value

mixed The resource