Home » Networking » Net_UserAgent_Mobile

HTTP mobile user agent string parser

This package is unmaintained.

Download latest release 1.0.0 (archived versions might be outdated)

License: New BSD License

Description

Net_UserAgent_Mobile parses HTTP_USER_AGENT strings of (mainly Japanese) mobile HTTP user agents. It'll be useful in page dispatching by user agents.
This package was ported from Perl's HTTP::MobileAgent.
See http://search.cpan.org/search?mode=module&query=HTTP-MobileAgent

Maintainers

• KUBO Atsuhiro (kuboa) — lead, active

Dependencies

Required

• PHP (>= 4.3.0)
• PEAR Installer (>= 1.4.3)
• PEAR (>= 1.4.3)
• pcre (extension)

Optional

• xml (extension)

Releases

• 1.0.0 (stable, 2009-06-23)
  Release notes

  License: New BSD License

  What's New in Net_UserAgent_Mobile 1.0.0

  * Updated docomo Support: Nine new models P-10A, P-08A, P-09A, N-09A, F-08A, F-09A, SH-05A, SH-06A, and SH-07A since the release 1.0.0RC3 have been supported. Also the model name of P-07A, N-06A, and N-08A have been adjusted to their fixed user-agent string like P07A => P07A3.

• 1.0.0RC3 (beta, 2009-05-25)
  Release notes

  License: New BSD License

  A new release of Net_UserAgent_Mobile is now available.

  What's New in Net_UserAgent_Mobile 1.0.0RC3

  * Updated docomo Support: Three new models, P-07A, N-06A, and N-08A since the release 1.0.0RC2 have been supported. These models have the i-mode browser 2.0, can be distinguished by newly added getBrowserVersion().

  See the following release notes for details.

  Enhancements
  ============

  - Changed the class declaration so as not to inherit from PEAR. (Net_UserAgent_Mobile, Net_UserAgent_Mobile_Common)
  - Added support for the new models of docomo. (since the release 1.0.0RC2)
  - Added getBrowserVersion() to get the i-mode browser version.

