如何在PHP中创建自定义混合数据类型快捷方式

问题场景 #

在PHP代码中，多个函数的参数需要反复使用string|int|float这类基础联合类型，有时还要加上null变成null|string|int|float，重复书写会拉长代码、降低可读性。比如下面的示例：

public function example(string|int|float $arg1, string|int|float $arg2, null|string|int|float $arg3)
{ /* ... */ }

想知道有没有内置的快捷关键字，或者能不能自定义类似BASIC这样的别名来简化书写，比如：

BASIC = string|int|float
public function example(BASIC $arg1, BASIC $arg2, ?BASIC $arg3)
{ /* ... */ }

可行方案 #

1. 使用PHP 8.2+ 原生类型别名（推荐） #

PHP 8.2及以上版本支持用type关键字定义自定义联合类型别名，完全匹配你的需求：

// 定义全局类型别名
type BASIC = string|int|float;

class YourClass {
    public function example(BASIC $arg1, BASIC $arg2, ?BASIC $arg3)
    { /* ... */ }
}

• ?BASIC 等价于 null|BASIC，刚好对应你需要的null|string|int|float场景
• 类型别名可以放在命名空间内，避免全局命名冲突

2. 低版本PHP兼容方案（PHPDoc注释） #

如果你的PHP版本低于8.2，没法用原生类型别名，可以用PHPDoc注释提升可读性（虽非强类型约束，但主流IDE能识别并提供提示）：

/**
 * @param string|int|float $arg1
 * @param string|int|float $arg2
 * @param string|int|float|null $arg3
 */
public function example($arg1, $arg2, $arg3)
{ /* ... */ }

也可以在注释中自定义别名（部分IDE支持识别）：

/**
 * @typedef string|int|float BASIC
 */

/**
 * @param BASIC $arg1
 * @param BASIC $arg2
 * @param ?BASIC $arg3
 */
public function example($arg1, $arg2, $arg3)
{ /* ... */ }

注意事项 #

• 原生类型别名是编译时生效的强类型约束，和直接书写联合类型的效果完全一致
• 自定义类型别名不要和PHP内置类型、已有类名重名，建议结合业务场景命名，比如ScalarBasic会更清晰

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