PHPackages simplestats/referer-parser - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. simplestats/referer-parser ActiveLibrary[Utility & Helpers](/categories/utility) simplestats/referer-parser ========================== Snowplow Refer(r)er parser for PHP v1.1.3(4mo ago)11.1k1MITPHPPHP >=8.2CI passing Since Jan 13Pushed 3mo agoCompare [ Source](https://github.com/bogdancondorachi/php-referer-parser)[ Packagist](https://packagist.org/packages/simplestats/referer-parser)[ RSS](/packages/simplestats-referer-parser/feed)WikiDiscussions main Synced today READMEChangelog (2)Dependencies (3)Versions (6)Used By (1) ❄️ PHP Snowplow Referer Parser ============================== [](#️-php-snowplow-referer-parser) A modern PHP implementation of [referer-parser](https://github.com/snowplow-referer-parser/referer-parser), the library for extracting **traffic data** from referer *(sic)* URLs. The implementation uses a JSON version of the shared `database` of known referers found in [`referers.yml`](https://github.com/snowplow-referer-parser/referer-parser/blob/master/resources/referers.yml). 🔱 Maintained PHP 8.2+ fork of [php-referer-parser](https://github.com/snowplow-referer-parser/php-referer-parser) by [Lars Strojny](https://github.com/lstrojny), with automatic data updates. ✨ Key Features -------------- [](#-key-features) - 🌍 Parse referer URLs into structured attribution data - 🧭 Identify traffic source and medium (search, social, email, etc.) - 📝 Extract search terms from supported search engines - 📦 Based on Snowplow’s shared referer database - ⚡ Modern PHP 8.2+ implementation - 🔁 Regularly updated referer data 🧩 Requirements -------------- [](#-requirements) - **PHP** ≥ 8.2 📦 Installation -------------- [](#-installation) ``` composer require simplestats/referer-parser ``` 🚀 Usage ------- [](#-usage) ``` use Snowplow\RefererParser\Parser; $parser = new Parser(); $referer = $parser->parse( 'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari', 'http:/www.psychicbazaar.com/shop' ); if ($referer->isKnown()) { echo $referer->medium; // Medium::SEARCH echo $referer->source; // "Google" echo $referer->searchTerm; // "gateway oracle cards denise linn" } ``` 🤝 Contributing -------------- [](#-contributing) Fork & PR are welcome. 🙏 Credits --------- [](#-credits) - 🧠 [Snowplow](https://github.com/snowplow) for the original [referer-parser](https://github.com/snowplow-referer-parser/referer-parser) library - 👤 [Lars Strojny](https://github.com/lstrojny) for the original [php-referer-parser](https://github.com/snowplow-referer-parser/php-referer-parser) 📜 License --------- [](#-license) [MIT License](./LICENSE) Copyright © 2026-PRESENT [Bogdan Condorachi](https://github.com/bogdancondorachi) [MIT License](https://github.com/snowplow-referer-parser/php-referer-parser/blob/develop/MIT-LICENSE.txt) Copyright © 2013-PRESENT [Lars Strojny](https://github.com/lstrojny) ### Health Score 44 — FairBetter than 90% of packages Maintenance77 Regular maintenance activity Popularity21 Limited adoption so far Community18 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 5 Last Release 138d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/9eaf70d8b4bb15f56f486bc83603613139479b751806cda601a7187ebd07bccf?d=identicon)[bogdancondorachi](/maintainers/bogdancondorachi) ![](https://avatars.githubusercontent.com/u/1329784?v=4)[Daan de Lange](/maintainers/daandelange)[@Daandelange](https://github.com/Daandelange) --- Top Contributors [![bogdancondorachi](https://avatars.githubusercontent.com/u/39380741?v=4)](https://github.com/bogdancondorachi "bogdancondorachi (18 commits)")[![lstrojny](https://avatars.githubusercontent.com/u/79707?v=4)](https://github.com/lstrojny "lstrojny (15 commits)")[![fblundun](https://avatars.githubusercontent.com/u/5892914?v=4)](https://github.com/fblundun "fblundun (6 commits)")[![alexanderdean](https://avatars.githubusercontent.com/u/200511?v=4)](https://github.com/alexanderdean "alexanderdean (3 commits)")[![mkatrenik](https://avatars.githubusercontent.com/u/887117?v=4)](https://github.com/mkatrenik "mkatrenik (2 commits)")[![swijnands](https://avatars.githubusercontent.com/u/1218969?v=4)](https://github.com/swijnands "swijnands (2 commits)")[![cagataygurturk](https://avatars.githubusercontent.com/u/963018?v=4)](https://github.com/cagataygurturk "cagataygurturk (1 commits)")[![rzats](https://avatars.githubusercontent.com/u/13783592?v=4)](https://github.com/rzats "rzats (1 commits)")[![tiborb](https://avatars.githubusercontent.com/u/3955068?v=4)](https://github.com/tiborb "tiborb (1 commits)")[![denka](https://avatars.githubusercontent.com/u/1197116?v=4)](https://github.com/denka "denka (1 commits)")[![tsileo](https://avatars.githubusercontent.com/u/395031?v=4)](https://github.com/tsileo "tsileo (1 commits)")[![ilianiv](https://avatars.githubusercontent.com/u/3925630?v=4)](https://github.com/ilianiv "ilianiv (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/simplestats-referer-parser/health.svg) ``` [![Health](https://phpackages.com/badges/simplestats-referer-parser/health.svg)](https://phpackages.com/packages/simplestats-referer-parser) ``` ### Alternatives [tizis/lara-comments Comments system for your Laravel application. Features: can be used to comment on any model, HTML filter customization (HTMLPurifier), API, comment rating, replies, events, auth rules ... 1194.7k](/packages/tizis-lara-comments)[yurunsoft/yurun-lock 501.8k](/packages/yurunsoft-yurun-lock) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)