diff options
Diffstat (limited to 'vendor/thecodingmachine/safe/deprecated/apc.php')
-rw-r--r-- | vendor/thecodingmachine/safe/deprecated/apc.php | 238 |
1 files changed, 238 insertions, 0 deletions
diff --git a/vendor/thecodingmachine/safe/deprecated/apc.php b/vendor/thecodingmachine/safe/deprecated/apc.php new file mode 100644 index 000000000..7930432c6 --- /dev/null +++ b/vendor/thecodingmachine/safe/deprecated/apc.php @@ -0,0 +1,238 @@ +<?php + +namespace Safe; + +use Safe\Exceptions\ApcException; + +/** + * Retrieves cached information and meta-data from APC's data store. + * + * @param string $cache_type If cache_type is "user", + * information about the user cache will be returned. + * + * If cache_type is "filehits", + * information about which files have been served from the bytecode cache + * for the current request will be returned. This feature must be enabled at + * compile time using --enable-filehits. + * + * If an invalid or no cache_type is specified, information about + * the system cache (cached files) will be returned. + * @param bool $limited If limited is TRUE, the + * return value will exclude the individual list of cache entries. This + * is useful when trying to optimize calls for statistics gathering. + * @return array Array of cached data (and meta-data) + * @throws ApcException + * + */ +function apc_cache_info(string $cache_type = '', bool $limited = false): array +{ + error_clear_last(); + $result = \apc_cache_info($cache_type, $limited); + if ($result === false) { + throw ApcException::createFromPhpError(); + } + return $result; +} + + +/** + * apc_cas updates an already existing integer value if the + * old parameter matches the currently stored value + * with the value of the new parameter. + * + * @param string $key The key of the value being updated. + * @param int $old The old value (the value currently stored). + * @param int $new The new value to update to. + * @throws ApcException + * + */ +function apc_cas(string $key, int $old, int $new): void +{ + error_clear_last(); + $result = \apc_cas($key, $old, $new); + if ($result === false) { + throw ApcException::createFromPhpError(); + } +} + + +/** + * Stores a file in the bytecode cache, bypassing all filters. + * + * @param string $filename Full or relative path to a PHP file that will be compiled and stored in + * the bytecode cache. + * @param bool $atomic + * @return mixed Returns TRUE on success. + * @throws ApcException + * + */ +function apc_compile_file(string $filename, bool $atomic = true) +{ + error_clear_last(); + $result = \apc_compile_file($filename, $atomic); + if ($result === false) { + throw ApcException::createFromPhpError(); + } + return $result; +} + + +/** + * Decreases a stored integer value. + * + * @param string $key The key of the value being decreased. + * @param int $step The step, or value to decrease. + * @param bool|null $success Optionally pass the success or fail boolean value to + * this referenced variable. + * @return int Returns the current value of key's value on success + * @throws ApcException + * + */ +function apc_dec(string $key, int $step = 1, ?bool &$success = null): int +{ + error_clear_last(); + $result = \apc_dec($key, $step, $success); + if ($result === false) { + throw ApcException::createFromPhpError(); + } + return $result; +} + + +/** + * define is notoriously slow. Since the main benefit of + * APC is to increase the performance of scripts/applications, this mechanism + * is provided to streamline the process of mass constant definition. However, + * this function does not perform as well as anticipated. + * + * For a better-performing solution, try the + * hidef extension from PECL. + * + * @param string $key The key serves as the name of the constant set + * being stored. This key is used to retrieve the + * stored constants in apc_load_constants. + * @param array $constants An associative array of constant_name => value + * pairs. The constant_name must follow the normal + * constant naming rules. + * value must evaluate to a scalar value. + * @param bool $case_sensitive The default behaviour for constants is to be declared case-sensitive; + * i.e. CONSTANT and Constant + * represent different values. If this parameter evaluates to FALSE the + * constants will be declared as case-insensitive symbols. + * @throws ApcException + * + */ +function apc_define_constants(string $key, array $constants, bool $case_sensitive = true): void +{ + error_clear_last(); + $result = \apc_define_constants($key, $constants, $case_sensitive); + if ($result === false) { + throw ApcException::createFromPhpError(); + } +} + + +/** + * Deletes the given files from the opcode cache. + * + * @param mixed $keys The files to be deleted. Accepts a string, + * array of strings, or an APCIterator + * object. + * @return mixed Returns TRUE on success. + * Or if keys is an array, then + * an empty array is returned on success, or an array of failed files + * is returned. + * @throws ApcException + * + */ +function apc_delete_file($keys) +{ + error_clear_last(); + $result = \apc_delete_file($keys); + if ($result === false) { + throw ApcException::createFromPhpError(); + } + return $result; +} + + +/** + * Removes a stored variable from the cache. + * + * @param string|string[]|\APCIterator $key The key used to store the value (with + * apc_store). + * @throws ApcException + * + */ +function apc_delete($key): void +{ + error_clear_last(); + $result = \apc_delete($key); + if ($result === false) { + throw ApcException::createFromPhpError(); + } +} + + +/** + * Increases a stored number. + * + * @param string $key The key of the value being increased. + * @param int $step The step, or value to increase. + * @param bool|null $success Optionally pass the success or fail boolean value to + * this referenced variable. + * @return int Returns the current value of key's value on success + * @throws ApcException + * + */ +function apc_inc(string $key, int $step = 1, ?bool &$success = null): int +{ + error_clear_last(); + $result = \apc_inc($key, $step, $success); + if ($result === false) { + throw ApcException::createFromPhpError(); + } + return $result; +} + + +/** + * Loads a set of constants from the cache. + * + * @param string $key The name of the constant set (that was stored with + * apc_define_constants) to be retrieved. + * @param bool $case_sensitive The default behaviour for constants is to be declared case-sensitive; + * i.e. CONSTANT and Constant + * represent different values. If this parameter evaluates to FALSE the + * constants will be declared as case-insensitive symbols. + * @throws ApcException + * + */ +function apc_load_constants(string $key, bool $case_sensitive = true): void +{ + error_clear_last(); + $result = \apc_load_constants($key, $case_sensitive); + if ($result === false) { + throw ApcException::createFromPhpError(); + } +} + + +/** + * Retrieves APC's Shared Memory Allocation information. + * + * @param bool $limited When set to FALSE (default) apc_sma_info will + * return a detailed information about each segment. + * @return array Array of Shared Memory Allocation data; FALSE on failure. + * @throws ApcException + * + */ +function apc_sma_info(bool $limited = false): array +{ + error_clear_last(); + $result = \apc_sma_info($limited); + if ($result === false) { + throw ApcException::createFromPhpError(); + } + return $result; +} |