-
-
Notifications
You must be signed in to change notification settings - Fork 68
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #201 from GwendolenLynch/uri-string
[docs] Update Parsing, Building & Normalizing URIs
- Loading branch information
Showing
6 changed files
with
26 additions
and
85 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| version: '3' | ||
|
|
||
| services: | ||
| jekyll: | ||
| image: jekyll/jekyll:latest | ||
| command: jekyll serve --watch --force_polling --verbose | ||
| ports: | ||
| - 4000:4000 | ||
| volumes: | ||
| - .:/srv/jekyll |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,78 +1,3 @@ | ||
| --- | ||
| layout: homepage | ||
| --- | ||
|
|
||
| # Features | ||
|
|
||
| ## Parsing URI | ||
|
|
||
| The League URI Parser parses any given URI according to RFC3986 rules | ||
|
|
||
| ~~~php | ||
| <?php | ||
|
|
||
| use function League\Uri\parse; | ||
|
|
||
| var_export(parse('http://[email protected]/')); | ||
| //returns the following array | ||
| //array( | ||
| // 'scheme' => 'http', | ||
| // 'user' => null, | ||
| // 'pass' => null, | ||
| // 'host' => 'foo.com', | ||
| // 'port' => null, | ||
| // 'path' => '', | ||
| // 'query' => '@bar.com/', | ||
| // 'fragment' => null, | ||
| //); | ||
| ~~~ | ||
|
|
||
| ## Normalizing URI | ||
|
|
||
| League URI objects normalize the URI string according to RFC3986/RFC3987 non destructive rules. | ||
|
|
||
| ~~~php | ||
| <?php | ||
|
|
||
| use League\Uri\Http; | ||
| use function League\Uri\create; | ||
|
|
||
| echo create("hTTp://www.ExAmPLE.com:80/hello/./wor ld?who=f 3#title"); | ||
| //displays http://www.example.com/hello/./wor%20ld?who=f%203#title | ||
|
|
||
| echo Http::createFromComponent(parse_url("hTTp://www.bébé.be?#")); | ||
| //displays http://xn--bb-bjab.be?# | ||
| ~~~ | ||
|
|
||
| ## URI Middlewares | ||
|
|
||
| A collection of URI middlewares to enable reliable URI modifications with any given League URI object or [PSR-7](http://www.php-fig.org/psr/psr-7/) `UriInterface` compatible implementation. | ||
|
|
||
| ~~~php | ||
| <?php | ||
|
|
||
| use Zend\Diactoros\Uri as DiactorosUri; | ||
| use function League\Uri\merge_query; | ||
|
|
||
| $uri = new DiactorosUri("http://www.example.com?fo.o=toto#~typo"); | ||
| $new_uri = merge_query($uri, 'fo.o=bar&taz='); | ||
| echo $new_uri; | ||
| // display http://www.example.com?fo.o=bar&taz=#~typo | ||
| // $new_uri is a Zend\Diactoros\Uri instance | ||
| ~~~ | ||
|
|
||
| ## URI components | ||
|
|
||
| Improve URI components manipulations through dedicated objects. | ||
|
|
||
| ~~~php | ||
| <?php | ||
|
|
||
| use League\Uri\Components\Host; | ||
|
|
||
| $host = new Host('www.example.co.uk'); | ||
| echo $host->getPublicSuffix(); //display 'co.uk' | ||
| echo $host->getRegisterableDomain(); //display 'example.co.uk' | ||
| echo $host->getSubdomain(); //display 'www' | ||
| $host->isPublicSuffixValid(); //return a boolean 'true' in this example | ||
| ~~~ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -155,3 +155,5 @@ $uri = UriString::build($components); | |
|
|
||
| echo $uri; //displays http://hello:[email protected][email protected]/ | ||
| ~~~ | ||
|
|
||
| The `build` method provides similar functionality to the `http_build_url()` function from v1.x of the [`pecl_http`](https://pecl.php.net/package/pecl_http) PECL extension. | ||