PHP中如何为函数参数数组的指定键添加类类型提示？

PHP 原生不支持你示例中直接在数组参数定义内给单个键绑定类型的语法，不存在$options = [\PDO 'pdo']这种声明方式。要实现$options数组中pdo键必须为\PDO实例的约束，可根据实际场景选择以下方案：

• 运行时手动校验（全PHP版本兼容）
  直接在构造方法内判断对应键的传入值类型，不符合要求就抛出类型异常，是最通用的实现方式：

class Database {
    public function __construct(array $options = ['pdo' => null]) {
        if (!($options['pdo'] instanceof \PDO)) {
            throw new \InvalidArgumentException('options 数组的 pdo 字段必须传入 \PDO 类实例');
        }
        $this->pdo = $options['pdo'];
    }
}

• 拆分参数使用原生类型声明（PHP 7.0+ 支持，最推荐）
  不需要强行把所有配置封装成单个数组传参，直接给每个参数声明对应类型，PHP会自动做运行时类型检查，PHP 8.0+还可以配合构造器属性提升简化代码：

class Database {
    // PHP 8.0+ 构造器属性提升写法
    public function __construct(
        private \PDO $pdo,
        private string $host = '127.0.0.1',
        private int $port = 3306
    ) {}
}

• 静态分析注解（开发阶段校验，无运行时性能损耗）
  如果只需要在编码、代码检查阶段拦截类型错误，不需要运行时校验，可以配合PHPStan、Psalm等静态分析工具，通过PHPDoc注释声明数组的结构类型：

class Database {
    /**
     * @param array{pdo: \PDO, host?: string, port?: int} $options
     */
    public function __construct(array $options = []) {
        $this->pdo = $options['pdo'];
    }
}

注意：这种注释声明的方式不会被PHP引擎解析，运行时不会触发类型校验，仅在静态扫描时识别类型错误。

• 配置DTO类替代原生数组（全PHP版本支持，适合复杂配置场景）
  如果配置项较多，可以把配置封装成独立的数据传输类，类属性提前声明好类型，传参时直接传入该类实例，即可获得完整的原生类型约束：

class DatabaseConfig {
    public \PDO $pdo;
    public string $host;
    public int $port;

    public function __construct(\PDO $pdo, string $host = '127.0.0.1', int $port = 3306) {
        $this->pdo = $pdo;
        $this->host = $host;
        $this->port = $port;
    }
}

class Database {
    public function __construct(DatabaseConfig $config) {
        $this->pdo = $config->pdo;
    }
}

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