• 1.0.0RC2 (beta, 2009-05-10)
  Release notes

  License: New BSD License

  A new release of Net_UserAgent_Mobile is now available.

  What's New in Net_UserAgent_Mobile 1.0.0RC2

  * Updated DoCoMo Support: A lot of new models since the release 1.0.0RC1 have been supported.
  * A few defect fixes: A few defect (including #13905, #15776) have been fixed.
  * License Change: The license has been changed from PHP License 3.0 to New BSD License (2-clause).

  See the following release notes for details.

  Enhancements
  ============

  - Added Support for the new models of docomo. (since the release 1.0.0RC1) Thanks to Sach Jobb <sach@77hz.jp> for the patch.

  Defect Fixes
  ============

  - Added @ to all list() calls to avoid unwanted warnings for invalid user agent string. (Net_UserAgent_Mobile_DoCoMo, Net_UserAgent_Mobile_EZweb, Net_UserAgent_Mobile_SoftBank) (Bug #13905)
  - Fixed a defect that caused "Strict standards" errors to be raised. (Bug #15776)
  - Fixed a defect that caused a broken error object to be returned even though the specified error mode is not PEAR_ERROR_RETURN. (Net_UserAgent_Mobile)

• 1.0.0RC1 (beta, 2008-05-10)
  Release notes

  License: PHP License

  A new release of Net_UserAgent_Mobile is now available.

  What's New in Net_UserAgent_Mobile 1.0.0RC1

  * UID support: Getting subscriber IDs (UIDs) by getUID() has been supported.
  * Updated DoCoMo Support: 14 new models since the release 0.31.0 have been supported. And also DeNA's Web Crawler has been supported.
  * Two defect fixes: Two minor defects (#13128 and #13129) have been fixed.

  See the following release notes for details.

  Enhancements
  ============

  - Added support for DeNA's Web Crawler. (Request #13130) (Net_UserAgent_Mobile_DoCoMo)
  - Added support for getting subscriber IDs (UIDs) by getUID().
  - Added support for NM705i, L705iX, F883iESS, SH705i, SH705i2, SO905iCS, F905iBiz, P905iTV, P705i, N705imyu, P705imyu, SO705i, P705iCL, F884i. (Net_UserAgent_Mobile_DoCoMo, Net_UserAgent_Mobile_DoCoMo_ScreenInfo)

  Defect Fixes
  ============

  - Added error control operators to all $_SERVER['HTTP_USER_AGENT'] to avoid PHP notices. (Bug #13128) (Net_UserAgent_Mobile)
  - Fixed a defect that the user agent string is not included in an error message raised from noMatch(). (Bug #13129) (Net_UserAgent_Mobile_Common)

• 0.31.0 (beta, 2008-02-10)
  Release notes

  License: PHP License

  A new release of Net_UserAgent_Mobile is now available.

  What's New in Net_UserAgent_Mobile 0.31.0

  * Updated DoCoMo Support: A lot of new models since the release 0.30.0 have been supported. Thanks to yosuke for providing a patch.
  * Some useful interfaces by the Net_UserAgent_Mobile class: The new methods isMobile() and isDoCoMo()/isEZweb()/isSoftBank()/isWillcom() can be used directly to check whether or not the user agent is mobile/DoCoMo/EZweb/SoftBank/Willcom.
  * Enhanced parsers: The Net_UserAgent_Mobile class and the SoftBank parser support SoftBank emulators. And the DoCoMo parser supports Yahoo!'s Web Crawler. Thanks to Hiroaki Kawai for feature requests and providing patches.

  See the following release notes for details.

  Enhancements
  ============

  - Added support for a lot of models. (Net_UserAgent_Mobile_DoCoMo, Net_UserAgent_Mobile_DoCoMoDisplayMap)
  - Changed the behavior of singleton() so that it creates a cache for each user-agent. (Net_UserAgent_Mobile)
  - Added the method isSoftBank() to check whether an agent is SoftBank or not. (Net_UserAgent_Mobile_Common)
  - Renamed the class name from Net_UserAgent_Mobile_Vodafone to Net_UserAgent_Mobile_SoftBank.
  - Added the methods isMobile() and isDoCoMo()/isEZweb()/isSoftBank()/isWillcom() to check whether or not the user agent is mobile/DoCoMo/EZweb/SoftBank/Willcom by a given user agent string or by the HTTP header in an environment. (Net_UserAgent_Mobile)
  - Added the method isWillcom() to check whether an agent is Willcom or not. (Net_UserAgent_Mobile_Common)
  - Renamed the class name from Net_UserAgent_Mobile_AirHPhone to Net_UserAgent_Mobile_Willcom.
  - Added $_model/$_rawModel properties and getModel()/getRawModel() methods. (Net_UserAgent_Mobile_Common)
  - Removed getDeviceID(). (Net_UserAgent_Mobile_NonMobile)
  - Added support some emulators. (Request #12877) (Net_UserAgent_Mobile, Net_UserAgent_Mobile_SoftBank)
  - Added support for Yahoo!'s Web Crawler. (Request #13061) (Net_UserAgent_Mobile_DoCoMo)

  Defect Fixes
  ============

  - Fixed the model name from N506ISII to N506IS2. (Net_UserAgent_Mobile_DoCoMoDisplayMap)
  - Fixed a defect that caused supported HTML versions for some user agents that support HTML version 6.0 or greater to be detected as 5.0. (Net_UserAgent_Mobile_DoCoMo)
  - Fixed invalid width and height of some models. (Net_UserAgent_Mobile_DoCoMoDisplayMap)

• 0.30.0 (beta, 2007-02-20)
  Release notes

  License: PHP License

  A new release of Net_UserAgent_Mobile is now available.

  This release includes a fix for the bug #9891 "dirname(__FILE__) should not be used for include/require". This can be replaced a driver with a user enhancement driver in the normal way.

  And also this release includes other fixes and supports many new models. See the following release notes for details.

  ## Defect Fixes ##

  - Changed to not use dirname(__FILE__) for include/require. (Bug #9891)

  ### Net_UserAgent_Mobile_DoCoMo ###

  - Changed so that an FOMA Card ID (iccXXXXXXXXXXXXXXXXXXXX) without 20 digit alphanumeric can be parsed successfully. Then getCardID() method will simply return null. (Bug #8584)
  - Fixed the HTML version for 882i from 5.0 to 6.0.

  ### Net_UserAgent_Mobile_Vodafone ###

  - Removed a duplicate statement. (Bug #8806)
  - Fixed model version matching to get appropriate model version as JP10 for 705P/PJP10.

  ## Enhancements ##

  ### Net_UserAgent_Mobile_DoCoMo, Net_UserAgent_Mobile_DoCoMoDisplayMap ###

  - Added support for L601i, M702iS, M702iG, N902iL, N601i, D800iDS, P703imyu, N903i, D903i, F903i, SO9603i, D903iTV, F903iX, P903iTV, N703iD, F703i, P703i, D703i, SH703i, N703imyu, SO703i.

• 0.29.0 (beta, 2006-11-07)
  Release notes

  License: PHP License

  This release includes support for SoftBank 705P and DoCoMo 903i series. See the following release notes for details.

  ## Enhancements ##

  ### Net_UserAgent_Mobile_Vodafone ###
  - Added support for SoftBank 705P. Thanks to Seiji Kajiwara <kajiwara@serverworks.co.jp> and HORINOUCHI Masato <t-hermes@confei.to> for the patches.

  ### Net_UserAgent_Mobile_DoCoMo ###
  - Added support for 903i series. Thanks to Masaki Fujimoto <fujimoto@php.net> for the patch.

  ### Net_UserAgent_Mobile_DoCoMoDisplayMap ###
  - Added support for SH903i, P903i.

• 0.28.0 (beta, 2006-09-25)
  Release notes

  License: PHP License

  - Added support for SoftBank. Thanks to Kazunari Komoriya <komoriya@livedoor.jp> for the patches.
  - Added support for N902iX, SH702iS, N702iS, P702iD, D702iF, F882iES.
  - Fixed height of F902iS.

• 0.27.0 (beta, 2006-07-12)
  Release notes

  License: PHP License

  - Added support a lot of agents as follows:
  NM850iG
  P901iTV
  F881iES
  N701iECO
  SA800i
  L600i
  N600i
  SO902i
  SH902iS
  P902iS
  N902iS
  D902iS
  F902iS
  SO902iWP+
  P702i
  N702iD
  F702iD
  SH702iD
  D702i
  SO702i
  D702iBCL
  D851iWM
  SH902iSL
  SA702i

• 0.26.0 (beta, 2006-02-01)
  Release notes

  License: PHP License

  - Added support for 'WILLCOM'.
  - Added support for 701i and 902i in getHTMLVersion.
  - Added support for DoCoMo's SO213iWR, SA700iS, P851i, D701i, N701i, P701iD, D701iWM, F902i, D902i, N902i, P902i, SH902i.

• 0.25.0 (beta, 2005-08-18)
  Release notes

  License: PHP License

  - Fixed "Only variable references should be returned by reference" notice with PHP 4.4.0 and 5.1.0.
  - Added support for DoCoMo's SH851i, F700iS, SH700iS.
  - Added code to get the vendor code of 'V301SH', 'V301T', etc in Vodafone.php. (Bug #5124)
  - Fixed 'Undefined offset' error in Vodafone.php.

• 0.24.0 (beta, 2005-07-27)
  Release notes

  License: PHP License

  - Added fallback mode on no match using $GLOBALS['_NET_USERAGENT_MOBILE_FALLBACK_ON_NOMATCH'].
  - Changed the EZweb regex pattern to be able to match au's A5511T.
  - Added support for DoCoMo's SO506iS, SH901iS, F901iS, D901iS, P901iS, N901iS.

  ** NOTE **
  If you want to use fallback mode on no match, please set true to $GLOBALS['_NET_USERAGENT_MOBILE_FALLBACK_ON_NOMATCH'] before calling factory().

• 0.23.0 (beta, 2005-03-23)
  Release notes

  License: PHP License

  - Added support for DoCoMo's N506iS, SO506i, P253iS.
  - Added support for DoCoMo's N901iC, D901i, P901i, F700i, SH700i, N700i, P700i. (by Christopher Kobayashi <chriskk at gmail dot com>)

• 0.22.0 (beta, 2005-02-03)
  Release notes

  License: PHP License

  * Mobile/Vodafone.php
  - Added getMsname() method which returns the value of x-jphone-msname header, which is the name of the mobile phone.

  * Mobile/NonMobile.php
  - Added makeDisplay() method as a temporary measure since the script would die when the method is called. (Bug #3368)

• 0.21.0 (beta, 2005-02-01)
  Release notes

  License: PHP License

  - Added support for Vodafone 3G mobile phones (3GC).
  - Added support for DoCoMo's SO213iS, D253i, N253i, P253i, D253iWM, P213i, N900iL, N900iG, SH901iC, F901iC.

• 0.20.0 (beta, 2004-09-25)
  Release notes

  License: PHP License

  - Fixed Bug #827 without BC break. This package currently works properly on PHP5.
  - Added getCarrierShortName() and getCarrierLongName() methods.
  - Added isVodafone() method.
  - Added isTUKa() method.
  - Changed the way to get a series of FOMA in DoCoMo.php.
  - Added support for DoCoMo's P651ps, SO213i, N506i, P506iC, SH506iC, SO506iC, F900iT, P900iV, N900iS, D900i, F900iC, F880iES.
  - Changed treatment of the name of the model in EZweb.php. getModel() method currently returns the device ID.
  - Renamed from JPhone.php to Vodafone.php.
  - Added getModel() and getDeviceID() methods in NonMobile.php. These methods always return ''.

• 0.19 (beta, 2004-05-27)
  Release notes

  License: PHP License

  - Added a external map file support.
  the XML data which is generated by makexmldocomomap, which is included in
  Perl's HTTP::MobileAgent, is now available.
  Please see the API documentation of Net_UserAgent_Mobile_Display class.
  - Added support for DoCoMo's P252iS, D506i, F506i.
  - Added support for EZweb's W21H, A5504T, TK41.

  ** NOTE **
  In the next release, BC will be broken for PHP5 compatibility reasons. Please
  see bug #827.

• 0.18 (beta, 2004-03-20)
  Release notes

  License: PHP License

  - Added support for DoCoMo's N900i, P900i, SH900i.
  - Added support for EZweb's A5502K, A5405SA, A1402S.
  - Some fixes related to PHP5 issues.

• 0.17 (beta, 2004-02-08)
  Release notes

  License: PHP License

  - Added support for DoCoMo's F505iGPS, F900i.
  - Added support for EZweb's A5502K, TS41.
  - EZweb.php: Fixed the model name for KCTD.

• 0.16 (beta, 2003-12-15)
  Release notes

  License: PHP License

  - Added support for DoCoMo's N505iS, SO505iS, SH505iS.
  - Added support for EZweb's W11K, W11H, A5503SA, A5404S, A5403CA, TS40, TT32
  in getModel() method.

• 0.15 (beta, 2003-11-16)
  Release notes

  License: PHP License

  - Added support for DoCoMo's D505iS, P505iS, P252i, N252i.
  - EZweb.php: Added getModel() method using a static table.

• 0.14.1 (beta, 2003-10-12)
  Release notes

  License: PHP License

  - removed a print statement for debugging in Net_UserAgent_Mobile::singleton().

• 0.14 (beta, 2003-10-12)
  Release notes

  License: PHP License

  - Added singleton() method.
  - Added support for DoCoMo's D252i, SH252i.

• 0.13 (beta, 2003-09-04)
  Release notes

  License: PHP License

  - Added support for DoCoMo's SH505i2, F672i.

• 0.12 (beta, 2003-08-11)
  Release notes

  License: PHP License

  - Changed way to handle static variables from the PEAR::getStaticProperty
  method to the static statement.
  - AirHPhone.php: Added makeDisplay() method as a temporary measure since the
  script would die when the method is called.
  - Added display information for DoCoMo's N2102V, P505i.

• 0.11 (beta, 2003-07-20)
  Release notes

  License: PHP License

  - Added display information for DoCoMo's P2102V, F2102V, F505i.

• 0.10 (beta, 2003-07-07)
  Release notes

  License: PHP License

  - Added display information for DoCoMo's N2701, SH505i, N505i.
  - Added support for DoCoMo's FOMA 2701.
  - Changed license from PHP license 2.02 to PHP license 3.0.

• 0.9 (beta, 2003-06-05)
  Release notes

  License: PHP License

  - Added display information about DoCoMo's 'SO505i'.
  - DoCoMo.php: Fixed the logic error which entered at the time of 505i support.

• 0.8 (beta, 2003-05-23)
  Release notes

  License: PHP License

  - Added isGPS() method in DoCoMo.
  - Added display information about DoCoMo's 'D505i'.

• 0.7 (beta, 2003-05-12)
  Release notes

  License: PHP License

  - Added support for DoCoMo 505i.

• 0.6 (beta, 2003-04-22)
  Release notes

  License: PHP License

  - Added support for DoCoMo's 'N251iS', 'F661i'.

• 0.5 (beta, 2003-04-07)
  Release notes

  License: PHP License

  - Added AirH"PHONE support.
  - Added display information about DoCoMo's 'N211iS', 'P211iS'.

• 0.4 (beta, 2003-03-27)
  Release notes

  License: PHP License

  - Changed way to get characteristics for new format of user agent which is
  used by 'FOMA 2051/2102V'.
  - Added display information about DoCoMo's 'P2102V'.
  - Added PEAR error handling.
  - Updated documentation.

• 0.3 (beta, 2003-02-24)
  Release notes

  License: PHP License

  - Added isNonMobile() method.

• 0.2 (beta, 2003-02-20)
  Release notes

  License: PHP License

  - Added code which had forgotten by the port.

• 0.1 (beta, 2003-02-19)
  Release notes

  License: PHP License

  - initial release

Bugs