本文讲解 php 中类内访问外部变量的两种主流方法：依赖注入（通过构造函数或 setter 方法）和参数传递，避免“undefined variable”错误，提升代码可维护性与可测试性。
本文讲解 php 中类内访问外部变量的两种主流方法：依赖注入（通过构造函数或 setter 方法）和参数传递，避免“undefined variable”错误，提升代码可维护性与可测试性。
在 PHP 面向对象开发中，常见误区是将全局变量（如数据库连接 $connection）直接在类方法中引用，导致 Notice: Undefined variable 错误。根本原因在于：类作用域与全局作用域相互隔离，类内部无法自动访问外部定义的变量。解决该问题的核心原则是——显式传递依赖，而非隐式依赖全局状态。
✅ 推荐方案一：使用成员属性 + Setter 注入（推荐）
这是更清晰、更易测试的设计方式。通过私有属性存储连接对象，并提供 setConnection() 方法在实例化后注入依赖：
class Article {
private $connection;
public function setConnection($conn) {
if ($conn instanceof PDO || method_exists($conn, 'prepare')) {
$this->connection = $conn;
} else {
throw new InvalidArgumentException('Invalid database connection object');
}
}
public function getConnection() {
if (!$this->connection) {
throw new RuntimeException('Database connection not set. Call setConnection() first.');
}
return $this->connection;
}
public function add_articles() {
$connection = $this->getConnection(); // 安全获取连接
require "add_article.php";
$username = $_POST['username'] ?? '';
$amount = $_POST['amount'] ?? '';
$comment = $_POST['comment'] ?? '';
$stmt = $connection->prepare("INSERT INTO items(item_name, amount, comment) VALUES(:username, :amount, :comment)");
$stmt->bindParam(':username', $username);
$stmt->bindParam(':amount', $amount);
$stmt->bindParam(':comment', $comment);
$stmt->execute();
}
}使用时只需两步：
$call = new Article(); $call->setConnection($connection); // 显式注入依赖 $call->poll();
? 优势：解耦性强，便于单元测试（可传入 Mock 连接）；支持运行时动态切换连接；符合 SOLID 原则中的依赖倒置原则。
立即学习“PHP免费学习笔记（深入）”；
✅ 方案二：通过方法参数传递（适用于简单场景）
若仅在特定方法中需连接，也可将 $connection 作为参数传入：
public function add_articles($connection) {
require "add_article.php";
// ... 同上，直接使用 $connection
}
// 调用方式：
$call->add_articles($connection);但注意：poll() 方法本身也需接收并透传该参数，否则逻辑链断裂：
public function poll($connection = null) {
$test = $_GET['page'] ?? '';
if ($test === 'add_article') {
$this->add_articles($connection); // 必须透传
} elseif ($test === 'my_articles') {
$this->my_articles();
}
}
// 调用：$call->poll($connection);⚠️ 不推荐全局 global $connection 或 $GLOBALS：破坏封装性，难以追踪依赖，阻碍自动化测试，且在严格模式下可能被禁用。
? 安全与健壮性增强建议
-
类型校验：在
setConnection()中验证对象是否具备prepare()方法（如 PDO 或兼容接口），防止传入无效值； -
空值防护：
getConnection()中抛出异常，避免静默失败； -
避免
require内部逻辑：add_article.php应只负责 HTML 渲染，业务逻辑（如数据处理、SQL 执行）应完全保留在类方法中，提升可测试性； -
考虑构造函数注入（更优实践）：
public function __construct($connection) { $this->setConnection($connection); } // 实例化：$call = new Article($connection);
综上，始终优先选择显式依赖注入，而非依赖作用域外的变量。这不仅是解决报错的手段，更是构建可维护、可扩展 PHP 应用的关键习惯。
