235

我在 PHP 7 中看到了以下新行,但没有人真正解释它的含义。我用谷歌搜索了它,他们谈论的只是你会启用它还是不喜欢投票类型的东西。

declare(strict_types = 1);

它有什么作用?它如何影响我的代码?我应该这样做吗?

一些解释会很好。

4

2 回答 2

238

来自树屋博客

在 PHP 7 中,我们现在添加了标量类型。具体来说:int、float、string 和 bool。

通过添加标量类型提示和启用严格要求,希望可以编写更正确和自文档化的 PHP 程序。它还使您可以更好地控制代码,并使代码更易于阅读。

默认情况下,标量类型声明是非严格的,这意味着它们将尝试更改原始类型以匹配类型声明指定的类型。换句话说,如果你将一个以数字开头的字符串传递给一个需要浮点数的函数,它将从开头获取数字并删除其他所有内容。将浮点数传递给需要 int 的函数将变为 int(1)。

默认情况下,如果可能,PHP 会将错误类型的值转换为预期的标量类型。例如,为期望字符串的参数提供整数的函数将获得字符串类型的变量。

禁用严格类型(eval):

<?php

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

  echo AddIntAndFloat(1.4, '2');
  /*
  * without strict typing, PHP will change float(1.4) to int(1)
  * and string('2') to float(2.0) and returns int(3)
  */

可以基于每个文件启用严格模式。在严格模式下,只会接受类型声明的确切类型的变量,否则会抛出 TypeError。此规则的唯一例外是可以将整数提供给期望浮点数的函数。来自内部函数的函数调用不受 strict_types 声明的影响。

为了启用严格模式,declare 语句与 strict_types 声明一起使用:

启用严格类型(eval):

<?php declare(strict_types=1);

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

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

  // Integers can be passed as float-points :
  echo AddIntAndFloat(1,1);
  // Fatal error: Uncaught TypeError: Return value of AddIntAndFloat() must be of the type integer, string returned

工作示例:

<?php

declare(strict_types=1);

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

$float = AddFloats(1.5,2.0); // Returns 3.5

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

$int = AddFloatsReturnInt($float,1.5); // Returns 5

function Say(string $message): void // As in PHP 7.2
{
    echo $message;
}

Say('Hello, World!'); // Prints "Hello, World!"

function ArrayToStdClass(array $array): stdClass
{
    return (object) $array;
}

$object = ArrayToStdClass(['name' => 'azjezz','age' => 100]); // returns an stdClass

function StdClassToArray(stdClass $object): array
{
    return (array) $object;
}

$array = StdClassToArray($object); // Returns array

function ArrayToObject(array $array): object // As of PHP 7.2
{
    return new ArrayObject($array);
}

function ObjectToArray(ArrayObject $object): array
{
    return $object->getArrayCopy();
}

var_dump( ObjectToArray( ArrayToObject( [1 => 'a' ] ) ) ); // array(1 => 'a');
于 2018-02-10T17:54:18.927 回答
100

strict_types影响类型强制。

不使用类型提示strict_types可能会导致细微的错误。

在严格类型之前,int $x意味着“$x必须具有可强制转换为 int 的值”。任何可以强制转换为 an 的值int都会传递类型提示,包括:

  • 一个 int 正确的 ( 242),
  • 一个浮点数(10.17),
  • 一个布尔 ( true),
  • null, 或者
  • 带有前导数字 ( "13 Ghosts") 的字符串。

通过设置strict_types=1,你告诉引擎这int $x意味着“$x 只能是一个正确的 int,不允许类型强制。” 你有很大的保证,你得到的是准确的,只有给定的,没有任何转换和潜在的损失。

例子:

<?php
function get_quantity(): int {
    return '100 apples';
}
echo get_quantity() . PHP_EOL;

产生一个可能令人困惑的结果:

Notice: A non well formed numeric value encountered in /Users/bishop/tmp/pmkr-994/junk.php on line 4
100

我认为,大多数开发人员会期望int暗示“只有一个 int”。但它不是,它的意思是“任何像 int 的东西”。启用 strict_types 会给出可能的预期和期望行为:

<?php declare(strict_types=1);

function get_quantity(): int {
    return '100 apples';
}
echo get_quantity() . PHP_EOL;

产量:

Fatal error: Uncaught TypeError: Return value of get_quantity() must be of the type int, string returned in example.php:4

如果您使用类型提示,我认为这里有两个教训:

  • 始终使用strict_types=1
  • 将通知转换为例外,以防您忘记添加strict_types编译指示。
于 2018-12-14T21:11:06.287 回答