Yii框架虽不内置PWA支持，但可通过三步完整实现：1.将manifest.json置于Web根目录并手动引入；2.将sw.js放在可访问路径并显式注册（scope设为/）；3.在Nginx/Apache层拦截/sw.js请求，避免被Yii路由拦截。
Yii 框架本身不内置 PWA 支持，但可以完整实现 PWA 所需的三项核心能力：清单文件（manifest.json）、Service Worker 注册、HTTPS 下的离线缓存策略。关键不在“框架有没有”，而在你是否正确注入静态资源路径、控制响应头、并绕过 Yii 的路由拦截机制。
如何正确部署 manifest.json 并确保可被访问
Yii 默认会把所有未匹配路由的请求交给 index.php 处理，而 manifest.json 必须被 Web 服务器直接返回，不能经由 PHP 路由。否则浏览器读不到它，PWA 就不会被识别。
- 把
manifest.json放在 Web 根目录（如web/manifest.json或htdocs/manifest.json），和index.php同级 - 确认 Web 服务器配置允许直接读取 JSON 文件（Nginx 默认支持；Apache 需确保没有
Deny from all拦截.json） - 在
web/index.php或布局文件（如protected/views/layouts/main.php）中手动引入：<link rel="manifest" href="/manifest.json">
- 用浏览器访问
https://yourdomain.com/manifest.json，必须返回 200 状态码且内容为合法 JSON —— 这是验证前提
为什么 registerServiceWorker.js 不能放在 protected/ 下
Service Worker 脚本必须位于 HTTPS 协议下，且其作用域（scope）默认是脚本所在路径。如果把它放在 protected/ 目录，不仅无法被浏览器加载（该目录通常禁止 Web 访问），还会因路径权限问题导致注册失败，控制台报错 Failed to register a ServiceWorker: SecurityError。
- 必须将
sw.js或registerServiceWorker.js放在 Web 可访问路径，例如web/js/sw.js - 注册代码要写在前端 JS 中（如
web/js/app.js），且仅在支持环境下执行：if ('serviceWorker' in navigator) { navigator.serviceWorker.register('/js/sw.js').catch(console.error); } - 注意：Service Worker 的 scope 默认为
/js/，若想控制整个站点，需显式声明：navigator.serviceWorker.register('/js/sw.js', { scope: '/' })
如何让 Yii 不拦截 /sw.js 请求
Yii 的 urlManager 规则默认会尝试把所有请求（包括 /sw.js）转发给 index.php，这会导致 404 或 PHP 解析错误。必须在 Web 服务器层提前拦截，或在 Yii 入口前放行。
- Nginx 配置示例（加在 server 块内）：
location = /sw.js { add_header 'Cache-Control' 'no-cache'; try_files $uri =404; } - Apache 用户可在
web/.htaccess添加：RewriteRule ^sw\.js$ - [L]
- 不要依赖 Yii 的
urlManager.rules去“匹配” sw.js —— 它不是控制器动作，不能也不该走 MVC 流程
最容易被忽略的一点：PWA 的安装提示只会在用户第二次访问时出现，且要求页面满足「HTTPS + manifest + service worker 注册成功 + 至少一个页面被缓存」四个条件同时成立。调试时别只盯着 console，务必检查 Application → Manifest 和 Application → Service Workers 两栏是否都显示正常 —— 尤其注意 scope 是否为 /，以及 status 是否为 activated。
