php_admin_value open_basedir 引起的上传文件失败解决方法

蒯义刚::网志 2009-10-28 13:32:24 累计浏览 4,312 次

本机暂存

内容概览

这篇讲的是一个在共享主机环境下很常见的坑：为了安全配置了 `open_basedir` 限制后，网站的文件上传功能突然失灵了。文章没有停留在“上传失败”这个表象，而是带我们一步步定位了问题的核心。

问题的根因在于，`open_basedir` 这个安全指令限制了PHP进程只能访问指定目录树内的文件。如果你的应用（比如框架或上传组件）会把文件先写入一个临时目录（如系统的 `/tmp` 或PHP的上传临时文件夹），或者最终保存的路径不在这个配置允许的列表里，那么即使代码完全正确，写入操作也会被底层的文件系统安全策略默默拒绝，导致上传失败。

作者提供的解决路径非常清晰：首先检查Web服务器的错误日志，通常能看到“open_basedir restriction in effect”这样的报错；接着，通过 `phpinfo()` 或排查配置文件，精确查明当前生效的 `open_basedir` 到底限制了哪些目录；最后，根据应用的实际需要，在安全与功能之间找到平衡，将必要的上传目录加入白名单。文章强调，配置安全防护时，理解其具体影响范围至关重要，粗放的限制常常会意外阻断正常的业务逻辑。

为了安全，我们通常会在虚拟主机设置中，加入这一行

php_admin_value open_basedir "/usr/local/apache/htdocs/www"

但这会导致move_uploaded_file不能读取临时目录中的上传文件，导致上传文件失失败。

一般会提示以下错误:

以下是代码片段：
Warning: move_uploaded_file() [function.move-uploaded-file]: open_basedir restriction in effect. File(/tmp/phpqwg5rO) is not within the allowed path(s): (/usr/local/apache/htdocs/www) in /usr/local/apache/htdocs/www/includes/lib_common.php on line 3130

解决方法：

将上传文件的临时目录加入到php_admin_value open_basedir后面，最后看起来是这样的：

以下是代码片段：
<VirtualHost *:80>
php_admin_value open_basedir "/usr/local/apache/htdocs/www:/tmp"
</VirtualHost>

注意：两个目录之间是冒号隔开。

同分类推荐文章

等了十年的 Go 链式管道，终于来了：seq 让你像写 Scala 一样写 Go （2026-06-25 18:38:18）
Go 实验特性详解（2026-06-21 10:05:27）
amd64 微架构级别对 Go 程序性能提升多少？（2026-06-21 09:38:49）

查看更多后端文章 →

建议继续学习

使用gettext来支持PHP的多语言（累计阅读 39,267）
WordPress插件开发 -- 在插件使用数据库存储数据（累计阅读 29,163）
Paypal接口详细代码(PHP版，非API接口) （累计阅读 19,407）
我的PHP，Python和Ruby之路（累计阅读 13,146）
在Apache2.2.XX下安装Mod-myvhost模块（累计阅读 13,056）
include(“./file.php”)和include(“file.php”)区别（累计阅读 12,788）
15个最好的免费开源电子商务平台（累计阅读 12,541）
Redis消息队列的若干实现方式（累计阅读 12,087）
到底什么是MVC？（累计阅读 11,865）
整理了一份招PHP高级工程师的面试题（累计阅读 11,708）