如何让PHP函数参数同时支持可选的字符串与数组类型？

我想让函数的某个参数既可以接收字符串或数组类型，同时该参数为可选参数，于是写了下面的示例函数：

function myFunction(string $msg = '' || array $msg = []) { // 这是第9行
    if(is_string($msg)) {
        echo "I'm a string";
    } else if (is_array($msg)){
        echo "I'm an array";
    }
}

这种写法不可行，运行时出现了语法错误：

Parse error: syntax error, unexpected variable "$msg", expecting "("
in /Path/To/My/File/test.php on line 9

我查了PHP官方手册中函数参数的说明，里面提到：

信息可通过参数列表传递给函数，参数列表是逗号分隔的表达式列表。参数会在函数实际调用前从左到右求值（即时求值）。

那为什么我的写法无法运行？

编辑补充：实际使用场景 #

以下是我实际用到的方法：

public function flash(string|array $name = '', string|array $message = '', string $type = '') {
    if (!empty($name) && !empty($message) && $type !== '') {
        // 创建flash消息
        $this->createFlashMessage($name, $message, $type);
    } elseif ($name !== '' && $message === '' && $type === '') {
        // 显示指定flash消息
        return $this->displayFlashMessage($name);
    } elseif ($name === '' && $message === '' && $type === '') {
        // 显示所有flash消息
        return $this->displayAllFlashMessages();
    }
}

第一个参数$name用于指定标识（比如error_msg），会被赋值给$_SESSION[FLASH_MESSAGE][$name]，单一场景下运行正常。但在多文件上传场景中（对应表单<input type="file" name="upload[]" multiple>），调用$upload->uploadFile方法时，该方法可能返回用于存入数据库的逗号分隔文件名字符串，或是包含错误信息的数组：

$upload = ['server_error' => ['message' => 'Error message here', 'type' => 'FLASH_ERROR']];

当存在多个上传错误时，返回的数组结构如下：

$upload = ['server_error' => [['message' => 'First error message', 'type' => 'FLASH_ERROR'],['message' => 'Second Error message', 'type' => 'FLASH_MESSAGE']]];

这就是我需要让参数支持字符串、数组或空值的原因。另外，我正在习惯用短数组语法[]替代array()，可能存在括号书写不规范的情况 :D

问题解答 #

你的错误写法核心问题是PHP联合类型的语法使用错误：

• 不能重复定义同一个参数名（$msg写了两次），也不能用||来分隔类型。
• PHP 8.0及以上支持联合类型，正确写法是用|分隔多个类型，再给参数设置一个符合类型要求的默认值。

修正后的示例函数

// 支持字符串/数组，默认值为空字符串（符合string类型要求）
function myFunction(string|array $msg = '') {
    if(is_string($msg)) {
        echo "I'm a string";
    } elseif (is_array($msg)){
        echo "I'm an array";
    }
}

// 或者默认值设为空数组（也符合array类型要求）
function myFunction(string|array $msg = []) {
    // 逻辑同上
}

针对你实际的flash函数优化建议

考虑到你需要兼容空值、字符串、数组，且参数是可选的，可以调整默认值和逻辑：

1. string|array类型允许空字符串或空数组（都属于对应类型的合法值），默认值可以统一设为''或[]，注意后续判断逻辑的一致性即可。
2. 针对上传返回的数组结构，可在flash函数里增加数组类型参数的处理分支，遍历错误数组批量创建flash消息：

public function flash(string|array $name = '', string|array $message = '', string $type = '') {
    // 处理批量错误数组的场景
    if (is_array($name) && isset($name['server_error'])) {
        foreach ($name['server_error'] as $error) {
            if (isset($error['message'], $error['type'])) {
                $this->createFlashMessage('server_error', $error['message'], $error['type']);
            }
        }
        return;
    }

    // 原有逻辑保留
    if (!empty($name) && !empty($message) && $type !== '') {
        $this->createFlashMessage($name, $message, $type);
    } elseif ($name !== '' && $message === '' && $type === '') {
        return $this->displayFlashMessage($name);
    } elseif ($name === '' && $message === '' && $type === '') {
        return $this->displayAllFlashMessages();
    }
}

这样既保留了原有功能，又能直接接收上传方法返回的错误数组，无需额外转换。

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