Declaración de tipos escalares y tipos de retorno en PHP

PHP 7 新特性Nuevas características de PHP 7


Declaración de tipos escalares

De forma predeterminada, todos los archivos PHP están en modo de comprobación de tipos débil.

PHP 7 añade la característica de declaración de tipos escalares, que tiene dos modos:

  • Modo coercitivo (predeterminado)
  • Modo estricto

Formato de sintaxis de la declaración de tipos escalares:

declare(strict_types=1); 

En el código, especificando el valor de strict_types (1 o 0), 1 indica el modo de comprobación de tipos estricto, que se aplica a las llamadas a funciones y a las declaraciones de retorno; 0 indica el modo de comprobación de tipos débil.

Los parámetros de tipo que se pueden usar son:

  • int

  • float

  • bool

  • string

  • interfaces

  • array

  • callable

Ejemplo de modo coercitivo

Ejemplo

<?php
// Modo coercitivo
function sum(int ...$ints)
{
   return
array_sum($ints);
}

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

El resultado de la ejecución del programa anterior es:

9

En el ejemplo, el parámetro 4.1 se convierte en el entero 4 y luego se suma.

Ejemplo de modo estricto

Ejemplo

<?php
// Modo estricto
declare(strict_types=1);

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

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

Como el programa anterior usa el modo estricto, si en los parámetros aparece un tipo que no sea entero, se producirá un error. El resultado de la ejecución es:

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

Declaración de tipos de retorno

PHP 7 añade soporte para la declaración de tipos de retorno, que especifica el tipo del valor de retorno de una función.

Los tipos de retorno que se pueden declarar son:

  • int

  • float

  • bool

  • string

  • interfaces

  • array

  • callable

Ejemplo de declaración de tipo de retorno

En el ejemplo, se requiere que el resultado devuelto sea un entero:

Ejemplo

<?php
declare(strict_types=1);

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

print(
returnIntValue(5));
?>

El resultado de la ejecución del programa anterior es:

5

Ejemplo de error en la declaración de tipo de retorno

Ejemplo

<?php
declare(strict_types=1);

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

print(
returnIntValue(5));
?>

Debido al modo estricto en el programa anterior, el valor de retorno debe ser int, pero el resultado del cálculo es float, por lo que se producirá un error. El resultado de la ejecución es:

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

Funciones void

Se ha introducido un nuevo tipo de retorno void. Los métodos cuyo tipo de retorno se declara como void deben omitir la declaración return o utilizar una declaración return vacía. Para las funciones void, NULL no es un valor de retorno válido.

También existe el tipo de retorno void. Una función con tipo de retorno void no puede tener un valor de retorno, ni siquiera devolver null.

Las funciones void pueden omitir la declaración return o utilizar una declaración return vacía.

Ejemplo

<?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);

El resultado del ejemplo anterior es:

null
int(2)
int(1)

PHP 7 新特性Nuevas características de PHP 7

Otras extensiones