<?php

namespace SampleInterface;

interface IAnimal
{
    // 定数を定義することが出来ます
    public const BEST_SLEEP = "良質な睡眠";

    // 具体的な実装を定義することは出来ません
    // アクセス修飾子は必ず public にする必要があります
    public function sleep(); // 動物は眠ります
}

<?php

namespace SampleInterface;

use SampleInterface\IAnimal;

class Dog implements IAnimal // implements クラス名 でインターフェースを実装する
{
    // インターフェースで定義されたメソッドは必ず実装する必要がある
    public function sleep()
    {
        // インターフェース実装先クラスで処理を記述する
        return "犬は 12~14 時間寝ます。";
    }
}

<?php

namespace SampleInterface;

use SampleInterface\IAnimal;

class Cat implements IAnimal
{
    public function sleep()
    {
        return "猫は 12~16 時間寝ます。";
    }
}

{
    "name": "hn_pgtech/sample_php_project",
    "description": "PHPの機能を検証する",
    "require": {},
    "autoload": {
        "psr-4": {
            "BaseClass\\": "ObjectSample/BaseClass/",
            "ExtendTrait\\": "ObjectSample/ExtendTrait/",
            "SampleStatic\\": "ObjectSample/SampleStatic/",
            "SampleConst\\": "ObjectSample/SampleConst/",
            "SampleAbstract\\": "ObjectSample/SampleAbstract/",
+           "SampleInterface\\": "ObjectSample/SampleInterface/"
        }
    }
}

$ composer dump-autoload

<?php

require __DIR__ . '/../vendor/autoload.php';

use SampleInterface\Cat;
use SampleInterface\Dog;

$dog = new Dog();
echo $dog->sleep() . "\n"; // 犬は 12~14 時間寝ます。

$dog = new Cat();
echo $dog->sleep() . "\n"; // 猫は 12~16 時間寝ます。

<?php

namespace SampleInterface;

interface IAnimal2
{
    public function eat(); // 動物は食べます
}

<?php

namespace SampleInterface;

interface IAnimal3
{
    public function run(); // 動物は走ります
}

<?php

namespace SampleInterface\le\SampleInterface;

use SampleInterface\IAnimal;
use SampleInterface\IAnimal2;
use SampleInterface\IAnimal3;

class Cat implements IAnimal, IAnimal2, IAnimal3 // カンマ区切りで複数実装することが出来る
{
    public function sleep()
    {
        return "猫は 12~16 時間寝ます。";
    }

    public function run()
    {
        return "猫は素早く走ります。";
    }

    public function eat()
    {
        return "猫はよく食べます。";
    }
}

<?php

namespace SampleInterface;

use SampleInterface\IAnimal;
use SampleInterface\IAnimal3;

class Dog implements IAnimal, IAnimal3 // 実装するインターフェースを任意に選択することも出来る
{
    public function sleep()
    {
        return "犬は 12~14 時間寝ます。";
    }

    public function run()
    {
        return "犬の走る速度は人間より速いです。";
    }
}

<?php

namespace SampleInterface;

use SampleInterface\IAnimal;

class Bird implements IAnimal
{
    public function sleep()
    {
        return "鳥の睡眠時間は短いです。";
    }
}

<?php

namespace SampleStatic;

use SampleInterface\IAnimal;

class AnimalClient
{
    // インターフェースに依存したオブジェクトを渡す
    public static function executeSleep(IAnimal $animalObj)
    {
        // IAnimalインターフェースでは sleep メソッドが
        // 実装されていることが保証されているので呼び出せる
        return $animalObj->sleep();
    }
}

    // 例
    // プログラムに変更があり、クラスが増えるえれば渡す引数も増えてしまう
    public static function executeSleep(Dog $dogObj, Cat $catObj, Bird $birdObj)
    {
        // インスタンスを判定するif文も増えていく
        if($dogObj instanceof Dog) {
            return $dogObj->sleep();
        }

        if($catObj instanceof Cat) {
            return $catObj->sleep();
        }

        if($birdObj instanceof Bird) {
            return $birdObj->sleep();
        }

        // ...

        // 変更するたびに、逐一条件分岐をテストする工数も増える
    }

<?php

require __DIR__ . '/../vendor/autoload.php';

use SampleInterface\Bird;
use SampleInterface\Cat;
use SampleInterface\Dog;
use SampleStatic\AnimalClient;

// $dog = new Dog();
// echo $dog->sleep() . "\n"; // 犬は 12~14 時間寝ます。

// $dog = new Cat();
// echo $dog->sleep() . "\n"; // 猫は 12~16 時間寝ます。

// DogクラスはIAnimalインタフェースを実装しているので引数に渡すことが出来ます
echo AnimalClient::executeSleep(new Dog()). "\n"; // 犬は 12~14 時間寝ます。

echo AnimalClient::executeSleep(new Cat()). "\n"; // 猫は 12~16 時間寝ます。

echo AnimalClient::executeSleep(new Bird()). "\n"; // 鳥の睡眠時間は短いです。