PHP开发REST API时获取URL中API Token遇路径识别问题求助

问题核心是Web服务器默认会将URL路径映射到真实文件/目录，所以请求/v1/{token}/时，服务器会尝试查找v1下名为{token}的文件夹，而非转发到v1/index.php。以下是具体解决方法：

1. 配置URL重写（关键步骤） #

需要让服务器将所有v1路径下的请求转发到v1/index.php，分两种服务器环境：

Apache环境 #

在v1目录下创建.htaccess文件，添加以下规则：

RewriteEngine On
# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将所有请求转发到index.php，并保留路径信息
RewriteRule ^(.*)$ index.php [QSA,L]

• QSA：保留原URL的查询字符串
• L：标记为最后一条规则，停止后续匹配

Nginx环境 #

在站点的Nginx配置文件中，找到对应server块，添加如下location规则：

location /v1/ {
    # 优先匹配真实文件/目录，否则转发到index.php
    try_files $uri $uri/ /v1/index.php?$args;
}

或者更精准地传递路径参数：

location /v1/ {
    if (!-e $request_filename) {
        rewrite ^/v1/(.*)$ /v1/index.php?token_path=$1 last;
    }
}

2. 在PHP中获取API Token #

配置重写后，请求会正确落到v1/index.php，此时可以通过两种方式提取Token：

方式1：解析请求路径 #

直接从$_SERVER['REQUEST_URI']中提取Token：

<?php
// 获取请求路径
$requestPath = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// 去除/v1/前缀和末尾的斜杠，得到Token
$apiToken = trim(str_replace('/v1/', '', $requestPath), '/');

// 输出验证
var_dump($apiToken);
?>

方式2：使用重写传递的参数（如果配置了） #

如果在重写规则中传递了token_path参数（比如Nginx的第二个配置），可以直接获取：

<?php
$apiToken = trim($_GET['token_path'], '/');
var_dump($apiToken);
?>

3. 替代方案：将Token放在请求头中 #

为了避免URL路径解析问题，更规范的做法是将Token放在请求头里（比如Authorization头）：

<?php
// 从Authorization头获取Bearer Token
if (isset($_SERVER['HTTP_AUTHORIZATION'])) {
    list($authType, $apiToken) = explode(' ', $_SERVER['HTTP_AUTHORIZATION'], 2);
    if (strtolower($authType) === 'bearer') {
        var_dump($apiToken);
    }
}
?>

这种方式不需要修改URL重写配置，且URL更简洁安全。

内容的提问来源于stack exchange，提问作者Satyar Salehian