如何将PHP中对象转float/int的警告转为错误（仅指定类）

原始类代码 #

class ValueObject
{
    public function __construct(public string $value)
    {
    }

    public function __toString(): string
    {
        return $this->value . "; this I can control";
    }
}

问题场景 #

当前该类的实例被强制转换为int、float、bool类型时，会返回无意义的真值1/true，不符合预期：

$object = new ValueObject('42');
print_r([
    (int) $object,  // 应抛出错误
    (float) $object,  // 应抛出错误
    (bool) $object, // 应抛出错误，仅针对此类实例，若无法实现也可接受
    (string) $object, // 可通过::__toString()抛出错误
]);

执行后输出：

Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 42; this I can control
)

转换int和float时会触发PHP警告，但程序仍继续运行，返回无意义数值：

PHP Warning:  Object of class Application\ValueObject could not be converted to int 
PHP Warning:  Object of class Application\ValueObject could not be converted to float

需求 #

• 将针对该类实例的int/float转换警告转为错误，终止程序执行
• 仅针对该类实例生效，不全局修改错误处理规则（遗留代码限制）
• 当前使用PHP 8.0.30，已知可通过__toString()处理字符串转换，但PHP无__toFloat()/__toInt()魔术方法

解决方案 #

方法1：临时错误处理拦截（实例级生效） #

在类的构造函数中注册临时错误处理函数，仅拦截当前实例的转换警告并转为错误，同时在程序结束时恢复默认处理：

class ValueObject
{
    public function __construct(public string $value)
    {
        $handler = function(int $errno, string $errstr): bool {
            // 精准匹配本类的转换警告
            if (str_contains($errstr, 'Object of class Application\ValueObject could not be converted')) {
                throw new \ErrorException($errstr, 0, $errno);
            }
            // 其他错误交给默认处理逻辑
            return false;
        };

        set_error_handler($handler);
        // 注册终止回调，恢复默认错误处理
        register_shutdown_function(fn() => restore_error_handler());
    }

    public function __toString(): string
    {
        // 若禁止字符串转换，直接抛出错误
        // throw new \InvalidArgumentException('ValueObject不允许转换为字符串');
        return $this->value . "; this I can control";
    }
}

方法2：利用WeakMap实现精准实例拦截 #

通过WeakMap跟踪类实例，在全局错误处理中仅针对本类实例抛出错误，避免影响其他代码：

use WeakMap;

class ValueObject
{
    private static WeakMap $trackedInstances;

    public function __construct(public string $value)
    {
        // 初始化全局错误处理（仅执行一次）
        if (!isset(self::$trackedInstances)) {
            self::$trackedInstances = new WeakMap();
            set_error_handler(function(int $errno, string $errstr): bool {
                if (preg_match('/Object of class (\w+\\\ValueObject) could not be converted to (int|float)/', $errstr, $matches)) {
                    // 回溯调用栈，确认是否为本类实例的转换操作
                    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
                    foreach ($trace as $frame) {
                        if (isset($frame['object']) && $frame['object'] instanceof self) {
                            throw new \ErrorException("ValueObject禁止转换为{$matches[2]}类型", 0, $errno);
                        }
                    }
                }
                return false;
            });
        }
        // 跟踪当前实例
        self::$trackedInstances[$this] = true;
    }

    public function __toString(): string
    {
        // 按需禁止字符串转换
        // throw new \InvalidArgumentException('ValueObject不允许转换为字符串');
        return $this->value . "; this I can control";
    }
}

补充说明 #

• bool转换：PHP中对象默认会转为true，无法通过魔术方法直接拦截，只能通过代码规范约束或在业务逻辑中提前检查类型
• 字符串转换：若需要禁止，直接在__toString()中抛出InvalidArgumentException即可

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