Download the PHP package stormcode/php-domain-parser without Composer
On this page you can find all versions of the php package stormcode/php-domain-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download stormcode/php-domain-parser
More information about stormcode/php-domain-parser
Files in stormcode/php-domain-parser
Package php-domain-parser
Short Description Public Suffix List based URL parsing implemented in PHP.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package php-domain-parser
PHP Domain Parser
PHP Domain Parser is a Public Suffix List based domain parser implemented in PHP.
Motivation
While there are plenty of excellent URL parsers and builders available, there are very few projects that can accurately parse a url into its component subdomain, registerable domain, and public suffix parts.
Consider the domain www.pref.okinawa.jp. In this domain, the public suffix portion is okinawa.jp, the registerable domain is pref.okinawa.jp, and the subdomain is www. You can't regex that.
Other similar libraries focus primarily on URL building, parsing, and manipulation and additionally include public suffix domain parsing. PHP Domain Parser was built around accurate Public Suffix List based parsing from the very beginning, adding a URL object simply for the sake of completeness.
Installation
The only (currently) supported method of installation is via Composer.
Create a composer.json file in the root of your project:
And then run: composer install
Add the autoloader to your project:
You're now ready to begin using the PHP Domain Parser.
Usage
Parsing URLs
Parsing URLs into their component parts is as simple as the example you see below.
The above will output:
Convenience Methods
A magic __get() method is provided to access the above object properties. Obtaining the public suffix for a parsed domain is as simple as:
IDNA Support
IDN (Internationalized Domain Name)
support was added in version 1.4.0. Both unicode domains and their ASCII equivalents
are supported.
IMPORTANT: PHP's intl extension is required for the IDN functions.
Unicode
Parsing IDNA hosts is no different that parsing standard hosts. Setting $host = 'Яндекс.РФ'; (Russian-Cyrillic)
in the Parsing URLs example would return:
ASCII (Punycode)
If you choose to provide the ASCII equivalent of the unicode domain name
($host = 'http://xn--d1acpjx3f.xn--p1ai'; in the case of the Parsing URLs example),
the ASCII equivalent will be returned by the parser:
IPv6 Support
Parsing IPv6 hosts is no different that parsing standard hosts. Setting $host = 'http://[2001:db8:85a3:8d3:1319:8a2e:370:7348]:8080/';
in the Parsing URLs example would return:
IMPORTANT: IPv6 url host names must be enclosed in square brackets. They will not be parsed properly otherwise.
Hat tip to @geekwright for adding IPv6 support in a bugfix pull request.
Parsing Domains
If you'd like to parse the domain (or host) portion only, you can use
Parser::parseHost().
The above will output:
Retrieving Domain Components Only
If you're only interested in a domain component, you can use the parser to retrieve only the component you're interested in
The above will output:
Sanity Check
You can quickly parse a url from the command line with the provided parse
vendor binary. From the root of your project, simply call:
If you pass a url to parse, that url will be parsed and the output printed
to screen.
If you do not pass a url, http://user:[email protected]:8080/path/to/page.html?query=string#fragment will be parsed and the output printed to screen.
Example:
Example Script
For more information on using the PHP Domain Parser, please see the provided example script.
Refreshing the Public Suffix List
While a cached PHP copy of the Public Suffix List is provided for you in the
data directory, that copy may or may not be up to date (Mozilla provides an
Atom change feed
to keep up with changes to the list). Please use the provided vendor binary to
refresh your cached copy of the Public Suffix List.
From the root of your project, simply call:
You may verify the update by checking the timestamp on the files located in the
data directory.
Important: The vendor binary pdp-psl depends on an internet connection to
update the cached Public Suffix List.
Contributing
Pull requests are always welcome! Please review the CONTRIBUTING.md document before submitting pull requests.
Attribution
The HTTP adapter interface and the cURL HTTP adapter were inspired by (er, lifted from) Will Durand's excellent Geocoder project. His MIT license and copyright notice are below.
Portions of the PublicSuffixListManager and the DomainParser are derivative works of the PHP registered-domain-libs. Those parts of this codebase are heavily commented, and I've included a copy of the Apache Software Foundation License 2.0 in this project.
All versions of php-domain-parser with dependencies
ext-curl Version *
ext-intl Version *
ext-mbstring Version *