2.9 Tipos de dados para métodos e propriedades
Declaração de tipos em propriedades, parâmetros e retornos no PHP: modo coercivo e strict_types, tipos anuláveis, union types, void, never, mixed e a evolução por versão.
Por que declarar tipos
⚠ A página original diz que a declaração de tipos foi introduzida "desde o PHP 7". Tipos de classe e array em parâmetros já existiam no PHP 5; o PHP 7.0 trouxe os tipos escalares e o tipo de retorno; propriedades tipadas, como as do exemplo da aula, só existem a partir do PHP 7.4.
Coerção × strict_types
<?php
declare(strict_types=1);
class Calculadora
{
public function somar(int $a, int $b): int
{
return $a + $b;
}
}
$c = new Calculadora();
echo $c->somar(5, 3); // Saída: 8
echo $c->somar("5", "3"); // TypeError (sem strict_types: 8)
echo $c->somar("cinco", 3); // TypeError nos dois modos⚠ A página original mostra somar("5", "3") funcionando e logo depois afirma que o método "só aceita números inteiros". As duas coisas só se conciliam sabendo do modo: sem strict_types o PHP converte strings numéricas; com declare(strict_types=1) aí sim só int passa.
Tipos de retorno e tipos compostos
<?php
declare(strict_types=1);
class Repositorio
{
/** @var array<int, string> */
private array $nomes = [1 => 'Ana'];
public function buscar(int $id): ?string // pode não achar
{
return $this->nomes[$id] ?? null;
}
public function salvar(int $id, string $nome): void
{
$this->nomes[$id] = $nome;
}
public function obter(int $id): string
{
return $this->buscar($id) ?? $this->falhar("Id $id não existe");
}
private function falhar(string $msg): never
{
throw new RuntimeException($msg);
}
}
function dobro(int|float $n): int|float
{
return $n * 2;
}
$r = new Repositorio();
var_dump($r->buscar(2)); // NULL
echo $r->obter(1); // Ana
echo dobro(2.5); // 5Revisão rápida
Sem strict_types, o que acontece com somar("5", "3") num método que pede int? E com strict?
Sem strict, o PHP converte e devolve 8. Com strict, TypeError.
Qual a diferença entre void e never?
void termina normalmente sem devolver valor; never não termina normalmente: sempre lança exceção ou encerra o script.
Como declarar um método que devolve um texto ou null?
: ?string (ou : string|null).
Em que versão surgiram as propriedades tipadas?
PHP 7.4.