Diviner Phabricator Tech Docs PhabricatorCaches

final class PhabricatorCaches
Phabricator Technical Documentation (Cache)

This class is not documented.

Tasks

Request Cache

No methods for this task.

Immutable Cache

public static function getImmutableCache() — Gets an immutable cache stack.
private static function buildImmutableCaches() — Build the immutable cache stack.

Setup Cache

public static function getServerStateCache() — Highly specialized cache for storing server process state.
public static function getSetupCache() — Highly specialized cache for performing setup checks. We use this cache to determine if we need to run expensive setup checks when the page loads. Without it, we would need to run these checks every time.
private static function buildSetupCaches($cache_name)
private static function getSetupCacheDiskCachePath($name)
private static function testTemporaryDirectory($dir)

Compression

public static function maybeDeflateData($value) — Deflate a value, if deflation is available and has an impact.
public static function inflateData($value) — Inflate data previously deflated by @{method:maybeDeflateData}.

Other Methods

public static function getNamespace()
private static function newStackFromCaches($caches)
public static function getRequestCache() — Get a request cache stack.
public static function destroyRequestCache() — Destroy the request cache.
public static function getMutableCache()
private static function buildMutableCaches()
public static function getMutableStructureCache()
private static function buildMutableStructureCaches()
public static function getRuntimeCache() — Get a runtime cache stack.
private static function buildRuntimeCaches()
public static function getRepositoryGraphL1Cache()
private static function buildRepositoryGraphL1Caches()
public static function getRepositoryGraphL2Cache()
private static function buildRepositoryGraphL2Caches()
private static function addProfilerToCaches($caches)
private static function addNamespaceToCaches($caches)

Methods

public static function getNamespace()

This method is not documented.

Return

wild

private static function newStackFromCaches($caches)

This method is not documented.

Parameters

array

$caches

Return

wild

public static function getRequestCache()

Get a request cache stack.

This cache stack is destroyed after each logical request. In particular, it is destroyed periodically by the daemons, while static caches are not.

Return

PhutilKeyValueCacheStack

Request cache stack.

public static function destroyRequestCache()

Destroy the request cache.

This is called at the beginning of each logical request.

Return

void

public static function getImmutableCache()

Gets an immutable cache stack.

This stack trades mutability away for improved performance. Normally, it is APC + DB.

In the general case with multiple web frontends, this stack can not be cleared, so it is only appropriate for use if the value of a given key is permanent and immutable.

Return

PhutilKeyValueCacheStack

Best immutable stack available.

private static function buildImmutableCaches()

Build the immutable cache stack.

Return

list<PhutilKeyValueCache>

List of caches.

public static function getMutableCache()

This method is not documented.

Return

wild

private static function buildMutableCaches()

This method is not documented.

Return

wild

public static function getMutableStructureCache()

This method is not documented.

Return

wild

private static function buildMutableStructureCaches()

This method is not documented.

Return

wild

public static function getRuntimeCache()

Get a runtime cache stack.

This stack is just APC. It's fast, it's effectively immutable, and it gets thrown away when the webserver restarts.

This cache is suitable for deriving runtime caches, like a map of Conduit method names to provider classes.

Return

PhutilKeyValueCacheStack

Best runtime stack available.

private static function buildRuntimeCaches()

This method is not documented.

Return

wild

public static function getRepositoryGraphL1Cache()

This method is not documented.

Return

wild

private static function buildRepositoryGraphL1Caches()

This method is not documented.

Return

wild

public static function getRepositoryGraphL2Cache()

This method is not documented.

Return

wild

private static function buildRepositoryGraphL2Caches()

This method is not documented.

Return

wild

public static function getServerStateCache()

Highly specialized cache for storing server process state.

We use this cache to track initial steps in the setup phase, before configuration is loaded.

This cache does NOT use the cache namespace (it must be accessed before we build configuration), and is global across all instances on the host.

Return

PhutilKeyValueCacheStack

Best available server state cache stack.

public static function getSetupCache()

Highly specialized cache for performing setup checks. We use this cache to determine if we need to run expensive setup checks when the page loads. Without it, we would need to run these checks every time.

Normally, this cache is just APC. In the absence of APC, this cache degrades into a slow, quirky on-disk cache.

NOTE: Do not use this cache for anything else! It is not a general-purpose cache!

Return

PhutilKeyValueCacheStack

Most qualified available cache stack.

private static function buildSetupCaches($cache_name)

This method is not documented.

Parameters

$cache_name

Return

wild

private static function getSetupCacheDiskCachePath($name)

This method is not documented.

Parameters

$name

Return

wild

private static function testTemporaryDirectory($dir)

This method is not documented.

Parameters

$dir

Return

wild

private static function addProfilerToCaches($caches)

This method is not documented.

Parameters

array

$caches

Return

wild

private static function addNamespaceToCaches($caches)

This method is not documented.

Parameters

array

$caches

Return

wild

public static function maybeDeflateData($value)

Deflate a value, if deflation is available and has an impact.

If the value is larger than 1KB, we have gzdeflate(), we successfully can deflate it, and it benefits from deflation, we deflate it. Otherwise we leave it as-is.

Data can later be inflated with inflateData().

Parameters

string

$value

String to attempt to deflate.

Return

string|null

Deflated string, or null if it was not deflated.

public static function inflateData($value)

Inflate data previously deflated by maybeDeflateData().

Parameters

string

$value

Deflated data, from @{method:maybeDeflateData}.

Return

string

Original, uncompressed data.

Defined: src/applications/cache/PhabricatorCaches.php:10

final class PhabricatorCachesPhabricator Technical Documentation (Cache)

Tasks

Request Cache

Immutable Cache

Setup Cache

Compression

Other Methods

Methods

public static function getNamespace()

private static function newStackFromCaches($caches)

public static function getRequestCache()

public static function destroyRequestCache()

public static function getImmutableCache()

private static function buildImmutableCaches()

public static function getMutableCache()

private static function buildMutableCaches()

public static function getMutableStructureCache()

private static function buildMutableStructureCaches()

public static function getRuntimeCache()

private static function buildRuntimeCaches()

public static function getRepositoryGraphL1Cache()

private static function buildRepositoryGraphL1Caches()

public static function getRepositoryGraphL2Cache()

private static function buildRepositoryGraphL2Caches()

public static function getServerStateCache()

public static function getSetupCache()

private static function buildSetupCaches($cache_name)

private static function getSetupCacheDiskCachePath($name)

private static function testTemporaryDirectory($dir)

private static function addProfilerToCaches($caches)

private static function addNamespaceToCaches($caches)

public static function maybeDeflateData($value)

public static function inflateData($value)

final class PhabricatorCaches
Phabricator Technical Documentation (Cache)