Siam博客

PHP path_info,Thinkphp controller not exists index\php

2019-08-24

写在前面

为什么写下这篇文章,嗯,因为又踩坑了。 问题背景:

  • php7.2
  • nginx
  • thinkphp5

问题体现: url如果以/为结尾 比如index.php/admin/,不会自动访问默认控制器、方法index,而是报错

controller not exists:app\admin\controller\index\Php

求知之路

研究过thinkphp框架源码的,或者深入了解过mvc的,都应该知道thinkphp框架的路由,是根据path_info值来解析的,甚至传参也可以带在path_info中

排查path_info的值

一路追踪源码,在thinkphp\library\think\Request.php 路径中,找到以下代码

/**
 * 673行左右
 *
 *
 * 获取当前请求URL的pathinfo信息(含URL后缀)
 * @access public
 * @return string
 */
public function pathinfo()
{
    if (is_null($this->pathinfo)) {
        if (isset($_GET[$this->config['var_pathinfo']])) {
            // 判断URL里面是否有兼容模式参数
            $pathinfo = $_GET[$this->config['var_pathinfo']];
            unset($_GET[$this->config['var_pathinfo']]);
            unset($this->get[$this->config['var_pathinfo']]);
        } elseif ($this->isCli()) {
            // CLI模式下 index.php module/controller/action/params/...
            $pathinfo = isset($_SERVER['argv'][1]) ? $_SERVER['argv'][1] : '';
        } elseif ('cli-server' == PHP_SAPI) {
            $pathinfo = strpos($this->server('REQUEST_URI'), '?') ? strstr($this->server('REQUEST_URI'), '?', true) : $this->server('REQUEST_URI');
        } elseif ($this->server('PATH_INFO')) {
            $pathinfo = $this->server('PATH_INFO');
        }

        // 分析PATHINFO信息
        if (!isset($pathinfo)) {
            foreach ($this->config['pathinfo_fetch'] as $type) {
                if ($this->server($type)) {
                    $pathinfo = (0 === strpos($this->server($type), $this->server('SCRIPT_NAME'))) ?
                    substr($this->server($type), strlen($this->server('SCRIPT_NAME'))) : $this->server($type);
                    break;
                }
            }
        }

        if (!empty($pathinfo)) {
            unset($this->get[$pathinfo], $this->request[$pathinfo]);
        }

        $this->pathinfo = empty($pathinfo)  '/' == $pathinfo ? '' : ltrim($pathinfo, '/');
    }

    return $this->pathinfo;
}

我尝试在这个方法里(目前来看,这里是分析path_info的第一门关)打印$_SERVER['PATH_INFO'] 打印出来的值大概为admin/index.php 然后在后续解析中,又会把.替换成/ 也就是admin/index/php 对应我们报错的app\admin\controller\index\Php

分析path_info来源

我们知道,$_SERVER超全局变量是在php中自动维护的,所以它的来源肯定来自以下两个方面之一

  • php底层
  • web服务器

经过找一些资料,我得知了该变量的值是来自web服务器,也就是我使用的nginx 宝塔安装的nginx,会自动维护很多常用配置,比如不同版本的php配置、path_info配置等等(有些自己编译安装的php没有path_info 需要自己添加) 在/www/server/nginx/conf 下有多个php版本的配置文件,在其中有一个配置项

fastcgi_index index.php;

fastcgi是什么意思大家可以先自行补充 ^ _ ^ 也就是该配置项影响了我们的运行 它的定义可以简单理解为:

默认值:none
使用字段:http, server, location
如果URI以斜线结尾,文件名将追加到URI后面,这个值将存储在变量$fastcgi_script_name中

测试: 把index.php改为index2.php 访问程序,报错变为:controller not exists:app\admin\controller\index2\Php 可以证实是该配置影响结果

总结处理

Web服务器该配置影响了程序运行,那么我们如何解决该问题

  • ① 修改thinkphp底层,把path_info最后的index.php替换掉
  • ② 修改web服务器该配置为none 去除
  • ③ 修改程序,遵循规范

基于业务迁移、兼容不同环境考虑,我选择第三种方案。也就是修改程序,不允许跳转或者访问带/结尾。

本文链接:
版权声明: 本文由 Siam原创发布,转载请遵循《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》许可协议授权
Tags: PHP

扫描二维码,分享此文章