[Day19]PHP Interface介面

Interface对象接口也称介面

使用介面（interface），可以指定某个类必须实现哪些方法，但不需要定义这些方法的具体内容。由於介面（interface）和类（class）、trait 共享了命名空间，所以它们不能重名。介面就像定义一个标准的类一样，通过 interface 关键字替换掉 class 关键字来定义，但其中所有的方法都是空的。介面中定义的所有方法都必须是公有，这是介面的特性。在实践中，往往出於两个辅助目的使用介面： 因为实现了同一个介面，所以开发者创建的对象虽然源自不同的类，但可能可以交换使用。常用於多个数据库的服务访问、多个支付网关、不同的缓存策略等。可能不需要任何代码修改，就能切换不同的实现方式。能够让函数与方法接受一个符合介面的参数，而不需要关心对像如何做、如何实现。这些介面常常命名成类似 Iterable、Cacheable、Renderable， 以便於体现出功能的含义。

注意: 虽然没有禁止，但是强烈建议不要在接口中使用 构造器。因为这样在对象实现接口时，会大幅降低灵活性。此外，也不能强制确保构造器遵守继承规则，将导致不可预料的行为结果。

实现implements

要使用一个介面，使用 implements 操作符。类中必须使用介面中定义的所有方法，否则会报一个致命错误。类可以实现多个接口，用逗号来分隔多个接口的名称。

警告：类使用（implement）两个接口时，如果它们定义了相同名称的方法，只有签名相同的时候才是允许的。

警告：使用介面的时候，class 中的参数名称不必和介面完全一致。然而， PHP 8.0 起语法开始支持命名参数， 也就是说调用方会依赖介面中参数的名称。因此，强烈建议开发者的参数的命名，在类和介面中保持一致。

注意:接口也可以通过 extends 操作符继承

注意:类实现介面时，必须以兼容的签名定义介面中所有方法。

1. 介面范例

<?php

// 声明一个'Template'介面
interface Template
{
    public function setVariable($name, $var);
    public function getHtml($template);
}


// 使用介面
// 正确写法如下
class WorkingTemplate implements Template
{
    private $vars = [];
  
    public function setVariable($name, $var)
    {
        $this->vars[$name] = $var;
    }
  
    public function getHtml($template)
    {
        foreach($this->vars as $name => $value) {
            $template = str_replace('{' . $name . '}', $value, $template);
        }
 
        return $template;
    }
}

// 下面的写法是错误的，会报错，因为没有使用到该介面方法 getHtml()：
// Fatal error: Class BadTemplate contains 1 abstract methods
// and must therefore be declared abstract (Template::getHtml)
class BadTemplate implements Template
{
    private $vars = [];
  
    public function setVariable($name, $var)
    {
        $this->vars[$name] = $var;
    }
}
?>

2. 可扩充介面

<?php
interface A
{
    public function foo();
}

interface B extends A
{
    public function baz(Baz $baz);
}

// 正确写法
class C implements B
{
    public function foo()
    {
    }

    public function baz(Baz $baz)
    {
    }
}

// 错误写法导致致命错误
class D implements B
{
    public function foo()
    {
    }

    public function baz(Foo $foo) // 参考错误
    {
    }
}
?>

3. 拓展多介面

<?php
interface A
{
    public function foo();
}

interface B
{
    public function bar();
}

interface C extends A, B
{
    public function baz();
}

class D implements C
{
    public function foo()
    {
    }

    public function bar()
    {
    }

    public function baz()
    {
    }
}
?>

4. 使用介面常量

<?php
interface A
{
    const B = 'Interface constant';
}

// 输出接口常量
echo A::B;

// 错误写法，因为常量不能被覆盖。接口常量的概念和类常量是一样的。
class B implements A
{
    const B = 'Class constant';
}
?>

5. 抽象（abstract）类的介面使用

<?php
interface A
{
    public function foo(string $s): string;

    public function bar(int $i): int;
}

//  抽象类可能仅实现了接口的一部分。 
// 扩展该抽象类时必须实现剩余部分
abstract class B implements A
{
    pubic function foo(string $s): string
    {
        return $s . PHP_EOL;
    }
}

class C extends B
{
    public function bar(int $i): int
    {
        return $i * 2;
    }
}
?>

6. 同时使用继承和介面

<?php

class One
{
    /* ... */
}

interface Usable
{
    /* ... */
}

interface Updatable
{
    /* ... */
}

// 关键字顺序至关重要： 'extends' 必须在前面
class Two extends One implements Usable, Updatable
{
    /* ... */
}
?>

资料来源: https://www.php.net/