[函数]rar_wrapper_cache_stats()函数—用法及示例

函数名称：rar_wrapper_cache_stats()

函数说明：rar_wrapper_cache_stats() 函数用于获取 RAR 文件的缓存统计信息。

适用版本：该函数在 PHP 7.2.0 及以上版本中可用。

语法：rar_wrapper_cache_stats()

返回值：该函数返回一个数组，包含以下键值对：

• "cached_files"：缓存中的文件数量
• "cached_dirs"：缓存中的目录数量
• "total_size"：缓存中所有文件和目录的总大小（以字节为单位）

示例：

<?php
// 打开 RAR 文件
$rar = rar_open('example.rar');

// 获取缓存统计信息
$cacheStats = rar_wrapper_cache_stats();

// 输出统计结果
echo "缓存中的文件数量：{$cacheStats['cached_files']}\n";
echo "缓存中的目录数量：{$cacheStats['cached_dirs']}\n";
echo "缓存中所有文件和目录的总大小：{$cacheStats['total_size']} 字节\n";

// 关闭 RAR 文件
rar_close($rar);
?>

注意事项：

• 在调用 rar_wrapper_cache_stats() 函数之前，需要先通过 rar_open() 函数打开一个 RAR 文件。
• 该函数返回的缓存统计信息是基于当前已打开的 RAR 文件的缓存，而不是全局的缓存统计信息。
• 如果没有打开任何 RAR 文件，或者无法获取缓存统计信息，函数将返回 false。
• 请确保已安装并启用了 RAR 扩展，否则无法使用该函数。