Uri\WhatWg\Url::parse

(PHP 8 >= 8.5.0)

Uri\WhatWg\Url::parse — URL をパースする

説明

public static function Uri\WhatWg\Url::parse(string $uri, ?Uri\WhatWg\Url $baseUrl = null, array &$errors = null): ?static

URL をパースします。

パラメータ

uri: パースする URL 文字列（例: https://example.com/foo）。 /foo のような相対 URL 文字列は、 baseUrl が指定された場合にのみ受け付けられます。
baseUrl: string が渡された場合、uri が相対 URL 文字列であれば、 uri を baseUrl に適用します。 null が渡されるか、uri が相対 URL 文字列でない場合、 baseUrl は効果を持ちません。
errors: パース中に発生したエラーの詳細情報を提供するために、 Uri\WhatWg\UrlValidationError インスタンスのリストを参照渡しするための array。

戻り値

成功した場合は Uri\WhatWg\Url インスタンスを返し、失敗した場合は null を返します。

例

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

<?php

$url = \Uri\WhatWg\Url::parse("https://example.com");

if ($url !== null) {
    echo "Valid URL: " . $url->toAsciiString();
} else {
    echo "Invalid URL";
}

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

Valid URL: https://example.com/

参考

Uri\WhatWg\Url::__construct() - Url オブジェクトを構築する
Uri\WhatWg\Url::resolve() - 現在のオブジェクトをベース URL として URL を解決する
Uri\Rfc3986\Uri::parse() - URI をパースする

関連キーワード:

WhatWg パース parse baseUrl https example 相対 resolve static errors インスタンス Valid getUsername 適用効果詳細提供 UrlValidationError 成功基本的 toAsciiString else Invalid 参考 construct