讲师中心 微信公众号
AI工具推荐 视频效率加速

php函数参数类型声明怎么用_php函数参数类型限定【语法】

秋婷吖_9467

秋婷吖_9467

发布时间:2026-02-26 17:24:56

|

523人浏览过

|

来源于php中文网

原创

PHP函数参数类型声明必须写在参数名前,如function foo(Type $param);strict_types=1须为文件首行非空非注释语句;可空类型用?string而非string|null;void仅作返回类型且禁止return值;联合类型中null须用?语法。

php函数参数类型声明怎么用_php函数参数类型限定【语法】

PHP 函数参数类型声明必须写在参数名前面

PHP 7.0+ 支持在函数定义中直接声明参数类型,语法是 function foo(Type $param),不是 function foo($param: Type)(那是 TypeScript 风格,PHP 不认)。漏掉类型或位置写错,会直接报 ParseError。

  • 标量类型(string、int、float、bool)默认开启严格模式才强制校验;否则 PHP 会尝试自动转换(比如把 "123" 转成 int)
  • 类名、接口名、array、callable、iterable、object 这些类型,无论是否启用严格模式,只要传错就立刻抛 TypeError
  • 如果想允许 null,得显式写成 ?string 或 string|null(PHP 8.0+ 推荐前者),光写 string 就不接受 null

strict_types=1 必须放在文件顶部第一行

启用严格类型检查不是靠函数里写类型就能生效的——它依赖 declare(strict_types=1);,而且这行必须是 PHP 文件中**第一个非空白、非注释的语句**。放第二行、被 BOM 或空格顶到前面,都会让声明失效,变成松散类型行为。

  • 这个声明只对当前文件有效,不会影响 include 或 require 的其他文件
  • 没加这行时,int $x = "42" 会静默转成 42;加了之后,直接报 TypeError
  • 常见坑:用 IDE 自动生成文件头(比如版权注释)时,不小心把 declare 挤到了第二行,结果调试半天发现类型没生效

void 返回类型不能有 return 值,但可以 return;

void 表示函数不返回任何值,连 null 都不算合法返回。写成 function foo(): void { return null; } 会触发 Fatal error。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • 正确写法只有两种:return;(显式退出)或直接结束函数体(隐式返回)
  • void 不能作为参数类型,也不能出现在联合类型里(比如 void|string 是语法错误)
  • 注意和没有声明返回类型的函数区别:没声明时,函数可以返回任意值;声明了 void,就彻底禁止返回任何表达式

联合类型(PHP 8.0+)里 null 要用 ? 写法,别混用 | null

PHP 8.0 引入联合类型,比如 string|int,但 null 是个特例:必须用可空语法 ?string,不能写成 string|null(虽然解析器能认,但会触发 Deprecated 警告,PHP 9 会彻底禁用)。

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

  • ?string 等价于 string|null,但前者是官方推荐写法,且更清晰表达“可空”语义
  • 联合类型中不能出现 void、mixed(PHP 8.0 中 mixed 是保留字,不能用于联合类型)
  • 如果函数可能返回多个类型又含 null,比如字符串或整数或空,得写成 string|int|null?不对——要写成 ?string|int?也不对。正确是 string|int 加上函数内允许返回 null 的逻辑,再配合 ?string|int 不合法;实际应选 string|int|NULL 并确保启用了 strict_types=1,但更稳妥是改用 mixed 或封装为返回数组
类型声明看着简单,真正落地时最常卡在 declare(strict_types=1) 的位置、可空语法的写法、以及联合类型中 null 的处理方式上。这几个点不手动验证一遍,很容易以为“写了类型就生效了”。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

312

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

520

2026.02.25

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

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

371

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

286

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

658

2026.06.16

string转int
string转int

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

6739

2023.08.02

css中float用法
css中float用法

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

6907

2024.04.28

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

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

804

2025.10.23

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

120

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn