SugarCRM7.9：如何通过模块清单安装Composer依赖包？

我之前也碰到过类似的棘手情况，SugarCRM7对第三方Composer库的原生支持确实有限，尤其是没有命令行权限的时候。下面是两种亲测可行的解决方案，帮你搞定这个问题：

方案一：打包Vendor目录+通过Post-Install钩子加载自动加载器 #

这是最直接的思路：本地先把依赖库装好，打包进模块安装包，然后在模块安装完成后让Sugar自动加载这些库的规则。

步骤1：本地准备兼容的依赖库 #

1. 在你的自定义模块目录（比如custom/modules/YourCustomModule）下创建composer.json文件，注意选和SugarCRM7环境兼容的版本（Sugar7一般要求PHP 5.6/7.0，所以Guzzle选6.x版本，因为Guzzle7需要PHP7.2+）：

{
    "require": {
        "guzzlehttp/guzzle": "^6.5",
        "psr/http-message": "^1.0"
    }
}

2. 本地运行composer install生成vendor目录，把这个目录完整保留在模块文件夹里。

步骤2：配置Manifest.php的Post-Install钩子 #

在模块的manifest.php中添加安装后执行的钩子脚本：

$manifest = array(
    // 其他manifest配置项（名称、版本、描述等）...
    'post_install' => 'custom/modules/YourCustomModule/post_install.php',
);

接着创建post_install.php文件，内容如下：

<?php
function post_install() {
    // 引入第三方库的自动加载器
    $autoloadPath = 'custom/modules/YourCustomModule/vendor/autoload.php';
    if (file_exists($autoloadPath)) {
        require_once $autoloadPath;
    }
}

这个脚本会在模块安装完成后自动执行，注册Guzzle和PSR库的自动加载规则。

步骤3：打包安装并测试 #

把包含vendor目录的模块文件夹打包成ZIP，上传到SugarCRM完成安装。之后你就能在模块的自定义代码里直接调用第三方库了，比如：

$client = new GuzzleHttp\Client();
$response = $client->get('https://api.example.com');

方案二：手动注册自动加载（备用方案） #

如果post_install钩子没生效，你可以在模块的核心代码里手动引入自动加载器。比如在模块的YourCustomModule.php（如果有）或者自定义逻辑钩子的开头添加：

require_once 'custom/modules/YourCustomModule/vendor/autoload.php';

这种方式虽然不够优雅，但能确保每次执行模块代码时，自动加载器都会被加载。

关键注意事项 #

• 版本兼容性：一定要选和SugarCRM7环境匹配的库版本，比如Guzzle6.x而非7.x，避免PHP版本不兼容导致的报错。
• 打包完整性：确保vendor目录下的所有文件和子目录都被打包进安装包，不要遗漏任何内容。
• 测试验证：安装完成后，先写一段简单的测试代码调用Guzzle，确认没有Class not found的错误。

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