PHP中安全处理前导零数字：避免八进制解析陷阱的实践指南

<?php

/**
 * 安全地将数字字符串转换为十进制整数。
 * 该函数会严格验证输入，防止前导零被误解析为八进制。
 *
 * @param string $num 待转换的数字字符串。
 * @return int 转换后的十进制整数。
 * @throws \InvalidArgumentException 如果输入不是有效的十进制数字字符串。
 */
function getDecimalNumber(string $num): int
{
    // 使用 FILTER_VALIDATE_INT 验证字符串是否为整数。
    // 该过滤器默认会拒绝八进制和十六进制格式，只接受十进制。
    $decimalNum = filter_var($num, FILTER_VALIDATE_INT);

    // 如果 filter_var 返回 false，表示验证失败，输入不是一个有效的十进制整数。
    if ($decimalNum === false) {
        throw new \InvalidArgumentException("提供的 '$num' 不是一个有效的十进制数字字符串。");
    }

    return $decimalNum;
}

// 示例用法：
try {
    echo "010 (字符串) 解析为: " . getDecimalNumber("010") . PHP_EOL; // 预期抛出异常
} catch (\InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL; // 输出: 错误: 提供的 '010' 不是一个有效的十进制数字字符串。
}

try {
    echo "123 (字符串) 解析为: " . getDecimalNumber("123") . PHP_EOL; // 预期输出 123
} catch (\InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL;
}

try {
    echo "-45 (字符串) 解析为: " . getDecimalNumber("-45") . PHP_EOL; // 预期输出 -45
} catch (\InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL;
}

try {
    echo "0 (字符串) 解析为: " . getDecimalNumber("0") . PHP_EOL; // 预期输出 0
} catch (\InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL;
}

try {
    echo "abc (字符串) 解析为: " . getDecimalNumber("abc") . PHP_EOL; // 预期抛出异常
} catch (\InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL; // 输出: 错误: 提供的 'abc' 不是一个有效的十进制数字字符串。
}

// 注意：如果直接传入整数，PHP会在函数调用前将其转换为字符串，
// 但如果该整数本身就是由八进制字面量表示的，那么在转换为字符串前就已经被解析了。
// 因此，此函数主要用于处理原始的字符串输入。
$octalLiteral = 010; // PHP在此处已经将其解析为十进制的 8
echo "010 (整数字面量) 的值: " . $octalLiteral . PHP_EOL; // 输出 8
// 如果将这个已经解析的整数传给函数，它会再次被转换为字符串 "8"，然后通过验证
echo "getDecimalNumber(string)$octalLiteral 结果: " . getDecimalNumber((string)$octalLiteral) . PHP_EOL; // 输出 8

?>