<?php
/**
 * Log handling functionality.
 *
 * @class IG_LOG_Handler
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}

if ( ! class_exists( 'IG_Log_Handler' ) ) {
	/**
	 * IG Log Handler Class
	 */
	abstract class IG_Log_Handler implements IG_Log_Handler_Interface {

		/**
		 * Formats a timestamp for use in log messages.
		 *
		 * @param int $timestamp Log timestamp.
		 *
		 * @return string Formatted time for use in log entry.
		 */
		protected static function format_time( $timestamp ) {
			return gmdate( 'c', $timestamp );
		}

		/**
		 * Builds a log entry text from level, timestamp and message.
		 *
		 * @param int    $timestamp Log timestamp.
		 * @param string $level emergency|alert|critical|error|warning|notice|info|debug.
		 * @param string $message Log message.
		 * @param array  $context Additional information for log handlers.
		 *
		 * @return string Formatted log entry.
		 */
		protected static function format_entry( $timestamp, $level, $message, $context ) {
			$time_string  = self::format_time( $timestamp );
			$level_string = strtoupper( $level );
			$entry        = "{$time_string} {$level_string} {$message}";

			return apply_filters(
				'ig_format_log_entry',
				$entry,
				array(
					'timestamp' => $timestamp,
					'level'     => $level,
					'message'   => $message,
					'context'   => $context,
				)
			);
		}
	}
}
