如何避免在方法返回值中重复声明数组形状？

针对你遇到的问题——属性已定义完整类型但getter方法需要重复写类型注释的情况，有以下几种实用方案：

• 利用PHPStan自动类型推断（优先推荐）
  确保属性带有原生array类型声明并初始化，PHPStan会自动识别属性的PHPDoc泛型/形状定义，并将其关联到返回该属性的getter方法上，无需在@return中重复书写：

  class Foo
  {
      /**
       * @var array<string, array{name: string, age: int}>
       */
      private array $things = [];
  
      public function getThings(): array
      {
          return $this->things;
      }
  }
  

  这样PHPStan会直接复用属性的完整类型信息，不会再抛出返回类型缺少值类型的警告。

• 定义PHPDoc类型别名统一维护
  如果该数组形状会在多个地方复用，可以通过PHPDoc的@type定义类型别名，在属性和方法中引用别名即可，既减少重复，也方便后续统一修改：

  /**
   * @type ThingList = array<string, array{name: string, age: int}>
   */
  class Foo
  {
      /**
       * @var ThingList
       */
      private array $things = [];
  
      /**
       * @return ThingList
       */
      public function getThings(): array
      {
          return $this->things;
      }
  }
  

• 配置PHPStan忽略特定警告（不推荐）
  若暂时不想修改代码，可在phpstan.neon配置文件中添加规则忽略，但这会削弱类型检查的严谨性，仅作为临时妥协方案：

  parameters:
      ignoreErrors:
          - '#Method Foo::getThings\(\) return type has no value type specified in iterable type array#'
  

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