PHP传递字符串参数时如何实现PhpStorm代码自动补全？

老哥，你写的这段带PHPDoc联合类型注释的代码，其实PhpStorm原生就支持你要的参数提示功能！不过可能得确认几个小细节：

• 确保你的PhpStorm版本不算太老（比如2020.3及以后），旧版本对这种PHPDoc联合类型的解析支持没那么到位
• 检查下项目的PHP语言级别设置：打开File > Settings > Languages & Frameworks > PHP，至少选7.0+（虽然这是PHPDoc标注，但高版本IDE对类型提示的兼容性更好）

正常情况下，当你输入getFruit('之后，光标在引号里时，PhpStorm应该会自动弹出包含apple、banana、pear的补全列表，直接选就行。

要是确实遇到提示不出来的情况，给你几个靠谱的替代方案：

替代方案1：用PHP 8.0+原生联合类型 #

如果你的项目已经升级到PHP 8.0及以上，直接把参数类型改成原生联合类型，IDE的支持会更精准：

function getFruit('apple'|'banana'|'pear' $fruit) {
    // ...
}

这种写法下，不仅输入时会自动提示可选值，要是你传了不符合的字符串，PhpStorm还会直接给语法错误提示，类型检查更严格。

替代方案2：用枚举类型（PHP 8.1+） #

如果项目是PHP 8.1及以上，真心推荐用枚举来管理这些可选值，可读性和IDE支持拉满：

enum Fruit: string {
    case Apple = 'apple';
    case Banana = 'banana';
    case Pear = 'pear';
}

function getFruit(Fruit $fruit) {
    // 需要字符串值的话，直接用 $fruit->value
    $fruitStr = $fruit->value;
    // ...
}

调用的时候，输入getFruit(Fruit::就会自动弹出所有枚举选项，完全不用怕手动输错字符串，类型安全也有保障。

替代方案3：用常量集合 #

要是项目版本较低，没法用枚举和原生联合类型，可以定义一组常量，然后在PHPDoc里引用：

class FruitConstants {
    const APPLE = 'apple';
    const BANANA = 'banana';
    const PEAR = 'pear';
}

/**
 * @param FruitConstants::APPLE|FruitConstants::BANANA|FruitConstants::PEAR $fruit
 */
function getFruit(string $fruit) {
    // ...
}

调用时输入getFruit(FruitConstants::就会提示所有常量，也能避免手动输入字符串出错。

替代方案4：自定义PhpStorm代码模板 #

如果以上方法都不适用，还可以给这个函数整个自定义的Live Template：

1. 打开File > Settings > Editor > Live Templates
2. 点+新建一个模板组，比如MyFruitTemplates
3. 再新建一个模板，缩写设为getFruit，模板内容写：getFruit('$FRUIT$')
4. 在Variables里把FRUIT的选项设为apple, banana, pear
5. 把模板的应用范围设为PHP

之后只要输入getFruit按Tab，就能直接选预设的水果值了。

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