PHP 获取当前页面 URL 信息：全面解析与最佳实践

目录#

一、URL 的基本结构回顾
二、PHP 中获取 URL 信息的核心超全局变量
三、获取完整 URL 的常见实现方法
四、URL 各部分信息的单独提取
五、最佳实践与注意事项
六、实际应用场景示例
七、总结
八、参考文献

一、URL 的基本结构回顾#

在正式进入 PHP 实现之前，我们先回顾一下标准 URL 的结构，这有助于理解后续各部分信息的提取逻辑：

[协议]://[域名]:[端口]/[路径/文件名]?[查询参数]#[锚点]

例如：

https://www.example.com:443/blog/detail.php?id=123&category=tech#comment

各部分对应如下：

协议：https
域名：www.example.com
端口：443（HTTPS 默认端口，可省略）
路径/文件名：/blog/detail.php
查询参数：id=123&category=tech
锚点：comment（仅客户端处理，服务器端无法直接获取）

二、PHP 中获取 URL 信息的核心超全局变量#

PHP 提供了 $_SERVER 超全局变量，它存储了服务器和执行环境的所有信息，其中与 URL 相关的核心变量如下：

变量名	说明
`$_SERVER['HTTP_HOST']`	请求中的主机头信息，通常包含域名和端口（如 `www.example.com:8080`）
`$_SERVER['REQUEST_URI']`	当前请求的路径和查询参数部分（如 `/blog/detail.php?id=123`）
`$_SERVER['SERVER_PROTOCOL']`	请求使用的协议（如 `HTTP/1.1`、`HTTP/2`）
`$_SERVER['HTTPS']`	若请求为 HTTPS 则返回 `on`，否则为空或 `off`
`$_SERVER['SERVER_PORT']`	服务器监听的端口（如 `80`、`443`）
`$_SERVER['QUERY_STRING']`	URL 中的查询参数部分（不含 `?`，如 `id=123&category=tech`）
`$_SERVER['HTTP_X_FORWARDED_PROTO']`	代理服务器转发的真实协议（仅在代理场景下存在，如 `https`）

注意：$_SERVER 变量的可用性可能受服务器环境（如 Apache、Nginx、IIS）和配置影响，后续最佳实践中会提到兼容性处理。

三、获取完整 URL 的常见实现方法#

3.1 基础方法：拼接核心变量#

最直接的方式是拼接 $_SERVER 中的核心变量，得到当前页面的完整 URL：

// 基础 HTTP 协议的完整 URL
$protocol = 'http://';
$fullUrl = $protocol . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
 
echo $fullUrl;
// 输出示例：http://www.example.com/blog/detail.php?id=123

3.2 处理 HTTPS 协议的场景#

上述方法默认使用 HTTP 协议，若要兼容 HTTPS 场景，需要判断 $_SERVER['HTTPS'] 或代理头：

// 判断当前请求的协议
$protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') || $_SERVER['SERVER_PORT'] == 443
    ? 'https://'
    : 'http://';
 
// 处理代理服务器下的真实协议（如 Nginx 反向代理）
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])) {
    $protocol = $_SERVER['HTTP_X_FORWARDED_PROTO'] . '://';
}
 
$fullUrl = $protocol . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];

3.3 包含查询参数的完整 URL 获取#

$_SERVER['REQUEST_URI'] 已经包含了路径和查询参数，因此上述方法默认会自动包含查询参数。如果需要单独确保查询参数存在，也可以手动拼接：

$protocol = isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? 'https://' : 'http://';
$host = $_SERVER['HTTP_HOST'];
$path = $_SERVER['PHP_SELF']; // 当前脚本路径（不含查询参数）
$query = $_SERVER['QUERY_STRING'] ? '?' . $_SERVER['QUERY_STRING'] : '';
 
$fullUrl = $protocol . $host . $path . $query;

四、URL 各部分信息的单独提取#

在很多场景下，我们不需要完整 URL，而是单独提取协议、域名、路径等部分，以下是各部分的提取方法：

4.1 获取协议（HTTP/HTTPS）#

function getProtocol() {
    if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])) {
        return $_SERVER['HTTP_X_FORWARDED_PROTO'];
    }
    return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') || $_SERVER['SERVER_PORT'] == 443
        ? 'https'
        : 'http';
}
 
echo getProtocol(); // 输出 "https" 或 "http"

4.2 获取域名与端口#

// 获取域名（自动去除端口，若为默认端口）
function getDomain() {
    $host = $_SERVER['HTTP_HOST'];
    // 若包含端口且为默认端口，则去掉
    if (strpos($host, ':') !== false) {
        list($domain, $port) = explode(':', $host, 2);
        if ($port == 80 || $port == 443) {
            return $domain;
        }
    }
    return $host;
}
 
// 获取端口（默认端口返回空）
function getPort() {
    $port = $_SERVER['SERVER_PORT'];
    return ($port == 80 || $port == 443) ? '' : $port;
}

4.3 获取路径与文件名#

// 获取当前脚本的路径和文件名
$scriptPath = $_SERVER['PHP_SELF'];
echo $scriptPath; // 输出 "/blog/detail.php"
 
// 获取仅路径部分（不含文件名）
$pathInfo = pathinfo($scriptPath);
$directory = $pathInfo['dirname'];
echo $directory; // 输出 "/blog"

4.4 获取查询参数（Query String）#

可以直接使用 $_SERVER['QUERY_STRING']，也可以用 parse_str 转换为关联数组：

// 获取原始查询参数字符串
$queryString = $_SERVER['QUERY_STRING'];
echo $queryString; // 输出 "id=123&category=tech"
 
