文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

使用Declare(strict_Types=1)来获得更健壮的PHP代码

2024-11-29 21:04

关注

我第一次看到这个声明时,我不知道它是做什么的。我以为这是某种注释,或者是我之前的旧PHP语法,但我错了(大错特错!)。

在这篇文章中,我们将介绍什么是declare(strict_types=1),以及它如何帮助您提高PHP代码的类型安全性。

declare(strict_types=1) 是什么?

declare(strict_types=1)是一个启用PHP严格模式并在PHP应用程序中强制严格类型的语句。

它是在PHP 7.0中添加的,当时类型声明系统首次在PHP中实现。这意味着它可以在PHP 8项目中使用,因此您可以开始在代码中充分利用严格类型。

当你使用这个语句时,PHP会对函数的参数和返回类型进行严格的类型检查。这意味着如果一个函数需要某种类型的参数或返回值,如果使用了错误的类型,PHP将抛出错误。这也适用于具有指定类型提示和返回类型的PHP闭包和箭头函数。

让我们举一个不使用declare(strict_types=1)的简单例子:

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

现在假设我们用字符串参数调用这个函数:

echo add('1', '2');
 
// Output:
// 3

PHP会很高兴地将字符串参数转换为整数并返回结果3。

在某些情况下,您可能完全不介意这种行为。但它可能会产生一些您没有预料到的意外后果,并可能导致应用程序中的错误。

然而,让我们假设我们想在这个例子中使用declare(strict_types=1)。我们可以通过在文件顶部添加以下语句来实现这一点:

declare(strict_types=1);
 
function add(int $a, int $b): int
{
    return $a + $b;
}

现在,如果我们用字符串参数调用add函数,PHP将抛出一个错误:

echo add('1', '2');
 
// Output:
// Fatal error: Uncaught TypeError: Argument 1 passed to add() must be of the type int, string given

正如我们在这里看到的,PHP抛出了一个错误,因为add函数期望传递整数,但却接收到了字符串。

类似地,如果启用了严格的类型检查,并且我们试图从方法返回错误的数据类型,PHP也会抛出错误。例如,假设我们的add函数现在接受浮点数而不是整数,并且我们没有启用严格的类型检查:

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

我们可以这样调用函数:

echo add(1.25, 2.25);
 
// Output:
// 3

你发现输出中的问题了吗?

我们应该得到的答案是3.5。然而,因为我们已经将返回类型定义为int,所以我们已经将浮点数(应该返回的)转换为整数,并失去了精度。可以想象,这可能会在我们应用程序的其他部分导致一些问题,我们正在使用这个结果,并且可能需要精度。

现在让我们通过使用declare(strict_types=1)来解决这个问题:

declare(strict_types=1);
 
function add(float $a, float $b): int
{
    return $a + $b;
}

我们可以这样调用函数:

echo add(1.25, 2.25);
 
// Output:
// Fatal error: Uncaught TypeError: add(): Return value must be of type int, float returned

正如我们所看到的,通过启用严格的类型检查,我们可以发现函数没有返回与返回类型声明匹配的正确数据类型。这很好,因为它可以突出显示我们代码中可能存在的错误,而我们并不知道。然后,我们可以采取必要的步骤:

我应该使用declare(strict_types=1)吗?

我个人认为,在所有的PHP文件中使用declare(strict_types=1)是一个好主意。我曾经认为仅仅有类型提示和返回类型就足以确保传递正确的数据类型,但我现在改变了主意。当我使用declare(strict_types=1)时,我对我的代码更有信心,并且由于使用它而发现了一些bug(特别是当将它添加到旧代码库时)。

由于PHP是一种动态类型的语言(而不是严格类型的语言),这意味着如果你不想的话,你根本不需要指定任何返回类型或类型提示。相反,PHP将在运行时为您确定类型。然而,即使有可能这样做,我还是强烈建议不要这样做。如果你不能在代码中使用严格类型(无论出于什么原因),我仍然建议使用类型提示和返回类型作为最低限度来提高PHP代码质量。

自从了解它以来,我习惯在我创建的每个新PHP文件中使用它。事实上,我更新了PhpStorm设置中的所有模板,以便它自动包含在我创建的每个文件的顶部。例如,下面是创建一个新的PHP类时使用的模板:

这真的很方便,因为它鼓励我继续使用declare(strict_types=1),而不需要在创建文件后进行任何手动更改(我肯定会忘记这样做!)。

对于我的任何Laravel阅读器,您还可以在运行Artisan命令(如php artisan make:controller)时发布用于创建PHP文件的存根。通过发布存根,您可以编辑它们并将declare(strict_types=1)添加到顶部。这意味着您使用Artisan命令创建的文件将在已启用更严格类型安全的情况下创建。

当然,如果您打算对现有文件添加更严格的类型检查,我强烈建议您首先要有一个高质量的测试套件。您的PHP代码可能允许传递不正确的数据类型而不引发任何错误。但是,通过启用严格的类型检查,您的代码将变得不那么宽容,并可能开始抛出错误。这可能会导致应用程序以用户意想不到的方式中断。

您可能还会发现需要重构一些代码,使其与declare(strict_types=1)兼容。但我不认为这是件坏事。相反,我认为这是一个提高代码质量的机会。

为了帮助您将declare(strict_types=1)添加到代码中,您可能需要使用PHPStan之类的工具,它可以为您收集这些类型不匹配。

来源:开源技术小栈内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