前言升级 PHP 版本时最容易被怀疑的对象之一就是gettype()。典型场景是项目从 PHP 7.4 升到 8.1 之后某个用了好几年的类型判断分支突然不走了日志里打出来的类型名看起来「怪怪的」于是第一反应是「gettype()的返回值在 8.1 里改了」。先给结论免得有人照着错误的前提去改一堆没问题的代码gettype()的返回字符串在 PHP 7.4 和 PHP 8.1 之间一个字都没有变。它返回的仍然是boolean、integer、double、string、array、object、resource、resource (closed)、NULL、unknown type这十个值。这套命名从更早的版本就固定下来了其中一个变化关闭后的资源从unknown type变成resource (closed)发生在 PHP 7.2也比 7.4 更早。那为什么升级之后确实「感觉变了」因为真正变化的是周边PHP 8.0 新增了get_debug_type()它返回一套和类型声明一致的短名字int、float、bool、null对象直接给类名PHP 8.0 移除了(real)强制转换和is_real()别名PHP 8.0 起字符串与数字的比较语义也变了。这些都会让「用gettype()做判断」的老代码表现异常但锅不在gettype()身上。本文给出完整的返回值对照表、一张可运行的验证脚本以及「7.4 到 8.1 之间到底变了什么」的准确清单。一、gettype() 的完整返回值7.4 与 8.1 完全相同下面这张表是gettype()的全部可能输出两个版本一字不差输入的值gettype()返回7.4 / 8.1 相同get_debug_type()返回PHP 8.0nullNULL全大写nulltrue/falsebooleanbool42integerint3.14doublefloatabcstringstring[1, 2]arrayarraynew DateTime()objectDateTime含命名空间的完全限定名new class {}objectclassanonymousfopen(php://memory, r)resourceresource (stream)已fclose()的资源resource (closed)resource (closed)枚举Suit::Hearts8.1objectSuit无法识别的内部类型unknown type视情况而定从表里能读出三件事老命名是历史包袱。integer而不是intdouble而不是floatboolean而不是boolNULL还必须大写。拿gettype($x) float做判断的代码从 PHP 4 起就一直是错的只是没人注意到。对象信息全丢了。gettype()对所有对象一律返回object想知道类名得再调get_class()。PHP 8.0 的get_debug_type()才是升级后的正确选择。它是为「调试输出」设计的命名和类型声明对齐一行就能拿到对象的类名或资源的具体类型。二、7.4 到 8.1 之间真正变了什么把「和类型判断有关」的变化单独列出来这些才是升级后代码行为改变的真正来源。变化引入版本对老代码的影响新增get_debug_type()PHP 8.0提供了更好的替代品gettype()本身没动移除(real)强制转换PHP 8.0(real) $x直接解析报错要改成(float)移除is_real()别名PHP 8.0调用即致命错误改用is_float()is_double()仍在未移除它至今仍是is_float()的别名别误以为没了字符串与数字比较语义变更PHP 8.00 foo从true变成false用gettype()分流再比较的代码会翻车非可数类型传给count()抛TypeErrorPHP 8.0以前是Warning并返回1现在是未捕获异常null传给内部函数的非可空参数被弃用PHP 8.1出现Deprecated: Passing null to parameter ... of type string新增array_is_list()、枚举、neverPHP 8.1类型判断有了更语义化的工具特别注意(real)与is_real()它们和gettype()返回double是同一批「历史命名」PHP 8.0 把它们清掉了。如果你的老代码里有is_real($price)在 7.4 下只是弃用提示到 8.0 会直接抛Error: Call to undefined function is_real()。这是升级中最典型的「类型相关」致命错误。至于gettype()本身从 PHP 7.4 到 8.1 没有任何一条变更日志提到它——因为它确实没被改过。三、判断类型不要用 gettype()gettype()的定位是「给人看的调试信息」不是「给机器用的类型判定」。原因是它返回字符串字符串就有拼写风险而且字符串比较比is_*()慢。意图❌ 不要这么写✅ 应该这么写判断整数gettype($x) int永远不成立is_int($x)判断浮点gettype($x) float永远不成立is_float($x)判断布尔gettype($x) bool永远不成立is_bool($x)判断 nullgettype($x) null永远不成立$x null判断可数gettype($x) arrayis_countable($x)PHP 7.3判断列表手写array_keys($a) range(0, count($a) - 1)array_is_list($a)PHP 8.1调试输出类型gettype($x) . / . get_class($x)get_debug_type($x)PHP 8.0一个具体的陷阱gettype()对true和false都返回boolean对0.0和3.14都返回double。想做类型分发却不写is_*()等于给自己埋雷。而在需要「多分支分发」的场景PHP 8.0 的match表达式配上get_debug_type()反而很合适?php declare(strict_types1); // 需要 PHP 8.0get_debug_type 与 match 都是 8.0 引入的 function describe(mixed $value): string { return match (get_debug_type($value)) { int 整数 . $value, float 浮点数 . $value, bool $value ? 真值 : 假值, null 空值, string 字符串长度 . mb_strlen($value), array 数组 . count($value) . 个元素, default 其他类型 . get_debug_type($value), }; }match用的是全等比较所以int和integer的差别在这里就是致命的——这也正是它比gettype()更安全的原因你会立刻发现写错了。四、完整可运行示例把两个函数的输出并排打出来把下面这段保存成type_diff.php直接运行。它能同时工作于 PHP 7.4 和 PHP 8.1用function_exists判断get_debug_type是否可用跑完你就有一张自己环境上的对照表?php declare(strict_types1); // 需要 PHP 7.4在 PHP 8.0 上会多打印一列 get_debug_type 的结果 $resource fopen(php://memory, r); $closed fopen(php://memory, r); fclose($closed); $samples [ null null, true true, false false, int 42 42, int 0 0, float 3.14 3.14, float 0.0 0.0, string abc abc, string 3.14 3.14, array [] [], array [1,2] [1, 2], object new DateTime(2024-01-01), closure static fn () 1, anonymous new class {}, resource $resource, closed res $closed, ]; $hasDebug function_exists(get_debug_type); // PHP 8.0 printf(%-16s %-18s %s\n, 样本, gettype(), $hasDebug ? get_debug_type() : (需要 PHP 8.0)); echo str_repeat(-, 56), \n; foreach ($samples as $label $value) { printf( %-16s %-18s %s\n, $label, gettype($value), $hasDebug ? get_debug_type($value) : - ); } // 顺带演示一个真实的老代码错误拿 gettype 的结果去比类型声明的名字 $price 19.9; var_dump(gettype($price) float); // 一直就是 false var_dump(is_float($price)); // 正确做法 // PHP 8.0 才会有的行为差异用版本判断隔离 if (PHP_VERSION_ID 80000) { // 字符串与数字的比较8.0 起 0 foo 是 false var_dump(0 foo); }在 PHP 8.1 上的输出大致如下gettype()那一列在 7.4 上完全一致样本 gettype() get_debug_type() -------------------------------------------------------- null NULL null true boolean bool false boolean bool int 42 integer int int 0 integer int float 3.14 double float float 0.0 double float string abc string string string 3.14 string string array [] array array array [1,2] array array object object DateTime closure object Closure anonymous object classanonymous resource resource resource (stream) closed res resource (closed) resource (closed) bool(false) bool(true) bool(false)最后三行是最有说服力的证据gettype()那一列在两个版本间纹丝不动而get_debug_type()才是 8.0 之后新增的那一列。常见坑点1. 拿gettype()的结果去比类型声明的名字❌if (gettype($v) float) { ... }——gettype()返回的是double这个分支永远不会执行而且不会有任何报错。 ✅if (is_float($v)) { ... }或者用get_debug_type($v) float注意后者要 PHP 8.0。2. 以为NULL是小写❌if (gettype($v) null) { ... }——gettype()对 null 返回的是全大写的NULL字符串比较区分大小写。 ✅ 判空直接用$v null这是最不容易写错也最快的写法。3. 升级到 8.0 后is_real()直接报致命错误❌ 老代码里的is_real($x)/(real) $x。——is_real()这个is_float()的别名和(real)强制转换都在 PHP 8.0 被移除了7.4 下还只是弃用提示8.0 起是Error: Call to undefined function。 ✅ 全部替换成is_float()与(float)。注意is_double()至今仍是is_float()的别名并没有被移除不要顺手把它一起改了。4. 用gettype()判断「是不是数字」❌gettype($id) integer用来校验从 JSON 里解出来的$id。——json_decode()会把大整数变成double也会把123保持为string你的判断会静默失败。 ✅ 用is_int($id) || (is_string($id) ctype_digit($id))这类显式规则或者干脆先做一次规范化再判断。5. 在switch里用gettype()做分发却忘了大小写❌switch (gettype($v)) { case integer: ...; case NULL: ...; }里把NULL写成Null、Null写成null分支静默失效。 ✅ 改用match (get_debug_type($v))PHP 8.0配合default分支兜底写错了立刻能看出来。6. 以为gettype()能区分「对象是什么类」❌if (gettype($e) object) { echo $e-getMessage(); }—— 任何对象都会通过这个判断$e是数组或null时才会挂但如果传进来的是stdClass$e-getMessage()就是未定义属性。 ✅ 用if ($e instanceof Throwable) { ... }或者前面加assert()让错误提前暴露。7. 在 PHP 8.1 上忽略null传参弃用提示❌ 从数据库取出的可空字段直接传给mb_strlen()、strlen()、trim()等内部函数 —— 8.1 起会刷Deprecated: Passing null to parameter #1 ($string) of type string is deprecated9.0 会升级成TypeError。 ✅ 传参前显式转换mb_strlen((string) $row[title])或在读取层就把 null 归一化成空串。8. 把gettype()的输出写进接口契约❌ 接口返回{type: double}给前端前端按float去解析 —— 两边对不上而且这套命名随时可能被当成历史包袱清理。 ✅ 对外契约用稳定的业务枚举值如integer | decimal | text内部调试才用get_debug_type()。总结问题结论gettype()在 7.4 与 8.1 之间有变化吗没有返回字符串完全相同什么时候变的resource (closed)是 PHP 7.2 引入的早于 7.4真正新增的是什么get_debug_type()PHP 8.0get_debug_type()强在哪int/float/bool/null与类型声明一致对象返回类名PHP 8.0 移除了什么(real)强制转换、is_real()别名is_double()仍在判断类型该用什么is_int()等is_*()函数、$v null、instanceof、array_is_list()8.1调试打日志该用什么get_debug_type()PHP 8.0所以「PHP 8.1 改了gettype()的返回值」是一个流传很广的误判。真正需要改的是你自己的代码把gettype() float这类永远不成立的分支换成is_float()把is_real()换成is_float()把调试输出换成get_debug_type()。这三步做完升级前后类型判断的行为就完全一致了。