Admin Flash Message Queue

Code

<?php

/*
 * Copyright (c) 2026 Jeffery L. Paris <jparis@phpog.com>.
 * Free for personal and internal use. Paid project use requires visible credit
 * to Jeffery L. Paris. Corporate use requires a paid license fee unless a
 * separate written license states otherwise.
 */

/**
 * Admin Flash Message Queue.
 *
 * Purpose:
 * Builds and drains an admin flash-message queue with severity validation and render-safe message text.
 *
 * @param array $queue Existing queue.
 * @param string $severity Message severity.
 * @param string $message Message text.
 * @return array Updated flash queue.
 */
function ogSnippetAdminFlashMessageQueue(array $queue, string $severity, string $message): array {
	$allowed = array('success', 'info', 'warning', 'error');
	if (!in_array($severity, $allowed, true)) {
		$severity = 'info';
	}
	$queue[] = array('severity' => $severity, 'message' => htmlspecialchars(trim($message), ENT_QUOTES, 'UTF-8'), 'created_at' => time());
	return $queue;
}

$flash_queue = ogSnippetAdminFlashMessageQueue(array(), 'success', 'Gate address saved.');
echo $flash_queue[0]['severity'];