cbschuld/browser.php
A PHP Class to detect a user's Browser. This encapsulation provides a breakdown of the browser and the version of the browser using the browser's user-agent string. This is not a guaranteed solution but provides an overall accurate way to detect what browser a user is using.
v2.0.0
7.3M downloads/mo
#2120 most downloaded on Packagist
cbschuld/Browser.php
What this package is like to depend on
Last release 11 months ago
04 Sep 2025
Ships unpredictably
gaps range from 8 days to 5.4 years
Nearly every release is documented
notes for 7 of 7 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
7 releases · first in 2019
1 release in the last 12 months
see the full history below
Release timeline
7 releases · Jun 2019 to Sep 2025
2020
2021
2022
2023
2024
2025
2026
Releases
latest 7-
v2.0.004 Sep 2025Release notes
Open source →Added
- PSR-4 autoloading with
cbschuldnamespace - Return type declarations on key methods (setVersion, checkBrowserEdge, etc.)
compareVersion()method for PHP 8+ compatible version comparisons- Enhanced Edge browser detection (supports Edge/, Edg/, EdgA/, EdgiOS/ patterns)
- Root-level Browser.php shim for non-Composer backward compatibility
- GitHub Actions CI pipeline (replaces Travis CI)
- Support metadata in composer.json
- Comprehensive upgrade documentation (UPGRADING.md)
Changed
- BREAKING: Minimum PHP version is now 8.0 (was 7.2)
- BREAKING: Added return type declarations to key methods (may affect extenders)
- BREAKING: Class is now namespaced as
cbschuld\Browser - Updated PHPUnit to 9.6 for broad PHP 8.x compatibility
- Updated phpunit.xml.dist to PHPUnit 9.6 schema
- Fixed fgetcsv escape parameter for PHP 8.1+ compatibility
- Removed composer.lock from repository (library best practice)
Removed
- Support for PHP 7.x
- Travis CI configuration (.travis.yml)
- Composer branch alias
Migration
- See UPGRADING.md for detailed migration instructions
- Backward compatibility maintained via automatic class aliasing
- Non-Composer users can still use direct includes
Breaking Changes
PHP Version Requirement
- Minimum PHP version: 8.0+ (was 7.2+)
- Reason: Enables modern PHP features and improved performance
Namespace Introduction
- New namespace:
cbschuld\Browser - Migration path: See usage examples below
Return Type Declarations
- Added return type hints to protected methods
- Impact: If you extend the
Browserclass and override protected methods, you'll need to add matching return types - Example:
protected function checkBrowserEdge(): bool(wasprotected function checkBrowserEdge())
Release notes
Open source →Added
- PSR-4 autoloading with
cbschuldnamespace - Return type declarations on key methods (setVersion, checkBrowserEdge, etc.)
compareVersion()method for PHP 8+ compatible version comparisons- Enhanced Edge browser detection (supports Edge/, Edg/, EdgA/, EdgiOS/ patterns)
- Root-level Browser.php shim for non-Composer backward compatibility
- GitHub Actions CI pipeline (replaces Travis CI)
- Support metadata in composer.json
- Comprehensive upgrade documentation (UPGRADING.md)
Changed
- BREAKING: Minimum PHP version is now 8.0 (was 7.2)
- BREAKING: Added return type declarations to key methods (may affect extenders)
- BREAKING: Class is now namespaced as
cbschuld\Browser - Updated PHPUnit to 9.6 for broad PHP 8.x compatibility
- Updated phpunit.xml.dist to PHPUnit 9.6 schema
- Fixed fgetcsv escape parameter for PHP 8.1+ compatibility
- Removed composer.lock from repository (library best practice)
Removed
- Support for PHP 7.x
- Travis CI configuration (.travis.yml)
- Composer branch alias
Migration
- See UPGRADING.md for detailed migration instructions
- Backward compatibility maintained via automatic class aliasing
- Non-Composer users can still use direct includes
- PSR-4 autoloading with
-
v1.9.614 Apr 2020Release notes
Open source →Adds
- support for Android Edge
Removes
- tests for 7.2 as it was dropped by Travis CI/trusty
Changes
- moved from /lib to /src for classes to get ready for 2.0 which will support PSR-4 loading
-
1.9.506 Apr 2020Release notes
Open source →Added
- better support for the Edge Browser
- updated travis to trusty and removed 7.2, added 7.4 for tests
- added better/additional Edge tests
Thanks
- thank you to @GramThanos for the PRs
-
1.9.409 Jul 2019Release notes
Open source →Added
- Added better support for Firefox Mobile
- Added support for the Brave browser
- Added support for the UCBrowser
- Added more tests for specific User Agents and more IE tests (removed duplicate UAs as well)
Release notes
Open source →Added
- Added better support for Firefox Mobile
- Added support for the Brave browser
- Added support for the UCBrowser
- Added more tests for specific User Agents and more IE tests (removed duplicate UAs as well)
-
1.9.308 Jul 2019 -
1.9.226 Jun 2019Release notes
Open source →Added testing to this release, updated the firefox and chrome sensors. Test suite addresses Firefox, Chrome and Opera detection with 3684 individual user-agent tests.
Added
- PHPUnit Tests for Firefox, Opera and Chrome (3684 tests, 7368 assertions)
- Stronger tests for Firefox and Chrome
Removed
- Dropped support for 5.x PHP due to updates to PHPUnit and legacy nature of 5.X
Release notes
Open source →Added
- PHPUnit Tests for Firefox, Opera and Chrome (3684 tests, 7368 assertions)
- Stronger tests for Firefox and Chrome
Removed
- Dropped support for 5.x PHP due to updates to PHPUnit and legacy nature of 5.X
-
1.9.109 Jul 2019Release notes
Open source →6/19/2019: Update (Version 1.9.1)
- Added Firefox iOS (gejobj)
- Corrected 'Vivalidi' to 'Vivaldi' (adaxi)
- Reset enhancement (yahasana)
- Enforce using precise distribution until End Of Life for Travis CI (bburnichon)
- Lazy load browser class on demand (bburnichon)
Release notes
Open source →Added
6/19/2019: Update (Version 1.9.1)
- Added Firefox iOS (gejobj)
- Corrected 'Vivalidi' to 'Vivaldi' (adaxi)
- Reset enhancement (yahasana)
- Enforce using precise distribution until End Of Life for Travis CI (bburnichon)
- Lazy load browser class on demand (bburnichon)