open_basedir restriction in effect. 原因与解决方法

超炯得强

在linux服务器部署thinkphp5的时候PHP报了这个错误，如下：

• Warning: require(): open_basedir restriction in effect. File(/www/wwwroot/zhuyuyun/thinkphp/start.php) is not within the allowed path(s): (/www/wwwroot/zhuyuyun/public/:/tmp/:/proc/) in /www/wwwroot/zhuyuyun/public/index.php on line 20
• Warning: require(/www/wwwroot/zhuyuyun/thinkphp/start.php): failed to open stream: Operation not permitted in /www/wwwroot/zhuyuyun/public/index.php on line 20
• Fatal error: require(): Failed opening required '/www/wwwroot/zhuyuyun/public/../thinkphp/start.php' (include_path='.:/www/server/php/56/lib/php') in /www/wwwroot/zhuyuyun/public/index.php on line 20
  

或者报如下类似：
Warning: include_once(): open_basedir restriction in effect. File(../../staticpayb/WxPay.Config) is not within the allowed path(s):

出现问题的原因：
查看问题描述以及资料，发现是php open_basedir 配置的问题，PHP不能引入其授权目录上级及其以上的文件；
一般情况下是不会出现这种问题的，之所以出现这个问题绝大多数情况是由于服务器的原因，为了安全才做了这样的限制！

解决方法：
我首先要申明的是，下面的方法适合所有类似PHP报“open_basedir restriction in effect”错误的项目，并不仅仅只是适合thinkphp5的人。只要你的PHP报此错误都可以得到解决。

如果把ThinkPHP5部署在了LAMP/LNMP环境上很有可能出现白屏或500的情况，这个时候需要开启 php 错误提示来判断是否是因为设置了open_basedir选项出错？
打开 php.ini 搜索 display_errors，把 Off 修改为 On就开启了 php 错误提示，这时再访问之前白屏的页面就会出现错误信息。如果错误信息如下那么很有可能就是因为open_basedir的问题。

一、php.ini 修改方法
把权限作用域由入口文件目录修改为框架根目录

打开 php.ini 搜索 open_basedir,把

• open_basedir = "/home/wwwroot/tp5/public/:/tmp/:/var/tmp/:/proc/"
  

修改为

• open_basedir = "/home/wwwroot/tp5/:/tmp/:/var/tmp/:/proc/"
  

注意：
如果你的 php.ini 文件的 open_basedir 设置选项是被注释的或者为 none，那么你需要通过 Apache 或者 Nginx 来修改> php.ini 文件通常是在 /usr/local/php/etc 目录中，当然了这取决于你 LAMP 环境配置。

二、Apache 修改方法
Apache 需要修改 httpd.conf 或者同目录下的 vhost 目录下 你的域名.conf 文件，如果你的生成环境是 LAMP 一键安装包配置那么多半就是直接修改 你的域名.conf 文件

• apache
• ├─vhost
•     ├─www.thinkphp.cn.conf
•     ├─......
• ├─httpd.conf
  

打开 你的域名.conf 文件 搜索 open_basedir,把

• php_admin_value open_basedir "/home/wwwroot/http://www.thinkphp.cn/public/:/tmp/:/var/tmp/:/proc/"
  

修改为

• php_admin_value open_basedir "/home/wwwroot/http://www.thinkphp.cn/:/tmp/:/var/tmp/:/proc/"
  

然后重新启动 apache 即可生效
> 域名.conf 文件通常是在 /usr/local/apache/conf 目录中，当然了这取决于你 LAMP 环境配置

三、Nginx/Tengine 修改方法
Nginx 需要修改 nginx.conf 或者 conf/vhost 目录下 你的域名.conf 文件，如果你的生成环境是 LNMP/LTMP 一键安装包配置那么多半就是直接修改 你的域名.conf 文件

• nginx
• ├─conf
•     ├─vhost
•         ├─www.thinkphp.cn.conf
•     ├─nginx.conf
•     ├─......
• ├─nginx.conf
  

打开 你的域名.conf 文件 搜索 open_basedir,把

• fastcgi_param  PHP_VALUE  "open_basedir=/home/wwwroot/http://www.thinkphp.cn/public/:/tmp/:/proc/";
  

修改为

• fastcgi_param  PHP_VALUE  "open_basedir=/home/wwwroot/http://www.thinkphp.cn/:/tmp/:/proc/";
  

