php关于$_SERVER中一些和环境有关的参数详解

前面有一个关于$_SERVER的文档，今天，来看看怎么不同环境下其携带参数的差异与统一。

• REQUEST_URI
  由HTTP1.1协议定义，指向某个页面的URI，去除开头的协议、主机、端口等信息。如 http://www.digpage.com:8080/index.php/foo/bar?queryParams,REQUEST_URI为/index.php/foo/bar?queryParams

• X-REWRITE-URL
  当使用了以开启ISAPI_Rewrite的IIS作为服务器时，ISAPI_Rewrite会在未对原始URI作任何修改前，将原始的REQUEST_URI以X-REWRITE0URL HTTP头保存起来。

• PATH_INFO
  CGI 1.1规范定义的环境变量。从形式上看。它是整个URI中，在脚本标识之后、查询参数?之前的部分。对于Apache，需要设置AcceptPathinfo On,且在一个URL没有</PATH_INFO>部分的时候 ，PATH_INFO无效。特殊情况，如http://www.digpage.com/index.php/，PATH_INFO为/。而对于 Nginx，则需要设置：
  fastcgi_split_path_info ^(.+?\.php)(/.*)$; fastcgi_param PATH_INFO $fastcgi_path_info;

• ORIG_PATH_INFO
  指未经 PHP 处理过的原始的 PATH_INFO”。 这个在 Apache 和 Nginx 需要配置一番才行，但一般用不到，已经有 PATH_INFO 可以用了嘛。而在 IIS 中则有点怪， 对于 http://www.digpage.com/index.php/ ORIG_PATH_INFO为/index.php/；对于 http://www.digapge.com/index.php ORIG_PATH_INFO为 /index.php 。

在yii2中的一个方法：用来获取不同环境下统一的URI

<?php
//使用了ISAPI_Rewrite的IIS
if (isset($_SERVER['HTTP_X_REWRITE_URL'])) {
    $requestUri = $_SERVER['HTTP_X_REWRITE_URL'];
//一般情况，需要去掉 URL 中的协议、主机、端口等内容
} elseif (isset($_SERVER['REQUEST_URI'])) {
    $requestUri = $_SERVER['REQUEST_URI'];
    if ($requestUri !== '' && $requestUri[0] !== '/') {
        $requestUri = preg_replace('/^(http|https):\/\/[^\/]+/i', '', $requestUri);
    }
// IIS 5.0， PHP 以 CGI 方式运行，需要把查询参数接上
} elseif (isset($_SERVER['ORIG_PATH_INFO'])) {
    $requestUri = $_SERVER['ORIG_PATH_INFO'];
    if (!empty($SERVER['QUERY_STRING'])) {
        $requestUri .= '?' . $SERVER['QUERY_STRING'];
    }
} else {
    throw new Exception('wrong');
}

echo $requestUri;

• SCRIPT_FILENAME
  当前脚本的实际物理路径，比如 /var/www/digpage.com/frontend/web/index.php ， 或 WIN平台的 D:\www\digpage.com\frontend\web\index.php 。 以 Nginx 为例，一般情况下，SCRIPT_FILENAME 有以下配置项：

fastcgi_split_path_info ^(.+?\.php)(/.*)$;
# 使用 document root 来得到物理路径
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name

• SCRIPT_NAME
  CGI 1.1 规范所定义的环境变量，用于标识 CGI 脚本（而非脚本的输出），如 http://www.digapge.com/path/index.php 中的/path/index.php。 仍以 Nginx 为例，SCRIPT_NAME 一般情况下有fastcgi_param SCRIPT_NAME $fastcgi_script_name的设置。绝大多数情况下，使用 SCRIPT_NAME 即可获取当前脚本。

• PHP_SELF
  PHP_SELF 是 PHP 自己实现的一个 $_SERVER 变量，是相对于文档根目录（documentroot）而言的。 对于 http://www.digpage.com/path/index.php?queryParams，PHP_SELF为 /path/index.php 。 一般 SCRIPT_NAME 与 PHP_SELF 无异。但是，在 PHP.INI 中，如 cgi.fix_pathinfo=1（默认即为 1）时， 对于形如http://www.digpage.com/path/index.php/post/view/123， 则PHP_SELF为 /path/index.php/post/view/123 。 而根据 CGI 1.1 规范，SCRIPT_NAME 仅为 /path/index.php ，至于剩余的 /post/view/123 则为 PATH_INFO。

