Releases: donatj/PhpUserAgent
PlayStation 5 Support + Cleanup
- Adds PlayStation 5 support
- Drops Support for PHP 5.3
- General cleanup
- Improved Firefox test coverage
Adds support for TelegramBot, Twitterbot and iMessageBot
Adds official support for TelegramBot and Twitterbot.
They were already detected but did not have constants nor tests.
Adds sniffing and support for iMessageBot.
Please Upgrade to v1.4.0 Instead of Using This - Adds support for TelegramBot, Twitterbot and iMessageBot
Adds official support for TelegramBot and Twitterbot.
They were already detected but did not have tests.
Adds sniffing and support for iMessageBot.
Please upgrade to the 1.x release.
This is a deprecated release for compatibility.
The functionality of this release is mirrored exactly by v1.3.0 and does not break compatibility. You can easily upgrade.
The 0.x releases will soon no longer be maintained.
Please upgrade ASAP.
Adds support for Miui Browser and Sailfish OS + Sailfish Browser
Adds:
- Support for Miui Browser
- Support for Sailfish OS
- Support for Sailfish Browser
Please Upgrade to v1.3.0 Instead of Using This - Adds support for Miui Browser and Sailfish OS + Sailfish Browser
Adds:
- Support for Miui Browser
- Support for Sailfish OS
- Support for Sailfish Browser
Please consider upgrading to the 1.x release.
This is a deprecated release for compatibility.
The functionality of this release is mirrored exactly by v1.3.0 and does not break compatibility. The 0.x releases will soon no longer be maintained. Please upgrade ASAP.
Much Better UC Browser Support
- Older versions of UC Browser noted the platform as
Adr
rather thanAndroid
- handle this weirdness. - Add a bunch of tests for UC Browser
Please use release v1.2.0 Instead - Much Better UC Browser Support
- Older versions of UC Browser noted the platform as
Adr
rather thanAndroid
- handle this weirdness. - Add a bunch of tests for UC Browser
Please consider upgrading to the 1.x release.
This is a deprecated release for compatibility.
The functionality of this release is mirrored exactly by v1.2.0 and does not break compatibility. The 0.x releases will soon no longer be maintained. Please upgrade ASAP.
Applebot Support
Adds support for the Applebot - http://www.apple.com/go/applebot
Applebot Support - Retroactive
Adds support for the Applebot - http://www.apple.com/go/applebot
Please consider upgrading to the 1.x release.
The functionality of this release is mirrored by v1.1.0 and does not break backwards compatibility. The 0.x releases will soon no longer be maintained.
1.0.0 Major Release
This is a major rework of the entire project that took just under 2 years. The utmost care went into considering how to keep this both the small and light library the community enjoys, but also add features people have been clamoring for since the beginning. I really believe we've hit the nail on the head here.
Backwards Compatibility Considerations:
A lot of work went into not breaking compatibility especially for people not using composer. If you encounter any issues with compatibility let us know and we will fix it ASAP.
All required "functional" logic remains in a single file src/UserAgentParser.php
This is specifically to make the library easy to use for people who do not use composer.
Adds:
- Object oriented convenience wrapper ecosystem.
\donatj\UserAgent\UserAgentParser
- Object orientedparse_user_agent
call wrapper.\donatj\UserAgent\UserAgent
- Object oriented response object.\donatj\UserAgent\UserAgentInterface
- Helper interface for test mocking.
- Namespaced
\donatj\UserAgent\parse_user_agent
function to mirror globalparse_user_agent
- Constants for the returned arrays keys
\donatj\UserAgent\PLATFORM = 'platform';
\donatj\UserAgent\BROWSER = 'browser';
\donatj\UserAgent\BROWSER_VERSION = 'version';
- Helpful predefined constants to check against for Platforms and Browsers generated from the same dataset as the tests.
\donatj\UserAgent\Browsers::*
\donatj\UserAgent\Platforms::*
- Even more test cases
Changes:
parse_user_agent
is deprecated in favor of\donatj\UserAgent\parse_user_agent
- Will remain in the code until at least 2.x
Thus require "{$dir}/src/UserAgentParser.php";
remains a supported method of using the library.
Upgrading to 1.*
The new 1.*
release does not break compatibility with 0.*
and nothing need to change to upgrade. However, the global parse_user_agent
is now deprecated; it has been replaced with the namespaced \donatj\UserAgent\parse_user_agent
and functions exactly the same. You can easily replace any existing call to parse_user_agent
with \donatj\UserAgent\parse_user_agent
In addition, 1.x adds a convenience object wrapper you may use should you prefer. More information on this is in the Usage section of the README.
I would also like to personally thank @mimmi20 for helping review ideas early in the project's life cycle.