對象接口

使用接口(interface),可以指定某個類必須實現(xiàn)哪些方法,但不需要定義這些方法的具體內(nèi)容。 由于接口(interface)和類(class)、trait 共享了命名空間,所以它們不能重名。

接口就像定義一個標(biāo)準(zhǔn)的類一樣,通過 interface 關(guān)鍵字替換掉 class 關(guān)鍵字來定義,但其中所有的方法都是空的。

接口中定義的所有方法都必須是 public ,這是接口的特性。

在實踐中,往往出于兩個輔助目的使用接口:

  • 因為實現(xiàn)了同一個接口,所以開發(fā)者創(chuàng)建的對象雖然源自不同的類,但可能可以交換使用。 常用于多個數(shù)據(jù)庫的服務(wù)訪問、多個支付網(wǎng)關(guān)、不同的緩存策略等。 可能不需要任何代碼修改,就能切換不同的實現(xiàn)方式。
  • 能夠讓函數(shù)與方法接受一個符合接口的參數(shù),而不需要關(guān)心對象如何做、如何實現(xiàn)。 這些接口常常命名成類似 Iterable、CacheableRenderable, 以便于體現(xiàn)出功能的含義。

接口可以定義魔術(shù)方法,以便要求類(class)實現(xiàn)這些方法。

注意:

雖然沒有禁止,但是強(qiáng)烈建議不要在接口中使用 構(gòu)造器。 因為這樣在對象實現(xiàn)接口時,會大幅降低靈活性。 此外,也不能強(qiáng)制確保構(gòu)造器遵守繼承規(guī)則,將導(dǎo)致不可預(yù)料的行為結(jié)果。

實現(xiàn)(implements

要實現(xiàn)一個接口,使用 implements 操作符。類中必須實現(xiàn)接口中定義的所有方法,否則會報一個致命錯誤。 類可以實現(xiàn)多個接口,用逗號來分隔多個接口的名稱。

警告

類實現(xiàn)(implement)兩個接口時,如果它們定義了相同名稱的方法,只有簽名相同的時候才是允許的。

警告

實現(xiàn)接口的時候,class 中的參數(shù)名稱不必和接口完全一致。 然而, PHP 8.0 起語法開始支持命名參數(shù), 也就是說調(diào)用方會依賴接口中參數(shù)的名稱。 因此,強(qiáng)烈建議開發(fā)者的參數(shù)的命名,在類和接口中保持一致。

注意:

接口也可以通過 extends 操作符擴(kuò)展。

注意:

類實現(xiàn)接口時,必須以兼容的簽名定義接口中所有方法。

常量

接口中也可以定義常量。接口常量和類常量的使用完全相同, 在 PHP 8.1.0 之前 不能被子類或子接口所覆蓋。

范例

示例 #1 接口示例

<?php

// 聲明一個'Template'接口
interface Template
{
    public function 
setVariable($name$var);
    public function 
getHtml($template);
}


// 實現(xiàn)接口
// 下面的寫法是正確的
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;
    }
}

// 下面的寫法是錯誤的,會報錯,因為沒有實現(xiàn) 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 可擴(kuò)充的接口

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

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

// 正確寫法
class implements B
{
    public function 
foo()
    {
    }

    public function 
baz(Baz $baz)
    {
    }
}

// 錯誤寫法會導(dǎo)致一個致命錯誤
class implements B
{
    public function 
foo()
    {
    }

    public function 
baz(Foo $foo)
    {
    }
}
?>

示例 #3 擴(kuò)展多個接口

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

interface 
B
{
    public function 
bar();
}

interface 
extends AB
{
    public function 
baz();
}

class 
implements C
{
    public function 
foo()
    {
    }

    public function 
bar()
    {
    }

    public function 
baz()
    {
    }
}
?>

示例 #4 使用接口常量

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

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

// 錯誤寫法,因為常量不能被覆蓋。接口常量的概念和類常量是一樣的。
class implements A
{
    const 
'Class constant';
}

// 輸出: Class constant
// 在 PHP 8.1.0 之前,不能正常運(yùn)行
// 因為之前還不允許覆蓋類常量。
echo B::B;
?>

示例 #5 抽象(abstract)類的接口使用

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

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

// 抽象類可能僅實現(xiàn)了接口的一部分。
// 擴(kuò)展該抽象類時必須實現(xiàn)剩余部分。
abstract class implements A
{
    public function 
foo(string $s): string
    
{
        return 
$s PHP_EOL;
    }
}

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

示例 #6 同時使用擴(kuò)展和實現(xiàn)

<?php

class One
{
    
/* ... */
}

interface 
Usable
{
    
/* ... */
}

interface 
Updatable
{
    
/* ... */
}

// 關(guān)鍵詞順序至關(guān)重要: 'extends' 必須在前面
class Two extends One implements UsableUpdatable
{
    
/* ... */
}
?>

接口加上類型約束,提供了一種很好的方式來確保某個對象包含有某些方法。參見 instanceof 操作符和類型聲明。