summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorspiderr <spiderr@bitweaver.org>2018-07-31 11:45:28 -0400
committerspiderr <spiderr@bitweaver.org>2018-07-31 11:45:28 -0400
commit4a945905298ba6173c2f53dfac5fe5fcffa3fb84 (patch)
tree2aa64fc11e943d185ec76c39214b46e4f775b069
parent8f7d7b9430e00ce3d5cd0f6182ff3da866d66a6e (diff)
downloadutil-4a945905298ba6173c2f53dfac5fe5fcffa3fb84.tar.gz
util-4a945905298ba6173c2f53dfac5fe5fcffa3fb84.tar.bz2
util-4a945905298ba6173c2f53dfac5fe5fcffa3fb84.zip
create includes/
-rw-r--r--.htaccess1
-rw-r--r--Snoopy.class.inc1173
-rw-r--r--Snoopy.readme261
-rw-r--r--includes/BrowserDetection.php2106
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