Acervo.estudos
Trilhas Enviar material Entrar
mapa · Intermediário

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 @julio · rev. 23 set · 4 telas

Contrato escrito na assinatura

Por que declarar tipos

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom

⚠ 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.

O PHP converte ou recusa?

Coerção × strict_types

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
<?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.

?Tipo, união, void, never

Tipos de retorno e tipos compostos

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
<?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);           // 5
Teste antes de seguir

Revisão rápida

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
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.

← Voltar ao curso