如何让PhpStorm为PHP类方法自定义限定值自动补全？

方法1：使用PHP 8.1+枚举（推荐，类型安全） #

先定义字符串枚举，限定允许的参数值：

enum ImageOrientation: string
{
    case Landscape = 'landscape';
    case Portrait = 'portrait';
    case Square = 'square';
    case Panoramic = 'panoramic';
}

修改方法参数类型为该枚举，默认值同步改为枚举实例：

public function orientation(ImageOrientation $orientation = ImageOrientation::Landscape)
{
    // 如需获取字符串值，调用 $orientation->value
    $orientationStr = $orientation->value;
}

这种方式不仅能让PhpStorm自动提示所有枚举case，还能在PHP层面限制参数只能是合法枚举值，避免非法输入。

方法2：使用PHPDoc注释（兼容低版本PHP） #

如果你的PHP版本低于8.1，可通过PHPDoc注释指定允许的参数值，让PhpStorm识别并提供补全：

/**
 * @param 'landscape'|'portrait'|'square'|'panoramic' $orientation
 */
public function orientation($orientation = 'landscape')
{

}

调用该方法时，PhpStorm会自动弹出这四个字符串值的补全选项。

内容的提问来源于stack exchange，提问作者alireza.haraji.dev