« Uri\Rfc3986\Uri::withFragment
Uri\Rfc3986\Uri::withPath »

Uri\Rfc3986\Uri::withHost

(PHP 8 >= 8.5.0)

Uri\Rfc3986\Uri::withHost — ホストコンポーネントを変更する

説明

public function Uri\Rfc3986\Uri::withHost(?string $host): static

新しい URI を作成し、そのホストコンポーネントを変更します。

パラメータ

host

新しいホストコンポーネント。

戻り値

変更された Uri\Rfc3986\Uri インスタンス。

エラー / 例外

結果の URI が不正な場合、Uri\InvalidUriException がスローされます。

例

例1 Uri\Rfc3986\Uri::withHost() の基本的な例

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

echo $uri->getHost();
?>

上の例の出力は以下となります。

example.net

参考

関連キーワード:
ホスト   コンポーネント   withHost   example   host   getHost   正規化   withFragment   withPath   static   インスタンス   不正   InvalidUriException   基本的   https   参考   getRawHost   WhatWg
関連する関数・ページ:
uri-whatwg-url.withhost   uri-rfc3986-uri.gethost   uri-rfc3986-uri.getrawhost   uri-whatwg-url.getasciihost   uri-whatwg-url.getunicodehost   uri-rfc3986-uri.getrawuserinfo