PHP中正确使用require_once()：变量与函数共享问题求解

场景复现 #

1. 共享文件 test.php #

<?php
  $myVar = "myVar";
  
  function myFunc() {
    echo "myFunc()";
  }
?>

2. 调度页 page1.php #

<?php
  echo "page1";
  require_once("include/test.php");
  print_r($myVar);

function GoTo2() {
  $urlSite = "page2.php";
  include($urlSite); 
  exit();
}

GoTo2();
?>

page1.php 可正常读取 $myVar 的值。

3. 目标页 page2.php #

<?php
  echo "page2";
  require_once("include/test.php");
  print_r($myVar);
?>

执行时触发PHP警告：
Undefined variable $myVar in .../page2.php on line 4

若将 page2.php 中的 require_once 改为 require，则触发致命错误：
PHP Fatal error: Cannot redeclare myFunc() (previously declared in .../include/test.php) in .../include/test.php ...

补充背景 #

• 这是实际业务代码的简化版本，升级到PHP8后出现page2.php无法读取变量的问题，收到大量“未定义变量”警告
• page1.php为系统调度页
• 接手他人开发的代码，需给出最优解决方案

最优解决方案 #

方案1：全局变量临时修复（最小改动） #

由于page2.php是被page1.php的GoTo2()函数包含执行，$myVar处于全局作用域，函数内部默认无法访问。可在page2.php中通过两种方式访问：

<?php
  echo "page2";
  require_once("include/test.php");
  // 方式1：用global声明变量
  global $myVar;
  print_r($myVar);
  // 方式2：通过$GLOBALS数组访问
  // print_r($GLOBALS['myVar']);
?>

注意：该方案仅适合快速临时修复，全局变量会增加代码耦合度，不推荐长期使用。

方案2：依赖注入重构（推荐长期方案） #

通过面向对象封装消除全局依赖，彻底解决问题：

1. 改造test.php为类文件：

<?php
class TestService {
    public $myVar = "myVar";
    
    public function myFunc() {
        echo "myFunc()";
    }
}
?>

2. 修改page1.php，实例化类并传递给目标页：

<?php
echo "page1";
require_once("include/test.php");
$testService = new TestService();
print_r($testService->myVar);

function GoTo2($serviceInstance) {
    $urlSite = "page2.php";
    include($urlSite); 
    exit();
}

GoTo2($testService);
?>

3. 修改page2.php直接使用传递的实例：

<?php
echo "page2";
// 无需重复引入test.php（若类未加载可按需引入）
print_r($testService->myVar);
?>

此方案遵循面向对象设计原则，消除全局依赖，避免函数重复声明，大幅提升代码可维护性。

方案3：静态类过渡（折中方案） #

若暂时无法完成全量重构，可将test.php改为静态类：

<?php
class TestStatic {
    public static $myVar = "myVar";
    
    public static function myFunc() {
        echo "myFunc()";
    }
}
?>

在page1.php和page2.php中直接静态访问：

// page1.php
require_once("include/test.php");
print_r(TestStatic::$myVar);

// page2.php
require_once("include/test.php");
print_r(TestStatic::$myVar);

该方案无需传递变量，避免函数重复声明，比全局变量更规范，适合作为重构过渡方案。

方案选择建议 #

• 快速修复小体量代码：选方案1
• 长期维护优化：选方案2（彻底解决问题）
• 过渡式优化：选方案3

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