]> git.mxchange.org Git - friendica.git/blobdiff - include/network.php
New dba functions
[friendica.git] / include / network.php
index 60b05bc77408ed5cd992a75e0c1558001b6596d1..4bf6868822b4549986f3bfbae630c3a9366c7f44 100644 (file)
@@ -4,18 +4,19 @@
  * @file include/network.php
  */
 
-use \Friendica\Core\Config;
+use Friendica\App;
+use Friendica\Core\Config;
+use Friendica\Network\Probe;
 
 require_once("include/xml.php");
-require_once('include/Probe.php');
 
 /**
  * @brief Curl wrapper
- * 
+ *
  * If binary flag is true, return binary results.
  * Set the cookiejar argument to a string (e.g. "/tmp/friendica-cookies.txt")
  * to preserve cookies from one request to the next.
- * 
+ *
  * @param string $url URL to fetch
  * @param boolean $binary default false
  *    TRUE if asked to return binary results (file download)
@@ -23,7 +24,7 @@ require_once('include/Probe.php');
  * @param integer $timeout Timeout in seconds, default system config value or 60 seconds
  * @param string $accept_content supply Accept: header with 'accept_content' as the value
  * @param string $cookiejar Path to cookie jar file
- * 
+ *
  * @return string The fetched content
  */
 function fetch_url($url,$binary = false, &$redirects = 0, $timeout = 0, $accept_content=Null, $cookiejar = 0) {
@@ -62,22 +63,27 @@ function fetch_url($url,$binary = false, &$redirects = 0, $timeout = 0, $accept_
  *    string 'header' => HTTP headers
  *    string 'body' => fetched content
  */
-function z_fetch_url($url,$binary = false, &$redirects = 0, $opts=array()) {
-
-       $ret = array('return_code' => 0, 'success' => false, 'header' => "", 'body' => "");
-
+function z_fetch_url($url, $binary = false, &$redirects = 0, $opts = array()) {
+       $ret = array('return_code' => 0, 'success' => false, 'header' => '', 'body' => '');
 
        $stamp1 = microtime(true);
 
        $a = get_app();
 
+       if (blocked_url($url)) {
+               logger('z_fetch_url: domain of ' . $url . ' is blocked', LOGGER_DATA);
+               return $ret;
+       }
+
        $ch = @curl_init($url);
-       if(($redirects > 8) || (! $ch))
-               return false;
+
+       if (($redirects > 8) || (!$ch)) {
+               return $ret;
+       }
 
        @curl_setopt($ch, CURLOPT_HEADER, true);
 
-       if(x($opts,"cookiejar")) {
+       if (x($opts, "cookiejar")) {
                curl_setopt($ch, CURLOPT_COOKIEJAR, $opts["cookiejar"]);
                curl_setopt($ch, CURLOPT_COOKIEFILE, $opts["cookiejar"]);
        }
@@ -86,50 +92,61 @@ function z_fetch_url($url,$binary = false, &$redirects = 0, $opts=array()) {
 //     @curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
 //     @curl_setopt($ch, CURLOPT_MAXREDIRS, 5);
 
-       if (x($opts,'accept_content')){
-               curl_setopt($ch,CURLOPT_HTTPHEADER, array (
-                       "Accept: " . $opts['accept_content']
+       if (x($opts, 'accept_content')) {
+               curl_setopt($ch, CURLOPT_HTTPHEADER, array(
+                       'Accept: ' . $opts['accept_content']
                ));
        }
 
-       @curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
+       @curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        @curl_setopt($ch, CURLOPT_USERAGENT, $a->get_useragent());
 
        $range = intval(Config::get('system', 'curl_range_bytes', 0));
+
        if ($range > 0) {
-               @curl_setopt($ch, CURLOPT_RANGE, '0-'.$range);
+               @curl_setopt($ch, CURLOPT_RANGE, '0-' . $range);
        }
 
-       if(x($opts,'headers')){
+       if (x($opts, 'headers')) {
                @curl_setopt($ch, CURLOPT_HTTPHEADER, $opts['headers']);
        }
-       if(x($opts,'nobody')){
+
+       if (x($opts, 'nobody')) {
                @curl_setopt($ch, CURLOPT_NOBODY, $opts['nobody']);
        }
-       if(x($opts,'timeout')){
+
+       if (x($opts, 'timeout')) {
                @curl_setopt($ch, CURLOPT_TIMEOUT, $opts['timeout']);
        } else {
-               $curl_time = intval(get_config('system','curl_timeout'));
+               $curl_time = intval(get_config('system', 'curl_timeout'));
                @curl_setopt($ch, CURLOPT_TIMEOUT, (($curl_time !== false) ? $curl_time : 60));
        }
 
        // by default we will allow self-signed certs
        // but you can override this
 
-       $check_cert = get_config('system','verifyssl');
+       $check_cert = get_config('system', 'verifyssl');
        @curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, (($check_cert) ? true : false));
-       @curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, (($check_cert) ? 2 : false));
 
-       $prx = get_config('system','proxy');
-       if(strlen($prx)) {
+       if ($check_cert) {
+               @curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
+       }
+
+       $proxy = get_config('system', 'proxy');
+
+       if (strlen($proxy)) {
                @curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);
-               @curl_setopt($ch, CURLOPT_PROXY, $prx);
-               $prxusr = @get_config('system','proxyuser');
-               if(strlen($prxusr))
-                       @curl_setopt($ch, CURLOPT_PROXYUSERPWD, $prxusr);
+               @curl_setopt($ch, CURLOPT_PROXY, $proxy);
+               $proxyuser = @get_config('system', 'proxyuser');
+
+               if (strlen($proxyuser)) {
+                       @curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyuser);
+               }
+       }
+
+       if ($binary) {
+               @curl_setopt($ch, CURLOPT_BINARYTRANSFER, 1);
        }
-       if($binary)
-               @curl_setopt($ch, CURLOPT_BINARYTRANSFER,1);
 
        $a->set_curl_code(0);
 
@@ -137,8 +154,9 @@ function z_fetch_url($url,$binary = false, &$redirects = 0, $opts=array()) {
        // if it throws any errors.
 
        $s = @curl_exec($ch);
+
        if (curl_errno($ch) !== CURLE_OK) {
-               logger('fetch_url error fetching '.$url.': '.curl_error($ch), LOGGER_NORMAL);
+               logger('fetch_url error fetching ' . $url . ': ' . curl_error($ch), LOGGER_NORMAL);
        }
 
        $ret['errno'] = curl_errno($ch);
@@ -147,134 +165,150 @@ function z_fetch_url($url,$binary = false, &$redirects = 0, $opts=array()) {
        $curl_info = @curl_getinfo($ch);
 
        $http_code = $curl_info['http_code'];
-       logger('fetch_url '.$url.': '.$http_code." ".$s, LOGGER_DATA);
+       logger('fetch_url ' . $url . ': ' . $http_code . " " . $s, LOGGER_DATA);
        $header = '';
 
        // Pull out multiple headers, e.g. proxy and continuation headers
        // allow for HTTP/2.x without fixing code
 
-       while(preg_match('/^HTTP\/[1-2].+? [1-5][0-9][0-9]/',$base)) {
-               $chunk = substr($base,0,strpos($base,"\r\n\r\n")+4);
+       while (preg_match('/^HTTP\/[1-2].+? [1-5][0-9][0-9]/', $base)) {
+               $chunk = substr($base, 0, strpos($base,"\r\n\r\n") + 4);
                $header .= $chunk;
-               $base = substr($base,strlen($chunk));
+               $base = substr($base, strlen($chunk));
        }
 
        $a->set_curl_code($http_code);
        $a->set_curl_content_type($curl_info['content_type']);
        $a->set_curl_headers($header);
 
-       if($http_code == 301 || $http_code == 302 || $http_code == 303 || $http_code == 307) {
-               $new_location_info = @parse_url($curl_info["redirect_url"]);
-               $old_location_info = @parse_url($curl_info["url"]);
+       if ($http_code == 301 || $http_code == 302 || $http_code == 303 || $http_code == 307) {
+               $new_location_info = @parse_url($curl_info['redirect_url']);
+               $old_location_info = @parse_url($curl_info['url']);
 
-               $newurl = $curl_info["redirect_url"];
+               $newurl = $curl_info['redirect_url'];
 
-               if (($new_location_info["path"] == "") AND ($new_location_info["host"] != ""))
-                       $newurl = $new_location_info["scheme"]."://".$new_location_info["host"].$old_location_info["path"];
+               if (($new_location_info['path'] == '') && ( $new_location_info['host'] != '')) {
+                       $newurl = $new_location_info['scheme'] . '://' . $new_location_info['host'] . $old_location_info['path'];
+               }
 
                $matches = array();
+
                if (preg_match('/(Location:|URI:)(.*?)\n/i', $header, $matches)) {
                        $newurl = trim(array_pop($matches));
                }
-               if(strpos($newurl,'/') === 0)
+               if (strpos($newurl,'/') === 0) {
                        $newurl = $old_location_info["scheme"]."://".$old_location_info["host"].$newurl;
+               }
+
                if (filter_var($newurl, FILTER_VALIDATE_URL)) {
                        $redirects++;
                        @curl_close($ch);
-                       return z_fetch_url($newurl,$binary, $redirects, $opts);
+                       return z_fetch_url($newurl, $binary, $redirects, $opts);
                }
        }
 
-
        $a->set_curl_code($http_code);
        $a->set_curl_content_type($curl_info['content_type']);
 
-       $body = substr($s,strlen($header));
-
-
+       $body = substr($s, strlen($header));
 
        $rc = intval($http_code);
        $ret['return_code'] = $rc;
        $ret['success'] = (($rc >= 200 && $rc <= 299) ? true : false);
        $ret['redirect_url'] = $url;
-       if(! $ret['success']) {
+
+       if (!$ret['success']) {
                $ret['error'] = curl_error($ch);
                $ret['debug'] = $curl_info;
-               logger('z_fetch_url: error: ' . $url . ': ' . $ret['error'], LOGGER_DEBUG);
-               logger('z_fetch_url: debug: ' . print_r($curl_info,true), LOGGER_DATA);
+               logger('z_fetch_url: error: '.$url.': '.$ret['return_code'].' - '.$ret['error'], LOGGER_DEBUG);
+               logger('z_fetch_url: debug: '.print_r($curl_info, true), LOGGER_DATA);
        }
-       $ret['body'] = substr($s,strlen($header));
+
+       $ret['body'] = substr($s, strlen($header));
        $ret['header'] = $header;
-       if(x($opts,'debug')) {
+
+       if (x($opts, 'debug')) {
                $ret['debug'] = $curl_info;
        }
+
        @curl_close($ch);
 
-       $a->save_timestamp($stamp1, "network");
+       $a->save_timestamp($stamp1, 'network');
 
        return($ret);
-
 }
 
-// post request to $url. $params is an array of post variables.
-
 /**
- * @brief Post request to $url
- * 
+ * @brief Send POST request to $url
+ *
  * @param string $url URL to post
- * @param mixed $params
+ * @param mixed $params array of POST variables
  * @param string $headers HTTP headers
  * @param integer $redirects Recursion counter for internal use - default = 0
  * @param integer $timeout The timeout in seconds, default system config value or 60 seconds
- * 
+ *
  * @return string The content
  */
-function post_url($url,$params, $headers = null, &$redirects = 0, $timeout = 0) {
+function post_url($url, $params, $headers = null, &$redirects = 0, $timeout = 0) {
        $stamp1 = microtime(true);
 
+       if (blocked_url($url)) {
+               logger('post_url: domain of ' . $url . ' is blocked', LOGGER_DATA);
+               return false;
+       }
+
        $a = get_app();
        $ch = curl_init($url);
-       if(($redirects > 8) || (! $ch))
+
+       if (($redirects > 8) || (!$ch)) {
                return false;
+       }
 
-       logger("post_url: start ".$url, LOGGER_DATA);
+       logger('post_url: start ' . $url, LOGGER_DATA);
 
        curl_setopt($ch, CURLOPT_HEADER, true);
-       curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
-       curl_setopt($ch, CURLOPT_POST,1);
-       curl_setopt($ch, CURLOPT_POSTFIELDS,$params);
+       curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+       curl_setopt($ch, CURLOPT_POST, 1);
+       curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
        curl_setopt($ch, CURLOPT_USERAGENT, $a->get_useragent());
 
-       if(intval($timeout)) {
+       if (intval($timeout)) {
                curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
-       }
-       else {
-               $curl_time = intval(get_config('system','curl_timeout'));
+       } else {
+               $curl_time = intval(get_config('system', 'curl_timeout'));
                curl_setopt($ch, CURLOPT_TIMEOUT, (($curl_time !== false) ? $curl_time : 60));
        }
 
-       if(defined('LIGHTTPD')) {
-               if(!is_array($headers)) {
+       if (defined('LIGHTTPD')) {
+               if (!is_array($headers)) {
                        $headers = array('Expect:');
                } else {
-                       if(!in_array('Expect:', $headers)) {
+                       if (!in_array('Expect:', $headers)) {
                                array_push($headers, 'Expect:');
                        }
                }
        }
-       if($headers)
+
+       if ($headers) {
                curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
+       }
 
-       $check_cert = get_config('system','verifyssl');
+       $check_cert = get_config('system', 'verifyssl');
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, (($check_cert) ? true : false));
-       curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, (($check_cert) ? 2 : false));
-       $prx = get_config('system','proxy');
-       if(strlen($prx)) {
+
+       if ($check_cert) {
+               @curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
+       }
+
+       $proxy = get_config('system', 'proxy');
+
+       if (strlen($proxy)) {
                curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);
-               curl_setopt($ch, CURLOPT_PROXY, $prx);
-               $prxusr = get_config('system','proxyuser');
-               if(strlen($prxusr))
-                       curl_setopt($ch, CURLOPT_PROXYUSERPWD, $prxusr);
+               curl_setopt($ch, CURLOPT_PROXY, $proxy);
+               $proxyuser = get_config('system', 'proxyuser');
+               if (strlen($proxyuser)) {
+                       curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyuser);
+               }
        }
 
        $a->set_curl_code(0);
@@ -288,44 +322,48 @@ function post_url($url,$params, $headers = null, &$redirects = 0, $timeout = 0)
        $curl_info = curl_getinfo($ch);
        $http_code = $curl_info['http_code'];
 
-       logger("post_url: result ".$http_code." - ".$url, LOGGER_DATA);
+       logger('post_url: result ' . $http_code . ' - ' . $url, LOGGER_DATA);
 
        $header = '';
 
        // Pull out multiple headers, e.g. proxy and continuation headers
        // allow for HTTP/2.x without fixing code
 
-       while(preg_match('/^HTTP\/[1-2].+? [1-5][0-9][0-9]/',$base)) {
-               $chunk = substr($base,0,strpos($base,"\r\n\r\n")+4);
+       while (preg_match('/^HTTP\/[1-2].+? [1-5][0-9][0-9]/', $base)) {
+               $chunk = substr($base, 0, strpos($base, "\r\n\r\n") + 4);
                $header .= $chunk;
-               $base = substr($base,strlen($chunk));
+               $base = substr($base, strlen($chunk));
        }
 
-       if($http_code == 301 || $http_code == 302 || $http_code == 303 || $http_code == 307) {
+       if ($http_code == 301 || $http_code == 302 || $http_code == 303 || $http_code == 307) {
                $matches = array();
                preg_match('/(Location:|URI:)(.*?)\n/', $header, $matches);
                $newurl = trim(array_pop($matches));
-               if(strpos($newurl,'/') === 0)
+
+               if (strpos($newurl, '/') === 0) {
                        $newurl = $old_location_info["scheme"] . "://" . $old_location_info["host"] . $newurl;
+               }
+
                if (filter_var($newurl, FILTER_VALIDATE_URL)) {
                        $redirects++;
-                       logger("post_url: redirect ".$url." to ".$newurl);
-                       return post_url($newurl,$params, $headers, $redirects, $timeout);
-                       //return fetch_url($newurl,false,$redirects,$timeout);
+                       logger('post_url: redirect ' . $url . ' to ' . $newurl);
+                       return post_url($newurl, $params, $headers, $redirects, $timeout);
                }
        }
+
        $a->set_curl_code($http_code);
-       $body = substr($s,strlen($header));
+
+       $body = substr($s, strlen($header));
 
        $a->set_curl_headers($header);
 
        curl_close($ch);
 
-       $a->save_timestamp($stamp1, "network");
+       $a->save_timestamp($stamp1, 'network');
 
-       logger("post_url: end ".$url, LOGGER_DATA);
+       logger('post_url: end ' . $url, LOGGER_DATA);
 
-       return($body);
+       return $body;
 }
 
 // Generic XML return
@@ -336,7 +374,7 @@ function xml_status($st, $message = '') {
 
        $xml_message = ((strlen($message)) ? "\t<message>" . xmlify($message) . "</message>\r\n" : '');
 
-       if($st)
+       if ($st)
                logger('xml_status returning non_zero: ' . $st . " message=" . $message);
 
        header( "Content-type: text/xml" );
@@ -364,12 +402,12 @@ function xml_status($st, $message = '') {
  */
 function http_status_exit($val, $description = array()) {
        $err = '';
-       if($val >= 400) {
+       if ($val >= 400) {
                $err = 'Error';
                if (!isset($description["title"]))
                        $description["title"] = $err." ".$val;
        }
-       if($val >= 200 && $val < 300)
+       if ($val >= 200 && $val < 300)
                $err = 'OK';
 
        logger('http_status_exit ' . $val);
@@ -387,28 +425,28 @@ function http_status_exit($val, $description = array()) {
 
 /**
  * @brief Check URL to se if ts's real
- * 
+ *
  * Take a URL from the wild, prepend http:// if necessary
  * and check DNS to see if it's real (or check if is a valid IP address)
- * 
+ *
  * @param string $url The URL to be validated
  * @return boolean True if it's a valid URL, fals if something wrong with it
  */
 function validate_url(&$url) {
-       if(get_config('system','disable_url_validation'))
+       if (get_config('system','disable_url_validation'))
                return true;
 
        // no naked subdomains (allow localhost for tests)
-       if(strpos($url,'.') === false && strpos($url,'/localhost/') === false)
+       if (strpos($url,'.') === false && strpos($url,'/localhost/') === false)
                return false;
 
-       if(substr($url,0,4) != 'http')
+       if (substr($url,0,4) != 'http')
                $url = 'http://' . $url;
 
        /// @TODO Really supress function outcomes? Why not find them + debug them?
        $h = @parse_url($url);
 
-       if((is_array($h)) && (dns_get_record($h['host'], DNS_A + DNS_CNAME + DNS_PTR) || filter_var($h['host'], FILTER_VALIDATE_IP) )) {
+       if ((is_array($h)) && (dns_get_record($h['host'], DNS_A + DNS_CNAME + DNS_PTR) || filter_var($h['host'], FILTER_VALIDATE_IP) )) {
                return true;
        }
 
@@ -417,20 +455,20 @@ function validate_url(&$url) {
 
 /**
  * @brief Checks that email is an actual resolvable internet address
- * 
+ *
  * @param string $addr The email address
  * @return boolean True if it's a valid email address, false if it's not
  */
 function validate_email($addr) {
 
-       if(get_config('system','disable_email_validation'))
+       if (get_config('system','disable_email_validation'))
                return true;
 
-       if(! strpos($addr,'@'))
+       if (! strpos($addr,'@'))
                return false;
        $h = substr($addr,strpos($addr,'@') + 1);
 
-       if(($h) && (dns_get_record($h, DNS_A + DNS_CNAME + DNS_PTR + DNS_MX) || filter_var($h, FILTER_VALIDATE_IP) )) {
+       if (($h) && (dns_get_record($h, DNS_A + DNS_CNAME + DNS_PTR + DNS_MX) || filter_var($h, FILTER_VALIDATE_IP) )) {
                return true;
        }
        return false;
@@ -438,10 +476,10 @@ function validate_email($addr) {
 
 /**
  * @brief Check if URL is allowed
- * 
+ *
  * Check $url against our list of allowed sites,
  * wildcards allowed. If allowed_sites is unset return true;
- * 
+ *
  * @param string $url URL which get tested
  * @return boolean True if url is allowed otherwise return false
  */
@@ -449,30 +487,31 @@ function allowed_url($url) {
 
        $h = @parse_url($url);
 
-       if(! $h) {
+       if (! $h) {
                return false;
        }
 
-       $str_allowed = get_config('system','allowed_sites');
-       if(! $str_allowed)
+       $str_allowed = Config::get('system', 'allowed_sites');
+       if (! $str_allowed) {
                return true;
+       }
 
        $found = false;
 
        $host = strtolower($h['host']);
 
        // always allow our own site
-
-       if($host == strtolower($_SERVER['SERVER_NAME']))
+       if ($host == strtolower($_SERVER['SERVER_NAME'])) {
                return true;
+       }
 
        $fnmatch = function_exists('fnmatch');
-       $allowed = explode(',',$str_allowed);
+       $allowed = explode(',', $str_allowed);
 
-       if(count($allowed)) {
-               foreach($allowed as $a) {
+       if (count($allowed)) {
+               foreach ($allowed as $a) {
                        $pat = strtolower(trim($a));
-                       if(($fnmatch && fnmatch($pat,$host)) || ($pat == $host)) {
+                       if (($fnmatch && fnmatch($pat, $host)) || ($pat == $host)) {
                                $found = true;
                                break;
                        }
@@ -481,35 +520,66 @@ function allowed_url($url) {
        return $found;
 }
 
+/**
+ * Checks if the provided url domain is on the domain blocklist.
+ * Returns true if it is or malformed URL, false if not.
+ *
+ * @param string $url The url to check the domain from
+ * @return boolean
+ */
+function blocked_url($url) {
+       $h = @parse_url($url);
+
+       if (! $h) {
+               return true;
+       }
+
+       $domain_blocklist = Config::get('system', 'blocklist', array());
+       if (! $domain_blocklist) {
+               return false;
+       }
+
+       $host = strtolower($h['host']);
+
+       foreach ($domain_blocklist as $domain_block) {
+               if (strtolower($domain_block['domain']) == $host) {
+                       return true;
+               }
+       }
+
+       return false;
+}
+
 /**
  * @brief Check if email address is allowed to register here.
- * 
+ *
  * Compare against our list (wildcards allowed).
- * 
+ *
  * @param type $email
  * @return boolean False if not allowed, true if allowed
  *    or if allowed list is not configured
  */
 function allowed_email($email) {
 
-
        $domain = strtolower(substr($email,strpos($email,'@') + 1));
-       if(! $domain)
+       if (! $domain) {
                return false;
+       }
 
        $str_allowed = get_config('system','allowed_email');
-       if(! $str_allowed)
+       if (! $str_allowed) {
                return true;
+       }
 
        $found = false;
 
        $fnmatch = function_exists('fnmatch');
        $allowed = explode(',',$str_allowed);
 
-       if(count($allowed)) {
-               foreach($allowed as $a) {
+       if (count($allowed)) {
+               foreach ($allowed as $a) {
                        $pat = strtolower(trim($a));
-                       if(($fnmatch && fnmatch($pat,$domain)) || ($pat == $domain)) {
+                       if (($fnmatch && fnmatch($pat,$domain)) || ($pat == $domain)) {
                                $found = true;
                                break;
                        }
@@ -538,8 +608,8 @@ function avatar_img($email) {
 
 function parse_xml_string($s,$strict = true) {
        /// @todo Move this function to the xml class
-       if($strict) {
-               if(! strstr($s,'<?xml'))
+       if ($strict) {
+               if (! strstr($s,'<?xml'))
                        return false;
                $s2 = substr($s,strpos($s,'<?xml'));
        }
@@ -653,61 +723,75 @@ function fix_contact_ssl_policy(&$contact,$new_policy) {
        }
 
        if ($ssl_changed) {
-               q("UPDATE `contact` SET
-                       `url` = '%s',
-                       `request` = '%s',
-                       `notify` = '%s',
-                       `poll` = '%s',
-                       `confirm` = '%s',
-                       `poco` = '%s'
-                       WHERE `id` = %d LIMIT 1",
-                       dbesc($contact['url']),
-                       dbesc($contact['request']),
-                       dbesc($contact['notify']),
-                       dbesc($contact['poll']),
-                       dbesc($contact['confirm']),
-                       dbesc($contact['poco']),
-                       intval($contact['id'])
-               );
+               dba::update('contact', $contact, array('id' => $contact['id']));
        }
 }
 
-function original_url($url, $depth=1, $fetchbody = false) {
-
-       $a = get_app();
-
-       // Remove Analytics Data from Google and other tracking platforms
+/**
+ * @brief Remove Google Analytics and other tracking platforms params from URL
+ *
+ * @param string $url Any user-submitted URL that may contain tracking params
+ * @return string The same URL stripped of tracking parameters
+ */
+function strip_tracking_query_params($url)
+{
        $urldata = parse_url($url);
        if (is_string($urldata["query"])) {
                $query = $urldata["query"];
                parse_str($query, $querydata);
 
-               if (is_array($querydata))
-                       foreach ($querydata AS $param=>$value)
+               if (is_array($querydata)) {
+                       foreach ($querydata AS $param => $value) {
                                if (in_array($param, array("utm_source", "utm_medium", "utm_term", "utm_content", "utm_campaign",
                                                        "wt_mc", "pk_campaign", "pk_kwd", "mc_cid", "mc_eid",
                                                        "fb_action_ids", "fb_action_types", "fb_ref",
                                                        "awesm", "wtrid",
                                                        "woo_campaign", "woo_source", "woo_medium", "woo_content", "woo_term"))) {
 
-                                       $pair = $param."=".urlencode($value);
+                                       $pair = $param . "=" . urlencode($value);
                                        $url = str_replace($pair, "", $url);
 
                                        // Second try: if the url isn't encoded completely
-                                       $pair = $param."=".str_replace(" ", "+", $value);
+                                       $pair = $param . "=" . str_replace(" ", "+", $value);
                                        $url = str_replace($pair, "", $url);
 
                                        // Third try: Maybey the url isn't encoded at all
-                                       $pair = $param."=".$value;
+                                       $pair = $param . "=" . $value;
                                        $url = str_replace($pair, "", $url);
 
                                        $url = str_replace(array("?&", "&&"), array("?", ""), $url);
                                }
+                       }
+               }
 
-               if (substr($url, -1, 1) == "?")
+               if (substr($url, -1, 1) == "?") {
                        $url = substr($url, 0, -1);
+               }
        }
 
+       return $url;
+}
+
+/**
+ * @brief Returns the original URL of the provided URL
+ *
+ * This function strips tracking query params and follows redirections, either
+ * through HTTP code or meta refresh tags. Stops after 10 redirections.
+ *
+ * @todo Remove the $fetchbody parameter that generates an extraneous HEAD request
+ *
+ * @see ParseUrl::getSiteinfo
+ *
+ * @param string $url A user-submitted URL
+ * @param int $depth The current redirection recursion level (internal)
+ * @param bool $fetchbody Wether to fetch the body or not after the HEAD requests
+ * @return string A canonical URL
+ */
+function original_url($url, $depth = 1, $fetchbody = false) {
+       $a = get_app();
+
+       $url = strip_tracking_query_params($url);
+
        if ($depth > 10)
                return($url);
 
@@ -734,8 +818,8 @@ function original_url($url, $depth=1, $fetchbody = false) {
        if ($http_code == 0)
                return($url);
 
-       if ((($curl_info['http_code'] == "301") OR ($curl_info['http_code'] == "302"))
-               AND (($curl_info['redirect_url'] != "") OR ($curl_info['location'] != ""))) {
+       if ((($curl_info['http_code'] == "301") || ($curl_info['http_code'] == "302"))
+               && (($curl_info['redirect_url'] != "") || ($curl_info['location'] != ""))) {
                if ($curl_info['redirect_url'] != "")
                        return(original_url($curl_info['redirect_url'], ++$depth, $fetchbody));
                else
@@ -751,7 +835,7 @@ function original_url($url, $depth=1, $fetchbody = false) {
                return($url);
 
        // if it isn't a HTML file then exit
-       if (($curl_info["content_type"] != "") AND !strstr(strtolower($curl_info["content_type"]),"html"))
+       if (($curl_info["content_type"] != "") && !strstr(strtolower($curl_info["content_type"]),"html"))
                return($url);
 
        $stamp1 = microtime(true);
@@ -823,7 +907,7 @@ function short_link($url) {
 
 /**
  * @brief Encodes content to json
- * 
+ *
  * This function encodes an array to json format
  * and adds an application/json HTTP header to the output.
  * After finishing the process is getting killed.
@@ -845,7 +929,7 @@ function json_return_and_die($x) {
  */
 function matching_url($url1, $url2) {
 
-       if (($url1 == "") OR ($url2 == ""))
+       if (($url1 == "") || ($url2 == ""))
                return "";
 
        $url1 = normalise_link($url1);
@@ -854,7 +938,7 @@ function matching_url($url1, $url2) {
        $parts1 = parse_url($url1);
        $parts2 = parse_url($url2);
 
-       if (!isset($parts1["host"]) OR !isset($parts2["host"]))
+       if (!isset($parts1["host"]) || !isset($parts2["host"]))
                return "";
 
        if ($parts1["scheme"] != $parts2["scheme"])
@@ -883,7 +967,7 @@ function matching_url($url1, $url2) {
                if ($path1 == $path2)
                        $path .= $path1."/";
 
-       } while (($path1 == $path2) AND ($i++ <= count($pathparts1)));
+       } while (($path1 == $path2) && ($i++ <= count($pathparts1)));
 
        $match .= $path;