Project

General

Profile

Download (9.97 KB) Statistics
| Branch: | Tag: | Revision:
1
<?php
2
/*
3
 * xmlparse.inc
4
 *
5
 * part of pfSense (https://www.pfsense.org)
6
 * Copyright (c) 2004-2013 BSD Perimeter
7
 * Copyright (c) 2013-2016 Electric Sheep Fencing
8
 * Copyright (c) 2014-2023 Rubicon Communications, LLC (Netgate)
9
 * All rights reserved.
10
 *
11
 * originally part of m0n0wall (http://m0n0.ch/wall)
12
 * Copyright (c) 2003-2004 Manuel Kasper <mk@neon1.net>.
13
 * All rights reserved.
14
 *
15
 * Licensed under the Apache License, Version 2.0 (the "License");
16
 * you may not use this file except in compliance with the License.
17
 * You may obtain a copy of the License at
18
 *
19
 * http://www.apache.org/licenses/LICENSE-2.0
20
 *
21
 * Unless required by applicable law or agreed to in writing, software
22
 * distributed under the License is distributed on an "AS IS" BASIS,
23
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
24
 * See the License for the specific language governing permissions and
25
 * limitations under the License.
26
 */
27

    
28
/* The following items will be treated as arrays in config.xml */
29
function listtags() {
30
	/*
31
	 * Please keep this list alpha sorted and no longer than 80 characters
32
	 * I know it's a pain, but it's a pain to find stuff too if it's not
33
	 */
34
	$ret = array(
35
		'acls', 'alias', 'aliasurl', 'allowedip', 'allowedhostname', 'authserver',
36
		'bridged', 'build_port_path',
37
		'ca', 'cacert', 'cert', 'crl', 'clone', 'config', 
38
		'container', 'columnitem', 'checkipservice',
39
		'depends_on_package', 'disk', 'dnsserver', 'dnsupdate', 'domainoverrides', 'dyndns',
40
		'earlyshellcmd', 'element', 'encryption-algorithm-option',
41
		'field', 'fieldname',
42
		'gateway_item', 'gateway_group', 'gif', 'gre', 'group',
43
		'hash-algorithm-option', 'hosts', 'ifgroupentry', 'igmpentry', 'interface_array', 'item', 'key',
44
		'lagg', 'lbaction', 'lbpool', 'l7rules', 'lbprotocol',
45
		'member', 'menu', 'tab', 'mobilekey', 'monitor_type', 'mount',
46
		'npt', 'ntpserver',
47
		'onetoone', 'openvpn-server', 'openvpn-client', 'openvpn-csc', 'option',
48
		'package', 'passthrumac', 'phase1', 'phase2', 'ppp', 'pppoe', 'priv', 'proxyarpnet', 'pool',
49
		'qinqentry', 'queue',
50
		'pages', 'pipe', 'radnsserver', 'roll', 'route', 'row', 'rrddatafile', 'rule',
51
		'schedule', 'service', 'servernat', 'servers', 'sshkeyfile',
52
		'serversdisabled', 'shellcmd', 'staticmap', 'subqueue', 'switch', 'swport',
53
		'timerange', 'tunnel', 'user', 'vip', 'virtual_server', 'vlan', 'vlangroup', 'voucherdbfile',
54
		'vxlan', 'wgpeer', 'winsserver', 'wolentry', 'widget', 'xmldatafile'
55
	);
56
	return array_flip($ret);
57
}
58

    
59
/* Package XML tags that should be treated as a list not as a traditional array */
60
function listtags_pkg() {
61
	$ret = array('build_port_path', 'depends_on_package', 'onetoone', 'queue', 'rule', 'servernat', 'alias', 'additional_files_needed', 'tab', 'template', 'menu', 'rowhelperfield', 'service', 'step', 'package', 'columnitem', 'option', 'item', 'field', 'package', 'file');
62

    
63
	return array_flip($ret);
64
}
65

    
66
function startElement($parser, $name, $attrs) {
67
	global $parsedcfg, $depth, $curpath, $havedata, $listtags;
68

    
69
	array_push($curpath, strtolower($name));
70

    
71
	$ptr = &$parsedcfg;
72
	foreach ($curpath as $path) {
73
		$ptr = &$ptr[$path];
74
	}
75

    
76
	/* is it an element that belongs to a list? */
77
	if (isset($listtags[strtolower($name)])) {
78

    
79
		/* is there an array already? */
80
		if (!is_array($ptr)) {
81
			/* make an array */
82
			$ptr = array();
83
		}
84

    
85
		array_push($curpath, count($ptr));
86

    
87
	} else if (isset($ptr)) {
88
		/* multiple entries not allowed for this element, bail out */
89
		throw new Exception(
90
		    sprintf(gettext('XML error: %1$s at line %2$d cannot occur more than once') . "\n",
91
		    $name,
92
		    xml_get_current_line_number($parser)));
93
	}
94

    
95
	$depth++;
96
	$havedata = $depth;
97
}
98

    
99
function endElement($parser, $name) {
100
	global $depth, $curpath, $parsedcfg, $havedata, $listtags;
101

    
102
	if ($havedata == $depth) {
103
		$ptr = &$parsedcfg;
104
		foreach ($curpath as $path) {
105
			$ptr = &$ptr[$path];
106
		}
107
		$ptr = "";
108
	}
109

    
110
	array_pop($curpath);
111

    
112
	/* Special case handling for erroneous empty $listtag elements. Pop the most
113
	 * recent $listtag element off if it is a string AND is zero length. */
114
	if (isset($listtags[strtolower($name)])) {
115
		$ptr = &$parsedcfg;
116
		foreach ($curpath as $path) {
117
			$ptr = &$ptr[$path];
118
		}
119

    
120
		if (!(is_array(end($ptr)) || strlen(end($ptr)))) {
121
			array_pop($ptr);
122
		}
123
	}
124

    
125
	if (isset($listtags[strtolower($name)])) {
126
		array_pop($curpath);
127
	}
128
	
129
	$depth--;
130
}
131

    
132
function cData($parser, $data) {
133
	global $depth, $curpath, $parsedcfg, $havedata;
134

    
135
	$data = trim($data, "\t\n\r");
136

    
137
	if ($data != "") {
138
		$ptr = &$parsedcfg;
139
		foreach ($curpath as $path) {
140
			$ptr = &$ptr[$path];
141
		}
142

    
143
		if (is_string($ptr)) {
144
			$ptr .= html_entity_decode($data);
145
		} else {
146
			if (trim($data, " ") != "") {
147
				$ptr = html_entity_decode($data);
148
				$havedata++;
149
			}
150
		}
151
	}
152
}
153

    
154
function parse_xml_config($cffile, $rootobj, $isstring = "false") {
155
	global $listtags;
156
	$listtags = listtags();
157
	if (isset($GLOBALS['custom_listtags'])) {
158
		foreach ($GLOBALS['custom_listtags'] as $tag) {
159
			$listtags[$tag] = $tag;
160
		}
161
	}
162
	return parse_xml_config_raw($cffile, $rootobj, $isstring);
163
}
164

    
165
function parse_xml_config_pkg($cffile, $rootobj, $isstring = "false") {
166
	global $listtags;
167
	$listtags = listtags_pkg();
168
	if (isset($GLOBALS['custom_listtags_pkg'])) {
169
		foreach ($GLOBALS['custom_listtags_pkg'] as $tag) {
170
			$listtags[$tag] = $tag;
171
		}
172
	}
173
	$cfg =parse_xml_config_raw($cffile, $rootobj, $isstring);
174
	if ($cfg == -1) {
175
		return array();
176
	}
177

    
178
	return $cfg;
179
}
180

    
181
function parse_xml_config_raw($cffile, $rootobj, $isstring = "false") {
182

    
183
	global $depth, $curpath, $parsedcfg, $havedata, $listtags;
184
	$parsedcfg = array();
185
	$curpath = array();
186
	$depth = 0;
187
	$havedata = 0;
188

    
189
	$xml_parser = xml_parser_create();
190

    
191
	xml_set_element_handler($xml_parser, "startElement", "endElement");
192
	xml_set_character_data_handler($xml_parser, "cdata");
193
	xml_parser_set_option($xml_parser, XML_OPTION_SKIP_WHITE, 1);
194

    
195
	if (!($fp = fopen($cffile, "r"))) {
196
		log_error(gettext("Error: could not open XML input") . "\n");
197
		return -1;
198
	}
199

    
200
	while ($data = fread($fp, 4096)) {
201
		if (!xml_parse($xml_parser, $data, feof($fp))) {
202
			log_error(sprintf(gettext('XML error: %1$s at line %2$d in %3$s') . "\n",
203
				xml_error_string(xml_get_error_code($xml_parser)),
204
				xml_get_current_line_number($xml_parser),
205
				$cffile));
206
			return -1;
207
		}
208
	}
209
	xml_parser_free($xml_parser);
210

    
211
	if ($rootobj) {
212
		if (!is_array($rootobj)) {
213
			$rootobj = array($rootobj);
214
		}
215
		foreach ($rootobj as $rootobj_name) {
216
			if ($parsedcfg[$rootobj_name]) {
217
				break;
218
			}
219
		}
220

    
221
		if (!$parsedcfg[$rootobj_name]) {
222
			log_error(sprintf(gettext("XML error: no %s object found!") . "\n", implode(" or ", $rootobj)));
223
			return -1;
224
		}
225
		return $parsedcfg[$rootobj_name];
226
	} else {
227
		return $parsedcfg;
228
	}
229
}
230

    
231
/* Return true if a field should be cdata encoded */
232
function is_cdata_entity($ent) {
233
	$cdata_fields = array(
234
		'aclname', 'auth_pass', 'auth_prompt', 'auth_user', 'certca', 'certname', 'city', 'common_name',
235
		'descr', 'detail', 'email', 'encryption_password', 'hint', 'ldap_attr',
236
		'ldap_authcn', 'ldap_basedn', 'ldap_basedomain', 'ldap_bind', 'ldapbinddn',
237
		'ldapbindpass', 'ldap_extended_query', 'ldap_filter', 'ldap_pam_groupdn', 'ldap_pass', 'ldap_user',
238
		'login_banner', 'organization', 'password', 'rangedescr', 'state', 'text',
239
		'username', 'varusersusername', 'varuserspassword'
240
	);
241

    
242
	/* Check if the entity name starts with any of the strings above */
243
	return preg_match('/(^' . implode('|^', $cdata_fields) . ')/', $ent) === 1;
244
}
245

    
246
function dump_xml_config_sub($arr, $indent) {
247

    
248
	global $listtags;
249

    
250
	if (!is_array($arr)) {
251
		return null;
252
	}
253

    
254
	$xmlconfig = "";
255

    
256
	foreach ($arr as $ent => $val) {
257
		if (is_array($val)) {
258
			/* is it just a list of multiple values? */
259
			if (isset($listtags[strtolower($ent)])) {
260
				foreach ($val as $cval) {
261
					if (is_array($cval)) {
262
						if (empty($cval)) {
263
							$xmlconfig .= str_repeat("\t", $indent);
264
							$xmlconfig .= "<$ent></$ent>\n";
265
						} else {
266
							$xmlconfig .= str_repeat("\t", $indent);
267
							$xmlconfig .= "<$ent>\n";
268
							$xmlconfig .= dump_xml_config_sub($cval, $indent + 1);
269
							$xmlconfig .= str_repeat("\t", $indent);
270
							$xmlconfig .= "</$ent>\n";
271
						}
272
					} else {
273
						if ($cval === false) {
274
							continue;
275
						}
276
						$xmlconfig .= str_repeat("\t", $indent);
277
						if ((is_bool($cval) && $cval == true) || ($cval === "")) {
278
							$xmlconfig .= "<$ent></$ent>\n";
279
						} else if (is_cdata_entity($ent)) {
280
							$xmlconfig .= "<$ent><![CDATA[" . htmlentities($cval) . "]]></$ent>\n";
281
						} else {
282
							$xmlconfig .= "<$ent>" . htmlentities($cval) . "</$ent>\n";
283
						}
284
					}
285
				}
286
			} else if (empty($val)) {
287
				$xmlconfig .= str_repeat("\t", $indent);
288
				$xmlconfig .= "<$ent></$ent>\n";
289
			} else {
290
				/* it's an array */
291
				$xmlconfig .= str_repeat("\t", $indent);
292
				$xmlconfig .= "<$ent>\n";
293
				$xmlconfig .= dump_xml_config_sub($val, $indent + 1);
294
				$xmlconfig .= str_repeat("\t", $indent);
295
				$xmlconfig .= "</$ent>\n";
296
			}
297
		} else {
298
			if ((is_bool($val) && ($val == true)) || ($val === "")) {
299
				$xmlconfig .= str_repeat("\t", $indent);
300
				$xmlconfig .= "<$ent></$ent>\n";
301
			} else if (!is_bool($val)) {
302
				$xmlconfig .= str_repeat("\t", $indent);
303
				if (is_cdata_entity($ent)) {
304
					$xmlconfig .= "<$ent><![CDATA[" . htmlentities($val) . "]]></$ent>\n";
305
				} else {
306
					$xmlconfig .= "<$ent>" . htmlentities($val) . "</$ent>\n";
307
				}
308
			}
309
		}
310
	}
311

    
312
	return $xmlconfig;
313
}
314

    
315
function dump_xml_config($arr, $rootobj) {
316
	global $listtags;
317
	$listtags = listtags();
318
	if (isset($GLOBALS['custom_listtags'])) {
319
		foreach ($GLOBALS['custom_listtags'] as $tag) {
320
			$listtags[$tag] = $tag;
321
		}
322
	}
323
	return dump_xml_config_raw($arr, $rootobj);
324
}
325

    
326
function dump_xml_config_pkg($arr, $rootobj) {
327
	global $listtags;
328
	$listtags = listtags_pkg();
329
	if (isset($GLOBALS['custom_listtags_pkg'])) {
330
		foreach ($GLOBALS['custom_listtags_pkg'] as $tag) {
331
			$listtags[$tag] = $tag;
332
		}
333
	}
334
	return dump_xml_config_raw($arr, $rootobj);
335
}
336

    
337
function dump_xml_config_raw($arr, $rootobj) {
338

    
339
	$xmlconfig = "<?xml version=\"1.0\"?" . ">\n";
340
	$xmlconfig .= "<$rootobj>\n";
341

    
342
	$xmlconfig .= dump_xml_config_sub($arr, 1);
343

    
344
	$xmlconfig .= "</$rootobj>\n";
345

    
346
	return $xmlconfig;
347
}
(59-59/61)