PHP函数如何设置函数的返回类型 PHP函数返回类型声明的基础教程-php教程-PHP中文网

PHP函数如何设置函数的返回类型 PHP函数返回类型声明的基础教程

雪夜

发布： 2025-08-15 22:26:01

原创

233人浏览过

PHP函数返回类型声明可提升代码健壮性和可读性，从7.0版本开始支持，在函数参数后用冒号加类型标注，如int、string、void等，启用strict_types=1时将严格校验类型，避免运行时错误，逐步添加并结合静态分析工具可有效迁移旧代码。

php函数如何设置函数的返回类型 php函数返回类型声明的基础教程

PHP函数的返回类型声明，简单来说，就是告诉PHP这个函数会返回什么类型的数据。这能帮助我们写出更健壮、更容易维护的代码。

返回类型声明其实是在函数声明时，在参数列表后面加上冒号

登录后复制

，然后写上返回类型。比如

function myFunction(): string { ... }

登录后复制

就表示这个函数应该返回一个字符串。

PHP从7.0版本开始支持返回类型声明。

解决方案

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

要设置PHP函数的返回类型，你可以这样做：

基本语法:
```
<?php
function add(int $a, int $b): int {
  return $a + $b;
}

echo add(2, 3); // 输出 5
?>
```
登录后复制
这里
```
add
```
登录后复制
函数接受两个整数作为参数，并声明返回一个整数。如果函数返回的值不是整数，PHP会尝试强制转换。如果无法转换，就会抛出一个
```
TypeError
```
登录后复制
错误（如果启用了严格模式
```
declare(strict_types=1);
```
登录后复制
）。
支持的返回类型:

PHP支持以下返回类型：
- ```
int
```
  登录后复制
  (整数)
- ```
float
```
  登录后复制
  (浮点数)
- ```
string
```
  登录后复制
  (字符串)
- ```
bool
```
  登录后复制
  (布尔值)
- ```
array
```
  登录后复制
  (数组)
- ```
object
```
  登录后复制
  (对象)
- ```
callable
```
  登录后复制
  (可调用类型，比如函数或方法)
- ```
iterable
```
  登录后复制
  (可迭代类型，比如数组或实现了
```
Traversable
```
  登录后复制
  接口的对象)
- ```
void
```
  登录后复制
  (无返回值)
- ```
mixed
```
  登录后复制
  (可以返回任何类型，PHP 8.0 引入)
- 类/接口名 (返回该类的实例或实现了该接口的对象)
- ```
self
```
  登录后复制
  (返回当前类的实例)
- ```
parent
```
  登录后复制
  (返回父类的实例)
- ```
static
```
  登录后复制
  (返回静态绑定的类的实例，PHP 8.0 引入)
```
void
```
登录后复制
返回类型:

如果函数没有返回值，可以使用
```
void
```
登录后复制
声明。
```
<?php
function logMessage(string $message): void {
  error_log($message);
}

logMessage("This is a log message.");
?>
```
登录后复制
声明为
```
void
```
登录后复制
的函数如果尝试返回任何值（包括
```
null
```
登录后复制
），都会抛出错误。

即构数智人
即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

36

查看详情

可为空的返回类型:

可以使用

登录后复制

符号来声明一个可为空的返回类型。

<?php
function findUser(int $id): ?string {
  // 假设从数据库查找用户
  if ($id == 1) {
    return "John Doe";
  } else {
    return null;
  }
}

echo findUser(1); // 输出 John Doe
echo findUser(2); // 输出 空字符串 (因为 null 被转换为字符串)
?>

登录后复制

?string

登录后复制

表示函数可以返回一个字符串或者

null

登录后复制

。

严格模式:

为了更严格地执行类型检查，可以在文件开头加上
```
declare(strict_types=1);
```
登录后复制
。启用严格模式后，PHP不会尝试自动类型转换，如果返回类型不匹配，会直接抛出
```
TypeError
```
登录后复制
错误。
```
<?php
declare(strict_types=1);

function add(int $a, int $b): int {
  return $a + $b;
}

echo add(2, 3); // 输出 5
// echo add(2, "3"); // 抛出 TypeError，因为 "3" 不是整数
?>
```
登录后复制