Download the PHP package league/uri-query-parser without Composer

Uri Query Parser

THIS PACKAGE IS ON MAINTENANCE MODE SINCE 2019-10-18, FOR ANY NEW PROJECT PLEASE CONSIDER USING league/uri-components v2+

This package contains a userland PHP uri query parser and builder.

System Requirements

You need:

• PHP >= 7.1.3 but the latest stable version of PHP is recommended

Installation

Documentation

The parsing/building algorithms preserve pairs order and uses the same algorithm used by JavaScript UrlSearchParams

Parsing the URI query string

Parsing a query string is easy.

Description

The returned array is a collection of key/value pairs. Each pair is represented as an array where the first element is the pair key and the second element the pair value. While the pair key is always a string, the pair value can be a string or the null value.

The League\Uri\QueryString::parse parameters are

• $query can be the null value, any scalar or object which is stringable;
• $separator is a string; by default it is the & character;
• $enc_type is one of PHP's constant PHP_QUERY_RFC3968 or PHP_QUERY_RFC1738 which represented the supported encoding algoritm
  • If you specify PHP_QUERY_RFC3968 decoding will be done using RFC3986 rules;
  • If you specify PHP_QUERY_RFC1738 decoding will be done using application/x-www-form-urlencoded rules;

Here's a simple example showing how to use all the given parameters:

Building the URI query string

To convert back the collection of key/value pairs into a valid query string or the null value you can use the QueryString::build function.

Description

The QueryString::build :

• accepts any iterable structure containing a collection of key/pair pairs as describe in the returned array of the QueryString::parse` function.

Just like with QueryString::parse, you can specify the separator and the encoding algorithm to use.

• the function returns the null value if an empty array or collection is given as input.

Extracting PHP variables

QueryString::parse and QueryString::build preserve the query string pairs content and order. If you want to extract PHP variables from the query string à la parse_str you can use:

• The QueryString::extract method which takes the same parameters as League\Uri\QueryString::parse
• The QueryString::convert method which takes the result of League\Uri\QueryString::parse

both methods, however, do not allow parameters key mangling in the returned array like parse_str;

Exceptions

All exceptions extends the League\Uri\Parser\InvalidUriComponent marker class which extends PHP's InvalidArgumentException class.

• If the query string is invalid a League\Uri\Exception\MalformedUriComponent exception is thrown.
• If the query pair is invalid a League\Uri\Parser\InvalidQueryPair exception is thrown.
• If the encoding algorithm is unknown or invalid a League\Uri\Parser\UnknownEncoding exception is thrown.

Contributing

Contributions are welcome and will be fully credited. Please see CONDUCT for details.

Testing

The library has a 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.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• ignace nyamagana butera
• All Contributors

License

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