一、sync_helper.php 总览

sync_helper.php 是整个项目的基础设施层提供了 Token 生命周期管理、API 调用封装、数据库连接、日志记录等通用功能。所有同步模块都依赖它，无需重复实现。

二、配置管理

config.json 结构

{
"appKey": "IERNZ8N49YRWRM6OBPCDQKE0WY9AK7UZ","appSecret": "YOUR_APP_SECRET","certificate": "YOUR_CERTIFICATE","secretKey": "YOUR_SECRET_KEY","openToken": "eyJhbG...","refreshToken": "def502..."。"token_expiry": null,"refresh_expiry": null,"db": {
再看"host"，".","port": "","name": "sq_t1","user": "root","pass": "your_password"
}
}

动态更新配置

function loadConfig {
$json = file_get_contents;老实说，return json_decode;不过，}
function saveConfig: void {
file_put_contents(
__DIR__ . '/config.json'。json_encode
);}

三、Token 生命周期管理

智能刷新策略

避免因 Token 即将过期导致同步中断，提前预判并主动刷新。

关键实现

function getValidToken: string {
$now = time;按理说，$expiry = $config?，0;// 提前5分钟刷新
if && )) {
return $config;}
// 优先使用 refreshToken
if && )) {
try {
$newToken = refreshToken;if return $newToken;} catch {
logMsg}");}
}
// 完整流程
return fullTokenFlow;}

四、AES 解密实现

算法参数

• AES--ECB 为无分组加密模式，不支持 C娱乐 的随机 IV。
• PADDING 必须手动处理；openssl 默认使用 PKCS7.

完整解密函数

function decryptAppTicket: string {
// Base64 解码
$decoded = base64_decode;// AES--ECB 解密
$decrypted = openssl_decrypt(
$decoded。'AES-128-ECB',hex2bin),OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING
);if { // 降级尝试：PKCS7 填充模式
$decrypted = openssl_decrypt(
$decoded。
'AES-128-ECB',hex2bin),OPENSSL_RAW_DATA
);}
if throw new Exception;// 手动去除 PKCS5 尾部填充
${'pad'} = ord);if ) {
${'decrypted'} = substr;}
// 解析 JSON 提取 appTicket
${'data'} = json_decode;if ) throw new Exception;return ${'data'};}

多密钥兼容机制

五、API 调用封装

通用 HTTP 调用

function callApi(string &$url。mixed &$data,array &$headers=):array{
\Curl\Curl::setTimeout;\Curl\Curl::setConnectTimeout;\Curl\Curl::setSslVerifyPeer;// 内网环境
\$ch= curl_init;curl_setopt_array?json_encode:\$data,CURLOPT_HTTPHEADER=>\$headers,CURLOPT_RETURNTRANSFER=>true。CURLOPT_TIMEOUT=>30,CURLOPT_CONNECTTIMEOUT=>10,CURLOPT_SSL_VERIFYPEER=>false]);\$response=curl_exec;说起来，\$httpCode=curl_getinfo;老实说，\$error=curl_error;curl_close，不过，if {throw new Exception;}
\$res=json_decode;if {throw new Exception?\$res:\$response)));}
return \$res;}
\end{kbd}

T+ API 专用封装