thephpleague/uri

Health v2 · maintenance only

Adoption not part of the score

1134 stars · 70 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A PHP library for parsing, validating, formatting, and manipulating URIs according to RFC 3986, RFC 3987, RFC 6570 (URI Templates), and RFC 8141 (URN), with WHATWG URL alignment and PSR-7/PSR-17 adapters. It provides immutable URI and URI-component objects, query string handling, IDN and IPv4/IPv6 host conversion, and modern replacements for PHP's legacy parse_url-style functions.

Use cases

• parse and manipulate urls in php
• validate uris against rfc 3986
• expand uri templates with rfc 6570
• resolve relative urls against a base uri
• normalize or relativize links
• handle internationalized domain names in urls
• replace php's unreliable parse_url with a standards-based parser
• get a psr-7 compatible uri object for http messages

When to choose

• you are writing PHP 8.1+ code that needs standards-compliant URI parsing, validation, or rewriting
• you need PSR-7/PSR-17 URI integration for HTTP clients or frameworks
• you must support IDN hosts, IPv4/IPv6 conversion, URN (RFC 8141), or URI template expansion
• you want immutable, object-oriented URL handling instead of PHP's legacy parse_url/string functions

When to avoid

• your project is not in PHP or runs on PHP below 8.1
• you only need a full HTTP client or web crawler rather than URI manipulation itself
• you need a general-purpose data serialization or templating tool rather than URL handling

Facets

library · maturity active

parser web-development parsers apis php uri url url-parsing rfc-3986 rfc-3987 rfc-6570 rfc-8141 uri-template psr-7 psr-17 whatwg-url idn ipv6 urn

Member repositories

For agents

markdown · JSON · MCP: product_card(name="thephpleague/uri")