Uri\Rfc3986\Uri::withHost

Modify the host component

Description

public static Uri\Rfc3986\Uri::withHost(stringnull $host)

Creates a new URI and modifies its host component.

Parameters

host
New host component.

Return Values

The modified Uri\Rfc3986\Uri instance.

Errors/Exceptions

If the resulting URI is invalid, a Uri\InvalidUriException is thrown.

Examples

Example #1 Uri\Rfc3986\Uri::withHost basic example

<?php
$uri = new \Uri\Rfc3986\Uri("https://example.com");
$uri = $uri->withHost("example.net");

echo $uri->getHost();
?>

The above example will output:

example.net

See Also

  • Uri\Rfc3986\Uri::getHost
  • Uri\Rfc3986\Uri::getRawHost
  • Uri\WhatWg\Url::withHost