esperecyan/url

Makes the algorithms and APIs defined by URL Standard (replaces RFC 3986 and RFC 3987) available on PHP. / URL Standard (RFC 3986、RFC 3987 を置き換える Web 標準仕様) で定義されているアルゴリズム、および API を PHP から利用できるようにします。

v5.3.1 2023-02-15 04:51 UTC

Requires

• php: >=5.4.7
• ext-ctype: *
• ext-filter: *
• ext-iconv: *
• ext-json: *
• ext-pcre: *
• esperecyan/webidl: ^2.0.0
• symfony/polyfill-intl-idn: ^1.13.1
• symfony/polyfill-mbstring: ^1.3.0

Requires (Dev)

• ext-dom: *
• ext-spl: *
• apigen/apigen: @dev
• phpunit/phpunit: ^8.5.2

MPL-2.0

• 100の人

• url
• W3C
• RFC 3986
• Web Standards
• WHATWG
• URLSearchParams

README

English / 日本語

URL Standard

Makes the algorithms and APIs defined by URL Standard available on PHP.

Description

URL Standard is the Web standard specification that replaces the previous standards RFC 3986 and RFC 3987.

The specification defines URL interface and URLSearchPrams interface as API. This library allows you to use esperecyan\url\URL class as URL interface and esperecyan\url\URLSearchParams class as URLSearchPrams interface. The documents on MDN may be easy to understand by way of explanation of the interfaces https://developer.mozilla.org/docs/Web/API/URL https://developer.mozilla.org/docs/Web/API/URLSearchParams .

This library allows you to use the algorithms defined by URL Standard. For details, see The correspondence table of the algorithms.

Example

<?php
require_once 'vendor/autoload.php';

use esperecyan\url\URL;

$url = new URL('http://url.test/foobar?name=value');
var_dump($url->protocol, $url->pathname, $url->searchParams->get('name'));

The above example will output:

string(5) "http:"
string(7) "/foobar"
string(5) "value"

Requirement

• PHP 5.4, or 7.2 or later (PHP 5.4 and 7.2 are deprecated)
  • SPL Types PECL library is not supported

Install

composer require esperecyan/url

For help with installation of Composer, see Composer documentation.

Contribution

1. Fork it ( https://github.com/esperecyan/url )
2. Create your feature branch git checkout -b my-new-feature
3. Commit your changes git commit -am 'Add some feature'
4. Push to the branch git push origin my-new-feature
5. Create new Pull Request

Or

Create new Issue

If you find any mistakes of English in the README or Doc comments or any flaws in tests, please report by such as above means. I also welcome translations of README too.

Acknowledgement

I use the code from コードポイントから UTF-8 の文字を生成する - Qiita and UTF-8 の文字からコードポイントを求める - Qiita in implementing URLencoding class.

I use URL Standard (Japanese translation) as reference in creating this library.

HADAA helped me translate README to English.

Semantic Versioning

This library uses Semantic Versioning. The classes, methods, constants, and properties in the documentation of the library are the public API.

Licence

This library is licensed under the Mozilla Public License Version 2.0 (MPL-2.0).

The correspondence table of the algorithms