?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
marge
[phpbb.git] / phpBB / includes / functions_jabber.php
blob3af7881043024bfd5c807df290d609cf1204623b
1 <?php
2 /**
3 *
4 * @package phpBB3
5 * @version $Id$
6 * @copyright (c) 2007 phpBB Group
7 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
8 *
9 */
10
11 /**
12 * @ignore
13 */
14 if (!defined('IN_PHPBB'))
15 {
16 exit;
17 }
18
19 /**
20 *
21 * Jabber class from Flyspray project
22 *
23 * @version class.jabber2.php 1488 2007-11-25
24 * @copyright 2006 Flyspray.org
25 * @author Florian Schmitz (floele)
26 *
27 * Only slightly modified by Acyd Burn
28 *
29 * @package phpBB3
30 */
31 class jabber
32 {
33 private $connection = null;
34 private $session = array();
35 private $timeout = 10;
36
37 private $server;
38 private $port;
39 private $username;
40 private $password;
41 private $use_ssl;
42 private $resource = 'functions_jabber.phpbb.php';
43
44 private $enable_logging;
45 private $log_array;
46
47 private $features = array();
48
49 /**
50 */
51 function __construct($server, $port, $username, $password, $use_ssl = false)
52 {
53 $this->server = ($server) ? $server : 'localhost';
54 $this->port = ($port) ? $port : 5222;
55 $this->username = $username;
56 $this->password = $password;
57 $this->use_ssl = ($use_ssl && self::can_use_ssl()) ? true : false;
58
59 // Change port if we use SSL
60 if ($this->port == 5222 && $this->use_ssl)
61 {
62 $this->port = 5223;
63 }
64
65 $this->enable_logging = true;
66 $this->log_array = array();
67 }
68
69 /**
70 * Able to use the SSL functionality?
71 */
72 public static function can_use_ssl()
73 {
74 // Will not work with PHP >= 5.2.1 or < 5.2.3RC2 until timeout problem with ssl hasn't been fixed (http://bugs.php.net/41236)
75 return ((version_compare(PHP_VERSION, '5.2.1', '<') || version_compare(PHP_VERSION, '5.2.3RC2', '>=')) && @extension_loaded('openssl')) ? true : false;
76 }
77
78 /**
79 * Able to use TLS?
80 */
81 public static function can_use_tls()
82 {
83 if (!@extension_loaded('openssl') || !function_exists('stream_socket_enable_crypto') || !function_exists('stream_get_meta_data') || !function_exists('socket_set_blocking') || !function_exists('stream_get_wrappers'))
84 {
85 return false;
86 }
87
88 /**
89 * Make sure the encryption stream is supported
90 * Also seem to work without the crypto stream if correctly compiled
91
92 $streams = stream_get_wrappers();
93
94 if (!in_array('streams.crypto', $streams))
95 {
96 return false;
97 }
98 */
99
100 return true;
101 }
102
103 /**
104 * Sets the resource which is used. No validation is done here, only escaping.
105 * @param string $name
106 * @access public
107 */
108 public function set_resource($name)
109 {
110 $this->resource = $name;
111 }
112
113 /**
114 * Connect
115 */
116 public function connect()
117 {
118 /* if (!$this->check_jid($this->username . '@' . $this->server))
119 {
120 $this->add_to_log('Error: Jabber ID is not valid: ' . $this->username . '@' . $this->server);
121 return false;
122 }*/
123
124 $this->session['ssl'] = $this->use_ssl;
125
126 if ($this->open_socket($this->server, $this->port, $this->use_ssl))
127 {
128 $this->send("<?xml version='1.0' encoding='UTF-8' ?" . ">\n");
129 $this->send("<stream:stream to='{$this->server}' xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0'>\n");
130 }
131 else
132 {
133 $this->add_to_log('Error: connect() #2');
134 return false;
135 }
136
137 // Now we listen what the server has to say...and give appropriate responses
138 $this->response($this->listen());
139 return true;
140 }
141
142 /**
143 * Disconnect
144 */
145 public function disconnect()
146 {
147 if ($this->connected())
148 {
149 // disconnect gracefully
150 if (isset($this->session['sent_presence']))
151 {
152 $this->send_presence('offline', '', true);
153 }
154
155 $this->send('</stream:stream>');
156 $this->session = array();
157 return fclose($this->connection);
158 }
159
160 return false;
161 }
162
163 /**
164 * Connected?
165 */
166 public function connected()
167 {
168 return (is_resource($this->connection) && !feof($this->connection)) ? true : false;
169 }
170
171
172 /**
173 * Initiates login (using data from contructor, after calling connect())
174 * @access public
175 * @return bool
176 */
177 public function login()
178 {
179 if (!sizeof($this->features))
180 {
181 $this->add_to_log('Error: No feature information from server available.');
182 return false;
183 }
184
185 return $this->response($this->features);
186 }
187
188 /**
189 * Send data to the Jabber server
190 * @param string $xml
191 * @access private
192 * @return bool
193 */
194 private function send($xml)
195 {
196 if ($this->connected())
197 {
198 $xml = trim($xml);
199 $this->add_to_log('SEND: '. $xml);
200 return fwrite($this->connection, $xml);
201 }
202 else
203 {
204 $this->add_to_log('Error: Could not send, connection lost (flood?).');
205 return false;
206 }
207 }
208
209 /**
210 * OpenSocket
211 * @param string $server host to connect to
212 * @param int $port port number
213 * @param bool $use_ssl use ssl or not
214 * @access private
215 * @return bool
216 */
217 private function open_socket($server, $port, $use_ssl = false)
218 {
219 if (@function_exists('dns_get_record'))
220 {
221 $record = @dns_get_record("_xmpp-client._tcp.$server", DNS_SRV);
222 if (!empty($record) && !empty($record[0]['target']))
223 {
224 $server = $record[0]['target'];
225 }
226 }
227
228 $server = $use_ssl ? 'ssl://' . $server : $server;
229
230 if ($this->connection = @fsockopen($server, $port, $errorno, $errorstr, $this->timeout))
231 {
232 socket_set_blocking($this->connection, 0);
233 socket_set_timeout($this->connection, 60);
234
235 return true;
236 }
237
238 // Apparently an error occured...
239 $this->add_to_log('Error: open_socket() - ' . $errorstr);
240 return false;
241 }
242
243 /**
244 * Return log
245 */
246 public function get_log()
247 {
248 if ($this->enable_logging && sizeof($this->log_array))
249 {
250 return implode("<br /><br />", $this->log_array);
251 }
252
253 return '';
254 }
255
256 /**
257 * Add information to log
258 */
259 private function add_to_log($string)
260 {
261 if ($this->enable_logging)
262 {
263 $this->log_array[] = utf8_htmlspecialchars($string);
264 }
265 }
266
267 /**
268 * Listens to the connection until it gets data or the timeout is reached.
269 * Thus, it should only be called if data is expected to be received.
270 * @access private
271 * @return mixed either false for timeout or an array with the received data
272 */
273 private function listen($timeout = 10, $wait = false)
274 {
275 if (!$this->connected())
276 {
277 return false;
278 }
279
280 // Wait for a response until timeout is reached
281 $start = time();
282 $data = '';
283
284 do
285 {
286 $read = trim(fread($this->connection, 4096));
287 $data .= $read;
288 }
289 while (time() <= $start + $timeout && !feof($this->connection) && ($wait || $data == '' || $read != '' || (substr(rtrim($data), -1) != '>')));
290
291 if ($data != '')
292 {
293 $this->add_to_log('RECV: '. $data);
294 return self::xmlize($data);
295 }
296 else
297 {
298 $this->add_to_log('Timeout, no response from server.');
299 return false;
300 }
301 }
302
303 /**
304 * Initiates account registration (based on data used for contructor)
305 * @access private
306 * @return bool
307 */
308 private function register()
309 {
310 if (!isset($this->session['id']) || isset($this->session['jid']))
311 {
312 $this->add_to_log('Error: Cannot initiate registration.');
313 return false;
314 }
315
316 $this->send("<iq type='get' id='reg_1'><query xmlns='jabber:iq:register'/></iq>");
317 return $this->response($this->listen());
318 }
319
320 /**
321 * Sets account presence. No additional info required (default is "online" status)
322 * @param $message online, offline...
323 * @param $type dnd, away, chat, xa or nothing
324 * @param $unavailable set this to true if you want to become unavailable
325 * @access private
326 * @return bool
327 */
328 private function send_presence($message = '', $type = '', $unavailable = false)
329 {
330 if (!isset($this->session['jid']))
331 {
332 $this->add_to_log('ERROR: send_presence() - Cannot set presence at this point, no jid given.');
333 return false;
334 }
335
336 $type = strtolower($type);
337 $type = (in_array($type, array('dnd', 'away', 'chat', 'xa'))) ? '<show>'. $type .'</show>' : '';
338
339 $unavailable = ($unavailable) ? " type='unavailable'" : '';
340 $message = ($message) ? '<status>' . utf8_htmlspecialchars($message) .'</status>' : '';
341
342 $this->session['sent_presence'] = !$unavailable;
343
344 return $this->send("<presence$unavailable>" . $type . $message . '</presence>');
345 }
346
347 /**
348 * This handles all the different XML elements
349 * @param array $xml
350 * @access private
351 * @return bool
352 */
353 private function response($xml)
354 {
355 if (!is_array($xml) || !sizeof($xml))
356 {
357 return false;
358 }
359
360 // did we get multiple elements? do one after another
361 // array('message' => ..., 'presence' => ...)
362 if (sizeof($xml) > 1)
363 {
364 foreach ($xml as $key => $value)
365 {
366 $this->response(array($key => $value));
367 }
368 return;
369 }
370 else
371 {
372 // or even multiple elements of the same type?
373 // array('message' => array(0 => ..., 1 => ...))
374 if (sizeof(reset($xml)) > 1)
375 {
376 foreach (reset($xml) as $value)
377 {
378 $this->response(array(key($xml) => array(0 => $value)));
379 }
380 return;
381 }
382 }
383
384 switch (key($xml))
385 {
386 case 'stream:stream':
387 // Connection initialised (or after authentication). Not much to do here...
388
389 if (isset($xml['stream:stream'][0]['#']['stream:features']))
390 {
391 // we already got all info we need
392 $this->features = $xml['stream:stream'][0]['#'];
393 }
394 else
395 {
396 $this->features = $this->listen();
397 }
398
399 $second_time = isset($this->session['id']);
400 $this->session['id'] = $xml['stream:stream'][0]['@']['id'];
401
402 if ($second_time)
403 {
404 // If we are here for the second time after TLS, we need to continue logging in
405 return $this->login();
406 }
407
408 // go on with authentication?
409 if (isset($this->features['stream:features'][0]['#']['bind']) || !empty($this->session['tls']))
410 {
411 return $this->response($this->features);
412 }
413 break;
414
415 case 'stream:features':
416 // Resource binding after successful authentication
417 if (isset($this->session['authenticated']))
418 {
419 // session required?
420 $this->session['sess_required'] = isset($xml['stream:features'][0]['#']['session']);
421
422 $this->send("<iq type='set' id='bind_1'>
423 <bind xmlns='urn:ietf:params:xml:ns:xmpp-bind'>
424 <resource>" . utf8_htmlspecialchars($this->resource) . '</resource>
425 </bind>
426 </iq>');
427 return $this->response($this->listen());
428 }
429
430 // Let's use TLS if SSL is not enabled and we can actually use it
431 if (!$this->session['ssl'] && self::can_use_tls() && self::can_use_ssl() && isset($xml['stream:features'][0]['#']['starttls']))
432 {
433 $this->add_to_log('Switching to TLS.');
434 $this->send("<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>\n");
435 return $this->response($this->listen());
436 }
437
438 // Does the server support SASL authentication?
439
440 // I hope so, because we do (and no other method).
441 if (isset($xml['stream:features'][0]['#']['mechanisms'][0]['@']['xmlns']) && $xml['stream:features'][0]['#']['mechanisms'][0]['@']['xmlns'] == 'urn:ietf:params:xml:ns:xmpp-sasl')
442 {
443 // Now decide on method
444 $methods = array();
445
446 foreach ($xml['stream:features'][0]['#']['mechanisms'][0]['#']['mechanism'] as $value)
447 {
448 $methods[] = $value['#'];
449 }
450
451 // we prefer DIGEST-MD5
452 // we don't want to use plain authentication (neither does the server usually) if no encryption is in place
453
454 // http://www.xmpp.org/extensions/attic/jep-0078-1.7.html
455 // The plaintext mechanism SHOULD NOT be used unless the underlying stream is encrypted (using SSL or TLS)
456 // and the client has verified that the server certificate is signed by a trusted certificate authority.
457
458 if (in_array('DIGEST-MD5', $methods))
459 {
460 $this->send("<auth xmlns='urn:ietf:params:xml:ns:xmpp-sasl' mechanism='DIGEST-MD5'/>");
461 }
462 else if (in_array('PLAIN', $methods) && ($this->session['ssl'] || !empty($this->session['tls'])))
463 {
464 $this->send("<auth xmlns='urn:ietf:params:xml:ns:xmpp-sasl' mechanism='PLAIN'>"
465 . base64_encode(chr(0) . $this->username . '@' . $this->server . chr(0) . $this->password) .
466 '</auth>');
467 }
468 else if (in_array('ANONYMOUS', $methods))
469 {
470 $this->send("<auth xmlns='urn:ietf:params:xml:ns:xmpp-sasl' mechanism='ANONYMOUS'/>");
471 }
472 else
473 {
474 // not good...
475 $this->add_to_log('Error: No authentication method supported.');
476 $this->disconnect();
477 return false;
478 }
479
480 return $this->response($this->listen());
481 }
482 else
483 {
484 // ok, this is it. bye.
485 $this->add_to_log('Error: Server does not offer SASL authentication.');
486 $this->disconnect();
487 return false;
488 }
489 break;
490
491 case 'challenge':
492 // continue with authentication...a challenge literally -_-
493 $decoded = base64_decode($xml['challenge'][0]['#']);
494 $decoded = self::parse_data($decoded);
495
496 if (!isset($decoded['digest-uri']))
497 {
498 $decoded['digest-uri'] = 'xmpp/'. $this->server;
499 }
500
501 // better generate a cnonce, maybe it's needed
502 $str = '';
503 mt_srand((double)microtime()*10000000);
504
505 for ($i = 0; $i < 32; $i++)
506 {
507 $str .= chr(mt_rand(0, 255));
508 }
509 $decoded['cnonce'] = base64_encode($str);
510
511 // second challenge?
512 if (isset($decoded['rspauth']))
513 {
514 $this->send("<response xmlns='urn:ietf:params:xml:ns:xmpp-sasl'/>");
515 }
516 else
517 {
518 // Make sure we only use 'auth' for qop (relevant for $this->encrypt_password())
519 // If the <response> is choking up on the changed parameter we may need to adjust encrypt_password() directly
520 if (isset($decoded['qop']) && $decoded['qop'] != 'auth' && strpos($decoded['qop'], 'auth') !== false)
521 {
522 $decoded['qop'] = 'auth';
523 }
524
525 $response = array(
526 'username' => $this->username,
527 'response' => $this->encrypt_password(array_merge($decoded, array('nc' => '00000001'))),
528 'charset' => 'utf-8',
529 'nc' => '00000001',
530 'qop' => 'auth', // only auth being supported
531 );
532
533 foreach (array('nonce', 'digest-uri', 'realm', 'cnonce') as $key)
534 {
535 if (isset($decoded[$key]))
536 {
537 $response[$key] = $decoded[$key];
538 }
539 }
540
541 $this->send("<response xmlns='urn:ietf:params:xml:ns:xmpp-sasl'>" . base64_encode($this->implode_data($response)) . '</response>');
542 }
543
544 return $this->response($this->listen());
545 break;
546
547 case 'failure':
548 $this->add_to_log('Error: Server sent "failure".');
549 $this->disconnect();
550 return false;
551 break;
552
553 case 'proceed':
554 // continue switching to TLS
555 $meta = stream_get_meta_data($this->connection);
556 socket_set_blocking($this->connection, 1);
557
558 if (!stream_socket_enable_crypto($this->connection, true, STREAM_CRYPTO_METHOD_TLS_CLIENT))
559 {
560 $this->add_to_log('Error: TLS mode change failed.');
561 return false;
562 }
563
564 socket_set_blocking($this->connection, $meta['blocked']);
565 $this->session['tls'] = true;
566
567 // new stream
568 $this->send("<?xml version='1.0' encoding='UTF-8' ?" . ">\n");
569 $this->send("<stream:stream to='{$this->server}' xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0'>\n");
570
571 return $this->response($this->listen());
572 break;
573
574 case 'success':
575 // Yay, authentication successful.
576 $this->send("<stream:stream to='{$this->server}' xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0'>\n");
577 $this->session['authenticated'] = true;
578
579 // we have to wait for another response
580 return $this->response($this->listen());
581 break;
582
583 case 'iq':
584 // we are not interested in IQs we did not expect
585 if (!isset($xml['iq'][0]['@']['id']))
586 {
587 return false;
588 }
589
590 // multiple possibilities here
591 switch ($xml['iq'][0]['@']['id'])
592 {
593 case 'bind_1':
594 $this->session['jid'] = $xml['iq'][0]['#']['bind'][0]['#']['jid'][0]['#'];
595
596 // and (maybe) yet another request to be able to send messages *finally*
597 if ($this->session['sess_required'])
598 {
599 $this->send("<iq to='{$this->server}' type='set' id='sess_1'>
600 <session xmlns='urn:ietf:params:xml:ns:xmpp-session'/>
601 </iq>");
602 return $this->response($this->listen());
603 }
604
605 return true;
606 break;
607
608 case 'sess_1':
609 return true;
610 break;
611
612 case 'reg_1':
613 $this->send("<iq type='set' id='reg_2'>
614 <query xmlns='jabber:iq:register'>
615 <username>" . utf8_htmlspecialchars($this->username) . "</username>
616 <password>" . utf8_htmlspecialchars($this->password) . "</password>
617 </query>
618 </iq>");
619 return $this->response($this->listen());
620 break;
621
622 case 'reg_2':
623 // registration end
624 if (isset($xml['iq'][0]['#']['error']))
625 {
626 $this->add_to_log('Warning: Registration failed.');
627 return false;
628 }
629 return true;
630 break;
631
632 case 'unreg_1':
633 return true;
634 break;
635
636 default:
637 $this->add_to_log('Notice: Received unexpected IQ.');
638 return false;
639 break;
640 }
641 break;
642
643 case 'message':
644 // we are only interested in content...
645 if (!isset($xml['message'][0]['#']['body']))
646 {
647 return false;
648 }
649
650 $message['body'] = $xml['message'][0]['#']['body'][0]['#'];
651 $message['from'] = $xml['message'][0]['@']['from'];
652
653 if (isset($xml['message'][0]['#']['subject']))
654 {
655 $message['subject'] = $xml['message'][0]['#']['subject'][0]['#'];
656 }
657 $this->session['messages'][] = $message;
658 break;
659
660 default:
661 // hm...don't know this response
662 $this->add_to_log('Notice: Unknown server response (' . key($xml) . ')');
663 return false;
664 break;
665 }
666 }
667
668 public function send_message($to, $text, $subject = '', $type = 'normal')
669 {
670 if (!isset($this->session['jid']))
671 {
672 return false;
673 }
674
675 if (!in_array($type, array('chat', 'normal', 'error', 'groupchat', 'headline')))
676 {
677 $type = 'normal';
678 }
679
680 return $this->send("<message from='" . utf8_htmlspecialchars($this->session['jid']) . "' to='" . utf8_htmlspecialchars($to) . "' type='$type' id='" . uniqid('msg') . "'>
681 <subject>" . utf8_htmlspecialchars($subject) . "</subject>
682 <body>" . utf8_htmlspecialchars($text) . "</body>
683 </message>"
684 );
685 }
686
687 /**
688 * Encrypts a password as in RFC 2831
689 * @param array $data Needs data from the client-server connection
690 * @access public
691 * @return string
692 */
693 public function encrypt_password($data)
694 {
695 // let's me think about <challenge> again...
696 foreach (array('realm', 'cnonce', 'digest-uri') as $key)
697 {
698 if (!isset($data[$key]))
699 {
700 $data[$key] = '';
701 }
702 }
703
704 $pack = md5($this->username . ':' . $data['realm'] . ':' . $this->password);
705
706 if (isset($data['authzid']))
707 {
708 $a1 = pack('H32', $pack) . sprintf(':%s:%s:%s', $data['nonce'], $data['cnonce'], $data['authzid']);
709 }
710 else
711 {
712 $a1 = pack('H32', $pack) . sprintf(':%s:%s', $data['nonce'], $data['cnonce']);
713 }
714
715 // should be: qop = auth
716 $a2 = 'AUTHENTICATE:'. $data['digest-uri'];
717
718 return md5(sprintf('%s:%s:%s:%s:%s:%s', md5($a1), $data['nonce'], $data['nc'], $data['cnonce'], $data['qop'], md5($a2)));
719 }
720
721 /**
722 * parse_data like a="b",c="d",... or like a="a, b", c, d="e", f=g,...
723 * @param string $data
724 * @access private
725 * @return array a => b ...
726 */
727 private static function parse_data($data)
728 {
729 $data = explode(',', $data);
730 $pairs = array();
731 $key = false;
732
733 foreach ($data as $pair)
734 {
735 $dd = strpos($pair, '=');
736
737 if ($dd)
738 {
739 $key = trim(substr($pair, 0, $dd));
740 $pairs[$key] = trim(trim(substr($pair, $dd + 1)), '"');
741 }
742 else if (strpos(strrev(trim($pair)), '"') === 0 && $key)
743 {
744 // We are actually having something left from "a, b" values, add it to the last one we handled.
745 $pairs[$key] .= ',' . trim(trim($pair), '"');
746 continue;
747 }
748 }
749
750 return $pairs;
751 }
752
753 /**
754 * opposite of jabber::parse_data()
755 * @param array $data
756 * @access private
757 * @return string
758 */
759 private function implode_data($data)
760 {
761 $return = array();
762 foreach ($data as $key => $value)
763 {
764 $return[] = $key . '="' . $value . '"';
765 }
766 return implode(',', $return);
767 }
768
769 /**
770 * xmlize()
771 * @author Hans Anderson
772 * @copyright Hans Anderson / http://www.hansanderson.com/php/xml/
773 */
774 private static function xmlize($data, $skip_white = 1, $encoding = 'UTF-8')
775 {
776 $data = trim($data);
777
778 if (substr($data, 0, 5) != '<?xml')
779 {
780 // mod
781 $data = '<root>'. $data . '</root>';
782 }
783
784 $vals = $index = $array = array();
785 $parser = xml_parser_create($encoding);
786 xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
787 xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, $skip_white);
788 xml_parse_into_struct($parser, $data, $vals, $index);
789 xml_parser_free($parser);
790
791 $i = 0;
792 $tagname = $vals[$i]['tag'];
793
794 $array[$tagname][0]['@'] = (isset($vals[$i]['attributes'])) ? $vals[$i]['attributes'] : array();
795 $array[$tagname][0]['#'] = self::_xml_depth($vals, $i);
796
797 if (substr($data, 0, 5) != '<?xml')
798 {
799 $array = $array['root'][0]['#'];
800 }
801
802 return $array;
803 }
804
805 /**
806 * _xml_depth()
807 * @author Hans Anderson
808 * @copyright Hans Anderson / http://www.hansanderson.com/php/xml/
809 */
810 private static function _xml_depth($vals, &$i)
811 {
812 $children = array();
813
814 if (isset($vals[$i]['value']))
815 {
816 array_push($children, $vals[$i]['value']);
817 }
818
819 while (++$i < sizeof($vals))
820 {
821 switch ($vals[$i]['type'])
822 {
823 case 'open':
824
825 $tagname = (isset($vals[$i]['tag'])) ? $vals[$i]['tag'] : '';
826 $size = (isset($children[$tagname])) ? sizeof($children[$tagname]) : 0;
827
828 if (isset($vals[$i]['attributes']))
829 {
830 $children[$tagname][$size]['@'] = $vals[$i]['attributes'];
831 }
832
833 $children[$tagname][$size]['#'] = self::_xml_depth($vals, $i);
834
835 break;
836
837 case 'cdata':
838 array_push($children, $vals[$i]['value']);
839 break;
840
841 case 'complete':
842
843 $tagname = $vals[$i]['tag'];
844 $size = (isset($children[$tagname])) ? sizeof($children[$tagname]) : 0;
845 $children[$tagname][$size]['#'] = (isset($vals[$i]['value'])) ? $vals[$i]['value'] : array();
846
847 if (isset($vals[$i]['attributes']))
848 {
849 $children[$tagname][$size]['@'] = $vals[$i]['attributes'];
850 }
851
852 break;
853
854 case 'close':
855 return $children;
856 break;
857 }
858 }
859
860 return $children;
861 }
862 }
863
864 ?>
phpbb is a php-based BBS (buletin board system)