Sugar CRM：添加联系人到目标列表时更新自定义表无响应求助

看起来你遇到的是SugarCRM逻辑钩子不触发的典型场景，我帮你梳理几个关键排查点和修正方案：

首先，核心问题大概率是你挂错了钩子模块——当联系人被添加到目标列表时，实际触发保存动作的是关联模块ProspectListContacts（而非ProspectLists或Contacts本身）。你当前把钩子挂在ProspectLists的after_save，只会在目标列表本身被修改（比如修改名称）时触发，完全覆盖不了"添加联系人到列表"这个操作。

接下来一步步拆解问题并修正：

1. 注册正确的钩子模块与位置 #

你需要把钩子注册到ProspectListContacts模块下：

• 创建/修改文件：custom/modules/ProspectListContacts/logic_hooks.php
• 写入以下代码（确保开头有<?php标签，语法无错误）：

<?php
$hook_array['after_save'][] = Array(
    1, // 钩子优先级，数字越小执行顺序越靠前
    'Update custom table when contact joins target list', // 钩子描述
    'custom/modules/ProspectListContacts/UpdateCustomTableHook.php', // 类文件路径
    'UpdateCustomTableHook', // 类名
    'handleContactAddedToList' // 要执行的方法名
);

2. 编写钩子处理类 #

创建对应的类文件custom/modules/ProspectListContacts/UpdateCustomTableHook.php，内容如下：

<?php
class UpdateCustomTableHook {
    function handleContactAddedToList($bean, $event, $arguments) {
        // 只处理"新建关联记录"的场景，排除更新关联记录的情况
        if (!$arguments['isUpdate']) {
            // 获取关联的联系人与目标列表Bean
            $contact = BeanFactory::getBean('Contacts', $bean->contact_id);
            $targetList = BeanFactory::getBean('ProspectLists', $bean->prospect_list_id);
            
            // 先写日志确认钩子触发，可去cache/logs/sugarcrm.log查看
            error_log("[Custom Hook] Contact {$contact->name} (ID: {$contact->id}) added to Target List {$targetList->name} (ID: {$targetList->id})");
            
            // 这里写入你的自定义表更新逻辑，示例用DB操作：
            $db = DBManagerFactory::getInstance();
            // 注意：实际使用建议用参数绑定避免SQL注入风险
            $db->query("INSERT INTO your_custom_table (contact_id, target_list_id, created_at) 
                        VALUES ('{$contact->id}', '{$targetList->id}', NOW())");
        }
    }
}

3. 关键排查步骤（如果钩子仍未触发） #

• 必须清缓存：SugarCRM不会自动加载新的逻辑钩子，一定要去后台Admin -> Repair -> Quick Repair and Rebuild执行缓存清理，这是90%钩子不触发的原因。
• 检查文件权限：确保钩子文件和类文件的权限为755（或符合服务器权限要求），Web服务器用户（如apache/nginx）要有读取权限。
• 排查语法错误：用PHP命令行检查文件语法：php -l custom/modules/ProspectListContacts/UpdateCustomTableHook.php，语法错误会直接导致钩子不执行且无报错。
• 调试方式要正确：后台操作（如添加联系人到列表）通常是AJAX或后台进程，print_r和exit不会输出到页面，还会中断Sugar流程，改用error_log去sugarcrm.log查看日志。
• 确认触发条件：如果需要处理更新关联记录的场景（比如修改联系人在列表中的状态），可以调整$arguments['isUpdate']的判断逻辑。

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