league/uri

URI manipulation library

7.8.0 2026-01-14 17:24 UTC

Requires

• php: ^8.1
• league/uri-interfaces: ^7.8
• psr/http-factory: ^1

Suggests

• php-64bit: to improve IPV4 host parsing
• ext-bcmath: to improve IPV4 host parsing
• ext-dom: to convert the URI into an HTML anchor tag
• ext-fileinfo: to create Data URI from file contennts
• ext-gmp: to improve IPV4 host parsing
• ext-intl: to handle IDN host with the best performance
• ext-uri: to use the PHP native URI class
• jeremykendall/php-domain-parser: to further parse the URI host and resolve its Public Suffix and Top Level Domain
• league/uri-components: to provide additional tools to manipulate URI objects components
• league/uri-polyfill: to backport the PHP URI extension for older versions of PHP
• rowbot/url: to handle URLs using the WHATWG URL Living Standard specification
• symfony/polyfill-intl-idn: to handle IDN host via the Symfony polyfill if ext-intl is not present

Conflicts

• league/uri-schemes: ^1.0

MIT

• Ignace Nyamagana Butera

• http
• url
• https
• middleware
• uri
• ftp
• URN
• hostname
• data-uri
• ws
• rfc3986
• parse_url
• rfc6570
• querystring
• psr-7
• uri-template
• query-string
• rfc3987
• parse_str
• file-uri
• rfc8141
• rfc2141

README

The Uri package provides simple and intuitive classes to manage URIs in PHP.

⚠️ this is a sub-split, for development, pull requests and issues, visit: https://github.com/thephpleague/uri-src

System Requirements

You require PHP >= 8.1 but the latest stable version of PHP is recommended

Handling of an IDN host requires the presence of the intl extension or a polyfill for the intl IDN functions like the symfony/polyfill-intl-idn otherwise an exception will be thrown when attempting to validate or interact with such a host.

IPv4 conversion requires at least one of the following:

• the GMP extension,
• the BCMatch extension or
• a 64-bits PHP version

otherwise, an exception will be thrown when attempting to convert a host as an IPv4 address.

Parsing or generating HTML related content requires the dom extension.

Dependencies

• League URI Interfaces
• PSR-7

Installation

$ composer require league/uri

Documentation

Full documentation can be found at uri.thephpleague.com.

License

The MIT License (MIT). Please see License File for more information.