6. Interfaces
Uma interface é uma estrutura que define protótipos de métodos. Uma classe que implementa uma interface deve implementar o código de todos os métodos da interface. Uma interface é um contrato: ela especifica o que um objeto pode fazer, sem especificar como ele o faz.
6.1. A estrutura de diretórios dos scripts
Os scripts deste capítulo estão na pasta [scripts-console/interfaces]:
6.2. Uma primeira interface
Definimos uma interface chamada [IExample] em um script chamado [IExample.php]. No mesmo script, definimos duas classes que implementam a interface [IExample]:
Comentários
- Linhas 10–15: A interface [IExample] define dois métodos: a função [add] (linha 13) e a função [subtract] (linha 15). A interface não define o código desses métodos. As classes que implementam a interface o farão. Os métodos de uma interface devem ser públicos;
- linha 19: a classe [Class1] implementa ([implements]) a interface [IExample]. Ela define, portanto, o código dos métodos [add] (linha 21) e [subtract] (linha 26). Os nomes dos parâmetros podem diferir dos da interface ([$a] em vez de [$i]), mas seus tipos devem ser compatíveis. Observe, porém: com os argumentos nomeados do PHP 8, uma chamada a [add(i: 1, j: 2)] não funcionaria com [Class1]. É preferível, portanto, manter os nomes da interface;
- Linhas 33–44: O mesmo vale para a classe [Class2].
Usamos a interface [IExample] no seguinte script [interface-01.php]:
Resultados:
Comentários
- linhas 7–10: inclusão e declaração das classes e interfaces usadas pelo script. O arquivo [IExample.php] é incluído com a instrução [require_once]: ele será incluído apenas uma vez, mesmo que vários scripts do projeto o incluam;
- Linhas 13–17: Uma função é definida;
- Linha 13: Aqui, declaramos os tipos dos três parâmetros. Se, em tempo de execução, o parâmetro real não for do tipo esperado, um erro [TypeError] é lançado. O terceiro parâmetro é do tipo [IExample]. Isso significa que o parâmetro real deve ser uma instância de uma classe que implemente a interface [IExample]; portanto, em nosso exemplo, uma instância das classes [Class1] ou [Class2]. A função [calculate] não conhece essas classes; ela só conhece a interface. Podemos passar a ela objetos de classes escritas posteriormente, desde que implementem a interface [IExample];
- linhas 15–16: usamos os métodos [add, subtract] da interface [IExample];
- linha 24: o terceiro parâmetro real é do tipo [Class1], que é compatível com o tipo [IExample] do terceiro parâmetro formal da função;
- linha 25: o mesmo vale para a classe [Class2];
- linha 28: uma interface não pode ser instanciada; um erro é retornado (linha 6 dos resultados).
6.3. Derivando uma interface
Assim como uma classe filha pode estender uma classe pai, uma interface filha pode estender uma interface pai.
Considere a interface [IExample2] definida no arquivo [IExample2.php]:
Comentários
- linha 7: a interface [IExample2] ficará no mesmo namespace que a interface [IExample];
- linha 10: o arquivo de definição da interface [IExample] é incluído;
- Linhas 13–17: definem a interface [IExample2], que estende ([extends]) a interface [IExample] e acrescenta a ela um novo método (linha 16). Uma interface pode até estender várias interfaces: [interface I3 extends I1, I2];
- linhas 20–28: A classe [Class3] estende a classe [Class2]. Como esta última implementa a interface [IExample], a classe [Class3] também a implementará. De fato, [Class3] herda todos os métodos públicos e protegidos da classe [Class2], incluindo os métodos [add] e [subtract]. Além disso, especifica-se que [Class3] implementa a interface [IExample2]. Assim, ela também deve implementar o método [multiply], o que [Class2] não faz. É isso que as linhas 24–27 fazem;
- linha 23: A partir do PHP 8.3, o atributo [#[\Override]], discutido no capítulo anterior, também se aplica a um método que implementa um método de interface. Se o método [multiply] desaparecesse da interface [IExample2], o PHP sinalizaria isso.
A interface [IExample2] é usada pelo seguinte script [interface-02.php]:
Resultados:
Comentários
- Linha 12: O terceiro parâmetro da função [calculate] é do tipo [IExample2];
- Linhas 14–16: Os três métodos da interface [IExample2] são usados: os dois herdados de [IExample] e o próprio dela;
- linha 23: a função [calculate] é chamada com, como terceiro parâmetro, um objeto do tipo [Class3] que implementa [IExample2] (linha 21).
6.4. Passando uma interface como parâmetro de uma função
Vimos no capítulo anterior (na seção “Passando um objeto como parâmetro de uma função”) que, quando o tipo esperado para um parâmetro de função é uma classe, o parâmetro real pode ser um objeto do tipo esperado ou de um tipo derivado. O mesmo vale para as interfaces, como mostra o seguinte script, [interface-03.php]:
Resultados:
Comentários
- Linha 15: A função [calculate] espera um tipo [IExample] como terceiro parâmetro. Isso significa que o parâmetro real pode ser do tipo [IExample] ou de um tipo derivado;
- Linha 23: Um objeto do tipo [$c3] é instanciado a partir da classe [Class3], que implementa a interface [IExample2], a qual, por sua vez, estende a interface [IExample]. Assim, em última análise, [$c3] implementa a interface [IExample];
- Linha 25: A função [calculate] é chamada com o objeto [$c3] (do tipo [Class3]) como terceiro parâmetro. Pela herança de classes e pelas implementações, vimos que o objeto [$c3] implementa o tipo [IExample]. Podemos, portanto, usá-lo como terceiro parâmetro;
- linhas 27–30: O operador [instanceof] verifica se um objeto implementa uma interface. Um objeto do tipo [Class1] implementa [IExample] mas não [IExample2] (linha 4 dos resultados). Um objeto do tipo [Class3] implementa ambas (linha 5);
- linha 32: A função [class_implements] retorna a lista de interfaces implementadas por um objeto ou classe, diretamente ou por herança (linhas 6–10 dos resultados).
6.5. Constantes de interface, várias interfaces e tipos de interseção
Uma interface também pode declarar constantes, e uma classe pode implementar várias interfaces. Definimos duas interfaces, [ICalculation] e [INameable], e duas classes que as implementam no arquivo [ICalculation.php]:
Comentários
- linha 13: A interface [ICalculation] declara uma constante. Todas as classes que implementam a interface a herdam. A partir do PHP 8.3, uma constante de classe ou de interface pode ser tipada (aqui, [int]);
- Linhas 19–22: Uma segunda interface, com um único método;
- linha 25: a classe [Addition] implementa as duas interfaces: os nomes das interfaces são separados por vírgulas. Ela deve definir os métodos de ambas;
- linha 30: a constante herdada da interface é acessada por [self::PRECISION]. A função [round] arredonda um número para o número de casas decimais especificado;
- linha 46: A constante também pode ser referenciada pelo nome da interface: [ICalculation::PRECISION].
Essas interfaces são usadas pelo script [interface-04.php]:
Resultados:
Comentários
- Linha 14: O terceiro parâmetro da função [execute] é do tipo [ICalculation] e tem um valor padrão — um objeto [Addition] criado com [new]. Até o PHP 8.0, o valor padrão de um parâmetro só podia ser uma constante. A partir do PHP 8.1, a expressão [new] é aceita em valores padrão de parâmetros (“new in initializers”), assim como nos argumentos de atributos do PHP ([#[...]]), em variáveis estáticas e em constantes globais. Ela continua proibida no valor padrão de um atributo de classe. O objeto é criado a cada chamada que omite o parâmetro;
- linha 20: o tipo [ICalculation&INameable] é um tipo de interseção (PHP 8.1): o parâmetro real deve implementar tanto [ICalculation] quanto [INameable]. A função pode então chamar métodos das duas interfaces. Isso não deve ser confundido com o tipo de união [ICalculation|INameable] (um ou outro);
- linha 27: a constante é acessível de fora pelo nome da interface (linha 2 dos resultados);
- linha 29: o terceiro parâmetro é omitido; é um objeto [Addition] que realiza o cálculo (linha 3);
- linha 31: um objeto [Division] é passado explicitamente (linha 4). Observe que os inteiros 10 e 3 são aceitos para parâmetros do tipo [float] apesar da declaração [strict_types=1]: a conversão de um
***[int]em um[float]*** é a única conversão automática permitida no modo estrito; - Linhas 33–34: Ambas as classes implementam ambas as interfaces; elas são aceitas pela função [display] (linhas 5–6);
- linha 36: a notação [Division::class] representa o nome completo da classe, neste caso [Examples\Division]. A função [class_implements] aceita tanto um nome de classe quanto um objeto.
As interfaces são onipresentes no próprio PHP. Já encontramos duas no capítulo anterior: [Stringable], implementada automaticamente por qualquer classe que tenha um método [__toString], e [JsonSerializable], que permite controlar a codificação JSON de um objeto. No próximo capítulo, veremos a interface [Throwable], implementada por todos os erros e exceções. Uma enumeração também pode implementar uma interface. Por fim, veremos mais adiante neste curso que as interfaces formam a base da arquitetura em camadas de nossas aplicações: cada camada conhece apenas a interface da camada adjacente.