/**
  * Determines which UserAgentMatcher is the best fit for the incoming user agent and returns it
  * @param TeraWurfl $wurfl
  * @param String $userAgent
  * @return UserAgentMatcher
  */
 public static function createUserAgentMatcher(TeraWurfl $wurfl, $userAgent)
 {
     // $isMobile means it IS MOBILE, $isDesktop means it IS DESKTOP
     // $isMobile does NOT mean it IS DESKTOP and vica-versa
     $isMobile = UserAgentUtils::isMobileBrowser($userAgent);
     $isDesktop = UserAgentUtils::isDesktopBrowser($userAgent);
     $userAgent_lcase = strtolower($userAgent);
     // Process exceptions
     if (TeraWurflConfig::$SIMPLE_DESKTOP_ENGINE_ENABLE && $userAgent == WurflConstants::$SIMPLE_DESKTOP_UA) {
         // SimpleDesktopUserAgentMatcher is included via require_once realpath(dirname(__FILE__).'/in TeraWurfl.php
         return new SimpleDesktopUserAgentMatcher($wurfl);
     }
     // Process MOBILE user agents
     if (!$isDesktop) {
         // High workload UAMs go first
         // Nokia
         if (UserAgentMatcher::contains($userAgent_lcase, 'nokia')) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/NokiaUserAgentMatcher.php');
             return new NokiaUserAgentMatcher($wurfl);
         }
         // Samsung
         if (UserAgentMatcher::contains($userAgent, array("Samsung/SGH", "SAMSUNG-SGH")) || UserAgentMatcher::startsWith($userAgent, array("SEC-", "Samsung", "SAMSUNG", "SPH", "SGH", "SCH")) || stripos($userAgent, 'samsung') !== false) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SamsungUserAgentMatcher.php');
             return new SamsungUserAgentMatcher($wurfl);
         }
         // Blackberry
         if (stripos($userAgent, "blackberry") !== false) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/BlackBerryUserAgentMatcher.php');
             return new BlackBerryUserAgentMatcher($wurfl);
         }
         // SonyEricsson
         if (UserAgentMatcher::contains($userAgent, 'Sony')) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SonyEricssonUserAgentMatcher.php');
             return new SonyEricssonUserAgentMatcher($wurfl);
         }
         // Motorola
         if (UserAgentMatcher::startsWith($userAgent, array('Mot-', 'MOT-', 'MOTO', 'moto')) || UserAgentMatcher::contains($userAgent, 'Motorola')) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/MotorolaUserAgentMatcher.php');
             return new MotorolaUserAgentMatcher($wurfl);
         }
         // Continue processing UAMs in alphabetical order
         // Alcatel
         if (UserAgentMatcher::startsWith($userAgent_lcase, "alcatel")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/AlcatelUserAgentMatcher.php');
             return new AlcatelUserAgentMatcher($wurfl);
         }
         // Apple
         if (UserAgentMatcher::contains($userAgent, array("iPhone", "iPod", "iPad", "(iphone"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/AppleUserAgentMatcher.php');
             return new AppleUserAgentMatcher($wurfl);
         }
         // BenQ
         if (UserAgentMatcher::startsWith($userAgent_lcase, "benq")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/BenQUserAgentMatcher.php');
             return new BenQUserAgentMatcher($wurfl);
         }
         // DoCoMo
         if (UserAgentMatcher::startsWith($userAgent, "DoCoMo")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/DoCoMoUserAgentMatcher.php');
             return new DoCoMoUserAgentMatcher($wurfl);
         }
         // Grundig
         if (UserAgentMatcher::startsWith($userAgent_lcase, "grundig")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/GrundigUserAgentMatcher.php');
             return new GrundigUserAgentMatcher($wurfl);
         }
         // HTC
         if (UserAgentMatcher::contains($userAgent, array("HTC", "XV6875"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/HTCUserAgentMatcher.php');
             return new HTCUserAgentMatcher($wurfl);
         }
         // KDDI
         if (UserAgentMatcher::contains($userAgent, "KDDI-")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/KddiUserAgentMatcher.php');
             return new KddiUserAgentMatcher($wurfl);
         }
         // Kyocera
         if (UserAgentMatcher::startsWith($userAgent, array("kyocera", "QC-", "KWC-"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/KyoceraUserAgentMatcher.php');
             return new KyoceraUserAgentMatcher($wurfl);
         }
         // LG
         if (UserAgentMatcher::startsWith($userAgent_lcase, "lg")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/LGUserAgentMatcher.php');
             return new LGUserAgentMatcher($wurfl);
         }
         // Mitsubishi
         if (UserAgentMatcher::startsWith($userAgent, "Mitsu")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/MitsubishiUserAgentMatcher.php');
             return new MitsubishiUserAgentMatcher($wurfl);
         }
         // NEC
         if (UserAgentMatcher::startsWith($userAgent, array("NEC-", "KGT"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/NecUserAgentMatcher.php');
             return new NecUserAgentMatcher($wurfl);
         }
         // Nintendo
         if (UserAgentMatcher::contains($userAgent, "Nintendo") || UserAgentMatcher::startsWith($userAgent, 'Mozilla/') && UserAgentMatcher::contains($userAgent, "Nitro") && UserAgentMatcher::contains($userAgent, "Opera")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/NintendoUserAgentMatcher.php');
             return new NintendoUserAgentMatcher($wurfl);
         }
         // Panasonic
         if (UserAgentMatcher::startsWith($userAgent, "Panasonic")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/PanasonicUserAgentMatcher.php');
             return new PanasonicUserAgentMatcher($wurfl);
         }
         // Pantech
         if (UserAgentMatcher::startsWith($userAgent, array("Pantech", "PT-", "PANTECH", "PG-"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/PantechUserAgentMatcher.php');
             return new PantechUserAgentMatcher($wurfl);
         }
         // Philips
         if (UserAgentMatcher::startsWith($userAgent_lcase, "philips")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/PhilipsUserAgentMatcher.php');
             return new PhilipsUserAgentMatcher($wurfl);
         }
         // Portalmmm
         if (UserAgentMatcher::startsWith($userAgent, "portalmmm")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/PortalmmmUserAgentMatcher.php');
             return new PortalmmmUserAgentMatcher($wurfl);
         }
         // Qtek
         if (UserAgentMatcher::startsWith($userAgent, "Qtek")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/QtekUserAgentMatcher.php');
             return new QtekUserAgentMatcher($wurfl);
         }
         // Sagem
         if (UserAgentMatcher::startsWith($userAgent_lcase, "sagem")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SagemUserAgentMatcher.php');
             return new SagemUserAgentMatcher($wurfl);
         }
         // Sanyo
         if (UserAgentMatcher::startsWith($userAgent_lcase, "sanyo") || UserAgentMatcher::contains($userAgent, "MobilePhone")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SanyoUserAgentMatcher.php');
             return new SanyoUserAgentMatcher($wurfl);
         }
         // Sharp
         if (UserAgentMatcher::startsWith($userAgent_lcase, "sharp")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SharpUserAgentMatcher.php');
             return new SharpUserAgentMatcher($wurfl);
         }
         // Siemens
         if (UserAgentMatcher::startsWith($userAgent, "SIE-")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SiemensUserAgentMatcher.php');
             return new SiemensUserAgentMatcher($wurfl);
         }
         // SPV
         if (UserAgentMatcher::contains($userAgent, 'SPV')) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SPVUserAgentMatcher.php');
             return new SPVUserAgentMatcher($wurfl);
         }
         // Toshiba
         if (UserAgentMatcher::startsWith($userAgent, "Toshiba")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/ToshibaUserAgentMatcher.php');
             return new ToshibaUserAgentMatcher($wurfl);
         }
         // Vodafone
         if (UserAgentMatcher::startsWith($userAgent, 'Vodafone')) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/VodafoneUserAgentMatcher.php');
             return new VodafoneUserAgentMatcher($wurfl);
         }
         // Process mobile browsers after mobile devices
         // Android
         if (UserAgentMatcher::contains($userAgent, "Android")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/AndroidUserAgentMatcher.php');
             return new AndroidUserAgentMatcher($wurfl);
         }
         // Opera Mini
         if (UserAgentMatcher::contains($userAgent, array('Opera Mini', 'Opera Mobi'))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/OperaMiniUserAgentMatcher.php');
             return new OperaMiniUserAgentMatcher($wurfl);
         }
         // Windows CE
         if (UserAgentMatcher::contains($userAgent, "Mozilla/") && UserAgentMatcher::contains($userAgent, "Windows CE")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/WindowsCEUserAgentMatcher.php');
             return new WindowsCEUserAgentMatcher($wurfl);
         }
     }
     // End if(!$isDesktop)
     // Process Robots (Web Crawlers and the like)
     if (UserAgentUtils::isRobot($userAgent)) {
         require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/BotUserAgentMatcher.php');
         return new BotUserAgentMatcher($wurfl);
     }
     // Process NON-MOBILE user agents
     if (!$isMobile) {
         // MSIE
         if (UserAgentMatcher::startsWith($userAgent, "Mozilla") && UserAgentMatcher::contains($userAgent, "MSIE") && !UserAgentMatcher::contains($userAgent, array("Opera", "armv", "MOTO", "BREW"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/MSIEUserAgentMatcher.php');
             return new MSIEUserAgentMatcher($wurfl);
         }
         // Firefox
         if (UserAgentMatcher::contains($userAgent, "Firefox") && !UserAgentMatcher::contains($userAgent, array("Sony", "Novarra", "Opera"))) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/FirefoxUserAgentMatcher.php');
             return new FirefoxUserAgentMatcher($wurfl);
         }
         // Chrome
         if (UserAgentMatcher::contains($userAgent, "Chrome")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/ChromeUserAgentMatcher.php');
             return new ChromeUserAgentMatcher($wurfl);
         }
         // Konqueror
         if (UserAgentMatcher::contains($userAgent, "Konqueror")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/KonquerorUserAgentMatcher.php');
             return new KonquerorUserAgentMatcher($wurfl);
         }
         // Opera
         if (UserAgentMatcher::contains($userAgent, "Opera")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/OperaUserAgentMatcher.php');
             return new OperaUserAgentMatcher($wurfl);
         }
         // Safari
         if (UserAgentMatcher::startsWith($userAgent, "Mozilla") && UserAgentMatcher::contains($userAgent, "Safari")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/SafariUserAgentMatcher.php');
             return new SafariUserAgentMatcher($wurfl);
         }
         // AOL
         if (UserAgentMatcher::contains($userAgent, array("AOL", "America Online")) || UserAgentMatcher::contains($userAgent_lcase, "aol 9")) {
             require_once realpath(dirname(__FILE__) . '/UserAgentMatchers/AOLUserAgentMatcher.php');
             return new AOLUserAgentMatcher($wurfl);
         }
     }
     // Nothing has matched so we will have to use the CatchAllUserAgentMatcher
     return new CatchAllUserAgentMatcher($wurfl);
 }