Объявления скалярных типов и объявления типов возвращаемых значений в PHP

PHP 7 新特性Новые возможности PHP 7


Объявления скалярных типов

По умолчанию все файлы PHP находятся в режиме слабой проверки типов.

PHP 7 добавляет возможность объявления скалярных типов. Существует два режима объявления скалярных типов:

  • Режим принудительного приведения (по умолчанию)
  • Строгий режим

Синтаксис объявления скалярного типа:

declare(strict_types=1); 

В коде укажите значение strict_types (1 или 0). 1 обозначает режим строгой проверки типов, который применяется к вызовам функций и операторам return; 0 обозначает режим слабой проверки типов.

Можно использовать следующие параметры типов:

  • int

  • float

  • bool

  • string

  • интерфейсы

  • array

  • вызываемый объект

Пример режима принудительного приведения

Пример

<?php
// Режим принудительного приведения
function sum(int ...$ints)
{
   return
array_sum($ints);
}

print(
sum(2, '3', 4.1));
?>

Вывод вышеприведённой программы:

9

В примере параметр 4.1 преобразуется в целое число 4 перед добавлением.

Пример строгого режима

Пример

<?php
// Строгий режим
declare(strict_types=1);

function
sum(int ...$ints)
{
   return
array_sum($ints);
}

print(
sum(2, '3', 4.1));
?>

Поскольку приведённая выше программа использует строгий режим, если в параметре появится нецелочисленный тип, будет выдана ошибка. Вывод при выполнении:

PHP Fatal error:  Uncaught TypeError: Argument 2 passed to sum() must be of the type integer, string given, called in……

Объявления типа возвращаемого значения

В PHP 7 добавлена поддержка объявлений типа возвращаемого значения. Объявления типа возвращаемого значения указывают тип возвращаемого значения функции.

Типы возвращаемых значений, которые можно объявить:

  • int

  • float

  • bool

  • string

  • интерфейсы

  • array

  • вызываемый объект

Пример объявлений типа возвращаемого значения

В примере требуется, чтобы возвращаемый результат был целым числом:

Пример

<?php
declare(strict_types=1);

function
returnIntValue(int $value): int
{
   return
$value;
}

print(
returnIntValue(5));
?>

Вывод вышеприведённой программы:

5

Пример ошибки объявления типа возвращаемого значения

Пример

<?php
declare(strict_types=1);

function
returnIntValue(int $value): int
{
   return
$value + 1.0;
}

print(
returnIntValue(5));
?>

Поскольку в приведённой выше программе используется строгий режим, возвращаемое значение должно быть int, но результат вычисления — float, поэтому будет сообщено об ошибке. Вывод при выполнении:

Fatal error: Uncaught TypeError: Return value of returnIntValue() must be of the type integer, float returned...

Функции void

Введён новый тип возвращаемого значения — void. Методы, тип возвращаемого значения которых объявлен как void, либо просто опускают оператор return, либо используют пустой оператор return. Для void-функций NULL не является допустимым возвращаемым значением.

Типы возвращаемого значения также включают void. Функции, у которых тип возвращаемого значения объявлен как void, не могут иметь возвращаемого значения, даже возвращать null.

void-функции могут опускать оператор return или использовать пустой оператор return.

Пример

<?php
function swap(&$left, &$right) : void
{
    if ($left === $right) {
        return;
    }

    $tmp = $left;
    $left = $right;
    $right = $tmp;
}

$a = 1;
$b = 2;
var_dump(swap($a, $b), $a, $b);

Вывод приведенного выше примера:

null
int(2)
int(1)

PHP 7 新特性Новые возможности PHP 7

Другие расширения