Warning: require(): open_basedir restriction in effect

爱被打了一巴掌 2022-04-14 21:28 169阅读 0赞

今天在linux服务器部署thinkphp5的时候PHP报了这个错误，

如下：

1.  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
2.   
3.  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
4.   
5.  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

## 出现问题的原因： ##

查看问题描述以及资料，发现是php **open\_basedir 配置**的问题，PHP不能引入其授权目录上级及其以上的文件；

一般情况下是不会出现这种问题的，之所以出现这个问题绝大多数情况是由于服务器的原因，为了安全才做了这样的限制！

## 解决方法： ##

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

如果把`ThinkPHP5`部署在了`LAMP/LNMP`环境上很有可能出现白屏或500的情况，这个时候需要开启 php 错误提示来判断是否是因为设置了`open_basedir`选项出错？

打开 php.ini 搜索 `display_errors`，把 Off 修改为 On就开启了 php 错误提示，这时再访问之前白屏的页面就会出现错误信息。如果错误信息如下那么很有可能就是因为`open_basedir`的问题。

[![require(): open\_basedir restriction in effect.][require_ open_basedir restriction in effect.]][require_ open_basedir restriction in effect.]

### 一、php.ini 修改方法 ###

把权限作用域由入口文件目录修改为框架根目录

打开 php.ini 搜索 `open_basedir`,把

1.  open\_basedir = "/home/wwwroot/tp5/public/:/tmp/:/var/tmp/:/proc/"

修改为

1.  open\_basedir = "/home/wwwroot/tp5/:/tmp/:/var/tmp/:/proc/"

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NzQ2ODE1_size_16_color_FFFFFF_t_70][]

**注意：**

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

### 二、Apache 修改方法 ###

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

1.  apache
2.  ├─vhost
3.      ├─www.thinkphp.cn.conf 
4.      ├─......
5.  ├─httpd.conf

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

1.  php\_admin\_value open\_basedir "/home/wwwroot/www.thinkphp.cn/public/:/tmp/:/var/tmp/:/proc/"

修改为

1.  php\_admin\_value open\_basedir "/home/wwwroot/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 文件

1.  nginx
2.  ├─conf
3.      ├─vhost
4.          ├─www.thinkphp.cn.conf
5.      ├─nginx.conf
6.      ├─......
7.  ├─nginx.conf

打开 你的域名.conf 文件 搜索 `open_basedir`,或自行加入把

1.  fastcgi\_param  PHP\_VALUE  "open\_basedir=/home/wwwroot/www.thinkphp.cn/public/:/tmp/:/proc/";

修改为

1.  fastcgi\_param  PHP\_VALUE  "open\_basedir=/home/wwwroot/www.thinkphp.cn/:/tmp/:/proc/";

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NzQ2ODE1_size_16_color_FFFFFF_t_70 1][]

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

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

1.  fastcgi\_param  PHP\_VALUE  "open\_basedir=/home/wwwroot/www.thinkphp.cn/public/:/tmp/:/proc/";

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

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

1.  open\_basedir=/home/wwwroot/www.thinkphp.cn/public/:/tmp/:/proc/

修改为

1.  open\_basedir=/home/wwwroot/www.thinkphp.cn/:/tmp/:/proc/

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

总结：

一定要仔细读此篇文章，否则你会选错适合你的方法。

一定要根据自己的服务器环境来选择你的修改方法。

[require_ open_basedir restriction in effect.]: https://www.fujieace.com/wp-content/uploads/2017/11/1-12.png?x86494
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NzQ2ODE1_size_16_color_FFFFFF_t_70]: /images/20220415/3fd37b4460ac492897d08cb2845ec4ad.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NzQ2ODE1_size_16_color_FFFFFF_t_70 1]: /images/20220415/6ad1f43014824e1d9b0f7bbe8825b7a2.png