declare(strict_types=1)必须置于PHP文件首行(

PhpStorm 本身不“开启 PHP 严格模式”,declare(strict_types=1) 是 PHP 解释器的运行时行为,由你写的代码控制——IDE 只负责识别、提示和协助你正确使用它。
怎么在文件里正确启用 strict_types
严格模式不是 PhpStorm 的设置项,而是一行必须出现在 PHP 文件最顶部(紧接 后)的声明:
-
declare(strict_types=1)必须是文件中第一个可执行语句(注释、空白行可以有,但不能有 echo、$var = ... 等) - 它只对当前文件生效,不会影响
include或require的其他文件 - 值为
0或不写,就是弱类型模式;只有显式写1才开启严格检查 - 如果放错位置(比如在
echo后面),PHP 会直接报Parse error: declare() must be used at the beginning
PhpStorm 怎么帮你写对 strict_types
虽然 PhpStorm 不“开启”它,但它能显著降低写错概率:
- 新建文件时选
New → PHP File,模板默认不带declare,但你可以编辑模板:Settings → Editor → File and Code Templates → Files → PHP File,把declare(strict_types=1);加到下一行 - 输入
declare后按Tab,PhpStorm 会自动补全完整语法并高亮错误位置(比如发现前面有输出就标红) - 当你调用带类型声明的函数却传了错误类型(如传字符串给
int参数),PhpStorm 会在编辑器里直接标黄警告,并在悬停时显示Expected int, got string - 配合
PHPStan或Psalm插件,还能在编码阶段提前发现跨文件的 strict_types 不一致问题
为什么写了 strict_types 却没报错?常见失效原因
现象:加了 declare(strict_types=1),但 add("5", "3") 还是返回 8,没抛 TypeError——大概率是下面某条出了问题:
立即学习“PHP免费学习笔记(深入)”;
- 文件没被 PHP 解释器真正执行(比如你在 PhpStorm 里双击打开但没运行;或用浏览器访问时,Web 服务器没加载该文件)
-
declare前有 BOM 字符、空格、UTF-8 签名,导致它不是“第一个语句”(用十六进制编辑器或file -i filename.php检查编码) - 你测试的是另一个没加
declare的文件,而函数定义和调用分在两个文件里——strict_types 不跨文件生效 - PHP 版本低于 7.0(strict_types 是 PHP 7.0+ 特性),运行
php -v确认版本
最容易被忽略的一点:strict_types 不是项目级开关,也不是 PhpStorm 设置项,它是一行代码、一个文件、一次声明。你得亲手在每个需要强类型的文件顶部写上它,而且得写对位置、写对语法——IDE 可以提醒你,但没法替你决定要不要用。











