diff options
| author | spiderr <spiderr@bitweaver.org> | 2018-07-31 11:45:28 -0400 |
|---|---|---|
| committer | spiderr <spiderr@bitweaver.org> | 2018-07-31 11:45:28 -0400 |
| commit | 4a945905298ba6173c2f53dfac5fe5fcffa3fb84 (patch) | |
| tree | 2aa64fc11e943d185ec76c39214b46e4f775b069 | |
| parent | 8f7d7b9430e00ce3d5cd0f6182ff3da866d66a6e (diff) | |
| download | util-4a945905298ba6173c2f53dfac5fe5fcffa3fb84.tar.gz util-4a945905298ba6173c2f53dfac5fe5fcffa3fb84.tar.bz2 util-4a945905298ba6173c2f53dfac5fe5fcffa3fb84.zip | |
create includes/
| -rw-r--r-- | .htaccess | 1 | ||||
| -rw-r--r-- | Snoopy.class.inc | 1173 | ||||
| -rw-r--r-- | Snoopy.readme | 261 | ||||
| -rw-r--r-- | includes/BrowserDetection.php | 2106 |
4 files changed, 2107 insertions, 1434 deletions
diff --git a/.htaccess b/.htaccess new file mode 100644 index 0000000..3a42882 --- /dev/null +++ b/.htaccess @@ -0,0 +1 @@ +Deny from all diff --git a/Snoopy.class.inc b/Snoopy.class.inc deleted file mode 100644 index 2e23f34..0000000 --- a/Snoopy.class.inc +++ /dev/null @@ -1,1173 +0,0 @@ -<?php - -/************************************************* - -Snoopy - the PHP net client -Author: Monte Ohrt <monte@ispi.net> -Copyright (c): 1999-2000 ispi, all rights reserved -Version: 1.0 - - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - -You may contact the author of Snoopy by e-mail at: -monte@ispi.net - -Or, write to: -Monte Ohrt -CTO, ispi -237 S. 70th suite 220 -Lincoln, NE 68510 - -The latest version of Snoopy can be obtained from: -http://snoopy.sourceforge.com - -*************************************************/ - -class Snoopy -{ - /**** Public variables ****/ - - /* user definable vars */ - - var $host = "www.php.net"; // host name we are connecting to - var $port = 80; // port we are connecting to - var $proxy_host = ""; // proxy host to use - var $proxy_port = ""; // proxy port to use - var $agent = "Snoopy v1.0"; // agent we masquerade as - var $referer = ""; // referer info to pass - var $cookies = array(); // array of cookies to pass - // $cookies["username"]="joe"; - var $rawheaders = array(); // array of raw headers to send - // $rawheaders["Content-type"]="text/html"; - - var $maxredirs = 5; // http redirection depth maximum. 0 = disallow - var $lastredirectaddr = ""; // contains address of last redirected address - var $offsiteok = true; // allows redirection off-site - var $maxframes = 0; // frame content depth maximum. 0 = disallow - var $expandlinks = true; // expand links to fully qualified URLs. - // this only applies to fetchlinks() - // or submitlinks() - var $passcookies = true; // pass set cookies back through redirects - // NOTE: this currently does not respect - // dates, domains or paths. - - var $user = ""; // user for http authentication - var $pass = ""; // password for http authentication - - // http accept types - var $accept = "image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, */*"; - - var $results = ""; // where the content is put - - var $error = ""; // error messages sent here - var $response_code = ""; // response code returned from server - var $headers = array(); // headers returned from server sent here - var $maxlength = 500000; // max return data length (body) - var $read_timeout = 0; // timeout on read operations, in seconds - // supported only since PHP 4 Beta 4 - // set to 0 to disallow timeouts - var $timed_out = false; // if a read operation timed out - var $status = 0; // http request status - - var $curl_path = "/usr/local/bin/curl"; - // Snoopy will use cURL for fetching - // SSL content if a full system path to - // the cURL binary is supplied here. - // set to false if you do not have - // cURL installed. See http://curl.haxx.se - // for details on installing cURL. - // Snoopy does *not* use the cURL - // library functions built into php, - // as these functions are not stable - // as of this Snoopy release. - - /**** Private variables ****/ - - var $_maxlinelen = 4096; // max line length (headers) - - var $_httpmethod = "GET"; // default http request method - var $_httpversion = "HTTP/1.0"; // default http request version - var $_submit_method = "POST"; // default submit method - var $_submit_type = "application/x-www-form-urlencoded"; // default submit type - var $_mime_boundary = ""; // MIME boundary for multipart/form-data submit type - var $_redirectaddr = false; // will be set if page fetched is a redirect - var $_redirectdepth = 0; // increments on an http redirect - var $_frameurls = array(); // frame src urls - var $_framedepth = 0; // increments on frame depth - - var $_isproxy = false; // set if using a proxy server - var $_fp_timeout = 30; // timeout for socket connection - -/*======================================================================*\ - Function: fetch - Purpose: fetch the contents of a web page - (and possibly other protocols in the - future like ftp, nntp, gopher, etc.) - Input: $URI the location of the page to fetch - Output: $this->results the output text from the fetch -\*======================================================================*/ - - function fetch($URI) - { - - //preg_match("|^([^:]+)://([^:/]+)(:[\d]+)*(.*)|",$URI,$URI_PARTS); - $URI_PARTS = parse_url($URI); - if (!empty($URI_PARTS["user"])) - $this->user = $URI_PARTS["user"]; - if (!empty($URI_PARTS["pass"])) - $this->pass = $URI_PARTS["pass"]; - if(!isset($URI_PARTS['path'])) $URI_PARTS['path']='/'; - if(!isset($URI_PARTS['query'])) $URI_PARTS['query']=''; - switch($URI_PARTS["scheme"]) - { - case "http": - $this->host = $URI_PARTS["host"]; - if(!empty($URI_PARTS["port"])) - $this->port = $URI_PARTS["port"]; - if($this->_connect($fp)) - { - if($this->_isproxy) - { - // using proxy, send entire URI - $this->_httprequest($URI,$fp,$URI,$this->_httpmethod); - } - else - { - $path = $URI_PARTS["path"].($URI_PARTS["query"] ? "?".$URI_PARTS["query"] : ""); - // no proxy, send only the path - $this->_httprequest($path, $fp, $URI, $this->_httpmethod); - } - - $this->_disconnect($fp); - - if($this->_redirectaddr) - { - /* url was redirected, check if we've hit the max depth */ - if($this->maxredirs > $this->_redirectdepth) - { - // only follow redirect if it's on this site, or offsiteok is true - if(preg_match("|^http://".preg_quote($this->host)."|i",$this->_redirectaddr) || $this->offsiteok) - { - /* follow the redirect */ - $this->_redirectdepth++; - $this->lastredirectaddr=$this->_redirectaddr; - $this->fetch($this->_redirectaddr); - } - } - } - - if($this->_framedepth < $this->maxframes && count($this->_frameurls) > 0) - { - $frameurls = $this->_frameurls; - $this->_frameurls = array(); - - while(list(,$frameurl) = each($frameurls)) - { - if($this->_framedepth < $this->maxframes) - { - $this->fetch($frameurl); - $this->_framedepth++; - } - else - break; - } - } - } - else - { - return false; - } - return true; - break; - case "https": - if(!$this->curl_path || (!is_executable($this->curl_path))) - return false; - $this->host = $URI_PARTS["host"]; - if(!empty($URI_PARTS["port"])) - $this->port = $URI_PARTS["port"]; - if($this->_isproxy) - { - // using proxy, send entire URI - $this->_httpsrequest($URI,$URI,$this->_httpmethod); - } - else - { - $path = $URI_PARTS["path"].($URI_PARTS["query"] ? "?".$URI_PARTS["query"] : ""); - // no proxy, send only the path - $this->_httpsrequest($path, $URI, $this->_httpmethod); - } - - if($this->_redirectaddr) - { - /* url was redirected, check if we've hit the max depth */ - if($this->maxredirs > $this->_redirectdepth) - { - // only follow redirect if it's on this site, or offsiteok is true - if(preg_match("|^http://".preg_quote($this->host)."|i",$this->_redirectaddr) || $this->offsiteok) - { - /* follow the redirect */ - $this->_redirectdepth++; - $this->lastredirectaddr=$this->_redirectaddr; - $this->fetch($this->_redirectaddr); - } - } - } - - if($this->_framedepth < $this->maxframes && count($this->_frameurls) > 0) - { - $frameurls = $this->_frameurls; - $this->_frameurls = array(); - - while(list(,$frameurl) = each($frameurls)) - { - if($this->_framedepth < $this->maxframes) - { - $this->fetch($frameurl); - $this->_framedepth++; - } - else - break; - } - } - return true; - break; - default: - // not a valid protocol - $this->error = 'Invalid protocol "'.$URI_PARTS["scheme"].'"\n'; - return false; - break; - } - return true; - } - -/*======================================================================*\ - Function: submit - Purpose: submit an http form - Input: $URI the location to post the data - $formvars the formvars to use. - format: $formvars["var"] = "val"; - Output: $this->results the text output from the post -\*======================================================================*/ - - function submit($URI, $formvars="", $formfiles="") - { - unset($postdata); - - $postdata = $this->_prepare_post_body($formvars, $formfiles); - - $URI_PARTS = parse_url($URI); - if(!isset($URI_PARTS['query'])) $URI_PARTS['query']=''; - if (!empty($URI_PARTS["user"])) - $this->user = $URI_PARTS["user"]; - if (!empty($URI_PARTS["pass"])) - $this->pass = $URI_PARTS["pass"]; - - switch($URI_PARTS["scheme"]) - { - case "http": - $this->host = $URI_PARTS["host"]; - if(!empty($URI_PARTS["port"])) - $this->port = $URI_PARTS["port"]; - if($this->_connect($fp)) - { - if($this->_isproxy) - { - // using proxy, send entire URI - $this->_httprequest($URI,$fp,$URI,$this->_submit_method,$this->_submit_type,$postdata); - } - else - { - $path = $URI_PARTS["path"].($URI_PARTS["query"] ? "?".$URI_PARTS["query"] : ""); - // no proxy, send only the path - $this->_httprequest($path, $fp, $URI, $this->_submit_method, $this->_submit_type, $postdata); - } - - $this->_disconnect($fp); - - if($this->_redirectaddr) - { - /* url was redirected, check if we've hit the max depth */ - if($this->maxredirs > $this->_redirectdepth) - { - if(!preg_match("|^".$URI_PARTS["scheme"]."://|", $this->_redirectaddr)) - $this->_redirectaddr = $this->_expandlinks($this->_redirectaddr,$URI_PARTS["scheme"]."://".$URI_PARTS["host"]); - - // only follow redirect if it's on this site, or offsiteok is true - if(preg_match("|^http://".preg_quote($this->host)."|i",$this->_redirectaddr) || $this->offsiteok) - { - /* follow the redirect */ - $this->_redirectdepth++; - $this->lastredirectaddr=$this->_redirectaddr; - $this->submit($this->_redirectaddr,$formvars, $formfiles); - } - } - } - - if($this->_framedepth < $this->maxframes && count($this->_frameurls) > 0) - { - $frameurls = $this->_frameurls; - $this->_frameurls = array(); - - while(list(,$frameurl) = each($frameurls)) - { - if($this->_framedepth < $this->maxframes) - { - $this->fetch($frameurl); - $this->_framedepth++; - } - else - break; - } - } - - } - else - { - return false; - } - return true; - break; - case "https": - if(!$this->curl_path || (!is_executable($this->curl_path))) - return false; - $this->host = $URI_PARTS["host"]; - if(!empty($URI_PARTS["port"])) - $this->port = $URI_PARTS["port"]; - if($this->_isproxy) - { - // using proxy, send entire URI - $this->_httpsrequest($URI, $URI, $this->_submit_method, $this->_submit_type, $postdata); - } - else - { - $path = $URI_PARTS["path"].($URI_PARTS["query"] ? "?".$URI_PARTS["query"] : ""); - // no proxy, send only the path - $this->_httpsrequest($path, $URI, $this->_submit_method, $this->_submit_type, $postdata); - } - - if($this->_redirectaddr) - { - /* url was redirected, check if we've hit the max depth */ - if($this->maxredirs > $this->_redirectdepth) - { - if(!preg_match("|^".$URI_PARTS["scheme"]."://|", $this->_redirectaddr)) - $this->_redirectaddr = $this->_expandlinks($this->_redirectaddr,$URI_PARTS["scheme"]."://".$URI_PARTS["host"]); - - // only follow redirect if it's on this site, or offsiteok is true - if(preg_match("|^http://".preg_quote($this->host)."|i",$this->_redirectaddr) || $this->offsiteok) - { - /* follow the redirect */ - $this->_redirectdepth++; - $this->lastredirectaddr=$this->_redirectaddr; - $this->submit($this->_redirectaddr,$formvars, $formfiles); - } - } - } - - if($this->_framedepth < $this->maxframes && count($this->_frameurls) > 0) - { - $frameurls = $this->_frameurls; - $this->_frameurls = array(); - - while(list(,$frameurl) = each($frameurls)) - { - if($this->_framedepth < $this->maxframes) - { - $this->fetch($frameurl); - $this->_framedepth++; - } - else - break; - } - } - return true; - break; - - default: - // not a valid protocol - $this->error = 'Invalid protocol "'.$URI_PARTS["scheme"].'"\n'; - return false; - break; - } - return true; - } - -/*======================================================================*\ - Function: fetchlinks - Purpose: fetch the links from a web page - Input: $URI where you are fetching from - Output: $this->results an array of the URLs -\*======================================================================*/ - - function fetchlinks($URI) - { - if ($this->fetch($URI)) - { - if(is_array($this->results)) - { - for($x=0;$x<count($this->results);$x++) { - - $this->results[$x] = $this->_striplinks($this->results[$x]); - } - } - else { - $this->results = $this->_striplinks($this->results); - } - if($this->expandlinks) - $this->results = $this->_expandlinks($this->results, $URI); - return true; - } - else - return false; - } - -/*======================================================================*\ - Function: fetchform - Purpose: fetch the form elements from a web page - Input: $URI where you are fetching from - Output: $this->results the resulting html form -\*======================================================================*/ - - function fetchform($URI) - { - - if ($this->fetch($URI)) - { - - if(is_array($this->results)) - { - for($x=0;$x<count($this->results);$x++) - $this->results[$x] = $this->_stripform($this->results[$x]); - } - else - $this->results = $this->_stripform($this->results); - - return true; - } - else - return false; - } - - -/*======================================================================*\ - Function: fetchtext - Purpose: fetch the text from a web page, stripping the links - Input: $URI where you are fetching from - Output: $this->results the text from the web page -\*======================================================================*/ - - function fetchtext($URI) - { - if($this->fetch($URI)) - { - if(is_array($this->results)) - { - for($x=0;$x<count($this->results);$x++) - $this->results[$x] = $this->_striptext($this->results[$x]); - } - else - $this->results = $this->_striptext($this->results); - return true; - } - else - return false; - } - -/*======================================================================*\ - Function: submitlinks - Purpose: grab links from a form submission - Input: $URI where you are submitting from - Output: $this->results an array of the links from the post -\*======================================================================*/ - - function submitlinks($URI, $formvars="", $formfiles="") - { - if($this->submit($URI,$formvars, $formfiles)) - { - if(is_array($this->results)) - { - for($x=0;$x<count($this->results);$x++) - { - $this->results[$x] = $this->_striplinks($this->results[$x]); - if($this->expandlinks) - $this->results[$x] = $this->_expandlinks($this->results[$x],$URI); - } - } - else - { - $this->results = $this->_striplinks($this->results); - if($this->expandlinks) - $this->results = $this->_expandlinks($this->results,$URI); - } - return true; - } - else - return false; - } - -/*======================================================================*\ - Function: submittext - Purpose: grab text from a form submission - Input: $URI where you are submitting from - Output: $this->results the text from the web page -\*======================================================================*/ - - function submittext($URI, $formvars = "", $formfiles = "") - { - if($this->submit($URI,$formvars, $formfiles)) - { - if(is_array($this->results)) - { - for($x=0;$x<count($this->results);$x++) - { - $this->results[$x] = $this->_striptext($this->results[$x]); - if($this->expandlinks) - $this->results[$x] = $this->_expandlinks($this->results[$x],$URI); - } - } - else - { - $this->results = $this->_striptext($this->results); - if($this->expandlinks) - $this->results = $this->_expandlinks($this->results,$URI); - } - return true; - } - else - return false; - } - - - -/*======================================================================*\ - Function: set_submit_multipart - Purpose: Set the form submission content type to - multipart/form-data -\*======================================================================*/ - function set_submit_multipart() - { - $this->_submit_type = "multipart/form-data"; - } - - -/*======================================================================*\ - Function: set_submit_normal - Purpose: Set the form submission content type to - application/x-www-form-urlencoded -\*======================================================================*/ - function set_submit_normal() - { - $this->_submit_type = "application/x-www-form-urlencoded"; - } - - - - -/*======================================================================*\ - Private functions -\*======================================================================*/ - - -/*======================================================================*\ - Function: _striplinks - Purpose: strip the hyperlinks from an html document - Input: $document document to strip. - Output: $match an array of the links -\*======================================================================*/ - - function _striplinks($document) - { -// preg_match_all("/<\s*a\s+.*href\s*=\s* # find <a href= - preg_match_all("'<\s*a\s+.*href\s*=\s* - ([\"\'])? # find single or double quote - (?(1) (.*?)\\1 | ([^\s\>]+)) # if quote found, match up to next matching - # quote, otherwise match up to next space - 'isx",$document,$links); - -// preg_match_all("/href=()/",$document,$links1); - - // catenate the non-empty matches from the conditional subpattern - - while(list($key,$val) = each($links[2])) - { - if(!empty($val)) - $match[] = $val; - } - - while(list($key,$val) = each($links[3])) - { - if(!empty($val)) - $match[] = $val; - } - - // return the links - return $match; - } - -/*======================================================================*\ - Function: _stripform - Purpose: strip the form elements from an html document - Input: $document document to strip. - Output: $match an array of the links -\*======================================================================*/ - - function _stripform($document) - { - preg_match_all("'<\/?(FORM|INPUT|SELECT|TEXTAREA|(OPTION))[^<>]*>(?(2)(.*(?=<\/?(option|select)[^<>]*>[\r\n]*)|(?=[\r\n]*))|(?=[\r\n]*))'Usi",$document,$elements); - - // catenate the matches - $match = implode("\r\n",$elements[0]); - - // return the links - return $match; - } - - - -/*======================================================================*\ - Function: _striptext - Purpose: strip the text from an html document - Input: $document document to strip. - Output: $text the resulting text -\*======================================================================*/ - - function _striptext($document) - { - - // I didn't use preg eval (//e) since that is only available in PHP 4.0. - // so, list your entities one by one here. I included some of the - // more common ones. - - $search = array("'<script[^>]*?>.*?</script>'si", // strip out javascript - "'<[\/\!]*?[^<>]*?>'si", // strip out html tags - "'([\r\n])[\s]+'", // strip out white space - "'&(quote|#34);'i", // replace html entities - "'&(amp|#38);'i", - "'&(lt|#60);'i", - "'&(gt|#62);'i", - "'&(nbsp|#160);'i", - "'&(iexcl|#161);'i", - "'&(cent|#162);'i", - "'&(pound|#163);'i", - "'&(copy|#169);'i" - ); - $replace = array( "", - "", - "\\1", - "\"", - "&", - "<", - ">", - " ", - chr(161), - chr(162), - chr(163), - chr(169)); - - $text = preg_replace($search,$replace,$document); - - return $text; - } - -/*======================================================================*\ - Function: _expandlinks - Purpose: expand each link into a fully qualified URL - Input: $links the links to qualify - $URI the full URI to get the base from - Output: $expandedLinks the expanded links -\*======================================================================*/ - - function _expandlinks($links,$URI) - { - - preg_match("/^[^\?]+/",$URI,$match); - - $match = preg_replace("|/[^\/\.]+\.[^\/\.]+$|","",$match[0]); - - $search = array( "|^http://".preg_quote($this->host)."|i", - "|^(?!http://)(\/)?(?!mailto:)|i", - "|/\./|", - "|/[^\/]+/\.\./|" - ); - - $replace = array( "", - $match."/", - "/", - "/" - ); - - $expandedLinks = preg_replace($search,$replace,$links); - - return $expandedLinks; - } - -/*======================================================================*\ - Function: _httprequest - Purpose: go get the http data from the server - Input: $url the url to fetch - $fp the current open file pointer - $URI the full URI - $body body contents to send if any (POST) - Output: -\*======================================================================*/ - - function _httprequest($url,$fp,$URI,$http_method,$content_type="",$body="") - { - if($this->passcookies && $this->_redirectaddr) - $this->setcookies(); - - $URI_PARTS = parse_url($URI); - if(empty($url)) - $url = "/"; - $headers = $http_method." ".$url." ".$this->_httpversion."\r\n"; - if(!empty($this->agent)) - $headers .= "User-Agent: ".$this->agent."\r\n"; - if(!empty($this->host) && !isset($this->rawheaders['Host'])) - $headers .= "Host: ".$this->host."\r\n"; - if(!empty($this->accept)) - $headers .= "Accept: ".$this->accept."\r\n"; - if(!empty($this->referer)) - $headers .= "Referer: ".$this->referer."\r\n"; - if(!empty($this->cookies)) - { - if(!is_array($this->cookies)) - $this->cookies = (array)$this->cookies; - - reset($this->cookies); - if ( count($this->cookies) > 0 ) { - $cookie_headers .= 'Cookie: '; - foreach ( $this->cookies as $cookieKey => $cookieVal ) { - $cookie_headers .= $cookieKey."=".urlencode($cookieVal)."; "; - } - $headers .= substr($cookie_headers,0,-2) . "\r\n"; - } - } - if(!empty($this->rawheaders)) - { - if(!is_array($this->rawheaders)) - $this->rawheaders = (array)$this->rawheaders; - while(list($headerKey,$headerVal) = each($this->rawheaders)) - $headers .= $headerKey.": ".$headerVal."\r\n"; - } - if(!empty($content_type)) { - $headers .= "Content-type: $content_type"; - if ($content_type == "multipart/form-data") - $headers .= "; boundary=".$this->_mime_boundary; - $headers .= "\r\n"; - } - if(!empty($body)) - $headers .= "Content-length: ".strlen($body)."\r\n"; - if(!empty($this->user) || !empty($this->pass)) - $headers .= "Authorization: BASIC ".base64_encode($this->user.":".$this->pass)."\r\n"; - - $headers .= "\r\n"; - - // set the read timeout if needed - if ($this->read_timeout > 0) - socket_set_timeout($fp, $this->read_timeout); - $this->timed_out = false; - - fwrite($fp,$headers.$body,strlen($headers.$body)); - - $this->_redirectaddr = false; - unset($this->headers); - - while($currentHeader = fgets($fp,$this->_maxlinelen)) - { - if ($this->read_timeout > 0 && $this->_check_timeout($fp)) - { - $this->status=-100; - return false; - } - - if($currentHeader == "\r\n") - break; - - // if a header begins with Location: or URI:, set the redirect - if(preg_match("/^(Location:|URI:)/i",$currentHeader)) - { - // get URL portion of the redirect - preg_match("/^(Location:|URI:)\s+(.*)/",chop($currentHeader),$matches); - // look for :// in the Location header to see if hostname is included - if(!preg_match("|\:\/\/|",$matches[2])) - { - // no host in the path, so prepend - $this->_redirectaddr = $URI_PARTS["scheme"]."://".$this->host.":".$this->port; - // eliminate double slash - if(!preg_match("|^/|",$matches[2])) - $this->_redirectaddr .= "/".$matches[2]; - else - $this->_redirectaddr .= $matches[2]; - } - else - $this->_redirectaddr = $matches[2]; - } - - if(preg_match("|^HTTP/|",$currentHeader)) - { - if(preg_match("|^HTTP/[^\s]*\s(.*?)\s|",$currentHeader, $status)) - { - $this->status= $status[1]; - } - $this->response_code = $currentHeader; - } - - $this->headers[] = $currentHeader; - } - - $results = fread($fp, $this->maxlength); - - if ($this->read_timeout > 0 && $this->_check_timeout($fp)) - { - $this->status=-100; - return false; - } - - // check if there is a a redirect meta tag - - if(preg_match("'<meta[\s]*http-equiv[^>]*?content[\s]*=[\s]*[\"\']?\d+;[\s]+URL[\s]*=[\s]*([^\"\']*?)[\"\']?>'i",$results,$match)) - { - $this->_redirectaddr = $this->_expandlinks($match[1],$URI); - } - - // have we hit our frame depth and is there frame src to fetch? - if(($this->_framedepth < $this->maxframes) && preg_match_all("'<frame\s+.*src[\s]*=[\'\"]?([^\'\"\>]+)'i",$results,$match)) - { - $this->results[] = $results; - for($x=0; $x<count($match[1]); $x++) - $this->_frameurls[] = $this->_expandlinks($match[1][$x],$URI_PARTS["scheme"]."://".$this->host); - } - // have we already fetched framed content? - elseif(is_array($this->results)) - $this->results[] = $results; - // no framed content - else - $this->results = $results; - - return true; - } - -/*======================================================================*\ - Function: _httpsrequest - Purpose: go get the https data from the server using curl - Input: $url the url to fetch - $URI the full URI - $body body contents to send if any (POST) - Output: -\*======================================================================*/ - - function _httpsrequest($url,$URI,$http_method,$content_type="",$body="") - { - if($this->passcookies && $this->_redirectaddr) - $this->setcookies(); - - $headers = array(); - - $URI_PARTS = parse_url($URI); - if(empty($url)) - $url = "/"; - // GET ... header not needed for curl - //$headers[] = $http_method." ".$url." ".$this->_httpversion; - if(!empty($this->agent)) - $headers[] = "User-Agent: ".$this->agent; - if(!empty($this->host)) - $headers[] = "Host: ".$this->host; - if(!empty($this->accept)) - $headers[] = "Accept: ".$this->accept; - if(!empty($this->referer)) - $headers[] = "Referer: ".$this->referer; - if(!empty($this->cookies)) - { - if(!is_array($this->cookies)) - $this->cookies = (array)$this->cookies; - - reset($this->cookies); - if ( count($this->cookies) > 0 ) { - $cookie_str = 'Cookie: '; - foreach ( $this->cookies as $cookieKey => $cookieVal ) { - $cookie_str .= $cookieKey."=".urlencode($cookieVal)."; "; - } - $headers[] = substr($cookie_str,0,-2); - } - } - if(!empty($this->rawheaders)) - { - if(!is_array($this->rawheaders)) - $this->rawheaders = (array)$this->rawheaders; - while(list($headerKey,$headerVal) = each($this->rawheaders)) - $headers[] = $headerKey.": ".$headerVal; - } - if(!empty($content_type)) { - if ($content_type == "multipart/form-data") - $headers[] = "Content-type: $content_type; boundary=".$this->_mime_boundary; - else - $headers[] = "Content-type: $content_type"; - } - if(!empty($body)) - $headers[] = "Content-length: ".strlen($body); - if(!empty($this->user) || !empty($this->pass)) - $headers[] = "Authorization: BASIC ".base64_encode($this->user.":".$this->pass); - - for($curr_header = 0; $curr_header < count($headers); $curr_header++) - $cmdline_params .= " -H \"".$headers[$curr_header]."\""; - - if(!empty($body)) - $cmdline_params .= " -d \"$body\""; - - if($this->read_timeout > 0) - $cmdline_params .= " -m ".$this->read_timeout; - - $headerfile = uniqid(time()); - - exec($this->curl_path." -D \"/tmp/$headerfile\"".$cmdline_params." ".$URI,$results,$return); - - if($return) - { - $this->error = "Error: cURL could not retrieve the document, error $return."; - return false; - } - - - $results = implode("\r\n",$results); - - $result_headers = file("/tmp/$headerfile"); - - $this->_redirectaddr = false; - unset($this->headers); - - for($currentHeader = 0; $currentHeader < count($result_headers); $currentHeader++) - { - - // if a header begins with Location: or URI:, set the redirect - if(preg_match("/^(Location: |URI: )/i",$result_headers[$currentHeader])) - { - // get URL portion of the redirect - preg_match("/^(Location: |URI:)(.*)/",chop($result_headers[$currentHeader]),$matches); - // look for :// in the Location header to see if hostname is included - if(!preg_match("|\:\/\/|",$matches[2])) - { - // no host in the path, so prepend - $this->_redirectaddr = $URI_PARTS["scheme"]."://".$this->host.":".$this->port; - // eliminate double slash - if(!preg_match("|^/|",$matches[2])) - $this->_redirectaddr .= "/".$matches[2]; - else - $this->_redirectaddr .= $matches[2]; - } - else - $this->_redirectaddr = $matches[2]; - } - - if(preg_match("|^HTTP/|",$result_headers[$currentHeader])) - $this->response_code = $result_headers[$currentHeader]; - - $this->headers[] = $result_headers[$currentHeader]; - } - - // check if there is a a redirect meta tag - - if(preg_match("'<meta[\s]*http-equiv[^>]*?content[\s]*=[\s]*[\"\']?\d+;[\s]+URL[\s]*=[\s]*([^\"\']*?)[\"\']?>'i",$results,$match)) - { - $this->_redirectaddr = $this->_expandlinks($match[1],$URI); - } - - // have we hit our frame depth and is there frame src to fetch? - if(($this->_framedepth < $this->maxframes) && preg_match_all("'<frame\s+.*src[\s]*=[\'\"]?([^\'\"\>]+)'i",$results,$match)) - { - $this->results[] = $results; - for($x=0; $x<count($match[1]); $x++) - $this->_frameurls[] = $this->_expandlinks($match[1][$x],$URI_PARTS["scheme"]."://".$this->host); - } - // have we already fetched framed content? - elseif(is_array($this->results)) - $this->results[] = $results; - // no framed content - else - $this->results = $results; - - unlink("/tmp/$headerfile"); - - return true; - } - -/*======================================================================*\ - Function: setcookies() - Purpose: set cookies for a redirection -\*======================================================================*/ - - function setcookies() - { - for($x=0; $x<count($this->headers); $x++) - { - if(preg_match("/^set-cookie:[\s]+([^=]+)=([^;]+)/i", $this->headers[$x],$match)) - $this->cookies[$match[1]] = $match[2]; - } - } - - -/*======================================================================*\ - Function: _check_timeout - Purpose: checks whether timeout has occurred - Input: $fp file pointer -\*======================================================================*/ - - function _check_timeout($fp) - { - if ($this->read_timeout > 0) { - $fp_status = socket_get_status($fp); - if ($fp_status["timed_out"]) { - $this->timed_out = true; - return true; - } - } - return false; - } - -/*======================================================================*\ - Function: _connect - Purpose: make a socket connection - Input: $fp file pointer -\*======================================================================*/ - - function _connect(&$fp) - { - if(!empty($this->proxy_host) && !empty($this->proxy_port)) - { - $this->_isproxy = true; - $host = $this->proxy_host; - $port = $this->proxy_port; - } - else - { - $host = $this->host; - $port = $this->port; - } - - $this->status = 0; - - if($fp = fsockopen( - $host, - $port, - $errno, - $errstr, - $this->_fp_timeout - )) - { - // socket connection succeeded - - return true; - } - else - { - // socket connection failed - $this->status = $errno; - switch($errno) - { - case -3: - $this->error="socket creation failed (-3)"; - case -4: - $this->error="dns lookup failure (-4)"; - case -5: - $this->error="connection refused or timed out (-5)"; - default: - $this->error="connection failed (".$errno.")"; - } - return false; - } - } -/*======================================================================*\ - Function: _disconnect - Purpose: disconnect a socket connection - Input: $fp file pointer -\*======================================================================*/ - - function _disconnect($fp) - { - return(fclose($fp)); - } - - -/*======================================================================*\ - Function: _prepare_post_body - Purpose: Prepare post body according to encoding type - Input: $formvars - form variables - $formfiles - form upload files - Output: post body -\*======================================================================*/ - - function _prepare_post_body($formvars, $formfiles) - { - settype($formvars, "array"); - settype($formfiles, "array"); - $postdata= ''; - if (count($formvars) == 0 && count($formfiles) == 0) - return; - - switch ($this->_submit_type) { - case "application/x-www-form-urlencoded": - reset($formvars); - while(list($key,$val) = each($formvars)) { - if (is_array($val) || is_object($val)) { - while (list($cur_key, $cur_val) = each($val)) { - $postdata .= urlencode($key)."[]=".urlencode($cur_val)."&"; - } - } else - $postdata .= urlencode($key)."=".urlencode($val)."&"; - } - break; - - case "multipart/form-data": - $this->_mime_boundary = "Snoopy".md5(uniqid(microtime())); - - reset($formvars); - while(list($key,$val) = each($formvars)) { - if (is_array($val) || is_object($val)) { - while (list($cur_key, $cur_val) = each($val)) { - $postdata .= "--".$this->_mime_boundary."\r\n"; - $postdata .= "Content-Disposition: form-data; name=\"$key\[\]\"\r\n\r\n"; - $postdata .= "$cur_val\r\n"; - } - } else { - $postdata .= "--".$this->_mime_boundary."\r\n"; - $postdata .= "Content-Disposition: form-data; name=\"$key\"\r\n\r\n"; - $postdata .= "$val\r\n"; - } - } - - reset($formfiles); - while (list($field_name, $file_names) = each($formfiles)) { - settype($file_names, "array"); - while (list(, $file_name) = each($file_names)) { - if (!is_readable($file_name)) continue; - - $fp = fopen($file_name, "r"); - $file_content = fread($fp, filesize($file_name)); - fclose($fp); - $base_name = basename($file_name); - - $postdata .= "--".$this->_mime_boundary."\r\n"; - $postdata .= "Content-Disposition: form-data; name=\"$field_name\"; filename=\"$base_name\"\r\n\r\n"; - $postdata .= "$file_content\r\n"; - } - } - $postdata .= "--".$this->_mime_boundary."--\r\n"; - break; - } - - return $postdata; - } -} - -?> diff --git a/Snoopy.readme b/Snoopy.readme deleted file mode 100644 index f65e23a..0000000 --- a/Snoopy.readme +++ /dev/null @@ -1,261 +0,0 @@ -NAME: - - Snoopy - the PHP net client v1.0 - -SYNOPSIS: - - include "Snoopy.class.inc"; - $snoopy = new Snoopy; - - $snoopy->fetchtext("http://www.php.net/"); - print $snoopy->results; - - $snoopy->fetchlinks("http://www.phpbuilder.com/"); - print $snoopy->results; - - $submit_url = "http://lnk.ispi.net/texis/scripts/msearch/netsearch.html"; - - $submit_vars["q"] = "amiga"; - $submit_vars["submit"] = "Search!"; - $submit_vars["searchhost"] = "Altavista"; - - $snoopy->submit($submit_url,$submit_vars); - print $snoopy->results; - - $snoopy->maxframes=5; - $snoopy->fetch("http://www.ispi.net/"); - echo "<PRE>\n"; - echo htmlentities($snoopy->results[0]); - echo htmlentities($snoopy->results[1]); - echo htmlentities($snoopy->results[2]); - echo "</PRE>\n"; - - $snoopy->fetchform("http://www.altavista.com"); - print $snoopy->results; - -DESCRIPTION: - - What is Snoopy? - - Snoopy is a PHP class that simulates a web browser. It automates the - task of retrieving web page content and posting forms, for example. - - Some of Snoopy's features: - - * easily fetch the contents of a web page - * easily fetch the text from a web page (strip html tags) - * easily fetch the the links from a web page - * supports proxy hosts - * supports basic user/pass authentication - * supports setting user_agent, referer, cookies and header content - * supports browser redirects, and controlled depth of redirects - * expands fetched links to fully qualified URLs (default) - * easily submit form data and retrieve the results - * supports following html frames (added v0.92) - * supports passing cookies on redirects (added v0.92) - - -REQUIREMENTS: - - Snoopy requires PHP with PCRE (Perl Compatible Regular Expressions), - which should be PHP 3.0.9 and up. For read timeout support, it requires - PHP 4 Beta 4 or later. Snoopy was developed and tested with PHP 3.0.12. - -CLASS METHODS: - - fetch($URI) - ----------- - - This is the method used for fetching the contents of a web page. - $URI is the fully qualified URL of the page to fetch. - The results of the fetch are stored in $this->results. - If you are fetching frames, then $this->results - contains each frame fetched in an array. - - fetchtext($URI) - --------------- - - This behaves exactly like fetch() except that it only returns - the text from the page, stripping out html tags and other - irrelevant data. - - fetchform($URI) - --------------- - - This behaves exactly like fetch() except that it only returns - the form elements from the page, stripping out html tags and other - irrelevant data. - - fetchlinks($URI) - ---------------- - - This behaves exactly like fetch() except that it only returns - the links from the page. By default, relative links are - converted to their fully qualified URL form. - - submit($URI,$formvars) - ---------------------- - - This submits a form to the specified $URI. $formvars is an - array of the form variables to pass. - - - submittext($URI,$formvars) - -------------------------- - - This behaves exactly like submit() except that it only returns - the text from the page, stripping out html tags and other - irrelevant data. - - submitlinks($URI) - ---------------- - - This behaves exactly like submit() except that it only returns - the links from the page. By default, relative links are - converted to their fully qualified URL form. - - -CLASS VARIABLES: (default value in parenthesis) - - $host the host to connect to - $port the port to connect to - $proxy_host the proxy host to use, if any - $proxy_port the proxy port to use, if any - $agent the user agent to masqerade as (Snoopy v0.1) - $referer referer information to pass, if any - $cookies cookies pass if any - $rawheaders any other header info to pass, if any - $maxredirs maximum redirects to allow. 0=none allowed. (5) - $offsiteok whether or not to allow redirects off-site. (true) - $expandlinks whether or not to expand links to fully qualified URLs (true) - $user authentication username, if any - $pass authentication password, if any - $accept http accept types (image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, */*) - $error where errors are sent, if any - $response_code responde code returned from server - $headers headers returned from server - $maxlength max return data length - $read_timeout timeout on read operations (requires PHP 4 Beta 4+) - set to 0 to disallow timeouts - $timed_out true if a read operation timed out (requires PHP 4 Beta 4+) - $maxframes number of frames we will follow - $status http status of fetch - $curl_path system path to cURL binary, set to false if none - - -EXAMPLES: - - Example: fetch a web page and display the return headers and - the contents of the page (html-escaped): - - include "Snoopy.class.inc"; - $snoopy = new Snoopy; - - $snoopy->user = "joe"; - $snoopy->pass = "bloe"; - - if($snoopy->fetch("http://www.slashdot.org/")) - { - echo "response code: ".$snoopy->response_code."<br>\n"; - while(list($key,$val) = each($snoopy->headers)) - echo $key.": ".$val."<br>\n"; - echo "<p>\n"; - - echo "<PRE>".htmlspecialchars($snoopy->results)."</PRE>\n"; - } - else - echo "error fetching document: ".$snoopy->error."\n"; - - - - Example: submit a form and print out the result headers - and html-escaped page: - - include "Snoopy.class.inc"; - $snoopy = new Snoopy; - - $submit_url = "http://lnk.ispi.net/texis/scripts/msearch/netsearch.html"; - - $submit_vars["q"] = "amiga"; - $submit_vars["submit"] = "Search!"; - $submit_vars["searchhost"] = "Altavista"; - - - if($snoopy->submit($submit_url,$submit_vars)) - { - while(list($key,$val) = each($snoopy->headers)) - echo $key.": ".$val."<br>\n"; - echo "<p>\n"; - - echo "<PRE>".htmlspecialchars($snoopy->results)."</PRE>\n"; - } - else - echo "error fetching document: ".$snoopy->error."\n"; - - - - Example: showing functionality of all the variables: - - - include "Snoopy.class.inc"; - $snoopy = new Snoopy; - - $snoopy->proxy_host = "my.proxy.host"; - $snoopy->proxy_port = "8080"; - - $snoopy->agent = "(compatible; MSIE 4.01; MSN 2.5; AOL 4.0; Windows 98)"; - $snoopy->referer = "http://www.microsnot.com/"; - - $snoopy->cookies["SessionID"] = 238472834723489l; - $snoopy->cookies["favoriteColor"] = "RED"; - - $snoopy->rawheaders["Pragma"] = "no-cache"; - - $snoopy->maxredirs = 2; - $snoopy->offsiteok = false; - $snoopy->expandlinks = false; - - $snoopy->user = "joe"; - $snoopy->pass = "bloe"; - - if($snoopy->fetchtext("http://www.phpbuilder.com")) - { - while(list($key,$val) = each($snoopy->headers)) - echo $key.": ".$val."<br>\n"; - echo "<p>\n"; - - echo "<PRE>".htmlspecialchars($snoopy->results)."</PRE>\n"; - } - else - echo "error fetching document: ".$snoopy->error."\n"; - - - Example: fetched framed content and display the results - - include "Snoopy.class.inc"; - $snoopy = new Snoopy; - - $snoopy->maxframes = 5; - - if($snoopy->fetch("http://www.ispi.net/")) - { - echo "<PRE>".htmlspecialchars($snoopy->results[0])."</PRE>\n"; - echo "<PRE>".htmlspecialchars($snoopy->results[1])."</PRE>\n"; - echo "<PRE>".htmlspecialchars($snoopy->results[2])."</PRE>\n"; - } - else - echo "error fetching document: ".$snoopy->error."\n"; - - -COPYRIGHT: - Copyright(c) 1999,2000 ispi. All rights reserved. - This software is released under the GNU General Public License. - Please read the disclaimer at the top of the Snoopy.class.inc file. - - -THANKS: - Special Thanks to: - Peter Sorger <sorgo@cool.sk> help fixing a redirect bug - Andrei Zmievski <andrei@ispi.net> implementing time out functionality - Patric Sandelin <patric@kajen.com> help with fetchform debugging - Carmelo <carmelo@meltingsoft.com> misc bug fixes with frames diff --git a/includes/BrowserDetection.php b/includes/BrowserDetection.php new file mode 100644 index 0000000..d2f33d3 --- /dev/null +++ b/includes/BrowserDetection.php @@ -0,0 +1,2106 @@ +<?php + +/** + * Browser detection class file. + * This file contains everything required to use the BrowserDetection class. Tested with PHP 5.3.29 - 7.2.4. + * + * This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General + * Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any + * later version (if any). + * + * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied + * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more + * details at: http://www.gnu.org/licenses/lgpl.html + * + * @package Browser_Detection + * @version 2.9.0 + * @last-modified July 15, 2018 + * @author Alexandre Valiquette + * @copyright Copyright (c) 2018, Wolfcast + * @link https://wolfcast.com/ + */ + + +namespace Wolfcast; + + +/** + * The BrowserDetection class facilitates the identification of the user's environment such as Web browser, version, + * platform and device type. + * + * Typical usage: + * + * $browser = new Wolfcast\BrowserDetection(); + * if ($browser->getName() == Wolfcast\BrowserDetection::BROWSER_FIREFOX && + * $browser->compareVersions($browser->getVersion(), '5.0') >= 0) { + * echo 'You are using FireFox version 5 or greater.'; + * } + * + * The class is a rewrite of Chris Schuld's Browser class version 1.9 which is mostly unmaintained since August 20th, + * 2010. Chris' class was based on the original work from Gary White. + * + * Updates: + * + * 2018-07-15: Version 2.9.0 + * + WARNING! Breaking change: new Wolfcast namespace. Use new Wolfcast\BrowserDetection(). + * + iPad, iPhone and iPod are all under iOS now. + * + Added Android Oreo detection. + * + Added macOS High Sierra detection. + * + Added UC Browser detection. + * + Improved regular expressions (even less false positives). + * + Removed AOL detection. + * + Removed the following Web browsers detection: Amaya, Galeon, NetPositive, OmniWeb, Vivaldi detection (use + * addCustomBrowserDetection()). + * + Removed the following legacy platforms detection: BeOS, OS/2, SunOS (use addCustomPlatformDetection()). + * + * 2016-11-28: Version 2.5.1 + * + Better detection of 64-bit platforms. + * + * 2016-08-19: Version 2.5.0 + * + Platform version and platform version name are now supported for Mac. + * + Fixed platform version name for Android. + * + * 2016-08-02: Version 2.4.0 + * + Platform version and platform version name are now supported for Android. + * + Added support for the Samsung Internet browser. + * + Added support for the Vivaldi browser. + * + Better support for legacy Windows versions. + * + * 2016-02-11: Version 2.3.0 + * + WARNING! Breaking change: public method getBrowser() is renamed to getName(). + * + WARNING! Breaking change: changed the compareVersions() return values to be more in line with other libraries. + * + You can now get the exact platform version (name or version numbers) on which the browser is run on with + * getPlatformVersion(). Only working with Windows operating systems at the moment. + * + You can now determine if the browser is executed from a 64-bit platform with is64bitPlatform(). + * + Better detection of mobile platform for Googlebot. + * + * 2016-01-04: Version 2.2.0 + * + Added support for Microsoft Edge. + * + * 2014-12-30: Version 2.1.2 + * + Better detection of Opera. + * + * 2014-07-11: Version 2.1.1 + * + Better detection of mobile devices and platforms. + * + * 2014-06-04: Version 2.1.0 + * + Added support for IE 11+. + * + * 2013-05-27: Version 2.0.0 which is (almost) a complete rewrite based on Chris Schuld's Browser class version 1.9 plus + * changes below. + * + Added support for Opera Mobile + * + Added support for the Windows Phone (formerly Windows Mobile) platform + * + Added support for BlackBerry Tablet OS and BlackBerry 10 + * + Added support for the Symbian platform + * + Added support for Bingbot + * + Added support for the Yahoo! Multimedia crawler + * + Removed iPhone/iPad/iPod browsers since there are not browsers but platforms - test them with getPlatform() + * + Removed support for Shiretoko (Firefox 3.5 alpha/beta) and MSN Browser + * + Merged Nokia and Nokia S60 + * + Updated some deprecated browser names + * + Many public methods are now protected + * + Documentation updated + * + * 2010-07-04: + * + Added detection of IE compatibility view - test with getIECompatibilityView() + * + Added support for all (deprecated) Netscape versions + * + Added support for Safari < 3.0 + * + Better Firefox version parsing + * + Better Opera version parsing + * + Better Mozilla detection + * + * @package Browser_Detection + * @version 2.9.0 + * @last-modified July 15, 2018 + * @author Alexandre Valiquette, Chris Schuld, Gary White + * @copyright Copyright (c) 2018, Wolfcast + * @license http://www.gnu.org/licenses/lgpl.html + * @link https://wolfcast.com/ + * @link https://wolfcast.com/open-source/browser-detection/tutorial.php + * @link http://chrisschuld.com/ + * @link http://www.apptools.com/phptools/browser/ + */ +class BrowserDetection +{ + + /**#@+ + * Constant for the name of the Web browser. + */ + const BROWSER_ANDROID = 'Android'; + const BROWSER_BINGBOT = 'Bingbot'; + const BROWSER_BLACKBERRY = 'BlackBerry'; + const BROWSER_CHROME = 'Chrome'; + const BROWSER_EDGE = 'Edge'; + const BROWSER_FIREBIRD = 'Firebird'; + const BROWSER_FIREFOX = 'Firefox'; + const BROWSER_GOOGLEBOT = 'Googlebot'; + const BROWSER_ICAB = 'iCab'; + const BROWSER_ICECAT = 'GNU IceCat'; + const BROWSER_ICEWEASEL = 'GNU IceWeasel'; + const BROWSER_IE = 'Internet Explorer'; + const BROWSER_IE_MOBILE = 'Internet Explorer Mobile'; + const BROWSER_KONQUEROR = 'Konqueror'; + const BROWSER_LYNX = 'Lynx'; + const BROWSER_MOZILLA = 'Mozilla'; + const BROWSER_MSNBOT = 'MSNBot'; + const BROWSER_MSNTV = 'MSN TV'; + const BROWSER_NETSCAPE = 'Netscape'; + const BROWSER_NOKIA = 'Nokia Browser'; + const BROWSER_OPERA = 'Opera'; + const BROWSER_OPERA_MINI = 'Opera Mini'; + const BROWSER_OPERA_MOBILE = 'Opera Mobile'; + const BROWSER_PHOENIX = 'Phoenix'; + const BROWSER_SAFARI = 'Safari'; + const BROWSER_SAMSUNG = 'Samsung Internet'; + const BROWSER_SLURP = 'Yahoo! Slurp'; + const BROWSER_TABLET_OS = 'BlackBerry Tablet OS'; + const BROWSER_UC = 'UC Browser'; + const BROWSER_UNKNOWN = 'unknown'; + const BROWSER_W3CVALIDATOR = 'W3C Validator'; + const BROWSER_YAHOO_MM = 'Yahoo! Multimedia'; + /**#@-*/ + + /**#@+ + * Constant for the name of the platform on which the Web browser runs. + */ + const PLATFORM_ANDROID = 'Android'; + const PLATFORM_BLACKBERRY = 'BlackBerry'; + const PLATFORM_FREEBSD = 'FreeBSD'; + const PLATFORM_IOS = 'iOS'; + const PLATFORM_LINUX = 'Linux'; + const PLATFORM_MACINTOSH = 'Macintosh'; + const PLATFORM_NETBSD = 'NetBSD'; + const PLATFORM_NOKIA = 'Nokia'; + const PLATFORM_OPENBSD = 'OpenBSD'; + const PLATFORM_OPENSOLARIS = 'OpenSolaris'; + const PLATFORM_SYMBIAN = 'Symbian'; + const PLATFORM_UNKNOWN = 'unknown'; + const PLATFORM_VERSION_UNKNOWN = 'unknown'; + const PLATFORM_WINDOWS = 'Windows'; + const PLATFORM_WINDOWS_CE = 'Windows CE'; + const PLATFORM_WINDOWS_PHONE = 'Windows Phone'; + /**#@-*/ + + /** + * Version unknown constant. + */ + const VERSION_UNKNOWN = 'unknown'; + + + /** + * @var string + * @access private + */ + private $_agent = ''; + + /** + * @var string + * @access private + */ + private $_browserName = ''; + + /** + * @var string + * @access private + */ + private $_compatibilityViewName = ''; + + /** + * @var string + * @access private + */ + private $_compatibilityViewVer = ''; + + /** + * @var array + * @access private + */ + private $_customBrowserDetection = array(); + + /** + * @var array + * @access private + */ + private $_customPlatformDetection = array(); + + /** + * @var boolean + * @access private + */ + private $_is64bit = false; + + /** + * @var boolean + * @access private + */ + private $_isMobile = false; + + /** + * @var boolean + * @access private + */ + private $_isRobot = false; + + /** + * @var string + * @access private + */ + private $_platform = ''; + + /** + * @var string + * @access private + */ + private $_platformVersion = ''; + + /** + * @var string + * @access private + */ + private $_version = ''; + + + //--- MAGIC METHODS ------------------------------------------------------------------------------------------------ + + + /** + * BrowserDetection class constructor. + * @param string $useragent (optional) The user agent to work with. Leave empty for the current user agent + * (contained in $_SERVER['HTTP_USER_AGENT']). + */ + public function __construct($useragent = '') + { + $this->setUserAgent($useragent); + } + + /** + * Determine how the class will react when it is treated like a string. + * @return string Returns an HTML formatted string with a summary of the browser informations. + */ + public function __toString() + { + $result = ''; + + $values = array(); + $values[] = array('label' => 'User agent', 'value' => $this->getUserAgent()); + $values[] = array('label' => 'Browser name', 'value' => $this->getName()); + $values[] = array('label' => 'Browser version', 'value' => $this->getVersion()); + $values[] = array('label' => 'Platform family', 'value' => $this->getPlatform()); + $values[] = array('label' => 'Platform version', 'value' => $this->getPlatformVersion(true)); + $values[] = array('label' => 'Platform version name', 'value' => $this->getPlatformVersion()); + $values[] = array('label' => 'Platform is 64-bit', 'value' => $this->is64bitPlatform() ? 'true' : 'false'); + $values[] = array('label' => 'Is mobile', 'value' => $this->isMobile() ? 'true' : 'false'); + $values[] = array('label' => 'Is robot', 'value' => $this->isRobot() ? 'true' : 'false'); + $values[] = array('label' => 'IE is in compatibility view', 'value' => $this->isInIECompatibilityView() ? 'true' : 'false'); + $values[] = array('label' => 'Emulated IE version', 'value' => $this->isInIECompatibilityView() ? $this->getIECompatibilityView() : 'Not applicable'); + $values[] = array('label' => 'Is Chrome Frame', 'value' => $this->isChromeFrame() ? 'true' : 'false'); + + foreach ($values as $currVal) { + $result .= '<strong>' . htmlspecialchars($currVal['label'], ENT_NOQUOTES) . ':</strong> ' . $currVal['value'] . '<br />' . PHP_EOL; + } + + return $result; + } + + + //--- PUBLIC MEMBERS ----------------------------------------------------------------------------------------------- + + + /** + * Dynamically add support for a new Web browser. + * @param string $browserName The Web browser name (used for display). + * @param mixed $uaNameToLookFor (optional) The string (or array of strings) representing the browser name to find + * in the user agent. If omitted, $browserName will be used. + * @param boolean $isMobile (optional) Determines if the browser is from a mobile device. + * @param boolean $isRobot (optional) Determines if the browser is a robot or not. + * @param string $separator (optional) The separator string used to split the browser name and the version number in + * the user agent. + * @param boolean $uaNameFindWords (optional) Determines if the browser name to find should match a word instead of + * a part of a word. For example "Bar" would not be found in "FooBar" when true but would be found in "Foo Bar". + * When set to false, the browser name can be found anywhere in the user agent string. + * @see removeCustomBrowserDetection() + * @return boolean Returns true if the custom rule has been added, false otherwise. + */ + public function addCustomBrowserDetection($browserName, $uaNameToLookFor = '', $isMobile = false, $isRobot = false, $separator = '/', $uaNameFindWords = true) + { + if ($browserName == '') { + return false; + } + if (array_key_exists($browserName, $this->_customBrowserDetection)) { + unset($this->_customBrowserDetection[$browserName]); + } + if ($uaNameToLookFor == '') { + $uaNameToLookFor = $browserName; + } + $this->_customBrowserDetection[$browserName] = array('uaNameToLookFor' => $uaNameToLookFor, 'isMobile' => $isMobile == true, 'isRobot' => $isRobot == true, + 'separator' => $separator, 'uaNameFindWords' => $uaNameFindWords == true); + return true; + } + + /** + * Dynamically add support for a new platform. + * @param string $platformName The platform name (used for display). + * @param mixed $platformNameToLookFor (optional) The string (or array of strings) representing the platform name to + * find in the user agent. If omitted, $platformName will be used. + * @param boolean $isMobile (optional) Determines if the platform is from a mobile device. + * @see removeCustomPlatformDetection() + * @return boolean Returns true if the custom rule has been added, false otherwise. + */ + public function addCustomPlatformDetection($platformName, $platformNameToLookFor = '', $isMobile = false) + { + if ($platformName == '') { + return false; + } + if (array_key_exists($platformName, $this->_customPlatformDetection)) { + unset($this->_customPlatformDetection[$platformName]); + } + if ($platformNameToLookFor == '') { + $platformNameToLookFor = $platformName; + } + $this->_customPlatformDetection[$platformName] = array('platformNameToLookFor' => $platformNameToLookFor, 'isMobile' => $isMobile == true); + return true; + } + + /** + * Compare two version number strings. + * @param string $sourceVer The source version number. + * @param string $compareVer The version number to compare with the source version number. + * @return int Returns -1 if $sourceVer < $compareVer, 0 if $sourceVer == $compareVer or 1 if $sourceVer > + * $compareVer. + */ + public function compareVersions($sourceVer, $compareVer) + { + $sourceVer = explode('.', $sourceVer); + foreach ($sourceVer as $k => $v) { + $sourceVer[$k] = $this->parseInt($v); + } + + $compareVer = explode('.', $compareVer); + foreach ($compareVer as $k => $v) { + $compareVer[$k] = $this->parseInt($v); + } + + if (count($sourceVer) != count($compareVer)) { + if (count($sourceVer) > count($compareVer)) { + for ($i = count($compareVer); $i < count($sourceVer); $i++) { + $compareVer[$i] = 0; + } + } else { + for ($i = count($sourceVer); $i < count($compareVer); $i++) { + $sourceVer[$i] = 0; + } + } + } + + foreach ($sourceVer as $i => $srcVerPart) { + if ($srcVerPart > $compareVer[$i]) { + return 1; + } else { + if ($srcVerPart < $compareVer[$i]) { + return -1; + } + } + } + + return 0; + } + + /** + * Get the name of the browser. All of the return values are class constants. You can compare them like this: + * $myBrowserInstance->getName() == BrowserDetection::BROWSER_FIREFOX. + * @return string Returns the name of the browser. + */ + public function getName() + { + return $this->_browserName; + } + + /** + * Get the name and version of the browser emulated in the compatibility view mode (if any). Since Internet + * Explorer 8, IE can be put in compatibility mode to make websites that were created for older browsers, especially + * IE 6 and 7, look better in IE 8+ which renders web pages closer to the standards and thus differently from those + * older versions of IE. + * @param boolean $asArray (optional) Determines if the return value must be an array (true) or a string (false). + * @return mixed If a string was requested, the function returns the name and version of the browser emulated in + * the compatibility view mode or an empty string if the browser is not in compatibility view mode. If an array was + * requested, an array with the keys 'browser' and 'version' is returned. + */ + public function getIECompatibilityView($asArray = false) + { + if ($asArray) { + return array('browser' => $this->_compatibilityViewName, 'version' => $this->_compatibilityViewVer); + } else { + return trim($this->_compatibilityViewName . ' ' . $this->_compatibilityViewVer); + } + } + + /** + * Return the BrowserDetection class version. + * @return string Returns the version as a sting with the #.#.# format. + */ + public function getLibVersion() + { + return '2.9.0'; + } + + /** + * Get the name of the platform family on which the browser is run on (such as Windows, Apple, etc.). All of + * the return values are class constants. You can compare them like this: + * $myBrowserInstance->getPlatform() == BrowserDetection::PLATFORM_ANDROID. + * @return string Returns the name of the platform or BrowserDetection::PLATFORM_UNKNOWN if unknown. + */ + public function getPlatform() + { + return $this->_platform; + } + + /** + * Get the platform version on which the browser is run on. It can be returned as a string number like 'NT 6.3' or + * as a name like 'Windows 8.1'. When returning version string numbers for Windows NT OS families the number is + * prefixed by 'NT ' to differentiate from older Windows 3.x & 9x release. At the moment only the Windows and + * Android operating systems are supported. + * @param boolean $returnVersionNumbers (optional) Determines if the return value must be versions numbers as a + * string (true) or the version name (false). + * @param boolean $returnServerFlavor (optional) Since some Windows NT versions have the same values, this flag + * determines if the Server flavor is returned or not. For instance Windows 8.1 and Windows Server 2012 R2 both use + * version 6.3. This parameter is only useful when testing for Windows. + * @return string Returns the version name/version numbers of the platform or the constant PLATFORM_VERSION_UNKNOWN + * if unknown. + */ + public function getPlatformVersion($returnVersionNumbers = false, $returnServerFlavor = false) + { + if ($this->_platformVersion == self::PLATFORM_VERSION_UNKNOWN || $this->_platformVersion == '') { + return self::PLATFORM_VERSION_UNKNOWN; + } + + if ($returnVersionNumbers) { + return $this->_platformVersion; + } else { + switch ($this->getPlatform()) { + case self::PLATFORM_WINDOWS: + if (substr($this->_platformVersion, 0, 3) == 'NT ') { + return $this->windowsNTVerToStr(substr($this->_platformVersion, 3), $returnServerFlavor); + } else { + return $this->windowsVerToStr($this->_platformVersion); + } + break; + + case self::PLATFORM_MACINTOSH: + return $this->macVerToStr($this->_platformVersion); + break; + + case self::PLATFORM_ANDROID: + return $this->androidVerToStr($this->_platformVersion); + break; + + case self::PLATFORM_IOS: + return $this->iOSVerToStr($this->_platformVersion); + break; + + default: return self::PLATFORM_VERSION_UNKNOWN; + } + } + } + + /** + * Get the user agent value used by the class to determine the browser details. + * @return string The user agent string. + */ + public function getUserAgent() + { + return $this->_agent; + } + + /** + * Get the version of the browser. + * @return string Returns the version of the browser or BrowserDetection::VERSION_UNKNOWN if unknown. + */ + public function getVersion() + { + return $this->_version; + } + + /** + * Determine if the browser is executed from a 64-bit platform. Keep in mind that not all platforms/browsers report + * this and the result may not always be accurate. + * @return boolean Returns true if the browser is executed from a 64-bit platform. + */ + public function is64bitPlatform() + { + return $this->_is64bit; + } + + /** + * Determine if the browser runs Google Chrome Frame (it's a plug-in designed for Internet Explorer 6+ based on the + * open-source Chromium project - it's like a Chrome browser within IE). + * @return boolean Returns true if the browser is using Google Chrome Frame, false otherwise. + */ + public function isChromeFrame() + { + return $this->containString($this->_agent, 'chromeframe'); + } + + /** + * Determine if the browser is in compatibility view or not. Since Internet Explorer 8, IE can be put in + * compatibility mode to make websites that were created for older browsers, especially IE 6 and 7, look better in + * IE 8+ which renders web pages closer to the standards and thus differently from those older versions of IE. + * @return boolean Returns true if the browser is in compatibility view, false otherwise. + */ + public function isInIECompatibilityView() + { + return ($this->_compatibilityViewName != '') || ($this->_compatibilityViewVer != ''); + } + + /** + * Determine if the browser is from a mobile device or not. + * @return boolean Returns true if the browser is from a mobile device, false otherwise. + */ + public function isMobile() + { + return $this->_isMobile; + } + + /** + * Determine if the browser is a robot (Googlebot, Bingbot, Yahoo! Slurp...) or not. + * @return boolean Returns true if the browser is a robot, false otherwise. + */ + public function isRobot() + { + return $this->_isRobot; + } + + /** + * Remove support for a previously added Web browser. + * @param string $browserName The Web browser name as used when added. + * @see addCustomBrowserDetection() + * @return boolean Returns true if the custom rule has been found and removed, false otherwise. + */ + public function removeCustomBrowserDetection($browserName) + { + if (array_key_exists($browserName, $this->_customBrowserDetection)) { + unset($this->_customBrowserDetection[$browserName]); + return true; + } + + return false; + } + + /** + * Remove support for a previously added platform. + * @param string $platformName The platform name as used when added. + * @see addCustomPlatformDetection() + * @return boolean Returns true if the custom rule has been found and removed, false otherwise. + */ + public function removeCustomPlatformDetection($platformName) + { + if (array_key_exists($platformName, $this->_customPlatformDetection)) { + unset($this->_customPlatformDetection[$platformName]); + return true; + } + + return false; + } + + /** + * Set the user agent to use with the class. + * @param string $agentString (optional) The value of the user agent. If an empty string is sent (default), + * $_SERVER['HTTP_USER_AGENT'] will be used. + */ + public function setUserAgent($agentString = '') + { + if (!is_string($agentString) || trim($agentString) == '') { + if (array_key_exists('HTTP_USER_AGENT', $_SERVER) && is_string($_SERVER['HTTP_USER_AGENT'])) { + $agentString = $_SERVER['HTTP_USER_AGENT']; + } else { + $agentString = ''; + } + } + + $this->reset(); + $this->_agent = $agentString; + $this->detect(); + } + + + //--- PROTECTED MEMBERS -------------------------------------------------------------------------------------------- + + + /** + * Convert the Android version numbers to the operating system name. For instance '1.6' returns 'Donut'. + * @access protected + * @param string $androidVer The Android version numbers as a string. + * @return string The operating system name or the constant PLATFORM_VERSION_UNKNOWN if nothing match the version + * numbers. + */ + protected function androidVerToStr($androidVer) + { + //https://en.wikipedia.org/wiki/Android_version_history + + if ($this->compareVersions($androidVer, '8') >= 0 && $this->compareVersions($androidVer, '9') < 0) { + return 'Oreo'; + } else if ($this->compareVersions($androidVer, '7') >= 0 && $this->compareVersions($androidVer, '8') < 0) { + return 'Nougat'; + } else if ($this->compareVersions($androidVer, '6') >= 0 && $this->compareVersions($androidVer, '7') < 0) { + return 'Marshmallow'; + } else if ($this->compareVersions($androidVer, '5') >= 0 && $this->compareVersions($androidVer, '6') < 0) { + return 'Lollipop'; + } else if ($this->compareVersions($androidVer, '4.4') >= 0 && $this->compareVersions($androidVer, '5') < 0) { + return 'KitKat'; + } else if ($this->compareVersions($androidVer, '4.1') >= 0 && $this->compareVersions($androidVer, '4.4') < 0) { + return 'Jelly Bean'; + } else if ($this->compareVersions($androidVer, '4') >= 0 && $this->compareVersions($androidVer, '4.1') < 0) { + return 'Ice Cream Sandwich'; + } else if ($this->compareVersions($androidVer, '3') >= 0 && $this->compareVersions($androidVer, '4') < 0) { + return 'Honeycomb'; + } else if ($this->compareVersions($androidVer, '2.3') >= 0 && $this->compareVersions($androidVer, '3') < 0) { + return 'Gingerbread'; + } else if ($this->compareVersions($androidVer, '2.2') >= 0 && $this->compareVersions($androidVer, '2.3') < 0) { + return 'Froyo'; + } else if ($this->compareVersions($androidVer, '2') >= 0 && $this->compareVersions($androidVer, '2.2') < 0) { + return 'Eclair'; + } else if ($this->compareVersions($androidVer, '1.6') >= 0 && $this->compareVersions($androidVer, '2') < 0) { + return 'Donut'; + } else if ($this->compareVersions($androidVer, '1.5') >= 0 && $this->compareVersions($androidVer, '1.6') < 0) { + return 'Cupcake'; + } else { + return self::PLATFORM_VERSION_UNKNOWN; //Unknown/unnamed Android version + } + } + + /** + * Determine if the browser is the Android browser (based on the WebKit layout engine and coupled with Chrome's + * JavaScript engine) or not. + * @access protected + * @return boolean Returns true if the browser is the Android browser, false otherwise. + */ + protected function checkBrowserAndroid() + { + //Android don't use the standard "Android/1.0", it uses "Android 1.0;" instead + return $this->checkSimpleBrowserUA('Android', $this->_agent, self::BROWSER_ANDROID, true); + } + + /** + * Determine if the browser is the Bingbot crawler or not. + * @access protected + * @link http://www.bing.com/webmaster/help/which-crawlers-does-bing-use-8c184ec0 + * @return boolean Returns true if the browser is Bingbot, false otherwise. + */ + protected function checkBrowserBingbot() + { + return $this->checkSimpleBrowserUA('bingbot', $this->_agent, self::BROWSER_BINGBOT, false, true); + } + + /** + * Determine if the browser is the BlackBerry browser or not. + * @access protected + * @link http://supportforums.blackberry.com/t5/Web-and-WebWorks-Development/How-to-detect-the-BlackBerry-Browser/ta-p/559862 + * @return boolean Returns true if the browser is the BlackBerry browser, false otherwise. + */ + protected function checkBrowserBlackBerry() + { + $found = false; + + //Tablet OS check + if ($this->checkSimpleBrowserUA('RIM Tablet OS', $this->_agent, self::BROWSER_TABLET_OS, true)) { + return true; + } + + //Version 6, 7 & 10 check (versions 8 & 9 does not exists) + if ($this->checkBrowserUAWithVersion(array('BlackBerry', 'BB10'), $this->_agent, self::BROWSER_BLACKBERRY, true)) { + if ($this->getVersion() == self::VERSION_UNKNOWN) { + $found = true; + } else { + return true; + } + } + + //Version 4.2 to 5.0 check + if ($this->checkSimpleBrowserUA('BlackBerry', $this->_agent, self::BROWSER_BLACKBERRY, true, false, '/', false)) { + if ($this->getVersion() == self::VERSION_UNKNOWN) { + $found = true; + } else { + return true; + } + } + + return $found; + } + + /** + * Determine if the browser is Chrome or not. + * @access protected + * @link http://www.google.com/chrome/ + * @return boolean Returns true if the browser is Chrome, false otherwise. + */ + protected function checkBrowserChrome() + { + return $this->checkSimpleBrowserUA('Chrome', $this->_agent, self::BROWSER_CHROME); + } + + /** + * Determine if the browser is among the custom browser rules or not. Rules are checked in the order they were + * added. + * @access protected + * @return boolean Returns true if we found the browser we were looking for in the custom rules, false otherwise. + */ + protected function checkBrowserCustom() + { + foreach ($this->_customBrowserDetection as $browserName => $customBrowser) { + $uaNameToLookFor = $customBrowser['uaNameToLookFor']; + $isMobile = $customBrowser['isMobile']; + $isRobot = $customBrowser['isRobot']; + $separator = $customBrowser['separator']; + $uaNameFindWords = $customBrowser['uaNameFindWords']; + if ($this->checkSimpleBrowserUA($uaNameToLookFor, $this->_agent, $browserName, $isMobile, $isRobot, $separator, $uaNameFindWords)) { + return true; + } + } + return false; + } + + /** + * Determine if the browser is Edge or not. + * @access protected + * @return boolean Returns true if the browser is Edge, false otherwise. + */ + protected function checkBrowserEdge() + { + return $this->checkSimpleBrowserUA('Edge', $this->_agent, self::BROWSER_EDGE); + } + + /** + * Determine if the browser is Firebird or not. Firebird was the name of Firefox from version 0.6 to 0.7.1. + * @access protected + * @return boolean Returns true if the browser is Firebird, false otherwise. + */ + protected function checkBrowserFirebird() + { + return $this->checkSimpleBrowserUA('Firebird', $this->_agent, self::BROWSER_FIREBIRD); + } + + /** + * Determine if the browser is Firefox or not. + * @access protected + * @link http://www.mozilla.org/en-US/firefox/new/ + * @return boolean Returns true if the browser is Firefox, false otherwise. + */ + protected function checkBrowserFirefox() + { + //Safari heavily matches with Firefox, ensure that Safari is filtered out... + if (preg_match('/.*Firefox[ (\/]*([a-z0-9.-]*)/i', $this->_agent, $matches) && + !$this->containString($this->_agent, 'Safari')) { + $this->setBrowser(self::BROWSER_FIREFOX); + $this->setVersion($matches[1]); + $this->setMobile(false); + $this->setRobot(false); + + return true; + } + + return false; + } + + /** + * Determine if the browser is the Googlebot crawler or not. + * @access protected + * @return boolean Returns true if the browser is Googlebot, false otherwise. + */ + protected function checkBrowserGooglebot() + { + if ($this->checkSimpleBrowserUA('Googlebot', $this->_agent, self::BROWSER_GOOGLEBOT, false, true)) { + + if ($this->containString($this->_agent, 'googlebot-mobile')) { + $this->setMobile(true); + } + + return true; + } + + return false; + } + + /** + * Determine if the browser is iCab or not. + * @access protected + * @link http://www.icab.de/ + * @return boolean Returns true if the browser is iCab, false otherwise. + */ + protected function checkBrowserIcab() + { + //Some (early) iCab versions don't use the standard "iCab/1.0", they uses "iCab 1.0;" instead + return $this->checkSimpleBrowserUA('iCab', $this->_agent, self::BROWSER_ICAB); + } + + /** + * Determine if the browser is GNU IceCat (formerly known as GNU IceWeasel) or not. + * @access protected + * @link http://www.gnu.org/software/gnuzilla/ + * @return boolean Returns true if the browser is GNU IceCat, false otherwise. + */ + protected function checkBrowserIceCat() + { + return $this->checkSimpleBrowserUA('IceCat', $this->_agent, self::BROWSER_ICECAT); + } + + /** + * Determine if the browser is GNU IceWeasel (now know as GNU IceCat) or not. + * @access protected + * @see checkBrowserIceCat() + * @return boolean Returns true if the browser is GNU IceWeasel, false otherwise. + */ + protected function checkBrowserIceWeasel() + { + return $this->checkSimpleBrowserUA('Iceweasel', $this->_agent, self::BROWSER_ICEWEASEL); + } + + /** + * Determine if the browser is Internet Explorer or not. + * @access protected + * @link http://www.microsoft.com/ie/ + * @link http://en.wikipedia.org/wiki/Internet_Explorer_Mobile + * @return boolean Returns true if the browser is Internet Explorer, false otherwise. + */ + protected function checkBrowserInternetExplorer() + { + //Test for Internet Explorer Mobile (formerly Pocket Internet Explorer) + if ($this->checkSimpleBrowserUA(array('IEMobile', 'MSPIE'), $this->_agent, self::BROWSER_IE_MOBILE, true)) { + return true; + } + + //Several browsers uses IE compatibility UAs filter these browsers out (but after testing for IE Mobile) + if ($this->containString($this->_agent, 'Opera') || $this->containString($this->_agent, array('BlackBerry', 'Nokia'), true, false)) { + return false; + } + + //Test for Internet Explorer 1 + if ($this->checkSimpleBrowserUA('Microsoft Internet Explorer', $this->_agent, self::BROWSER_IE)) { + if ($this->getVersion() == self::VERSION_UNKNOWN) { + if (preg_match('/308|425|426|474|0b1/i', $this->_agent)) { + $this->setVersion('1.5'); + } else { + $this->setVersion('1.0'); + } + } + return true; + } + + //Test for Internet Explorer 2+ + if ($this->containString($this->_agent, array('MSIE', 'Trident'))) { + $version = ''; + + if ($this->containString($this->_agent, 'Trident')) { + //Test for Internet Explorer 11+ (check the rv: string) + if ($this->containString($this->_agent, 'rv:', true, false)) { + if ($this->checkSimpleBrowserUA('Trident', $this->_agent, self::BROWSER_IE, false, false, 'rv:')) { + return true; + } + } else { + //Test for Internet Explorer 8, 9 & 10 (check the Trident string) + if (preg_match('/Trident\/([\d]+)/i', $this->_agent, $foundVersion)) { + //Trident started with version 4.0 on IE 8 + $verFromTrident = $this->parseInt($foundVersion[1]) + 4; + if ($verFromTrident >= 8) { + $version = $verFromTrident . '.0'; + } + } + } + + //If we have the IE version from Trident, we can check for the compatibility view mode + if ($version != '') { + $emulatedVer = ''; + preg_match_all('/MSIE\s*([^\s;$]+)/i', $this->_agent, $foundVersions); + foreach ($foundVersions[1] as $currVer) { + //Keep the lowest MSIE version for the emulated version (in compatibility view mode) + if ($emulatedVer == '' || $this->compareVersions($emulatedVer, $currVer) == 1) { + $emulatedVer = $currVer; + } + } + //Set the compatibility view mode if $version != $emulatedVer + if ($this->compareVersions($version, $emulatedVer) != 0) { + $this->_compatibilityViewName = self::BROWSER_IE; + $this->_compatibilityViewVer = $this->cleanVersion($emulatedVer); + } + } + } + + //Test for Internet Explorer 2-7 versions if needed + if ($version == '') { + preg_match_all('/MSIE\s+([^\s;$]+)/i', $this->_agent, $foundVersions); + foreach ($foundVersions[1] as $currVer) { + //Keep the highest MSIE version + if ($version == '' || $this->compareVersions($version, $currVer) == -1) { + $version = $currVer; + } + } + } + + $this->setBrowser(self::BROWSER_IE); + $this->setVersion($version); + $this->setMobile(false); + $this->setRobot(false); + + return true; + } + + return false; + } + + /** + * Determine if the browser is Konqueror or not. + * @access protected + * @link http://www.konqueror.org/ + * @return boolean Returns true if the browser is Konqueror, false otherwise. + */ + protected function checkBrowserKonqueror() + { + return $this->checkSimpleBrowserUA('Konqueror', $this->_agent, self::BROWSER_KONQUEROR); + } + + /** + * Determine if the browser is Lynx or not. It is the oldest web browser currently in general use and development. + * It is a text-based only Web browser. + * @access protected + * @link http://en.wikipedia.org/wiki/Lynx + * @return boolean Returns true if the browser is Lynx, false otherwise. + */ + protected function checkBrowserLynx() + { + return $this->checkSimpleBrowserUA('Lynx', $this->_agent, self::BROWSER_LYNX); + } + + /** + * Determine if the browser is Mozilla or not. + * @access protected + * @return boolean Returns true if the browser is Mozilla, false otherwise. + */ + protected function checkBrowserMozilla() + { + return $this->checkSimpleBrowserUA('Mozilla', $this->_agent, self::BROWSER_MOZILLA, false, false, 'rv:'); + } + + /** + * Determine if the browser is the MSNBot crawler or not. In October 2010 it was replaced by the Bingbot robot. + * @access protected + * @see checkBrowserBingbot() + * @return boolean Returns true if the browser is MSNBot, false otherwise. + */ + protected function checkBrowserMsnBot() + { + return $this->checkSimpleBrowserUA('msnbot', $this->_agent, self::BROWSER_MSNBOT, false, true); + } + + /** + * Determine if the browser is MSN TV (formerly WebTV) or not. + * @access protected + * @link http://en.wikipedia.org/wiki/MSN_TV + * @return boolean Returns true if the browser is WebTv, false otherwise. + */ + protected function checkBrowserMsnTv() + { + return $this->checkSimpleBrowserUA('webtv', $this->_agent, self::BROWSER_MSNTV); + } + + /** + * Determine if the browser is Netscape or not. Official support for this browser ended on March 1st, 2008. + * @access protected + * @link http://en.wikipedia.org/wiki/Netscape + * @return boolean Returns true if the browser is Netscape, false otherwise. + */ + protected function checkBrowserNetscape() + { + //BlackBerry & Nokia UAs can conflict with Netscape UAs + if ($this->containString($this->_agent, array('BlackBerry', 'Nokia'), true, false)) { + return false; + } + + //Netscape v6 to v9 check + if ($this->checkSimpleBrowserUA(array('Netscape', 'Navigator', 'Netscape6'), $this->_agent, self::BROWSER_NETSCAPE)) { + return true; + } + + //Netscape v1-4 (v5 don't exists) + $found = false; + if ($this->containString($this->_agent, 'Mozilla') && !$this->containString($this->_agent, 'rv:', true, false)) { + $version = ''; + $verParts = explode('/', stristr($this->_agent, 'Mozilla')); + if (count($verParts) > 1) { + $verParts = explode(' ', $verParts[1]); + $verParts = explode('.', $verParts[0]); + + $majorVer = $this->parseInt($verParts[0]); + if ($majorVer > 0 && $majorVer < 5) { + $version = implode('.', $verParts); + $found = true; + + if (strtolower(substr($version, -4)) == '-sgi') { + $version = substr($version, 0, -4); + } else { + if (strtolower(substr($version, -4)) == 'gold') { + $version = substr($version, 0, -4) . ' Gold'; //Doubles spaces (if any) will be normalized by setVersion() + } + } + } + } + } + + if ($found) { + $this->setBrowser(self::BROWSER_NETSCAPE); + $this->setVersion($version); + $this->setMobile(false); + $this->setRobot(false); + } + + return $found; + } + + /** + * Determine if the browser is a Nokia browser or not. + * @access protected + * @link http://www.developer.nokia.com/Community/Wiki/User-Agent_headers_for_Nokia_devices + * @return boolean Returns true if the browser is a Nokia browser, false otherwise. + */ + protected function checkBrowserNokia() + { + if ($this->containString($this->_agent, array('Nokia5800', 'Nokia5530', 'Nokia5230'), true, false)) { + $this->setBrowser(self::BROWSER_NOKIA); + $this->setVersion('7.0'); + $this->setMobile(true); + $this->setRobot(false); + + return true; + } + + if ($this->checkSimpleBrowserUA(array('NokiaBrowser', 'BrowserNG', 'Series60', 'S60', 'S40OviBrowser'), $this->_agent, self::BROWSER_NOKIA, true)) { + return true; + } + + return false; + } + + /** + * Determine if the browser is Opera or not. + * @access protected + * @link http://www.opera.com/ + * @link http://www.opera.com/mini/ + * @link http://www.opera.com/mobile/ + * @link http://my.opera.com/community/openweb/idopera/ + * @return boolean Returns true if the browser is Opera, false otherwise. + */ + protected function checkBrowserOpera() + { + if ($this->checkBrowserUAWithVersion('Opera Mobi', $this->_agent, self::BROWSER_OPERA_MOBILE, true)) { + return true; + } + + if ($this->checkSimpleBrowserUA('Opera Mini', $this->_agent, self::BROWSER_OPERA_MINI, true)) { + return true; + } + + $version = ''; + $found = $this->checkBrowserUAWithVersion('Opera', $this->_agent, self::BROWSER_OPERA); + if ($found && $this->getVersion() != self::VERSION_UNKNOWN) { + $version = $this->getVersion(); + } + + if (!$found || $version == '') { + if ($this->checkSimpleBrowserUA('Opera', $this->_agent, self::BROWSER_OPERA)) { + return true; + } + } + + if (!$found && $this->checkSimpleBrowserUA('Chrome', $this->_agent, self::BROWSER_CHROME) ) { + if ($this->checkSimpleBrowserUA('OPR/', $this->_agent, self::BROWSER_OPERA)) { + return true; + } + } + + return $found; + } + + /** + * Determine if the browser is Phoenix or not. Phoenix was the name of Firefox from version 0.1 to 0.5. + * @access protected + * @return boolean Returns true if the browser is Phoenix, false otherwise. + */ + protected function checkBrowserPhoenix() + { + return $this->checkSimpleBrowserUA('Phoenix', $this->_agent, self::BROWSER_PHOENIX); + } + + /** + * Determine what is the browser used by the user. + * @access protected + * @return boolean Returns true if the browser has been identified, false otherwise. + */ + protected function checkBrowsers() + { + //Changing the check order can break the class detection results! + return + /* Major browsers and browsers that need to be detected in a special order */ + $this->checkBrowserCustom() || /* Customs rules are always checked first */ + $this->checkBrowserMsnTv() || /* MSN TV is based on IE so we must check for MSN TV before IE */ + $this->checkBrowserInternetExplorer() || + $this->checkBrowserOpera() || /* Opera must be checked before Firefox, Netscape and Chrome to avoid conflicts */ + $this->checkBrowserEdge() || /* Edge must be checked before Firefox, Safari and Chrome to avoid conflicts */ + $this->checkBrowserSamsung() || /* Samsung Internet browser must be checked before Chrome and Safari to avoid conflicts */ + $this->checkBrowserUC() || /* UC Browser must be checked before Chrome and Safari to avoid conflicts */ + $this->checkBrowserChrome() || /* Chrome must be checked before Netscaoe and Mozilla to avoid conflicts */ + $this->checkBrowserIcab() || /* Check iCab before Netscape since iCab have Mozilla UAs */ + $this->checkBrowserNetscape() || /* Must be checked before Firefox since Netscape 8-9 are based on Firefox */ + $this->checkBrowserIceCat() || /* Check IceCat and IceWeasel before Firefox since they are GNU builds of Firefox */ + $this->checkBrowserIceWeasel() || + $this->checkBrowserFirefox() || + /* Current browsers that don't need to be detected in any special order */ + $this->checkBrowserKonqueror() || + $this->checkBrowserLynx() || + /* Mobile */ + $this->checkBrowserAndroid() || + $this->checkBrowserBlackBerry() || + $this->checkBrowserNokia() || + /* Bots */ + $this->checkBrowserGooglebot() || + $this->checkBrowserBingbot() || + $this->checkBrowserMsnBot() || + $this->checkBrowserSlurp() || + $this->checkBrowserYahooMultimedia() || + $this->checkBrowserW3CValidator() || + /* WebKit base check (after most other checks) */ + $this->checkBrowserSafari() || + /* Deprecated browsers that don't need to be detected in any special order */ + $this->checkBrowserFirebird() || + $this->checkBrowserPhoenix() || + /* Mozilla is such an open standard that it must be checked last */ + $this->checkBrowserMozilla(); + } + + /** + * Determine if the browser is Safari or not. + * @access protected + * @link http://www.apple.com/safari/ + * @link http://web.archive.org/web/20080514173941/http://developer.apple.com/internet/safari/uamatrix.html + * @link http://en.wikipedia.org/wiki/Safari_version_history#Release_history + * @return boolean Returns true if the browser is Safari, false otherwise. + */ + protected function checkBrowserSafari() + { + $version = ''; + + //Check for current versions of Safari + $found = $this->checkBrowserUAWithVersion(array('Safari', 'AppleWebKit'), $this->_agent, self::BROWSER_SAFARI); + if ($found && $this->getVersion() != self::VERSION_UNKNOWN) { + $version = $this->getVersion(); + } + + //Safari 1-2 didn't had a "Version" string in the UA, only a WebKit build and/or Safari build, extract version from these... + if (!$found || $version == '') { + if (preg_match('/.*Safari[ (\/]*([a-z0-9.-]*)/i', $this->_agent, $matches)) { + $version = $this->safariBuildToSafariVer($matches[1]); + $found = true; + } + } + if (!$found || $version == '') { + if (preg_match('/.*AppleWebKit[ (\/]*([a-z0-9.-]*)/i', $this->_agent, $matches)) { + $version = $this->webKitBuildToSafariVer($matches[1]); + $found = true; + } + } + + if ($found) { + $this->setBrowser(self::BROWSER_SAFARI); + $this->setVersion($version); + $this->setMobile(false); + $this->setRobot(false); + } + + return $found; + } + + /** + * Determine if the browser is the Samsung Internet browser or not. + * @access protected + * @return boolean Returns true if the browser is the the Samsung Internet browser, false otherwise. + */ + protected function checkBrowserSamsung() + { + return $this->checkSimpleBrowserUA('SamsungBrowser', $this->_agent, self::BROWSER_SAMSUNG, true); + } + + /** + * Determine if the browser is the Yahoo! Slurp crawler or not. + * @access protected + * @return boolean Returns true if the browser is Yahoo! Slurp, false otherwise. + */ + protected function checkBrowserSlurp() + { + return $this->checkSimpleBrowserUA('Yahoo! Slurp', $this->_agent, self::BROWSER_SLURP, false, true); + } + + /** + * Test the user agent for a specific browser that use a "Version" string (like Safari and Opera). The user agent + * should look like: "Version/1.0 Browser name/123.456" or "Browser name/123.456 Version/1.0". + * @access protected + * @param mixed $uaNameToLookFor The string (or array of strings) representing the browser name to find in the user + * agent. + * @param string $userAgent The user agent string to work with. + * @param string $browserName The literal browser name. Always use a class constant! + * @param boolean $isMobile (optional) Determines if the browser is from a mobile device. + * @param boolean $isRobot (optional) Determines if the browser is a robot or not. + * @param boolean $findWords (optional) Determines if the needle should match a word to be found. For example "Bar" + * would not be found in "FooBar" when true but would be found in "Foo Bar". When set to false, the needle can be + * found anywhere in the haystack. + * @return boolean Returns true if we found the browser we were looking for, false otherwise. + */ + protected function checkBrowserUAWithVersion($uaNameToLookFor, $userAgent, $browserName, $isMobile = false, $isRobot = false, $findWords = true) + { + if (!is_array($uaNameToLookFor)) { + $uaNameToLookFor = array($uaNameToLookFor); + } + + foreach ($uaNameToLookFor as $currUANameToLookFor) { + if ($this->containString($userAgent, $currUANameToLookFor, true, $findWords)) { + $version = ''; + $verParts = explode('/', stristr($this->_agent, 'Version')); + if (count($verParts) > 1) { + $verParts = explode(' ', $verParts[1]); + $version = $verParts[0]; + } + + $this->setBrowser($browserName); + $this->setVersion($version); + + $this->setMobile($isMobile); + $this->setRobot($isRobot); + + return true; + } + } + + return false; + } + + /** + * Determine if the browser is UC Browser or not. + * @access protected + * @return boolean Returns true if the browser is UC Browser, false otherwise. + */ + protected function checkBrowserUC() + { + return $this->checkSimpleBrowserUA('UCBrowser', $this->_agent, self::BROWSER_UC, true, false); + } + + /** + * Determine if the browser is the W3C Validator or not. + * @access protected + * @link http://validator.w3.org/ + * @return boolean Returns true if the browser is the W3C Validator, false otherwise. + */ + protected function checkBrowserW3CValidator() + { + //Since the W3C validates pages with different robots we will prefix our versions with the part validated on the page... + + //W3C Link Checker (prefixed with "Link-") + if ($this->checkSimpleBrowserUA('W3C-checklink', $this->_agent, self::BROWSER_W3CVALIDATOR, false, true)) { + if ($this->getVersion() != self::VERSION_UNKNOWN) { + $this->setVersion('Link-' . $this->getVersion()); + } + return true; + } + + //W3C CSS Validation Service (prefixed with "CSS-") + if ($this->checkSimpleBrowserUA('Jigsaw', $this->_agent, self::BROWSER_W3CVALIDATOR, false, true)) { + if ($this->getVersion() != self::VERSION_UNKNOWN) { + $this->setVersion('CSS-' . $this->getVersion()); + } + return true; + } + + //W3C mobileOK Checker (prefixed with "mobileOK-") + if ($this->checkSimpleBrowserUA('W3C-mobileOK', $this->_agent, self::BROWSER_W3CVALIDATOR, false, true)) { + if ($this->getVersion() != self::VERSION_UNKNOWN) { + $this->setVersion('mobileOK-' . $this->getVersion()); + } + return true; + } + + //W3C Markup Validation Service (no prefix) + return $this->checkSimpleBrowserUA('W3C_Validator', $this->_agent, self::BROWSER_W3CVALIDATOR, false, true); + } + + /** + * Determine if the browser is the Yahoo! multimedia crawler or not. + * @access protected + * @return boolean Returns true if the browser is the Yahoo! multimedia crawler, false otherwise. + */ + protected function checkBrowserYahooMultimedia() + { + return $this->checkSimpleBrowserUA('Yahoo-MMCrawler', $this->_agent, self::BROWSER_YAHOO_MM, false, true); + } + + /** + * Determine the user's platform. + * @access protected + */ + protected function checkPlatform() + { + if (!$this->checkPlatformCustom()) { /* Customs rules are always checked first */ + /* Mobile platforms */ + if ($this->containString($this->_agent, array('Windows Phone', 'IEMobile'))) { /* Check Windows Phone (formerly Windows Mobile) before Windows */ + $this->setPlatform(self::PLATFORM_WINDOWS_PHONE); + $this->setMobile(true); + } else if ($this->containString($this->_agent, 'Windows CE')) { /* Check Windows CE before Windows */ + $this->setPlatform(self::PLATFORM_WINDOWS_CE); + $this->setMobile(true); + } else if ($this->containString($this->_agent, array('CPU OS', 'CPU iPhone OS', 'iPhone', 'iPad', 'iPod'))) { /* Check iOS (iPad/iPod/iPhone) before Macintosh */ + $this->setPlatform(self::PLATFORM_IOS); + $this->setMobile(true); + } else if ($this->containString($this->_agent, 'Android')) { + $this->setPlatform(self::PLATFORM_ANDROID); + $this->setMobile(true); + } else if ($this->containString($this->_agent, 'BlackBerry', true, false) || $this->containString($this->_agent, array('BB10', 'RIM Tablet OS'))) { + $this->setPlatform(self::PLATFORM_BLACKBERRY); + $this->setMobile(true); + } else if ($this->containString($this->_agent, 'Nokia', true, false)) { + $this->setPlatform(self::PLATFORM_NOKIA); + $this->setMobile(true); + + /* Desktop platforms */ + } else if ($this->containString($this->_agent, 'Windows')) { + $this->setPlatform(self::PLATFORM_WINDOWS); + } else if ($this->containString($this->_agent, 'Macintosh')) { + $this->setPlatform(self::PLATFORM_MACINTOSH); + } else if ($this->containString($this->_agent, 'Linux')) { + $this->setPlatform(self::PLATFORM_LINUX); + } else if ($this->containString($this->_agent, 'FreeBSD')) { + $this->setPlatform(self::PLATFORM_FREEBSD); + } else if ($this->containString($this->_agent, 'OpenBSD')) { + $this->setPlatform(self::PLATFORM_OPENBSD); + } else if ($this->containString($this->_agent, 'NetBSD')) { + $this->setPlatform(self::PLATFORM_NETBSD); + + /* Discontinued */ + } else if ($this->containString($this->_agent, array('Symbian', 'SymbianOS'))) { + $this->setPlatform(self::PLATFORM_SYMBIAN); + $this->setMobile(true); + } else if ($this->containString($this->_agent, 'OpenSolaris')) { + $this->setPlatform(self::PLATFORM_OPENSOLARIS); + + /* Generic */ + } else if ($this->containString($this->_agent, 'Win', true, false)) { + $this->setPlatform(self::PLATFORM_WINDOWS); + } else if ($this->containString($this->_agent, 'Mac', true, false)) { + $this->setPlatform(self::PLATFORM_MACINTOSH); + } + } + + //Check if it's a 64-bit platform + if ($this->containString($this->_agent, array('WOW64', 'Win64', 'AMD64', 'x86_64', 'x86-64', 'ia64', 'IRIX64', + 'ppc64', 'sparc64', 'x64;', 'x64_64'))) { + $this->set64bit(true); + } + + $this->checkPlatformVersion(); + } + + /** + * Determine if the platform is among the custom platform rules or not. Rules are checked in the order they were + * added. + * @access protected + * @return boolean Returns true if we found the platform we were looking for in the custom rules, false otherwise. + */ + protected function checkPlatformCustom() + { + foreach ($this->_customPlatformDetection as $platformName => $customPlatform) { + $platformNameToLookFor = $customPlatform['platformNameToLookFor']; + $isMobile = $customPlatform['isMobile']; + if ($this->containString($this->_agent, $platformNameToLookFor)) { + $this->setPlatform($platformName); + if ($isMobile) { + $this->setMobile(true); + } + return true; + } + } + + return false; + } + + /** + * Determine the user's platform version. + * @access protected + */ + protected function checkPlatformVersion() + { + $result = ''; + switch ($this->getPlatform()) { + case self::PLATFORM_WINDOWS: + if (preg_match('/Windows NT\s*(\d+(?:\.\d+)*)/i', $this->_agent, $foundVersion)) { + $result = 'NT ' . $foundVersion[1]; + } else { + //https://support.microsoft.com/en-us/kb/158238 + + if ($this->containString($this->_agent, array('Windows XP', 'WinXP', 'Win XP'))) { + $result = '5.1'; + } else if ($this->containString($this->_agent, 'Windows 2000', 'Win 2000', 'Win2000')) { + $result = '5.0'; + } else if ($this->containString($this->_agent, array('Win 9x 4.90', 'Windows ME', 'WinME', 'Win ME'))) { + $result = '4.90.3000'; //Windows Me version range from 4.90.3000 to 4.90.3000A + } else if ($this->containString($this->_agent, array('Windows 98', 'Win98', 'Win 98'))) { + $result = '4.10'; //Windows 98 version range from 4.10.1998 to 4.10.2222B + } else if ($this->containString($this->_agent, array('Windows 95', 'Win95', 'Win 95'))) { + $result = '4.00'; //Windows 95 version range from 4.00.950 to 4.03.1214 + } else if (($foundAt = stripos($this->_agent, 'Windows 3')) !== false) { + $result = '3'; + if (preg_match('/\d+(?:\.\d+)*/', substr($this->_agent, $foundAt + strlen('Windows 3')), $foundVersion)) { + $result .= '.' . $foundVersion[0]; + } + } else if ($this->containString($this->_agent, 'Win16')) { + $result = '3.1'; + } + } + break; + + case self::PLATFORM_MACINTOSH: + if (preg_match('/Mac OS X\s*(\d+(?:_\d+)+)/i', $this->_agent, $foundVersion)) { + $result = str_replace('_', '.', $this->cleanVersion($foundVersion[1])); + } else if ($this->containString($this->_agent, 'Mac OS X')) { + $result = '10'; + } + break; + + case self::PLATFORM_ANDROID: + if (preg_match('/Android\s+([^\s;$]+)/i', $this->_agent, $foundVersion)) { + $result = $this->cleanVersion($foundVersion[1]); + } + break; + + case self::PLATFORM_IOS: + if (preg_match('/(?:CPU OS|iPhone OS|iOS)[\s_]*([\d_]+)/i', $this->_agent, $foundVersion)) { + $result = str_replace('_', '.', $this->cleanVersion($foundVersion[1])); + } + break; + } + + if (trim($result) == '') { + $result = self::PLATFORM_VERSION_UNKNOWN; + } + $this->setPlatformVersion($result); + } + + /** + * Test the user agent for a specific browser where the browser name is immediately followed by the version number. + * The user agent should look like: "Browser name/1.0" or "Browser 1.0;". + * @access protected + * @param mixed $uaNameToLookFor The string (or array of strings) representing the browser name to find in the user + * agent. + * @param string $userAgent The user agent string to work with. + * @param string $browserName The literal browser name. Always use a class constant! + * @param boolean $isMobile (optional) Determines if the browser is from a mobile device. + * @param boolean $isRobot (optional) Determines if the browser is a robot or not. + * @param string $separator (optional) The separator string used to split the browser name and the version number in + * the user agent. + * @param boolean $uaNameFindWords (optional) Determines if the browser name to find should match a word instead of + * a part of a word. For example "Bar" would not be found in "FooBar" when true but would be found in "Foo Bar". + * When set to false, the browser name can be found anywhere in the user agent string. + * @return boolean Returns true if we found the browser we were looking for, false otherwise. + */ + protected function checkSimpleBrowserUA($uaNameToLookFor, $userAgent, $browserName, $isMobile = false, $isRobot = false, $separator = '/', $uaNameFindWords = true) + { + if (!is_array($uaNameToLookFor)) { + $uaNameToLookFor = array($uaNameToLookFor); + } + + foreach ($uaNameToLookFor as $currUANameToLookFor) { + + if ($this->containString($userAgent, $currUANameToLookFor, true, $uaNameFindWords)) { + //Many browsers don't use the standard "Browser/1.0" format, they uses "Browser 1.0;" instead + if (stripos($userAgent, $currUANameToLookFor . $separator) === false) { + $userAgent = str_ireplace($currUANameToLookFor . ' ', $currUANameToLookFor . $separator, $this->_agent); + } + + $version = ''; + $verParts = explode($separator, stristr($userAgent, $currUANameToLookFor)); + if (count($verParts) > 1) { + $verParts = explode(' ', $verParts[1]); + $version = $verParts[0]; + } + + $this->setBrowser($browserName); + $this->setVersion($version); + + $this->setMobile($isMobile); + $this->setRobot($isRobot); + + return true; + } + } + + return false; + } + + /** + * Find if one or more substring is contained in a string. + * @access protected + * @param string $haystack The string to search in. + * @param mixed $needle The string to search for. Can be a string or an array of strings if multiples values are to + * be searched. + * @param boolean $insensitive (optional) Determines if we do a case-sensitive search (false) or a case-insensitive + * one (true). + * @param boolean $findWords (optional) Determines if the needle should match a word to be found. For example "Bar" + * would not be found in "FooBar" when true but would be found in "Foo Bar". When set to false, the needle can be + * found anywhere in the haystack. + * @return boolean Returns true if the needle (or one of the needles) has been found in the haystack, false + * otherwise. + */ + protected function containString($haystack, $needle, $insensitive = true, $findWords = true) + { + if (!is_array($needle)) { + $needle = array($needle); + } + + foreach ($needle as $currNeedle) { + if ($findWords) { + $found = $this->wordPos($haystack, $currNeedle, $insensitive) !== false; + } else { + if ($insensitive) { + $found = stripos($haystack, $currNeedle) !== false; + } else { + $found = strpos($haystack, $currNeedle) !== false; + } + } + + if ($found) { + return true; + } + } + + return false; + } + + /** + * Detect the user environment from the details in the user agent string. + * @access protected + */ + protected function detect() + { + $this->checkBrowsers(); + $this->checkPlatform(); //Check the platform after the browser since some platforms can change the mobile value + } + + /** + * Clean a version string from unwanted characters. + * @access protected + * @param string $version The version string to clean. + * @return string Returns the cleaned version number string. + */ + protected function cleanVersion($version) + { + //Clear anything that is in parentheses (and the parentheses themselves) - will clear started but unclosed ones too + $cleanVer = preg_replace('/\([^)]+\)?/', '', $version); + //Replace with a space any character which is NOT an alphanumeric, dot (.), hyphen (-), underscore (_) or space + $cleanVer = preg_replace('/[^0-9.a-zA-Z_ -]/', ' ', $cleanVer); + + //Remove trailing and leading spaces + $cleanVer = trim($cleanVer); + + //Remove trailing dot (.), hyphen (-), underscore (_) + while (in_array(substr($cleanVer, -1), array('.', '-', '_'))) { + $cleanVer = substr($cleanVer, 0, -1); + } + //Remove leading dot (.), hyphen (-), underscore (_) and character v + while (in_array(substr($cleanVer, 0, 1), array('.', '-', '_', 'v', 'V'))) { + $cleanVer = substr($cleanVer, 1); + } + + //Remove double spaces if any + while (strpos($cleanVer, ' ') !== false) { + $cleanVer = str_replace(' ', ' ', $cleanVer); + } + + return trim($cleanVer); + } + + /** + * Convert the iOS version numbers to the operating system name. For instance '2.0' returns 'iPhone OS 2.0'. + * @access protected + * @param string $iOSVer The iOS version numbers as a string. + * @return string The operating system name. + */ + protected function iOSVerToStr($iOSVer) + { + if ($this->compareVersions($iOSVer, '3.0') <= 0) { + return 'iPhone OS ' . $iOSVer; + } else { + return 'iOS ' . $iOSVer; + } + } + + /** + * Convert the macOS version numbers to the operating system name. For instance '10.7' returns 'Mac OS X Lion'. + * @access protected + * @param string $macVer The macOS version numbers as a string. + * @return string The operating system name or the constant PLATFORM_VERSION_UNKNOWN if nothing match the version + * numbers. + */ + protected function macVerToStr($macVer) + { + //https://en.wikipedia.org/wiki/OS_X#Release_history + + if ($this->_platformVersion === '10') { + return 'Mac OS X'; //Unspecified Mac OS X version + } else if ($this->compareVersions($macVer, '10.13') >= 0 && $this->compareVersions($macVer, '10.14') < 0) { + return 'macOS High Sierra'; + } else if ($this->compareVersions($macVer, '10.12') >= 0 && $this->compareVersions($macVer, '10.13') < 0) { + return 'macOS Sierra'; + } else if ($this->compareVersions($macVer, '10.11') >= 0 && $this->compareVersions($macVer, '10.12') < 0) { + return 'OS X El Capitan'; + } else if ($this->compareVersions($macVer, '10.10') >= 0 && $this->compareVersions($macVer, '10.11') < 0) { + return 'OS X Yosemite'; + } else if ($this->compareVersions($macVer, '10.9') >= 0 && $this->compareVersions($macVer, '10.10') < 0) { + return 'OS X Mavericks'; + } else if ($this->compareVersions($macVer, '10.8') >= 0 && $this->compareVersions($macVer, '10.9') < 0) { + return 'OS X Mountain Lion'; + } else if ($this->compareVersions($macVer, '10.7') >= 0 && $this->compareVersions($macVer, '10.8') < 0) { + return 'Mac OS X Lion'; + } else if ($this->compareVersions($macVer, '10.6') >= 0 && $this->compareVersions($macVer, '10.7') < 0) { + return 'Mac OS X Snow Leopard'; + } else if ($this->compareVersions($macVer, '10.5') >= 0 && $this->compareVersions($macVer, '10.6') < 0) { + return 'Mac OS X Leopard'; + } else if ($this->compareVersions($macVer, '10.4') >= 0 && $this->compareVersions($macVer, '10.5') < 0) { + return 'Mac OS X Tiger'; + } else if ($this->compareVersions($macVer, '10.3') >= 0 && $this->compareVersions($macVer, '10.4') < 0) { + return 'Mac OS X Panther'; + } else if ($this->compareVersions($macVer, '10.2') >= 0 && $this->compareVersions($macVer, '10.3') < 0) { + return 'Mac OS X Jaguar'; + } else if ($this->compareVersions($macVer, '10.1') >= 0 && $this->compareVersions($macVer, '10.2') < 0) { + return 'Mac OS X Puma'; + } else if ($this->compareVersions($macVer, '10.0') >= 0 && $this->compareVersions($macVer, '10.1') < 0) { + return 'Mac OS X Cheetah'; + } else { + return self::PLATFORM_VERSION_UNKNOWN; //Unknown/unnamed Mac OS version + } + } + + /** + * Get the integer value of a string variable. + * @access protected + * @param string $intStr The scalar value being converted to an integer. + * @return int The integer value of $intStr on success, or 0 on failure. + */ + protected function parseInt($intStr) + { + return intval($intStr, 10); + } + + /** + * Reset all the properties of the class. + * @access protected + */ + protected function reset() + { + $this->_agent = ''; + $this->_browserName = self::BROWSER_UNKNOWN; + $this->_compatibilityViewName = ''; + $this->_compatibilityViewVer = ''; + $this->_is64bit = false; + $this->_isMobile = false; + $this->_isRobot = false; + $this->_platform = self::PLATFORM_UNKNOWN; + $this->_platformVersion = self::PLATFORM_VERSION_UNKNOWN; + $this->_version = self::VERSION_UNKNOWN; + } + + /** + * Convert a Safari build number to a Safari version number. + * @access protected + * @param string $version A string representing the version number. + * @link http://web.archive.org/web/20080514173941/http://developer.apple.com/internet/safari/uamatrix.html + * @return string Returns the Safari version string. If the version can't be determined, an empty string is + * returned. + */ + protected function safariBuildToSafariVer($version) + { + $verParts = explode('.', $version); + + //We need a 3 parts version (version 2 will becomes 2.0.0) + while (count($verParts) < 3) { + $verParts[] = 0; + } + foreach ($verParts as $i => $currPart) { + $verParts[$i] = $this->parseInt($currPart); + } + + switch ($verParts[0]) { + case 419: $result = '2.0.4'; + break; + case 417: $result = '2.0.3'; + break; + case 416: $result = '2.0.2'; + break; + + case 412: + if ($verParts[1] >= 5) { + $result = '2.0.1'; + } else { + $result = '2.0'; + } + break; + + case 312: + if ($verParts[1] >= 5) { + $result = '1.3.2'; + } else { + if ($verParts[1] >= 3) { + $result = '1.3.1'; + } else { + $result = '1.3'; + } + } + break; + + case 125: + if ($verParts[1] >= 11) { + $result = '1.2.4'; + } else { + if ($verParts[1] >= 9) { + $result = '1.2.3'; + } else { + if ($verParts[1] >= 7) { + $result = '1.2.2'; + } else { + $result = '1.2'; + } + } + } + break; + + case 100: + if ($verParts[1] >= 1) { + $result = '1.1.1'; + } else { + $result = '1.1'; + } + break; + + case 85: + if ($verParts[1] >= 8) { + $result = '1.0.3'; + } else { + if ($verParts[1] >= 7) { + $result = '1.0.2'; + } else { + $result = '1.0'; + } + } + break; + + case 73: $result = '0.9'; + break; + case 51: $result = '0.8.1'; + break; + case 48: $result = '0.8'; + break; + + default: $result = ''; + } + + return $result; + } + + /** + * Set if the browser is executed from a 64-bit platform. + * @access protected + * @param boolean $is64bit Value that tells if the browser is executed from a 64-bit platform. + */ + protected function set64bit($is64bit) + { + $this->_is64bit = $is64bit == true; + } + + /** + * Set the name of the browser. + * @access protected + * @param string $browserName The name of the browser. + */ + protected function setBrowser($browserName) + { + $this->_browserName = $browserName; + } + + /** + * Set the browser to be from a mobile device or not. + * @access protected + * @param boolean $isMobile (optional) Value that tells if the browser is on a mobile device or not. + */ + protected function setMobile($isMobile = true) + { + $this->_isMobile = $isMobile == true; + } + + /** + * Set the platform on which the browser is on. + * @access protected + * @param string $platform The name of the platform. + */ + protected function setPlatform($platform) + { + $this->_platform = $platform; + } + + /** + * Set the platform version on which the browser is on. + * @access protected + * @param string $platformVer The version numbers of the platform. + */ + protected function setPlatformVersion($platformVer) + { + $this->_platformVersion = $platformVer; + } + + /** + * Set the browser to be a robot (crawler) or not. + * @access protected + * @param boolean $isRobot (optional) Value that tells if the browser is a robot or not. + */ + protected function setRobot($isRobot = true) + { + $this->_isRobot = $isRobot == true; + } + + /** + * Set the version of the browser. + * @access protected + * @param string $version The version of the browser. + */ + protected function setVersion($version) + { + $cleanVer = $this->cleanVersion($version); + + if ($cleanVer == '') { + $this->_version = self::VERSION_UNKNOWN; + } else { + $this->_version = $cleanVer; + } + } + + /** + * Convert a WebKit build number to a Safari version number. + * @access protected + * @param string $version A string representing the version number. + * @link http://web.archive.org/web/20080514173941/http://developer.apple.com/internet/safari/uamatrix.html + * @return string Returns the Safari version string. If the version can't be determined, an empty string is + * returned. + */ + protected function webKitBuildToSafariVer($version) + { + $verParts = explode('.', $version); + + //We need a 3 parts version (version 2 will becomes 2.0.0) + while (count($verParts) < 3) { + $verParts[] = 0; + } + foreach ($verParts as $i => $currPart) { + $verParts[$i] = $this->parseInt($currPart); + } + + switch ($verParts[0]) { + case 419: $result = '2.0.4'; + break; + + case 418: + if ($verParts[1] >= 8) { + $result = '2.0.4'; + } else { + $result = '2.0.3'; + } + break; + + case 417: $result = '2.0.3'; + break; + + case 416: $result = '2.0.2'; + break; + + case 412: + if ($verParts[1] >= 7) { + $result = '2.0.1'; + } else { + $result = '2.0'; + } + break; + + case 312: + if ($verParts[1] >= 8) { + $result = '1.3.2'; + } else { + if ($verParts[1] >= 5) { + $result = '1.3.1'; + } else { + $result = '1.3'; + } + } + break; + + case 125: + if ($this->compareVersions('5.4', $verParts[1] . '.' . $verParts[2]) == -1) { + $result = '1.2.4'; //125.5.5+ + } else { + if ($verParts[1] >= 4) { + $result = '1.2.3'; + } else { + if ($verParts[1] >= 2) { + $result = '1.2.2'; + } else { + $result = '1.2'; + } + } + } + break; + + //WebKit 100 can be either Safari 1.1 (Safari build 100) or 1.1.1 (Safari build 100.1) + //for this reason, check the Safari build before the WebKit build. + case 100: $result = '1.1.1'; + break; + + case 85: + if ($verParts[1] >= 8) { + $result = '1.0.3'; + } else { + if ($verParts[1] >= 7) { + //WebKit 85.7 can be either Safari 1.0 (Safari build 85.5) or 1.0.2 (Safari build 85.7) + //for this reason, check the Safari build before the WebKit build. + $result = '1.0.2'; + } else { + $result = '1.0'; + } + } + break; + + case 73: $result = '0.9'; + break; + case 51: $result = '0.8.1'; + break; + case 48: $result = '0.8'; + break; + + default: $result = ''; + } + + return $result; + } + + /** + * Convert the Windows NT family version numbers to the operating system name. For instance '5.1' returns + * 'Windows XP'. + * @access protected + * @param string $winVer The Windows NT family version numbers as a string. + * @param boolean $returnServerFlavor (optional) Since some Windows NT versions have the same values, this flag + * determines if the Server flavor is returned or not. For instance Windows 8.1 and Windows Server 2012 R2 both use + * version 6.3. + * @return string The operating system name or the constant PLATFORM_VERSION_UNKNOWN if nothing match the version + * numbers. + */ + protected function windowsNTVerToStr($winVer, $returnServerFlavor = false) + { + //https://en.wikipedia.org/wiki/List_of_Microsoft_Windows_versions + + $cleanWinVer = explode('.', $winVer); + while (count($cleanWinVer) > 2) { + array_pop($cleanWinVer); + } + $cleanWinVer = implode('.', $cleanWinVer); + + if ($this->compareVersions($cleanWinVer, '11') >= 0) { + //Future versions of Windows + return self::PLATFORM_WINDOWS . ' ' . $winVer; + } else if ($this->compareVersions($cleanWinVer, '10') >= 0) { + //Current version of Windows + return $returnServerFlavor ? (self::PLATFORM_WINDOWS . ' Server 2016') : (self::PLATFORM_WINDOWS . ' 10'); + } else if ($this->compareVersions($cleanWinVer, '7') < 0) { + if ($this->compareVersions($cleanWinVer, '6.3') == 0) { + return $returnServerFlavor ? (self::PLATFORM_WINDOWS . ' Server 2012 R2') : (self::PLATFORM_WINDOWS . ' 8.1'); + } else if ($this->compareVersions($cleanWinVer, '6.2') == 0) { + return $returnServerFlavor ? (self::PLATFORM_WINDOWS . ' Server 2012') : (self::PLATFORM_WINDOWS . ' 8'); + } else if ($this->compareVersions($cleanWinVer, '6.1') == 0) { + return $returnServerFlavor ? (self::PLATFORM_WINDOWS . ' Server 2008 R2') : (self::PLATFORM_WINDOWS . ' 7'); + } else if ($this->compareVersions($cleanWinVer, '6') == 0) { + return $returnServerFlavor ? (self::PLATFORM_WINDOWS . ' Server 2008') : (self::PLATFORM_WINDOWS . ' Vista'); + } else if ($this->compareVersions($cleanWinVer, '5.2') == 0) { + return $returnServerFlavor ? (self::PLATFORM_WINDOWS . ' Server 2003 / ' . self::PLATFORM_WINDOWS . ' Server 2003 R2') : (self::PLATFORM_WINDOWS . ' XP x64 Edition'); + } else if ($this->compareVersions($cleanWinVer, '5.1') == 0) { + return self::PLATFORM_WINDOWS . ' XP'; + } else if ($this->compareVersions($cleanWinVer, '5') == 0) { + return self::PLATFORM_WINDOWS . ' 2000'; + } else if ($this->compareVersions($cleanWinVer, '5') < 0 && $this->compareVersions($cleanWinVer, '3') >= 0) { + return self::PLATFORM_WINDOWS . ' NT ' . $winVer; + } + } + + return self::PLATFORM_VERSION_UNKNOWN; //Invalid Windows NT version + } + + /** + * Convert the Windows 3.x & 9x family version numbers to the operating system name. For instance '4.10.1998' + * returns 'Windows 98'. + * @access protected + * @param string $winVer The Windows 3.x or 9x family version numbers as a string. + * @return string The operating system name or the constant PLATFORM_VERSION_UNKNOWN if nothing match the version + * numbers. + */ + protected function windowsVerToStr($winVer) + { + //https://support.microsoft.com/en-us/kb/158238 + + if ($this->compareVersions($winVer, '4.90') >= 0 && $this->compareVersions($winVer, '4.91') < 0) { + return self::PLATFORM_WINDOWS . ' Me'; //Normally range from 4.90.3000 to 4.90.3000A + } else if ($this->compareVersions($winVer, '4.10') >= 0 && $this->compareVersions($winVer, '4.11') < 0) { + return self::PLATFORM_WINDOWS . ' 98'; //Normally range from 4.10.1998 to 4.10.2222B + } else if ($this->compareVersions($winVer, '4') >= 0 && $this->compareVersions($winVer, '4.04') < 0) { + return self::PLATFORM_WINDOWS . ' 95'; //Normally range from 4.00.950 to 4.03.1214 + } else if ($this->compareVersions($winVer, '3.1') == 0 || $this->compareVersions($winVer, '3.11') == 0) { + return self::PLATFORM_WINDOWS . ' ' . $winVer; + } else if ($this->compareVersions($winVer, '3.10') == 0) { + return self::PLATFORM_WINDOWS . ' 3.1'; + } else { + return self::PLATFORM_VERSION_UNKNOWN; //Invalid Windows version + } + } + + /** + * Find the position of the first occurrence of a word in a string. + * @access protected + * @param string $haystack The string to search in. + * @param string $needle The string to search for. + * @param boolean $insensitive (optional) Determines if we do a case-sensitive search (false) or a case-insensitive + * one (true). + * @param int $offset If specified, search will start this number of characters counted from the beginning of the + * string. If the offset is negative, the search will start this number of characters counted from the end of the + * string. + * @param string $foundString String buffer that will contain the exact matching needle found. Set to NULL when + * return value of the function is false. + * @return mixed Returns the position of the needle (int) if found, false otherwise. Warning this function may + * return Boolean false, but may also return a non-Boolean value which evaluates to false. + */ + protected function wordPos($haystack, $needle, $insensitive = true, $offset = 0, &$foundString = NULL) + { + if ($offset != 0) { + $haystack = substr($haystack, $offset); + } + + $parts = explode(' ', $needle); + foreach ($parts as $i => $currPart) { + $parts[$i] = preg_quote($currPart, '/'); + } + + $regex = '/(?<=\A|[\s\/\\.,;:_()-])' . implode('[\s\/\\.,;:_()-]', $parts) . '(?=[\s\/\\.,;:_()-]|$)/'; + if ($insensitive) { + $regex .= 'i'; + } + + if (preg_match($regex, $haystack, $matches, PREG_OFFSET_CAPTURE)) { + $foundString = $matches[0][0]; + return (int)$matches[0][1]; + } + + return false; + } +}
\ No newline at end of file |
