pre_recurse_dirsize
Filters the amount of storage space used by one directory and all its children, in megabytes.
Return the actual used space to short-circuit the recursive PHP file size calculation and use something else, like a CDN API or native operating system tools for better performance.
Usage
add_filter( 'pre_recurse_dirsize', 'wp_kama_pre_recurse_dirsize_filter', 10, 5 ); /** * Function for `pre_recurse_dirsize` filter-hook. * * @param int|false $space_used The amount of used space, in bytes. * @param string $directory Full path of a directory. * @param string|string[]|null $exclude Full path of a subdirectory to exclude from the total, or array of paths. * @param int $max_execution_time Maximum time to run before giving up. In seconds. * @param array $directory_cache Array of cached directory paths. * * @return int|false */ function wp_kama_pre_recurse_dirsize_filter( $space_used, $directory, $exclude, $max_execution_time, $directory_cache ){ // filter... return $space_used; }
- $space_used(int|false)
- The amount of used space, in bytes.
Default: false - $directory(string)
- Full path of a directory.
- $exclude(string|string[]|null)
- Full path of a subdirectory to exclude from the total, or array of paths.
- $max_execution_time(int)
- Maximum time to run before giving up. In seconds.
- $directory_cache(array)
- Array of cached directory paths.
Changelog
Since 5.6.0 | Introduced. |
Where the hook is called
pre_recurse_dirsize
wp-includes/functions.php 8702
$size = apply_filters( 'pre_recurse_dirsize', false, $directory, $exclude, $max_execution_time, $directory_cache );