如何基于Headers与TestHeaders类提取共用接口并实现类型提示？

你的核心问题是Headers和TestHeaders的profile方法签名不一致，但需要让它们实现同一个接口，给login函数的$headers参数做类型提示。可以按以下步骤处理：

1. 定义兼容的接口（PHP 8.0+ 推荐） #

利用PHP 8.0支持的联合类型，定义接口的profile方法参数和返回类型为两个类对应类型的联合，同时兼容两个类的方法签名：

interface HeadersInterface
{
    public function profile(string|int $input): Header|TestHeader;
}

2. 让两个类实现接口 #

修改Headers和TestHeaders类实现上述接口。PHP允许子类方法的参数类型是接口参数类型的子集（逆变规则），返回类型是接口返回类型的子集（协变规则），因此原有的方法签名完全符合接口要求：

// 修改Headers类
class Headers implements HeadersInterface
{
    public function profile(string $header): Header
    {
        return Header::profile($header);
    }
}

// 修改TestHeaders类
class TestHeaders implements HeadersInterface
{
    public function profile(int $userId): TestHeader
    {
        return new TestHeader();
    }
}

3. 更新匿名函数的类型提示 #

把login和内部getView函数的$headers参数类型提示改为HeadersInterface：

$login = function (HeadersInterface $headers) {
    $getView = function (HeadersInterface $headers): View {
        // 注意：调用$headers->profile()时，要传入符合当前实例要求的参数类型
        // 比如生产环境传string，测试环境传int，可通过环境变量或实例类型判断适配
        example code
    };

    $view = $getView($headers);
    $view->render();
};

// 生产环境调用
$login(new Headers());
// 测试环境调用
$login(new TestHeaders());

进阶优化：统一返回值类型（可选） #

如果Header和TestHeader存在共用的方法（比如View会依赖的方法），可以再定义一个HeaderInterface，让这两个类实现它，进一步提升类型安全：

// 定义Header通用接口
interface HeaderInterface
{
    // 列出Header和TestHeader共有的方法，例如：
    public function getContent(): string;
}

// 修改Header类
class Header implements HeaderInterface
{
    public static function profile(string $header): self
    {
        return new self();
    }

    public function getContent(): string
    {
        // 实现逻辑
        return '';
    }
}

// 修改TestHeader类
class TestHeader implements HeaderInterface
{
    public function getContent(): string
    {
        // 实现逻辑
        return '';
    }
}

// 更新HeadersInterface的返回类型
interface HeadersInterface
{
    public function profile(string|int $input): HeaderInterface;
}

这样在getView中调用profile后，就能安全调用HeaderInterface定义的方法，无需关心具体是哪个实现类。

低PHP版本兼容方案（PHP < 8.0） #

如果你的PHP版本低于8.0，不支持联合类型，可以使用mixed类型作为参数和返回类型（类型约束会弱一些）：

interface HeadersInterface
{
    public function profile($input);
}

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