PHP Manual
Uri\Rfc3986\Uri
スキームコンポーネントを変更する

Uri\Rfc3986\Uri::withScheme

(PHP 8 >= 8.5.0)

Uri\Rfc3986\Uri::withScheme — スキームコンポーネントを変更する

説明

public function Uri\Rfc3986\Uri::withScheme(?string $scheme): static

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

パラメータ

scheme: 新しいスキームコンポーネント。

戻り値

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

エラー / 例外

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

例

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

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

echo $uri->getScheme();
?>

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

http

参考

Uri\Rfc3986\Uri::getRawScheme() - 正規化されていないスキームコンポーネントを取得する
Uri\Rfc3986\Uri::getScheme() - 正規化されたスキームコンポーネントを取得する
Uri\WhatWg\Url::withScheme() - スキームコンポーネントを変更する

関連キーワード:

スキームコンポーネント withScheme scheme http getScheme 正規化 withQuery withUserInfo static インスタンス不正 InvalidUriException 基本的 https example 参考 getRawScheme WhatWg

関連する関数・ページ:

uri-whatwg-url.withscheme uri-rfc3986-uri.getscheme uri-rfc3986-uri.getrawscheme uri-whatwg-url.getscheme uri-rfc3986-uri.withuserinfo uri-rfc3986-uri.getrawuserinfo