Français
Français
Dans de nombreuses interfaces API, en particulier les services impliquant des signatures OAuth, des systèmes forestiers ou des opérations de zone inter-temps, il est souvent nécessaire que le client envoie du temps au format UTC (COORDINEND WORD TIME). Par défaut, l'utilisation de la fonction date () renvoie l'heure en fonction du fuseau horaire local du serveur, ce qui peut entraîner des horodatages inexacts si la configuration du fuseau horaire est incohérente.
La fonction GMDate () renvoie toujours le temps GMT / UTC quelle que soit la configuration du serveur. Par conséquent, GMDate () est une option plus fiable lorsque vous devez vous assurer que le temps est le temps UTC standard.
Jetons un coup d'œil à un exemple typique: lors de l'appel d'une API qui nécessite un paramètre d'horodatage, le paramètre doit être au format RFC 1123 (par exemple , mer, 23 mai 2025 12:34:56 GMT ). Il s'agit d'un format de temps courant dans les en-têtes HTTP, comme pour le champ Date .
<?php
// actuel UTC temps，conforme à HTTP Header de Date Format
$date = gmdate('D, d M Y H:i:s') . ' GMT';
// 打印生成detemps
echo $date;
// Exemple：Utilisé dans un API 请求de Header milieu
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://gitbox.net/api/example");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Date: ' . $date,
'Authorization: Bearer YOUR_ACCESS_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
Dans le code ci-dessus, nous utilisons gmdate () pour obtenir le format de temps conforme à l'API et l'ajoutant à l'en-tête de demande. Cela évite l'échec de la vérification ou la demande de rejet en raison de problèmes de fuseau horaire.
Un autre scénario courant consiste à utiliser des horodatages dans le cadre du mécanisme de signature, par exemple lorsque nous devons envoyer une demande signée, l'horodatage peut être une variable dans la chaîne de signature. Pour le moment, le format que nous utilisons couramment est l'horodatage Unix, c'est-à-dire le nombre de secondes de 00:00:00 UTC le 1er janvier 1970 à l'heure actuelle.
<?php
// 获取actuel UTC temps戳
$timestamp = time();
// utiliser gmdate 验证输出de日期
$formatted = gmdate('Y-m-d\TH:i:s\Z', $timestamp);
echo "temps戳：$timestamp\n";
echo "Format化temps：$formatted\n";
// Exemple：Chaîne de signature
$secret = "your_secret";
$signature_base = "timestamp=$timestamp";
$signature = hash_hmac('sha256', $signature_base, $secret);
echo "signe：$signature\n";
?>
GMDate () fournit une représentation temporelle UTC lisible par l'homme ici, tandis que Time () fournit un horodatage brut de transformation de la machine. Les deux peuvent être utilisés de manière flexible au besoin.
S'assurer que l'utilisation du temps UTC est une tâche de base mais critique lors de la gestion des demandes d'API liées au temps. La fonction GMDate () de PHP fournit un moyen simple et direct de générer des chaînes de temps standardisées. Que ce soit utilisé pour les en-têtes HTTP, les mécanismes de signature ou la journalisation, l'utilisation rationnelle de gmdate () peut considérablement améliorer la stabilité et la sécurité de l'interaction d'interface.
En combinant GMDate () et Time () , les développeurs peuvent répondre aux doubles besoins de la lisibilité humaine et de la compatibilité du système en même temps, créant ainsi une logique client API plus robuste.
Étiquettes associées:
API
