MiuCMS - 常见问题与解决方案

1MiuCMS 安装时报「目录不可写」怎么办？

将 runtime、public/storage、config 这些目录设置为可写权限（Linux 常见为 755 或 775，取决于 PHP 运行用户），并确认 open_basedir 未限制站点目录。 虚拟主机环境可在控制面板中调整文件权限，或联系服务商协助处理。

2MiuCMS 对 PHP 与数据库版本有什么要求？

### 服务器要求 - 1核CPU (建议2核+) - 2G内存 (建议4G+) - 带宽不限 ### 运行环境 - Nignx（推荐）/Apache/IIS - PHP 8.0 及以上。 - Mysql >= 5.5.0 (需支持innodb引擎)。 - 启用 fileinfo、gd、mysqli、pdo_mysql 扩展。 - SSL

3如何开发一套自己的 MiuCMS 模板？

在 templates 目录新建模板目录，用 info.txt 声明模板名称、版本与兼容信息，再按区块拆分 HTML 模板文件即可被后台识别。 建议先在模板市场下载一套免费模板作为骨架进行二次修改。

4插件安装后不生效，应如何排查？

先确认插件版本与当前 MiuCMS 主程序兼容，再检查依赖扩展是否已启用；随后在后台清除缓存并查看运行日志中的插件加载记录。 若开启了全站静态化，请手动生成一次页面后再验证。

5站点访问慢，有哪些优化手段？

尝试启用 OPcache，并为静态资源配置 CDN 与浏览器缓存。 尝试SEO->URL配置 改为使用 **生成静态模式**。 数据库侧可定期清理草稿与日志表，避免单表数据量过大。

6忘记后台登录密码如何重置？

下载官方提供的密码重置插件，按照说明进行操作。 请勿使用在非官方网站获取到的任何插件及代码。

7MiuCMS 可以商用吗？是否需要授权费用？

主程序开源免费，可自由用于商业项目；模板市场与插件中心标注为「付费」的资源需单独购买。 免费模板与插件同样允许商用，具体以各资源详情页说明为准。

8旧版本程序如何升级？

1. 可在官网下载升级包进行升级，不可跨版本升级。 2. 点击后台右上角**系统升级**，全自动升级。

9安装时报错You do not have the SUPER privilege and binary logging is enabled

是 MySQL 导入 SQL 时的权限/二进制日志限制,解决方法：mysql配置文件里，在 `[mysqld]` 段下加一行：`log_bin_trust_function_creators=1`，重启数据库/或重置配置 即可。

10为什么打开不存在的页面404报错没加载404模板？

服务器开启了 fastcgi_intercept_errors on;，把 PHP 返回的错误页面拦截并替换了。 解决方法是nginx配置文件里把`fastcgi_intercept_errors on;`改成`fastcgi_intercept_errors off;`