lucca_client.php 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219
  1. <?php
  2. /**
  3. * Client API Lucca
  4. *
  5. * Fonctions utilitaires pour communiquer avec l'API Lucca
  6. * Configuration via variables d'environnement pour préprod/prod
  7. */
  8. // --- Configuration (change à l'env de préprod / prod via variables d'environnement) ---
  9. define('LUCCA_API_BASE', getenv('LUCCA_API_BASE') ?: 'https://siparh-livinweb.sandbox.eu1.luccasoftware.com');
  10. define('LUCCA_API_TOKEN', getenv('LUCCA_API_TOKEN') ?: 'ed29a0a8-d394-4c93-b4f7-222360f8b465');
  11. // --- Client HTTP minimal vers Lucca ---
  12. /**
  13. * Effectue une requête HTTP vers l'API Lucca avec gestion avancée des erreurs
  14. *
  15. * @param string $method Méthode HTTP (GET, POST, PUT, DELETE, etc.)
  16. * @param string $path Chemin de l'endpoint (ex: /users, /leaves)
  17. * @param array $query Paramètres de query string
  18. * @param mixed $body Corps de la requête (array ou string)
  19. * @param int $timeout Timeout en secondes
  20. * @param bool $debug Active le mode debug Lucca ($debug=true)
  21. * @return array [
  22. * 'code' => int,
  23. * 'body' => string,
  24. * 'data' => array|null (JSON décodé),
  25. * 'error' => string|null,
  26. * 'lucca_error' => string|null (X-Lucca-ErrorMessage header),
  27. * 'error_message' => string|null (ErrorMessage du body),
  28. * 'headers' => array,
  29. * 'curl_info' => array
  30. * ]
  31. */
  32. function lucca_request(string $method, string $path, array $query = [], $body = null, int $timeout = 20, bool $debug = false): array {
  33. // Ajout automatique du paramètre $debug si demandé
  34. if ($debug) {
  35. $query['$debug'] = 'true';
  36. }
  37. $url = rtrim(LUCCA_API_BASE, '/') . '/' . ltrim($path, '/');
  38. if (!empty($query)) {
  39. $url .= '?' . http_build_query($query);
  40. }
  41. $headers = [
  42. 'Accept: application/json',
  43. 'Content-Type: application/json',
  44. 'Authorization: lucca application=' . LUCCA_API_TOKEN,
  45. ];
  46. $ch = curl_init($url);
  47. curl_setopt_array($ch, [
  48. CURLOPT_CUSTOMREQUEST => strtoupper($method),
  49. CURLOPT_RETURNTRANSFER => true,
  50. CURLOPT_HEADER => true, // ✅ Inclure les headers dans la réponse
  51. CURLOPT_HTTPHEADER => $headers,
  52. CURLOPT_TIMEOUT => $timeout, // Utilise le paramètre $timeout passé à la fonction
  53. CURLOPT_CONNECTTIMEOUT => min(30, $timeout), // Timeout de connexion augmenté à 30s max
  54. CURLOPT_SSL_VERIFYPEER => false, // Pour test local/sandbox
  55. CURLOPT_SSL_VERIFYHOST => false, // Pour test local/sandbox
  56. CURLOPT_FOLLOWLOCATION => true,
  57. CURLOPT_VERBOSE => false,
  58. ]);
  59. if ($body !== null) {
  60. curl_setopt($ch, CURLOPT_POSTFIELDS, is_string($body) ? $body : json_encode($body, JSON_UNESCAPED_UNICODE));
  61. }
  62. $response = curl_exec($ch);
  63. $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
  64. $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
  65. $err = curl_error($ch);
  66. $errno = curl_errno($ch);
  67. $info = curl_getinfo($ch);
  68. curl_close($ch);
  69. // Séparer headers et body
  70. $response_headers = substr($response, 0, $header_size);
  71. $response_body = substr($response, $header_size);
  72. // ✅ Extraction du header X-Lucca-ErrorMessage
  73. $lucca_error = null;
  74. if (preg_match('/X-Lucca-ErrorMessage:\s*(.+)/i', $response_headers, $match)) {
  75. $lucca_error = trim($match[1]);
  76. }
  77. // ✅ Parser les headers en tableau
  78. $headers_array = [];
  79. foreach (explode("\r\n", $response_headers) as $line) {
  80. if (strpos($line, ':') !== false) {
  81. list($key, $value) = explode(':', $line, 2);
  82. $headers_array[trim($key)] = trim($value);
  83. }
  84. }
  85. // ✅ Décoder le body JSON
  86. $data = json_decode($response_body, true);
  87. // ✅ Extraire ErrorMessage du body si présent
  88. $error_message_field = null;
  89. if (is_array($data) && isset($data['ErrorMessage'])) {
  90. $error_message_field = $data['ErrorMessage'];
  91. }
  92. // Diagnostic détaillé cURL
  93. $error_curl = null;
  94. if ($errno !== 0) {
  95. $error_curl = "cURL Error #$errno: $err";
  96. } elseif ($code === 0) {
  97. $error_curl = "Connection failed - no response from server. Check network/firewall. URL: $url";
  98. }
  99. return [
  100. 'code' => (int)$code,
  101. 'body' => $response_body ?: '',
  102. 'data' => $data,
  103. 'error' => $error_curl,
  104. 'lucca_error' => $lucca_error,
  105. 'error_message' => $error_message_field,
  106. 'headers' => $headers_array,
  107. 'curl_info' => [
  108. 'url' => $info['url'] ?? $url,
  109. 'total_time' => $info['total_time'] ?? 0,
  110. 'namelookup_time' => $info['namelookup_time'] ?? 0,
  111. 'connect_time' => $info['connect_time'] ?? 0,
  112. ]
  113. ];
  114. }
  115. /**
  116. * Fonction helper pour appeler Lucca et gérer les erreurs proprement
  117. *
  118. * @param string $method Méthode HTTP
  119. * @param string $path Chemin de l'endpoint
  120. * @param array $query Paramètres query string
  121. * @param mixed $body Corps de la requête
  122. * @param bool $debug Active le mode debug Lucca
  123. * @return array Les données décodées (data) en cas de succès
  124. * @throws Exception En cas d'erreur détaillée
  125. */
  126. function lucca_request_safe(string $method, string $path, array $query = [], $body = null, bool $debug = false): array {
  127. $result = lucca_request($method, $path, $query, $body, 20, $debug);
  128. // Erreur cURL
  129. if (!empty($result['error'])) {
  130. throw new Exception("Erreur cURL: " . $result['error']);
  131. }
  132. // Erreur dans le header X-Lucca-ErrorMessage
  133. if (!empty($result['lucca_error'])) {
  134. throw new Exception("Erreur Lucca (header): " . $result['lucca_error']);
  135. }
  136. // Erreur dans le body ErrorMessage
  137. if (!empty($result['error_message'])) {
  138. throw new Exception("Erreur Lucca (body): " . $result['error_message']);
  139. }
  140. // Code HTTP non-2xx
  141. if ($result['code'] < 200 || $result['code'] >= 300) {
  142. $error = "Erreur HTTP {$result['code']}";
  143. // Essayer d'extraire plus d'infos du body
  144. if (isset($result['data']['title'])) {
  145. $error .= ": " . $result['data']['title'];
  146. }
  147. if (isset($result['data']['traceId'])) {
  148. $error .= " (traceId: {$result['data']['traceId']})";
  149. }
  150. throw new Exception($error);
  151. }
  152. return $result['data'] ?? [];
  153. }
  154. /**
  155. * Formatte une réponse d'erreur détaillée pour les endpoints
  156. *
  157. * @param array $result Résultat de lucca_request()
  158. * @return array Payload d'erreur formaté pour json_response()
  159. */
  160. function lucca_format_error(array $result): array {
  161. $error = [
  162. "error" => "Erreur API Lucca",
  163. "http_code" => $result['code'],
  164. "response_body" => $result['body']
  165. ];
  166. // ✅ Ajouter X-Lucca-ErrorMessage si présent
  167. if (!empty($result['lucca_error'])) {
  168. $error['lucca_error_header'] = $result['lucca_error'];
  169. }
  170. // ✅ Ajouter ErrorMessage du body si présent
  171. if (!empty($result['error_message'])) {
  172. $error['lucca_error_message'] = $result['error_message'];
  173. }
  174. // ✅ Ajouter les détails du data si disponible
  175. if (!empty($result['data'])) {
  176. if (isset($result['data']['title'])) {
  177. $error['title'] = $result['data']['title'];
  178. }
  179. if (isset($result['data']['traceId'])) {
  180. $error['trace_id'] = $result['data']['traceId'];
  181. }
  182. if (isset($result['data']['type'])) {
  183. $error['type'] = $result['data']['type'];
  184. }
  185. }
  186. // Erreur cURL
  187. if (!empty($result['error'])) {
  188. $error['curl_error'] = $result['error'];
  189. }
  190. return $error;
  191. }