trait / マジックメソッド対応: PHP 5.4（2012）

// トレイトを定義します。
trait トレイト名 {
	public function method() { }
}

// トレイトをクラスに組み込みます。
class クラス名 {
	use トレイト名;
}

// instanceof でオブジェクトの型を判定します。
$obj instanceof クラス名;

<?php
// トレイトの基本的な使い方です。
trait Timestampable {
	private string $created_at;
	private string $updated_at;

	public function set_timestamps(): void {
		$now = date('Y-m-d H:i:s');
		$this->created_at = $this->created_at ?? $now;
		$this->updated_at = $now;
	}

	public function get_created_at(): string {
		return $this->created_at;
	}
}

trait SoftDeletable {
	private ?string $deleted_at = null;

	public function soft_delete(): void {
		$this->deleted_at = date('Y-m-d H:i:s');
	}

	public function is_deleted(): bool {
		return $this->deleted_at !== null;
	}
}

// 複数のトレイトを組み合わせて使用します。
class Post {
	use Timestampable, SoftDeletable;

	public function __construct(
		public string $title
	) {
		$this->set_timestamps();
	}
}

$post = new Post("PHPトレイト入門");
echo $post->get_created_at(); // 現在日時が出力されます。
$post->soft_delete();
var_dump($post->is_deleted()); // 『bool(true)』と出力されます。

// __toString() マジックメソッドの例です。
class Money {
	public function __construct(
		private int $amount,
		private string $currency = '円'
	) {}

	public function __toString(): string {
		return number_format($this->amount) . $this->currency;
	}
}

$price = new Money(2980);
echo $price; // 『2,980円』と出力されます。__toString() が自動的に呼ばれます。

// __get() と __set() の例です。
class FlexibleObject {
	private array $data = [];

	public function __get(string $name): mixed {
		return $this->data[$name] ?? null;
	}

	public function __set(string $name, mixed $value): void {
		$this->data[$name] = $value;
	}
}

$obj = new FlexibleObject();
$obj->color = "赤"; // __set() が呼ばれます。
echo $obj->color;   // __get() が呼ばれ、『赤』と出力されます。

// __invoke() の例です。
class Multiplier {
	public function __construct(
		private int $factor
	) {}

	public function __invoke(int $value): int {
		return $value * $this->factor;
	}
}

$double = new Multiplier(2);
echo $double(5);  // 『10』と出力されます。オブジェクトを関数のように呼び出せます。
echo $double(15); // 『30』と出力されます。

// instanceof で型を判定します。
var_dump($post instanceof Post);          // 『bool(true)』と出力されます。
var_dump($price instanceof Money);        // 『bool(true)』と出力されます。
var_dump($price instanceof \Stringable);  // 『bool(true)』と出力されます。__toString() を持つためです。

トレイトはPHP 5.4 で導入された、コードの再利用を実現する仕組みです。PHPは単一継承のため複数のクラスから機能を継承できませんが、トレイトを使えば複数の機能をクラスに自由に組み込めます。タイムスタンプの管理、ソフトデリート、ログ出力など、複数のクラスで共通する振る舞いを定義するのに適しています。

マジックメソッドはPHPが特定の状況で自動的に呼び出す特殊なメソッドです。『__toString()』はオブジェクトの文字列表現を定義し、『__get()』『__set()』は動的なプロパティアクセスを制御します。『__invoke()』を定義するとオブジェクトを関数のように呼び出せるため、コールバックとして渡す場面で便利です。

クラスの基本については『class』、継承とインターフェースについては『extends / implements』を参照してください。