A Flamework library for decoding User Agent strings

This library is designed to be used with Flamework, but works standalone too.

Usage:

# single shot
$ret = useragent_decode($ua);

# when decoding in batches
$ret = useragent_decode_cached($ua);

# return structure
$ret = array(
  'agent'          => 'chrome',
  'agent_version'  => '15.0.874.121',
  'engine'         => 'webkit',
  'engine_version' => '535.2',
  'os'             => 'osx',
  'os_version'     => '10.7.2',
);

Possible values

agent will be one of the following, with the full version number in agent_version:

• chrome
• safari
• firefox
• msie
• dalvik (android VM, not actually the browser)
• opera
• netscape
• konqueror
• blackberry (pre-safari)

engine contains the rendering engine, with the full version number in engine_version:

• webkit
• gecko
• trident
• presto

os and os_version contain the platform, with the following values:

• osx/n.n(.n)
• iphone/n.n(.n)
• ipad/n.n(.n)
• ipod/n.n(.n)
• windows/xp
• windows/xp-x64
• windows/vista
• windows/7
• linux/i686
• linux/x86_64
• android/n.n(.n)
• blackberry/$model

When a field does not match one of the known values, it will be set to null.

Caveats

• Not all browsers, rendering engines and platforms are supported - this is by design! Only common agents are included.
• We just return "linux/i686" rather than e.g. "Ubuntu", since most Linux flavors don't give distro, plus nobody cares.
• Chromium returns "chrome" - same thing anyway, plus it has a different version number.
• We differentiate iPad, iPhone and iPod, even though they are the same OS. You can easily patch this locally if you don't need to know.