PHPackages                             xoops/regdom - 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. xoops/regdom

ActiveLibrary[Utility & Helpers](/categories/utility)

xoops/regdom
============

A robust domain parser for PHP, using the Mozilla Public Suffix List to determine the registrable domain and validate cookie domains per RFC 6265.

v2.0.1(1y ago)06.8k↓91.7%12Apache-2.0PHPPHP >=7.4.0CI failing

Since Jul 8Pushed 1mo agoCompare

[ Source](https://github.com/XOOPS/RegDom)[ Packagist](https://packagist.org/packages/xoops/regdom)[ Docs](https://github.com/XOOPS/RegDom)[ RSS](/packages/xoops-regdom/feed)WikiDiscussions master Synced yesterday

READMEChangelog (8)Dependencies (2)Versions (8)Used By (2)

[![alt XOOPS CMS](https://camo.githubusercontent.com/afcc8bbe53ee000d859b25f55229b090203cf7ef7e8f8a6ff1c0222dce8bce9e/68747470733a2f2f786f6f70732e6f72672f696d616765732f6c6f676f586f6f7073344769746875625265706f7369746f72792e706e67)](https://camo.githubusercontent.com/afcc8bbe53ee000d859b25f55229b090203cf7ef7e8f8a6ff1c0222dce8bce9e/68747470733a2f2f786f6f70732e6f72672f696d616765732f6c6f676f586f6f7073344769746875625265706f7369746f72792e706e67)

RegDom - Registered Domain Check in PHP
=======================================

[](#regdom---registered-domain-check-in-php)

Object oriented PHP library for querying Mozilla's Public Suffix List to determine the registrable domain portion of URLs and validate cookie domains per RFC 6265. Adapted from Florian Sager's regdom library.

For more information on public suffixes, see [publicsuffix.org](https://publicsuffix.org/).

Requirements
------------

[](#requirements)

- PHP 8.2 or later
- `ext-mbstring` required
- `ext-intl` recommended (for internationalized domain name support)

Installation
------------

[](#installation)

```
composer require xoops/regdom
```

Usage
-----

[](#usage)

### Extracting the Registered Domain

[](#extracting-the-registered-domain)

```
use Xoops\RegDom\RegisteredDomain;

$regdom = new RegisteredDomain();

echo $regdom->getRegisteredDomain('https://www.google.com/');
// Output: google.com

echo $regdom->getRegisteredDomain('theregister.co.uk');
// Output: theregister.co.uk

var_dump($regdom->getRegisteredDomain('co.uk'));
// Output: NULL (co.uk is a public suffix, not a registrable domain)

// IDN support (requires ext-intl)
echo $regdom->getRegisteredDomain('www.münchen.de');
// Output: münchen.de
```

### Cookie Domain Validation (RFC 6265)

[](#cookie-domain-validation-rfc-6265)

```
use Xoops\RegDom\RegisteredDomain;

// Validates if a cookie domain is appropriate for a given host
RegisteredDomain::domainMatches('www.example.com', 'example.com');  // true
RegisteredDomain::domainMatches('example.com', 'com');              // false (public suffix)
RegisteredDomain::domainMatches('google.com', 'facebook.com');      // false (cross-domain)
RegisteredDomain::domainMatches('192.168.1.1', '192.168.1.1');      // false (IP addresses)
```

### Querying the Public Suffix List

[](#querying-the-public-suffix-list)

```
use Xoops\RegDom\PublicSuffixList;

$psl = new PublicSuffixList();

$psl->isPublicSuffix('com');        // true
$psl->isPublicSuffix('co.uk');      // true
$psl->isPublicSuffix('example.com'); // false

$psl->getPublicSuffix('www.example.co.uk'); // 'co.uk'

$psl->isException('www.ck'); // true (PSL exception rule)
```

### Checking PSL Cache Status

[](#checking-psl-cache-status)

```
$metadata = $psl->getMetadata();
// Returns: active_cache, last_updated, days_old, rule_counts, needs_update
```

### Updating the Public Suffix List

[](#updating-the-public-suffix-list)

```
composer run update-psl
```

Set the `XOOPS_SKIP_PSL_UPDATE` environment variable to skip automatic PSL updates during `composer install`/`update` (useful in CI or restricted networks).

Configuration
-------------

[](#configuration)

### XOOPS\_COOKIE\_DOMAIN\_USE\_PSL

[](#xoops_cookie_domain_use_psl)

When defined and set to `false`, disables PSL-based validation in `RegisteredDomain::domainMatches()`. Defaults to `true` when undefined.

### XOOPS\_SKIP\_PSL\_UPDATE

[](#xoops_skip_psl_update)

Environment variable. When set (to any value), prevents automatic PSL download during Composer post-install/update hooks.

Development
-----------

[](#development)

```
composer install          # Install dependencies
composer ci               # Run all checks: lint + analyse + test
composer test             # Run PHPUnit tests
composer lint             # Check code style (PSR-12)
composer analyse          # Run PHPStan (level max)
composer fix              # Auto-fix code style issues
```

Credits
-------

[](#credits)

Reg-dom was written by Florian Sager, 2009-02-05,

Marcus Bointon's adapted code:

License
-------

[](#license)

The PHP library code in this repository is licensed under the Apache License 2.0. See [LICENSE.txt](LICENSE.txt) for the full Apache 2.0 license text.

The bundled Public Suffix List data/cache is derived from Mozilla's Public Suffix List and is available under the Mozilla Public License 2.0 (MPL-2.0). For details, see  and .

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance66

Regular maintenance activity

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.4% of commits — single point of failure

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 ~99 days

Recently: every ~113 days

Total

7

Last Release

130d ago

PHP version history (3 changes)v2.0.0-AlphaPHP >=7.4.0

v2.0.2-beta2PHP ^7.4 || ^8.0

v2.1.0-beta1PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/7eb0c56896d2405e44608ffb77c1411e4a18927be440b28275f7e0cb075ea9d6?d=identicon)[geekwright](/maintainers/geekwright)

---

Top Contributors

[![mambax7](https://avatars.githubusercontent.com/u/613686?v=4)](https://github.com/mambax7 "mambax7 (87 commits)")[![geekwright](https://avatars.githubusercontent.com/u/3181636?v=4)](https://github.com/geekwright "geekwright (40 commits)")[![Synchro](https://avatars.githubusercontent.com/u/81561?v=4)](https://github.com/Synchro "Synchro (4 commits)")

---

Tags

publictldsuffixregdom

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/xoops-regdom/health.svg)

```
[![Health](https://phpackages.com/badges/xoops-regdom/health.svg)](https://phpackages.com/packages/xoops-regdom)
```

###  Alternatives

[symfony/dom-crawler

Eases DOM navigation for HTML and XML documents

4.1k399.9M2.6k](/packages/symfony-dom-crawler)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.2k](/packages/friendsofphp-php-cs-fixer)[symfony/filesystem

Provides basic utilities for the filesystem

4.6k710.3M4.0k](/packages/symfony-filesystem)[symfony/console

Eases the creation of beautiful and testable command line interfaces

9.8k1.1B13.9k](/packages/symfony-console)[symfony/symfony

The Symfony PHP framework

31.4k87.2M2.2k](/packages/symfony-symfony)[symfony/http-foundation

Defines an object-oriented layer for the HTTP specification

8.7k928.6M6.5k](/packages/symfony-http-foundation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)