ホストコンポーネントを変更する

# Uri\WhatWg\Url::withHost

(PHP 8 >= 8.5.0)

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

### 説明

public function Uri\WhatWg\Url::withHost(?string `$host`): static

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

### パラメータ

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

### 戻り値

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

### エラー / 例外

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

### 例

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

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

    echo $url->getAsciiHost();
    ?>

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

    example.net

### 参考

- Uri\WhatWg\Url::getAsciiHost() - ホストコンポーネントを ASCII string として取得する
- Uri\WhatWg\Url::getUnicodeHost() - ホストコンポーネントを Unicode string として取得する
- Uri\Rfc3986\Uri::withHost() - ホストコンポーネントを変更する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open