PHP路由场景下如何隔离被包含文件的执行上下文？

现有PHP路由脚本如下：

include_once('routing-functions.php');

// pathMatches 从 routing-functions.php 导入

if(pathMatches('/blog/*')){
    include_once('actual-script.php');
}

当前遇到的核心问题：

• routing-functions.php中的函数、全局变量可能与actual-script.php产生命名冲突
• 不希望actual-script.php能访问任何路由相关的变量或函数
• 需要让actual-script.php如同被直接HTTP请求一样执行，同时保持在/blog/开头的URL路径下运行

已排除的方案：

• 用匿名函数包裹include：会改变actual-script.php的执行作用域，不符合需求
• 本地cURL请求：存在明显性能损耗
• .htaccess配置：需要纯PHP的动态路由解决方案

可以通过启动独立的PHP CLI进程来执行actual-script.php，以此彻底隔离当前路由脚本的所有上下文，同时通过环境变量模拟HTTP请求的URL环境，让目标脚本的行为和直接被请求时完全一致。

示例代码 #

include_once('routing-functions.php');

if(pathMatches('/blog/*')){
    // 将当前HTTP请求的关键环境变量传递给CLI进程
    putenv("REQUEST_URI={$_SERVER['REQUEST_URI']}");
    putenv("PATH_INFO=" . ($_SERVER['PATH_INFO'] ?? ''));
    putenv("HTTP_HOST={$_SERVER['HTTP_HOST']}");
    // 如果需要传递其他HTTP头，可继续添加putenv语句

    // 构建CLI执行命令，确保路径正确
    $scriptPath = realpath('actual-script.php');
    $command = "php -d variables_order=EGPCS \"{$scriptPath}\"";

    // 执行命令并输出结果，最后退出当前进程
    passthru($command, $exitCode);
    exit($exitCode);
}

方案细节说明 #

1. 完全隔离上下文：CLI模式下的PHP进程是全新启动的，不会继承当前路由脚本中的任何函数、全局变量或类，从根本上避免冲突问题。
2. 模拟HTTP请求环境：通过putenv设置REQUEST_URI、PATH_INFO等变量，让actual-script.php能获取到正确的URL路径信息，和直接被HTTP请求时的行为一致。
3. 性能优势：直接调用CLI进程的开销远小于本地cURL请求，无需经过HTTP服务器层的额外处理。
4. 兼容POST请求：如果需要处理POST数据，可以读取请求体并通过管道传递给CLI进程，示例：

   include_once('routing-functions.php');
   
   if(pathMatches('/blog/*')){
       // 传递HTTP环境变量
       putenv("REQUEST_URI={$_SERVER['REQUEST_URI']}");
       putenv("HTTP_HOST={$_SERVER['HTTP_HOST']}");
       putenv("REQUEST_METHOD={$_SERVER['REQUEST_METHOD']}");
   
       // 读取POST数据
       $postData = file_get_contents('php://input');
       $scriptPath = realpath('actual-script.php');
   
       // 构建带POST数据的命令
       $command = sprintf(
           'echo %s | php -d variables_order=EGPCS "%s"',
           escapeshellarg($postData),
           $scriptPath
       );
   
       passthru($command, $exitCode);
       exit($exitCode);
   }
   

注意事项 #

• 确保服务器环境允许执行PHP CLI命令，若php不在系统PATH中，需使用完整路径（如/usr/bin/php）。
• 若目标脚本依赖特定的$_SERVER变量，需将对应的变量通过putenv传递，CLI模式下默认不会自动加载这些变量，需要通过variables_order=EGPCS配置让PHP读取环境变量到超全局数组中。

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