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

今天一位朋友在linux服务器部署thinkphp5的时候PHP报了这个错误，如下：

 

或者报如下类似：

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,把

修改为

 

注意：

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

 

二、Apache 修改方法

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

 

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

修改为

 

然后重新启动 apache 即可生效

> 域名.conf 文件通常是在 /usr/local/apache/conf 目录中，当然了这取决于你 LAMP 环境配置

 

三、Nginx/Tengine 修改方法

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

 

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

修改为

 

然后重新启动 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；

依然会生成错误的配置如下：

 

四、fpm/fastcgi user.ini 修改方法

打开 项目根目录下找到 user.ini 文件，搜索 open_basedir,把

修改为

 

然后重新启动 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上也可以直接使用lnmp1.4/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参数进行设置。如果不需要设置可以在前面加 # 进行注释，或自行修改目录的限制。

重启apache生效。