PHP利用Crontab定时刷新并保存微信Access Token

背景与核心思路

在微信公众平台开发中，access_token 的全局唯一性决定了其必须妥善保存。该凭证的有效期为 7200秒（2小时）。若在同一时间内重复获取，上一次获取的 token 将立即失效。因此，开发者不应在每次业务请求时临时获取 token，而应采用“一次获取，多次复用”的策略。

推荐的做法是将 token 保存在服务器端的文件中、数据库中或缓存系统（如 Redis）里，并利用操作系统的计划任务（如 Crontab）定期刷新，以平衡时效性与合规性。

准备条件

1. 服务器环境：已配置好 PHP 运行环境的 Linux 服务器（示例以 CentOS 为例）。
2. 开发者权限：拥有微信公众平台 AppID 和 AppSecret，可从后台“设置 → 公众号设置 → 功能设置 → JS安全域名/网页授权域名”等相关基础配置中获取。
3. CURL 扩展：确保 PHP 已开启 CURL 扩展，用于发起 HTTPS 请求。

第1步：创建 Token 获取脚本

首先，编写一个 PHP 脚本用于向微信服务器申请 token 并将其写入本地文件。

操作入口：在项目根目录下新建 access_token.php 文件。

代码逻辑：

• 构造微信官方 API 地址，拼接 AppID 和 Secret。
• 使用 CURL 发起 GET 请求获取 JSON 响应。
• 将返回的 token 字符串写入同目录下的 access_token.php 配置文件。

<?php
// 定义 AppID 和 Secret (请替换为真实值)
define('AppID', 'YOUR_APP_ID');
define('AppSecret', 'YOUR_APP_SECRET');

// 微信 API 地址
$url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" . AppID . "&secret=" . AppSecret;

// 执行请求
$result = http_request($url);

if ($result) {
    // 解析 JSON 结果
    $data = json_decode($result, true);
    if (isset($data['access_token'])) {
        $dir = __DIR__; // 使用绝对路径避免 cron 执行时的上下文问题
        $filename = $dir . "/wx_config.php"; // 改为更明确的文件名
        create_file($filename, '<?php
' . '$config["access_token"] = "' . $data['access_token'] . '";
' . '$config["expires_in"] = ' . $data['expires_in'] . ';');
        echo "Token updated successfully at: " . date('Y-m-d H:i:s') . "\n";
    } else {
        echo "Failed to get token: " . $result . "\n";
    }
} else {
    echo "HTTP request failed.\n";
}

function http_request($url, $data = null){
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
    if (!empty($data)){
        curl_setopt($curl, CURLOPT_POST, 1);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    }
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $output = curl_exec($curl);
    curl_close($curl);
    return $output;
}

function create_file($filename, $content){
    $fp = fopen($filename, "w+");
    fwrite($fp, $content);
    fclose($fp);
}
?>

第2步：设置 Crontab 定时任务

为了确保 Token 在过期前得到更新，需要设置定时任务。虽然 Token 有效期为2小时，但建议在到期前一段时间（如每1小时或50分钟）刷新一次，以预留缓冲时间。

操作入口：终端命令行输入 crontab -e。

配置示例：以下规则表示每小时第5分钟执行一次脚本，并将日志输出到指定文件以便排查错误。

# 每小时的第5分钟执行一次
5 * * * * /usr/bin/php /path/to/your/access_token.php >> /var/log/wechat_token_update.log 2>&1

请确保 /usr/bin/php 是你服务器上实际的 PHP CLI 可执行文件路径。

第3步：验证与排错

• 手动测试：先手动运行一次脚本 php access_token.php，检查是否生成了配置文件且内容符合预期（JSON 包含 access_token 字段）。
• 查看日志：如果 cron 不执行，检查 /var/log/cron 或脚本输出的日志文件，确认是否有权限错误或语法错误。
• 安全性：生成的包含 Token 的文件应禁止 Web 访问。可通过 Nginx/Apache 配置限制 .php 或特定目录的直接访问，或在文件中增加判断 if(!defined('APP_EXEC')) exit;。

总结

通过 PHP 脚本自动化获取并保存微信 access_token，配合 Crontab 定时刷新，可以有效避免因频繁请求导致的 API 限流风险，同时保证业务调用的连续性。关键在于合理设置刷新频率与安全的存储策略。

以上就是 PHP 利用 Crontab 定时刷新并保存微信 Access Token 的详细内容，更多关于 PHP 微信开发技巧与 Token 管理的资料请关注本站其它相关文章！