Windwalker Uri package

Installs: 47 643

Dependents: 4

Suggesters: 0

Stars: 0

Watchers: 3

Forks: 0

Open Issues: 0

Type:windwalker-package

3.4.9 2018-12-02 04:59 UTC

README

Windwalker Uri package is a Joomla Framework fork now, to support our Application package.

Introduction

The Windwalker Framework includes a Uri package that allows for manipulating pieces of the Uri string with a number of useful methods to set and get values while dealing with the uri.

The classes that are included with the Uri package are Uri, which extends the UriAbstract class, an implementation of the UriInterface. Another class is the UriHelperclass.

The Uri class is a mutable object which you'd use to manipulate an Uri.

To pass along an uri as value use UriImmutable, this object guarantees that the code you pass the object into can't manipulate it and, causing bugs in your code.

If only read access is required it's recommended to type hint against the UriInterface. This way either an Uri or an UriImmutable object can be passed.

The UriHelper class only contains one method parse_url() that's an UTF-8 safe replacement for PHP's parse_url().

You can use the Uri class a number of different ways when dealing with Uris. It is very easy to construct a uri programatically using the methods provided in the Uri class.

Installation via Composer

{
	"require": {
		"windwalker/uri": "~3.0"
	}
}

Usage

The methods provided in the Uri class allow you to manipulate all aspects of a uri. For example, suppose you wanted to set a new uri, add in a port, and then also post a username and password to authenticate a .htaccess security file. You could use the following syntax:

// new uri object
$uri = new Windwalker\Uri\Uri;

$uri->setHost('http://localhost');
$uri->setPort('8888');
$uri->setUser('myUser');
$uri->setPass('myPass');

echo $uri->__toString();

This will output:

myUser:myPass@http://localhost:8888

If you wanted to add a specific filepath after the host you could use the setPath() method:

// set path
$uri->setPath('path/to/file.php');

Which will output

myUser:myPass@http://localhost:8888path/to/file.php

Adding a URL query:

// url query
$uri->setQuery('foo=bar');

Output:

myUser:myPass@http://localhost:8888path/to/file.php?foo=bar

PsrUri

PsrUri is a Uri object implemented the Psr UriInterface.

This object is also immutable, so we must get return value as new object every change.

$uri = (new PsrUri('http://example.com'))
    ->withScheme('https')
    ->withUserInfo('user', 'pass')
    ->withPath('/path/to/target')
    ->withQuery('flower=sakura')
    ->withFragment('#hash');

(string) $uri; // https://user:pass@example.com/path/to/target?flower=sakura#fragment