PHPackages                             decodelabs/singularity - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. decodelabs/singularity

ActiveLibrary[Parsing & Serialization](/categories/parsing)

decodelabs/singularity
======================

Consolidated URI parsing and resolving

v0.4.2(7mo ago)12.8k2MITPHPPHP ^8.4CI passing

Since Oct 29Pushed 5mo ago2 watchersCompare

[ Source](https://github.com/decodelabs/singularity)[ Packagist](https://packagist.org/packages/decodelabs/singularity)[ RSS](/packages/decodelabs-singularity/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (22)Used By (2)

Singularity
===========

[](#singularity)

[![PHP from Packagist](https://camo.githubusercontent.com/73fe3f319cec763c7f001312deb40ec0124e8378744d89e1791bdec2dc7a4b5c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6465636f64656c6162732f73696e67756c61726974793f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/singularity)[![Latest Version](https://camo.githubusercontent.com/ef46c7a6591da0acec0e83d4e633ad7b9e5dadaad7949019c789764941d385d4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6465636f64656c6162732f73696e67756c61726974792e7376673f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/singularity)[![Total Downloads](https://camo.githubusercontent.com/d407a0b367930c4da831413c77973e02be69b3fd4c0c13cf26868d611ba833ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6465636f64656c6162732f73696e67756c61726974792e7376673f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/singularity)[![GitHub Workflow Status](https://camo.githubusercontent.com/688cb979fd2751b683192d7ea51225c9399643eb941d6fb30bca16db43a01f84/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6465636f64656c6162732f73696e67756c61726974792f696e746567726174652e796d6c3f6272616e63683d646576656c6f70)](https://github.com/decodelabs/singularity/actions/workflows/integrate.yml)[![PHPStan](https://camo.githubusercontent.com/e25c14ce011edabdd0fbd2e10415b41cc5d66ed11ef3e5b7edd074c5bdd35a2d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d656e61626c65642d3434434331312e7376673f6c6f6e6743616368653d74727565267374796c653d666c6174)](https://github.com/phpstan/phpstan)[![License](https://camo.githubusercontent.com/c77e0c78ab033adc53e4830ac9a4a8da720c8a65c28fd286000ff192571d3191/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6465636f64656c6162732f73696e67756c61726974793f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/singularity)

### Consolidated URI parsing and resolving

[](#consolidated-uri-parsing-and-resolving)

Singularity provides a unified interface for parsing and resolving URIs, PSR-7 URLs and file paths.

---

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

[](#installation)

This package requires PHP 8.4 or higher.

Install via Composer:

```
composer require decodelabs/singularity
```

Usage
-----

[](#usage)

Parse and normalize URIs:

```
use DecodeLabs\Singularity;

dd(
    // ::uri() will parse any valid URI
    Singularity::uri('mailto:info@example.com'),

    // ::url() will parse any valid URL
    Singularity::url('http://user:pass@www.example.com:8080/resource/page.html?param1=value1&param2=value2#section1'),
    Singularity::url('ftp://ftp.example.com/files/document.pdf'),
    Singularity::url('mailto:user@example.com?subject=Hello&body=Hi%20there')->getEmailAddress(),
    Singularity::url('tel:+1-816-555-1212'),

    // ::urn() will parse any valid URN
    Singularity::urn('urn:isbn:0-486-27557-4'),
    Singularity::urn('urn:ietf:rfc:3986')->getNamespace(), // ietf
    Singularity::urn('urn:oid:2.16.840')->getIdentifier(), // 2.16.840
);
```

Parse query strings to `Tree`:

```
use DecodeLabs\Singularity;

$url = Singularity::uri('http://www.example.com?param1=value1&param2=value2');
$tree = $url->parseQuery();
echo $tree->param2->as('string'); // value2

// Update query
$newUrl = $url->withQuery(function($tree, $url) {
    $tree->param2 = 'newValue2';
    $tree->param3 = 'value3';
    return $tree;
});
```

Parse and normalize file paths:

```
use DecodeLabs\Singularity;

dd(
    // ::path() will parse any valid file path
    Singularity::path('/path/to/file.txt'),
    Singularity::path('C:\path\to\file.txt'),
    Singularity::path('file:///path/to/file.txt'),
    Singularity::path('file://C:/path/to/file.txt'),

    // ::canonicalPath() will parse any valid file path and normalize it
    Singularity::canonicalPath('/path/to/inner/./directory/../../file.txt'), // /path/to/file.txt
);

$url = Singularity::uri('http://www.example.com?param1=value1&param2=value2');
$url->withPath(function($path) {
    $path->setFileName('file.txt');
    return $path;
});
```

Licensing
---------

[](#licensing)

Singularity is licensed under the proprietary License. See [LICENSE](./LICENSE) for the full license text.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance67

Regular maintenance activity

Popularity19

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~37 days

Recently: every ~29 days

Total

20

Last Release

227d ago

PHP version history (3 changes)v0.1.0PHP ^8.0

v0.2.6PHP ^8.1

v0.3.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a241d64d12b3b5ee94197862ec1ec30b82ed2efa34a0cd7f4c3565a021daddd?d=identicon)[betterthanclay](/maintainers/betterthanclay)

---

Top Contributors

[![betterthanclay](https://avatars.githubusercontent.com/u/1273586?v=4)](https://github.com/betterthanclay "betterthanclay (93 commits)")

---

Tags

phpuriurl

### Embed Badge

![Health badge](/badges/decodelabs-singularity/health.svg)

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

###  Alternatives

[neos/flow

Flow Application Framework

862.0M451](/packages/neos-flow)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28137.8k](/packages/phpro-http-tools)[neos/flow-development-collection

Flow packages in a joined repository for pull requests.

144179.3k3](/packages/neos-flow-development-collection)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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