海洋 CMS 后台模板管理找不到新模板是什么原因

海洋CMS 后台「模板管理」里看不到刚上传的新模板，最直接的原因是模板目录层级不对——模板文件夹没有直接放在网站根目录的 template/ 下，而是被解压工具多套了一层；其次才是站点根目录搞错、权限属主不对、文件夹命名不规范和缓存没刷新这四类问题。按「层级 → 根目录 → 权限 → 命名 → 缓存」的顺序排查，能一项项定位到具体原因。

海洋CMS 的模板应该放在哪个目录？

结论：海洋CMS 的模板目录固定为网站根目录下的 /template/，每个模板占用一个一级子文件夹，后台模板管理读取的就是这一层文件夹的列表。

正确结构长这样：

网站根目录/
└── template/
    ├── default/          ← 模板名文件夹
    │   ├── index.htm     首页模板
    │   ├── list.htm      列表页模板
    │   ├── content.htm   内容页模板
    │   └── ...
    └── mytheme/          ← 新模板，与 default 同级

错误结构（后台永远扫不到）：

template/mytheme_v1/mytheme/   ← 多了一层 mytheme_v1

用宝塔面板在线解压 zip 模板包时，默认会在当前目录下再建一个与压缩包同名的文件夹，把整包拖进 template/ 就会出现上面这种嵌套。结论：后台模板管理只认 template/ 的下一级文件夹，嵌套超过一层就不再列为模板。

怎么确认文件真的到了正确的站点目录？

结论：一台服务器跑多个站点时，你上传的目录未必是当前域名指向的根目录，这是第二高发原因。

排查三步：

1. 在宝塔或虚拟主机面板查看该域名的「网站根目录」，例如 /www/wwwroot/xxx.com；
2. SSH 执行 ls -l /www/wwwroot/xxx.com/template/，确认新模板文件夹能列出来；
3. 如果域名绑定了子目录（如 /www/wwwroot/xxx.com/web），模板必须放到 /web/template/ 下，放到外层无效。

注意点：A 站上传、B 站后台找，是新手最容易犯的错，先确认后台登录的是哪个域名。

目录权限和属主怎么设才不会漏掉模板？

结论：模板目录权限设为 755、文件设为 644，属主设为 PHP 运行用户，否则 PHP 扫描目录时可能拿不到内容。

chown -R www:www /www/wwwroot/xxx.com/template
find /www/wwwroot/xxx.com/template -type d -exec chmod 755 {} \;
find /www/wwwroot/xxx.com/template -type f -exec chmod 644 {} \;

PHP 运行用户常见为 www、www-data 或 nginx，用 ps aux | grep php-fpm 可以看到实际用户。另外，如果 php.ini 里的 open_basedir 没把 template 目录包含进去，PHP 同样读不到目录内容，需要在面板的「网站目录」设置或 php.ini 中放开路径。

模板文件夹命名有哪些坑？

结论：模板文件夹名只用小写英文字母、数字和下划线，不要用中文、空格和连字符。

具体限制：

• 中文名在部分服务器的 locale 环境下会变成乱码，后台列表出现空白项或直接不显示；
• 名字含空格时，后台生成的路径会被截断；
• 名字含 &、# 等字符，在 URL 传参时会解析出错；
• Linux 区分大小写，MyTheme 和 mytheme 是两个不同目录。

文件齐全、权限也对，后台还是看不到怎么办？

结论：先清缓存再重登后台，最后检查模板包本身是否缺少首页模板文件。

按顺序做：

1. 后台执行一次「更新缓存 / 清除缓存」；
2. 用浏览器无痕窗口重新登录后台，排除浏览器缓存；
3. 服务器开了 OPcache 的，重启 php-fpm：systemctl restart php-fpm；
4. 检查模板包内是否有首页模板文件（通常命名为 index.htm 或 index.html），部分版本在扫描时会跳过没有入口文件的目录；
5. 复制一份已知可用的模板文件夹改名后放入，如果新复制的能显示，说明问题出在原来那个模板包。

一句话排查清单

按「目录层级 → 站点根目录 → 权限属主 → 命名 → 缓存」走一遍：ls -l 站点根/template/ 看层级和权限，确认没有多套一层文件夹、没有中文名、权限是 755、属主是 PHP 运行用户，然后清后台缓存并重启 php-fpm。这五步走完，剩下的可能只剩模板包自身损坏或与当前版本不兼容。