使用接口(interface),可以指定某個(gè)類(lèi)必須實(shí)現(xiàn)哪些方法,但不需要定義這些方法的具體內(nèi)容。 由于接口(interface)和類(lèi)(class)、trait 共享了命名空間,所以它們不能重名。
接口就像定義一個(gè)標(biāo)準(zhǔn)的類(lèi)一樣,通過(guò) interface
關(guān)鍵字替換掉
class
關(guān)鍵字來(lái)定義,但其中所有的方法都是空的。
接口中定義的所有方法都必須是 public ,這是接口的特性。
在實(shí)踐中,往往出于兩個(gè)輔助目的使用接口:
Iterable
、Cacheable
、Renderable
,
以便于體現(xiàn)出功能的含義。
接口可以定義魔術(shù)方法,以便要求類(lèi)(class)實(shí)現(xiàn)這些方法。
注意:
雖然沒(méi)有禁止,但是強(qiáng)烈建議不要在接口中使用 構(gòu)造器。 因?yàn)檫@樣在對(duì)象實(shí)現(xiàn)接口時(shí),會(huì)大幅降低靈活性。 此外,也不能強(qiáng)制確保構(gòu)造器遵守繼承規(guī)則,將導(dǎo)致不可預(yù)料的行為結(jié)果。
implements
)
要實(shí)現(xiàn)一個(gè)接口,使用 implements
操作符。類(lèi)中必須實(shí)現(xiàn)接口中定義的所有方法,否則會(huì)報(bào)一個(gè)致命錯(cuò)誤。
類(lèi)可以實(shí)現(xiàn)多個(gè)接口,用逗號(hào)來(lái)分隔多個(gè)接口的名稱。
類(lèi)實(shí)現(xiàn)(implement)兩個(gè)接口時(shí),如果它們定義了相同名稱的方法,只有簽名相同的時(shí)候才是允許的。
實(shí)現(xiàn)接口的時(shí)候,class 中的參數(shù)名稱不必和接口完全一致。 然而, PHP 8.0 起語(yǔ)法開(kāi)始支持命名參數(shù), 也就是說(shuō)調(diào)用方會(huì)依賴接口中參數(shù)的名稱。 因此,強(qiáng)烈建議開(kāi)發(fā)者的參數(shù)的命名,在類(lèi)和接口中保持一致。
注意:
接口也可以通過(guò) extends 操作符擴(kuò)展。
注意:
類(lèi)實(shí)現(xiàn)接口時(shí),必須以兼容的簽名定義接口中所有方法。
常量
接口中也可以定義常量。接口常量和類(lèi)常量的使用完全相同, 在 PHP 8.1.0 之前 不能被子類(lèi)或子接口所覆蓋。
示例 #1 接口示例
<?php
// 聲明一個(gè)'Template'接口
interface Template
{
public function setVariable($name, $var);
public function getHtml($template);
}
// 實(shí)現(xiàn)接口
// 下面的寫(xiě)法是正確的
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ě)法是錯(cuò)誤的,會(huì)報(bào)錯(cuò),因?yàn)闆](méi)有實(shí)現(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 B extends A
{
public function baz(Baz $baz);
}
// 正確寫(xiě)法
class C implements B
{
public function foo()
{
}
public function baz(Baz $baz)
{
}
}
// 錯(cuò)誤寫(xiě)法會(huì)導(dǎo)致一個(gè)致命錯(cuò)誤
class D implements B
{
public function foo()
{
}
public function baz(Foo $foo)
{
}
}
?>
示例 #3 擴(kuò)展多個(gè)接口
<?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;
// 錯(cuò)誤寫(xiě)法,因?yàn)槌A坎荒鼙桓采w。接口常量的概念和類(lèi)常量是一樣的。
class B implements A
{
const B = 'Class constant';
}
// 輸出: Class constant
// 在 PHP 8.1.0 之前,不能正常運(yùn)行
// 因?yàn)橹斑€不允許覆蓋類(lèi)常量。
echo B::B;
?>
示例 #5 抽象(abstract)類(lèi)的接口使用
<?php
interface A
{
public function foo(string $s): string;
public function bar(int $i): int;
}
// 抽象類(lèi)可能僅實(shí)現(xiàn)了接口的一部分。
// 擴(kuò)展該抽象類(lèi)時(shí)必須實(shí)現(xiàn)剩余部分。
abstract class B implements A
{
public function foo(string $s): string
{
return $s . PHP_EOL;
}
}
class C extends B
{
public function bar(int $i): int
{
return $i * 2;
}
}
?>
示例 #6 同時(shí)使用擴(kuò)展和實(shí)現(xiàn)
<?php
class One
{
/* ... */
}
interface Usable
{
/* ... */
}
interface Updatable
{
/* ... */
}
// 關(guān)鍵詞順序至關(guān)重要: 'extends' 必須在前面
class Two extends One implements Usable, Updatable
{
/* ... */
}
?>
接口加上類(lèi)型約束,提供了一種很好的方式來(lái)確保某個(gè)對(duì)象包含有某些方法。參見(jiàn) instanceof 操作符和類(lèi)型聲明。