PHP中get()和set()魔术方法详解与实例

Cora

发布时间：2026-10-14 | 4人浏览过

原创

在PHP面向对象编程中，类的属性通常被定义为私有(private)以增强封装性。然而，这导致外部无法直接读写属性。本文将深入解析__get()和__set()这两个魔术方法的使用场景，通过具体代码示例展示如何利用它们实现对私有属性的安全赋值、获取以及逻辑校验，是掌握PHP高级特性的重要一步。

结果或目标

实现一个安全的类属性访问机制：无需编写繁琐的Getter/Setter方法，即可在外部直接通过对象->属性名进行读写，同时在内部自动触发拦截逻辑（如日志记录、数据校验或默认值处理），保持接口简洁且具备高内聚性。

准备条件

已安装支持PHP 5及以上版本的运行环境。
理解面向对象的基本概念：类、对象、成员属性及访问控制权限（public/private）。
明确魔术方法(Magic Methods)的概念：由PHP引擎在特定时刻自动调用的特殊方法，需以双下划线开头。

真实操作顺序

第1步：定义包含私有属性的基础类

创建一个简单的业务类（如Person），将其核心属性声明为private。这是使用__get/__set的前提，因为公共属性直接可见，无需拦截。

<?php
class Person
{
    private $name;   // 姓名
    private $sex;    // 性别
    private $age;    // 年龄
}

第2步：实现__set()方法进行属性赋值拦截

当尝试从类外部对私有属性赋值时（如$object->prop = value），PHP会检测并调用此方法。该方法接收两个参数：属性名($name)和要赋的值($value)。

目的：统一处理属性写入逻辑，例如数据类型检查、格式转换或拒绝非法值。
关键代码结构：

// 将魔术方法也设为private或public均可，通常配合private属性使用
private function __set($property_name, $value)
{
    // 这里可以添加自定义逻辑，例如：
    if ($property_name === 'age') {
        if (!is_int($value) || $value < 0 || $value > 120) {
            echo "无效的年龄值\n";
            return;
        }
    }
    // 执行实际赋值
    $this->$property_name = $value;
}

第3步：实现__get()方法进行属性读取拦截

当尝试从类外部获取私有属性值时（如echo $object->prop），PHP会自动调用此方法。它接收一个参数：欲获取的属性名($name)，返回该属性的实际值。

目的：统一处理属性读取逻辑，例如计算衍生数据、提供默认值或防止未初始化访问报错。
关键代码结构：

private function __get($property_name)
{
    if (isset($this->$property_name)) {
        return $this->$property_name;
    } else {
        // 如果属性不存在或未设置，可返回null或其他默认状态
        return null;
    }
}

第4步：整合完整代码并进行测试验证

将上述方法组合在一个完整的PHP文件中，实例化对象并模拟外部调用，观察输出结果以确认魔术方法是否生效。

<?php
class Person
{
    private $name;
    private $sex;
    private $age;

    // 赋值拦截器
    private function __set($property_name, $value)
    {
        // 可选：在此处打印日志或做简单校验
        $this->$property_name = $value;
    }

    // 取值拦截器
    private function __get($property_name)
    {
        if (isset($this->$property_name)) {
            return $this->$property_name;
        }
        return null;
    }
}

// 1. 实例化对象
$p1 = new Person();

// 2. 直接赋值，底层自动触发__set()
$p1->name = "张三";
$p1->sex = "男";
$p1->age = 20;

// 3. 直接读取，底层自动触发__get()
echo "姓名：" . $p1->name . "<br>";
echo "性别：" . $p1->sex . "<br>";
echo "年龄：" . $p1->age . "<br>";
?>

第5步：分析执行流程与输出结果

运行上述代码后，程序行为如下：

执行$p1->name = "张三"时，由于$name是私有属性且类中存在__set()，引擎自动调用__set('name', '张三')完成赋值。
执行echo $p1->name时，同理自动调用__get('name')并返回值。
注意：如果没有定义__set()而试图给私有属性赋值，或者没有定义__get()而试图读取私有属性，PHP将会抛出Fatal Error。

完成判断

通过浏览器或命令行执行代码，若能正常输出“姓名：张三”、“性别：男”等预期内容，且在赋值/读取过程中无致命错误提示，则说明__get和__set魔术方法配置成功。可以通过修改访问权限为strict模式或故意访问不存在的属性来进一步测试边界情况。

原文有依据的排错

问题：在外部直接访问非私有（如public）属性是否会触发__get？
解答：不会。__get和__set仅针对不可访问的成员属性（private/protected）生效。如果属性是public的，直接存取即可，绕过这两个魔术方法。
问题：属性不存在时会发生什么？
解答：如果访问的是一个从未在类中声明的属性，且该类使用了__get，通常会返回null（如果在__get中做了isset判断）或直接触发notice/error，取决于具体的实现逻辑。建议在使用前确认属性是否存在。