ThinkPHP8项目需通过CDN加速静态资源并配置缓存策略以解决加载慢问题：先确保资源集中于public/static/目录，再配置CDN域名、DNS解析及ThinkPHP的cdn()或mix()函数调用，最后设置Nginx缓存头并重载配置。
ThinkPHP8项目上线后用户加载CSS和JS总卡在3秒以上，首页白屏时间长、字体渲染延迟、图片加载缓慢，根本原因是静态资源仍从源站直连下载，未走CDN边缘节点分发，且浏览器缓存策略缺失导致重复请求体积过大。
确认CDN接入前提条件
第一步：检查你的静态资源是否已集中存放于public/static/目录下。若CSS放在app/或runtime/里，CDN回源时会404，无法拉取任何文件。
第二步：登录CDN服务商控制台（如腾讯云CDN），添加加速域名static.yoursite.com，并设置回源地址为你的主站域名（如www.yoursite.com）。【必须启用“强制HTTPS回源”】，否则HTTP请求可能被拒绝或跳转失败。
第三步：在DNS解析平台为static.yoursite.com添加CNAME记录，指向CDN分配的CNAME地址（如static.yoursite.com.cdn.dnsv1.com），等待生效（通常5–30分钟）。
立即学习“PHP免费学习笔记（深入）”；
配置ThinkPHP8 CDN资源路径
方法一：在config/app.php中新增CDN配置项
'cdn' => ['enable' => true, 'domain' => 'https://static.yoursite.com'],
方法二：封装全局资源函数，在app/common.php中定义
function cdn($path) { $cdn = config('cdn'); return $cdn['enable'] ? $cdn['domain'] . '/' . ltrim($path, '/') : '/' . ltrim($path, '/'); }
这一步操作起来很简单，直接把函数粘贴进common.php即可生效，无需额外注册或加载。
方法三：模板中统一调用，替换所有硬编码路径
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
<link rel="stylesheet" href="{:cdn('static/css/app.css')}"><script src="{:cdn('static/js/main.js')}"></script><img src="{:cdn('static/images/logo.png')}">
启用文件哈希版本号防缓存失效
第一步：进入项目根目录，执行Mix构建命令
php think build:assets
该命令会扫描public/static/下的js、css文件，生成带内容哈希的新文件名（如app.7f3a9b2e.js），并更新public/mix-manifest.json映射关系。
第二步：在模板中改用{:mix('static/js/app.js')}替代{:cdn('static/js/app.js')}
mix()函数会自动查manifest文件，输出真实哈希路径。不这么做，用户永远加载旧文件——浏览器认不出你改了内容，因为URL没变。
第三步：确保Nginx location块中try_files $uri /index.php?$query_string;已移除，改为try_files $uri =404;，避免哈希文件被框架路由劫持返回404。
设置Nginx静态资源缓存头
编辑/etc/nginx/conf.d/your-site.conf，在server块内插入以下配置：
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf|eot|webp|pdf)$ {<br>
expires 1y;<br>
add_header Cache-Control "public, immutable";<br>
add_header X-Content-Type-Options nosniff;<br>
try_files $uri =404;<br>
}
注意：这段配置必须放在所有location ~ \.php$规则之前，否则PHP-FPM会先接管请求，缓存头根本不会生效。
执行nginx -t && nginx -s reload重载配置，然后用curl验证响应头：curl -I https://static.yoursite.com/static/css/app.css，确认返回Cache-Control: public, immutable。
