league/uri-components

URI components manipulation library

7.5.1 2024-12-08 08:40 UTC

Requires

• php: ^8.1
• league/uri: ^7.5

Suggests

• php-64bit: to improve IPV4 host parsing
• ext-bcmath: to improve IPV4 host parsing
• 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-mbstring: to use the sorting algorithm of URLSearchParams
• jeremykendall/php-domain-parser: to resolve Public Suffix and Top Level Domain
• symfony/polyfill-intl-idn: to handle IDN host via the Symfony polyfill if ext-intl is not present

MIT

• Ignace Nyamagana Butera

• path
• url
• components
• query
• middleware
• uri
• modifier
• host
• port
• fragment
• authority
• rfc3986
• scheme
• userinfo

README

This package contains concrete URI components instances represented as immutable value objects.

⚠️ 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.

Dependencies

• League URI
• League URI Interfaces
• PSR-7

Installation

$ composer require league/uri-components

Documentation

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

License

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