Moodle PHP Documentation 4.3
Moodle 4.3.5 (Build: 20240610) (7dcfaa79f78)
|
A cache helper for administration tasks. More...
Public Member Functions | |
__construct () | |
Please do not call constructor directly. | |
action_addstore () | |
Performs the add store action. | |
action_deletelock (string $action) | |
Performs the delete lock action. | |
action_deletestore (string $action) | |
Performs the deletestore action. | |
action_editdefinitionmapping () | |
Performs the edit definition mapping action. | |
action_editdefinitionsharing () | |
Performs the edit definition sharing action. | |
action_editmodemappings () | |
Performs the edit mode mappings action. | |
action_editstore () | |
Performs the edit store action. | |
action_newlockinstance () | |
Performs the new lock instance action. | |
action_purge () | |
Performs the purge action. | |
action_purgedefinition () | |
Performs the purge definition action. | |
action_rescan_definition () | |
Performs the rescan definition action. | |
generate_admin_page (\core_cache\output\renderer $renderer) | |
Outputs the main admin page by generating it through the renderer. | |
get_add_lock_form (string $plugin, array $lockplugin=null) | |
Gets the form to use when adding a lock instance. | |
get_add_store_form (string $plugin) | |
Returns a form that can be used to add a store instance. | |
get_addable_lock_options () | |
Returns an array of lock plugins for which we can add an instance. | |
get_definition_actions (\context $context, array $definitionsummary) | |
Returns all of the actions that can be performed on a definition. | |
get_edit_store_form (string $plugin, string $store) | |
Returns a form that can be used to edit a store instance. | |
get_lock_configuration_from_data (string $plugin, stdClass $data) | |
Gets configuration data from a new lock instance form. | |
get_store_configuration_from_data (\stdClass $data) | |
Processes the results of the add/edit instance form data for a plugin returning an array of config information suitable to store in configuration. | |
get_store_instance_actions (string $name, array $storedetails) | |
Returns all of the actions that can be performed on a store. | |
get_store_plugin_actions (string $name, array $plugindetails) | |
Returns all of the actions that can be performed on a plugin. | |
get_usage (int $samplekeys) | |
Gets usage information about the whole cache system. | |
perform_cache_actions (string $action, array $forminfo) | |
Handles the page actions, based on the parameter. | |
Static Public Member Functions | |
static | clean_old_session_data ($output=false) |
Cleans old session data from cache stores used for session based definitions. | |
static | cron () |
Runs cron routines for MUC. | |
static | early_get_cache_plugins () |
Returns an array of plugins without using core methods. | |
static | get_cache_stores (cache_definition $definition) |
Returns the cache stores to be used with the given definition. | |
static | get_cachelock_for_store (cache_store $store) |
Returns a cache_lock instance suitable for use with the store. | |
static | get_class_for_mode ($mode) |
Returns the class for use as a cache loader for the given mode. | |
static | get_default_mode_stores () |
Get the default stores for all modes. | |
static | get_definition_name ($definition) |
Returns the translated name of the definition. | |
static | get_definition_sharing_options (int $sharingoption, bool $isselectedoptions=true) |
Given a sharing option hash this function returns an array of strings that can be used to describe it. | |
static | get_definition_store_options (string $component, string $area) |
Get an array of stores that are suitable to be used for a given definition. | |
static | get_definition_summaries () |
Returns an array about the definitions. | |
static | get_lock_summaries () |
Returns an array summarising the locks available in the system. | |
static | get_site_identifier () |
Returns the site identifier. | |
static | get_site_version () |
Returns the site version. | |
static | get_stats () |
Return the stats collected so far. | |
static | get_store_instance_summaries () |
Returns an array containing all of the information about stores a renderer needs. | |
static | get_store_plugin_summaries () |
Returns an array of information about plugins, everything a renderer needs. | |
static | get_stores_suitable_for_definition (cache_definition $definition) |
Returns stores suitable for use with a given definition. | |
static | get_stores_suitable_for_mode_default () |
Returns an array of stores that would meet the requirements for every definition. | |
static | hash_key ($key, cache_definition $definition) |
Hashes a descriptive key to make it shorter and still unique. | |
static | invalidate_by_definition ($component, $area, array $identifiers=array(), $keys=array()) |
Invalidates a given set of keys from a given definition. | |
static | invalidate_by_event ($event, array $keys) |
Invalidates a given set of keys by means of an event. | |
static | purge_all ($usewriter=false) |
Purge all of the cache stores of all of their data. | |
static | purge_by_definition ($component, $area, array $identifiers=array()) |
Purges the cache for a specific definition. | |
static | purge_by_event ($event) |
Purges a cache of all information on a given event. | |
static | purge_store ($storename, cache_config $config=null) |
Purges a store given its name. | |
static | purge_stores_used_by_definition ($component, $area) |
Purges all of the stores used by a definition. | |
static | ready_for_early_init () |
Returns true if the cache API can be initialised before Moodle has finished initialising itself. | |
static | record_cache_hit ($store, $definition, int $hits=1, int $readbytes=cache_store::IO_BYTES_NOT_SUPPORTED) |
Record a cache hit in the stats for the given store and definition. | |
static | record_cache_miss ($store, $definition, $misses=1) |
Record a cache miss in the stats for the given store and definition. | |
static | record_cache_set ($store, $definition, int $sets=1, int $writebytes=cache_store::IO_BYTES_NOT_SUPPORTED) |
Record a cache set in the stats for the given store and definition. | |
static | result_found ($value) |
A helper to determine whether a result was found. | |
static | update_definitions ($coreonly=false) |
Finds all definitions and updates them within the cache config file. | |
static | update_site_identifier ($siteidentifier) |
Update the site identifier stored by the cache API. | |
static | warnings (array $stores=null) |
Returns an array of warnings from the cache API. | |
Protected Member Functions | |
get_possible_locks_for_stores (string $plugindir, string $plugin) | |
Returns an array of suitable lock instances for use with this plugin, or false if the plugin handles locking itself. | |
Static Protected Member Functions | |
static | ensure_ready_for_stats ($store, $storeclass, $definition, $mode=cache_store::MODE_APPLICATION) |
Ensure that the stats array is ready to collect information for the given store and definition. | |
static | get_definition_stat_id_and_mode ($definition) |
Returns a string to describe the definition. | |
static | initialise_cachestore_instances (array $stores, cache_definition $definition) |
Internal function for initialising an array of stores against a given cache definition. | |
static | instance () |
Returns an instance of the cache_helper. | |
Static Protected Attributes | |
static cache_helper | $instance |
The instance of the cache helper. | |
static string | $siteidentifier = null |
The site identifier used by the cache. | |
static array | $stats = array() |
Statistics gathered by the cache API during its operation will be used here. | |
A cache helper for administration tasks.
core_cache\local\administration_display_helper::__construct | ( | ) |
Please do not call constructor directly.
Use cache_factory\get_administration_display_helper() instead.
Reimplemented from cache_helper.
core_cache\local\administration_display_helper::action_addstore | ( | ) |
Performs the add store action.
array | an array of the form to display to the user, and the page title. |
core_cache\local\administration_display_helper::action_deletelock | ( | string | $action | ) |
Performs the delete lock action.
string | $action | the action calling this function. |
core_cache\local\administration_display_helper::action_deletestore | ( | string | $action | ) |
Performs the deletestore action.
string | $action | the action calling to this function. |
core_cache\local\administration_display_helper::action_editdefinitionmapping | ( | ) |
Performs the edit definition mapping action.
array | an array of the form to display, and the page title. |
cache_exception |
core_cache\local\administration_display_helper::action_editdefinitionsharing | ( | ) |
Performs the edit definition sharing action.
array | an array of the edit definition sharing form, and the page title. |
core_cache\local\administration_display_helper::action_editmodemappings | ( | ) |
Performs the edit mode mappings action.
array | an array of the edit mode mappings form. |
core_cache\local\administration_display_helper::action_editstore | ( | ) |
Performs the edit store action.
array | an array of the form to display, and the page title. |
core_cache\local\administration_display_helper::action_newlockinstance | ( | ) |
Performs the new lock instance action.
array | An array containing the new lock instance form. |
core_cache\local\administration_display_helper::action_purge | ( | ) |
Performs the purge action.
void |
core_cache\local\administration_display_helper::action_purgedefinition | ( | ) |
Performs the purge definition action.
void |
core_cache\local\administration_display_helper::action_rescan_definition | ( | ) |
Performs the rescan definition action.
void |
|
staticinherited |
Cleans old session data from cache stores used for session based definitions.
bool | $output | If set to true output will be given. |
|
staticinherited |
Returns an array of plugins without using core methods.
This function explicitly does NOT use core functions as it will in some circumstances be called before Moodle has finished initialising. This happens when loading configuration for instance.
array |
|
staticprotectedinherited |
Ensure that the stats array is ready to collect information for the given store and definition.
string | $store | |
string | $storeclass | |
string | $definition | A string that identifies the definition. |
int | $mode | One of cache_store\MODE_*. Since 2.9. |
core_cache\local\administration_display_helper::generate_admin_page | ( | \core_cache\output\renderer | $renderer | ) |
Outputs the main admin page by generating it through the renderer.
core_cache\output\renderer | $renderer | the renderer to use to generate the page. |
string | the HTML for the admin page. |
Reimplemented from core_cache\administration_helper.
core_cache\local\administration_display_helper::get_add_lock_form | ( | string | $plugin, |
array | $lockplugin = null ) |
Gets the form to use when adding a lock instance.
string | $plugin | |
array | $lockplugin |
cache_lock_form |
coding_exception |
core_cache\local\administration_display_helper::get_add_store_form | ( | string | $plugin | ) |
Returns a form that can be used to add a store instance.
string | $plugin | The plugin to add an instance of |
cachestore_addinstance_form |
coding_exception |
core_cache\local\administration_display_helper::get_addable_lock_options | ( | ) |
Returns an array of lock plugins for which we can add an instance.
Suitable for use within an mform select element.
array |
Reimplemented from core_cache\administration_helper.
|
staticinherited |
Returns the cache stores to be used with the given definition.
cache_definition | $definition |
array |
|
staticinherited |
Returns a cache_lock instance suitable for use with the store.
cache_store | $store |
cache_lock_interface |
|
staticinherited |
Returns the class for use as a cache loader for the given mode.
int | $mode | One of cache_store\MODE_ |
string |
coding_exception |
|
staticinherited |
Get the default stores for all modes.
array | An array containing sub-arrays, one for each mode. |
core_cache\local\administration_display_helper::get_definition_actions | ( | \context | $context, |
array | $definitionsummary ) |
Returns all of the actions that can be performed on a definition.
context | $context | the system context. |
array | $definitionsummary | information about this cache, from the array returned by core_cache\administration_helper\get_definition_summaries(). Currently only 'sharingoptions' element is used. |
array | of actions. Each action is an action_url. |
Reimplemented from core_cache\administration_helper.
|
staticinherited |
Returns the translated name of the definition.
cache_definition | $definition |
lang_string |
|
staticinherited |
Given a sharing option hash this function returns an array of strings that can be used to describe it.
int | $sharingoption | The sharing option hash to get strings for. |
bool | $isselectedoptions | Set to true if the strings will be used to view the selected options. |
array | An array of lang_string's. |
|
staticprotectedinherited |
Returns a string to describe the definition.
This method supports the definition as a string due to legacy requirements. It is backwards compatible when a string is passed but is not accurate.
cache_definition | string | $definition |
string |
|
staticinherited |
Get an array of stores that are suitable to be used for a given definition.
string | $component | |
string | $area |
array | Array containing 3 elements
|
|
staticinherited |
Returns an array about the definitions.
All the information a renderer needs.
array | for each store, an array containing various information about each store. See the code below for details |
core_cache\local\administration_display_helper::get_edit_store_form | ( | string | $plugin, |
string | $store ) |
Returns a form that can be used to edit a store instance.
string | $plugin | |
string | $store |
cachestore_addinstance_form |
coding_exception |
core_cache\local\administration_display_helper::get_lock_configuration_from_data | ( | string | $plugin, |
stdClass | $data ) |
Gets configuration data from a new lock instance form.
string | $plugin | |
stdClass | $data |
array |
coding_exception |
|
staticinherited |
Returns an array summarising the locks available in the system.
array | array of lock summaries. |
|
protected |
Returns an array of suitable lock instances for use with this plugin, or false if the plugin handles locking itself.
string | $plugindir | |
string | $plugin |
array|false |
|
staticinherited |
Returns the site identifier.
string |
|
staticinherited |
Returns the site version.
string |
|
staticinherited |
Return the stats collected so far.
array |
core_cache\local\administration_display_helper::get_store_configuration_from_data | ( | \stdClass | $data | ) |
Processes the results of the add/edit instance form data for a plugin returning an array of config information suitable to store in configuration.
stdClass | $data | The mform data. |
array |
coding_exception |
core_cache\local\administration_display_helper::get_store_instance_actions | ( | string | $name, |
array | $storedetails ) |
Returns all of the actions that can be performed on a store.
string | $name | The name of the store |
array | $storedetails | information about this store, from the array returned by core_cache\administration_helper\get_store_instance_summaries(). |
array | of actions. Each action is an action_url. |
Reimplemented from core_cache\administration_helper.
|
staticinherited |
Returns an array containing all of the information about stores a renderer needs.
array |
core_cache\local\administration_display_helper::get_store_plugin_actions | ( | string | $name, |
array | $plugindetails ) |
Returns all of the actions that can be performed on a plugin.
string | $name | The name of the plugin |
array | $plugindetails | information about this store, from the array returned by core_cache\administration_helper\get_store_plugin_summaries(). |
array | of actions. Each action is an action_url. |
Reimplemented from core_cache\administration_helper.
|
staticinherited |
Returns an array of information about plugins, everything a renderer needs.
array | for each store, an array containing various information about each store. See the code below for details |
|
staticinherited |
Returns stores suitable for use with a given definition.
cache_definition | $definition |
cache_store[] |
|
staticinherited |
Returns an array of stores that would meet the requirements for every definition.
These stores would be 100% suitable to map as defaults for cache modes.
array[] | An array of stores, keys are the store names. |
core_cache\local\administration_display_helper::get_usage | ( | int | $samplekeys | ) |
Gets usage information about the whole cache system.
This is a slow function and should only be used on an admin information page.
The returned array lists all cache definitions with fields 'cacheid' and 'stores'. For each store, the following fields are available:
The storetotal field will be the same for every cache that uses the same store.
int | $samplekeys | Number of keys to sample when checking size of large caches |
array | Details of cache usage |
Reimplemented from core_cache\administration_helper.
|
staticinherited |
Hashes a descriptive key to make it shorter and still unique.
string | int | $key | |
cache_definition | $definition |
string |
|
staticprotectedinherited |
Internal function for initialising an array of stores against a given cache definition.
array | $stores | |
cache_definition | $definition |
cache_store[] |
|
staticprotectedinherited |
Returns an instance of the cache_helper.
This is designed for internal use only and acts as a static store. @staticvar null $instance
cache_helper |
|
staticinherited |
Invalidates a given set of keys from a given definition.
string | $component | |
string | $area | |
array | $identifiers | |
array | string | int | $keys |
boolean |
coding_exception |
|
staticinherited |
Invalidates a given set of keys by means of an event.
Events cannot determine what identifiers might need to be cleared. Event based purge and invalidation are only supported on caches without identifiers.
string | $event | |
array | $keys |
core_cache\local\administration_display_helper::perform_cache_actions | ( | string | $action, |
array | $forminfo ) |
Handles the page actions, based on the parameter.
string | $action | the action to handle. |
array | $forminfo | an empty array to be overridden and set. |
array | the empty or overridden forminfo array. |
Reimplemented from core_cache\administration_helper.
|
staticinherited |
Purge all of the cache stores of all of their data.
Think twice before calling this method. It will purge ALL caches regardless of whether they have been used recently or anything. This will involve full setup of the cache + the purge operation. On a site using caching heavily this WILL be painful.
bool | $usewriter | If set to true the cache_config_writer class is used. This class is special as it avoids it is still usable when caches have been disabled. Please use this option only if you really must. It's purpose is to allow the cache to be purged when it would be otherwise impossible. |
|
staticinherited |
Purges the cache for a specific definition.
string | $component | |
string | $area | |
array | $identifiers |
bool |
|
staticinherited |
Purges a cache of all information on a given event.
Events cannot determine what identifiers might need to be cleared. Event based purge and invalidation are only supported on caches without identifiers.
string | $event |
|
staticinherited |
|
staticinherited |
Purges all of the stores used by a definition.
Unlike cache_helper\purge_by_definition this purges all of the data from the stores not just the data relating to the definition. This function is useful when you must purge a definition that requires setup but you don't want to set it up.
string | $component | |
string | $area |
|
staticinherited |
Returns true if the cache API can be initialised before Moodle has finished initialising itself.
This check is essential when trying to cache the likes of configuration information. It checks to make sure that the cache configuration file has been created which allows use to set up caching when ever is required.
bool |
|
staticinherited |
Record a cache hit in the stats for the given store and definition.
In Moodle 2.9 the $definition argument changed from accepting only a string to accepting a string or a cache_definition instance. It is preferable to pass a cache definition instance.
In Moodle 3.9 the first argument changed to also accept a cache_store.
|
staticinherited |
Record a cache miss in the stats for the given store and definition.
In Moodle 2.9 the $definition argument changed from accepting only a string to accepting a string or a cache_definition instance. It is preferable to pass a cache definition instance.
In Moodle 3.9 the first argument changed to also accept a cache_store.
|
staticinherited |
Record a cache set in the stats for the given store and definition.
In Moodle 2.9 the $definition argument changed from accepting only a string to accepting a string or a cache_definition instance. It is preferable to pass a cache definition instance.
In Moodle 3.9 the first argument changed to also accept a cache_store.
|
staticinherited |
A helper to determine whether a result was found.
This has been deemed required after people have been confused by the fact that [] == false.
mixed | $value |
bool |
|
staticinherited |
Finds all definitions and updates them within the cache config file.
bool | $coreonly | If set to true only core definitions will be updated. |
|
staticinherited |
Update the site identifier stored by the cache API.
string | $siteidentifier |
string | The new site identifier. |
|
staticinherited |
Returns an array of warnings from the cache API.
The warning returned here are for things like conflicting store instance configurations etc. These get shown on the admin notifications page for example.
array | null | $stores | An array of stores to get warnings for, or null for all. |
string[] |
|
staticprotectedinherited |
The site identifier used by the cache.
Set the first time get_site_identifier is called.