EyouCMS文件写入失败解决：从权限到代码的实操修复指南

一、第一步：排查站点目录权限（90%的问题出在这里）

EyouCMS在新安装、保存配置、上传模板、更新缓存时提示写入失败，绝大多数都是因为站点运行进程没有目录写入权限，不同服务器环境操作步骤不同，以下给出可直接复制执行的方案：

1.1 Linux服务器（Nginx/Apache通用）

• 如果是宝塔面板，直接打开面板左侧的终端功能即可登录；如果是纯服务器，用自己的SSH工具连接
• 找到EyouCMS的站点根目录，宝塔面板默认根目录路径为 /www/wwwroot/你的域名/，直接复制执行以下两条命令，替换成你自己的根目录路径即可：

``` 给所有目录设置可执行可读取权限，文件设置可读写权限 chmod -R 755 /www/wwwroot/你的域名/ 修改目录所有者为站点运行用户 chown -R www:www /www/wwwroot/你的域名/ ```

不同环境的运行用户不一样，如果是官方默认的LNMP环境，将上述命令中的www:www替换为nginx:nginx（Nginx环境）或apache:apache（Apache环境）即可；如果不确定运行用户，执行以下命令直接获取：

``` ps -ef | grep nginx | awk '{print $1}' | head -n 1 ```

命令输出的内容就是你的运行用户名，替换对应位置即可。

1.2 Windows服务器（IIS环境）

• 打开资源管理器，找到站点根目录文件夹，右键点击选择属性
• 切换到顶部的安全标签页，找到IUSR用户（没有的话添加Everyone用户），点击编辑按钮
• 勾选权限列表中的写入权限，点击保存应用配置即可。

二、第二步：排查系统临时目录配置

EyouCMS上传文件、缓存更新都需要用到临时目录，如果临时目录不存在或无权限，也会触发写入失败，操作步骤如下：

• 打开站点根目录，检查是否存在名为temp的空文件夹，如果不存在，手动新建一个同名文件夹即可
• 新建完成后，给temp文件夹设置和根目录一致的权限：Linux设置755权限，Windows给运行用户开通写入权限
• 如果修改后还是报错，打开根目录下application/config.php文件，检查临时目录配置是否正确，正确配置如下，可直接复制替换：

``` // 系统临时目录 'temp_path' => ROOT_PATH . 'temp' . DS, ```

三、第三步：排查服务器磁盘空间不足

服务器磁盘空间占满会直接导致所有写入操作失败，这个问题非常容易被新手忽略，检查方式非常简单：

• 如果使用宝塔面板，直接打开面板首页就能看到磁盘使用率，使用率超过95%就是空间不足，删除过期备份、无用日志即可释放空间
• 如果是纯Linux环境，连接SSH后执行以下命令查看：

``` df -h ```

输出结果中的Use%列就是磁盘使用率，超过95%即为空间不足，清理无用文件后即可恢复写入。

四、第四步：修复上传压缩包提示写入失败

如果是上传模板、插件压缩包时提示写入失败，大概率是PHP上传大小限制不足，修改配置即可解决：

• 打开你的PHP配置文件php.ini，宝塔面板可直接在站点对应的PHP版本设置中点击编辑配置文件
• 找到以下两个配置项，修改成你需要的大小，比如要上传20M的压缩包，修改为：

``` upload_max_filesize = 20M post_max_size = 20M ```

• 修改完成后保存，重启PHP服务，重新上传压缩包即可解决问题。

五、第五步：修复开启OPcache后写入失败

很多用户为了提升站点速度开启了PHP的OPcache缓存，如果配置不合理，会导致文件更新后无法写入，修改OPcache配置即可：

打开php.ini找到OPcache配置块，修改为以下参数，核心项已经标注：

``` opcache.enable=1 opcache.enable_cli=1 opcache.memory_consumption=128 opcache.interned_strings_buffer=8 opcache.max_accelerated_files=100000 opcache.revalidate_freq=60 opcache.validate_timestamps=1 ```

核心注意：必须将opcache.validate_timestamps设置为1，该参数开启后OPcache才会自动检测文件更新，不会阻挡新内容写入。修改完成后重启PHP服务即可生效。

六、编辑内容场景的特殊修复

如果是在后台编辑文章、修改模板时提示写入失败，单独检查两个核心目录的权限即可：

Linux环境执行以下命令，替换成你自己的根目录路径：

``` chmod -R 755 /www/wwwroot/你的域名/template chmod -R 755 /www/wwwroot/你的域名/runtime ```

Windows环境直接给这两个文件夹开通IUSR用户的写入权限即可。

按照上述步骤从第一步到第五步依次排查，99%的EyouCMS文件写入失败问题都可以解决，如果排查后仍无法解决，检查服务器防火墙、云服务商WAF/CDN是否拦截了后台的写入请求，关闭拦截即可恢复。