Object oriented adaptation of Florian Sager's regdom library for querying Mozilla's Public Suffix List, complete with unit testing.
For more information of public suffixes, and why you may want to query the list, please see publicsuffix.org
composer require geekwright/regdom
This class handles all direct interaction with the public suffix list (PSL.) This includes, fetching the list from a source URL, caching that list locally, converting that list to a tree form to facilitate rapid lookup, and caching that tree in a serialized form.
Creates a new PublicSuffixList object that will use the specified URL as the source of the PSL. If no $url is specified, it will default to https://publicsuffix.org/list/public_suffix_list.dat
Resets the current PSL, and uses the specified URL as the source.
Returns the tree of the current PSL. Geekwright\RegDom\RegisteredDomain
uses this tree form for all lookups.
By default, this will clear all cached PSL data, including local copies
of remotely accessed PSL data. Pass true for $cacheOnly
to clear only
the serialized tree data.
This class can be used to determine the registrable domain portion of a URL, respecting the public suffix list conventions.
Creates a new RegisteredDomain object that will use $psl to access the PSL. If no $psl is specified, a new PublicSuffixList object will be instantiated using default behaviors.
Returns the shortest registrable domain portion of the supplied $host, or null if the host could not be validly registered.
Examples:
echo $regdom->getRegisteredDomain('https://www.google.com/');
Outputs:
google.com
echo $regdom->getRegisteredDomain('theregister.co.uk');
Outputs:
theregister.co.uk
echo null === $regdom->getRegisteredDomain('co.uk');
Outputs:
1
This script can be used to load a fresh copy of the PSL. It may be useful in cron job, or other scripted updates.
Reg-dom was written by Florian Sager, 2009-02-05, sager@agitos.de
Original code was published at http://www.dkim-reputation.org/regdom-lib-downloads/
Marcus Bointon's adapted code is here http://github.com/Synchro
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to you under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at:
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.