• ORIG_SCRIPT_NAME
  当 PHP 以 CGI 模式运行时，默认会对一些环境变量进行调整。 首当其冲的，就是SCRIPT_NAME 的内容会变成 php.cgi 等二进制文件，而不再是 CGI 脚本文件。 当然，设置 cgi.fix_pathinfo=0 可以关闭这一默认行为。但这导致的副作用比较大，影响范围过大，不宜使用。 但天无绝人之路，九死之地总留一线生机，那就是 ORIG_SCRIPT_NAME，他保留了调整前 SCRIPT_NAME 的内容。 也就是说，在 CGI 模式下，可以使用ORIG_SCRIPT_NAME 来获取想要的 SCRIPT_NAME。 请留意使用ORIG_SCRIPT_NAME 前一定要先确认它是否存在。

再来看看yii2中的相关方法：

<?php
$scriptFile = $_SERVER['SCRIPT_FILENAME'];
$scriptName = basename($scriptFile);

if (basename($_SERVER['SCRIPT_NAME']) === $scriptName){
    $_scriptUrl = $_SERVER['SCRIPT_NAME'];
} elseif (basename($_SERVER['PHP_SELF']) === $scriptName) {
    $_scriptUrl = $_SERVER['PHP_SELF'];
} elseif (isset($_SERVER['ORIG_SCRIPT_NAME']) && basename($_SERVER['ORIG_SCRIPT_NAME']) === $scriptName) {
    $_scriptUrl = $_SERVER['ORIG_SCRIPT_NAME'];
} elseif (!empty($_SERVER['DOCUMENT_ROOT']) && strpos($scriptFile, $_SERVER['DOCUMENT_ROOT']) === 0) {
    $_scriptUrl = str_replace("\\", '/', str_replace($_SERVER['DOCUMENT_ROOT'], '', $scriptFile));
} else {
    throw new Exception ('wrong');
}

$baseUrl = retirm(dirname($_scriptUrl), '\\/');

在yii中通过这些的配合，也有一个获取pathinfo的方法，如下是逻辑代码:

$pathinfo = $requestUri;

if (($pos = strpos($pathinfo , '?')) !== false) {
    $pathinfo = substr($pathinfo, 0, $pos);
}

if (!preg_match('%^(?:
    [\x09\x0A\x0D\x20-\x7E] # ASCII
    | [\xC2-\xDF][\x80-\xBF] # non-overlong 2-byte
    | \xE0[\xA0-\xBF][\x80-\xBF] # excluding overlongs
    | [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2} # straight 3-byte
    | \xED[\x80-\x9F][\x80-\xBF] # excluding surrogates
    | \xF0[\x90-\xBF][\x80-\xBF]{2} # planes 1-3
    | [\xF1-\xF3][\x80-\xBF]{3} # planes 4-15
    | \xF4[\x80-\x8F][\x80-\xBF]{2} # plane 16
    )*$%xs', $pathinfo)
) {
    $pathInfo = utf8_encode($pathInfo);
}

if (strpos($pathinfo, $_scriptUrl) === 0) {
    $pathinfo = substr($pathinfo, strlen($_scriptUrl));
} elseif ($baseUrl === "" || strpos($pathinfo, $baseUrl) === 0) {
    $pathinfo = substr($pathinfo, strlen($baseUrl));
} elseif (isset($_SERVER['PHP_SELF']) && strpos($_SERVER['PHP_SELF'], $_scriptUrl) === 0) {
    $pathinfo = substr($_SERVER['PHP_SELF'], str($_scriptUrl));
} else {
    throw new Exception('wrong');
}
if ($pathinfo[0] === '/') {
    $pathinfo = substr($pathinfo, 1);
}

这样，就获得了当前请求的URI($requestUri)、脚本路径($_scriptUrl)、pathinfo($pathinfo),这些变量都是一个健壮的框架所需利用的元素。