// 转换为关联数组
parse_str($queryString, $queryParams);
print_r($queryParams);
// 输出：Array ( [id] => 123 [category] => tech )

4.5 获取锚点（Anchor）#

锚点（如 #comment）是客户端浏览器处理的内容，不会发送到服务器端，因此 PHP 无法直接获取。需要通过 JavaScript 获取后，再通过 AJAX 或表单提交到服务器：

// 前端获取锚点
const anchor = window.location.hash; // 输出 "#comment"
 
// 通过 AJAX 发送到服务器
fetch('/save-anchor.php', {
    method: 'POST',
    body: JSON.stringify({ anchor: anchor })
});

五、最佳实践与注意事项#

5.1 处理代理服务器与负载均衡场景#

在使用 Nginx、Apache 等反向代理或负载均衡的环境中，$_SERVER['HTTPS'] 可能显示为 off（因为代理与后端 PHP 服务器之间使用 HTTP 通信）。此时需要：

在代理服务器配置中添加真实协议头，例如 Nginx：

location / {
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_pass http://php-fpm;
}

PHP 中优先读取 HTTP_X_FORWARDED_PROTO 头来判断真实协议。

5.2 过滤与转义特殊字符，避免安全风险#

若将获取的 URL 输出到页面或存储到数据库，必须进行转义处理，防止 XSS 攻击或 SQL 注入：

$currentUrl = getCurrentFullUrl();
// 输出到页面时转义
echo htmlspecialchars($currentUrl, ENT_QUOTES, 'UTF-8');
// 存储到数据库时，根据数据库类型转义（如使用 PDO 预处理语句）

5.3 兼容性处理（不同服务器环境差异）#

IIS 服务器：$_SERVER['REQUEST_URI'] 可能不可用，可使用 $_SERVER['PATH_INFO'] 或 IIS_URL_REWRITE 模拟。
Apache 与 Nginx：$_SERVER['HTTP_HOST'] 的表现基本一致，但需注意虚拟主机配置是否正确传递主机头。

5.4 封装可复用的工具函数#

将 URL 相关操作封装为工具函数，提高代码复用性和可维护性：

class UrlUtils {
    /**
     * 获取当前页面完整 URL
     */
    public static function getFullUrl() {
        $protocol = self::getProtocol();
        $host = $_SERVER['HTTP_HOST'];
        $uri = $_SERVER['REQUEST_URI'] ?? '';
        return $protocol . '://' . $host . $uri;
    }
 
    /**
     * 获取当前请求协议
     */
    public static function getProtocol() {
        if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])) {
            return $_SERVER['HTTP_X_FORWARDED_PROTO'];
        }
        return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') || $_SERVER['SERVER_PORT'] == 443
            ? 'https'
            : 'http';
    }
 
    /**
     * 获取查询参数数组
     */
    public static function getQueryParams() {
        $queryString = $_SERVER['QUERY_STRING'] ?? '';
        $params = [];
        if ($queryString) {
            parse_str($queryString, $params);
        }
        return $params;
    }
}
 
// 使用示例
echo UrlUtils::getFullUrl();

六、实际应用场景示例#

6.1 登录成功后跳转回原页面#

用户访问需要登录的页面时，记录当前 URL，登录成功后跳转回该页面：

// 需要登录的页面（如 user/profile.php）
session_start();
if (!isset($_SESSION['user'])) {
    // 存储当前 URL 到会话
    $_SESSION['redirect_url'] = UrlUtils::getFullUrl();
    header('Location: /login.php');
    exit;
}
 
// 登录处理页面（login.php）
session_start();
if ($loginSuccess) {
    // 获取存储的跳转 URL，默认跳转到首页
    $redirectUrl = $_SESSION['redirect_url'] ?? '/index.php';
    unset($_SESSION['redirect_url']);
    header('Location: ' . htmlspecialchars($redirectUrl, ENT_QUOTES));
    exit;
}

6.2 生成带参数的分享链接#

在商品页生成带用户推广 ID 的分享链接：

// 当前商品页 URL：https://www.example.com/goods/1001
$baseUrl = UrlUtils::getFullUrl();
$userId = 'user_12345';
 
// 拼接推广参数
$shareUrl = $baseUrl . (strpos($baseUrl, '?') !== false ? '&' : '?') . 'ref=' . urlencode($userId);
 
echo $shareUrl;
// 输出：https://www.example.com/goods/1001?ref=user_12345

6.3 记录用户访问的完整 URL 日志#

将用户访问的 URL 记录到日志文件：

function logAccessUrl() {
    $currentUrl = UrlUtils::getFullUrl();
    $clientIp = $_SERVER['REMOTE_ADDR'];
    $logLine = sprintf(
        '[%s] IP: %s | URL: %s' . PHP_EOL,
        date('Y-m-d H:i:s'),
        $clientIp,
        htmlspecialchars($currentUrl, ENT_QUOTES)
    );
    // 追加写入日志
    file_put_contents('access.log', $logLine, FILE_APPEND | LOCK_EX);
}
 
// 在页面入口处调用
logAccessUrl();

七、总结#

获取当前页面 URL 是 PHP 开发中的基础需求，但涉及到协议判断、代理场景兼容、安全处理等多个细节。通过本文的介绍，你应该掌握：

利用 $_SERVER 超全局变量获取 URL 核心信息的方法；
完整 URL 与各部分信息的提取实现；
代理环境、安全风险等场景下的最佳实践；
封装可复用工具函数及实际应用场景的代码示例。

合理封装工具函数、处理边界场景、重视安全转义，能够让你的代码更健壮、可维护。

目录#