kknongchang_2506/app/Module/UrsPromotion/Commands

Urs推广模块命令行工具

URS推荐关系同步命令 (UrsReferralSyncCommand)

功能描述

用于从URS获取用户上级关系，同步到本地数据库的命令行工具。支持同步指定用户或所有用户的推荐关系。

命令签名

php artisan urs:sync-referral [urs_user_id] [options]

参数说明

• urs_user_id (可选): URS用户ID，不指定则同步所有用户

选项说明

• --batch-size=100: 批处理大小，默认100
• --force: 强制重新同步已存在的关系
• --dry-run: 仅模拟运行，不实际执行同步

使用示例

1. 同步指定用户

# 同步URS用户ID为1001的推荐关系
php artisan urs:sync-referral 1001

# 强制重新同步已存在的关系
php artisan urs:sync-referral 1001 --force

# 模拟运行，查看将要执行的操作
php artisan urs:sync-referral 1001 --dry-run

2. 批量同步所有用户

# 同步所有用户的推荐关系
php artisan urs:sync-referral

# 指定批处理大小为50
php artisan urs:sync-referral --batch-size=50

# 强制重新同步所有用户
php artisan urs:sync-referral --force

# 模拟运行批量同步
php artisan urs:sync-referral --dry-run

技术实现

1. 调用 \App\Module\AppGame\Handler\Public\Login4uHandler::syncReferralRelations 方法
2. 使用 UrsUserMappingService 获取用户映射关系
3. 通过 UrsService::getUserTeam() 获取URS上级关系
4. 支持批量处理，避免内存溢出
5. 提供详细的进度显示和错误处理

注意事项

• 只有已进入农场的用户才能同步推荐关系
• 已存在的推荐关系默认会跳过，除非使用 --force 选项
• 批量同步时会显示进度条和统计结果
• 所有操作都会记录详细日志