0

0

PHP中的类型声明:如何在PHP中使用严格类型检查

穿越時空

穿越時空

发布时间:2025-06-07 20:45:01

|

1078人浏览过

|

来源于php中文网

原创

php 7.0 引入类型声明并支持严格模式,提升代码健壮性。1. 启用方式是在文件顶部添加 declare(strict_types=1); 且必须为第一行;2. 类型声明支持 int、float、string、bool 等基本类型,array、callable 等复合类型,以及类、接口、联合类型(php 8.0+)、可空类型(?type)等;3. 可对函数参数和返回值进行类型约束,传参或返回类型不匹配会抛出 typeerror;4. 返回值类型声明可确保函数返回预期结构,支持使用 ?type 表示可能返回 null;5. 严格类型检查仅影响当前文件,对第三方库无强制要求,性能开销小;6. 即不启用严格模式,类型声明仍有助于 ide 提供更好提示。类型声明配合严格模式使 php 在团队协作和长期维护中更清晰安全,只需在开头添加声明并按需标注类型即可。

PHP中的类型声明:如何在PHP中使用严格类型检查

PHP 从 7.0 开始引入了类型声明功能,让开发者可以更清晰地定义变量、函数参数和返回值的类型。虽然 PHP 是一种弱类型语言,但通过使用严格类型检查(strict mode),可以让代码更健壮、减少潜在错误。


启用严格类型检查

在 PHP 中启用严格类型检查非常简单,只需要在脚本文件的顶部加上一行:

declare(strict_types=1);

这一行必须是文件的第一行内容,不能有任何输出或空白字符在它之前。一旦开启,PHP 就会对函数参数、返回值等进行严格类型检查。例如:

立即学习PHP免费学习笔记(深入)”;

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

add(1, 2);      // 正常
add("1", 2);    // 报错:Argument 1 passed to add() must be of the type int, string given

如果传入的参数类型不匹配,PHP 会抛出 TypeError 错误。


类型声明支持的数据类型

PHP 支持多种类型的声明,包括基本类型和复合类型:

Otter.ai
Otter.ai

一个自动的会议记录和笔记工具,会议内容生成和实时转录

下载
  • 基本类型

    • int
    • float
    • string
    • bool
  • 复合类型

    • array
    • callable
    • iterable
    • object
  • 类与接口: 你可以直接指定某个类或接口作为参数类型:

class User {}
function greet(User $user) {
    echo "Hello!";
}
  • 联合类型(Union Types)(PHP 8.0+): 如果一个参数可以接受多个类型,可以用 | 来声明:
function setPrice(float|int $price) {
    // ...
}
  • 可空类型(Nullable Types): 允许参数为 null,写法是在类型前加个问号:
function setName(?string $name) {
    // $name 可以为 null 或字符串
}

返回值类型声明

除了参数类型之外,还可以对函数的返回值进行类型声明。这有助于确保函数始终返回预期的数据结构:

function getAge(): int {
    return '30'; // 严格模式下会报错,因为返回的是字符串而不是整数
}

如果你希望函数可能返回 null,也可以使用可空类型:

function findUser(int $id): ?User {
    // 如果找不到用户,可以返回 null
}

注意事项和常见问题

  • 只影响当前文件declare(strict_types=1); 只会影响当前文件中的函数调用行为,不会影响被调用的其他文件。
  • 第三方库兼容性:有些老项目或第三方库没有使用类型声明,调用它们时可能会出现类型不匹配的问题。
  • 性能影响不大:类型检查带来的性能开销可以忽略不计,主要是编译期的行为。
  • IDE 更好提示:即使不开启严格模式,类型声明也能帮助 IDE 提供更好的自动补全和错误提示。

基本上就这些。类型声明配合严格模式,能让你的 PHP 代码更清晰、更安全,尤其是在团队协作或长期维护中特别有用。只要记得在文件开头加上那句声明,剩下的就是按需加上类型标注了。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

338

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

225

2025.10.31

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

138

2026.02.12

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1051

2023.08.02

css中float用法
css中float用法

css中float属性允许元素脱离文档流并沿其父元素边缘排列,用于创建并排列、对齐文本图像、浮动菜单边栏和重叠元素。想了解更多float的相关内容,可以阅读本专题下面的文章。

595

2024.04.28

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

108

2025.10.23

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号