php 8.6在单机缓存小型json结果时,可把过期时间与数据一起写入私有目录,再用同目录临时文件替换目标文件,避免读到写了一半的内容。以下是linux本地文件系统场景,不提供跨机器一致性、请求合并或缓存雪崩保护。
。图源:PHP Documentation Group(CC BY 3.0)。
PHP手册中的tempnam。图源:PHP Documentation Group(CC BY 3.0)。
读取有效缓存,未命中则生成并替换
<?php
$dir=realpath('/srv/app-private/cache');
if(!$dir||!is_writable($dir))throw new RuntimeException('缓存目录未准备');
$key='public-catalog-v1';$path=$dir.'/'.hash('sha256',$key).'.json';$hit=false;$value=null;
if(is_file($path)){
$raw=file_get_contents($path,false,null,0,131073);
if(is_string($raw)&&strlen($raw)<=131072){
try{$box=json_decode($raw,true,32,JSON_THROW_ON_ERROR);
if(is_array($box)&&is_int($box['expires_at']??null)&&$box['expires_at']>time()&&array_key_exists('data',$box)){
$value=$box['data'];$hit=true;
}
}catch(JsonException $e){/* 损坏缓存作为未命中处理。 */}
}
}
if(!$hit){
$value=['items'=>[['id'=>101,'name'=>'示例']]]; // 替换成有权限边界的真实计算。
$payload=json_encode(['expires_at'=>time()+60,'data'=>$value],JSON_THROW_ON_ERROR);
if(strlen($payload)>131072)throw new RuntimeException('缓存结果过大');
$tmp=tempnam($dir,'cache-');
if($tmp===false)throw new RuntimeException('临时文件失败');
try{
if(dirname($tmp)!==$dir)throw new RuntimeException('临时文件目录偏离');
if(file_put_contents($tmp,$payload)!==strlen($payload))throw new RuntimeException('写入不完整');
if(!rename($tmp,$path))throw new RuntimeException('替换失败');
}finally{if(is_file($tmp))unlink($tmp);}
}
echo json_encode($value,JSON_THROW_ON_ERROR|JSON_UNESCAPED_UNICODE);
。图源:PHP Documentation Group(CC BY 3.0)。
PHP手册中的rename。图源:PHP Documentation Group(CC BY 3.0)。
把私有与公共数据分开
示例缓存公共目录;账号、租户、语言等会改变结果时,必须纳入缓存键,避免把A用户结果交给B用户。目录仅允许应用账号写入,不能接收客户端文件路径。tempnam回退到系统临时目录时直接拒绝,保证同目录替换的前提。
exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。
明确竞争和失效语义
并发未命中可能重复计算并由最后写入者覆盖,因此生成过程必须可重复且没有业务副作用。过期文件不会在读取时自动删除,应按固定目录、归属和过期规则另行回收;不要对混合业务目录泛化清理。网络文件系统和Windows覆盖行为需要按部署环境重新验证,不能据此承诺通用原子更新。


















