api实现

This commit is contained in:
Developer
2026-04-09 08:54:36 +08:00
parent 2eaf317705
commit 8d27c67d3a
319 changed files with 70169 additions and 4677 deletions

304
docs/api/cache.php Normal file
View File

@@ -0,0 +1,304 @@
<?php
/**
* 🚀 API缓存系统
*
* 支持文件缓存,自动清理过期缓存
* 优化多人多次请求性能
*/
class ApiCache {
private static $cacheDir = null;
private static $defaultTTL = 300;
private static $ttlConfig = array(
'list' => 300,
'detail' => 600,
'full' => 600,
'ingredients' => 600,
'ingredient_detail' => 1200,
'search' => 180,
'categories' => 1800,
'tags' => 1800,
'stats' => 120,
'stats_full' => 120,
'hot' => 300,
'query' => 180,
'filter' => 180,
'like' => 0,
'recommend' => 0,
'view' => 0
);
public static function init() {
if (self::$cacheDir === null) {
self::$cacheDir = dirname(__FILE__) . '/cache/';
if (!is_dir(self::$cacheDir)) {
@mkdir(self::$cacheDir, 0755, true);
}
}
}
public static function getTTL($act) {
return isset(self::$ttlConfig[$act]) ? self::$ttlConfig[$act] : self::$defaultTTL;
}
public static function getCacheKey($act, $params = array()) {
ksort($params);
$paramStr = http_build_query($params);
return md5($act . '_' . $paramStr);
}
public static function get($act, $params = array()) {
self::init();
$ttl = isset(self::$ttlConfig[$act]) ? self::$ttlConfig[$act] : self::$defaultTTL;
if ($ttl <= 0) {
return null;
}
$key = self::getCacheKey($act, $params);
$file = self::$cacheDir . $key . '.json';
if (!file_exists($file)) {
return null;
}
$content = file_get_contents($file);
$data = json_decode($content, true);
if (!$data || !isset($data['expire']) || !isset($data['data'])) {
@unlink($file);
return null;
}
if (time() > $data['expire']) {
@unlink($file);
return null;
}
return $data['data'];
}
public static function getStale($act, $params = array()) {
self::init();
$key = self::getCacheKey($act, $params);
$file = self::$cacheDir . $key . '.json';
if (!file_exists($file)) {
return null;
}
$content = @file_get_contents($file);
if ($content === false) {
return null;
}
$data = json_decode($content, true);
if (!$data || !isset($data['data'])) {
return null;
}
return $data['data'];
}
public static function isExpired($act, $params = array()) {
self::init();
$key = self::getCacheKey($act, $params);
$file = self::$cacheDir . $key . '.json';
if (!file_exists($file)) {
return true;
}
$content = @file_get_contents($file);
if ($content === false) {
return true;
}
$data = json_decode($content, true);
if (!$data || !isset($data['expire'])) {
return true;
}
return time() > $data['expire'];
}
public static function getCacheAge($act, $params = array()) {
self::init();
$key = self::getCacheKey($act, $params);
$file = self::$cacheDir . $key . '.json';
if (!file_exists($file)) {
return -1;
}
$content = @file_get_contents($file);
if ($content === false) {
return -1;
}
$data = json_decode($content, true);
if (!$data || !isset($data['created'])) {
return -1;
}
return time() - $data['created'];
}
public static function set($act, $params, $data) {
self::init();
$ttl = isset(self::$ttlConfig[$act]) ? self::$ttlConfig[$act] : self::$defaultTTL;
if ($ttl <= 0) {
return false;
}
$key = self::getCacheKey($act, $params);
$file = self::$cacheDir . $key . '.json';
$cacheData = array(
'act' => $act,
'params' => $params,
'data' => $data,
'expire' => time() + $ttl,
'created' => time()
);
return file_put_contents($file, json_encode($cacheData, JSON_UNESCAPED_UNICODE)) !== false;
}
public static function clear($act = null, $params = array()) {
self::init();
if ($act === null) {
$files = glob(self::$cacheDir . '*.json');
foreach ($files as $file) {
@unlink($file);
}
return true;
}
$key = self::getCacheKey($act, $params);
$file = self::$cacheDir . $key . '.json';
if (file_exists($file)) {
@unlink($file);
}
return true;
}
public static function clearByAct($act) {
self::init();
$files = glob(self::$cacheDir . '*.json');
$count = 0;
foreach ($files as $file) {
$content = file_get_contents($file);
$data = json_decode($content, true);
if ($data && isset($data['act']) && $data['act'] === $act) {
@unlink($file);
$count++;
}
}
return $count;
}
public static function cleanExpired() {
self::init();
$files = glob(self::$cacheDir . '*.json');
$count = 0;
$now = time();
foreach ($files as $file) {
$content = @file_get_contents($file);
if ($content === false) {
@unlink($file);
$count++;
continue;
}
$data = json_decode($content, true);
if (!$data || !isset($data['expire']) || $now > $data['expire']) {
@unlink($file);
$count++;
}
}
return $count;
}
public static function getStats() {
self::init();
$files = glob(self::$cacheDir . '*.json');
$totalSize = 0;
$count = 0;
$oldest = time();
$newest = 0;
foreach ($files as $file) {
$count++;
$totalSize += filesize($file);
$content = file_get_contents($file);
$data = json_decode($content, true);
if ($data && isset($data['created'])) {
$oldest = min($oldest, $data['created']);
$newest = max($newest, $data['created']);
}
}
return array(
'count' => $count,
'total_size' => $totalSize,
'total_size_readable' => self::formatBytes($totalSize),
'oldest' => $oldest > 0 ? date('Y-m-d H:i:s', $oldest) : '-',
'newest' => $newest > 0 ? date('Y-m-d H:i:s', $newest) : '-'
);
}
private static function formatBytes($bytes) {
if ($bytes >= 1073741824) {
return number_format($bytes / 1073741824, 2) . ' GB';
} elseif ($bytes >= 1048576) {
return number_format($bytes / 1048576, 2) . ' MB';
} elseif ($bytes >= 1024) {
return number_format($bytes / 1024, 2) . ' KB';
} else {
return $bytes . ' bytes';
}
}
}
if (php_sapi_name() === 'cli' && isset($argv[0]) && basename($argv[0]) === 'cache.php') {
$action = $argv[1] ?? 'stats';
switch ($action) {
case 'clean':
$count = ApiCache::cleanExpired();
echo "Cleaned {$count} expired cache files.\n";
break;
case 'clear':
ApiCache::clear();
echo "All cache cleared.\n";
break;
case 'stats':
default:
$stats = ApiCache::getStats();
echo "Cache Statistics:\n";
echo " Files: {$stats['count']}\n";
echo " Size: {$stats['total_size_readable']}\n";
echo " Oldest: {$stats['oldest']}\n";
echo " Newest: {$stats['newest']}\n";
break;
}
}