Download the PHP package joomla/uri without Composer
On this page you can find all versions of the php package joomla/uri. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package uri
Short Description Joomla Uri Package
License GPL-2.0-or-later
Homepage https://github.com/joomla-framework/uri
Informations about the package uri
The Uri Package
Introduction
The Joomla 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 UriHelper
class.
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 programmatically using the methods provided in the Uri
class.
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:
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:
Which will output myUser:myPass@http://localhost:8888path/to/file.php
Adding a URL query:
Output:
myUser:myPass@http://localhost:8888path/to/file.php?foo=bar
Installation via Composer
Add "joomla/uri": "~3.0"
to the require block in your composer.json and then run composer install
.
Alternatively, you can simply run the following from the command line: