Laminas\Crypt模块初始化失败及相关使用问题咨询

问题描述 #

我想在项目中使用Laminas-Crypt的Bcrypt组件，执行了以下命令：
composer require laminas/laminas-crypt、composer dump-autoload、composer update
之后在控制器中添加了use语句：use Laminas\Crypt\Password\Bcrypt;，应用运行正常无报错。但我误以为所有用到的包命名空间都需要在config/modules.config.php中注册才能被自动加载，于是将Laminas\Crypt添加到了该配置文件中，结果应用抛出异常：

Uncaught Laminas\ModuleManager\Exception\RuntimeException: Module (Laminas\Crypt) could not be initialized. in C:\xampp\htdocs\phpLessons\Shortly\vendor\laminas\laminas-modulemanager\src\ModuleManager.php:180

我的疑问：

1. 不在config/modules.config.php中定义所用包的命名空间，应用能否正常运行？
2. 如何处理该异常？

相关配置信息 #

composer.json 的 require 部分 #

"require": {
        "php": ">=8.1.0",
        "laminas/laminas-component-installer": "^3.0",
        "laminas/laminas-development-mode": "^3.2",
        "laminas/laminas-skeleton-installer": "^1.0",
        "laminas/laminas-mvc": "^3.3.4",
        "laminas/laminas-db": "^2.12.0",
        "laminas/laminas-mvc-form": "^2.0.0",
        "laminas/laminas-json": "^3.2",
        "laminas/laminas-log": "^2.13.1",
        "laminas/laminas-cli": "^1.1.1",
        "laminas/laminas-mvc-i18n": "^1.2.0",
        "laminas/laminas-mvc-plugins": "^1.1.0",
        "laminas/laminas-mvc-middleware": "^2.0.0",
        "laminas/laminas-session": "^2.10.0",
        "laminas/laminas-di": "^3.2.2",
        "laminas/laminas-view": "^2.25",
        "laminas/laminas-form": "3.7",
        "laminas/laminas-crypt": "^3.9",
        "ext-pdo": "*",
        "laminas/laminas-mail": "^2.20",
        "doctrine/orm": "^2.14",
        "doctrine/dbal": "^3.2",
        "symfony/yaml": "^5.4",
        "symfony/cache": "^5.4",
        "doctrine/common": "^3.4",
        "doctrine/doctrine-orm-module": "^5.3"
    },

config/modules.config.php 内容 #

return [
    'Laminas\Cache',
    'Laminas\Paginator',
    'Laminas\Mail',
    'Laminas\Mvc\Plugin\FilePrg',
    'Laminas\Mvc\Plugin\FlashMessenger',
    'Laminas\Mvc\Plugin\Identity',
    'Laminas\Mvc\Plugin\Prg',
    'Laminas\Session',
    'Laminas\Mvc\Middleware',
    'Laminas\Mvc\I18n',
    'Laminas\Form',
    'Laminas\I18n',
    'Laminas\Log',
    'Laminas\InputFilter',
    'Laminas\Filter',
    'Laminas\Hydrator',
    'Laminas\Di',
    'Laminas\Db',
    'Laminas\Router',
    'Laminas\Validator',
    'Laminas\DeveloperTools',
    'Laminas\Diactoros',
    'DoctrineModule',
    'DoctrineORMModule',
    'Application',
    'User',
    'Pages',
];

问题解答 #

1. 未在modules.config.php注册命名空间，应用能否正常运行？ #

完全可以。原因如下：

• Composer自带的自动加载机制已经能处理Laminas\Crypt的类加载，只要通过composer require安装了这个包，Composer生成的自动加载器就能找到对应的类文件，不需要把它注册成Laminas MVC的模块。
• 只有当某个包是标准的Laminas MVC模块（包含Module.php文件，需要通过模块注册来加载配置、路由、服务容器定义等）时，才需要在modules.config.php里添加。而laminas/laminas-crypt是独立的工具组件，不属于MVC模块范畴，自然不需要注册。

2. 如何处理添加Laminas\Crypt后抛出的异常？ #

直接把Laminas\Crypt从config/modules.config.php的数组中移除即可。

• 因为laminas/laminas-crypt没有对应的Module类，Laminas的ModuleManager尝试初始化这个“模块”时找不到必要的入口文件，所以抛出异常。移除之后，Composer的自动加载器依然能正常加载Bcrypt类，完全不影响组件功能的使用。

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