ThinkPHP8 CDN加速静态资源与响应提速【优化】-ThinkPHP-PHP中文网

thinkphp8项目需通过cdn加速静态资源并配置缓存策略以解决加载慢问题：先确保资源集中于public/static/目录，再配置cdn域名、dns解析及thinkphp的cdn()或mix()函数调用，最后设置nginx缓存头并重载配置。

thinkphp8 cdn加速静态资源与响应提速【优化】

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分钟）。

配置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即可生效，无需额外注册或加载。

方法三：模板中统一调用，替换所有硬编码路径

<link rel="stylesheet" href="%7B:cdn('static/css/app.css')%7D">
<script src="%7B:cdn('static/js/main.js')%7D"></script>
<img src="%7B:cdn('static/images/logo.png')%7D">

PHP 8.5.12 RC 1

PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

启用文件哈希版本号防缓存失效

第一步：进入项目根目录，执行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。