aAbsoluteUri

class AeonDigital\Http\Uri\Abstracts\aAbsoluteUri

Implementa a interface iAbsoluteUri.

Parent:AeonDigital\Http\Uri\Abstracts\aHierPartUri Implements:AeonDigital\Interfaces\Http\Uri\iAbsoluteUri

Properties

Methods

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::getQuery()

Retorna o componente query da URI ou '' caso ele não esteja especificado.

O caracter ? não faz parte do componente query.

Os valores definidos serão retornados usando percent-encoding.

See:https://tools.ietf.org/html/rfc3986#section-3.4 Returns:‹ string ›

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::withQuery($query)

Este método DEVE manter o estado da instância atual e retornar uma nova instância

contendo o query especificado.

Parameters:

• ‹ string › $query
  O novo valor para query na nova instância.

Returns:

‹ static ›

Throws:

‹ InvalidArgumentException ›
Caso seja definido um valor inválido para query.

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::getFragment()

Retorna o componente fragment da URI ou '' caso ele não esteja especificado.

O caracter # não faz parte do componente fragment.

Os valores definidos serão retornados usando percent-encoding.

See:https://tools.ietf.org/html/rfc3986#section-3.4 Returns:‹ string ›

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::withFragment($fragment)

Este método DEVE manter o estado da instância atual e retornar uma nova instância

contendo o fragment especificado.

Parameters:

• ‹ string › $fragment
  O novo valor para fragment na nova instância.

Returns:

‹ static ›

Throws:

‹ InvalidArgumentException ›
Caso seja definido um valor inválido para fragment.

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::withRelativeUri($path="", $query="", $fragment="")

Este método DEVE manter o estado da instância atual e retornar uma nova instância

contendo a parte relative-uri especificado.

Parameters:

• ‹ string › $path
  O novo valor para path na nova instância.
• ‹ string › $query
  O novo valor para query na nova instância.
• ‹ string › $fragment
  O novo valor para fragment na nova instância.

Returns:

‹ static ›

Throws:

‹ InvalidArgumentException ›
Caso seja definido um valor inválido para algum argumento.

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::__construct($scheme="", $user="", $password=null, $host="", $port=null, $path="", $query="", $fragment="")

Inicia uma instância absoluteUri de uma URI.

Parameters:

• ‹ string › $scheme
  Define o scheme usado pelo URI.
• ‹ string › $user
  Define o user usado pelo URI.
• ‹ ?string › $password
  Define o password usado pelo URI. Se null for passado, o valor da password não será removido.
• ‹ string › $host
  Define o host usado pelo URI.
• ‹ ?int › $port
  Define a port usado pelo URI. Use null para usar o valor padrão para do scheme.
• ‹ string › $path
  Define o path usado pelo URI.
• ‹ string › $query
  Define o query usado pelo URI.
• ‹ string › $fragment
  Define o fragment usado pelo URI.

Throws:

‹ InvalidArgumentException ›
Caso algum dos parametros passados seja inválido.

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::getAbsoluteUri($withFragment=false)

Retorna uma string que representa toda a uri representada pela atual instância.

O resultado será uma string com o seguinte formato:

```

[ scheme ":" ][ "//" authority ][ "/" path ][ "?" query ][ "#" fragment ]

```

Parameters:

• ‹ bool › $withFragment
  Quando true irá adicionar o componente fragment. Se false irá omitir totalmente este componente.

Returns:

‹ string ›

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::getRelativeUri($withFragment=false)

Retorna uma string que representa toda a parte relativa da URI atualmente representada

pela instância.

O resultado será uma string com o seguinte formato:

```

[ "/" path ][ "?" query ][ "#" fragment ]

```

Parameters:

• ‹ bool › $withFragment
  Quando true irá adicionar o componente fragment. Se false irá omitir totalmente este componente.

Returns:

‹ string ›

public static AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::fromString($uri)

Retorna uma nova instância definida a partir do valor indicado na string $uri.

Parameters:

• ‹ string › $uri
  URI que será usada de base para a nova instância.

Returns:

‹ static ›

Throws:

‹ InvalidArgumentException ›
Exception lançada caso a URI indicada seja inválida.

public AeonDigital\Http\Uri\Abstracts\aAbsoluteUri::__toString()

Converte os atributos que formam a URI em uma string válida para seu respectivo scheme.

Returns:‹ string ›