PHP接口返回数字串转整型注意啥？判空与格式优先

PHP接口处理数字字符串转整型前必须先判空，因null、""、"null"或空白符直接(int)会转为0；应使用isset()、is_string()和trim()组合校验，再用filter_var(..., FILTER_VALIDATE_INT)确保合法性。

PHP 接口返回数字字符串转整型前必须判空

接口返回的 $data['id'] 看似是 "123"，但可能是 null、""、"null" 甚至空白符（如 "\t\n "）。直接 (int) 或 intval() 会把空值转成 0，掩盖真实问题。

• 用 isset($data['id']) && is_string($data['id']) && trim($data['id']) !== '' 先兜底
• 避免仅用 !empty($data['id'])：它对 "0" 也返回 false，而 "0" 是合法数字字符串
• 若上游可能返回 null，优先用 filter_var($data['id'], FILTER_VALIDATE_INT) !== false，它天然拒绝空值和非数字结构

数字字符串含前导零或科学计数法时别硬转 (int)

(int) "0123" 得到 123（PHP 会当八进制？不，PHP 8+ 已废弃八进制解释，但前导零仍是歧义信号），而 (int) "1e3" 得到 1 —— 因为 (int) 截断小数点前部分，不是解析浮点再转整。

• 要保留语义：用 filter_var($str, FILTER_VALIDATE_FLOAT) 先确认是否可安全表示为数字，再 (int)round(...) 或 intval(..., 10)
• 明确禁止前导零：正则 /^\d+$/ 配合 trim() 检查；允许负号就用 /^-?\d+$/
• 接口文档若约定数字字符串不含前导零，建议在接收后加断言：assert($str === (string)(int)$str, 'leading zero detected')

intval() 的基数参数不填默认是 10，但易被忽略

写 intval("0xFF") 得到 0（因默认按十进制解析），而 intval("0xFF", 0) 才能自动识别 0x 前缀。但接口数据几乎不会带 0x，强行设 0 反而引入风险。

• 始终显式传 10：intval($str, 10)，杜绝意外进制推断
• intval("", 10) 返回 0，所以仍需前置判空，不能依赖它报错
• 性能上 (int) 略快于 intval()，但差异微乎其微，可读性和安全性优先

JSON 接口返回数字被 PHP 自动转成 float？小心精度丢失

如果接口返回的是 {"id": 9223372036854775807}（即 PHP_INT_MAX），而你用 json_decode($json, true)，在 32 位系统或某些旧版本中，大整数会被转成 float，再强转 (int) 就溢出变 PHP_INT_MAX 或负数。

• 用 json_decode($json, true, 512, JSON_BIGINT_AS_STRING) 强制大数保持字符串
• 之后再对字段做字符串校验 + filter_var(..., FILTER_VALIDATE_INT)
• 不要依赖 is_int() 判断结果类型，它对字符串数字永远返回 false

实际处理链路常是：接收 → trim() → 正则粗筛 → filter_var(..., FILTER_VALIDATE_INT) → 业务逻辑。中间任何一环跳过，都可能让脏数据漏进数据库或计算逻辑。尤其注意 JSON 解析选项和空格/不可见字符——它们比想象中更常出现。