1. <?php
  3. /**
  4. * Gracefully handles API responses with fallback mechanisms for monitoring.
  5. *
  6. * @param string $apiUrl The URL of the API endpoint.
  7. * @param callable $fallbackFunction A function to execute if the API request fails.
  8. * @param int $retryAttempts Number of times to retry the API request.
  9. * @param int $retryDelay Delay between retry attempts in seconds.
  10. * @return mixed The API response data or the fallback result.
  11. */
  12. function getApiDataWithFallback(string $apiUrl, callable $fallbackFunction, int $retryAttempts = 3, int $retryDelay = 1): mixed
  13. {
  14. for ($i = 0; $i < $retryAttempts; $i++) {
  15. try {
  16. $response = file_get_contents($apiUrl); // Use file_get_contents for simplicity & minimal dependencies
  17. if ($response === false) {
  18. if ($i === $retryAttempts - 1) {
  19. // Last attempt failed, execute the fallback
  20. return $fallbackFunction();
  21. }
  22. sleep($retryDelay);
  23. continue; // Retry
  24. }
  26. $data = json_decode($response, true); // Decode JSON
  27. if (json_last_error() !== JSON_ERROR_NONE) {
  28. if ($i === $retryAttempts - 1) {
  29. return $fallbackFunction();
  30. }
  31. sleep($retryDelay);
  32. continue; // Retry
  33. }
  35. return $data; // Successfully retrieved and decoded data
  37. } catch (Exception $e) {
  38. if ($i === $retryAttempts - 1) {
  39. return $fallbackFunction();
  40. }
  41. sleep($retryDelay);
  42. continue; // Retry
  43. }
  44. }
  46. return $fallbackFunction(); // Should not reach here, but included for safety
  47. }
  49. // Example Usage (Replace with your API and fallback)
  50. /*
  51. function myFallbackFunction(): array {
  52. // Your fallback logic here (e.g., default data, cached data, etc.)
  53. return ['message' => 'API request failed, using fallback data.', 'data' => []];
  54. }
  56. $apiUrl = 'https://api.example.com/data';
  57. $data = getApiDataWithFallback($apiUrl, 'myFallbackFunction');
  59. if (is_array($data)) {
  60. // Process the API data
  61. print_r($data);
  62. } else {
  63. // Process the fallback data
  64. print_r($data);
  65. }
  66. */
  68. ?>

Add your comment