Xiuno BBS 缓存系统详解
<![CDATA[# Xiuno BBS 缓存系统详解
> 本文使用人工智能编写。
## 1. 缓存系统架构
Xiuno BBS 采用多层缓存架构，主要包括以下几个部分：
### 1.1 核心缓存函数
- **cache_get($k, $c = NULL)**：获取缓存数据
- **cache_set($k, $v, $life = 0, $c = NULL)**：设置缓存数据
- **cache_delete($k, $c = NULL)**：删除缓存数据
- **cache_truncate($c = NULL)**：清空所有缓存
### 1.2 缓存实现类
Xiuno BBS 支持多种缓存类型，每种类型都有对应的实现类：
- `cache_mysql.class.php`：MySQL 缓存实现
- `cache_memcached.class.php`：Memcached 缓存实现
- `cache_redis.class.php`：Redis 缓存实现
- `cache_apc.class.php`：APC 缓存实现
- `cache_xcache.class.php`：XCache 缓存实现
- `cache_yac.class.php`：Yac 缓存实现
### 1.3 键值存储功能
- **kv_get($k)**：获取键值数据
- **kv_set($k, $v, $life = 0)**：设置键值数据
- **kv_delete($k)**：删除键值数据
- **kv_cache_get($k)**：带缓存的键值获取
- **kv_cache_set($k, $v, $life = 0)**：带缓存的键值设置
- **kv_cache_delete($k)**：带缓存的键值删除
### 1.4 运行时数据处理
- **runtime_init()**：初始化运行时数据
- **runtime_get($k)**：获取运行时数据
- **runtime_set($k, $v)**：设置运行时数据
- **runtime_delete($k)**：删除运行时数据
- **runtime_save()**：保存运行时数据
- **runtime_truncate()**：清空运行时数据
## 2. 缓存类型配置
### 2.1 MySQL 缓存
**配置示例**：
```php
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'mysql';
$conf['cache']['mysql'] = array(
'db' => $db, // 可选，复用全局数据库连接
'table' => 'cache', // 缓存表名
'cachepre' => 'pre_' // 缓存键前缀
);
```
**特点**：
- 基于数据库表存储，适合小站点
- 不需要额外服务
- 性能相对较低
### 2.2 Memcached 缓存
**配置示例**：
```php
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'memcached';
$conf['cache']['memcached'] = array(
'host' => '127.0.0.1', // Memcached 服务器地址
'port' => 11211, // Memcached 服务器端口
'cachepre' => 'pre_' // 缓存键前缀
);
```
**特点**：
- 需要安装 Memcache 或 Memcached 扩展
- 性能较高
- 适合中大型站点
### 2.3 Redis 缓存
**配置示例**：
```php
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'redis';
$conf['cache']['redis'] = array(
'host' => '127.0.0.1', // Redis 服务器地址
'port' => 6379, // Redis 服务器端口
'cachepre' => 'pre_' // 缓存键前缀
);
```
**特点**：
- 需要安装 Redis 扩展
- 性能优异
- 支持更多数据结构
- 适合大型站点
### 2.4 APC 缓存
**配置示例**：
```php
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'apc';
$conf['cache']['apc'] = array(
'cachepre' => 'pre_' // 缓存键前缀
);
```
**特点**：
- 需要安装 APC 扩展
- 基于内存，性能高
- 适合单机部署
### 2.5 XCache 缓存
**配置示例**：
```php
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'xcache';
$conf['cache']['xcache'] = array(
'cachepre' => 'pre_' // 缓存键前缀
);
```
**特点**：
- 需要安装 XCache 扩展
- 基于内存，性能高
- 注意：XCache 3.1 版本的 life 参数可能不生效
### 2.6 Yac 缓存
**配置示例**：
```php
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'yac';
$conf['cache']['yac'] = array(
'cachepre' => 'pre_' // 缓存键前缀
);
```
**特点**：
- 需要安装 Yac 扩展
- 基于内存，性能高
- 适合单机部署
## 3. 核心缓存函数使用
### 3.1 cache_get()
**函数签名**：
```php
function cache_get($k, $c = NULL)
```
**参数**：
- `$k`：缓存键名
- `$c`：缓存实例（可选，默认使用全局缓存实例）
**返回值**：
- 缓存的数据，如果不存在则返回 NULL
**使用示例**：
```php
// 获取缓存数据
$user_count = cache_get('user_count');
if ($user_count === NULL) {
// 缓存不存在，从数据库获取
$user_count = user_count();
// 设置缓存
cache_set('user_count', $user_count, 3600); // 1小时过期
}
```
### 3.2 cache_set()
**函数签名**：
```php
function cache_set($k, $v, $life = 0, $c = NULL)
```
**参数**：
- `$k`：缓存键名
- `$v`：缓存数据
- `$life`：过期时间（秒），0 表示永不过期
- `$c`：缓存实例（可选，默认使用全局缓存实例）
**返回值**：
- 成功返回 TRUE，失败返回 FALSE
**使用示例**：
```php
// 设置缓存，1小时过期
cache_set('user_count', $user_count, 3600);
// 设置永不过期的缓存
cache_set('site_config', $config);
```
### 3.3 cache_delete()
**函数签名**：
```php
function cache_delete($k, $c = NULL)
```
**参数**：
- `$k`：缓存键名
- `$c`：缓存实例（可选，默认使用全局缓存实例）
**返回值**：
- 成功返回 TRUE，失败返回 FALSE
**使用示例**：
```php
// 删除缓存
cache_delete('user_count');
```
## 4. 运行时数据处理
### 4.1 runtime_init()
**函数签名**：
```php
function runtime_init()
```
**功能**：
- 初始化运行时数据，从缓存中获取，如果不存在则重新计算
- 主要初始化站点统计数据，如用户数、帖子数、主题数等
**返回值**：
- 运行时数据数组
**使用示例**：
```php
// 在入口文件中初始化运行时数据
$runtime = runtime_init();
```
### 4.2 runtime_get()
**函数签名**：
```php
function runtime_get($k)
```
**参数**：
- `$k`：运行时数据键名
**返回值**：
- 运行时数据，如果不存在则返回 NULL
**使用示例**：
```php
// 获取在线用户数
$onlines = runtime_get('onlines');
// 获取今日发帖数
$todayposts = runtime_get('todayposts');
```
### 4.3 runtime_set()
**函数签名**：
```php
function runtime_set($k, $v)
```
**参数**：
- `$k`：运行时数据键名
- `$v`：运行时数据值
**功能**：
- 设置运行时数据
- 支持增量操作，如 `runtime_set('posts+', 1)` 表示帖子数加 1
**返回值**：
- 始终返回 TRUE
**使用示例**：
```php
// 增加帖子数
runtime_set('posts+', 1);
// 增加今日发帖数
runtime_set('todayposts+', 1);
// 设置具体值
runtime_set('onlines', 100);
```
### 4.4 运行时数据自动保存
Xiuno BBS 在脚本结束时会自动保存运行时数据：
```php
register_shutdown_function('runtime_save');
```
这确保了运行时数据的修改能够被持久化到缓存中。
## 5. 缓存清理策略
### 5.1 自动过期
- **MySQL 缓存**：通过 `expiry` 字段控制，获取时检查是否过期
- **Memcached/Redis**：利用服务端的过期机制
- **APC/XCache/Yac**：利用扩展的过期机制
### 5.2 手动清理
- **cache_delete()**：删除指定缓存
- **runtime_delete()**：删除指定运行时数据
- **kv_delete()**：删除指定键值数据
### 5.3 定期清理
- **runtime_truncate()**：清空运行时数据
- **cache_truncate()**：清空所有缓存
- **cron 任务**：系统会定期重置今日统计数据
### 5.4 缓存键管理
- 键名长度超过 32 字符时会自动使用 md5 加密
- 所有缓存键都会添加配置的前缀，避免冲突
## 6. 缓存系统最佳实践
### 6.1 缓存类型选择
- **小站点**：MySQL 缓存
- **中大型站点**：Memcached 或 Redis
- **单机高性能**：APC、XCache 或 Yac
### 6.2 缓存使用建议
1. **合理设置过期时间**：根据数据更新频率设置合适的过期时间
2. **缓存热点数据**：优先缓存访问频率高的数据
3. **避免缓存大数据**：缓存过大的数据会影响性能
4. **及时清理无效缓存**：数据更新后及时删除相关缓存
5. **监控缓存命中率**：根据实际情况调整缓存策略
### 6.3 故障处理
- **缓存服务不可用**：系统会自动降级，不影响基本功能
- **缓存数据不一致**：可以通过 `cache_truncate()` 清空缓存重新生成
- **内存不足**：对于内存型缓存，注意监控内存使用情况
## 7. 代码示例
### 7.1 配置缓存
```php
// 配置 Redis 缓存
$conf['cache']['enable'] = 1;
$conf['cache']['type'] = 'redis';
$conf['cache']['redis'] = array(
'host' => '127.0.0.1',
'port' => 6379,
'cachepre' => 'xiuno_'
);
// 初始化缓存
$cache = cache_new($conf['cache']);
$_SERVER['cache'] = $cache;
```
### 7.2 使用缓存
```php
// 缓存用户列表
$users = cache_get('users_list');
if ($users === NULL) {
$users = db_find('user', array(), array('uid' => -1), array(0, 20));
cache_set('users_list', $users, 600); // 10分钟过期
}
// 更新用户数后清理缓存
user_create($user_data);
runtime_set('users+', 1);
cache_delete('users_list');
```
### 7.3 使用键值存储
```php
// 存储站点配置
kv_set('site_config', $config);
// 获取站点配置
$config = kv_get('site_config');
// 使用带缓存的键值存储
kv_cache_set('site_config', $config);
$config = kv_cache_get('site_config');
```
## 8. 总结
Xiuno BBS 的缓存系统设计灵活，支持多种缓存类型，可以根据不同的服务器环境和站点规模选择合适的缓存方案。通过合理使用缓存，可以显著提高站点性能，减轻数据库负担。
缓存系统的核心是多层缓存架构，包括：
- **底层缓存**：由各种缓存实现类提供
- **中间层**：核心缓存函数和键值存储
- **上层应用**：运行时数据和业务逻辑
通过理解和掌握这些缓存机制，可以更好地优化 Xiuno BBS 的性能，为用户提供更流畅的访问体验。]]>