PHP传入实现IEntity接口对象时出现声明不兼容错误的解决方法

PHP 要求实现接口的方法必须与接口方法签名完全兼容，包括参数类型。RepositoryInterface 定义的 find、save、remove 方法接受 IEntity 类型参数，但 ShirtOrderRepository 中对应的方法把参数类型限定为 ShirtOrder——这相当于缩小了参数的可接受范围，违反了接口契约，因此触发致命错误。

根据你「让仓库仅处理 ShirtOrder 实体」的需求，有两种可行方案：

方案1：使用PHP泛型（推荐，PHP 7.4+支持） #

通过泛型让 RepositoryInterface 支持绑定特定实体类型，既满足接口兼容性，又能在编译阶段确保类型正确。

修改后代码：

<?php

interface IEntity {
    public function getTableName();
}

class ShirtOrder implements IEntity
{
    public $id;
    public $customerId;
    public $fabricId;
    public $collarSize;
    public $chestSize;
    public $waistSize;
    public $wristSize;

    public function getTableName()
    {
        return 'shirt_orders';
    }
}

// 定义带泛型约束的仓库接口
interface RepositoryInterface<T extends IEntity> {
    public function find(T $entity);
    public function save(T $entity);
    public function remove(T $entity);
}

interface DatabaseInterface {
    public function find(IEntity $entity);
    public function save(IEntity $entity);
    public function remove(IEntity $entity);
}

// 实现时绑定泛型类型为ShirtOrder
class ShirtOrderRepository implements RepositoryInterface<ShirtOrder> {
    protected $db;

    public function __construct(DatabaseInterface $db) {
        $this->db = $db;
    }

    public function find(ShirtOrder $shirtOrder)
    {
        return $this->db->find($shirtOrder);
    }

    public function save(ShirtOrder $shirtOrder)
    {
        return $this->db->save($shirtOrder);
    }

    public function remove(ShirtOrder $shirtOrder)
    {
        return $this->db->remove($shirtOrder);
    }
}

方案2：保持接口参数类型，内部做类型校验 #

如果你的PHP版本不支持泛型，可以让仓库方法参数保持 IEntity 类型，在方法内部校验传入实体是否为 ShirtOrder，不符合则抛出异常。

修改后代码：

<?php

interface IEntity {
    public function getTableName();
}

class ShirtOrder implements IEntity
{
    public $id;
    public $customerId;
    public $fabricId;
    public $collarSize;
    public $chestSize;
    public $waistSize;
    public $wristSize;

    public function getTableName()
    {
        return 'shirt_orders';
    }
}

interface RepositoryInterface
{
    public function find(IEntity $entity);
    public function save(IEntity $entity);
    public function remove(IEntity $entity);
}

interface DatabaseInterface {
    public function find(IEntity $entity);
    public function save(IEntity $entity);
    public function remove(IEntity $entity);
}

class ShirtOrderRepository implements RepositoryInterface {
    protected $db;

    public function __construct(DatabaseInterface $db) {
        $this->db = $db;
    }

    public function find(IEntity $entity)
    {
        if (!$entity instanceof ShirtOrder) {
            throw new InvalidArgumentException('仅支持传入ShirtOrder类型实体');
        }
        return $this->db->find($entity);
    }

    public function save(IEntity $entity)
    {
        if (!$entity instanceof ShirtOrder) {
            throw new InvalidArgumentException('仅支持传入ShirtOrder类型实体');
        }
        return $this->db->save($entity);
    }

    public function remove(IEntity $entity)
    {
        if (!$entity instanceof ShirtOrder) {
            throw new InvalidArgumentException('仅支持传入ShirtOrder类型实体');
        }
        return $this->db->remove($entity);
    }
}

• 泛型方案更简洁，能提前拦截类型错误，避免运行时异常；
• 类型校验方案兼容低版本PHP，但需要手动编写校验逻辑，相对繁琐。

内容的提问来源于stack exchange，提问作者Alireza Bashiri