Domain::PublicSuffix - Parse a domain down to root
use Domain::PublicSuffix; my $suffix = new Domain::PublicSuffix ({ 'data_file' => '/tmp/effective_tld_names.dat' }); my $root = $suffix->get_root_domain('www.google.com'); # $root now contains "google.com" $root = $suffix->get_root_domain('www.google.co.uk'); # $root now contains google.co.uk
This module utilizes the "effective_tld_names.dat" provided by Mozilla as a way to effectively reduce a fully qualified domain name down to the absolute root. The Mozilla PublicSuffix file is an open source, fully documented format that shows absolute root TLDs, primarily for Mozilla's browser products to be able to determine how far a cookie's security boundaries go.
This module will attempt to search etc directories in /usr, /usr/local, and /opt/local for the effective_tld_names.dat file. If a file is not found, a default file is loaded from Domain::PublicSuffix::Default, which is current at the time of the module's release. You can override the data file path by giving the new() method a 'data_file' argument.
When creating a new PublicSuffix object, the module will load the data file as specified, and use the internal structure to parse each domain sent to the get_root_domain method. To re-parse the file, you must destroy and create a new object, or execute the _parse_data_file method directly, though that is not recommended.
On unsuccessful parse, contains a human-readable error string.
Returns the effective tld of the last parsed domain. For the domain 'google.co.uk', this would return 'co.uk'.
Returns the true DNS tld of the last parsed domain. For the domain 'google.co.uk', this would return 'uk'.
Instantiate a PublicSuffix object. It is best to instantiate an object and continue calling get_root_domain instead of continually recreating the object, as the data file is read and parsed on instantiation.
Can take a data_file argument inside of a hashref, as a fully qualified path, to override the effective_tld_names.dat file.
Given a fully qualified domain name, return the parsed root domain name. Returns undefined if an error occurs parsing the given domain, and fills the error accessor with a human-readable error string.
For version 0.04, Domain::PublicSuffix went through some code normalization, causing most methods to undergo a name change. The following methods are provided to maintain compatibility with older version, but new scripts and applications should not use these methods.
Current List:
http://tinyurl.com/4tgwb9 [mxr.mozilla.org]
Mozilla Documentation:
http://wiki.mozilla.org/Gecko:TLD_Service
Public Info Site:
http://publicsuffix.org/
Please report any bugs or feature requests to bug-domain-publicsuffix at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Domain-PublicSuffix. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-domain-publicsuffix at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc Domain::PublicSuffix
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Domain-PublicSuffix
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Domain-PublicSuffix
CPAN Ratings
http://cpanratings.perl.org/d/Domain-PublicSuffix
Search CPAN
http://search.cpan.org/dist/Domain-PublicSuffix
Copyright 2008 Nicholas Melnick, nick at abstractwankery.com.
nick at abstractwankery.com
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Domain::PublicSuffix, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Domain::PublicSuffix
CPAN shell
perl -MCPAN -e shell install Domain::PublicSuffix
For more information on module installation, please visit the detailed CPAN module installation guide.