yii框架本身不内置cdn自动分发逻辑，但可通过配置assetmanager的baseurl指向cdn域名，使生成的css/js/图片url直接加载cdn资源；支持全局配置、单bundle指定、禁用自动发布等多种灵活方式实现高效cdn集成。
Yii 框架本身不内置 CDN 自动分发逻辑，但能通过 assetManager 配置 + 前端构建配合，把静态资源（CSS/JS/图片）真正指向 CDN 域名。关键不是“Yii 能不能 CDN”，而是“你有没有让 Yii 生成的 URL 走 CDN”。
配置 assetManager 的 baseUrl 指向 CDN
这是最直接、影响所有自动注册资源的方式。Yii 在生成 <link> 和 <script></script> 标签时，会用 assetManager->baseUrl 拼接资源路径。
在 config/web.php 中修改：
'components' => [
'assetManager' => [
'baseUrl' => 'https://static.example.com',
// 注意：不要加 trailing slash，Yii 会自动拼接
'bundles' => [
'yii\web\YiiAsset' => [
'js' => ['js/yii.js'],
],
],
],
],
这样 YiiAsset::register() 就会输出：<script src="https://static.example.com/js/yii.js"></script>。
常见错误现象：
-
baseUrl写成https://static.example.com/（末尾斜杠）→ 可能导致路径重复，如https://static.example.com//css/site.css - 没清空
@web/assets目录或浏览器缓存 → 旧资源 URL 仍被加载 - CDN 域名未配置 HTTPS 或证书不匹配 → 浏览器拦截混合内容（Mixed Content）
按页面拆分资源包并单独指定 CDN 路径
当首页、后台、结账页用的 JS/CSS 完全不同时，硬塞进一个 baseUrl 反而低效。这时应为每个 AssetBundle 单独控制发布路径。
例如定义 app\assets\CheckoutAsset：
class CheckoutAsset extends AssetBundle
{
public $sourcePath = '@app/resources/checkout';
public $baseUrl = 'https://static.example.com/checkout';
public $js = ['main.js'];
public $css = ['style.css'];
}
这样它就和全局 assetManager->baseUrl 解耦，可对接不同 CDN 子路径或甚至不同服务商（比如结账资源走阿里云 CDN，图片走腾讯云 COS）。
使用场景：
- 多套前端构建产物（如 Admin 是 Vue SPA，前台是 Twig 渲染）需要隔离资源域名
- 第三方库（如
jquery.min.js）想直接引用公共 CDN（https://cdn.jsdelivr.net/npm/jquery@3.7.1），可在$js中写完整 URL - 某些资源需带版本号或 hash（如
app.a1b2c3.js），靠baseUrl不够灵活，得靠构建工具生成后手动设$js
避免 assetManager 自动生成本地发布目录
默认情况下，Yii 会把 sourcePath 下的文件复制到 @web/assets/xxx/ 并生成哈希目录。如果你已用 Webpack/Vite 构建好全部静态资源并上传到 CDN，这个步骤纯属冗余，还可能因权限问题失败。
关闭自动发布：
'components' => [
'assetManager' => [
'forceCopy' => false,
'linkAssets' => true, // 推荐：用符号链接代替复制（需服务器支持）
'publishCallback' => function ($asset) {
return false; // 彻底禁用发布，强制走 baseUrl
},
],
],
为什么这样做：
-
forceCopy => false防止每次请求都尝试复制（尤其在容器或只读文件系统中报错） -
linkAssets => true在开发环境更省空间，但生产环境通常不用——因为你根本不想让 Yii 碰本地静态文件 -
publishCallback => false是最彻底的方案，适合完全由构建流程管控资源的项目
容易踩的坑：
- 设了
publishCallback => false却忘了配baseUrl→ 所有资源 URL 变成空或相对路径，404 - 本地开发时用了
linkAssets，但部署到 Docker 容器里没挂载对应路径 → 符号链接失效
CDN 域名必须和 Nginx / 前端构建对齐
光改 Yii 配置不够。CDN 加速生效的前提是：用户发出的 HTTP 请求，目标域名确实是你的 CDN 域名，且该域名 DNS 已 CNAME 到 CDN 提供商（如 xxx.cdn.aliyuncs.com）。
三处必须一致：
- Yii 中
baseUrl或AssetBundle->baseUrl写的是https://static.example.com - DNS 解析中，
static.example.com的记录类型是 CNAME，值为 CDN 分配的节点域名 - Nginx 配置里，
server_name static.example.com要存在，并启用expires和Cache-Control缓存头
如果其中一环断开（比如 DNS 没生效、Nginx 没监听该域名、CDN 控制台没开启“强制 HTTPS”），用户看到的仍是源站响应，CDN 形同虚设。
最容易被忽略的地方是：Yii 输出的 HTML 里资源 URL 是对的，但浏览器开发者工具 Network 面板里，那个请求的 Remote Address 显示的还是你自己的服务器 IP —— 这说明 DNS 或 CDN 接入根本没生效，别急着调 Yii 配置。
