如何让PhpStorm对数组参数启用ExpectedValues/expectedArguments自动补全？

可以通过#[ExpectedValues]特性或PHPDoc的@expectedArguments元指令实现，核心是明确数组元素的类型，让PHPStorm识别数组内元素的补全规则：

方法一：使用PHP 8特性 #[ExpectedValues] #

给参数声明string|array<string>类型，同时在特性中指定数组匹配模式：

use JetBrains\PhpStorm\ExpectedValues;

#[ExpectedValues(
    values: ['value1', 'value2', 'value anything'],
    matchType: ExpectedValues::MATCH_TYPE_ARRAY
)]
function myFunction(string|array $param) {
    // 函数逻辑
}

调用时，传入单个字符串会直接补全预设值；传入数组时，数组内的每个元素都会触发预设值的自动补全提示。

方法二：使用PHPDoc的@expectedArguments元指令 #

通过PHPDoc声明参数类型，并指定参数的可选值：

/**
 * @param string|array<string> $param
 * @expectedArguments 0 'value1', 'value2', 'value anything'
 */
function myFunction(string|array $param) {
    // 函数逻辑
}

这里的0代表第一个参数的索引，后续的字符串就是预设的可选值，PHPStorm会自动识别数组内元素的补全规则。

关键注意事项 #

• 必须明确数组元素类型为string（如array<string>），否则PHPStorm无法判断数组元素的补全范围
• 确保预设值的类型与参数类型一致（这里均为字符串），避免类型不匹配导致补全失效

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