Skip to content

A free, self-hostable news aggregator…

1.9 KB
Raw Blame
<?php
declare(strict_types=1);

/**
 * MINZ - Copyright 2011 Marien Fressinaud
 * Licensed under AGPL3 <https://www.gnu.org/licenses/>
*/

/**
 * The Minz_Error class logs and raises framework errors
 */
class Minz_Error {
	public function __construct() {}

	/**
	* Raises an error
	* @param int $code the error code, 404 by default (page not found)
	* @param string|array<'error'|'warning'|'notice',list<string>> $logs error logs grouped as follows
	*      > $logs['error']
	*      > $logs['warning']
	*      > $logs['notice']
	* @param bool $redirect If true, uses an HTTP redirection, and if false (default), performs an internal dispatcher redirection.
	*/
	public static function error(int $code = 404, string|array $logs = [], bool $redirect = true): void {
		$logs = self::processLogs($logs);

		Minz_Session::_params([
			'error_code' => $code,
			'error_logs' => $logs,
		]);

		// Also pass the error code by URL, in case the session is lost (session ID rotation)
		Minz_Request::forward(['c' => 'error', 'params' => ['code' => $code]], $redirect);
	}

	/**
	 * Returns filtered logs
	 * @param string|array<'error'|'warning'|'notice',list<string>> $logs logs sorted by category (error, warning, notice)
	 * @return list<string> list of matching logs, without the category, according to environment preferences (production / development)
	 */
	private static function processLogs(string|array $logs): array {
		if (is_string($logs)) {
			return [$logs];
		}

		$error = [];
		$warning = [];
		$notice = [];

		if (is_array($logs['error'] ?? null)) {
			$error = $logs['error'];
		}
		if (is_array($logs['warning'] ?? null)) {
			$warning = $logs['warning'];
		}
		if (is_array($logs['notice'] ?? null)) {
			$notice = $logs['notice'];
		}

		switch (Minz_Configuration::get('system')->environment) {
			case 'development':
				return array_merge($error, $warning, $notice);
			case 'production':
			default:
				return $error;
		}
	}
}