Download the PHP package shapeways/referer-parser without Composer
On this page you can find all versions of the php package shapeways/referer-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download shapeways/referer-parser
More information about shapeways/referer-parser
Files in shapeways/referer-parser
Package referer-parser
Short Description Snowplow Refer(r)er parser for PHP
License MIT
Informations about the package referer-parser
referer-parser
referer-parser is a multi-language library for extracting marketing attribution data (such as search terms) from referer URLs, inspired by the ua-parser project (an equivalent library for user agent parsing).
referer-parser is a core component of Snowplow, the open-source web-scale analytics platform powered by Hadoop and Redshift.
Note that we always use the original HTTP misspelling of 'referer' (and thus 'referal') in this project - never 'referrer'.
Maintainers
- PHP: Yuehlin Chung at Shapeways, Inc
referers.yml
: Snowplow Analytics
Usage: PHP
The PHP version of this library uses the updated API, and identifies search, social, webmail, internal and unknown referers:
For more information, please see the PHP README.
referers.yml
referer-parser identifies whether a URL is a known referer or not by checking it against the referers.yml
file; the intention is that this YAML file is reusable as-is by every language-specific implementation of referer-parser.
The file is broken out into sections for the different mediums that we support:
unknown
for when we know the source, but not the mediumemail
for webmail providerssocial
for social media servicessearch
for search engines
Then within each section, we list each known provider (aka source
) by name, and then which domains each provider uses. For search engines, we also list the parameters used in the search engine URL to identify the search term
. For example:
The number of referers and the domains they use is constantly growing - we need to keep referers.yml
up-to-date, and hope that the community will help!
Contributing
We welcome contributions to referer-parser:
- New search engines and other referers - if you notice a search engine, social network or other site missing from
referers.yml
, please fork the repo, add the missing entry and submit a pull request - Ports of referer-parser to other languages - we welcome ports of referer-parser to new programming languages (e.g. Lua, Go, Haskell, C)
- Bug fixes, feature requests etc - much appreciated!
Please sign the Snowplow CLA before making pull requests.
Support
General support for referer-parser is handled by the team at Snowplow Analytics Ltd.
You can contact the Snowplow Analytics team through any of the channels listed on their wiki.
Copyright and license
referers.yml
is based on Piwik's SearchEngines.php
and Socials.php
, copyright 2012 Matthieu Aubry and available under the GNU General Public License v3.
The PHP port is copyright 2013-2014 Lars Strojny and is available under the MIT License.