Browser.php - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #go #machine-learning #rust #macos #java #awesome #awesome-list #vue #pytorch #mcp #openai #open-source

Browser.php

(★ 579)

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.

파일 탐색기

최종 버전 다운로드 (.zip)

- - tests.yml
- Browser.php
- Browser.php
- - brave.txt
  - chrome.txt
  - edge.txt
  - firefox-mobile.txt
  - firefox.txt
  - ie.txt
  - opera.txt
  - palemoon.txt
  - ucbrowser.txt
- AliasTest.php
- BraveTest.php
- ChromeTest.php
- CurlWgetTest.php
- EdgeTest.php
- FirefoxMobileTest.php
- FirefoxTest.php
- InternetExplorerTest.php
- OperaTest.php
- PalemoonTest.php
- StaticTest.php
- TabDelimitedFileIterator.php
- UCBrowserTest.php
.gitignore
Browser.php
CHANGELOG.md
composer.json
LICENSE.md
phpunit.xml.dist
README.md
UPGRADING.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/cbschuld/Browser.php

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd Browser.php

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. PHP (Composer)

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
PHP PHP 실행 환경이 필요합니다.
Composer PHP 라이브러리 설치를 위한 패키지 매니저입니다.

composer require cbschuld/browser.php

이 명령어를 터미널에 그대로 입력해 실행하세요.

composer require --dev cbschuld/browser.php

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ php -S localhost:8000 같은 내장 서버로 실행한 뒤 브라우저에서 http://localhost:8000 으로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# cbschuld/browser.php

