PHP 不允许直接将接口“实例化”，必须通过实现该接口的具体类来创建对象，再将这些对象存入数组，从而满足 instanceof Site 类型校验。
php 不允许直接将接口“实例化”，必须通过实现该接口的具体类来创建对象，再将这些对象存入数组，从而满足 `instanceof site` 类型校验。
在 PHP 中，接口（interface）本身不能被实例化——它仅定义契约（方法签名），不包含具体实现。因此，当你在代码中写 if (!$site instanceof Site) 时，PHP 实际检查的是 $site 是否为实现了 Site 接口的某个具体类的实例，而非“接口的实例”。这意味着：你无法“返回一个接口”，但可以“返回一组实现了该接口的对象”，并将其组织成数组。
✅ 正确做法：定义实现类 + 构造对象数组
首先，需创建一个具体类（如 SiteImpl 或直接命名为 Site）并实现 Site 接口：
interface Site
{
public function getName(): string;
// 可按需扩展其他契约方法，例如：
// public function getSiteId(): int;
// public function getBone(): string;
}
class SiteImpl implements Site
{
private int $siteId;
private string $name;
private string $bone;
public function __construct(int $siteId, string $name, string $bone)
{
$this->siteId = $siteId;
$this->name = $name;
$this->bone = $bone;
}
public function getName(): string
{
return $this->name;
}
// 实现接口要求的全部方法（此处仅 getName() 是强制的）
// 若后续扩展接口，需同步补充实现
}接着，在 getSites() 方法中，不再返回关联数组（即 ['siteId' => ..., 'name' => ...]），而是返回 SiteImpl 对象数组：
class BonesSites
{
public function getSites(string $site): array
{
if ($site === 'Egypt') {
return [
new SiteImpl(1, 'Cairo', 'T-Rex bones'),
new SiteImpl(2, 'Giza', 'Raptors bones'),
new SiteImpl(3, 'Alexandria', 'Bronchiosaurus bones'),
];
}
throw new \InvalidArgumentException("Unknown site: {$site}");
}
}⚠️ 注意：原示例中 getSites() 返回了形如 ['error' => '...'] 的错误数组，这会破坏类型一致性。建议统一返回 SiteImpl[]，错误情况应抛出异常（如上所示），或使用更健壮的返回类型（如 Result<array>></array> 模式，可通过自定义 Result 类或 PHP 8.1+ Union Types + null 处理）。
立即学习“PHP免费学习笔记（深入）”；
? 关联优化：声明返回类型提升可靠性
为增强可维护性与 IDE 支持，推荐显式标注返回类型（PHP 7.4+）：
/**
* @return SiteImpl[]
*/
public function getSites(string $site): array
{
// ...
}若使用 PHP 8.0+，还可结合 mixed 或更精确的联合类型（配合严格模式）；PHP 8.1+ 更支持 SiteImpl[] 作为完整返回类型注解（需启用 strict_types=1 并配合静态分析工具如 Psalm/PHPStan）。
? 总结关键点
- ❌ 错误认知：“返回接口” → 接口不是类，不能
new Site()； - ✅ 正确路径：定义
class X implements Site→ 创建X实例 → 放入数组； - ✅ 类型安全：
foreach ($sites as $site) { if (!$site instanceof Site) { ... } }才能真正生效； - ✅ 设计建议：将数据载体（DTO）与契约（interface）分离，例如
SiteImpl实现Site，便于未来替换实现（如CachedSite、ApiSite）； - ⚠️ 避免混合类型：数组中不应同时存在对象与字符串/关联数组，否则
instanceof校验必然失败。
遵循以上实践，即可在 PHP 中安全、清晰、可扩展地实现“接口导向的数组返回”。
