4 * @file include/network.php
7 require_once("include/xml.php");
8 require_once('include/Probe.php');
13 * If binary flag is true, return binary results.
14 * Set the cookiejar argument to a string (e.g. "/tmp/friendica-cookies.txt")
15 * to preserve cookies from one request to the next.
17 * @param string $url URL to fetch
18 * @param boolean $binary default false
19 * TRUE if asked to return binary results (file download)
20 * @param integer $redirects The recursion counter for internal use - default 0
21 * @param integer $timeout Timeout in seconds, default system config value or 60 seconds
22 * @param string $accept_content supply Accept: header with 'accept_content' as the value
23 * @param string $cookiejar Path to cookie jar file
25 * @return string The fetched content
27 function fetch_url($url,$binary = false, &$redirects = 0, $timeout = 0, $accept_content=Null, $cookiejar = 0) {
33 array('timeout'=>$timeout,
34 'accept_content'=>$accept_content,
35 'cookiejar'=>$cookiejar
42 * @brief fetches an URL.
44 * @param string $url URL to fetch
45 * @param boolean $binary default false
46 * TRUE if asked to return binary results (file download)
47 * @param int $redirects The recursion counter for internal use - default 0
48 * @param array $opts (optional parameters) assoziative array with:
49 * 'accept_content' => supply Accept: header with 'accept_content' as the value
50 * 'timeout' => int Timeout in seconds, default system config value or 60 seconds
51 * 'http_auth' => username:password
52 * 'novalidate' => do not validate SSL certs, default is to validate using our CA list
53 * 'nobody' => only return the header
54 * 'cookiejar' => path to cookie jar file
56 * @return array an assoziative array with:
57 * int 'return_code' => HTTP return code or 0 if timeout or failure
58 * boolean 'success' => boolean true (if HTTP 2xx result) or false
59 * string 'redirect_url' => in case of redirect, content was finally retrieved from this URL
60 * string 'header' => HTTP headers
61 * string 'body' => fetched content
63 function z_fetch_url($url,$binary = false, &$redirects = 0, $opts=array()) {
65 $ret = array('return_code' => 0, 'success' => false, 'header' => "", 'body' => "");
68 $stamp1 = microtime(true);
72 $ch = @curl_init($url);
73 if(($redirects > 8) || (! $ch))
76 @curl_setopt($ch, CURLOPT_HEADER, true);
78 if(x($opts,"cookiejar")) {
79 curl_setopt($ch, CURLOPT_COOKIEJAR, $opts["cookiejar"]);
80 curl_setopt($ch, CURLOPT_COOKIEFILE, $opts["cookiejar"]);
83 // These settings aren't needed. We're following the location already.
84 // @curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
85 // @curl_setopt($ch, CURLOPT_MAXREDIRS, 5);
87 if (x($opts,'accept_content')){
88 curl_setopt($ch,CURLOPT_HTTPHEADER, array (
89 "Accept: " . $opts['accept_content']
93 @curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
94 @curl_setopt($ch, CURLOPT_USERAGENT, $a->get_useragent());
98 if(x($opts,'headers')){
99 @curl_setopt($ch, CURLOPT_HTTPHEADER, $opts['headers']);
101 if(x($opts,'nobody')){
102 @curl_setopt($ch, CURLOPT_NOBODY, $opts['nobody']);
104 if(x($opts,'timeout')){
105 @curl_setopt($ch, CURLOPT_TIMEOUT, $opts['timeout']);
107 $curl_time = intval(get_config('system','curl_timeout'));
108 @curl_setopt($ch, CURLOPT_TIMEOUT, (($curl_time !== false) ? $curl_time : 60));
111 // by default we will allow self-signed certs
112 // but you can override this
114 $check_cert = get_config('system','verifyssl');
115 @curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, (($check_cert) ? true : false));
116 @curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, (($check_cert) ? 2 : false));
118 $prx = get_config('system','proxy');
120 @curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);
121 @curl_setopt($ch, CURLOPT_PROXY, $prx);
122 $prxusr = @get_config('system','proxyuser');
124 @curl_setopt($ch, CURLOPT_PROXYUSERPWD, $prxusr);
127 @curl_setopt($ch, CURLOPT_BINARYTRANSFER,1);
129 $a->set_curl_code(0);
131 // don't let curl abort the entire application
132 // if it throws any errors.
134 $s = @curl_exec($ch);
135 if (curl_errno($ch) !== CURLE_OK) {
136 logger('fetch_url error fetching '.$url.': '.curl_error($ch), LOGGER_NORMAL);
140 $curl_info = @curl_getinfo($ch);
142 $http_code = $curl_info['http_code'];
143 logger('fetch_url '.$url.': '.$http_code." ".$s, LOGGER_DATA);
146 // Pull out multiple headers, e.g. proxy and continuation headers
147 // allow for HTTP/2.x without fixing code
149 while(preg_match('/^HTTP\/[1-2].+? [1-5][0-9][0-9]/',$base)) {
150 $chunk = substr($base,0,strpos($base,"\r\n\r\n")+4);
152 $base = substr($base,strlen($chunk));
155 $a->set_curl_code($http_code);
156 $a->set_curl_content_type($curl_info['content_type']);
157 $a->set_curl_headers($header);
159 if($http_code == 301 || $http_code == 302 || $http_code == 303 || $http_code == 307) {
160 $new_location_info = @parse_url($curl_info["redirect_url"]);
161 $old_location_info = @parse_url($curl_info["url"]);
163 $newurl = $curl_info["redirect_url"];
165 if (($new_location_info["path"] == "") AND ($new_location_info["host"] != ""))
166 $newurl = $new_location_info["scheme"]."://".$new_location_info["host"].$old_location_info["path"];
169 if (preg_match('/(Location:|URI:)(.*?)\n/i', $header, $matches)) {
170 $newurl = trim(array_pop($matches));
172 if(strpos($newurl,'/') === 0)
173 $newurl = $old_location_info["scheme"]."://".$old_location_info["host"].$newurl;
174 if (filter_var($newurl, FILTER_VALIDATE_URL)) {
177 return z_fetch_url($newurl,$binary, $redirects, $opts);
182 $a->set_curl_code($http_code);
183 $a->set_curl_content_type($curl_info['content_type']);
185 $body = substr($s,strlen($header));
189 $rc = intval($http_code);
190 $ret['return_code'] = $rc;
191 $ret['success'] = (($rc >= 200 && $rc <= 299) ? true : false);
192 $ret['redirect_url'] = $url;
193 if(! $ret['success']) {
194 $ret['error'] = curl_error($ch);
195 $ret['debug'] = $curl_info;
196 logger('z_fetch_url: error: ' . $url . ': ' . $ret['error'], LOGGER_DEBUG);
197 logger('z_fetch_url: debug: ' . print_r($curl_info,true), LOGGER_DATA);
199 $ret['body'] = substr($s,strlen($header));
200 $ret['header'] = $header;
201 if(x($opts,'debug')) {
202 $ret['debug'] = $curl_info;
206 $a->save_timestamp($stamp1, "network");
212 // post request to $url. $params is an array of post variables.
215 * @brief Post request to $url
217 * @param string $url URL to post
218 * @param mixed $params
219 * @param string $headers HTTP headers
220 * @param integer $redirects Recursion counter for internal use - default = 0
221 * @param integer $timeout The timeout in seconds, default system config value or 60 seconds
223 * @return string The content
225 function post_url($url,$params, $headers = null, &$redirects = 0, $timeout = 0) {
226 $stamp1 = microtime(true);
229 $ch = curl_init($url);
230 if(($redirects > 8) || (! $ch))
233 logger("post_url: start ".$url, LOGGER_DATA);
235 curl_setopt($ch, CURLOPT_HEADER, true);
236 curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
237 curl_setopt($ch, CURLOPT_POST,1);
238 curl_setopt($ch, CURLOPT_POSTFIELDS,$params);
239 curl_setopt($ch, CURLOPT_USERAGENT, $a->get_useragent());
241 if(intval($timeout)) {
242 curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
245 $curl_time = intval(get_config('system','curl_timeout'));
246 curl_setopt($ch, CURLOPT_TIMEOUT, (($curl_time !== false) ? $curl_time : 60));
249 if(defined('LIGHTTPD')) {
250 if(!is_array($headers)) {
251 $headers = array('Expect:');
253 if(!in_array('Expect:', $headers)) {
254 array_push($headers, 'Expect:');
259 curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
261 $check_cert = get_config('system','verifyssl');
262 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, (($check_cert) ? true : false));
263 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, (($check_cert) ? 2 : false));
264 $prx = get_config('system','proxy');
266 curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);
267 curl_setopt($ch, CURLOPT_PROXY, $prx);
268 $prxusr = get_config('system','proxyuser');
270 curl_setopt($ch, CURLOPT_PROXYUSERPWD, $prxusr);
273 $a->set_curl_code(0);
275 // don't let curl abort the entire application
276 // if it throws any errors.
278 $s = @curl_exec($ch);
281 $curl_info = curl_getinfo($ch);
282 $http_code = $curl_info['http_code'];
284 logger("post_url: result ".$http_code." - ".$url, LOGGER_DATA);
288 // Pull out multiple headers, e.g. proxy and continuation headers
289 // allow for HTTP/2.x without fixing code
291 while(preg_match('/^HTTP\/[1-2].+? [1-5][0-9][0-9]/',$base)) {
292 $chunk = substr($base,0,strpos($base,"\r\n\r\n")+4);
294 $base = substr($base,strlen($chunk));
297 if($http_code == 301 || $http_code == 302 || $http_code == 303 || $http_code == 307) {
299 preg_match('/(Location:|URI:)(.*?)\n/', $header, $matches);
300 $newurl = trim(array_pop($matches));
301 if(strpos($newurl,'/') === 0)
302 $newurl = $old_location_info["scheme"] . "://" . $old_location_info["host"] . $newurl;
303 if (filter_var($newurl, FILTER_VALIDATE_URL)) {
305 logger("post_url: redirect ".$url." to ".$newurl);
306 return post_url($newurl,$params, $headers, $redirects, $timeout);
307 //return fetch_url($newurl,false,$redirects,$timeout);
310 $a->set_curl_code($http_code);
311 $body = substr($s,strlen($header));
313 $a->set_curl_headers($header);
317 $a->save_timestamp($stamp1, "network");
319 logger("post_url: end ".$url, LOGGER_DATA);
324 // Generic XML return
325 // Outputs a basic dfrn XML status structure to STDOUT, with a <status> variable
326 // of $st and an optional text <message> of $message and terminates the current process.
328 function xml_status($st, $message = '') {
330 $xml_message = ((strlen($message)) ? "\t<message>" . xmlify($message) . "</message>\r\n" : '');
333 logger('xml_status returning non_zero: ' . $st . " message=" . $message);
335 header( "Content-type: text/xml" );
336 echo '<?xml version="1.0" encoding="UTF-8"?>'."\r\n";
337 echo "<result>\r\n\t<status>$st</status>\r\n$xml_message</result>\r\n";
343 * @brief Send HTTP status header and exit.
345 * @param integer $val HTTP status result value
346 * @param array $description optional message
347 * 'title' => header title
348 * 'description' => optional message
351 function http_status_exit($val, $description = array()) {
355 if (!isset($description["title"]))
356 $description["title"] = $err." ".$val;
358 if($val >= 200 && $val < 300)
361 logger('http_status_exit ' . $val);
362 header($_SERVER["SERVER_PROTOCOL"] . ' ' . $val . ' ' . $err);
364 if (isset($description["title"])) {
365 $tpl = get_markup_template('http_status.tpl');
366 echo replace_macros($tpl, array('$title' => $description["title"],
367 '$description' => $description["description"]));
375 * @brief Check URL to se if ts's real
377 * Take a URL from the wild, prepend http:// if necessary
378 * and check DNS to see if it's real (or check if is a valid IP address)
380 * @param string $url The URL to be validated
381 * @return boolean True if it's a valid URL, fals if something wrong with it
383 function validate_url(&$url) {
385 if(get_config('system','disable_url_validation'))
387 // no naked subdomains (allow localhost for tests)
388 if(strpos($url,'.') === false && strpos($url,'/localhost/') === false)
390 if(substr($url,0,4) != 'http')
391 $url = 'http://' . $url;
392 $h = @parse_url($url);
394 if(($h) && (dns_get_record($h['host'], DNS_A + DNS_CNAME + DNS_PTR) || filter_var($h['host'], FILTER_VALIDATE_IP) )) {
401 * @brief Checks that email is an actual resolvable internet address
403 * @param string $addr The email address
404 * @return boolean True if it's a valid email address, false if it's not
406 function validate_email($addr) {
408 if(get_config('system','disable_email_validation'))
411 if(! strpos($addr,'@'))
413 $h = substr($addr,strpos($addr,'@') + 1);
415 if(($h) && (dns_get_record($h, DNS_A + DNS_CNAME + DNS_PTR + DNS_MX) || filter_var($h, FILTER_VALIDATE_IP) )) {
422 * @brief Check if URL is allowed
424 * Check $url against our list of allowed sites,
425 * wildcards allowed. If allowed_sites is unset return true;
427 * @param string $url URL which get tested
428 * @return boolean True if url is allowed otherwise return false
430 function allowed_url($url) {
432 $h = @parse_url($url);
438 $str_allowed = get_config('system','allowed_sites');
444 $host = strtolower($h['host']);
446 // always allow our own site
448 if($host == strtolower($_SERVER['SERVER_NAME']))
451 $fnmatch = function_exists('fnmatch');
452 $allowed = explode(',',$str_allowed);
454 if(count($allowed)) {
455 foreach($allowed as $a) {
456 $pat = strtolower(trim($a));
457 if(($fnmatch && fnmatch($pat,$host)) || ($pat == $host)) {
467 * @brief Check if email address is allowed to register here.
469 * Compare against our list (wildcards allowed).
472 * @return boolean False if not allowed, true if allowed
473 * or if allowed list is not configured
475 function allowed_email($email) {
478 $domain = strtolower(substr($email,strpos($email,'@') + 1));
482 $str_allowed = get_config('system','allowed_email');
488 $fnmatch = function_exists('fnmatch');
489 $allowed = explode(',',$str_allowed);
491 if(count($allowed)) {
492 foreach($allowed as $a) {
493 $pat = strtolower(trim($a));
494 if(($fnmatch && fnmatch($pat,$domain)) || ($pat == $domain)) {
503 function avatar_img($email) {
507 $avatar['size'] = 175;
508 $avatar['email'] = $email;
510 $avatar['success'] = false;
512 call_hooks('avatar_lookup', $avatar);
514 if(! $avatar['success'])
515 $avatar['url'] = $a->get_baseurl() . '/images/person-175.jpg';
517 logger('Avatar: ' . $avatar['email'] . ' ' . $avatar['url'], LOGGER_DEBUG);
518 return $avatar['url'];
522 function parse_xml_string($s,$strict = true) {
523 /// @todo Move this function to the xml class
525 if(! strstr($s,'<?xml'))
527 $s2 = substr($s,strpos($s,'<?xml'));
531 libxml_use_internal_errors(true);
533 $x = @simplexml_load_string($s2);
535 logger('libxml: parse: error: ' . $s2, LOGGER_DATA);
536 foreach(libxml_get_errors() as $err)
537 logger('libxml: parse: ' . $err->code." at ".$err->line.":".$err->column." : ".$err->message, LOGGER_DATA);
538 libxml_clear_errors();
543 function scale_external_images($srctext, $include_link = true, $scale_replace = false) {
545 // Suppress "view full size"
546 if (intval(get_config('system','no_view_full_size')))
547 $include_link = false;
551 // Picture addresses can contain special characters
552 $s = htmlspecialchars_decode($srctext);
555 $c = preg_match_all('/\[img.*?\](.*?)\[\/img\]/ism',$s,$matches,PREG_SET_ORDER);
557 require_once('include/Photo.php');
558 foreach($matches as $mtch) {
559 logger('scale_external_image: ' . $mtch[1]);
561 $hostname = str_replace('www.','',substr($a->get_baseurl(),strpos($a->get_baseurl(),'://')+3));
562 if(stristr($mtch[1],$hostname))
565 // $scale_replace, if passed, is an array of two elements. The
566 // first is the name of the full-size image. The second is the
567 // name of a remote, scaled-down version of the full size image.
568 // This allows Friendica to display the smaller remote image if
569 // one exists, while still linking to the full-size image
571 $scaled = str_replace($scale_replace[0], $scale_replace[1], $mtch[1]);
574 $i = @fetch_url($scaled);
578 // guess mimetype from headers or filename
579 $type = guess_image_type($mtch[1],true);
582 $ph = new Photo($i, $type);
583 if($ph->is_valid()) {
584 $orig_width = $ph->getWidth();
585 $orig_height = $ph->getHeight();
587 if($orig_width > 640 || $orig_height > 640) {
589 $ph->scaleImage(640);
590 $new_width = $ph->getWidth();
591 $new_height = $ph->getHeight();
592 logger('scale_external_images: ' . $orig_width . '->' . $new_width . 'w ' . $orig_height . '->' . $new_height . 'h' . ' match: ' . $mtch[0], LOGGER_DEBUG);
593 $s = str_replace($mtch[0],'[img=' . $new_width . 'x' . $new_height. ']' . $scaled . '[/img]'
594 . "\n" . (($include_link)
595 ? '[url=' . $mtch[1] . ']' . t('view full size') . '[/url]' . "\n"
597 logger('scale_external_images: new string: ' . $s, LOGGER_DEBUG);
604 // replace the special char encoding
605 $s = htmlspecialchars($s,ENT_NOQUOTES,'UTF-8');
610 function fix_contact_ssl_policy(&$contact,$new_policy) {
612 $ssl_changed = false;
613 if((intval($new_policy) == SSL_POLICY_SELFSIGN || $new_policy === 'self') && strstr($contact['url'],'https:')) {
615 $contact['url'] = str_replace('https:','http:',$contact['url']);
616 $contact['request'] = str_replace('https:','http:',$contact['request']);
617 $contact['notify'] = str_replace('https:','http:',$contact['notify']);
618 $contact['poll'] = str_replace('https:','http:',$contact['poll']);
619 $contact['confirm'] = str_replace('https:','http:',$contact['confirm']);
620 $contact['poco'] = str_replace('https:','http:',$contact['poco']);
623 if((intval($new_policy) == SSL_POLICY_FULL || $new_policy === 'full') && strstr($contact['url'],'http:')) {
625 $contact['url'] = str_replace('http:','https:',$contact['url']);
626 $contact['request'] = str_replace('http:','https:',$contact['request']);
627 $contact['notify'] = str_replace('http:','https:',$contact['notify']);
628 $contact['poll'] = str_replace('http:','https:',$contact['poll']);
629 $contact['confirm'] = str_replace('http:','https:',$contact['confirm']);
630 $contact['poco'] = str_replace('http:','https:',$contact['poco']);
634 q("update contact set
641 where id = %d limit 1",
642 dbesc($contact['url']),
643 dbesc($contact['request']),
644 dbesc($contact['notify']),
645 dbesc($contact['poll']),
646 dbesc($contact['confirm']),
647 dbesc($contact['poco']),
648 intval($contact['id'])
653 function original_url($url, $depth=1, $fetchbody = false) {
657 // Remove Analytics Data from Google and other tracking platforms
658 $urldata = parse_url($url);
659 if (is_string($urldata["query"])) {
660 $query = $urldata["query"];
661 parse_str($query, $querydata);
663 if (is_array($querydata))
664 foreach ($querydata AS $param=>$value)
665 if (in_array($param, array("utm_source", "utm_medium", "utm_term", "utm_content", "utm_campaign",
666 "wt_mc", "pk_campaign", "pk_kwd", "mc_cid", "mc_eid",
667 "fb_action_ids", "fb_action_types", "fb_ref",
669 "woo_campaign", "woo_source", "woo_medium", "woo_content", "woo_term"))) {
671 $pair = $param."=".urlencode($value);
672 $url = str_replace($pair, "", $url);
674 // Second try: if the url isn't encoded completely
675 $pair = $param."=".str_replace(" ", "+", $value);
676 $url = str_replace($pair, "", $url);
678 // Third try: Maybey the url isn't encoded at all
679 $pair = $param."=".$value;
680 $url = str_replace($pair, "", $url);
682 $url = str_replace(array("?&", "&&"), array("?", ""), $url);
685 if (substr($url, -1, 1) == "?")
686 $url = substr($url, 0, -1);
692 $url = trim($url, "'");
694 $stamp1 = microtime(true);
698 curl_setopt($ch, CURLOPT_URL, $url);
699 curl_setopt($ch, CURLOPT_HEADER, 1);
700 curl_setopt($ch, CURLOPT_NOBODY, 1);
701 curl_setopt($ch, CURLOPT_TIMEOUT, 10);
702 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
703 curl_setopt($ch, CURLOPT_USERAGENT, $a->get_useragent());
705 $header = curl_exec($ch);
706 $curl_info = @curl_getinfo($ch);
707 $http_code = $curl_info['http_code'];
710 $a->save_timestamp($stamp1, "network");
715 if ((($curl_info['http_code'] == "301") OR ($curl_info['http_code'] == "302"))
716 AND (($curl_info['redirect_url'] != "") OR ($curl_info['location'] != ""))) {
717 if ($curl_info['redirect_url'] != "")
718 return(original_url($curl_info['redirect_url'], ++$depth, $fetchbody));
720 return(original_url($curl_info['location'], ++$depth, $fetchbody));
723 // Check for redirects in the meta elements of the body if there are no redirects in the header.
725 return(original_url($url, ++$depth, true));
727 // if the file is too large then exit
728 if ($curl_info["download_content_length"] > 1000000)
731 // if it isn't a HTML file then exit
732 if (($curl_info["content_type"] != "") AND !strstr(strtolower($curl_info["content_type"]),"html"))
735 $stamp1 = microtime(true);
738 curl_setopt($ch, CURLOPT_URL, $url);
739 curl_setopt($ch, CURLOPT_HEADER, 0);
740 curl_setopt($ch, CURLOPT_NOBODY, 0);
741 curl_setopt($ch, CURLOPT_TIMEOUT, 10);
742 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
743 curl_setopt($ch, CURLOPT_USERAGENT, $a->get_useragent());
745 $body = curl_exec($ch);
748 $a->save_timestamp($stamp1, "network");
750 if (trim($body) == "")
753 // Check for redirect in meta elements
754 $doc = new DOMDocument();
755 @$doc->loadHTML($body);
757 $xpath = new DomXPath($doc);
759 $list = $xpath->query("//meta[@content]");
760 foreach ($list as $node) {
762 if ($node->attributes->length)
763 foreach ($node->attributes as $attribute)
764 $attr[$attribute->name] = $attribute->value;
766 if (@$attr["http-equiv"] == 'refresh') {
767 $path = $attr["content"];
768 $pathinfo = explode(";", $path);
770 foreach ($pathinfo AS $value)
771 if (substr(strtolower($value), 0, 4) == "url=")
772 return(original_url(substr($value, 4), ++$depth));
779 function short_link($url) {
780 require_once('library/slinky.php');
781 $slinky = new Slinky($url);
782 $yourls_url = get_config('yourls','url1');
784 $yourls_username = get_config('yourls','username1');
785 $yourls_password = get_config('yourls', 'password1');
786 $yourls_ssl = get_config('yourls', 'ssl1');
787 $yourls = new Slinky_YourLS();
788 $yourls->set('username', $yourls_username);
789 $yourls->set('password', $yourls_password);
790 $yourls->set('ssl', $yourls_ssl);
791 $yourls->set('yourls-url', $yourls_url);
792 $slinky->set_cascade( array($yourls, new Slinky_UR1ca(), new Slinky_Trim(), new Slinky_IsGd(), new Slinky_TinyURL()));
794 // setup a cascade of shortening services
795 // try to get a short link from these services
796 // in the order ur1.ca, trim, id.gd, tinyurl
797 $slinky->set_cascade(array(new Slinky_UR1ca(), new Slinky_Trim(), new Slinky_IsGd(), new Slinky_TinyURL()));
799 return $slinky->short();
803 * @brief Encodes content to json
805 * This function encodes an array to json format
806 * and adds an application/json HTTP header to the output.
807 * After finishing the process is getting killed.
809 * @param array $x The input content
811 function json_return_and_die($x) {
812 header("content-type: application/json");
813 echo json_encode($x);
818 * @brief Find the matching part between two url
820 * @param string $url1
821 * @param string $url2
822 * @return string The matching part
824 function matching_url($url1, $url2) {
826 if (($url1 == "") OR ($url2 == ""))
829 $url1 = normalise_link($url1);
830 $url2 = normalise_link($url2);
832 $parts1 = parse_url($url1);
833 $parts2 = parse_url($url2);
835 if (!isset($parts1["host"]) OR !isset($parts2["host"]))
838 if ($parts1["scheme"] != $parts2["scheme"])
841 if ($parts1["host"] != $parts2["host"])
844 if ($parts1["port"] != $parts2["port"])
847 $match = $parts1["scheme"]."://".$parts1["host"];
850 $match .= ":".$parts1["port"];
852 $pathparts1 = explode("/", $parts1["path"]);
853 $pathparts2 = explode("/", $parts2["path"]);
858 $path1 = $pathparts1[$i];
859 $path2 = $pathparts2[$i];
861 if ($path1 == $path2)
864 } while (($path1 == $path2) AND ($i++ <= count($pathparts1)));
868 return normalise_link($match);