PHP从5.0逐步引入类型声明,7.0后全面支持,可为参数和返回值指定类型以提升代码健壮性;支持标量(int、float、bool、string)、复合(array、callable)及类类型;通过declare(strict_types=1)启用严格模式,避免自动类型转换;返回值类型用冒号声明,支持void表示无返回;nullable类型以?前缀允许null值;正确使用可减少错误并提高可读性。

PHP 中的类型声明(Type Declarations)用于约束变量、函数参数和返回值的数据类型,提升代码的可读性和健壮性。从 PHP 5.0 开始逐步引入,并在 PHP 7 及以上版本中得到全面支持。下面详细介绍常见的类型声明语法与用法。
函数参数类型声明
你可以为函数或方法的参数指定类型,确保传入的值符合预期。
- 标量类型声明:PHP 7.0+ 支持 string、int、float、bool 类型。
- 复合类型:包括 array、callable、self、parent 等。
- 类类型声明:可直接使用类名作为类型提示。
示例:
function add(int $a, float $b): float {
return $a + $b;
}
class User {
public function setName(string $name): void {
$this->name = $name;
}
}
function process(array $data): bool {
return !empty($data);
}
注意:默认情况下,PHP 使用“严格模式”关闭,意味着某些类型会尝试自动转换。要启用严格模式,在文件顶部添加:
立即学习“PHP免费学习笔记(深入)”;
declare(strict_types=1);
开启后,传入的参数必须完全匹配声明类型,否则抛出 TypeError。
返回值类型声明
使用冒号后接类型来声明函数返回值的类型。
- 语法格式:
function func(): ReturnType - 支持所有参数类型中的类型,包括 void(表示不返回任何值)。
示例:
function getAge(): int {
return 25;
}
function logMessage(): void {
echo "Hello";
// 不允许 return 值,或只能 return;
}
nullable 类型声明
如果希望某个参数或返回值可以为 null,可在类型前加问号 ?。
function findUser(int $id): ?User {
return $user ?? null;
}
function setName(?string $name): void {
$this->name = $name;
}
上述例子中,findUser 返回 User 对象或 null,setName 接受字符串或 null。
void 类型说明
void 表示函数不返回任何值。不能返回任何内容(包括 null),除非是空 return 语句。
function doSomething(): void {
// 正确
return;
// 错误:return null; 在 void 函数中不允许显式返回 null
}
基本上就这些。合理使用类型声明能有效减少运行时错误,提高开发效率。记得根据项目需求决定是否开启 strict_types。不复杂但容易忽略细节。











