1. <?php
  3. /**
  4. * Wraps log stream functions with error handling and defensive checks.
  5. *
  6. * @param callable $logFunction The original log function. Must accept a string.
  7. * @param string $logStreamName A descriptive name for the log stream.
  8. * @return callable A wrapped log function.
  9. */
  10. function wrapLogStream(callable $logFunction, string $logStreamName): callable
  11. {
  12. return function (string $message) use ($logFunction, $logStreamName) {
  13. // Defensive check: Ensure message is a string
  14. if (!is_string($message)) {
  15. throw new InvalidArgumentException("Log message must be a string.");
  16. }
  18. try {
  19. // Perform the logging operation
  20. $logFunction($message);
  21. } catch (Exception $e) {
  22. // Log the error with context
  23. error_log("ERROR: Log stream '$logStreamName' - " . $e->getMessage() . "\n", 3, 'error.log');
  24. // Optionally re-throw the exception, or handle it differently.
  25. // throw $e;
  26. }
  27. };
  28. }
  31. /**
  32. * Example usage: Demonstrates wrapping a hypothetical log function.
  33. */
  34. function hypotheticalLog(string $message): void
  35. {
  36. // Simulate a logging operation
  37. echo date('Y-m-d H:i:s') . " - " . $message . "\n";
  38. }
  42. // Wrap the hypothetical log function for the data migration log stream.
  43. $migrationLog = wrapLogStream(
  44. 'hypotheticalLog',
  45. 'data_migration'
  46. );
  48. // Example calls to the wrapped log function:
  49. $migrationLog("Starting data migration process...");
  50. $migrationLog("Successfully processed record: 123");
  51. $migrationLog("ERROR: Failed to process record: 456 - Invalid data");
  52. $migrationLog(123); // This will trigger an exception and be logged.
  56. ?>

Add your comment