summaryrefslogtreecommitdiffstats
path: root/lib/SimpleSAML/XML/Errors.php
blob: c56d95b74b8ec8679f1c2a78aac349d6f06ed609 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?php

/**
 * This class defines an interface for accessing errors from the XML library.
 *
 * In PHP versions which doesn't support accessing error information, this class
 * will hide that, and pretend that no errors were logged.
 *
 * @author Olav Morken, UNINETT AS.
 * @package SimpleSAMLphp
 */
class SimpleSAML_XML_Errors {

	/**
	 * This is an stack of error logs. The topmost element is the one we are
	 * currently working on.
	 */
	private static $errorStack = array();

	/**
	 * This is the xml error state we had before we began logging.
	 */
	private static $xmlErrorState;


	/**
	 * Append current XML errors to the the current stack level.
	 */
	private static function addErrors() {

		$currentErrors = libxml_get_errors();
		libxml_clear_errors();

		$level = count(self::$errorStack) - 1;
		self::$errorStack[$level] = array_merge(self::$errorStack[$level], $currentErrors);
	}


	/**
	 * Start error logging.
	 *
	 * A call to this function will begin a new error logging context. Every call must have
	 * a corresponding call to end().
	 */
	public static function begin() {

		// Check whether the error access functions are present
		if(!function_exists('libxml_use_internal_errors')) {
			return;
		}

		if(count(self::$errorStack) === 0) {
			// No error logging is currently in progress. Initialize it.
			self::$xmlErrorState = libxml_use_internal_errors(TRUE);
			libxml_clear_errors();
		} else {
			/* We have already started error logging. Append the current errors to the
			 * list of errors in this level.
			 */
			self::addErrors();
		}

		// Add a new level to the error stack
		self::$errorStack[] = array();
	}


	/**
	 * End error logging.
	 *
	 * @return  An array with the LibXMLErrors which has occurred since begin() was called.
	 */
	public static function end() {

		// Check whether the error access functions are present
		if(!function_exists('libxml_use_internal_errors')) {
			// Pretend that no errors occurred
			return array();
		}

		// Add any errors which may have occurred
		self::addErrors();


		$ret = array_pop(self::$errorStack);

		if(count(self::$errorStack) === 0) {
			// Disable our error logging and restore the previous state
			libxml_use_internal_errors(self::$xmlErrorState);
		}

		return $ret;
	}


	/**
	 * Format an error as a string.
	 *
	 * This function formats the given LibXMLError object as a string.
	 *
	 * @param $error  The LibXMLError which should be formatted.
	 * @return  A string representing the given LibXMLError.
	 */
	public static function formatError($error) {
		assert('$error instanceof LibXMLError');
		return 'level=' . $error->level . ',code='  . $error->code . ',line=' . $error->line . ',col=' . $error->column .
			',msg=' . trim($error->message);
	}


	/**
	 * Format a list of errors as a string.
	 *
	 * This fucntion takes an array of LibXMLError objects and creates a string with all the errors.
	 * Each error will be separated by a newline, and the string will end with a newline-character.
	 *
	 * @param $errors  An array of errors.
	 * @return  A string representing the errors. An empty string will be returned if there were no
	 *          errors in the array.
	 */
	public static function formatErrors($errors) {
		assert('is_array($errors)');

		$ret = '';
		foreach($errors as $error) {
			$ret .= self::formatError($error) . "\n";
		}

		return $ret;
	}

}