从'混合到`void'：php返回类型声明的实用指南

通过指定函数必须返回的内容，返回PHP中的类型提高了代码的可靠性和清晰度。 2。使用字符串，数组或DateTime等基本类型来执行正确的返回值并尽早捕获错误。 3。应用无效类型？ （例如？字符串）何时为有效的返回值。 4.使用void进行执行操作的功能而无需返回数据，仅允许返回；或没有返回声明。 5。php 8.0中的利用联合类型（例如，字符串| int | bool）用于返回多种不同类型的功能。 6.更喜欢明确的返回类型声明，而不是混合的隐式，以增强IDE支持和可维护性。 7.避免过度使用工会类型并混合，保留在任何类型的预期的情况下混合使用。 8.通过将返回类型与其行为对准，例如将false转换为null的null来仔细处理内部PHP功能。 9。不要在空隙函数中返回null以防止混乱，即使在技术上允许。 10。从核心逻辑和API开始，逐步采用返回类型，以使代码更容易预测，更容易发生错误，同时保持可读性和意图。

PHP的类型系统自早期以来就已经显着发展，而返回类型声明是编写更可预测和可维护的代码的基石。如果您曾经使用过松散键入的PHP功能（无需任何明确的合同而没有任何明确的合同null ，您可能会遇到难以追踪的错误。这就是返回类型的来源。

从PHP 7.0开始，您现在可以指定功能应返回的功能，从而帮助引擎和队友了解您的代码意图。本指南使您无法使用不使用类型（ mixed并非总是明确的）来拥抱void ，并提供实践的例子和最佳实践。

为什么返回类型很重要

在研究语法之前，值得了解为什么返回类型会有所帮助：

• 尽早捕获错误：当您期望字符串时返回数组？ PHP会抛出TypeError。
• 提高代码可读性：任何阅读您的功能的人都知道会发生什么。
• 启用更好的IDE支持：自动完成，重构和直列文档变得更加准确。
• 鼓励故意设计：您对您的功能应该返回的内容更加努力。

没有返回类型，所有内容都是mixed ，这是任何类型的值。虽然灵活，但这会导致不确定性。返回类型可让您缩小范围。

基本返回类型：从字符串到对象

您可以声明所有常见类型的退货类型：

函数getUsername（）：字符串{
    返回“爱丽丝”；
}

函数getUserData（）：array {
    返回['name'=>'alice'，'age'=> 30];
}

函数CreateTateTion（）：DateTime {
    返回new dateTime（）;
}

如果您违反合同：

函数getUsername（）：字符串{
    返回null; //致命错误：返回值必须是类型字符串，null返回
}

除非您允许使用无效类型显式null ：

 function getUsername（）：？string {
    返回null; //这现在有效
}

这?前缀表示“这种类型或无效”。

何时使用void ：不返回任何东西的函数

当功能执行操作时，请使用void ，但不会返回有意义的数据（例如记录，打印或修改状态）。

函数logmessage（字符串$消息）：void {
    file_put_contents（'log.txt'，$message。php_eol，file_append）;
    //无需返回语句
}

或带有明确的return; ：

功能Abortifnotadmin（用户$用户）：void {
    如果（！$ user-> isadmin（））{
        死（“访问被拒绝”）；
    }
    返回; //可选，但允许
}

void的关键规则：

• 您无法返回值： return 5; →致命错误。
• return;没有允许的值（与不返回相同）。
• null也不是有效的返回值。

这实现了这样的想法：“此功能可以做点什么，但没有给您任何回报。”

处理具有工会类型的可选或多种类型（PHP 8.0）

在PHP 8.0之前，您无法表达“返回字符串或布尔”。现在您可以：

函数finduser（int $ id）：？user {
    //返回用户或null
}

工会类型更好：

功能processInput（$ input）：字符串| int | bool {
    如果（$ input ===''）{
        返回false;
    }
    if（is_numeric（$ input））{
        返回（int）$输入;
    }
    返回装饰（$输入）;
}

这使得返回合同明确而不是将其作为无证件的mixed 。

？提示：避免过度使用工会类型。如果功能返回太多类型，请考虑是否做得太多。

常见的陷阱和最佳实践

这里有几件事要注意：

• 不要仅仅为此添加类型
  从关键功能（API，核心逻辑）开始，而不是每个助手。

• 小心内部PHP功能
  有些人在失败时返回false （例如， strpos() ）。匹配期望：

  函数FindPosition（字符串$ Haystack，字符串$针）：？int {
      $ pos = strpos（$ haystack，$针）;
      返回$ pos === false？ null：$ pos;
  }

  现在返回类型是?int ，哪个比int|false更清晰。

• 有意使用mixed （PHP 8.0）
  如果功能真正接受或返回任何类型，请使用mixed ：

  函数debugprint（混合$ value）：void {
      var_dump（$ value）;
  }

  这总比没有类型的提示好。

• 避免return null;在void函数中
  虽然允许，但它可能会使读者感到困惑。除非您提早退出，否则请return 。

---

概括

从未型（由公约mixed ）转移到良好的功能使您的PHP代码更加稳健：

• 当您知道返回值时，请使用特定类型（ string ， array ， User ）。
• 使用?Type null有效响应。
• 使用void用于仅副作用的功能。
• 预期多种类型时，请使用联合类型（ string|int ）。
• 谨慎和故意使用mixed 。

目标不是在最大程度上键入所有内容，而是要使您的代码的行为更清晰，更容易出错。

基本上：如果您的函数承诺返回类型，请确保它保持这一承诺。 PHP将帮助您执行它。

以上是从'混合到`void'：php返回类型声明的实用指南的详细内容。更多信息请关注PHP中文网其他相关文章！