PHPCMS上传报错修复全攻略：图片/附件/视频上传失败常见原因及解决办法

不少用PHPCMS建站的站长应该都碰到过上传问题，要么传产品图跳“文件类型不允许”，要么传文档附件提示“大小超出限制”，甚至点上传直接空白无响应，改了后台配置还是没用。今天这篇就从后台配置、目录权限、服务器环境三个维度拆解实测可行的解决方案，不用懂复杂开发就能操作，适合刚上手的建站新手、运维小白参考。

PHPCMS上传报错常规排查步骤

很多新手遇到phpcms上传报错修复不知道从哪下手，其实按照优先级从易到难排查，半小时内基本就能定位问题，不用到处找付费技术支持。

第一步：校验后台基础配置是否正确

这是最容易操作的排查项，登录PHPCMS后台，依次点击「设置」-「附件设置」，重点核对三个配置项：

• 允许上传的文件后缀是否包含目标格式，比如很多人漏加webp、mov这类新格式就会触发系统拦截
• 单文件/多文件上传大小上限是否符合当前上传需求
• 操作用户对应的用户组附件上传权限是否开启

如果调整配置后还是报错，再往下排查目录权限问题。

第二步：核查站点上传目录权限

刚迁移完服务器的站点90%的上传问题都是权限导致的，PHPCMS默认的上传文件都存在根目录的uploadfile文件夹下，Linux服务器需要给该目录开读写权限，执行权限可以不给，直接运行下方命令即可：

``` chmod -R 755 /你的站点根目录/uploadfile ```

Windows服务器的话，需要给IIS或者Apache运行用户授予uploadfile目录的读写权限。我之前帮客户迁站的时候就碰到过一次，改完后台配置还是报错，查了半小时才发现是迁移的时候漏了给uploadfile开权限，改完立刻就好。这一步是phpcms上传报错修复里成本最低、最容易被忽略的排查项，很多人上来就改代码反而容易搞出更多问题。

特殊场景上传报错的针对性解决方案

大文件上传直接报错/空白页

如果是传10M以上的大文件触发报错，大概率是服务器PHP配置限制，和PHPCMS本身的配置没关系，需要修改php.ini里的三个参数：

``` upload_max_filesize = 100M post_max_size = 100M max_execution_time = 300 ```

用Nginx的站点还要额外在配置文件里加client_max_body_size 100m;的规则，重启服务后生效。如果改完还是报错，要检查是不是之前做CMS二次开发的时候改了上传类的校验规则，/phpcms/libs/classes/upload.class.php这个核心文件如果被篡改过，还原原始的官方文件就能完成phpcms上传报错修复。

上传后提示“上传目录不存在”

这种情况大多是你在后台自定义了附件存储路径，但是对应的目录没有手动创建，或者路径里写了中文、特殊字符导致系统识别失败，改成纯英文路径、手动创建对应目录就能解决。

我自己运维过七八台PHPCMS搭建的企业站，最近也发现很多站长还在沿用2017年左右的v9老版本，其实官方虽然停更了，但是常规的内容发布、附件上传功能只要基础配置对基本不会出问题，改核心功能之前最好先做全量备份，犯不上为了个小功能改崩整站。