Plugin Directory

Changeset 927219


Ignore:
Timestamp:
06/05/2014 04:25:00 PM (12 years ago)
Author:
fsdsolutions
Message:

mobile class modified

File:
1 edited

Legend:

Unmodified
Added
Removed
  • quickapp/trunk/lib/Mobile_Detect.php

    r859204 r927219  
    3333 */
    3434
    35 class Mobile_Detect
     35 // Check that the class exists before trying to use it
     36if (!class_exists('Mobile_Detect'))
    3637{
    37     /**
    38      * Mobile detection type.
    39      */
    40     const DETECTION_TYPE_MOBILE     = 'mobile';
    41 
    42     /**
    43      * Extended detection type.
    44      */
    45     const DETECTION_TYPE_EXTENDED   = 'extended';
    46 
    47     /**
    48      * A frequently used regular expression to extract version #s.
    49      */
    50     const VER                       = '([\w._\+]+)';
    51 
    52     /**
    53      * Top-level device.
    54      */
    55     const MOBILE_GRADE_A            = 'A';
    56 
    57     /**
    58      * Mid-level device.
    59      */
    60     const MOBILE_GRADE_B            = 'B';
    61 
    62     /**
    63      * Low-level device.
    64      */
    65     const MOBILE_GRADE_C            = 'C';
    66 
    67     /**
    68      * Stores the version number of the current release.
    69      */
    70     const VERSION                   = '2.6.9';
    71 
    72     /**
    73      * A type for the version() method indicating a string return value.
    74      */
    75     const VERSION_TYPE_STRING       = 'text';
    76 
    77     /**
    78      * A type for the version() method indicating a float return value.
    79      */
    80     const VERSION_TYPE_FLOAT        = 'float';
    81 
    82     /**
    83      * The User-Agent HTTP header is stored in here.
    84      * @var string
    85      */
    86     protected $userAgent = null;
    87 
    88     /**
    89      * HTTP headers in the PHP-flavor. So HTTP_USER_AGENT and SERVER_SOFTWARE.
    90      * @var array
    91      */
    92     protected $httpHeaders = array();
    93 
    94     /**
    95      * The detection type, using self::DETECTION_TYPE_MOBILE or self::DETECTION_TYPE_EXTENDED.
    96      *
    97      * @var string
    98      */
    99     protected $detectionType = self::DETECTION_TYPE_MOBILE;
    100 
    101     /**
    102      * List of mobile devices (phones).
    103      *
    104      * @var array
    105      */
    106     protected static $phoneDevices = array(
    107         'iPhone'        => '\biPhone.*Mobile|\biPod', // |\biTunes
    108         'BlackBerry'    => 'BlackBerry|\bBB10\b|rim[0-9]+',
    109         'HTC'           => 'HTC|HTC.*(Sensation|Evo|Vision|Explorer|6800|8100|8900|A7272|S510e|C110e|Legend|Desire|T8282)|APX515CKT|Qtek9090|APA9292KT|HD_mini|Sensation.*Z710e|PG86100|Z715e|Desire.*(A8181|HD)|ADR6200|ADR6400L|ADR6425|001HT|Inspire 4G|Android.*\bEVO\b',
    110         'Nexus'         => 'Nexus One|Nexus S|Galaxy.*Nexus|Android.*Nexus.*Mobile',
    111         // @todo: Is 'Dell Streak' a tablet or a phone? ;)
    112         'Dell'          => 'Dell.*Streak|Dell.*Aero|Dell.*Venue|DELL.*Venue Pro|Dell Flash|Dell Smoke|Dell Mini 3iX|XCD28|XCD35|\b001DL\b|\b101DL\b|\bGS01\b',
    113         'Motorola'      => 'Motorola|\bDroid\b.*Build|DROIDX|Android.*Xoom|HRI39|MOT-|A1260|A1680|A555|A853|A855|A953|A955|A956|Motorola.*ELECTRIFY|Motorola.*i1|i867|i940|MB200|MB300|MB501|MB502|MB508|MB511|MB520|MB525|MB526|MB611|MB612|MB632|MB810|MB855|MB860|MB861|MB865|MB870|ME501|ME502|ME511|ME525|ME600|ME632|ME722|ME811|ME860|ME863|ME865|MT620|MT710|MT716|MT720|MT810|MT870|MT917|Motorola.*TITANIUM|WX435|WX445|XT300|XT301|XT311|XT316|XT317|XT319|XT320|XT390|XT502|XT530|XT531|XT532|XT535|XT603|XT610|XT611|XT615|XT681|XT701|XT702|XT711|XT720|XT800|XT806|XT860|XT862|XT875|XT882|XT883|XT894|XT901|XT907|XT909|XT910|XT912|XT928|XT926|XT915|XT919|XT925',
    114         'Samsung'       => 'Samsung|SGH-I337|BGT-S5230|GT-B2100|GT-B2700|GT-B2710|GT-B3210|GT-B3310|GT-B3410|GT-B3730|GT-B3740|GT-B5510|GT-B5512|GT-B5722|GT-B6520|GT-B7300|GT-B7320|GT-B7330|GT-B7350|GT-B7510|GT-B7722|GT-B7800|GT-C3010|GT-C3011|GT-C3060|GT-C3200|GT-C3212|GT-C3212I|GT-C3262|GT-C3222|GT-C3300|GT-C3300K|GT-C3303|GT-C3303K|GT-C3310|GT-C3322|GT-C3330|GT-C3350|GT-C3500|GT-C3510|GT-C3530|GT-C3630|GT-C3780|GT-C5010|GT-C5212|GT-C6620|GT-C6625|GT-C6712|GT-E1050|GT-E1070|GT-E1075|GT-E1080|GT-E1081|GT-E1085|GT-E1087|GT-E1100|GT-E1107|GT-E1110|GT-E1120|GT-E1125|GT-E1130|GT-E1160|GT-E1170|GT-E1175|GT-E1180|GT-E1182|GT-E1200|GT-E1210|GT-E1225|GT-E1230|GT-E1390|GT-E2100|GT-E2120|GT-E2121|GT-E2152|GT-E2220|GT-E2222|GT-E2230|GT-E2232|GT-E2250|GT-E2370|GT-E2550|GT-E2652|GT-E3210|GT-E3213|GT-I5500|GT-I5503|GT-I5700|GT-I5800|GT-I5801|GT-I6410|GT-I6420|GT-I7110|GT-I7410|GT-I7500|GT-I8000|GT-I8150|GT-I8160|GT-I8190|GT-I8320|GT-I8330|GT-I8350|GT-I8530|GT-I8700|GT-I8703|GT-I8910|GT-I9000|GT-I9001|GT-I9003|GT-I9010|GT-I9020|GT-I9023|GT-I9070|GT-I9082|GT-I9100|GT-I9103|GT-I9220|GT-I9250|GT-I9300|GT-I9305|GT-I9500|GT-I9505|GT-M3510|GT-M5650|GT-M7500|GT-M7600|GT-M7603|GT-M8800|GT-M8910|GT-N7000|GT-S3110|GT-S3310|GT-S3350|GT-S3353|GT-S3370|GT-S3650|GT-S3653|GT-S3770|GT-S3850|GT-S5210|GT-S5220|GT-S5229|GT-S5230|GT-S5233|GT-S5250|GT-S5253|GT-S5260|GT-S5263|GT-S5270|GT-S5300|GT-S5330|GT-S5350|GT-S5360|GT-S5363|GT-S5369|GT-S5380|GT-S5380D|GT-S5560|GT-S5570|GT-S5600|GT-S5603|GT-S5610|GT-S5620|GT-S5660|GT-S5670|GT-S5690|GT-S5750|GT-S5780|GT-S5830|GT-S5839|GT-S6102|GT-S6500|GT-S7070|GT-S7200|GT-S7220|GT-S7230|GT-S7233|GT-S7250|GT-S7500|GT-S7530|GT-S7550|GT-S7562|GT-S7710|GT-S8000|GT-S8003|GT-S8500|GT-S8530|GT-S8600|SCH-A310|SCH-A530|SCH-A570|SCH-A610|SCH-A630|SCH-A650|SCH-A790|SCH-A795|SCH-A850|SCH-A870|SCH-A890|SCH-A930|SCH-A950|SCH-A970|SCH-A990|SCH-I100|SCH-I110|SCH-I400|SCH-I405|SCH-I500|SCH-I510|SCH-I515|SCH-I600|SCH-I730|SCH-I760|SCH-I770|SCH-I830|SCH-I910|SCH-I920|SCH-I959|SCH-LC11|SCH-N150|SCH-N300|SCH-R100|SCH-R300|SCH-R351|SCH-R400|SCH-R410|SCH-T300|SCH-U310|SCH-U320|SCH-U350|SCH-U360|SCH-U365|SCH-U370|SCH-U380|SCH-U410|SCH-U430|SCH-U450|SCH-U460|SCH-U470|SCH-U490|SCH-U540|SCH-U550|SCH-U620|SCH-U640|SCH-U650|SCH-U660|SCH-U700|SCH-U740|SCH-U750|SCH-U810|SCH-U820|SCH-U900|SCH-U940|SCH-U960|SCS-26UC|SGH-A107|SGH-A117|SGH-A127|SGH-A137|SGH-A157|SGH-A167|SGH-A177|SGH-A187|SGH-A197|SGH-A227|SGH-A237|SGH-A257|SGH-A437|SGH-A517|SGH-A597|SGH-A637|SGH-A657|SGH-A667|SGH-A687|SGH-A697|SGH-A707|SGH-A717|SGH-A727|SGH-A737|SGH-A747|SGH-A767|SGH-A777|SGH-A797|SGH-A817|SGH-A827|SGH-A837|SGH-A847|SGH-A867|SGH-A877|SGH-A887|SGH-A897|SGH-A927|SGH-B100|SGH-B130|SGH-B200|SGH-B220|SGH-C100|SGH-C110|SGH-C120|SGH-C130|SGH-C140|SGH-C160|SGH-C170|SGH-C180|SGH-C200|SGH-C207|SGH-C210|SGH-C225|SGH-C230|SGH-C417|SGH-C450|SGH-D307|SGH-D347|SGH-D357|SGH-D407|SGH-D415|SGH-D780|SGH-D807|SGH-D980|SGH-E105|SGH-E200|SGH-E315|SGH-E316|SGH-E317|SGH-E335|SGH-E590|SGH-E635|SGH-E715|SGH-E890|SGH-F300|SGH-F480|SGH-I200|SGH-I300|SGH-I320|SGH-I550|SGH-I577|SGH-I600|SGH-I607|SGH-I617|SGH-I627|SGH-I637|SGH-I677|SGH-I700|SGH-I717|SGH-I727|SGH-i747M|SGH-I777|SGH-I780|SGH-I827|SGH-I847|SGH-I857|SGH-I896|SGH-I897|SGH-I900|SGH-I907|SGH-I917|SGH-I927|SGH-I937|SGH-I997|SGH-J150|SGH-J200|SGH-L170|SGH-L700|SGH-M110|SGH-M150|SGH-M200|SGH-N105|SGH-N500|SGH-N600|SGH-N620|SGH-N625|SGH-N700|SGH-N710|SGH-P107|SGH-P207|SGH-P300|SGH-P310|SGH-P520|SGH-P735|SGH-P777|SGH-Q105|SGH-R210|SGH-R220|SGH-R225|SGH-S105|SGH-S307|SGH-T109|SGH-T119|SGH-T139|SGH-T209|SGH-T219|SGH-T229|SGH-T239|SGH-T249|SGH-T259|SGH-T309|SGH-T319|SGH-T329|SGH-T339|SGH-T349|SGH-T359|SGH-T369|SGH-T379|SGH-T409|SGH-T429|SGH-T439|SGH-T459|SGH-T469|SGH-T479|SGH-T499|SGH-T509|SGH-T519|SGH-T539|SGH-T559|SGH-T589|SGH-T609|SGH-T619|SGH-T629|SGH-T639|SGH-T659|SGH-T669|SGH-T679|SGH-T709|SGH-T719|SGH-T729|SGH-T739|SGH-T746|SGH-T749|SGH-T759|SGH-T769|SGH-T809|SGH-T819|SGH-T839|SGH-T919|SGH-T929|SGH-T939|SGH-T959|SGH-T989|SGH-U100|SGH-U200|SGH-U800|SGH-V205|SGH-V206|SGH-X100|SGH-X105|SGH-X120|SGH-X140|SGH-X426|SGH-X427|SGH-X475|SGH-X495|SGH-X497|SGH-X507|SGH-X600|SGH-X610|SGH-X620|SGH-X630|SGH-X700|SGH-X820|SGH-X890|SGH-Z130|SGH-Z150|SGH-Z170|SGH-ZX10|SGH-ZX20|SHW-M110|SPH-A120|SPH-A400|SPH-A420|SPH-A460|SPH-A500|SPH-A560|SPH-A600|SPH-A620|SPH-A660|SPH-A700|SPH-A740|SPH-A760|SPH-A790|SPH-A800|SPH-A820|SPH-A840|SPH-A880|SPH-A900|SPH-A940|SPH-A960|SPH-D600|SPH-D700|SPH-D710|SPH-D720|SPH-I300|SPH-I325|SPH-I330|SPH-I350|SPH-I500|SPH-I600|SPH-I700|SPH-L700|SPH-M100|SPH-M220|SPH-M240|SPH-M300|SPH-M305|SPH-M320|SPH-M330|SPH-M350|SPH-M360|SPH-M370|SPH-M380|SPH-M510|SPH-M540|SPH-M550|SPH-M560|SPH-M570|SPH-M580|SPH-M610|SPH-M620|SPH-M630|SPH-M800|SPH-M810|SPH-M850|SPH-M900|SPH-M910|SPH-M920|SPH-M930|SPH-N100|SPH-N200|SPH-N240|SPH-N300|SPH-N400|SPH-Z400|SWC-E100|SCH-i909|GT-N7100|GT-N7105|SCH-I535',
    115         'LG'            => '\bLG\b;|(LG|LG-)?(C800|C900|E400|E610|E900|E-900|F160|F180K|F180L|F180S|730|855|L160|LS840|LS970|LU6200|MS690|MS695|MS770|MS840|MS870|MS910|P500|P700|P705|VM696|AS680|AS695|AX840|C729|E970|GS505|272|C395|E739BK|E960|L55C|L75C|LS696|LS860|P769BK|P350|P500|P509|P870|UN272|US730|VS840|VS950|LN272|LN510|LS670|LS855|LW690|MN270|MN510|P509|P769|P930|UN200|UN270|UN510|UN610|US670|US740|US760|UX265|UX840|VN271|VN530|VS660|VS700|VS740|VS750|VS910|VS920|VS930|VX9200|VX11000|AX840A|LW770|P506|P925|P999)',
    116         'Sony'          => 'SonyST|SonyLT|SonyEricsson|SonyEricssonLT15iv|LT18i|E10i|LT28h|SonyEricssonMT27i',
    117         'Asus'          => 'Asus.*Galaxy|PadFone.*Mobile',
    118         // @ref: http://www.micromaxinfo.com/mobiles/smartphones
    119         // Added because the codes might conflict with Acer Tablets.
    120         'Micromax'      => 'Micromax.*\b(A210|A92|A88|A72|A111|A110Q|A115|A116|A110|A90S|A26|A51|A35|A54|A25|A27|A89|A68|A65|A57|A90)\b',
    121         'Palm'          => 'PalmSource|Palm', // avantgo|blazer|elaine|hiptop|plucker|xiino ; @todo - complete the regex.
    122         'Vertu'         => 'Vertu|Vertu.*Ltd|Vertu.*Ascent|Vertu.*Ayxta|Vertu.*Constellation(F|Quest)?|Vertu.*Monika|Vertu.*Signature', // Just for fun ;)
    123         // @ref: http://www.pantech.co.kr/en/prod/prodList.do?gbrand=VEGA (PANTECH)
    124         // Most of the VEGA devices are legacy. PANTECH seem to be newer devices based on Android.
    125         'Pantech'       => 'PANTECH|IM-A850S|IM-A840S|IM-A830L|IM-A830K|IM-A830S|IM-A820L|IM-A810K|IM-A810S|IM-A800S|IM-T100K|IM-A725L|IM-A780L|IM-A775C|IM-A770K|IM-A760S|IM-A750K|IM-A740S|IM-A730S|IM-A720L|IM-A710K|IM-A690L|IM-A690S|IM-A650S|IM-A630K|IM-A600S|VEGA PTL21|PT003|P8010|ADR910L|P6030|P6020|P9070|P4100|P9060|P5000|CDM8992|TXT8045|ADR8995|IS11PT|P2030|P6010|P8000|PT002|IS06|CDM8999|P9050|PT001|TXT8040|P2020|P9020|P2000|P7040|P7000|C790',
    126         // @ref: http://www.fly-phone.com/devices/smartphones/ ; Included only smartphones.
    127         'Fly'           => 'IQ230|IQ444|IQ450|IQ440|IQ442|IQ441|IQ245|IQ256|IQ236|IQ255|IQ235|IQ245|IQ275|IQ240|IQ285|IQ280|IQ270|IQ260|IQ250',
    128         // Added simvalley mobile just for fun. They have some interesting devices.
    129         // @ref: http://www.simvalley.fr/telephonie---gps-_22_telephonie-mobile_telephones_.html
    130         'SimValley'     => '\b(SP-80|XT-930|SX-340|XT-930|SX-310|SP-360|SP60|SPT-800|SP-120|SPT-800|SP-140|SPX-5|SPX-8|SP-100|SPX-8|SPX-12)\b',
    131         // @Tapatalk is a mobile app; @ref: http://support.tapatalk.com/threads/smf-2-0-2-os-and-browser-detection-plugin-and-tapatalk.15565/#post-79039
    132         'GenericPhone'  => 'Tapatalk|PDA;|SAGEM|mmp|pocket|psp|symbian|Smartphone|smartfon|treo|up.browser|up.link|vodafone|wap|nokia|Series40|Series60|S60|SonyEricsson|N900|MAUI.*WAP.*Browser'
    133     );
    134 
    135     /**
    136      * List of tablet devices.
    137      *
    138      * @var array
    139      */
    140     protected static $tabletDevices = array(
    141         'iPad'              => 'iPad|iPad.*Mobile', // @todo: check for mobile friendly emails topic.
    142         'NexusTablet'       => '^.*Android.*Nexus(((?:(?!Mobile))|(?:(\s(7|10).+))).)*$',
    143         'SamsungTablet'     => 'SAMSUNG.*Tablet|Galaxy.*Tab|SC-01C|GT-P1000|GT-P1003|GT-P1010|GT-P3105|GT-P6210|GT-P6800|GT-P6810|GT-P7100|GT-P7300|GT-P7310|GT-P7500|GT-P7510|SCH-I800|SCH-I815|SCH-I905|SGH-I957|SGH-I987|SGH-T849|SGH-T859|SGH-T869|SPH-P100|GT-P3100|GT-P3108|GT-P3110|GT-P5100|GT-P5110|GT-P6200|GT-P7320|GT-P7511|GT-N8000|GT-P8510|SGH-I497|SPH-P500|SGH-T779|SCH-I705|SCH-I915|GT-N8013|GT-P3113|GT-P5113|GT-P8110|GT-N8010|GT-N8005|GT-N8020|GT-P1013|GT-P6201|GT-P7501|GT-N5100|GT-N5110|SHV-E140K|SHV-E140L|SHV-E140S|SHV-E150S|SHV-E230K|SHV-E230L|SHV-E230S|SHW-M180K|SHW-M180L|SHW-M180S|SHW-M180W|SHW-M300W|SHW-M305W|SHW-M380K|SHW-M380S|SHW-M380W|SHW-M430W|SHW-M480K|SHW-M480S|SHW-M480W|SHW-M485W|SHW-M486W|SHW-M500W|GT-I9228|SCH-P739|SCH-I925|GT-I9200|GT-I9205|GT-P5200|GT-P5210|SM-T311|SM-T310|SM-T210|SM-T211|SM-P900',
    144         // @reference: http://www.labnol.org/software/kindle-user-agent-string/20378/
    145         'Kindle'            => 'Kindle|Silk.*Accelerated|Android.*\b(KFTT|KFOTE)\b',
    146         // Only the Surface tablets with Windows RT are considered mobile.
    147         // @ref: http://msdn.microsoft.com/en-us/library/ie/hh920767(v=vs.85).aspx
    148         'SurfaceTablet'     => 'Windows NT [0-9.]+; ARM;',
    149         // @ref: http://shopping1.hp.com/is-bin/INTERSHOP.enfinity/WFS/WW-USSMBPublicStore-Site/en_US/-/USD/ViewStandardCatalog-Browse?CatalogCategoryID=JfIQ7EN5lqMAAAEyDcJUDwMT
    150         'HPTablet'          => 'HP Slate 7|HP ElitePad 900|hp-tablet|EliteBook.*Touch',
    151         // @note: watch out for PadFone, see #132
    152         'AsusTablet'        => 'Transformer|TF101|^.*PadFone((?!Mobile).)*$|ME301T|ME371MG|ME172V|ME173X|TF300T',
    153         'BlackBerryTablet'  => 'PlayBook|RIM Tablet',
    154         'HTCtablet'         => 'HTC Flyer|HTC Jetstream|HTC-P715a|HTC EVO View 4G|PG41200',
    155         'MotorolaTablet'    => 'xoom|sholest|MZ615|MZ605|MZ505|MZ601|MZ602|MZ603|MZ604|MZ606|MZ607|MZ608|MZ609|MZ615|MZ616|MZ617',
    156         'NookTablet'        => 'Android.*Nook|NookColor|nook browser|BNRV200|BNRV200A|BNTV250|BNTV250A|BNTV400|BNTV600|LogicPD Zoom2',
    157         // @ref: http://www.acer.ro/ac/ro/RO/content/drivers
    158         // @ref: http://www.packardbell.co.uk/pb/en/GB/content/download (Packard Bell is part of Acer)
    159         // @note: Can conflict with Micromax phones codes.
    160         'AcerTablet'        => 'Android.*; \b(A100|A101|A110|A200|A210|A211|A500|A501|A510|A511|A700|A701|W500|W500P|W501|W501P|W510|W511|W700|G100|G100W|B1-A71)\b',
    161         // @ref: http://eu.computers.toshiba-europe.com/innovation/family/Tablets/1098744/banner_id/tablet_footerlink/
    162         // @ref: http://us.toshiba.com/tablets/tablet-finder
    163         // @ref: http://www.toshiba.co.jp/regza/tablet/
    164         'ToshibaTablet'     => 'Android.*(AT100|AT105|AT200|AT205|AT270|AT275|AT300|AT305|AT1S5|AT500|AT570|AT700|AT830)|TOSHIBA.*FOLIO',
    165         // @ref: http://www.nttdocomo.co.jp/english/service/developer/smart_phone/technical_info/spec/index.html
    166         'LGTablet'          => '\bL-06C|LG-V900|LG-V909\b',
    167         'FujitsuTablet'     => 'Android.*\b(F-01D|F-05E|F-10D|M532|Q572)\b',
    168         // Prestigio Tablets http://www.prestigio.com/support
    169         'PrestigioTablet'   => 'PMP3170B|PMP3270B|PMP3470B|PMP7170B|PMP3370B|PMP3570C|PMP5870C|PMP3670B|PMP5570C|PMP5770D|PMP3970B|PMP3870C|PMP5580C|PMP5880D|PMP5780D|PMP5588C|PMP7280C|PMP7280|PMP7880D|PMP5597D|PMP5597|PMP7100D|PER3464|PER3274|PER3574|PER3884|PER5274|PER5474|PMP5097CPRO|PMP5097|PMP7380D',
    170         // @ref: http://support.lenovo.com/en_GB/downloads/default.page?#
    171         'LenovoTablet'      => 'IdeaTab|S2110|S6000|K3011|A3000|A1000|A2107|A2109|A1107',
    172         'YarvikTablet'      => 'Android.*(TAB210|TAB211|TAB224|TAB250|TAB260|TAB264|TAB310|TAB360|TAB364|TAB410|TAB411|TAB420|TAB424|TAB450|TAB460|TAB461|TAB464|TAB465|TAB467|TAB468)',
    173         'MedionTablet'      => 'Android.*\bOYO\b|LIFE.*(P9212|P9514|P9516|S9512)|LIFETAB',
    174         'ArnovaTablet'      => 'AN10G2|AN7bG3|AN7fG3|AN8G3|AN8cG3|AN7G3|AN9G3|AN7dG3|AN7dG3ST|AN7dG3ChildPad|AN10bG3|AN10bG3DT',
    175         // IRU.ru Tablets http://www.iru.ru/catalog/soho/planetable/
    176         'IRUTablet'         => 'M702pro',
    177         'MegafonTablet'     => 'MegaFon V9|ZTE V9',
    178         // @ref: http://www.allview.ro/produse/droseries/lista-tablete-pc/
    179         'AllViewTablet'           => 'Allview.*(Viva|Alldro|City|Speed|All TV|Frenzy|Quasar|Shine|TX1|AX1|AX2)',
    180         // @reference: http://wiki.archosfans.com/index.php?title=Main_Page
    181         'ArchosTablet'      => '\b(101G9|80G9|A101IT)\b',
    182         // @ref: http://www.ainol.com/plugin.php?identifier=ainol&module=product
    183         'AinolTablet'       => 'NOVO7|NOVO8|NOVO10|Novo7Aurora|Novo7Basic|NOVO7PALADIN|novo9-Spark',
    184         // @todo: inspect http://esupport.sony.com/US/p/select-system.pl?DIRECTOR=DRIVER
    185         // @ref: Readers http://www.atsuhiro-me.net/ebook/sony-reader/sony-reader-web-browser
    186         // @ref: http://www.sony.jp/support/tablet/
    187         'SonyTablet'        => 'Sony.*Tablet|Xperia Tablet|Sony Tablet S|SO-03E|SGPT12|SGPT121|SGPT122|SGPT123|SGPT111|SGPT112|SGPT113|SGPT211|SGPT213|SGP311|SGP312|SGP321|EBRD1101|EBRD1102|EBRD1201',
    188         // @ref: db + http://www.cube-tablet.com/buy-products.html
    189         'CubeTablet'        => 'Android.*(K8GT|U9GT|U10GT|U16GT|U17GT|U18GT|U19GT|U20GT|U23GT|U30GT)|CUBE U8GT',
    190         // @ref: http://www.cobyusa.com/?p=pcat&pcat_id=3001
    191         'CobyTablet'        => 'MID1042|MID1045|MID1125|MID1126|MID7012|MID7014|MID7015|MID7034|MID7035|MID7036|MID7042|MID7048|MID7127|MID8042|MID8048|MID8127|MID9042|MID9740|MID9742|MID7022|MID7010',
    192         // @ref: http://www.match.net.cn/products.asp
    193         'MIDTablet'         => 'M9701|M9000|M9100|M806|M1052|M806|T703|MID701|MID713|MID710|MID727|MID760|MID830|MID728|MID933|MID125|MID810|MID732|MID120|MID930|MID800|MID731|MID900|MID100|MID820|MID735|MID980|MID130|MID833|MID737|MID960|MID135|MID860|MID736|MID140|MID930|MID835|MID733',
    194         // @ref: http://pdadb.net/index.php?m=pdalist&list=SMiT (NoName Chinese Tablets)
    195         // @ref: http://www.imp3.net/14/show.php?itemid=20454
    196         'SMiTTablet'        => 'Android.*(\bMID\b|MID-560|MTV-T1200|MTV-PND531|MTV-P1101|MTV-PND530)',
    197         // @ref: http://www.rock-chips.com/index.php?do=prod&pid=2
    198         'RockChipTablet'    => 'Android.*(RK2818|RK2808A|RK2918|RK3066)|RK2738|RK2808A',
    199         // @ref: http://www.fly-phone.com/devices/tablets/ ; http://www.fly-phone.com/service/
    200         'FlyTablet'         => 'IQ310|Fly Vision',
    201         // @ref: http://www.bqreaders.com/gb/tablets-prices-sale.html
    202         'bqTablet'          => 'bq.*(Elcano|Curie|Edison|Maxwell|Kepler|Pascal|Tesla|Hypatia|Platon|Newton|Livingstone|Cervantes|Avant)|Maxwell.*Lite|Maxwell.*Plus',
    203         // @ref: http://www.huaweidevice.com/worldwide/productFamily.do?method=index&directoryId=5011&treeId=3290
    204         // @ref: http://www.huaweidevice.com/worldwide/downloadCenter.do?method=index&directoryId=3372&treeId=0&tb=1&type=software (including legacy tablets)
    205         'HuaweiTablet'      => 'MediaPad|IDEOS S7|S7-201c|S7-202u|S7-101|S7-103|S7-104|S7-105|S7-106|S7-201|S7-Slim',
    206         // Nec or Medias Tab
    207         'NecTablet'         => '\bN-06D|\bN-08D',
    208         // Pantech Tablets: http://www.pantechusa.com/phones/
    209         'PantechTablet'     => 'Pantech.*P4100',
    210         // Broncho Tablets: http://www.broncho.cn/ (hard to find)
    211         'BronchoTablet'     => 'Broncho.*(N701|N708|N802|a710)',
    212         // @ref: http://versusuk.com/support.html
    213         'VersusTablet'      => 'TOUCHPAD.*[78910]|\bTOUCHTAB\b',
    214         // @ref: http://www.zync.in/index.php/our-products/tablet-phablets
    215         'ZyncTablet'        => 'z1000|Z99 2G|z99|z930|z999|z990|z909|Z919|z900',
    216         // @ref: http://www.positivoinformatica.com.br/www/pessoal/tablet-ypy/
    217         'PositivoTablet'    => 'TB07STA|TB10STA|TB07FTA|TB10FTA',
    218         // @ref: https://www.nabitablet.com/
    219         'NabiTablet'        => 'Android.*\bNabi',
    220         'KoboTablet'        => 'Kobo Touch|\bK080\b|\bVox\b Build|\bArc\b Build',
    221         // French Danew Tablets http://www.danew.com/produits-tablette.php
    222         'DanewTablet'       => 'DSlide.*\b(700|701R|702|703R|704|802|970|971|972|973|974|1010|1012)\b',
    223         // Texet Tablets and Readers http://www.texet.ru/tablet/
    224         'TexetTablet'       => 'NaviPad|TB-772A|TM-7045|TM-7055|TM-9750|TM-7016|TM-7024|TM-7026|TM-7041|TM-7043|TM-7047|TM-8041|TM-9741|TM-9747|TM-9748|TM-9751|TM-7022|TM-7021|TM-7020|TM-7011|TM-7010|TM-7023|TM-7025|TM-7037W|TM-7038W|TM-7027W|TM-9720|TM-9725|TM-9737W|TM-1020|TM-9738W|TM-9740|TM-9743W|TB-807A|TB-771A|TB-727A|TB-725A|TB-719A|TB-823A|TB-805A|TB-723A|TB-715A|TB-707A|TB-705A|TB-709A|TB-711A|TB-890HD|TB-880HD|TB-790HD|TB-780HD|TB-770HD|TB-721HD|TB-710HD|TB-434HD|TB-860HD|TB-840HD|TB-760HD|TB-750HD|TB-740HD|TB-730HD|TB-722HD|TB-720HD|TB-700HD|TB-500HD|TB-470HD|TB-431HD|TB-430HD|TB-506|TB-504|TB-446|TB-436|TB-416|TB-146SE|TB-126SE',
    225         // @note: Avoid detecting 'PLAYSTATION 3' as mobile.
    226         'PlaystationTablet' => 'Playstation.*(Portable|Vita)',
    227         // @ref: http://www.galapad.net/product.html
    228         'GalapadTablet'     => 'Android.*\bG1\b',
    229         // @ref: http://www.micromaxinfo.com/tablet/funbook
    230         'MicromaxTablet'    => 'Funbook|Micromax.*\b(P250|P560|P360|P362|P600|P300|P350|P500|P275)\b',
    231         // http://www.karbonnmobiles.com/products_tablet.php
    232         'KarbonnTablet'     => 'Android.*\b(A39|A37|A34|ST8|ST10|ST7|Smart Tab3|Smart Tab2)\b',
    233         // @ref: http://www.myallfine.com/Products.asp
    234         'AllFineTablet'     => 'Fine7 Genius|Fine7 Shine|Fine7 Air|Fine8 Style|Fine9 More|Fine10 Joy|Fine11 Wide',
    235         // @ref: http://www.proscanvideo.com/products-search.asp?itemClass=TABLET&itemnmbr=
    236         'PROSCANTablet'     => '\b(PEM63|PLT1023G|PLT1041|PLT1044|PLT1044G|PLT1091|PLT4311|PLT4311PL|PLT4315|PLT7030|PLT7033|PLT7033D|PLT7035|PLT7035D|PLT7044K|PLT7045K|PLT7045KB|PLT7071KG|PLT7072|PLT7223G|PLT7225G|PLT7777G|PLT7810K|PLT7849G|PLT7851G|PLT7852G|PLT8015|PLT8031|PLT8034|PLT8036|PLT8080K|PLT8082|PLT8088|PLT8223G|PLT8234G|PLT8235G|PLT8816K|PLT9011|PLT9045K|PLT9233G|PLT9735|PLT9760G|PLT9770G)\b',
    237         // @ref: http://www.yonesnav.com/products/products.php
    238         'YONESTablet' => 'BQ1078|BC1003|BC1077|RK9702|BC9730|BC9001|IT9001|BC7008|BC7010|BC708|BC728|BC7012|BC7030|BC7027|BC7026',
    239         // @ref: http://www.cjshowroom.com/eproducts.aspx?classcode=004001001
    240         // China manufacturer makes tablets for different small brands (eg. http://www.zeepad.net/index.html)
    241         'ChangJiaTablet'    => 'TPC7102|TPC7103|TPC7105|TPC7106|TPC7107|TPC7201|TPC7203|TPC7205|TPC7210|TPC7708|TPC7709|TPC7712|TPC7110|TPC8101|TPC8103|TPC8105|TPC8106|TPC8203|TPC8205|TPC8503|TPC9106|TPC9701|TPC97101|TPC97103|TPC97105|TPC97106|TPC97111|TPC97113|TPC97203|TPC97603|TPC97809|TPC97205|TPC10101|TPC10103|TPC10106|TPC10111|TPC10203|TPC10205|TPC10503',
    242         // @ref: http://www.gloryunion.cn/products.asp
    243         // @ref: http://www.allwinnertech.com/en/apply/mobile.html
    244         // @ref: http://www.ptcl.com.pk/pd_content.php?pd_id=284 (EVOTAB)
    245         // aka. Cute or Cool tablets. Not sure yet, must research to avoid collisions.
    246         'GUTablet'          => 'TX-A1301|TX-M9002|Q702', // A12R|D75A|D77|D79|R83|A95|A106C|R15|A75|A76|D71|D72|R71|R73|R77|D82|R85|D92|A97|D92|R91|A10F|A77F|W71F|A78F|W78F|W81F|A97F|W91F|W97F|R16G|C72|C73E|K72|K73|R96G
    247         // @ref: http://www.telstra.com.au/home-phone/thub-2/
    248         'TelstraTablet'     => 'T-Hub2',
    249         'GenericTablet'     => 'Android.*\b97D\b|Tablet(?!.*PC)|ViewPad7|BNTV250A|MID-WCDMA|LogicPD Zoom2|\bA7EB\b|CatNova8|A1_07|CT704|CT1002|\bM721\b|rk30sdk|\bEVOTAB\b',
    250     );
    251 
    252     /**
    253      * List of mobile Operating Systems.
    254      *
    255      * @var array
    256      */
    257     protected static $operatingSystems = array(
    258         'AndroidOS'         => 'Android',
    259         'BlackBerryOS'      => 'blackberry|\bBB10\b|rim tablet os',
    260         'PalmOS'            => 'PalmOS|avantgo|blazer|elaine|hiptop|palm|plucker|xiino',
    261         'SymbianOS'         => 'Symbian|SymbOS|Series60|Series40|SYB-[0-9]+|\bS60\b',
    262         // @reference: http://en.wikipedia.org/wiki/Windows_Mobile
    263         'WindowsMobileOS'   => 'Windows CE.*(PPC|Smartphone|Mobile|[0-9]{3}x[0-9]{3})|Window Mobile|Windows Phone [0-9.]+|WCE;',
    264         // @reference: http://en.wikipedia.org/wiki/Windows_Phone
    265         // http://wifeng.cn/?r=blog&a=view&id=106
    266         // http://nicksnettravels.builttoroam.com/post/2011/01/10/Bogus-Windows-Phone-7-User-Agent-String.aspx
    267         'WindowsPhoneOS'   => 'Windows Phone 8.0|Windows Phone OS|XBLWP7|ZuneWP7',
    268         'iOS'               => '\biPhone.*Mobile|\biPod|\biPad',
    269         // http://en.wikipedia.org/wiki/MeeGo
    270         // @todo: research MeeGo in UAs
    271         'MeeGoOS'           => 'MeeGo',
    272         // http://en.wikipedia.org/wiki/Maemo
    273         // @todo: research Maemo in UAs
    274         'MaemoOS'           => 'Maemo',
    275         'JavaOS'            => 'J2ME/|\bMIDP\b|\bCLDC\b', // '|Java/' produces bug #135
    276         'webOS'             => 'webOS|hpwOS',
    277         'badaOS'            => '\bBada\b',
    278         'BREWOS'            => 'BREW',
    279     );
    280 
    281     /**
    282      * List of mobile User Agents.
    283      *
    284      * @var array
    285      */
    286     protected static $browsers = array(
    287         // @reference: https://developers.google.com/chrome/mobile/docs/user-agent
    288         'Chrome'          => '\bCrMo\b|CriOS|Android.*Chrome/[.0-9]* (Mobile)?',
    289         'Dolfin'          => '\bDolfin\b',
    290         'Opera'           => 'Opera.*Mini|Opera.*Mobi|Android.*Opera|Mobile.*OPR/[0-9.]+',
    291         'Skyfire'         => 'Skyfire',
    292         'IE'              => 'IEMobile|MSIEMobile', // |Trident/[.0-9]+
    293         'Firefox'         => 'fennec|firefox.*maemo|(Mobile|Tablet).*Firefox|Firefox.*Mobile',
    294         'Bolt'            => 'bolt',
    295         'TeaShark'        => 'teashark',
    296         'Blazer'          => 'Blazer',
    297         // @reference: http://developer.apple.com/library/safari/#documentation/AppleApplications/Reference/SafariWebContent/OptimizingforSafarioniPhone/OptimizingforSafarioniPhone.html#//apple_ref/doc/uid/TP40006517-SW3
    298         'Safari'          => 'Version.*Mobile.*Safari|Safari.*Mobile',
    299         // @ref: http://en.wikipedia.org/wiki/Midori_(web_browser)
    300         //'Midori'          => 'midori',
    301         'Tizen'           => 'Tizen',
    302         'UCBrowser'       => 'UC.*Browser|UCWEB',
    303         // @ref: https://github.com/serbanghita/Mobile-Detect/issues/7
    304         'DiigoBrowser'    => 'DiigoBrowser',
    305         // http://www.puffinbrowser.com/index.php
    306         'Puffin'            => 'Puffin',
    307         // @ref: http://mercury-browser.com/index.html
    308         'Mercury'          => '\bMercury\b',
    309         // @reference: http://en.wikipedia.org/wiki/Minimo
    310         // http://en.wikipedia.org/wiki/Vision_Mobile_Browser
    311         'GenericBrowser'  => 'NokiaBrowser|OviBrowser|OneBrowser|TwonkyBeamBrowser|SEMC.*Browser|FlyFlow|Minimo|NetFront|Novarra-Vision|MQQBrowser|MicroMessenger'
    312     );
    313 
    314     /**
    315      * Utilities.
    316      *
    317      * @var array
    318      */
    319     protected static $utilities = array(
    320         // Experimental. When a mobile device wants to switch to 'Desktop Mode'.
    321         // @ref: http://scottcate.com/technology/windows-phone-8-ie10-desktop-or-mobile/
    322         // @ref: https://github.com/serbanghita/Mobile-Detect/issues/57#issuecomment-15024011
    323         'DesktopMode' => 'WPDesktop',
    324         'TV'          => 'SonyDTV|HbbTV', // experimental
    325         'WebKit'      => '(webkit)[ /]([\w.]+)',
    326         'Bot'         => 'Googlebot|DoCoMo|YandexBot|bingbot|ia_archiver|AhrefsBot|Ezooms|GSLFbot|WBSearchBot|Twitterbot|TweetmemeBot|Twikle|PaperLiBot|Wotbox|UnwindFetchor|facebookexternalhit',
    327         'MobileBot'   => 'Googlebot-Mobile|DoCoMo|YahooSeeker/M1A1-R2D2',
    328         'Console'     => '\b(Nintendo|Nintendo WiiU|PLAYSTATION|Xbox)\b',
    329         'Watch'       => 'SM-V700',
    330     );
    331 
    332     /**
    333      * The individual segments that could exist in a User-Agent string. VER refers to the regular
    334      * expression defined in the constant self::VER.
    335      *
    336      * @var array
    337      */
    338     protected static $properties = array(
    339 
    340         // Build
    341         'Mobile'        => 'Mobile/[VER]',
    342         'Build'         => 'Build/[VER]',
    343         'Version'       => 'Version/[VER]',
    344         'VendorID'      => 'VendorID/[VER]',
    345 
    346         // Devices
    347         'iPad'          => 'iPad.*CPU[a-z ]+[VER]',
    348         'iPhone'        => 'iPhone.*CPU[a-z ]+[VER]',
    349         'iPod'          => 'iPod.*CPU[a-z ]+[VER]',
    350         //'BlackBerry'    => array('BlackBerry[VER]', 'BlackBerry [VER];'),
    351         'Kindle'        => 'Kindle/[VER]',
    352 
    353         // Browser
    354         'Chrome'        => array('Chrome/[VER]', 'CriOS/[VER]', 'CrMo/[VER]'),
    355         'Dolfin'        => 'Dolfin/[VER]',
    356         // @reference: https://developer.mozilla.org/en-US/docs/User_Agent_Strings_Reference
    357         'Firefox'       => 'Firefox/[VER]',
    358         'Fennec'        => 'Fennec/[VER]',
    359         // @reference: http://msdn.microsoft.com/en-us/library/ms537503(v=vs.85).aspx
    360         'IE'      => array('IEMobile/[VER];', 'IEMobile [VER]', 'MSIE [VER];'),
    361         // http://en.wikipedia.org/wiki/NetFront
    362         'NetFront'      => 'NetFront/[VER]',
    363         'NokiaBrowser'  => 'NokiaBrowser/[VER]',
    364         'Opera'         => array( ' OPR/[VER]', 'Opera Mini/[VER]', 'Version/[VER]' ),
    365         'Opera Mini'    => 'Opera Mini/[VER]',
    366         'Opera Mobi'    => 'Version/[VER]',
    367         'UC Browser'    => 'UC Browser[VER]',
    368         'MQQBrowser'    => 'MQQBrowser/[VER]',
    369         'MicroMessenger' => 'MicroMessenger/[VER]',
    370         // @note: Safari 7534.48.3 is actually Version 5.1.
    371         // @note: On BlackBerry the Version is overwriten by the OS.
    372         'Safari'        => array( 'Version/[VER]', 'Safari/[VER]' ),
    373         'Skyfire'       => 'Skyfire/[VER]',
    374         'Tizen'         => 'Tizen/[VER]',
    375         'Webkit'        => 'webkit[ /][VER]',
    376 
    377         // Engine
    378         'Gecko'         => 'Gecko/[VER]',
    379         'Trident'       => 'Trident/[VER]',
    380         'Presto'        => 'Presto/[VER]',
    381 
    382         // OS
    383         'iOS'              => ' \bOS\b [VER] ',
    384         'Android'          => 'Android [VER]',
    385         'BlackBerry'       => array('BlackBerry[\w]+/[VER]', 'BlackBerry.*Version/[VER]', 'Version/[VER]'),
    386         'BREW'             => 'BREW [VER]',
    387         'Java'             => 'Java/[VER]',
    388         // @reference: http://windowsteamblog.com/windows_phone/b/wpdev/archive/2011/08/29/introducing-the-ie9-on-windows-phone-mango-user-agent-string.aspx
    389         // @reference: http://en.wikipedia.org/wiki/Windows_NT#Releases
    390         'Windows Phone OS' => array( 'Windows Phone OS [VER]', 'Windows Phone [VER]'),
    391         'Windows Phone'    => 'Windows Phone [VER]',
    392         'Windows CE'       => 'Windows CE/[VER]',
    393         // http://social.msdn.microsoft.com/Forums/en-US/windowsdeveloperpreviewgeneral/thread/6be392da-4d2f-41b4-8354-8dcee20c85cd
    394         'Windows NT'       => 'Windows NT [VER]',
    395         'Symbian'          => array('SymbianOS/[VER]', 'Symbian/[VER]'),
    396         'webOS'            => array('webOS/[VER]', 'hpwOS/[VER];'),
    397     );
    398 
    399     /**
    400      * Construct an instance of this class.
    401      *
    402      * @param array $headers Specify the headers as injection. Should be PHP _SERVER flavored.
    403      *                       If left empty, will use the global _SERVER['HTTP_*'] vars instead.
    404      * @param string $userAgent Inject the User-Agent header. If null, will use HTTP_USER_AGENT
    405      *                          from the $headers array instead.
    406      */
    407     public function __construct(
    408         array $headers = null,
    409         $userAgent = null
    410     ){
    411         $this->setHttpHeaders($headers);
    412         $this->setUserAgent($userAgent);
    413     }
    414 
    415     /**
    416     * Get the current script version.
    417     * This is useful for the demo.php file,
    418     * so people can check on what version they are testing
    419     * for mobile devices.
    420     *
    421     * @return string The version number in semantic version format.
    422     */
    423     public static function getScriptVersion()
     38    class Mobile_Detect
    42439    {
    425         return self::VERSION;
    426     }
    427 
    428     /**
    429      * Set the HTTP Headers. Must be PHP-flavored. This method will reset existing headers.
    430      *
    431      * @param array $httpHeaders The headers to set. If null, then using PHP's _SERVER to extract
    432      *                           the headers. The default null is left for backwards compatibilty.
    433      */
    434     public function setHttpHeaders($httpHeaders = null)
    435     {
    436         //use global _SERVER if $httpHeaders aren't defined
    437         if (!is_array($httpHeaders) || !count($httpHeaders)) {
    438             $httpHeaders = $_SERVER;
    439         }
    440 
    441         //clear existing headers
    442         $this->httpHeaders = array();
    443 
    444         //Only save HTTP headers. In PHP land, that means only _SERVER vars that
    445         //start with HTTP_.
    446         foreach ($httpHeaders as $key => $value) {
    447             if (substr($key,0,5) == 'HTTP_') {
    448                 $this->httpHeaders[$key] = $value;
    449             }
    450         }
    451     }
    452 
    453     /**
    454      * Retrieves the HTTP headers.
    455      *
    456      * @return array
    457      */
    458     public function getHttpHeaders()
    459     {
    460         return $this->httpHeaders;
    461     }
    462 
    463     /**
    464      * Retrieves a particular header. If it doesn't exist, no exception/error is caused.
    465      * Simply null is returned.
    466      *
    467      * @param string $header The name of the header to retrieve. Can be HTTP compliant such as
    468      *                       "User-Agent" or "X-Device-User-Agent" or can be php-esque with the
    469      *                       all-caps, HTTP_ prefixed, underscore seperated awesomeness.
    470      *
    471      * @return string|null The value of the header.
    472      */
    473     public function getHttpHeader($header)
    474     {
    475         //are we using PHP-flavored headers?
    476         if (strpos($header, '_') === false) {
    477             $header = str_replace('-', '_', $header);
    478             $header = strtoupper($header);
    479         }
    480 
    481         //test the alternate, too
    482         $altHeader = 'HTTP_' . $header;
    483 
    484         //Test both the regular and the HTTP_ prefix
    485         if (isset($this->httpHeaders[$header])) {
    486             return $this->httpHeaders[$header];
    487         } elseif (isset($this->httpHeaders[$altHeader])) {
    488             return $this->httpHeaders[$altHeader];
    489         }
    490     }
    491 
    492     /**
    493      * Set the User-Agent to be used.
    494      *
    495      * @param string $userAgent The user agent string to set.
    496      */
    497     public function setUserAgent($userAgent = null)
    498     {
    499         if (!empty($userAgent)) {
    500             $this->userAgent = $userAgent;
    501         } else {
    502             $this->userAgent = $this->getHttpHeader('User-Agent');
    503 
    504             if (empty($this->userAgent)) {
    505                 $this->userAgent = $this->getHttpHeader('X-Device-User-Agent');
    506             }
    507 
    508             //Header can occur on devices using Opera Mini (can expose the real device type).
    509             //Let's concatenate it (we need this extra info in the regexes).
    510             if ($operaMiniUa = $this->getHttpHeader('X-OperaMini-Phone-UA')) {
    511                 $this->userAgent .= ' ' . $operaMiniUa;
    512             }
    513         }
    514     }
    515 
    516     /**
    517      * Retrieve the User-Agent.
    518      *
    519      * @return string|null The user agent if it's set.
    520      */
    521     public function getUserAgent()
    522     {
    523         return $this->userAgent;
    524     }
    525 
    526     /**
    527      * Set the detection type. Must be one of self::DETECTION_TYPE_MOBILE or
    528      * self::DETECTION_TYPE_EXTENDED. Otherwise, nothing is set.
    529      *
    530      * @param string $type The type. Must be a self::DETECTION_TYPE_* constant. The default
    531      *                     parameter is null which will default to self::DETECTION_TYPE_MOBILE.
    532      */
    533     public function setDetectionType($type = null)
    534     {
    535         if ($type === null) {
    536             $type = self::DETECTION_TYPE_MOBILE;
    537         }
    538 
    539         if ($type != self::DETECTION_TYPE_MOBILE && $type != self::DETECTION_TYPE_EXTENDED) {
    540             return;
    541         }
    542 
    543         $this->detectionType = $type;
    544     }
    545 
    546     /**
    547      * Retrieve the list of known phone devices.
    548      *
    549      * @return array List of phone devices.
    550      */
    551     public static function getPhoneDevices()
    552     {
    553         return self::$phoneDevices;
    554     }
    555 
    556     /**
    557      * Retrieve the list of known tablet devices.
    558      *
    559      * @return array List of tablet devices.
    560      */
    561     public static function getTabletDevices()
    562     {
    563         return self::$tabletDevices;
    564     }
    565 
    566     /**
    567      * Alias for getBrowsers() method.
    568      *
    569      * @return array List of user agents.
    570      */
    571     public static function getUserAgents()
    572     {
    573         return self::getBrowsers();
    574     }
    575 
    576     /**
    577      * Retrieve the list of known browsers. Specifically, the user agents.
    578      *
    579      * @return array List of browsers / user agents.
    580      */
    581     public static function getBrowsers()
    582     {
    583         return self::$browsers;
    584     }
    585 
    586     /**
    587      * Retrieve the list of known utilities.
    588      *
    589      * @return array List of utilities.
    590      */
    591     public static function getUtilities()
    592     {
    593         return self::$utilities;
    594     }
    595 
    596     /**
    597      * Method gets the mobile detection rules. This method is used for the magic methods $detect->is*().
    598      *
    599      * @return array All the rules (but not extended).
    600      */
    601     public static function getMobileDetectionRules()
    602     {
    603         static $rules;
    604 
    605         if (!$rules) {
    606             $rules = array_merge(
    607                 self::$phoneDevices,
    608                 self::$tabletDevices,
    609                 self::$operatingSystems,
    610                 self::$browsers
     40        /**
     41         * Mobile detection type.
     42         */
     43        const DETECTION_TYPE_MOBILE     = 'mobile';
     44   
     45        /**
     46         * Extended detection type.
     47         */
     48        const DETECTION_TYPE_EXTENDED   = 'extended';
     49   
     50        /**
     51         * A frequently used regular expression to extract version #s.
     52         */
     53        const VER                       = '([\w._\+]+)';
     54   
     55        /**
     56         * Top-level device.
     57         */
     58        const MOBILE_GRADE_A            = 'A';
     59   
     60        /**
     61         * Mid-level device.
     62         */
     63        const MOBILE_GRADE_B            = 'B';
     64   
     65        /**
     66         * Low-level device.
     67         */
     68        const MOBILE_GRADE_C            = 'C';
     69   
     70        /**
     71         * Stores the version number of the current release.
     72         */
     73        const VERSION                   = '2.6.9';
     74   
     75        /**
     76         * A type for the version() method indicating a string return value.
     77         */
     78        const VERSION_TYPE_STRING       = 'text';
     79   
     80        /**
     81         * A type for the version() method indicating a float return value.
     82         */
     83        const VERSION_TYPE_FLOAT        = 'float';
     84   
     85        /**
     86         * The User-Agent HTTP header is stored in here.
     87         * @var string
     88         */
     89        protected $userAgent = null;
     90   
     91        /**
     92         * HTTP headers in the PHP-flavor. So HTTP_USER_AGENT and SERVER_SOFTWARE.
     93         * @var array
     94         */
     95        protected $httpHeaders = array();
     96   
     97        /**
     98         * The detection type, using self::DETECTION_TYPE_MOBILE or self::DETECTION_TYPE_EXTENDED.
     99         *
     100         * @var string
     101         */
     102        protected $detectionType = self::DETECTION_TYPE_MOBILE;
     103   
     104        /**
     105         * List of mobile devices (phones).
     106         *
     107         * @var array
     108         */
     109        protected static $phoneDevices = array(
     110            'iPhone'        => '\biPhone.*Mobile|\biPod', // |\biTunes
     111            'BlackBerry'    => 'BlackBerry|\bBB10\b|rim[0-9]+',
     112            'HTC'           => 'HTC|HTC.*(Sensation|Evo|Vision|Explorer|6800|8100|8900|A7272|S510e|C110e|Legend|Desire|T8282)|APX515CKT|Qtek9090|APA9292KT|HD_mini|Sensation.*Z710e|PG86100|Z715e|Desire.*(A8181|HD)|ADR6200|ADR6400L|ADR6425|001HT|Inspire 4G|Android.*\bEVO\b',
     113            'Nexus'         => 'Nexus One|Nexus S|Galaxy.*Nexus|Android.*Nexus.*Mobile',
     114            // @todo: Is 'Dell Streak' a tablet or a phone? ;)
     115            'Dell'          => 'Dell.*Streak|Dell.*Aero|Dell.*Venue|DELL.*Venue Pro|Dell Flash|Dell Smoke|Dell Mini 3iX|XCD28|XCD35|\b001DL\b|\b101DL\b|\bGS01\b',
     116            'Motorola'      => 'Motorola|\bDroid\b.*Build|DROIDX|Android.*Xoom|HRI39|MOT-|A1260|A1680|A555|A853|A855|A953|A955|A956|Motorola.*ELECTRIFY|Motorola.*i1|i867|i940|MB200|MB300|MB501|MB502|MB508|MB511|MB520|MB525|MB526|MB611|MB612|MB632|MB810|MB855|MB860|MB861|MB865|MB870|ME501|ME502|ME511|ME525|ME600|ME632|ME722|ME811|ME860|ME863|ME865|MT620|MT710|MT716|MT720|MT810|MT870|MT917|Motorola.*TITANIUM|WX435|WX445|XT300|XT301|XT311|XT316|XT317|XT319|XT320|XT390|XT502|XT530|XT531|XT532|XT535|XT603|XT610|XT611|XT615|XT681|XT701|XT702|XT711|XT720|XT800|XT806|XT860|XT862|XT875|XT882|XT883|XT894|XT901|XT907|XT909|XT910|XT912|XT928|XT926|XT915|XT919|XT925',
     117            'Samsung'       => 'Samsung|SGH-I337|BGT-S5230|GT-B2100|GT-B2700|GT-B2710|GT-B3210|GT-B3310|GT-B3410|GT-B3730|GT-B3740|GT-B5510|GT-B5512|GT-B5722|GT-B6520|GT-B7300|GT-B7320|GT-B7330|GT-B7350|GT-B7510|GT-B7722|GT-B7800|GT-C3010|GT-C3011|GT-C3060|GT-C3200|GT-C3212|GT-C3212I|GT-C3262|GT-C3222|GT-C3300|GT-C3300K|GT-C3303|GT-C3303K|GT-C3310|GT-C3322|GT-C3330|GT-C3350|GT-C3500|GT-C3510|GT-C3530|GT-C3630|GT-C3780|GT-C5010|GT-C5212|GT-C6620|GT-C6625|GT-C6712|GT-E1050|GT-E1070|GT-E1075|GT-E1080|GT-E1081|GT-E1085|GT-E1087|GT-E1100|GT-E1107|GT-E1110|GT-E1120|GT-E1125|GT-E1130|GT-E1160|GT-E1170|GT-E1175|GT-E1180|GT-E1182|GT-E1200|GT-E1210|GT-E1225|GT-E1230|GT-E1390|GT-E2100|GT-E2120|GT-E2121|GT-E2152|GT-E2220|GT-E2222|GT-E2230|GT-E2232|GT-E2250|GT-E2370|GT-E2550|GT-E2652|GT-E3210|GT-E3213|GT-I5500|GT-I5503|GT-I5700|GT-I5800|GT-I5801|GT-I6410|GT-I6420|GT-I7110|GT-I7410|GT-I7500|GT-I8000|GT-I8150|GT-I8160|GT-I8190|GT-I8320|GT-I8330|GT-I8350|GT-I8530|GT-I8700|GT-I8703|GT-I8910|GT-I9000|GT-I9001|GT-I9003|GT-I9010|GT-I9020|GT-I9023|GT-I9070|GT-I9082|GT-I9100|GT-I9103|GT-I9220|GT-I9250|GT-I9300|GT-I9305|GT-I9500|GT-I9505|GT-M3510|GT-M5650|GT-M7500|GT-M7600|GT-M7603|GT-M8800|GT-M8910|GT-N7000|GT-S3110|GT-S3310|GT-S3350|GT-S3353|GT-S3370|GT-S3650|GT-S3653|GT-S3770|GT-S3850|GT-S5210|GT-S5220|GT-S5229|GT-S5230|GT-S5233|GT-S5250|GT-S5253|GT-S5260|GT-S5263|GT-S5270|GT-S5300|GT-S5330|GT-S5350|GT-S5360|GT-S5363|GT-S5369|GT-S5380|GT-S5380D|GT-S5560|GT-S5570|GT-S5600|GT-S5603|GT-S5610|GT-S5620|GT-S5660|GT-S5670|GT-S5690|GT-S5750|GT-S5780|GT-S5830|GT-S5839|GT-S6102|GT-S6500|GT-S7070|GT-S7200|GT-S7220|GT-S7230|GT-S7233|GT-S7250|GT-S7500|GT-S7530|GT-S7550|GT-S7562|GT-S7710|GT-S8000|GT-S8003|GT-S8500|GT-S8530|GT-S8600|SCH-A310|SCH-A530|SCH-A570|SCH-A610|SCH-A630|SCH-A650|SCH-A790|SCH-A795|SCH-A850|SCH-A870|SCH-A890|SCH-A930|SCH-A950|SCH-A970|SCH-A990|SCH-I100|SCH-I110|SCH-I400|SCH-I405|SCH-I500|SCH-I510|SCH-I515|SCH-I600|SCH-I730|SCH-I760|SCH-I770|SCH-I830|SCH-I910|SCH-I920|SCH-I959|SCH-LC11|SCH-N150|SCH-N300|SCH-R100|SCH-R300|SCH-R351|SCH-R400|SCH-R410|SCH-T300|SCH-U310|SCH-U320|SCH-U350|SCH-U360|SCH-U365|SCH-U370|SCH-U380|SCH-U410|SCH-U430|SCH-U450|SCH-U460|SCH-U470|SCH-U490|SCH-U540|SCH-U550|SCH-U620|SCH-U640|SCH-U650|SCH-U660|SCH-U700|SCH-U740|SCH-U750|SCH-U810|SCH-U820|SCH-U900|SCH-U940|SCH-U960|SCS-26UC|SGH-A107|SGH-A117|SGH-A127|SGH-A137|SGH-A157|SGH-A167|SGH-A177|SGH-A187|SGH-A197|SGH-A227|SGH-A237|SGH-A257|SGH-A437|SGH-A517|SGH-A597|SGH-A637|SGH-A657|SGH-A667|SGH-A687|SGH-A697|SGH-A707|SGH-A717|SGH-A727|SGH-A737|SGH-A747|SGH-A767|SGH-A777|SGH-A797|SGH-A817|SGH-A827|SGH-A837|SGH-A847|SGH-A867|SGH-A877|SGH-A887|SGH-A897|SGH-A927|SGH-B100|SGH-B130|SGH-B200|SGH-B220|SGH-C100|SGH-C110|SGH-C120|SGH-C130|SGH-C140|SGH-C160|SGH-C170|SGH-C180|SGH-C200|SGH-C207|SGH-C210|SGH-C225|SGH-C230|SGH-C417|SGH-C450|SGH-D307|SGH-D347|SGH-D357|SGH-D407|SGH-D415|SGH-D780|SGH-D807|SGH-D980|SGH-E105|SGH-E200|SGH-E315|SGH-E316|SGH-E317|SGH-E335|SGH-E590|SGH-E635|SGH-E715|SGH-E890|SGH-F300|SGH-F480|SGH-I200|SGH-I300|SGH-I320|SGH-I550|SGH-I577|SGH-I600|SGH-I607|SGH-I617|SGH-I627|SGH-I637|SGH-I677|SGH-I700|SGH-I717|SGH-I727|SGH-i747M|SGH-I777|SGH-I780|SGH-I827|SGH-I847|SGH-I857|SGH-I896|SGH-I897|SGH-I900|SGH-I907|SGH-I917|SGH-I927|SGH-I937|SGH-I997|SGH-J150|SGH-J200|SGH-L170|SGH-L700|SGH-M110|SGH-M150|SGH-M200|SGH-N105|SGH-N500|SGH-N600|SGH-N620|SGH-N625|SGH-N700|SGH-N710|SGH-P107|SGH-P207|SGH-P300|SGH-P310|SGH-P520|SGH-P735|SGH-P777|SGH-Q105|SGH-R210|SGH-R220|SGH-R225|SGH-S105|SGH-S307|SGH-T109|SGH-T119|SGH-T139|SGH-T209|SGH-T219|SGH-T229|SGH-T239|SGH-T249|SGH-T259|SGH-T309|SGH-T319|SGH-T329|SGH-T339|SGH-T349|SGH-T359|SGH-T369|SGH-T379|SGH-T409|SGH-T429|SGH-T439|SGH-T459|SGH-T469|SGH-T479|SGH-T499|SGH-T509|SGH-T519|SGH-T539|SGH-T559|SGH-T589|SGH-T609|SGH-T619|SGH-T629|SGH-T639|SGH-T659|SGH-T669|SGH-T679|SGH-T709|SGH-T719|SGH-T729|SGH-T739|SGH-T746|SGH-T749|SGH-T759|SGH-T769|SGH-T809|SGH-T819|SGH-T839|SGH-T919|SGH-T929|SGH-T939|SGH-T959|SGH-T989|SGH-U100|SGH-U200|SGH-U800|SGH-V205|SGH-V206|SGH-X100|SGH-X105|SGH-X120|SGH-X140|SGH-X426|SGH-X427|SGH-X475|SGH-X495|SGH-X497|SGH-X507|SGH-X600|SGH-X610|SGH-X620|SGH-X630|SGH-X700|SGH-X820|SGH-X890|SGH-Z130|SGH-Z150|SGH-Z170|SGH-ZX10|SGH-ZX20|SHW-M110|SPH-A120|SPH-A400|SPH-A420|SPH-A460|SPH-A500|SPH-A560|SPH-A600|SPH-A620|SPH-A660|SPH-A700|SPH-A740|SPH-A760|SPH-A790|SPH-A800|SPH-A820|SPH-A840|SPH-A880|SPH-A900|SPH-A940|SPH-A960|SPH-D600|SPH-D700|SPH-D710|SPH-D720|SPH-I300|SPH-I325|SPH-I330|SPH-I350|SPH-I500|SPH-I600|SPH-I700|SPH-L700|SPH-M100|SPH-M220|SPH-M240|SPH-M300|SPH-M305|SPH-M320|SPH-M330|SPH-M350|SPH-M360|SPH-M370|SPH-M380|SPH-M510|SPH-M540|SPH-M550|SPH-M560|SPH-M570|SPH-M580|SPH-M610|SPH-M620|SPH-M630|SPH-M800|SPH-M810|SPH-M850|SPH-M900|SPH-M910|SPH-M920|SPH-M930|SPH-N100|SPH-N200|SPH-N240|SPH-N300|SPH-N400|SPH-Z400|SWC-E100|SCH-i909|GT-N7100|GT-N7105|SCH-I535',
     118            'LG'            => '\bLG\b;|(LG|LG-)?(C800|C900|E400|E610|E900|E-900|F160|F180K|F180L|F180S|730|855|L160|LS840|LS970|LU6200|MS690|MS695|MS770|MS840|MS870|MS910|P500|P700|P705|VM696|AS680|AS695|AX840|C729|E970|GS505|272|C395|E739BK|E960|L55C|L75C|LS696|LS860|P769BK|P350|P500|P509|P870|UN272|US730|VS840|VS950|LN272|LN510|LS670|LS855|LW690|MN270|MN510|P509|P769|P930|UN200|UN270|UN510|UN610|US670|US740|US760|UX265|UX840|VN271|VN530|VS660|VS700|VS740|VS750|VS910|VS920|VS930|VX9200|VX11000|AX840A|LW770|P506|P925|P999)',
     119            'Sony'          => 'SonyST|SonyLT|SonyEricsson|SonyEricssonLT15iv|LT18i|E10i|LT28h|SonyEricssonMT27i',
     120            'Asus'          => 'Asus.*Galaxy|PadFone.*Mobile',
     121            // @ref: http://www.micromaxinfo.com/mobiles/smartphones
     122            // Added because the codes might conflict with Acer Tablets.
     123            'Micromax'      => 'Micromax.*\b(A210|A92|A88|A72|A111|A110Q|A115|A116|A110|A90S|A26|A51|A35|A54|A25|A27|A89|A68|A65|A57|A90)\b',
     124            'Palm'          => 'PalmSource|Palm', // avantgo|blazer|elaine|hiptop|plucker|xiino ; @todo - complete the regex.
     125            'Vertu'         => 'Vertu|Vertu.*Ltd|Vertu.*Ascent|Vertu.*Ayxta|Vertu.*Constellation(F|Quest)?|Vertu.*Monika|Vertu.*Signature', // Just for fun ;)
     126            // @ref: http://www.pantech.co.kr/en/prod/prodList.do?gbrand=VEGA (PANTECH)
     127            // Most of the VEGA devices are legacy. PANTECH seem to be newer devices based on Android.
     128            'Pantech'       => 'PANTECH|IM-A850S|IM-A840S|IM-A830L|IM-A830K|IM-A830S|IM-A820L|IM-A810K|IM-A810S|IM-A800S|IM-T100K|IM-A725L|IM-A780L|IM-A775C|IM-A770K|IM-A760S|IM-A750K|IM-A740S|IM-A730S|IM-A720L|IM-A710K|IM-A690L|IM-A690S|IM-A650S|IM-A630K|IM-A600S|VEGA PTL21|PT003|P8010|ADR910L|P6030|P6020|P9070|P4100|P9060|P5000|CDM8992|TXT8045|ADR8995|IS11PT|P2030|P6010|P8000|PT002|IS06|CDM8999|P9050|PT001|TXT8040|P2020|P9020|P2000|P7040|P7000|C790',
     129            // @ref: http://www.fly-phone.com/devices/smartphones/ ; Included only smartphones.
     130            'Fly'           => 'IQ230|IQ444|IQ450|IQ440|IQ442|IQ441|IQ245|IQ256|IQ236|IQ255|IQ235|IQ245|IQ275|IQ240|IQ285|IQ280|IQ270|IQ260|IQ250',
     131            // Added simvalley mobile just for fun. They have some interesting devices.
     132            // @ref: http://www.simvalley.fr/telephonie---gps-_22_telephonie-mobile_telephones_.html
     133            'SimValley'     => '\b(SP-80|XT-930|SX-340|XT-930|SX-310|SP-360|SP60|SPT-800|SP-120|SPT-800|SP-140|SPX-5|SPX-8|SP-100|SPX-8|SPX-12)\b',
     134            // @Tapatalk is a mobile app; @ref: http://support.tapatalk.com/threads/smf-2-0-2-os-and-browser-detection-plugin-and-tapatalk.15565/#post-79039
     135            'GenericPhone'  => 'Tapatalk|PDA;|SAGEM|mmp|pocket|psp|symbian|Smartphone|smartfon|treo|up.browser|up.link|vodafone|wap|nokia|Series40|Series60|S60|SonyEricsson|N900|MAUI.*WAP.*Browser'
     136        );
     137   
     138        /**
     139         * List of tablet devices.
     140         *
     141         * @var array
     142         */
     143        protected static $tabletDevices = array(
     144            'iPad'              => 'iPad|iPad.*Mobile', // @todo: check for mobile friendly emails topic.
     145            'NexusTablet'       => '^.*Android.*Nexus(((?:(?!Mobile))|(?:(\s(7|10).+))).)*$',
     146            'SamsungTablet'     => 'SAMSUNG.*Tablet|Galaxy.*Tab|SC-01C|GT-P1000|GT-P1003|GT-P1010|GT-P3105|GT-P6210|GT-P6800|GT-P6810|GT-P7100|GT-P7300|GT-P7310|GT-P7500|GT-P7510|SCH-I800|SCH-I815|SCH-I905|SGH-I957|SGH-I987|SGH-T849|SGH-T859|SGH-T869|SPH-P100|GT-P3100|GT-P3108|GT-P3110|GT-P5100|GT-P5110|GT-P6200|GT-P7320|GT-P7511|GT-N8000|GT-P8510|SGH-I497|SPH-P500|SGH-T779|SCH-I705|SCH-I915|GT-N8013|GT-P3113|GT-P5113|GT-P8110|GT-N8010|GT-N8005|GT-N8020|GT-P1013|GT-P6201|GT-P7501|GT-N5100|GT-N5110|SHV-E140K|SHV-E140L|SHV-E140S|SHV-E150S|SHV-E230K|SHV-E230L|SHV-E230S|SHW-M180K|SHW-M180L|SHW-M180S|SHW-M180W|SHW-M300W|SHW-M305W|SHW-M380K|SHW-M380S|SHW-M380W|SHW-M430W|SHW-M480K|SHW-M480S|SHW-M480W|SHW-M485W|SHW-M486W|SHW-M500W|GT-I9228|SCH-P739|SCH-I925|GT-I9200|GT-I9205|GT-P5200|GT-P5210|SM-T311|SM-T310|SM-T210|SM-T211|SM-P900',
     147            // @reference: http://www.labnol.org/software/kindle-user-agent-string/20378/
     148            'Kindle'            => 'Kindle|Silk.*Accelerated|Android.*\b(KFTT|KFOTE)\b',
     149            // Only the Surface tablets with Windows RT are considered mobile.
     150            // @ref: http://msdn.microsoft.com/en-us/library/ie/hh920767(v=vs.85).aspx
     151            'SurfaceTablet'     => 'Windows NT [0-9.]+; ARM;',
     152            // @ref: http://shopping1.hp.com/is-bin/INTERSHOP.enfinity/WFS/WW-USSMBPublicStore-Site/en_US/-/USD/ViewStandardCatalog-Browse?CatalogCategoryID=JfIQ7EN5lqMAAAEyDcJUDwMT
     153            'HPTablet'          => 'HP Slate 7|HP ElitePad 900|hp-tablet|EliteBook.*Touch',
     154            // @note: watch out for PadFone, see #132
     155            'AsusTablet'        => 'Transformer|TF101|^.*PadFone((?!Mobile).)*$|ME301T|ME371MG|ME172V|ME173X|TF300T',
     156            'BlackBerryTablet'  => 'PlayBook|RIM Tablet',
     157            'HTCtablet'         => 'HTC Flyer|HTC Jetstream|HTC-P715a|HTC EVO View 4G|PG41200',
     158            'MotorolaTablet'    => 'xoom|sholest|MZ615|MZ605|MZ505|MZ601|MZ602|MZ603|MZ604|MZ606|MZ607|MZ608|MZ609|MZ615|MZ616|MZ617',
     159            'NookTablet'        => 'Android.*Nook|NookColor|nook browser|BNRV200|BNRV200A|BNTV250|BNTV250A|BNTV400|BNTV600|LogicPD Zoom2',
     160            // @ref: http://www.acer.ro/ac/ro/RO/content/drivers
     161            // @ref: http://www.packardbell.co.uk/pb/en/GB/content/download (Packard Bell is part of Acer)
     162            // @note: Can conflict with Micromax phones codes.
     163            'AcerTablet'        => 'Android.*; \b(A100|A101|A110|A200|A210|A211|A500|A501|A510|A511|A700|A701|W500|W500P|W501|W501P|W510|W511|W700|G100|G100W|B1-A71)\b',
     164            // @ref: http://eu.computers.toshiba-europe.com/innovation/family/Tablets/1098744/banner_id/tablet_footerlink/
     165            // @ref: http://us.toshiba.com/tablets/tablet-finder
     166            // @ref: http://www.toshiba.co.jp/regza/tablet/
     167            'ToshibaTablet'     => 'Android.*(AT100|AT105|AT200|AT205|AT270|AT275|AT300|AT305|AT1S5|AT500|AT570|AT700|AT830)|TOSHIBA.*FOLIO',
     168            // @ref: http://www.nttdocomo.co.jp/english/service/developer/smart_phone/technical_info/spec/index.html
     169            'LGTablet'          => '\bL-06C|LG-V900|LG-V909\b',
     170            'FujitsuTablet'     => 'Android.*\b(F-01D|F-05E|F-10D|M532|Q572)\b',
     171            // Prestigio Tablets http://www.prestigio.com/support
     172            'PrestigioTablet'   => 'PMP3170B|PMP3270B|PMP3470B|PMP7170B|PMP3370B|PMP3570C|PMP5870C|PMP3670B|PMP5570C|PMP5770D|PMP3970B|PMP3870C|PMP5580C|PMP5880D|PMP5780D|PMP5588C|PMP7280C|PMP7280|PMP7880D|PMP5597D|PMP5597|PMP7100D|PER3464|PER3274|PER3574|PER3884|PER5274|PER5474|PMP5097CPRO|PMP5097|PMP7380D',
     173            // @ref: http://support.lenovo.com/en_GB/downloads/default.page?#
     174            'LenovoTablet'      => 'IdeaTab|S2110|S6000|K3011|A3000|A1000|A2107|A2109|A1107',
     175            'YarvikTablet'      => 'Android.*(TAB210|TAB211|TAB224|TAB250|TAB260|TAB264|TAB310|TAB360|TAB364|TAB410|TAB411|TAB420|TAB424|TAB450|TAB460|TAB461|TAB464|TAB465|TAB467|TAB468)',
     176            'MedionTablet'      => 'Android.*\bOYO\b|LIFE.*(P9212|P9514|P9516|S9512)|LIFETAB',
     177            'ArnovaTablet'      => 'AN10G2|AN7bG3|AN7fG3|AN8G3|AN8cG3|AN7G3|AN9G3|AN7dG3|AN7dG3ST|AN7dG3ChildPad|AN10bG3|AN10bG3DT',
     178            // IRU.ru Tablets http://www.iru.ru/catalog/soho/planetable/
     179            'IRUTablet'         => 'M702pro',
     180            'MegafonTablet'     => 'MegaFon V9|ZTE V9',
     181            // @ref: http://www.allview.ro/produse/droseries/lista-tablete-pc/
     182            'AllViewTablet'           => 'Allview.*(Viva|Alldro|City|Speed|All TV|Frenzy|Quasar|Shine|TX1|AX1|AX2)',
     183            // @reference: http://wiki.archosfans.com/index.php?title=Main_Page
     184            'ArchosTablet'      => '\b(101G9|80G9|A101IT)\b',
     185            // @ref: http://www.ainol.com/plugin.php?identifier=ainol&module=product
     186            'AinolTablet'       => 'NOVO7|NOVO8|NOVO10|Novo7Aurora|Novo7Basic|NOVO7PALADIN|novo9-Spark',
     187            // @todo: inspect http://esupport.sony.com/US/p/select-system.pl?DIRECTOR=DRIVER
     188            // @ref: Readers http://www.atsuhiro-me.net/ebook/sony-reader/sony-reader-web-browser
     189            // @ref: http://www.sony.jp/support/tablet/
     190            'SonyTablet'        => 'Sony.*Tablet|Xperia Tablet|Sony Tablet S|SO-03E|SGPT12|SGPT121|SGPT122|SGPT123|SGPT111|SGPT112|SGPT113|SGPT211|SGPT213|SGP311|SGP312|SGP321|EBRD1101|EBRD1102|EBRD1201',
     191            // @ref: db + http://www.cube-tablet.com/buy-products.html
     192            'CubeTablet'        => 'Android.*(K8GT|U9GT|U10GT|U16GT|U17GT|U18GT|U19GT|U20GT|U23GT|U30GT)|CUBE U8GT',
     193            // @ref: http://www.cobyusa.com/?p=pcat&pcat_id=3001
     194            'CobyTablet'        => 'MID1042|MID1045|MID1125|MID1126|MID7012|MID7014|MID7015|MID7034|MID7035|MID7036|MID7042|MID7048|MID7127|MID8042|MID8048|MID8127|MID9042|MID9740|MID9742|MID7022|MID7010',
     195            // @ref: http://www.match.net.cn/products.asp
     196            'MIDTablet'         => 'M9701|M9000|M9100|M806|M1052|M806|T703|MID701|MID713|MID710|MID727|MID760|MID830|MID728|MID933|MID125|MID810|MID732|MID120|MID930|MID800|MID731|MID900|MID100|MID820|MID735|MID980|MID130|MID833|MID737|MID960|MID135|MID860|MID736|MID140|MID930|MID835|MID733',
     197            // @ref: http://pdadb.net/index.php?m=pdalist&list=SMiT (NoName Chinese Tablets)
     198            // @ref: http://www.imp3.net/14/show.php?itemid=20454
     199            'SMiTTablet'        => 'Android.*(\bMID\b|MID-560|MTV-T1200|MTV-PND531|MTV-P1101|MTV-PND530)',
     200            // @ref: http://www.rock-chips.com/index.php?do=prod&pid=2
     201            'RockChipTablet'    => 'Android.*(RK2818|RK2808A|RK2918|RK3066)|RK2738|RK2808A',
     202            // @ref: http://www.fly-phone.com/devices/tablets/ ; http://www.fly-phone.com/service/
     203            'FlyTablet'         => 'IQ310|Fly Vision',
     204            // @ref: http://www.bqreaders.com/gb/tablets-prices-sale.html
     205            'bqTablet'          => 'bq.*(Elcano|Curie|Edison|Maxwell|Kepler|Pascal|Tesla|Hypatia|Platon|Newton|Livingstone|Cervantes|Avant)|Maxwell.*Lite|Maxwell.*Plus',
     206            // @ref: http://www.huaweidevice.com/worldwide/productFamily.do?method=index&directoryId=5011&treeId=3290
     207            // @ref: http://www.huaweidevice.com/worldwide/downloadCenter.do?method=index&directoryId=3372&treeId=0&tb=1&type=software (including legacy tablets)
     208            'HuaweiTablet'      => 'MediaPad|IDEOS S7|S7-201c|S7-202u|S7-101|S7-103|S7-104|S7-105|S7-106|S7-201|S7-Slim',
     209            // Nec or Medias Tab
     210            'NecTablet'         => '\bN-06D|\bN-08D',
     211            // Pantech Tablets: http://www.pantechusa.com/phones/
     212            'PantechTablet'     => 'Pantech.*P4100',
     213            // Broncho Tablets: http://www.broncho.cn/ (hard to find)
     214            'BronchoTablet'     => 'Broncho.*(N701|N708|N802|a710)',
     215            // @ref: http://versusuk.com/support.html
     216            'VersusTablet'      => 'TOUCHPAD.*[78910]|\bTOUCHTAB\b',
     217            // @ref: http://www.zync.in/index.php/our-products/tablet-phablets
     218            'ZyncTablet'        => 'z1000|Z99 2G|z99|z930|z999|z990|z909|Z919|z900',
     219            // @ref: http://www.positivoinformatica.com.br/www/pessoal/tablet-ypy/
     220            'PositivoTablet'    => 'TB07STA|TB10STA|TB07FTA|TB10FTA',
     221            // @ref: https://www.nabitablet.com/
     222            'NabiTablet'        => 'Android.*\bNabi',
     223            'KoboTablet'        => 'Kobo Touch|\bK080\b|\bVox\b Build|\bArc\b Build',
     224            // French Danew Tablets http://www.danew.com/produits-tablette.php
     225            'DanewTablet'       => 'DSlide.*\b(700|701R|702|703R|704|802|970|971|972|973|974|1010|1012)\b',
     226            // Texet Tablets and Readers http://www.texet.ru/tablet/
     227            'TexetTablet'       => 'NaviPad|TB-772A|TM-7045|TM-7055|TM-9750|TM-7016|TM-7024|TM-7026|TM-7041|TM-7043|TM-7047|TM-8041|TM-9741|TM-9747|TM-9748|TM-9751|TM-7022|TM-7021|TM-7020|TM-7011|TM-7010|TM-7023|TM-7025|TM-7037W|TM-7038W|TM-7027W|TM-9720|TM-9725|TM-9737W|TM-1020|TM-9738W|TM-9740|TM-9743W|TB-807A|TB-771A|TB-727A|TB-725A|TB-719A|TB-823A|TB-805A|TB-723A|TB-715A|TB-707A|TB-705A|TB-709A|TB-711A|TB-890HD|TB-880HD|TB-790HD|TB-780HD|TB-770HD|TB-721HD|TB-710HD|TB-434HD|TB-860HD|TB-840HD|TB-760HD|TB-750HD|TB-740HD|TB-730HD|TB-722HD|TB-720HD|TB-700HD|TB-500HD|TB-470HD|TB-431HD|TB-430HD|TB-506|TB-504|TB-446|TB-436|TB-416|TB-146SE|TB-126SE',
     228            // @note: Avoid detecting 'PLAYSTATION 3' as mobile.
     229            'PlaystationTablet' => 'Playstation.*(Portable|Vita)',
     230            // @ref: http://www.galapad.net/product.html
     231            'GalapadTablet'     => 'Android.*\bG1\b',
     232            // @ref: http://www.micromaxinfo.com/tablet/funbook
     233            'MicromaxTablet'    => 'Funbook|Micromax.*\b(P250|P560|P360|P362|P600|P300|P350|P500|P275)\b',
     234            // http://www.karbonnmobiles.com/products_tablet.php
     235            'KarbonnTablet'     => 'Android.*\b(A39|A37|A34|ST8|ST10|ST7|Smart Tab3|Smart Tab2)\b',
     236            // @ref: http://www.myallfine.com/Products.asp
     237            'AllFineTablet'     => 'Fine7 Genius|Fine7 Shine|Fine7 Air|Fine8 Style|Fine9 More|Fine10 Joy|Fine11 Wide',
     238            // @ref: http://www.proscanvideo.com/products-search.asp?itemClass=TABLET&itemnmbr=
     239            'PROSCANTablet'     => '\b(PEM63|PLT1023G|PLT1041|PLT1044|PLT1044G|PLT1091|PLT4311|PLT4311PL|PLT4315|PLT7030|PLT7033|PLT7033D|PLT7035|PLT7035D|PLT7044K|PLT7045K|PLT7045KB|PLT7071KG|PLT7072|PLT7223G|PLT7225G|PLT7777G|PLT7810K|PLT7849G|PLT7851G|PLT7852G|PLT8015|PLT8031|PLT8034|PLT8036|PLT8080K|PLT8082|PLT8088|PLT8223G|PLT8234G|PLT8235G|PLT8816K|PLT9011|PLT9045K|PLT9233G|PLT9735|PLT9760G|PLT9770G)\b',
     240            // @ref: http://www.yonesnav.com/products/products.php
     241            'YONESTablet' => 'BQ1078|BC1003|BC1077|RK9702|BC9730|BC9001|IT9001|BC7008|BC7010|BC708|BC728|BC7012|BC7030|BC7027|BC7026',
     242            // @ref: http://www.cjshowroom.com/eproducts.aspx?classcode=004001001
     243            // China manufacturer makes tablets for different small brands (eg. http://www.zeepad.net/index.html)
     244            'ChangJiaTablet'    => 'TPC7102|TPC7103|TPC7105|TPC7106|TPC7107|TPC7201|TPC7203|TPC7205|TPC7210|TPC7708|TPC7709|TPC7712|TPC7110|TPC8101|TPC8103|TPC8105|TPC8106|TPC8203|TPC8205|TPC8503|TPC9106|TPC9701|TPC97101|TPC97103|TPC97105|TPC97106|TPC97111|TPC97113|TPC97203|TPC97603|TPC97809|TPC97205|TPC10101|TPC10103|TPC10106|TPC10111|TPC10203|TPC10205|TPC10503',
     245            // @ref: http://www.gloryunion.cn/products.asp
     246            // @ref: http://www.allwinnertech.com/en/apply/mobile.html
     247            // @ref: http://www.ptcl.com.pk/pd_content.php?pd_id=284 (EVOTAB)
     248            // aka. Cute or Cool tablets. Not sure yet, must research to avoid collisions.
     249            'GUTablet'          => 'TX-A1301|TX-M9002|Q702', // A12R|D75A|D77|D79|R83|A95|A106C|R15|A75|A76|D71|D72|R71|R73|R77|D82|R85|D92|A97|D92|R91|A10F|A77F|W71F|A78F|W78F|W81F|A97F|W91F|W97F|R16G|C72|C73E|K72|K73|R96G
     250            // @ref: http://www.telstra.com.au/home-phone/thub-2/
     251            'TelstraTablet'     => 'T-Hub2',
     252            'GenericTablet'     => 'Android.*\b97D\b|Tablet(?!.*PC)|ViewPad7|BNTV250A|MID-WCDMA|LogicPD Zoom2|\bA7EB\b|CatNova8|A1_07|CT704|CT1002|\bM721\b|rk30sdk|\bEVOTAB\b',
     253        );
     254   
     255        /**
     256         * List of mobile Operating Systems.
     257         *
     258         * @var array
     259         */
     260        protected static $operatingSystems = array(
     261            'AndroidOS'         => 'Android',
     262            'BlackBerryOS'      => 'blackberry|\bBB10\b|rim tablet os',
     263            'PalmOS'            => 'PalmOS|avantgo|blazer|elaine|hiptop|palm|plucker|xiino',
     264            'SymbianOS'         => 'Symbian|SymbOS|Series60|Series40|SYB-[0-9]+|\bS60\b',
     265            // @reference: http://en.wikipedia.org/wiki/Windows_Mobile
     266            'WindowsMobileOS'   => 'Windows CE.*(PPC|Smartphone|Mobile|[0-9]{3}x[0-9]{3})|Window Mobile|Windows Phone [0-9.]+|WCE;',
     267            // @reference: http://en.wikipedia.org/wiki/Windows_Phone
     268            // http://wifeng.cn/?r=blog&a=view&id=106
     269            // http://nicksnettravels.builttoroam.com/post/2011/01/10/Bogus-Windows-Phone-7-User-Agent-String.aspx
     270            'WindowsPhoneOS'   => 'Windows Phone 8.0|Windows Phone OS|XBLWP7|ZuneWP7',
     271            'iOS'               => '\biPhone.*Mobile|\biPod|\biPad',
     272            // http://en.wikipedia.org/wiki/MeeGo
     273            // @todo: research MeeGo in UAs
     274            'MeeGoOS'           => 'MeeGo',
     275            // http://en.wikipedia.org/wiki/Maemo
     276            // @todo: research Maemo in UAs
     277            'MaemoOS'           => 'Maemo',
     278            'JavaOS'            => 'J2ME/|\bMIDP\b|\bCLDC\b', // '|Java/' produces bug #135
     279            'webOS'             => 'webOS|hpwOS',
     280            'badaOS'            => '\bBada\b',
     281            'BREWOS'            => 'BREW',
     282        );
     283   
     284        /**
     285         * List of mobile User Agents.
     286         *
     287         * @var array
     288         */
     289        protected static $browsers = array(
     290            // @reference: https://developers.google.com/chrome/mobile/docs/user-agent
     291            'Chrome'          => '\bCrMo\b|CriOS|Android.*Chrome/[.0-9]* (Mobile)?',
     292            'Dolfin'          => '\bDolfin\b',
     293            'Opera'           => 'Opera.*Mini|Opera.*Mobi|Android.*Opera|Mobile.*OPR/[0-9.]+',
     294            'Skyfire'         => 'Skyfire',
     295            'IE'              => 'IEMobile|MSIEMobile', // |Trident/[.0-9]+
     296            'Firefox'         => 'fennec|firefox.*maemo|(Mobile|Tablet).*Firefox|Firefox.*Mobile',
     297            'Bolt'            => 'bolt',
     298            'TeaShark'        => 'teashark',
     299            'Blazer'          => 'Blazer',
     300            // @reference: http://developer.apple.com/library/safari/#documentation/AppleApplications/Reference/SafariWebContent/OptimizingforSafarioniPhone/OptimizingforSafarioniPhone.html#//apple_ref/doc/uid/TP40006517-SW3
     301            'Safari'          => 'Version.*Mobile.*Safari|Safari.*Mobile',
     302            // @ref: http://en.wikipedia.org/wiki/Midori_(web_browser)
     303            //'Midori'          => 'midori',
     304            'Tizen'           => 'Tizen',
     305            'UCBrowser'       => 'UC.*Browser|UCWEB',
     306            // @ref: https://github.com/serbanghita/Mobile-Detect/issues/7
     307            'DiigoBrowser'    => 'DiigoBrowser',
     308            // http://www.puffinbrowser.com/index.php
     309            'Puffin'            => 'Puffin',
     310            // @ref: http://mercury-browser.com/index.html
     311            'Mercury'          => '\bMercury\b',
     312            // @reference: http://en.wikipedia.org/wiki/Minimo
     313            // http://en.wikipedia.org/wiki/Vision_Mobile_Browser
     314            'GenericBrowser'  => 'NokiaBrowser|OviBrowser|OneBrowser|TwonkyBeamBrowser|SEMC.*Browser|FlyFlow|Minimo|NetFront|Novarra-Vision|MQQBrowser|MicroMessenger'
     315        );
     316   
     317        /**
     318         * Utilities.
     319         *
     320         * @var array
     321         */
     322        protected static $utilities = array(
     323            // Experimental. When a mobile device wants to switch to 'Desktop Mode'.
     324            // @ref: http://scottcate.com/technology/windows-phone-8-ie10-desktop-or-mobile/
     325            // @ref: https://github.com/serbanghita/Mobile-Detect/issues/57#issuecomment-15024011
     326            'DesktopMode' => 'WPDesktop',
     327            'TV'          => 'SonyDTV|HbbTV', // experimental
     328            'WebKit'      => '(webkit)[ /]([\w.]+)',
     329            'Bot'         => 'Googlebot|DoCoMo|YandexBot|bingbot|ia_archiver|AhrefsBot|Ezooms|GSLFbot|WBSearchBot|Twitterbot|TweetmemeBot|Twikle|PaperLiBot|Wotbox|UnwindFetchor|facebookexternalhit',
     330            'MobileBot'   => 'Googlebot-Mobile|DoCoMo|YahooSeeker/M1A1-R2D2',
     331            'Console'     => '\b(Nintendo|Nintendo WiiU|PLAYSTATION|Xbox)\b',
     332            'Watch'       => 'SM-V700',
     333        );
     334   
     335        /**
     336         * The individual segments that could exist in a User-Agent string. VER refers to the regular
     337         * expression defined in the constant self::VER.
     338         *
     339         * @var array
     340         */
     341        protected static $properties = array(
     342   
     343            // Build
     344            'Mobile'        => 'Mobile/[VER]',
     345            'Build'         => 'Build/[VER]',
     346            'Version'       => 'Version/[VER]',
     347            'VendorID'      => 'VendorID/[VER]',
     348   
     349            // Devices
     350            'iPad'          => 'iPad.*CPU[a-z ]+[VER]',
     351            'iPhone'        => 'iPhone.*CPU[a-z ]+[VER]',
     352            'iPod'          => 'iPod.*CPU[a-z ]+[VER]',
     353            //'BlackBerry'    => array('BlackBerry[VER]', 'BlackBerry [VER];'),
     354            'Kindle'        => 'Kindle/[VER]',
     355   
     356            // Browser
     357            'Chrome'        => array('Chrome/[VER]', 'CriOS/[VER]', 'CrMo/[VER]'),
     358            'Dolfin'        => 'Dolfin/[VER]',
     359            // @reference: https://developer.mozilla.org/en-US/docs/User_Agent_Strings_Reference
     360            'Firefox'       => 'Firefox/[VER]',
     361            'Fennec'        => 'Fennec/[VER]',
     362            // @reference: http://msdn.microsoft.com/en-us/library/ms537503(v=vs.85).aspx
     363            'IE'      => array('IEMobile/[VER];', 'IEMobile [VER]', 'MSIE [VER];'),
     364            // http://en.wikipedia.org/wiki/NetFront
     365            'NetFront'      => 'NetFront/[VER]',
     366            'NokiaBrowser'  => 'NokiaBrowser/[VER]',
     367            'Opera'         => array( ' OPR/[VER]', 'Opera Mini/[VER]', 'Version/[VER]' ),
     368            'Opera Mini'    => 'Opera Mini/[VER]',
     369            'Opera Mobi'    => 'Version/[VER]',
     370            'UC Browser'    => 'UC Browser[VER]',
     371            'MQQBrowser'    => 'MQQBrowser/[VER]',
     372            'MicroMessenger' => 'MicroMessenger/[VER]',
     373            // @note: Safari 7534.48.3 is actually Version 5.1.
     374            // @note: On BlackBerry the Version is overwriten by the OS.
     375            'Safari'        => array( 'Version/[VER]', 'Safari/[VER]' ),
     376            'Skyfire'       => 'Skyfire/[VER]',
     377            'Tizen'         => 'Tizen/[VER]',
     378            'Webkit'        => 'webkit[ /][VER]',
     379   
     380            // Engine
     381            'Gecko'         => 'Gecko/[VER]',
     382            'Trident'       => 'Trident/[VER]',
     383            'Presto'        => 'Presto/[VER]',
     384   
     385            // OS
     386            'iOS'              => ' \bOS\b [VER] ',
     387            'Android'          => 'Android [VER]',
     388            'BlackBerry'       => array('BlackBerry[\w]+/[VER]', 'BlackBerry.*Version/[VER]', 'Version/[VER]'),
     389            'BREW'             => 'BREW [VER]',
     390            'Java'             => 'Java/[VER]',
     391            // @reference: http://windowsteamblog.com/windows_phone/b/wpdev/archive/2011/08/29/introducing-the-ie9-on-windows-phone-mango-user-agent-string.aspx
     392            // @reference: http://en.wikipedia.org/wiki/Windows_NT#Releases
     393            'Windows Phone OS' => array( 'Windows Phone OS [VER]', 'Windows Phone [VER]'),
     394            'Windows Phone'    => 'Windows Phone [VER]',
     395            'Windows CE'       => 'Windows CE/[VER]',
     396            // http://social.msdn.microsoft.com/Forums/en-US/windowsdeveloperpreviewgeneral/thread/6be392da-4d2f-41b4-8354-8dcee20c85cd
     397            'Windows NT'       => 'Windows NT [VER]',
     398            'Symbian'          => array('SymbianOS/[VER]', 'Symbian/[VER]'),
     399            'webOS'            => array('webOS/[VER]', 'hpwOS/[VER];'),
     400        );
     401   
     402        /**
     403         * Construct an instance of this class.
     404         *
     405         * @param array $headers Specify the headers as injection. Should be PHP _SERVER flavored.
     406         *                       If left empty, will use the global _SERVER['HTTP_*'] vars instead.
     407         * @param string $userAgent Inject the User-Agent header. If null, will use HTTP_USER_AGENT
     408         *                          from the $headers array instead.
     409         */
     410        public function __construct(
     411            array $headers = null,
     412            $userAgent = null
     413        ){
     414            $this->setHttpHeaders($headers);
     415            $this->setUserAgent($userAgent);
     416        }
     417   
     418        /**
     419        * Get the current script version.
     420        * This is useful for the demo.php file,
     421        * so people can check on what version they are testing
     422        * for mobile devices.
     423        *
     424        * @return string The version number in semantic version format.
     425        */
     426        public static function getScriptVersion()
     427        {
     428            return self::VERSION;
     429        }
     430   
     431        /**
     432         * Set the HTTP Headers. Must be PHP-flavored. This method will reset existing headers.
     433         *
     434         * @param array $httpHeaders The headers to set. If null, then using PHP's _SERVER to extract
     435         *                           the headers. The default null is left for backwards compatibilty.
     436         */
     437        public function setHttpHeaders($httpHeaders = null)
     438        {
     439            //use global _SERVER if $httpHeaders aren't defined
     440            if (!is_array($httpHeaders) || !count($httpHeaders)) {
     441                $httpHeaders = $_SERVER;
     442            }
     443   
     444            //clear existing headers
     445            $this->httpHeaders = array();
     446   
     447            //Only save HTTP headers. In PHP land, that means only _SERVER vars that
     448            //start with HTTP_.
     449            foreach ($httpHeaders as $key => $value) {
     450                if (substr($key,0,5) == 'HTTP_') {
     451                    $this->httpHeaders[$key] = $value;
     452                }
     453            }
     454        }
     455   
     456        /**
     457         * Retrieves the HTTP headers.
     458         *
     459         * @return array
     460         */
     461        public function getHttpHeaders()
     462        {
     463            return $this->httpHeaders;
     464        }
     465   
     466        /**
     467         * Retrieves a particular header. If it doesn't exist, no exception/error is caused.
     468         * Simply null is returned.
     469         *
     470         * @param string $header The name of the header to retrieve. Can be HTTP compliant such as
     471         *                       "User-Agent" or "X-Device-User-Agent" or can be php-esque with the
     472         *                       all-caps, HTTP_ prefixed, underscore seperated awesomeness.
     473         *
     474         * @return string|null The value of the header.
     475         */
     476        public function getHttpHeader($header)
     477        {
     478            //are we using PHP-flavored headers?
     479            if (strpos($header, '_') === false) {
     480                $header = str_replace('-', '_', $header);
     481                $header = strtoupper($header);
     482            }
     483   
     484            //test the alternate, too
     485            $altHeader = 'HTTP_' . $header;
     486   
     487            //Test both the regular and the HTTP_ prefix
     488            if (isset($this->httpHeaders[$header])) {
     489                return $this->httpHeaders[$header];
     490            } elseif (isset($this->httpHeaders[$altHeader])) {
     491                return $this->httpHeaders[$altHeader];
     492            }
     493        }
     494   
     495        /**
     496         * Set the User-Agent to be used.
     497         *
     498         * @param string $userAgent The user agent string to set.
     499         */
     500        public function setUserAgent($userAgent = null)
     501        {
     502            if (!empty($userAgent)) {
     503                $this->userAgent = $userAgent;
     504            } else {
     505                $this->userAgent = $this->getHttpHeader('User-Agent');
     506   
     507                if (empty($this->userAgent)) {
     508                    $this->userAgent = $this->getHttpHeader('X-Device-User-Agent');
     509                }
     510   
     511                //Header can occur on devices using Opera Mini (can expose the real device type).
     512                //Let's concatenate it (we need this extra info in the regexes).
     513                if ($operaMiniUa = $this->getHttpHeader('X-OperaMini-Phone-UA')) {
     514                    $this->userAgent .= ' ' . $operaMiniUa;
     515                }
     516            }
     517        }
     518   
     519        /**
     520         * Retrieve the User-Agent.
     521         *
     522         * @return string|null The user agent if it's set.
     523         */
     524        public function getUserAgent()
     525        {
     526            return $this->userAgent;
     527        }
     528   
     529        /**
     530         * Set the detection type. Must be one of self::DETECTION_TYPE_MOBILE or
     531         * self::DETECTION_TYPE_EXTENDED. Otherwise, nothing is set.
     532         *
     533         * @param string $type The type. Must be a self::DETECTION_TYPE_* constant. The default
     534         *                     parameter is null which will default to self::DETECTION_TYPE_MOBILE.
     535         */
     536        public function setDetectionType($type = null)
     537        {
     538            if ($type === null) {
     539                $type = self::DETECTION_TYPE_MOBILE;
     540            }
     541   
     542            if ($type != self::DETECTION_TYPE_MOBILE && $type != self::DETECTION_TYPE_EXTENDED) {
     543                return;
     544            }
     545   
     546            $this->detectionType = $type;
     547        }
     548   
     549        /**
     550         * Retrieve the list of known phone devices.
     551         *
     552         * @return array List of phone devices.
     553         */
     554        public static function getPhoneDevices()
     555        {
     556            return self::$phoneDevices;
     557        }
     558   
     559        /**
     560         * Retrieve the list of known tablet devices.
     561         *
     562         * @return array List of tablet devices.
     563         */
     564        public static function getTabletDevices()
     565        {
     566            return self::$tabletDevices;
     567        }
     568   
     569        /**
     570         * Alias for getBrowsers() method.
     571         *
     572         * @return array List of user agents.
     573         */
     574        public static function getUserAgents()
     575        {
     576            return self::getBrowsers();
     577        }
     578   
     579        /**
     580         * Retrieve the list of known browsers. Specifically, the user agents.
     581         *
     582         * @return array List of browsers / user agents.
     583         */
     584        public static function getBrowsers()
     585        {
     586            return self::$browsers;
     587        }
     588   
     589        /**
     590         * Retrieve the list of known utilities.
     591         *
     592         * @return array List of utilities.
     593         */
     594        public static function getUtilities()
     595        {
     596            return self::$utilities;
     597        }
     598   
     599        /**
     600         * Method gets the mobile detection rules. This method is used for the magic methods $detect->is*().
     601         *
     602         * @return array All the rules (but not extended).
     603         */
     604        public static function getMobileDetectionRules()
     605        {
     606            static $rules;
     607   
     608            if (!$rules) {
     609                $rules = array_merge(
     610                    self::$phoneDevices,
     611                    self::$tabletDevices,
     612                    self::$operatingSystems,
     613                    self::$browsers
     614                );
     615            }
     616   
     617            return $rules;
     618   
     619        }
     620   
     621        /**
     622         * Method gets the mobile detection rules + utilities.
     623         * The reason this is separate is because utilities rules
     624         * don't necessary imply mobile. This method is used inside
     625         * the new $detect->is('stuff') method.
     626         *
     627         * @return array All the rules + extended.
     628         */
     629        public function getMobileDetectionRulesExtended()
     630        {
     631            static $rules;
     632   
     633            if (!$rules) {
     634                // Merge all rules together.
     635                $rules = array_merge(
     636                    self::$phoneDevices,
     637                    self::$tabletDevices,
     638                    self::$operatingSystems,
     639                    self::$browsers,
     640                    self::$utilities
     641                );
     642            }
     643   
     644            return $rules;
     645        }
     646   
     647        /**
     648         * Retrieve the current set of rules.
     649         *
     650         * @return array
     651         */
     652        public function getRules()
     653        {
     654            if ($this->detectionType == self::DETECTION_TYPE_EXTENDED) {
     655                return self::getMobileDetectionRulesExtended();
     656            } else {
     657                return self::getMobileDetectionRules();
     658            }
     659        }
     660   
     661        /**
     662        * Check the HTTP headers for signs of mobile.
     663        * This is the fastest mobile check possible; it's used
     664        * inside isMobile() method.
     665        *
     666        * @return bool
     667        */
     668        public function checkHttpHeadersForMobile()
     669        {
     670            return(
     671                isset($this->httpHeaders['HTTP_ACCEPT']) &&
     672                    (strpos($this->httpHeaders['HTTP_ACCEPT'], 'application/x-obml2d') !== false || // Opera Mini; @reference: http://dev.opera.com/articles/view/opera-binary-markup-language/
     673                     strpos($this->httpHeaders['HTTP_ACCEPT'], 'application/vnd.rim.html') !== false || // BlackBerry devices.
     674                     strpos($this->httpHeaders['HTTP_ACCEPT'], 'text/vnd.wap.wml') !== false ||
     675                     strpos($this->httpHeaders['HTTP_ACCEPT'], 'application/vnd.wap.xhtml+xml') !== false) ||
     676                isset($this->httpHeaders['HTTP_X_WAP_PROFILE'])             || // @todo: validate
     677                isset($this->httpHeaders['HTTP_X_WAP_CLIENTID'])            ||
     678                isset($this->httpHeaders['HTTP_WAP_CONNECTION'])            ||
     679                isset($this->httpHeaders['HTTP_PROFILE'])                   ||
     680                isset($this->httpHeaders['HTTP_X_OPERAMINI_PHONE_UA'])      || // Reported by Nokia devices (eg. C3)
     681                isset($this->httpHeaders['HTTP_X_NOKIA_IPADDRESS'])         ||
     682                isset($this->httpHeaders['HTTP_X_NOKIA_GATEWAY_ID'])        ||
     683                isset($this->httpHeaders['HTTP_X_ORANGE_ID'])               ||
     684                isset($this->httpHeaders['HTTP_X_VODAFONE_3GPDPCONTEXT'])   ||
     685                isset($this->httpHeaders['HTTP_X_HUAWEI_USERID'])           ||
     686                isset($this->httpHeaders['HTTP_UA_OS'])                     || // Reported by Windows Smartphones.
     687                isset($this->httpHeaders['HTTP_X_MOBILE_GATEWAY'])          || // Reported by Verizon, Vodafone proxy system.
     688                isset($this->httpHeaders['HTTP_X_ATT_DEVICEID'])            || // Seen this on HTC Sensation. @ref: SensationXE_Beats_Z715e
     689                //HTTP_X_NETWORK_TYPE = WIFI
     690                ( isset($this->httpHeaders['HTTP_UA_CPU']) &&
     691                        $this->httpHeaders['HTTP_UA_CPU'] == 'ARM'          // Seen this on a HTC.
     692                )
    611693            );
    612694        }
    613 
    614         return $rules;
    615 
    616     }
    617 
    618     /**
    619      * Method gets the mobile detection rules + utilities.
    620      * The reason this is separate is because utilities rules
    621      * don't necessary imply mobile. This method is used inside
    622      * the new $detect->is('stuff') method.
    623      *
    624      * @return array All the rules + extended.
    625      */
    626     public function getMobileDetectionRulesExtended()
    627     {
    628         static $rules;
    629 
    630         if (!$rules) {
    631             // Merge all rules together.
    632             $rules = array_merge(
    633                 self::$phoneDevices,
    634                 self::$tabletDevices,
    635                 self::$operatingSystems,
    636                 self::$browsers,
    637                 self::$utilities
    638             );
    639         }
    640 
    641         return $rules;
    642     }
    643 
    644     /**
    645      * Retrieve the current set of rules.
    646      *
    647      * @return array
    648      */
    649     public function getRules()
    650     {
    651         if ($this->detectionType == self::DETECTION_TYPE_EXTENDED) {
    652             return self::getMobileDetectionRulesExtended();
    653         } else {
    654             return self::getMobileDetectionRules();
    655         }
    656     }
    657 
    658     /**
    659     * Check the HTTP headers for signs of mobile.
    660     * This is the fastest mobile check possible; it's used
    661     * inside isMobile() method.
    662     *
    663     * @return bool
    664     */
    665     public function checkHttpHeadersForMobile()
    666     {
    667         return(
    668             isset($this->httpHeaders['HTTP_ACCEPT']) &&
    669                 (strpos($this->httpHeaders['HTTP_ACCEPT'], 'application/x-obml2d') !== false || // Opera Mini; @reference: http://dev.opera.com/articles/view/opera-binary-markup-language/
    670                  strpos($this->httpHeaders['HTTP_ACCEPT'], 'application/vnd.rim.html') !== false || // BlackBerry devices.
    671                  strpos($this->httpHeaders['HTTP_ACCEPT'], 'text/vnd.wap.wml') !== false ||
    672                  strpos($this->httpHeaders['HTTP_ACCEPT'], 'application/vnd.wap.xhtml+xml') !== false) ||
    673             isset($this->httpHeaders['HTTP_X_WAP_PROFILE'])             || // @todo: validate
    674             isset($this->httpHeaders['HTTP_X_WAP_CLIENTID'])            ||
    675             isset($this->httpHeaders['HTTP_WAP_CONNECTION'])            ||
    676             isset($this->httpHeaders['HTTP_PROFILE'])                   ||
    677             isset($this->httpHeaders['HTTP_X_OPERAMINI_PHONE_UA'])      || // Reported by Nokia devices (eg. C3)
    678             isset($this->httpHeaders['HTTP_X_NOKIA_IPADDRESS'])         ||
    679             isset($this->httpHeaders['HTTP_X_NOKIA_GATEWAY_ID'])        ||
    680             isset($this->httpHeaders['HTTP_X_ORANGE_ID'])               ||
    681             isset($this->httpHeaders['HTTP_X_VODAFONE_3GPDPCONTEXT'])   ||
    682             isset($this->httpHeaders['HTTP_X_HUAWEI_USERID'])           ||
    683             isset($this->httpHeaders['HTTP_UA_OS'])                     || // Reported by Windows Smartphones.
    684             isset($this->httpHeaders['HTTP_X_MOBILE_GATEWAY'])          || // Reported by Verizon, Vodafone proxy system.
    685             isset($this->httpHeaders['HTTP_X_ATT_DEVICEID'])            || // Seen this on HTC Sensation. @ref: SensationXE_Beats_Z715e
    686             //HTTP_X_NETWORK_TYPE = WIFI
    687             ( isset($this->httpHeaders['HTTP_UA_CPU']) &&
    688                     $this->httpHeaders['HTTP_UA_CPU'] == 'ARM'          // Seen this on a HTC.
    689             )
    690         );
    691     }
    692 
    693     /**
    694      * Magic overloading method.
    695      *
    696      * @method boolean is[...]()
    697      * @param  string                 $name
    698      * @param  array                  $arguments
    699      * @return mixed
    700      * @throws BadMethodCallException when the method doesn't exist and doesn't start with 'is'
    701      */
    702     public function __call($name, $arguments)
    703     {
    704         //make sure the name starts with 'is', otherwise
    705         if (substr($name, 0, 2) != 'is') {
    706             throw new BadMethodCallException("No such method exists: $name");
    707         }
    708 
    709         $this->setDetectionType(self::DETECTION_TYPE_MOBILE);
    710 
    711         $key = substr($name, 2);
    712 
    713         return $this->matchUAAgainstKey($key);
    714     }
    715 
    716     /**
    717     * Find a detection rule that matches the current User-agent.
    718     *
    719     * @param null $userAgent deprecated
    720     * @return boolean
    721     */
    722     private function matchDetectionRulesAgainstUA($userAgent = null)
    723     {
    724         // Begin general search.
    725         foreach ($this->getRules() as $_regex) {
    726             if (empty($_regex)) {
    727                 continue;
    728             }
    729             if ($this->match($_regex, $userAgent)) {
     695   
     696        /**
     697         * Magic overloading method.
     698         *
     699         * @method boolean is[...]()
     700         * @param  string                 $name
     701         * @param  array                  $arguments
     702         * @return mixed
     703         * @throws BadMethodCallException when the method doesn't exist and doesn't start with 'is'
     704         */
     705        public function __call($name, $arguments)
     706        {
     707            //make sure the name starts with 'is', otherwise
     708            if (substr($name, 0, 2) != 'is') {
     709                throw new BadMethodCallException("No such method exists: $name");
     710            }
     711   
     712            $this->setDetectionType(self::DETECTION_TYPE_MOBILE);
     713   
     714            $key = substr($name, 2);
     715   
     716            return $this->matchUAAgainstKey($key);
     717        }
     718   
     719        /**
     720        * Find a detection rule that matches the current User-agent.
     721        *
     722        * @param null $userAgent deprecated
     723        * @return boolean
     724        */
     725        private function matchDetectionRulesAgainstUA($userAgent = null)
     726        {
     727            // Begin general search.
     728            foreach ($this->getRules() as $_regex) {
     729                if (empty($_regex)) {
     730                    continue;
     731                }
     732                if ($this->match($_regex, $userAgent)) {
     733                    return true;
     734                }
     735            }
     736   
     737            return false;
     738        }
     739   
     740        /**
     741        * Search for a certain key in the rules array.
     742        * If the key is found the try to match the corresponding
     743        * regex agains the User-Agent.
     744        *
     745        * @param string $key
     746        * @param null $userAgent deprecated
     747        * @return mixed
     748        */
     749        private function matchUAAgainstKey($key, $userAgent = null)
     750        {
     751            // Make the keys lowercase so we can match: isIphone(), isiPhone(), isiphone(), etc.
     752            $key = strtolower($key);
     753   
     754            //change the keys to lower case
     755            $_rules = array_change_key_case($this->getRules());
     756   
     757            if (array_key_exists($key, $_rules)) {
     758                if (empty($_rules[$key])) {
     759                    return null;
     760                }
     761   
     762                return $this->match($_rules[$key], $userAgent);
     763            }
     764   
     765            return false;
     766        }
     767   
     768        /**
     769        * Check if the device is mobile.
     770        * Returns true if any type of mobile device detected, including special ones
     771        * @param null $userAgent deprecated
     772        * @param null $httpHeaders deprecated
     773        * @return bool
     774        */
     775        public function isMobile($userAgent = null, $httpHeaders = null)
     776        {
     777   
     778            if ($httpHeaders) {
     779                $this->setHttpHeaders($httpHeaders);
     780            }
     781   
     782            if ($userAgent) {
     783                $this->setUserAgent($userAgent);
     784            }
     785   
     786            $this->setDetectionType(self::DETECTION_TYPE_MOBILE);
     787   
     788            if ($this->checkHttpHeadersForMobile()) {
    730789                return true;
    731             }
    732         }
    733 
    734         return false;
    735     }
    736 
    737     /**
    738     * Search for a certain key in the rules array.
    739     * If the key is found the try to match the corresponding
    740     * regex agains the User-Agent.
    741     *
    742     * @param string $key
    743     * @param null $userAgent deprecated
    744     * @return mixed
    745     */
    746     private function matchUAAgainstKey($key, $userAgent = null)
    747     {
    748         // Make the keys lowercase so we can match: isIphone(), isiPhone(), isiphone(), etc.
    749         $key = strtolower($key);
    750 
    751         //change the keys to lower case
    752         $_rules = array_change_key_case($this->getRules());
    753 
    754         if (array_key_exists($key, $_rules)) {
    755             if (empty($_rules[$key])) {
    756                 return null;
    757             }
    758 
    759             return $this->match($_rules[$key], $userAgent);
    760         }
    761 
    762         return false;
    763     }
    764 
    765     /**
    766     * Check if the device is mobile.
    767     * Returns true if any type of mobile device detected, including special ones
    768     * @param null $userAgent deprecated
    769     * @param null $httpHeaders deprecated
    770     * @return bool
    771     */
    772     public function isMobile($userAgent = null, $httpHeaders = null)
    773     {
    774 
    775         if ($httpHeaders) {
    776             $this->setHttpHeaders($httpHeaders);
    777         }
    778 
    779         if ($userAgent) {
    780             $this->setUserAgent($userAgent);
    781         }
    782 
    783         $this->setDetectionType(self::DETECTION_TYPE_MOBILE);
    784 
    785         if ($this->checkHttpHeadersForMobile()) {
    786             return true;
    787         } else {
    788             return $this->matchDetectionRulesAgainstUA();
    789         }
    790 
    791     }
    792 
    793     /**
    794      * Check if the device is a tablet.
    795      * Return true if any type of tablet device is detected.
    796      *
    797      * @param  string $userAgent   deprecated
    798      * @param  array  $httpHeaders deprecated
    799      * @return bool
    800      */
    801     public function isTablet($userAgent = null, $httpHeaders = null)
    802     {
    803         $this->setDetectionType(self::DETECTION_TYPE_MOBILE);
    804 
    805         foreach (self::$tabletDevices as $_regex) {
    806             if ($this->match($_regex, $userAgent)) {
    807                 return true;
    808             }
    809         }
    810 
    811         return false;
    812     }
    813 
    814     /**
    815      * This method checks for a certain property in the
    816      * userAgent.
    817      * @todo: The httpHeaders part is not yet used.
    818      *
    819      * @param $key
    820      * @param  string        $userAgent   deprecated
    821      * @param  string        $httpHeaders deprecated
    822      * @return bool|int|null
    823      */
    824     public function is($key, $userAgent = null, $httpHeaders = null)
    825     {
    826         // Set the UA and HTTP headers only if needed (eg. batch mode).
    827         if ($httpHeaders) {
    828             $this->setHttpHeaders($httpHeaders);
    829         }
    830 
    831         if ($userAgent) {
    832             $this->setUserAgent($userAgent);
    833         }
    834 
    835         $this->setDetectionType(self::DETECTION_TYPE_EXTENDED);
    836 
    837         return $this->matchUAAgainstKey($key);
    838     }
    839 
    840     /**
    841      * Retrieve the list of mobile operating systems.
    842      *
    843      * @return array The list of mobile operating systems.
    844      */
    845     public static function getOperatingSystems()
    846     {
    847         return self::$operatingSystems;
    848     }
    849 
    850     /**
    851      * Some detection rules are relative (not standard),
    852      * because of the diversity of devices, vendors and
    853      * their conventions in representing the User-Agent or
    854      * the HTTP headers.
    855      *
    856      * This method will be used to check custom regexes against
    857      * the User-Agent string.
    858      *
    859      * @param $regex
    860      * @param  string $userAgent
    861      * @return bool
    862      *
    863      * @todo: search in the HTTP headers too.
    864      */
    865     public function match($regex, $userAgent = null)
    866     {
    867         // Escape the special character which is the delimiter.
    868         $regex = str_replace('/', '\/', $regex);
    869 
    870         return (bool) preg_match('/'.$regex.'/is', (!empty($userAgent) ? $userAgent : $this->userAgent));
    871     }
    872 
    873     /**
    874      * Get the properties array.
    875      *
    876      * @return array
    877      */
    878     public static function getProperties()
    879     {
    880         return self::$properties;
    881     }
    882 
    883     /**
    884      * Prepare the version number.
    885      *
    886      * @todo Remove the error supression from str_replace() call.
    887      *
    888      * @param string $ver The string version, like "2.6.21.2152";
    889      *
    890      * @return float
    891      */
    892     public function prepareVersionNo($ver)
    893     {
    894         $ver = str_replace(array('_', ' ', '/'), '.', $ver);
    895         $arrVer = explode('.', $ver, 2);
    896 
    897         if (isset($arrVer[1])) {
    898             $arrVer[1] = @str_replace('.', '', $arrVer[1]); // @todo: treat strings versions.
    899         }
    900 
    901         return (float) implode('.', $arrVer);
    902     }
    903 
    904     /**
    905      * Check the version of the given property in the User-Agent.
    906      * Will return a float number. (eg. 2_0 will return 2.0, 4.3.1 will return 4.31)
    907      *
    908      * @param string $propertyName The name of the property. See self::getProperties() array
    909      *                              keys for all possible properties.
    910      * @param string $type Either self::VERSION_TYPE_STRING to get a string value or
    911      *                      self::VERSION_TYPE_FLOAT indicating a float value. This parameter
    912      *                      is optional and defaults to self::VERSION_TYPE_STRING. Passing an
    913      *                      invalid parameter will default to the this type as well.
    914      *
    915      * @return string|float The version of the property we are trying to extract.
    916      */
    917     public function version($propertyName, $type = self::VERSION_TYPE_STRING)
    918     {
    919         if (empty($propertyName)) {
     790            } else {
     791                return $this->matchDetectionRulesAgainstUA();
     792            }
     793   
     794        }
     795   
     796        /**
     797         * Check if the device is a tablet.
     798         * Return true if any type of tablet device is detected.
     799         *
     800         * @param  string $userAgent   deprecated
     801         * @param  array  $httpHeaders deprecated
     802         * @return bool
     803         */
     804        public function isTablet($userAgent = null, $httpHeaders = null)
     805        {
     806            $this->setDetectionType(self::DETECTION_TYPE_MOBILE);
     807   
     808            foreach (self::$tabletDevices as $_regex) {
     809                if ($this->match($_regex, $userAgent)) {
     810                    return true;
     811                }
     812            }
     813   
    920814            return false;
    921815        }
    922 
    923         //set the $type to the default if we don't recognize the type
    924         if ($type != self::VERSION_TYPE_STRING && $type != self::VERSION_TYPE_FLOAT) {
    925             $type = self::VERSION_TYPE_STRING;
    926         }
    927 
    928         $properties = self::getProperties();
    929 
    930         // Check if the property exists in the properties array.
    931         if (array_key_exists($propertyName, $properties)) {
    932 
    933             // Prepare the pattern to be matched.
    934             // Make sure we always deal with an array (string is converted).
    935             $properties[$propertyName] = (array) $properties[$propertyName];
    936 
    937             foreach ($properties[$propertyName] as $propertyMatchString) {
    938 
    939                 $propertyPattern = str_replace('[VER]', self::VER, $propertyMatchString);
    940 
    941                 // Escape the special character which is the delimiter.
    942                 $propertyPattern = str_replace('/', '\/', $propertyPattern);
    943 
    944                 // Identify and extract the version.
    945                 preg_match('/'.$propertyPattern.'/is', $this->userAgent, $match);
    946 
    947                 if (!empty($match[1])) {
    948                     $version = ( $type == self::VERSION_TYPE_FLOAT ? $this->prepareVersionNo($match[1]) : $match[1] );
    949 
    950                     return $version;
     816   
     817        /**
     818         * This method checks for a certain property in the
     819         * userAgent.
     820         * @todo: The httpHeaders part is not yet used.
     821         *
     822         * @param $key
     823         * @param  string        $userAgent   deprecated
     824         * @param  string        $httpHeaders deprecated
     825         * @return bool|int|null
     826         */
     827        public function is($key, $userAgent = null, $httpHeaders = null)
     828        {
     829            // Set the UA and HTTP headers only if needed (eg. batch mode).
     830            if ($httpHeaders) {
     831                $this->setHttpHeaders($httpHeaders);
     832            }
     833   
     834            if ($userAgent) {
     835                $this->setUserAgent($userAgent);
     836            }
     837   
     838            $this->setDetectionType(self::DETECTION_TYPE_EXTENDED);
     839   
     840            return $this->matchUAAgainstKey($key);
     841        }
     842   
     843        /**
     844         * Retrieve the list of mobile operating systems.
     845         *
     846         * @return array The list of mobile operating systems.
     847         */
     848        public static function getOperatingSystems()
     849        {
     850            return self::$operatingSystems;
     851        }
     852   
     853        /**
     854         * Some detection rules are relative (not standard),
     855         * because of the diversity of devices, vendors and
     856         * their conventions in representing the User-Agent or
     857         * the HTTP headers.
     858         *
     859         * This method will be used to check custom regexes against
     860         * the User-Agent string.
     861         *
     862         * @param $regex
     863         * @param  string $userAgent
     864         * @return bool
     865         *
     866         * @todo: search in the HTTP headers too.
     867         */
     868        public function match($regex, $userAgent = null)
     869        {
     870            // Escape the special character which is the delimiter.
     871            $regex = str_replace('/', '\/', $regex);
     872   
     873            return (bool) preg_match('/'.$regex.'/is', (!empty($userAgent) ? $userAgent : $this->userAgent));
     874        }
     875   
     876        /**
     877         * Get the properties array.
     878         *
     879         * @return array
     880         */
     881        public static function getProperties()
     882        {
     883            return self::$properties;
     884        }
     885   
     886        /**
     887         * Prepare the version number.
     888         *
     889         * @todo Remove the error supression from str_replace() call.
     890         *
     891         * @param string $ver The string version, like "2.6.21.2152";
     892         *
     893         * @return float
     894         */
     895        public function prepareVersionNo($ver)
     896        {
     897            $ver = str_replace(array('_', ' ', '/'), '.', $ver);
     898            $arrVer = explode('.', $ver, 2);
     899   
     900            if (isset($arrVer[1])) {
     901                $arrVer[1] = @str_replace('.', '', $arrVer[1]); // @todo: treat strings versions.
     902            }
     903   
     904            return (float) implode('.', $arrVer);
     905        }
     906   
     907        /**
     908         * Check the version of the given property in the User-Agent.
     909         * Will return a float number. (eg. 2_0 will return 2.0, 4.3.1 will return 4.31)
     910         *
     911         * @param string $propertyName The name of the property. See self::getProperties() array
     912         *                              keys for all possible properties.
     913         * @param string $type Either self::VERSION_TYPE_STRING to get a string value or
     914         *                      self::VERSION_TYPE_FLOAT indicating a float value. This parameter
     915         *                      is optional and defaults to self::VERSION_TYPE_STRING. Passing an
     916         *                      invalid parameter will default to the this type as well.
     917         *
     918         * @return string|float The version of the property we are trying to extract.
     919         */
     920        public function version($propertyName, $type = self::VERSION_TYPE_STRING)
     921        {
     922            if (empty($propertyName)) {
     923                return false;
     924            }
     925   
     926            //set the $type to the default if we don't recognize the type
     927            if ($type != self::VERSION_TYPE_STRING && $type != self::VERSION_TYPE_FLOAT) {
     928                $type = self::VERSION_TYPE_STRING;
     929            }
     930   
     931            $properties = self::getProperties();
     932   
     933            // Check if the property exists in the properties array.
     934            if (array_key_exists($propertyName, $properties)) {
     935   
     936                // Prepare the pattern to be matched.
     937                // Make sure we always deal with an array (string is converted).
     938                $properties[$propertyName] = (array) $properties[$propertyName];
     939   
     940                foreach ($properties[$propertyName] as $propertyMatchString) {
     941   
     942                    $propertyPattern = str_replace('[VER]', self::VER, $propertyMatchString);
     943   
     944                    // Escape the special character which is the delimiter.
     945                    $propertyPattern = str_replace('/', '\/', $propertyPattern);
     946   
     947                    // Identify and extract the version.
     948                    preg_match('/'.$propertyPattern.'/is', $this->userAgent, $match);
     949   
     950                    if (!empty($match[1])) {
     951                        $version = ( $type == self::VERSION_TYPE_FLOAT ? $this->prepareVersionNo($match[1]) : $match[1] );
     952   
     953                        return $version;
     954                    }
     955   
    951956                }
    952 
    953             }
    954 
    955         }
    956 
    957         return false;
    958     }
    959 
    960     /**
    961      * Retrieve the mobile grading, using self::MOBILE_GRADE_* constants.
    962      *
    963      * @return string One of the self::MOBILE_GRADE_* constants.
    964      */
    965     public function mobileGrade()
    966     {
    967         $isMobile = $this->isMobile();
    968 
    969         if (
    970             // Apple iOS 3.2-5.1 - Tested on the original iPad (4.3 / 5.0), iPad 2 (4.3), iPad 3 (5.1), original iPhone (3.1), iPhone 3 (3.2), 3GS (4.3), 4 (4.3 / 5.0), and 4S (5.1)
    971             $this->version('iPad', self::VERSION_TYPE_FLOAT)>=4.3 ||
    972             $this->version('iPhone', self::VERSION_TYPE_FLOAT)>=3.1 ||
    973             $this->version('iPod', self::VERSION_TYPE_FLOAT)>=3.1 ||
    974 
    975             // Android 2.1-2.3 - Tested on the HTC Incredible (2.2), original Droid (2.2), HTC Aria (2.1), Google Nexus S (2.3). Functional on 1.5 & 1.6 but performance may be sluggish, tested on Google G1 (1.5)
    976             // Android 3.1 (Honeycomb)  - Tested on the Samsung Galaxy Tab 10.1 and Motorola XOOM
    977             // Android 4.0 (ICS)  - Tested on a Galaxy Nexus. Note: transition performance can be poor on upgraded devices
    978             // Android 4.1 (Jelly Bean)  - Tested on a Galaxy Nexus and Galaxy 7
    979             ( $this->version('Android', self::VERSION_TYPE_FLOAT)>2.1 && $this->is('Webkit') ) ||
    980 
    981             // Windows Phone 7-7.5 - Tested on the HTC Surround (7.0) HTC Trophy (7.5), LG-E900 (7.5), Nokia Lumia 800
    982             $this->version('Windows Phone OS', self::VERSION_TYPE_FLOAT)>=7.0 ||
    983 
    984             // Blackberry 7 - Tested on BlackBerry® Torch 9810
    985             // Blackberry 6.0 - Tested on the Torch 9800 and Style 9670
    986             $this->is('BlackBerry') && $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)>=6.0 ||
    987             // Blackberry Playbook (1.0-2.0) - Tested on PlayBook
    988             $this->match('Playbook.*Tablet') ||
    989 
    990             // Palm WebOS (1.4-2.0) - Tested on the Palm Pixi (1.4), Pre (1.4), Pre 2 (2.0)
    991             ( $this->version('webOS', self::VERSION_TYPE_FLOAT)>=1.4 && $this->match('Palm|Pre|Pixi') ) ||
    992             // Palm WebOS 3.0  - Tested on HP TouchPad
    993             $this->match('hp.*TouchPad') ||
    994 
    995             // Firefox Mobile (12 Beta) - Tested on Android 2.3 device
    996             ( $this->is('Firefox') && $this->version('Firefox', self::VERSION_TYPE_FLOAT)>=12 ) ||
    997 
    998             // Chrome for Android - Tested on Android 4.0, 4.1 device
    999             ( $this->is('Chrome') && $this->is('AndroidOS') && $this->version('Android', self::VERSION_TYPE_FLOAT)>=4.0 ) ||
    1000 
    1001             // Skyfire 4.1 - Tested on Android 2.3 device
    1002             ( $this->is('Skyfire') && $this->version('Skyfire', self::VERSION_TYPE_FLOAT)>=4.1 && $this->is('AndroidOS') && $this->version('Android', self::VERSION_TYPE_FLOAT)>=2.3 ) ||
    1003 
    1004             // Opera Mobile 11.5-12: Tested on Android 2.3
    1005             ( $this->is('Opera') && $this->version('Opera Mobi', self::VERSION_TYPE_FLOAT)>11 && $this->is('AndroidOS') ) ||
    1006 
    1007             // Meego 1.2 - Tested on Nokia 950 and N9
    1008             $this->is('MeeGoOS') ||
    1009 
    1010             // Tizen (pre-release) - Tested on early hardware
    1011             $this->is('Tizen') ||
    1012 
    1013             // Samsung Bada 2.0 - Tested on a Samsung Wave 3, Dolphin browser
    1014             // @todo: more tests here!
    1015             $this->is('Dolfin') && $this->version('Bada', self::VERSION_TYPE_FLOAT)>=2.0 ||
    1016 
    1017             // UC Browser - Tested on Android 2.3 device
    1018             ( ($this->is('UC Browser') || $this->is('Dolfin')) && $this->version('Android', self::VERSION_TYPE_FLOAT)>=2.3 ) ||
    1019 
    1020             // Kindle 3 and Fire  - Tested on the built-in WebKit browser for each
    1021             ( $this->match('Kindle Fire') ||
    1022             $this->is('Kindle') && $this->version('Kindle', self::VERSION_TYPE_FLOAT)>=3.0 ) ||
    1023 
    1024             // Nook Color 1.4.1 - Tested on original Nook Color, not Nook Tablet
    1025             $this->is('AndroidOS') && $this->is('NookTablet') ||
    1026 
    1027             // Chrome Desktop 11-21 - Tested on OS X 10.7 and Windows 7
    1028             $this->version('Chrome', self::VERSION_TYPE_FLOAT)>=11 && !$isMobile ||
    1029 
    1030             // Safari Desktop 4-5 - Tested on OS X 10.7 and Windows 7
    1031             $this->version('Safari', self::VERSION_TYPE_FLOAT)>=5.0 && !$isMobile ||
    1032 
    1033             // Firefox Desktop 4-13 - Tested on OS X 10.7 and Windows 7
    1034             $this->version('Firefox', self::VERSION_TYPE_FLOAT)>=4.0 && !$isMobile ||
    1035 
    1036             // Internet Explorer 7-9 - Tested on Windows XP, Vista and 7
    1037             $this->version('MSIE', self::VERSION_TYPE_FLOAT)>=7.0 && !$isMobile ||
    1038 
    1039             // Opera Desktop 10-12 - Tested on OS X 10.7 and Windows 7
    1040             // @reference: http://my.opera.com/community/openweb/idopera/
    1041             $this->version('Opera', self::VERSION_TYPE_FLOAT)>=10 && !$isMobile
    1042 
    1043         ){
    1044             return self::MOBILE_GRADE_A;
    1045         }
    1046 
    1047         if (
    1048             $this->version('iPad', self::VERSION_TYPE_FLOAT)<4.3 ||
    1049             $this->version('iPhone', self::VERSION_TYPE_FLOAT)<3.1 ||
    1050             $this->version('iPod', self::VERSION_TYPE_FLOAT)<3.1 ||
    1051 
    1052             // Blackberry 5.0: Tested on the Storm 2 9550, Bold 9770
    1053             $this->is('Blackberry') && $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)>=5 && $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)<6 ||
    1054 
    1055             //Opera Mini (5.0-6.5) - Tested on iOS 3.2/4.3 and Android 2.3
    1056             ( $this->version('Opera Mini', self::VERSION_TYPE_FLOAT)>=5.0 && $this->version('Opera Mini', self::VERSION_TYPE_FLOAT)<=6.5 &&
    1057             ($this->version('Android', self::VERSION_TYPE_FLOAT)>=2.3 || $this->is('iOS')) ) ||
    1058 
    1059             // Nokia Symbian^3 - Tested on Nokia N8 (Symbian^3), C7 (Symbian^3), also works on N97 (Symbian^1)
    1060             $this->match('NokiaN8|NokiaC7|N97.*Series60|Symbian/3') ||
    1061 
    1062             // @todo: report this (tested on Nokia N71)
    1063             $this->version('Opera Mobi', self::VERSION_TYPE_FLOAT)>=11 && $this->is('SymbianOS')
    1064         ){
    1065             return self::MOBILE_GRADE_B;
    1066         }
    1067 
    1068         if (
    1069             // Blackberry 4.x - Tested on the Curve 8330
    1070             $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)<5.0 ||
    1071             // Windows Mobile - Tested on the HTC Leo (WinMo 5.2)
    1072             $this->match('MSIEMobile|Windows CE.*Mobile') || $this->version('Windows Mobile', self::VERSION_TYPE_FLOAT)<=5.2
    1073 
    1074         ){
     957   
     958            }
     959   
     960            return false;
     961        }
     962   
     963        /**
     964         * Retrieve the mobile grading, using self::MOBILE_GRADE_* constants.
     965         *
     966         * @return string One of the self::MOBILE_GRADE_* constants.
     967         */
     968        public function mobileGrade()
     969        {
     970            $isMobile = $this->isMobile();
     971   
     972            if (
     973                // Apple iOS 3.2-5.1 - Tested on the original iPad (4.3 / 5.0), iPad 2 (4.3), iPad 3 (5.1), original iPhone (3.1), iPhone 3 (3.2), 3GS (4.3), 4 (4.3 / 5.0), and 4S (5.1)
     974                $this->version('iPad', self::VERSION_TYPE_FLOAT)>=4.3 ||
     975                $this->version('iPhone', self::VERSION_TYPE_FLOAT)>=3.1 ||
     976                $this->version('iPod', self::VERSION_TYPE_FLOAT)>=3.1 ||
     977   
     978                // Android 2.1-2.3 - Tested on the HTC Incredible (2.2), original Droid (2.2), HTC Aria (2.1), Google Nexus S (2.3). Functional on 1.5 & 1.6 but performance may be sluggish, tested on Google G1 (1.5)
     979                // Android 3.1 (Honeycomb)  - Tested on the Samsung Galaxy Tab 10.1 and Motorola XOOM
     980                // Android 4.0 (ICS)  - Tested on a Galaxy Nexus. Note: transition performance can be poor on upgraded devices
     981                // Android 4.1 (Jelly Bean)  - Tested on a Galaxy Nexus and Galaxy 7
     982                ( $this->version('Android', self::VERSION_TYPE_FLOAT)>2.1 && $this->is('Webkit') ) ||
     983   
     984                // Windows Phone 7-7.5 - Tested on the HTC Surround (7.0) HTC Trophy (7.5), LG-E900 (7.5), Nokia Lumia 800
     985                $this->version('Windows Phone OS', self::VERSION_TYPE_FLOAT)>=7.0 ||
     986   
     987                // Blackberry 7 - Tested on BlackBerry® Torch 9810
     988                // Blackberry 6.0 - Tested on the Torch 9800 and Style 9670
     989                $this->is('BlackBerry') && $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)>=6.0 ||
     990                // Blackberry Playbook (1.0-2.0) - Tested on PlayBook
     991                $this->match('Playbook.*Tablet') ||
     992   
     993                // Palm WebOS (1.4-2.0) - Tested on the Palm Pixi (1.4), Pre (1.4), Pre 2 (2.0)
     994                ( $this->version('webOS', self::VERSION_TYPE_FLOAT)>=1.4 && $this->match('Palm|Pre|Pixi') ) ||
     995                // Palm WebOS 3.0  - Tested on HP TouchPad
     996                $this->match('hp.*TouchPad') ||
     997   
     998                // Firefox Mobile (12 Beta) - Tested on Android 2.3 device
     999                ( $this->is('Firefox') && $this->version('Firefox', self::VERSION_TYPE_FLOAT)>=12 ) ||
     1000   
     1001                // Chrome for Android - Tested on Android 4.0, 4.1 device
     1002                ( $this->is('Chrome') && $this->is('AndroidOS') && $this->version('Android', self::VERSION_TYPE_FLOAT)>=4.0 ) ||
     1003   
     1004                // Skyfire 4.1 - Tested on Android 2.3 device
     1005                ( $this->is('Skyfire') && $this->version('Skyfire', self::VERSION_TYPE_FLOAT)>=4.1 && $this->is('AndroidOS') && $this->version('Android', self::VERSION_TYPE_FLOAT)>=2.3 ) ||
     1006   
     1007                // Opera Mobile 11.5-12: Tested on Android 2.3
     1008                ( $this->is('Opera') && $this->version('Opera Mobi', self::VERSION_TYPE_FLOAT)>11 && $this->is('AndroidOS') ) ||
     1009   
     1010                // Meego 1.2 - Tested on Nokia 950 and N9
     1011                $this->is('MeeGoOS') ||
     1012   
     1013                // Tizen (pre-release) - Tested on early hardware
     1014                $this->is('Tizen') ||
     1015   
     1016                // Samsung Bada 2.0 - Tested on a Samsung Wave 3, Dolphin browser
     1017                // @todo: more tests here!
     1018                $this->is('Dolfin') && $this->version('Bada', self::VERSION_TYPE_FLOAT)>=2.0 ||
     1019   
     1020                // UC Browser - Tested on Android 2.3 device
     1021                ( ($this->is('UC Browser') || $this->is('Dolfin')) && $this->version('Android', self::VERSION_TYPE_FLOAT)>=2.3 ) ||
     1022   
     1023                // Kindle 3 and Fire  - Tested on the built-in WebKit browser for each
     1024                ( $this->match('Kindle Fire') ||
     1025                $this->is('Kindle') && $this->version('Kindle', self::VERSION_TYPE_FLOAT)>=3.0 ) ||
     1026   
     1027                // Nook Color 1.4.1 - Tested on original Nook Color, not Nook Tablet
     1028                $this->is('AndroidOS') && $this->is('NookTablet') ||
     1029   
     1030                // Chrome Desktop 11-21 - Tested on OS X 10.7 and Windows 7
     1031                $this->version('Chrome', self::VERSION_TYPE_FLOAT)>=11 && !$isMobile ||
     1032   
     1033                // Safari Desktop 4-5 - Tested on OS X 10.7 and Windows 7
     1034                $this->version('Safari', self::VERSION_TYPE_FLOAT)>=5.0 && !$isMobile ||
     1035   
     1036                // Firefox Desktop 4-13 - Tested on OS X 10.7 and Windows 7
     1037                $this->version('Firefox', self::VERSION_TYPE_FLOAT)>=4.0 && !$isMobile ||
     1038   
     1039                // Internet Explorer 7-9 - Tested on Windows XP, Vista and 7
     1040                $this->version('MSIE', self::VERSION_TYPE_FLOAT)>=7.0 && !$isMobile ||
     1041   
     1042                // Opera Desktop 10-12 - Tested on OS X 10.7 and Windows 7
     1043                // @reference: http://my.opera.com/community/openweb/idopera/
     1044                $this->version('Opera', self::VERSION_TYPE_FLOAT)>=10 && !$isMobile
     1045   
     1046            ){
     1047                return self::MOBILE_GRADE_A;
     1048            }
     1049   
     1050            if (
     1051                $this->version('iPad', self::VERSION_TYPE_FLOAT)<4.3 ||
     1052                $this->version('iPhone', self::VERSION_TYPE_FLOAT)<3.1 ||
     1053                $this->version('iPod', self::VERSION_TYPE_FLOAT)<3.1 ||
     1054   
     1055                // Blackberry 5.0: Tested on the Storm 2 9550, Bold 9770
     1056                $this->is('Blackberry') && $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)>=5 && $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)<6 ||
     1057   
     1058                //Opera Mini (5.0-6.5) - Tested on iOS 3.2/4.3 and Android 2.3
     1059                ( $this->version('Opera Mini', self::VERSION_TYPE_FLOAT)>=5.0 && $this->version('Opera Mini', self::VERSION_TYPE_FLOAT)<=6.5 &&
     1060                ($this->version('Android', self::VERSION_TYPE_FLOAT)>=2.3 || $this->is('iOS')) ) ||
     1061   
     1062                // Nokia Symbian^3 - Tested on Nokia N8 (Symbian^3), C7 (Symbian^3), also works on N97 (Symbian^1)
     1063                $this->match('NokiaN8|NokiaC7|N97.*Series60|Symbian/3') ||
     1064   
     1065                // @todo: report this (tested on Nokia N71)
     1066                $this->version('Opera Mobi', self::VERSION_TYPE_FLOAT)>=11 && $this->is('SymbianOS')
     1067            ){
     1068                return self::MOBILE_GRADE_B;
     1069            }
     1070   
     1071            if (
     1072                // Blackberry 4.x - Tested on the Curve 8330
     1073                $this->version('BlackBerry', self::VERSION_TYPE_FLOAT)<5.0 ||
     1074                // Windows Mobile - Tested on the HTC Leo (WinMo 5.2)
     1075                $this->match('MSIEMobile|Windows CE.*Mobile') || $this->version('Windows Mobile', self::VERSION_TYPE_FLOAT)<=5.2
     1076   
     1077            ){
     1078                return self::MOBILE_GRADE_C;
     1079            }
     1080   
     1081            //All older smartphone platforms and featurephones - Any device that doesn't support media queries
     1082            //will receive the basic, C grade experience.
    10751083            return self::MOBILE_GRADE_C;
    10761084        }
    1077 
    1078         //All older smartphone platforms and featurephones - Any device that doesn't support media queries
    1079         //will receive the basic, C grade experience.
    1080         return self::MOBILE_GRADE_C;
    10811085    }
    10821086}
Note: See TracChangeset for help on using the changeset viewer.