Kann ich in PHP einen Alias ​​für einen gesamten Namespace erstellen?

Question

Kann ich Namespace-Aliase mit PHP 8.1-Funktionen erstellen (z. B. Kategorienamen)?

Wir haben das Standard-Namespace-Modul in der Firma „Subcompany“ genannt und möchten, dass es jetzt „Company“ heißt, da seine Verwendung erweitert wurde.

Eine perfekte Antwort besteht darin, so wenig Overhead wie möglich zu haben und ein transparentes automatisches Laden zu ermöglichen. Ein Problem besteht darin, dass Tools wie Intelepense diesen Alias ​​verstehen.

Dieses Projekt verwendet auch Composer, daher funktioniert auch die Lösung zum Umschreiben des Namespace damit.

Answer 1

是的，并且思考：class_alias 是随 PHP 5.3 引入的，并且它的新命名空间语言功能。它的创建是为了更容易地从全局命名空间迁移到命名空间 - 实际上是在命名空间之间。

但是，您需要首先为每个旧类/接口/特征/枚举注册一个类别名到新的对应项。

My\Old\Lib\Name\Module\Submodule\Interface
My\Tiger\Lib\Name\Module\Submodule\Interface

旧的库已经消失，现在有了全新的 Tiger 库。它们的所有类等都可以通过交换命名空间前缀来映射（'My\Old\Lib\Name\' -> 'My\Tiger\Lib\Name'）。

这可以在运行时完成，因为 PHP 会为您完成大部分工作。

注册一个自动加载器，它基于旧的命名空间前缀作为新的命名空间前缀加载，并预先将类别名为旧名称。

示例：

spl_autoload_register(
    static function (string $class_name) {
        static $old = 'My\\Old\\Lib\\Name\\';
        static $new = 'My\\Tiger\\Lib\\Name\\';

        // only operate on the old namespace
        if (0 !== strpos($class_name, $old)) {
            return;
        }
        $new_name = substr_replace($class_name, $new, 0, strlen($old));
        class_alias($new_name, $class_name);
        $exists = class_exists($new_name);
    },
    $throw = true,   /* throw when registering fails */
    $prepend = false /* only alias at fall-through */
);

这段代码很简单，只需对注册参数做两点说明：

1. $throw = true：当别名自动加载器无法注册时，您希望立即停止应用程序，否则您会在很久以后收到奇怪的“未找到类”错误。
2. $prepend = false：仅当仍有代码使用旧类名时，才应调用回调。因此，现在使用新命名空间和标准自动加载的标准代码是第一位的。

也许值得注意的是 class_exists() 部分：

        $exists = class_exists($new_name);

如果新类尚未加载，它会触发自动加载。

注册自动加载器后，旧代码将自动加载旧别名下的新类。

use My\Old\Lib\Name\Module\Boring;

$boring = new Boring();
assert($boring instanceof My\Old\Lib\Name\Module\Boring);
var_dump(get_class($boring)); # string(31) "My\Tiger\Lib\Name\Module\Boring"

• 3v4l.org 上的完整示例。