使用接口(interface),可以指定某個類必須實現(xiàn)哪些方法,但不需要定義這些方法的具體內容。 由于接口(interface)和類(class)、trait 共享了命名空間,所以它們不能重名。
接口就像定義一個標準的類一樣,通過 interface
關鍵字替換掉
class
關鍵字來定義,但其中所有的方法都是空的。
接口中定義的所有方法都必須是 public ,這是接口的特性。
在實踐中,往往出于兩個輔助目的使用接口:
Iterable
、Cacheable
、Renderable
,
以便于體現(xiàn)出功能的含義。
接口可以定義魔術方法,以便要求類(class)實現(xiàn)這些方法。
注意:
雖然沒有禁止,但是強烈建議不要在接口中使用 構造器。 因為這樣在對象實現(xiàn)接口時,會大幅降低靈活性。 此外,也不能強制確保構造器遵守繼承規(guī)則,將導致不可預料的行為結果。
implements
)
要實現(xiàn)一個接口,使用 implements
操作符。類中必須實現(xiàn)接口中定義的所有方法,否則會報一個致命錯誤。
類可以實現(xiàn)多個接口,用逗號來分隔多個接口的名稱。
類實現(xiàn)(implement)兩個接口時,如果它們定義了相同名稱的方法,只有簽名相同的時候才是允許的。
實現(xiàn)接口的時候,class 中的參數(shù)名稱不必和接口完全一致。 然而, PHP 8.0 起語法開始支持命名參數(shù), 也就是說調用方會依賴接口中參數(shù)的名稱。 因此,強烈建議開發(fā)者的參數(shù)的命名,在類和接口中保持一致。
注意:
接口也可以通過 extends 操作符擴展。
注意:
類實現(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 可擴充的接口
<?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';
}
// 輸出: Class constant
// 在 PHP 8.1.0 之前,不能正常運行
// 因為之前還不允許覆蓋類常量。
echo B::B;
?>
示例 #5 抽象(abstract)類的接口使用
<?php
interface A
{
public function foo(string $s): string;
public function bar(int $i): int;
}
// 抽象類可能僅實現(xiàn)了接口的一部分。
// 擴展該抽象類時必須實現(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 同時使用擴展和實現(xiàn)
<?php
class One
{
/* ... */
}
interface Usable
{
/* ... */
}
interface Updatable
{
/* ... */
}
// 關鍵詞順序至關重要: 'extends' 必須在前面
class Two extends One implements Usable, Updatable
{
/* ... */
}
?>
接口加上類型約束,提供了一種很好的方式來確保某個對象包含有某些方法。參見 instanceof 操作符和類型聲明。