然后重新启动 Nginx 即可生效
域名.conf 文件通常是在 /usr/local/nginx/conf/vhost 目录中，当然了这取决于你 LNMP/LTMP 环境配置

注意：上面我们修改的时候用的是绝对地址，但是也可以这样直接去找网站根目录（如果你这样配置，你一定要懂不同项目有不同根目录的原理，否则也是行不通的。）：
fastcgi_param PHP_ADMIN_VALUE "open_basedir=$document_root/:/tmp/:/proc/";
上面这行代码拿thinkphp来讲，如果你根目录是public，那么$document_root就会指到public；
依然会生成错误的配置如下：

• fastcgi_param  PHP_VALUE  "open_basedir=/home/wwwroot/http://www.thinkphp.cn/public/:/tmp/:/proc/";
  

四、fpm/fastcgi user.ini 修改方法
打开 项目根目录下找到 user.ini 文件，搜索 open_basedir,把

• open_basedir=/home/wwwroot/http://www.thinkphp.cn/public/:/tmp/:/proc/
  

修改为

• open_basedir=/home/wwwroot/http://www.thinkphp.cn/:/tmp/:/proc/
  

然后重新启动 web 服务器 即可生效！

总结：
一定要仔细读此篇文章，否则你会选错适合你的方法。
一定要根据自己的服务器环境来选择你的修改方法。

由于有很多的朋友用的是“宝塔面板”或“LNMP/LAMP“一键安装包的，设置方法可以看评论！

---

最近发现有很多人用“宝塔面板”经常出现这个错误，一直来Q上私聊我，我就再给大家分享一下。
宝塔面板出现“open_basedir restriction in effect. ”的解决方法
1、只需要在相应的网站目录，勾选掉防跨站攻击（open_basedir）即可！
2、必须重启PHP；

LNMP/LAMP 出现“open_basedir restriction in effect. ”的解决方法
我今天也遇到了这样的情况，我用的是LNMP一键安装包+Thinkphp，然后根目录绑定到的是public目录下，再访问首页的时候出现500错误，后来去 php.ini 把 display_errors 设置为 on 后，报的错误和文章讲的一模一样；

我的解决方法其实和文章也差不多，原理都是一样的：

我是看到LNMP官方提供的“防跨目录设置”方法，如下：
LNMP 1.1及之前的版本使用php.ini里面，open_basedir设置

LNMP 1.2及更高版本防跨目录功能使用.user.ini，该文件在网站根目录下，可以修改.user.ini 里面的open_basedir的值来设置限制访问的目录或删除来移除防跨目录的设置。

.user.ini文件无法直接修改，如要修或删除需要先执行：chattr -i /网站目录/.user.ini
可以使用winscp文件管理、vim编辑器或nano编辑器进行修改。
删除的话rm -f /网站目录/.user.ini 就可以。
修改完成后再执行：chattr +i /网站目录/.user.ini
.user.ini不需要重启一般5分钟左右生效，也可以重启一下php-fpm立即生效。
如果要更改网站目录必须要按上述方法修改防跨目录的设置，否则肯定报错！！

LNMP 1.4或更高版本如果不想用防跨目录除需要删除.user.ini的防跨目录的目录还需要将 /usr/local/nginx/conf/fastcgi.conf 里面的fastcgi_param PHP_ADMIN_VALUE "open_basedir=$document_root/:/tmp/:/proc/"; 在该行行前添加 # 或删除改行，需要重启nginx。

LNMP 1.4或更高版本也可以直接使用lnmp安装包 tools/ 目录下的 ./remove_open_basedir_restriction.sh 进行移除，需要输入原网站目录完整路径(注意不是新的网站路径)，回车即可。
在Thinkphp、codeigniter、Laravel等框架下，网站目录一般是在public下，但是public下的程序要跨目录调用public上级目录下的文件，因为LNMP默认是不允许跨目录访问的，所以都是必须要将防跨目录访问的设置去掉，有时候这些框架类的程序提示500错误也可能是这个问题引起的。

LNMPA或LAMP 模式1.2版本或更高版本的防跨目录的设置使用的对应apache虚拟主机配置文件（lnmp管理工具添加的话文件是 /usr/local/apache/conf/vhost/域名.conf ）里的php_admin_value open_basedir参数进行设置。如果不需要防跨目录设置可以在 php_admin_value open_basedir 该行前面加 # 进行注释，或自行修改参数后面的目录。

重启apache生效。