如何在 Laminas (Zend Framework) 项目中正确使用 composer？

Composer是Laminas项目的核心，用于依赖管理、自动加载和模块化架构。通过psr-4配置命名空间映射，使用composer require安装组件（如laminas-mvc），并借助laminas-component-installer自动注册模块；若未自动注册，需手动添加至modules.config.php，并注意加载顺序（如DoctrineModule在DoctrineORMModule前）。开发自定义模块时可将其打包为laminas-module类型，通过repositories引入私有包并require安装，实现复用。正确配置composer.json并运行dump-autoload确保类自动加载，使项目结构清晰、可维护性强。

在 Laminas 项目中，Composer 不只是依赖管理工具，更是模块加载、自动加载和应用结构组织的核心。正确使用 Composer 能让项目更清晰、可维护性更强。

理解 Laminas 与 Composer 的关系

Laminas（原 Zend Framework）从版本 3 开始全面转向 Composer 驱动的模块化架构。每个组件都是独立的 Composer 包，通过 PSR-4 自动加载 和 模块配置注册 来工作。

项目初始化后，composer.json 文件定义了所有依赖，包括框架组件、第三方库以及你自己的模块。

配置 composer.json 正确引入依赖

确保你的 composer.json 正确设置自动加载规则和依赖项：

• psr-4 自动加载：将自定义模块命名空间映射到目录，例如：

"autoload": {
    "psr-4": {
        "Application\\": "module/Application/src/",
        "Api\\": "module/Api/src/"
    }
}

• 运行 composer dump-autoload 更新自动加载映射，尤其在新增类或命名空间后。
• 安装 Laminas 组件时，使用官方推荐方式：

composer require laminas/laminas-mvc
composer require laminas/laminas-db

这些包会自动注册必要的模块（通过 Composer 的 extra.classmap 或 Module.php 发现机制）。

模块注册与加载顺序

Laminas 应用通过 config/modules.config.php 或 ConfigProvider 加载模块。但很多模块依赖 Composer 在安装时写入配置。

• 某些 Laminas 包支持 laminas-component-installer，安装时会自动提示是否注册模块。
• 若未自动注册，手动将其添加到 modules.config.php 中，例如：

return [
    'Laminas\Mvc\Plugin\Identity',
    'Laminas\Mvc\Console',
    'Application',
];

• 注意加载顺序：如 DoctrineModule 必须在 DoctrineORMModule 之前。

开发自定义模块并发布为包（可选）

如果你开发的模块想在多个项目中复用，可以将其打包为私有或公开的 Composer 包：

• 创建独立仓库，包含自己的 composer.json，类型设为 laminas-module。
• 在主项目中通过 repositories 引入私有包：

"repositories": [
    {
        "type": "path",
        "url": "../my-laminas-module"
    }
]

• 然后执行 composer require my-vendor/my-module 安装。

基本上就这些。关键是把 Composer 当作整个 Laminas 项目的“中枢”，不只是装包工具。只要自动加载配置对了，模块能被发现，后续开发就很顺畅。