告别PHP对象属性的隐形坑：如何使用kore/data-object让你的数据更严谨！

function getUserInfo(int $userId): stdClass
{
    // 假设从数据库获取数据
    $data = [
        'id' => $userId,
        'username' => 'john_doe',
        'email' => 'john@example.com',
        'registration_date' => '2023-01-01',
    ];
    return (object) $data;
}

$user = getUserInfo(1);
echo $user->username; // 正常工作

// 某个地方的代码
echo $user->usename; // 这里不会报错！只会得到一个null或者空字符串

composer require kore/data-object

use Kore\DataObject\DataObject;

class User extends DataObject
{
    public int $id;
    public string $username;
    public string $email;
    public string $registration_date;
    // 你也可以定义其他方法，比如一个构造函数来初始化
    public function __construct(array $data = [])
    {
        parent::__construct($data); // 调用父类构造函数来填充属性
    }
}

function getUserInfoStrict(int $userId): User
{
    $data = [
        'id' => $userId,
        'username' => 'john_doe',
        'email' => 'john@example.com',
        'registration_date' => '2023-01-01',
    ];
    return new User($data);
}

$user = getUserInfoStrict(1);

// 尝试访问一个不存在的属性
try {
    echo $user->usename; // 这里会立即抛出异常！
} catch (\Kore\DataObject\Exception\UnknownPropertyException $e) {
    echo "错误：尝试访问未知属性 - " . $e->getMessage() . PHP_EOL;
}

// 正常访问已定义的属性
echo "用户名: " . $user->username . PHP_EOL;

class Address extends DataObject
{
    public string $street;
    public string $city;
}

class UserWithAddress extends DataObject
{
    public string $name;
    public Address $address;

    public function __construct(array $data = [])
    {
        parent::__construct($data);
        if (isset($data['address']) && is_array($data['address'])) {
            $this->address = new Address($data['address']);
        }
    }
}

$originalUser = new UserWithAddress([
    'name' => 'Alice',
    'address' => ['street' => 'Main St', 'city' => 'Anytown']
]);

$clonedUser = clone $originalUser;

// 修改克隆对象的地址
$clonedUser->address->city = 'Newtown';

// 原始对象的地址不会被修改
echo $originalUser->address->city; // 输出：Anytown
echo $clonedUser->address->city;   // 输出：Newtown

class SimpleData extends DataObject
{
    public string $key1;
}

$dataWithExtra = [
    'key1' => 'value1',
    'extra_key' => 'extra_value' // 这个键在SimpleData中未定义
];

// 默认情况下，这里会抛出异常，因为'extra_key'是未知的
// $obj = new SimpleData($dataWithExtra);

// 设置为true，构造时会忽略'extra_key'，不会抛出异常
$obj = new SimpleData($dataWithExtra, true);

echo $obj->key1; // 输出: value1

// 但如果你尝试访问它，仍然会抛出异常
try {
    echo $obj->extra_key;
} catch (\Kore\DataObject\Exception\UnknownPropertyException $e) {
    echo "错误：尝试访问构造时被忽略的未知属性 - " . $e->getMessage() . PHP_EOL;
}