PHP 返回类型声明-php教程-PHP中文网

PHP 返回类型声明

P粉390130307

发布： 2025-07-02 14:38:01

原创

793人浏览过

php 7 版本为函数返回值引入了标量类型声明的支持。借助这一功能，开发者可以明确指定函数应返回的数据类型。支持的返回类型包括：

int
float
bool
string
接口（interfaces）
array
callable

函数定义格式如下所示：

function myfunction(type $par1, type $param2): type {
   // 函数体
   return $val;
}

登录后复制

在默认情况下，PHP 解析器使用的是弱类型检查机制。如果希望启用更严格的类型验证，则需要在脚本顶部添加 declare(strict_types=1)。

示例

下面这个例子中我们创建了一个名为 division() 的函数，并将它的返回类型设定为 int：

<?php function division(int $x, int $y): int {
      $z = $x / $y;
      return $z;
   }

   $x = 20.5;
   $y = 10;

   echo "第一个数字: " . $x; 
   echo "\n第二个数字: " . $y; 
   echo "\n除法结果: " . division($x, $y);
??>

登录后复制

由于没有开启严格模式（即未设置 strict_types=1），即使传入的参数并非整型，程序依然可以正常运行并输出以下结果：

立即学习“PHP免费学习笔记（深入）”；

第一个数字: 20.5
第二个数字: 10
除法结果: 2

登录后复制

但如果你在文件开头加上 declare(strict_types=1);，则会触发一个致命错误：

Fatal error: Uncaught TypeError: division(): Argument #1 ($x) must be of type int, float given, called in div.php on line 12 and defined in div.php:3
Stack trace:
#0 div.php(12): division(20.5, 10)
#1 {main}
   thrown in div.php on line 3

登录后复制

而且，在你编写代码时，VS Code 等编辑器就已经能显示出相关错误提示：

PHP 返回类型声明

再看另一个示例

如果你想让 division() 函数返回 float 类型而非 int，可以尝试将分子强制转换为浮点数，然后观察 PHP 是否抛出错误：

<?php // declare(strict_types=1);
   function division(int $x, int $y): int {
      $z = (float)$x / $y;
      return $z;
   }

   $x = 20;
   $y = 10;

   echo "第一个数字: " . $x; 
   echo "\n第二个数字: " . $y; 
   echo "\n除法结果: " . division($x, $y);
??>

登录后复制

取消顶部 declare 行的注释后运行代码，你会看到类似如下的致命错误信息：

第一个数字: 20
第二个数字: 10
PHP Fatal error:  Uncaught TypeError: division(): Return value must be of type int, float returned in /home/cg/root/14246/main.php:5
Stack trace:
#0 /home/cg/root/14246/main.php(13): division()
#1 {main}
  thrown in /home/cg/root/14246/main.php on line 5

登录后复制

以上就是PHP 返回类型声明的详细内容，更多请关注php中文网其它相关文章！