league / uri-components
URI components manipulation library
Fund package maintenance!
nyamsprod
Installs: 4 782 475
Dependents: 26
Suggesters: 2
Security: 0
Stars: 245
Watchers: 3
Forks: 5
Open Issues: 0
Requires
- php: ^7.3 || ^8.0
- ext-json: *
- league/uri-interfaces: ^2.1
- psr/http-message: ^1.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.18
- guzzlehttp/psr7: ^1.4.2
- laminas/laminas-diactoros: ^2.0
- league/uri: ^6.0
- phpstan/phpstan: ^0.12
- phpstan/phpstan-phpunit: ^0.12
- phpstan/phpstan-strict-rules: ^0.12
- phpunit/phpunit: ^9.0
Suggests
- php-64bit: to improve handle IPV4 parsing
- ext-fileinfo: Needed to create Data URI from a filepath
- ext-gmp: to improve handle IPV4 parsing
- ext-intl: to handle IDN host
- jeremykendall/php-domain-parser: Public Suffix and Top Level Domain parsing implemented in PHP
- league/uri: to allow manipulating URI objects
- psr/http-message-implementation: to allow manipulating PSR-7 Uri objects
README
This package contains concrete URI components instances represented as immutable value objects.
System Requirements
You need PHP >= 7.3 but the latest stable version of PHP is recommended.
Dependencies
In order to handle IDN host you should also require the intl extension otherwise an exception will be thrown when attempting to validate such host.
Installation
$ composer require league/uri-components
Documentation
Full documentation can be found at uri.thephpleague.com.
Contributing
Contributions are welcome and will be fully credited. Please see CONTRIBUTING and CONDUCT for details.
Testing
The library has a :
- a PHPUnit test suite
- a coding style compliance test suite using PHP CS Fixer.
- a code analysis compliance test suite using PHPStan.
To run the tests, run the following command from the project folder.
$ composer test
Security
If you discover any security related issues, please email nyamsprod@gmail.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.