[![Tests](https://github.com/cbschuld/Browser.php/actions/workflows/tests.yml/badge.svg)](https://github.com/cbschuld/Browser.php/actions/workflows/tests.yml)

Helps detect the user's browser and platform at the PHP level via the user agent

## Installation

### Via Composer (Recommended)

```bash
composer require cbschuld/browser.php
```

For development only:
```bash
composer require --dev cbschuld/browser.php
```

### Direct Download

Download `Browser.php` and include it in your project:
```php
require_once 'Browser.php';
```

## Usage

### Modern Usage (v2.0+, Recommended)

```php
use cbschuld\Browser;

$browser = new Browser();
if ($browser->getBrowser() == Browser::BROWSER_FIREFOX && $browser->compareVersion('10', '>=')) {
    echo 'You have Firefox version 10 or greater';
}
```

### Legacy Usage (Still Supported)

```php
// Works via automatic aliasing - no namespace needed
$browser = new Browser();
if ($browser->getBrowser() == Browser::BROWSER_FIREFOX && $browser->getVersion() >= 10) {
    echo 'You have Firefox version 10 or greater';
}
```

### Version Comparison (PHP 8+ Compatible)

```php
use cbschuld\Browser;

$browser = new Browser();

// Recommended approach for version comparison
if ($browser->compareVersion('15.0', '>=')) {
    echo 'Modern browser detected';
}

// Multiple comparisons
if ($browser->getBrowser() == Browser::BROWSER_CHROME && 
    $browser->compareVersion('90', '>=')) {
    echo 'Modern Chrome detected';
}
```

## Browser Detection

This solution identifies the following Browsers and does a best-guess on the version:

* Opera (`Browser::BROWSER_OPERA`)
* WebTV (`Browser::BROWSER_WEBTV`)
* NetPositive (`Browser::BROWSER_NETPOSITIVE`)
* Edge (`Browser::BROWSER_EDGE`)
* Internet Explorer (`Browser::BROWSER_IE`)
* Pocket Internet Explorer (`Browser::BROWSER_POCKET_IE`)
* Galeon (`Browser::BROWSER_GALEON`)
* Konqueror (`Browser::BROWSER_KONQUEROR`)
* iCab (`Browser::BROWSER_ICAB`)
* OmniWeb (`Browser::BROWSER_OMNIWEB`)
* Phoenix (`Browser::BROWSER_PHOENIX`)
* Firebird (`Browser::BROWSER_FIREBIRD`)
* UCBrowser (`Browser::BROWSER_UCBROWSER`)
* Firefox (`Browser::BROWSER_FIREFOX`)
* Mozilla (`Browser::BROWSER_MOZILLA`)
* Palemoon (`Browser::BROWSER_PALEMOON`)
* curl (`Browser::BROWSER_CURL`)
* wget (`Browser::BROWSER_WGET`)
* Amaya (`Browser::BROWSER_AMAYA`)
* Lynx (`Browser::BROWSER_LYNX`)
* Safari (`Browser::BROWSER_SAFARI`)
* Playstation (`Browser::BROWSER_PLAYSTATION`)
* iPhone (`Browser::BROWSER_IPHONE`)
* iPod (`Browser::BROWSER_IPOD`)
* Google's Android(`Browser::BROWSER_ANDROID`)
* Google's Chrome(`Browser::BROWSER_CHROME`)
* GoogleBot(`Browser::BROWSER_GOOGLEBOT`)
* Yahoo!'s Slurp(`Browser::BROWSER_SLURP`)
* W3C's Validator(`Browser::BROWSER_W3CVALIDATOR`)
* BlackBerry(`Browser::BROWSER_BLACKBERRY`)

## Operating System Detection

This solution identifies the following Operating Systems:

* Windows (`Browser::PLATFORM_WINDOWS`)
* Windows CE (`Browser::PLATFORM_WINDOWS_CE`)
* Apple (`Browser::PLATFORM_APPLE`)
* Linux (`Browser::PLATFORM_LINUX`)
* Android (`Browser::PLATFORM_ANDROID`)
* OS/2 (`Browser::PLATFORM_OS2`)
* BeOS (`Browser::PLATFORM_BEOS`)
* iPhone (`Browser::PLATFORM_IPHONE`)
* iPod (`Browser::PLATFORM_IPOD`)
* BlackBerry (`Browser::PLATFORM_BLACKBERRY`)
* FreeBSD (`Browser::PLATFORM_FREEBSD`)
* OpenBSD (`Browser::PLATFORM_OPENBSD`)
* NetBSD (`Browser::PLATFORM_NETBSD`)
* SunOS (`Browser::PLATFORM_SUNOS`)
* OpenSolaris (`Browser::PLATFORM_OPENSOLARIS`)
* iPad (`Browser::PLATFORM_IPAD`)

## History and Legacy

Detecting the user's browser type and version is helpful in web applications that harness some of the newer bleeding edge concepts. With the browser type and version you can notify users about challenges they may experience and suggest they upgrade before using such application. Not a great idea on a large scale public site; but on a private application this type of check can be helpful.

In an active project of mine we have a pretty graphically intensive and visually appealing user interface which leverages a lot of transparent PNG files. Because we all know how great IE6 supports PNG files it was necessary for us to tell our users the lack of power their browser has in a kind way.

Searching for a way to do this at the PHP layer and not at the client layer was more of a challenge than I would have guessed; the only script available was written by Gary White and Gary no longer maintains this script because of reliability. I do agree 100% with Gary about the readability; however, there are realistic reasons to desire the user's browser and browser version and if your visitor is not echoing a false user agent we can take an educated guess.

I based this solution off of Gary White's original work but have since replaced all of his original code.  Either way, thank you to Gary.  Sadly, I never was able to get in touch with him regarding this solution.

## Testing

The testing with PHPUnit against known user agents available in tests/lists.  Each file is tab delimited with the following fields:

User Agent, User Agent Type, Browser, Version, Operating System, Operating System Version

eg
```
Opera/9.80 (X11; Linux i686; Ubuntu/14.10) Presto/2.12.388 Version/12.16	Browser	Opera	12.16	Linux	Linux	
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_2) AppleWebKit/535.1 (KHTML, like Gecko) Chrome/14.0.835.186 Safari/535.1   Browser	Chrome	14.0.835.186	Macintosh	OS X		10_7_2
```

Tests can be run by phpunit:

```bash
vendor/bin/phpunit
```

## Upgrading from v1.x

See [UPGRADING.md](UPGRADING.md) for detailed migration instructions.

**Quick Summary:**
- v2.0 requires PHP 8.0+
- Class is now namespaced: `cbschuld\Browser`
- Backward compatibility maintained via automatic aliasing
- Use `compareVersion()` for reliable version comparisons