diff --git a/README_Glossary.md b/README_Glossary.md index 13a1702a45..7df983eed6 100644 --- a/README_Glossary.md +++ b/README_Glossary.md @@ -41,6 +41,10 @@ * 移行ガイドの文脈での Standard は「標準ライブラリ」で統一する - php-src で言うところの ext/standard に入っている関数全てを指す - Standard PHP Librady (SPL) は別にあるが、「標準ライブラリ」でいいことにする +- WHATWG URL Standard + * 「WHATWG URL Standard」（原語のまま）で統一 + - ext/uri などで言及される、URL 仕様の固有名詞 + - 「WHATWG URL 標準」とはしない - throw Exception * 例外をスローする - 例外を「投げる」とはしない diff --git a/build/prh.yml b/build/prh.yml index 427087e877..a4186b51d5 100644 --- a/build/prh.yml +++ b/build/prh.yml @@ -51,3 +51,10 @@ rules: to: サーバー - from: サーバー to: サーバー + - expected: WHATWG URL Standard + pattern: WHATWG URL 標準 + specs: + - from: WHATWG URL 標準 + to: WHATWG URL Standard + - from: WHATWG URL Standard + to: WHATWG URL Standard diff --git a/language-snippets.ent b/language-snippets.ent index f3605565d2..4a3e7cc41a 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,6 +1,6 @@ - + @@ -4747,6 +4747,21 @@ local: { '> + + + 結果の URI が不正な場合、Uri\InvalidUriException + がスローされます。 + +'> + + + 結果の URL が不正な場合、Uri\WhatWg\InvalidUrlException + がスローされます。 + +'> + + + + + + + URI + URI + + + &reftitle.intro; + + この章では、Uniform Resource Identifier (URI) を扱うための関数について説明します。 + URI とは、リソースを識別するために使われる文字列です。 + URI は、インターネット上のリソースを識別するために、Web 技術で利用されています。 + + + この拡張モジュールは、 + RFC 3986, + Uniform Resource Identifier (URI): Generic Syntax および + WHATWG URL Standard + の仕様に従う機能を実装しています。 + + + + &reference.uri.uri.rfc3986.uri; + + &reference.uri.uri.whatwg.url; + + &reference.uri.uri.uricomparisonmode; + + &reference.uri.uri.uriexception; + &reference.uri.uri.urierror; + &reference.uri.uri.invaliduriexception; + &reference.uri.uri.whatwg.invalidurlexception; + &reference.uri.uri.whatwg.urlvalidationerror; + &reference.uri.uri.whatwg.urlvalidationerrortype; + + diff --git a/reference/uri/uri.invaliduriexception.xml b/reference/uri/uri.invaliduriexception.xml new file mode 100644 index 0000000000..94c08b9827 --- /dev/null +++ b/reference/uri/uri.invaliduriexception.xml @@ -0,0 +1,68 @@ + + + + + Uri\InvalidUriException クラス + Uri\InvalidUriException + + +
+ &reftitle.intro; + + 指定された URI が不正であるか、操作の結果が不正な URI になることを示します。 + +
+ +
+ &reftitle.classsynopsis; + + + Uri + + + + InvalidUriException + + + + extends + Uri\UriException + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + + +
+ + + diff --git a/reference/uri/uri.rfc3986.uri.xml b/reference/uri/uri.rfc3986.uri.xml new file mode 100644 index 0000000000..2a2cb67dbc --- /dev/null +++ b/reference/uri/uri.rfc3986.uri.xml @@ -0,0 +1,63 @@ + + + + + + Uri\Rfc3986\Uri クラス + Uri\Rfc3986\Uri + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + Uri\Rfc3986 + + + + final + readonly + Uri + + + &Methods; + + + + + + + + +
+ + + &reference.uri.uri.rfc3986.entities.uri; + + + diff --git a/reference/uri/uri.uricomparisonmode.xml b/reference/uri/uri.uricomparisonmode.xml new file mode 100644 index 0000000000..2118b01404 --- /dev/null +++ b/reference/uri/uri.uricomparisonmode.xml @@ -0,0 +1,62 @@ + + + + + Uri\UriComparisonMode Enum + Uri\UriComparisonMode + + +
+ &reftitle.intro; + + URI の比較結果に fragment コンポーネントを反映させるかどうかを指定します。 + + + フラグメントが比較から除外される場合、2 つの URI はどちらも fragment + コンポーネントを持たないかのように比較されます。 + +
+ +
+ &reftitle.enumsynopsis; + + + Uri + + + UriComparisonMode + + + IncludeFragment + fragment コンポーネントを比較に含めます。 + + + + ExcludeFragment + fragment コンポーネントを比較から除外します。 + + + +
+ + + diff --git a/reference/uri/uri.urierror.xml b/reference/uri/uri.urierror.xml new file mode 100644 index 0000000000..03e2c74ce0 --- /dev/null +++ b/reference/uri/uri.urierror.xml @@ -0,0 +1,68 @@ + + + + + Uri\UriError クラス + Uri\UriError + + +
+ &reftitle.intro; + + URI の処理中に発生する Error の基底クラスです。 + +
+ +
+ &reftitle.classsynopsis; + + + Uri + + + + UriError + + + + extends + Error + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + + +
+ + + diff --git a/reference/uri/uri.uriexception.xml b/reference/uri/uri.uriexception.xml new file mode 100644 index 0000000000..cd55742b94 --- /dev/null +++ b/reference/uri/uri.uriexception.xml @@ -0,0 +1,69 @@ + + + + + + Uri\UriException クラス + Uri\UriException + + +
+ &reftitle.intro; + + URI の処理中に発生する Exception の基底クラスです。 + +
+ +
+ &reftitle.classsynopsis; + + + Uri + + + + UriException + + + + extends + Exception + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + + +
+ + + diff --git a/reference/uri/uri.whatwg.invalidurlexception.xml b/reference/uri/uri.whatwg.invalidurlexception.xml new file mode 100644 index 0000000000..9009632820 --- /dev/null +++ b/reference/uri/uri.whatwg.invalidurlexception.xml @@ -0,0 +1,97 @@ + + + + + Uri\WhatWg\InvalidUrlException クラス + Uri\WhatWg\InvalidUrlException + + +
+ &reftitle.intro; + + 指定された URL が不正であるか、操作の結果が + WHATWG URL Standard + に従って不正な URL になることを示します。 + +
+ +
+ &reftitle.classsynopsis; + + + Uri\WhatWg + + + + InvalidUrlException + + + + extends + Uri\InvalidUriException + + + &Properties; + + public + readonly + array + errors + + + &InheritedProperties; + + + + + &Methods; + + + + + &InheritedMethods; + + + + + +
+ +
+ &reftitle.properties; + + + errors + + + Uri\WhatWg\UrlValidationError オブジェクトの &array;。 + + + + +
+ + + &reference.uri.uri.whatwg.entities.invalidurlexception; + + + diff --git a/reference/uri/uri.whatwg.url.xml b/reference/uri/uri.whatwg.url.xml new file mode 100644 index 0000000000..d672729c12 --- /dev/null +++ b/reference/uri/uri.whatwg.url.xml @@ -0,0 +1,62 @@ + + + + + Uri\WhatWg\Url クラス + Uri\WhatWg\Url + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + Uri\WhatWg + + + + final + readonly + Url + + + &Methods; + + + + + + + + +
+ + + &reference.uri.uri.whatwg.entities.url; + + + diff --git a/reference/uri/uri.whatwg.urlvalidationerror.xml b/reference/uri/uri.whatwg.urlvalidationerror.xml new file mode 100644 index 0000000000..0ca36520de --- /dev/null +++ b/reference/uri/uri.whatwg.urlvalidationerror.xml @@ -0,0 +1,109 @@ + + + + + Uri\WhatWg\UrlValidationError クラス + Uri\WhatWg\UrlValidationError + + +
+ &reftitle.intro; + + Uri\WhatWg\Url で URL をパースする際に + 検出されたエラーの詳細情報を提供します。 + +
+ +
+ &reftitle.classsynopsis; + + + Uri\WhatWg + + + + final + readonly + UrlValidationError + + + &Properties; + + public + string + context + + + public + Uri\WhatWg\UrlValidationErrorType + type + + + public + bool + failure + + + &Methods; + + + + + +
+ +
+ &reftitle.properties; + + + context + + + エラーが検出された時点での入力 URL。 + + + + + type + + + エラーの種類。 + + + + + failure + + + &true; の場合、エラーにより URL は不正として拒否されます。&false; + の場合、エラーはパース中に自動的に修正されたソフトエラーです。 + + + + +
+ + + &reference.uri.uri.whatwg.entities.urlvalidationerror; + + + diff --git a/reference/uri/uri.whatwg.urlvalidationerrortype.xml b/reference/uri/uri.whatwg.urlvalidationerrortype.xml new file mode 100644 index 0000000000..9519dcf720 --- /dev/null +++ b/reference/uri/uri.whatwg.urlvalidationerrortype.xml @@ -0,0 +1,203 @@ + + + + + Uri\WhatWg\UrlValidationErrorType Enum + Uri\WhatWg\UrlValidationErrorType + + +
+ &reftitle.intro; + + WHATWG URL Standard で定義されている検証エラーの種類です。 + +
+ +
+ &reftitle.enumsynopsis; + + + Uri\WhatWg + + + UrlValidationErrorType + + + DomainToAscii + ドメイン名を ASCII 文字列に変換する処理中のエラーです。 + + + + DomainToUnicode + ドメイン名を Unicode 文字列に変換する処理中のエラーです。 + + + + DomainInvalidCodePoint + 入力のホストに、禁止されたドメインコードポイントが含まれています。 + + + + HostInvalidCodePoint + 不透明なホスト（特別ではない URL のホスト）に、禁止されたホストコードポイントが含まれています。 + + + + Ipv4EmptyPart + IPv4 アドレスが U+002E (.) で終わっています。 + + + + Ipv4TooManyParts + IPv4 アドレスがちょうど 4 つのパートで構成されていません。 + + + + Ipv4NonNumericPart + IPv4 アドレスのパートが数値ではありません。 + + + + Ipv4NonDecimalPart + IPv4 アドレスに、16 進数または 8 進数で表現された数値が含まれています。 + + + + Ipv4OutOfRangePart + IPv4 アドレスのパートが 255 を超えています。 + + + + Ipv6Unclosed + IPv6 アドレスを閉じる U+005D (]) が欠けています。 + + + + Ipv6InvalidCompression + IPv6 アドレスが不正な圧縮で始まっています。 + + + + Ipv6TooManyPieces + IPv6 アドレスに 8 つを超えるピースが含まれています。 + + + + Ipv6MultipleCompression + IPv6 アドレスが複数箇所で圧縮されています。 + + + + Ipv6InvalidCodePoint + + IPv6 アドレスに、ASCII 16 進数字でも U+003A (:) + でもないコードポイントが含まれています。または、予期せず終了しています。 + + + + + Ipv6TooFewPieces + 圧縮されていない IPv6 アドレスに含まれるピースが 8 つ未満です。 + + + + Ipv4InIpv6TooManyPieces + IPv4 アドレス構文を持つ IPv6 アドレスにおいて、IPv6 アドレスのピースが 6 つを超えています。 + + + + Ipv4InIpv6InvalidCodePoint + IPv4 アドレス構文を持つ IPv6 アドレスです。 + + + + Ipv4InIpv6OutOfRangePart + IPv4 アドレス構文を持つ IPv6 アドレスにおいて、IPv4 のパートが 255 を超えています。 + + + + Ipv4InIpv6TooFewParts + IPv4 アドレス構文を持つ IPv6 アドレスにおいて、IPv4 アドレスのパートが少なすぎます。 + + + + InvalidUrlUnit + URL 単位ではないコードポイントが見つかりました。 + + + + SpecialSchemeMissingFollowingSolidus + 入力のスキームの後に // が続いていません。 + + + + MissingSchemeNonRelativeUrl + + 入力にスキームがありません。これは、入力が ASCII アルファベットで始まっておらず、 + かつベース URL が指定されていないか、ベース URL が不透明なパスを持つためベース URL として使用できないためです。 + + + + + InvalidReverseSoldius + URL が特別なスキームを持ち、U+002F (/) + の代わりに U+005C (\) を使用しています。 + + + + InvalidCredentials + 入力に認証情報が含まれています。 + + + + HostMissing + 入力が特別なスキームを持っていますが、ホストを含んでいません。 + + + + PortOutOfRange + 入力のポートが大きすぎます。 + + + + PortInvalid + 入力のポートが不正です。 + + + + FileInvalidWindowsDriveLetter + + 入力が Windows ドライブレターで始まる相対 URL 文字列であり、 + かつベース URL のスキームが file です。 + + + + + FileInvalidWindowsDriveLetterHost + file: URL のホストが Windows ドライブレターになっています。 + + + +
+ + + diff --git a/reference/uri/uri/rfc3986/uri/construct.xml b/reference/uri/uri/rfc3986/uri/construct.xml new file mode 100644 index 0000000000..10ec6336ab --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/construct.xml @@ -0,0 +1,80 @@ + + + + + + Uri\Rfc3986\Uri::__construct + Uri オブジェクトを構築する + + + + &reftitle.description; + + public Uri\Rfc3986\Uri::__construct + stringuri + Uri\Rfc3986\UrinullbaseUrl&null; + + + Uri\Rfc3986\Uri オブジェクトを構築します。 + + + + + &reftitle.parameters; + + + uri + + + パースする URI。 + + + + + baseUrl + + + &string; が渡された場合、uri が相対参照であれば、 + uri を baseUrl に適用します。 + &null; が渡されるか、uri が相対参照でない場合、 + baseUrl は効果を持ちません。 + + + + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::parse + Uri\Rfc3986\Uri::resolve + Uri\WhatWg\Url::__construct + + + + diff --git a/reference/uri/uri/rfc3986/uri/debuginfo.xml b/reference/uri/uri/rfc3986/uri/debuginfo.xml new file mode 100644 index 0000000000..83cad43a92 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/debuginfo.xml @@ -0,0 +1,60 @@ + + + + + + + Uri\Rfc3986\Uri::__debugInfo + URI の内部状態を返す + + + + &reftitle.description; + + public arrayUri\Rfc3986\Uri::__debugInfo + + + + URI の内部状態を返します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + URI の内部状態を &array; として返します。 + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__debugInfo + + + + diff --git a/reference/uri/uri/rfc3986/uri/equals.xml b/reference/uri/uri/rfc3986/uri/equals.xml new file mode 100644 index 0000000000..2cb51e7a8c --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/equals.xml @@ -0,0 +1,103 @@ + + + + + + + Uri\Rfc3986\Uri::equals + 2 つの URI が等価かを判定する + + + + &reftitle.description; + + public boolUri\Rfc3986\Uri::equals + Uri\Rfc3986\Uriuri + Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment + + + 2 つの URI が等価かを判定します。 + + + + + &reftitle.parameters; + + + uri + + + 現在の URI と比較する URI。 + + + + + comparisonMode + + + フラグメントコンポーネントを比較の対象に含めるか + (Uri\UriComparisonMode::IncludeFragment)、含めないか + (Uri\UriComparisonMode::ExcludeFragment)。デフォルトでは、フラグメントは除外されます。 + + + + + + + + &reftitle.returnvalues; + + 2 つの URI が等価である場合は &true; を、そうでない場合は &false; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::equals</methodname> の基本的な例 + +equals($uri2)); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::equals + + + + diff --git a/reference/uri/uri/rfc3986/uri/getfragment.xml b/reference/uri/uri/rfc3986/uri/getfragment.xml new file mode 100644 index 0000000000..8127d725a7 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getfragment.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getFragment + 正規化されたフラグメントコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getFragment + + + + 正規化されたフラグメントコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + フラグメントコンポーネントが存在する場合は正規化されたフラグメントコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getFragment</methodname> の基本的な例 + +getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawFragment + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + diff --git a/reference/uri/uri/rfc3986/uri/gethost.xml b/reference/uri/uri/rfc3986/uri/gethost.xml new file mode 100644 index 0000000000..60188e4dd4 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/gethost.xml @@ -0,0 +1,85 @@ + + + + + + + Uri\Rfc3986\Uri::getHost + 正規化されたホストコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getHost + + + + 正規化されたホストコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ホストコンポーネントが存在する場合は正規化されたホストコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getHost</methodname> の基本的な例 + +getHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::withHost + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + + + + diff --git a/reference/uri/uri/rfc3986/uri/getpassword.xml b/reference/uri/uri/rfc3986/uri/getpassword.xml new file mode 100644 index 0000000000..95791d8f66 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getpassword.xml @@ -0,0 +1,88 @@ + + + + + + + Uri\Rfc3986\Uri::getPassword + 正規化されたパスワードを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getPassword + + + + ユーザー情報コンポーネントから、正規化されたパスワードの部分（最初の : 文字より後ろのテキスト）を取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー情報コンポーネントが : 文字を含む場合は、正規化されたパスワードを &string; として返します。 + ユーザー情報コンポーネントが : 文字を含まない場合は、空文字列を返します。 + ユーザー情報コンポーネントが存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getPassword</methodname> の基本的な例 + +getPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withPassword + Uri\WhatWg\Url::getPassword + + + + diff --git a/reference/uri/uri/rfc3986/uri/getpath.xml b/reference/uri/uri/rfc3986/uri/getpath.xml new file mode 100644 index 0000000000..8da4af1dea --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getpath.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getPath + 正規化されたパスコンポーネントを取得する + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::getPath + + + + 正規化されたパスコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 正規化されたパスコンポーネントを &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getPath</methodname> の基本的な例 + +getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawPath + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + diff --git a/reference/uri/uri/rfc3986/uri/getport.xml b/reference/uri/uri/rfc3986/uri/getport.xml new file mode 100644 index 0000000000..369c2745ea --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getport.xml @@ -0,0 +1,82 @@ + + + + + + Uri\Rfc3986\Uri::getPort + 正規化されたポートコンポーネントを取得する + + + + &reftitle.description; + + public intnullUri\Rfc3986\Uri::getPort + + + + 正規化されたポートコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ポートコンポーネントが存在する場合は正規化されたポートコンポーネントを &integer; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getPort</methodname> の基本的な例 + +getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withPort + Uri\WhatWg\Url::getPort + + + + diff --git a/reference/uri/uri/rfc3986/uri/getquery.xml b/reference/uri/uri/rfc3986/uri/getquery.xml new file mode 100644 index 0000000000..5e0d1f0517 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getquery.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getQuery + 正規化されたクエリコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getQuery + + + + 正規化されたクエリコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + クエリコンポーネントが存在する場合は正規化されたクエリコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getQuery</methodname> の基本的な例 + +getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawfragment.xml b/reference/uri/uri/rfc3986/uri/getrawfragment.xml new file mode 100644 index 0000000000..b1ae45360c --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawfragment.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getRawFragment + 正規化されていないフラグメントコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawFragment + + + + 正規化されていないフラグメントコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + フラグメントコンポーネントが存在する場合は正規化されていないフラグメントコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawFragment</methodname> の基本的な例 + +getRawFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getFragment + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawhost.xml b/reference/uri/uri/rfc3986/uri/getrawhost.xml new file mode 100644 index 0000000000..abc253a64a --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawhost.xml @@ -0,0 +1,85 @@ + + + + + + + Uri\Rfc3986\Uri::getRawHost + 正規化されていないホストコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawHost + + + + 正規化されていないホストコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ホストコンポーネントが存在する場合は正規化されていないホストコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawHost</methodname> の基本的な例 + +getRawHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getHost + Uri\Rfc3986\Uri::withHost + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawpassword.xml b/reference/uri/uri/rfc3986/uri/getrawpassword.xml new file mode 100644 index 0000000000..d136b2c2a9 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawpassword.xml @@ -0,0 +1,86 @@ + + + + + + + Uri\Rfc3986\Uri::getRawPassword + 正規化されていないパスワードを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawPassword + + + + ユーザー情報コンポーネントから、正規化されていないパスワードの部分（最初の : 文字より後ろのテキスト）を取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー情報コンポーネントが : 文字を含む場合は、正規化されていないパスワードを &string; として返します。 + ユーザー情報コンポーネントが : 文字を含まない場合は、空文字列を返します。 + ユーザー情報コンポーネントが存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawPassword</methodname> の基本的な例 + +getRawPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getPassword + + + + \ No newline at end of file diff --git a/reference/uri/uri/rfc3986/uri/getrawpath.xml b/reference/uri/uri/rfc3986/uri/getrawpath.xml new file mode 100644 index 0000000000..1f54407053 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawpath.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getRawPath + 正規化されていないパスコンポーネントを取得する + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::getRawPath + + + + 正規化されていないパスコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 正規化されていないパスコンポーネントを &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawPath</methodname> の基本的な例 + +getRawPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPath + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawquery.xml b/reference/uri/uri/rfc3986/uri/getrawquery.xml new file mode 100644 index 0000000000..a1b7b550db --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawquery.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getRawQuery + 正規化されていないクエリコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawQuery + + + + 正規化されていないクエリコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + クエリコンポーネントが存在する場合は正規化されていないクエリコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawQuery</methodname> の基本的な例 + +getRawQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getQuery + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawscheme.xml b/reference/uri/uri/rfc3986/uri/getrawscheme.xml new file mode 100644 index 0000000000..61b9a58a25 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawscheme.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getRawScheme + 正規化されていないスキームコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawScheme + + + + 正規化されていないスキームコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + スキームコンポーネントが存在する場合は正規化されていないスキームコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawScheme</methodname> の基本的な例 + +getRawScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getScheme + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml b/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml new file mode 100644 index 0000000000..031ba88df6 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml @@ -0,0 +1,88 @@ + + + + + + + Uri\Rfc3986\Uri::getRawUserInfo + 正規化されていないユーザー情報コンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawUserInfo + + + + 正規化されていないユーザー情報コンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー情報コンポーネントが存在する場合は正規化されていないユーザー情報コンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawUserInfo</methodname> の基本的な例 + +getRawUserInfo(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawusername.xml b/reference/uri/uri/rfc3986/uri/getrawusername.xml new file mode 100644 index 0000000000..85108bbeb3 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawusername.xml @@ -0,0 +1,86 @@ + + + + + + + Uri\Rfc3986\Uri::getRawUsername + 正規化されていないユーザー名を取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawUsername + + + + ユーザー情報コンポーネントから、正規化されていないユーザー名の部分 + （最初の : 文字より前のテキスト）を取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー情報コンポーネントが存在する場合は正規化されていないユーザー名を &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawUsername</methodname> の基本的な例 + +getRawUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + + + + diff --git a/reference/uri/uri/rfc3986/uri/getscheme.xml b/reference/uri/uri/rfc3986/uri/getscheme.xml new file mode 100644 index 0000000000..d16fa9fbd8 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getscheme.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::getScheme + 正規化されたスキームコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getScheme + + + + 正規化されたスキームコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + スキームコンポーネントが存在する場合は正規化されたスキームコンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getScheme</methodname> の基本的な例 + +getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + diff --git a/reference/uri/uri/rfc3986/uri/getuserinfo.xml b/reference/uri/uri/rfc3986/uri/getuserinfo.xml new file mode 100644 index 0000000000..d0ff4bbd1b --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getuserinfo.xml @@ -0,0 +1,89 @@ + + + + + + + Uri\Rfc3986\Uri::getUserInfo + 正規化されたユーザー情報コンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getUserInfo + + + + 正規化されたユーザー情報コンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー情報コンポーネントが存在する場合は正規化されたユーザー情報コンポーネントを &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getUserInfo</methodname> の基本的な例 + +getUserInfo(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + + + + diff --git a/reference/uri/uri/rfc3986/uri/getusername.xml b/reference/uri/uri/rfc3986/uri/getusername.xml new file mode 100644 index 0000000000..8af05e69df --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getusername.xml @@ -0,0 +1,87 @@ + + + + + + + Uri\Rfc3986\Uri::getUsername + 正規化されたユーザー名を取得する + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getUsername + + + + ユーザー情報コンポーネントから、正規化されたユーザー名の部分 + （最初の : 文字より前のテキスト）を取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー情報コンポーネントが存在する場合は正規化されたユーザー名を &string; として返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getUsername</methodname> の基本的な例 + +getUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + + + + diff --git a/reference/uri/uri/rfc3986/uri/parse.xml b/reference/uri/uri/rfc3986/uri/parse.xml new file mode 100644 index 0000000000..87427fec2c --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/parse.xml @@ -0,0 +1,108 @@ + + + + + + Uri\Rfc3986\Uri::parse + URI をパースする + + + + &reftitle.description; + + public static staticnullUri\Rfc3986\Uri::parse + stringuri + Uri\Rfc3986\UrinullbaseUrl&null; + + + URI をパースします。 + + + + + &reftitle.parameters; + + + uri + + + パースする URI。 + + + + + baseUrl + + + &string; が渡された場合、uri が相対参照であれば、 + uri を baseUrl に適用します。 + &null; が渡されるか、uri が相対参照でない場合、 + baseUrl は効果を持ちません。 + + + + + + + + &reftitle.returnvalues; + + 成功した場合は Uri\Rfc3986\Uri インスタンスを返し、失敗した場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::parse</methodname> の基本的な例 + +toString(); +} else { + echo "Invalid URI" +} +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__construct + Uri\Rfc3986\Uri::resolve + Uri\WhatWg\Url::parse + + + + diff --git a/reference/uri/uri/rfc3986/uri/resolve.xml b/reference/uri/uri/rfc3986/uri/resolve.xml new file mode 100644 index 0000000000..056beff5e9 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/resolve.xml @@ -0,0 +1,99 @@ + + + + + + + Uri\Rfc3986\Uri::resolve + 現在のオブジェクトをベース URL として URI を解決する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::resolve + stringuri + + + 現在のオブジェクトをベース URL として URI（相対参照である可能性もあります）を解決します。 + + + + + &reftitle.parameters; + + + uri + + + 現在のオブジェクトに適用する URI。 + + + + + + + + &reftitle.returnvalues; + + 新しい Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::resolve</methodname> の基本的な例 + +resolve("/foo"); + +echo $uri->toRawString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__construct + Uri\Rfc3986\Uri::parse + Uri\WhatWg\Url::resolve + + + + diff --git a/reference/uri/uri/rfc3986/uri/serialize.xml b/reference/uri/uri/rfc3986/uri/serialize.xml new file mode 100644 index 0000000000..44b202a97e --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/serialize.xml @@ -0,0 +1,61 @@ + + + + + + + Uri\Rfc3986\Uri::__serialize + Uri オブジェクトをシリアライズする + + + + &reftitle.description; + + public arrayUri\Rfc3986\Uri::__serialize + + + + Uri\Rfc3986\Uri オブジェクトをシリアライズします。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + シリアライズされた URI を &string; として返します。 + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__unserialize + Uri\WhatWg\Url::__serialize + + + + diff --git a/reference/uri/uri/rfc3986/uri/torawstring.xml b/reference/uri/uri/rfc3986/uri/torawstring.xml new file mode 100644 index 0000000000..4532ccea14 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/torawstring.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::toRawString + 正規化されていない URI を再構築する + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::toRawString + + + + 正規化されていない URI を &string; として再構築します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 再構築された正規化されていない URI を &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::toRawString</methodname> の基本的な例 + +toRawString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toString + Uri\WhatWg\Url::toAsciiString + Uri\WhatWg\Url::toUnicodeString + + + + diff --git a/reference/uri/uri/rfc3986/uri/tostring.xml b/reference/uri/uri/rfc3986/uri/tostring.xml new file mode 100644 index 0000000000..48b68ecc03 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/tostring.xml @@ -0,0 +1,84 @@ + + + + + + + Uri\Rfc3986\Uri::toString + 正規化された URI を再構築する + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::toString + + + + 正規化された URI を &string; として再構築します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 再構築された正規化された URI を &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::toString</methodname> の基本的な例 + +toString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toRawString + Uri\WhatWg\Url::toAsciiString + Uri\WhatWg\Url::toUnicodeString + + + + diff --git a/reference/uri/uri/rfc3986/uri/unserialize.xml b/reference/uri/uri/rfc3986/uri/unserialize.xml new file mode 100644 index 0000000000..5674f4e48b --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/unserialize.xml @@ -0,0 +1,80 @@ + + + + + + + Uri\Rfc3986\Uri::__unserialize + data パラメータを Uri オブジェクトにアンシリアライズする + + + + &reftitle.description; + + public voidUri\Rfc3986\Uri::__unserialize + arraydata + + + data パラメータを Uri\Rfc3986\Uri オブジェクトにアンシリアライズします。 + + + + + &reftitle.parameters; + + + data + + + array 形式の、シリアライズされたデータ。 + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + 既に初期化済みの URI に対して __unserialize メソッドが呼ばれた場合、Error + がスローされます。 + + + &uri.errors.invalidUriException; + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__serialize + Uri\WhatWg\Url::__unserialize + + + + diff --git a/reference/uri/uri/rfc3986/uri/withfragment.xml b/reference/uri/uri/rfc3986/uri/withfragment.xml new file mode 100644 index 0000000000..809bf91d5a --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withfragment.xml @@ -0,0 +1,98 @@ + + + + + + + Uri\Rfc3986\Uri::withFragment + フラグメントコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withFragment + stringnullfragment + + + 新しい URI を作成し、そのフラグメントコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + fragment + + + 新しいフラグメントコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withFragment</methodname> の基本的な例 + +withFragment("bar"); + +echo $uri->getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getFragment + Uri\Rfc3986\Uri::getRawFragment + Uri\WhatWg\Url::withFragment + + + + diff --git a/reference/uri/uri/rfc3986/uri/withhost.xml b/reference/uri/uri/rfc3986/uri/withhost.xml new file mode 100644 index 0000000000..74c8fb8223 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withhost.xml @@ -0,0 +1,99 @@ + + + + + + + Uri\Rfc3986\Uri::withHost + ホストコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withHost + stringnullhost + + + 新しい URI を作成し、そのホストコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + host + + + 新しいホストコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withHost</methodname> の基本的な例 + +withHost("example.net"); + +echo $uri->getHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getHost + Uri\Rfc3986\Uri::getRawHost + Uri\WhatWg\Url::withHost + + + + diff --git a/reference/uri/uri/rfc3986/uri/withpath.xml b/reference/uri/uri/rfc3986/uri/withpath.xml new file mode 100644 index 0000000000..aefcdd3109 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withpath.xml @@ -0,0 +1,99 @@ + + + + + + + Uri\Rfc3986\Uri::withPath + パスコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withPath + stringpath + + + 新しい URI を作成し、そのパスコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + path + + + 新しいパスコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withPath</methodname> の基本的な例 + +withPath("/baz"); + +echo $uri->getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPath + Uri\Rfc3986\Uri::getRawPath + Uri\WhatWg\Url::withPath + + + + diff --git a/reference/uri/uri/rfc3986/uri/withport.xml b/reference/uri/uri/rfc3986/uri/withport.xml new file mode 100644 index 0000000000..d84489a402 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withport.xml @@ -0,0 +1,97 @@ + + + + + + Uri\Rfc3986\Uri::withPort + ポートコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withPort + intnullport + + + 新しい URI を作成し、そのポートコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + port + + + 新しいポートコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withPort</methodname> の基本的な例 + +withPort(443); + +echo $uri->getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPort + Uri\WhatWg\Url::withPort + + + + diff --git a/reference/uri/uri/rfc3986/uri/withquery.xml b/reference/uri/uri/rfc3986/uri/withquery.xml new file mode 100644 index 0000000000..5b58d67825 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withquery.xml @@ -0,0 +1,99 @@ + + + + + + + Uri\Rfc3986\Uri::withQuery + クエリコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withQuery + stringnullquery + + + 新しい URI を作成し、そのクエリコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + query + + + 新しいクエリコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withQuery</methodname> の基本的な例 + +withQuery("foo=baz"); + +echo $uri->getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::getQuery + Uri\WhatWg\Url::withQuery + + + + diff --git a/reference/uri/uri/rfc3986/uri/withscheme.xml b/reference/uri/uri/rfc3986/uri/withscheme.xml new file mode 100644 index 0000000000..28232585ff --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withscheme.xml @@ -0,0 +1,98 @@ + + + + + + Uri\Rfc3986\Uri::withScheme + スキームコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withScheme + stringnullscheme + + + 新しい URI を作成し、そのスキームコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + scheme + + + 新しいスキームコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withScheme</methodname> の基本的な例 + +withScheme("http"); + +echo $uri->getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::getScheme + Uri\WhatWg\Url::withScheme + + + + diff --git a/reference/uri/uri/rfc3986/uri/withuserinfo.xml b/reference/uri/uri/rfc3986/uri/withuserinfo.xml new file mode 100644 index 0000000000..6063e2c95e --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withuserinfo.xml @@ -0,0 +1,104 @@ + + + + + + + Uri\Rfc3986\Uri::withUserInfo + ユーザー情報コンポーネントを変更する + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withUserInfo + #[\SensitiveParameter]stringnulluserinfo + + + 新しい URI を作成し、そのユーザー情報コンポーネントを変更します。 + + + + + &reftitle.parameters; + + + userinfo + + + 新しいユーザー情報コンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\Rfc3986\Uri インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withUserInfo</methodname> の基本的な例 + +withUserInfo("userinfo"); + +echo $uri->getUserInfo(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getPassword + Uri\WhatWg\Url::withUsername + Uri\WhatWg\Url::withPassword + + + + diff --git a/reference/uri/uri/whatwg/invalidurlexception/construct.xml b/reference/uri/uri/whatwg/invalidurlexception/construct.xml new file mode 100644 index 0000000000..9d4c48e2be --- /dev/null +++ b/reference/uri/uri/whatwg/invalidurlexception/construct.xml @@ -0,0 +1,81 @@ + + + + + + Uri\WhatWg\InvalidUrlException::__construct + InvalidUrlException オブジェクトを構築する + + + + &reftitle.description; + + public Uri\WhatWg\InvalidUrlException::__construct + stringmessage"" + arrayerrors[] + intcode0 + Throwablenullprevious&null; + + + Uri\WhatWg\InvalidUrlException オブジェクトを構築します。 + + + + + &reftitle.parameters; + + + message + + + 例外メッセージ。 + + + + + errors + + + Uri\WhatWg\UrlValidationError オブジェクトの &array;。 + + + + + code + + + 例外コード。 + + + + + previous + + + 例外チェーン用の直前の例外。 + + + + + + + diff --git a/reference/uri/uri/whatwg/url/construct.xml b/reference/uri/uri/whatwg/url/construct.xml new file mode 100644 index 0000000000..392fac49ee --- /dev/null +++ b/reference/uri/uri/whatwg/url/construct.xml @@ -0,0 +1,90 @@ + + + + + + Uri\WhatWg\Url::__construct + Url オブジェクトを構築する + + + + &reftitle.description; + + public Uri\WhatWg\Url::__construct + stringuri + Uri\WhatWg\UrlnullbaseUrl&null; + arraysoftErrors&null; + + + Uri\Rfc3986\Uri オブジェクトを構築します。 + + + + + &reftitle.parameters; + + + uri + + + パースする有効な URL 文字列（例: /foo や (例: https://example.com/foo)。 + + + + + baseUrl + + + &string; が渡された場合、uri が相対 URL 文字列であれば、 + uri を baseUrl に適用します。 + &null; が渡されるか、uri が相対 URL 文字列でない場合、 + baseUrl は効果を持ちません。 + + + + + softErrors + + + パース中に発生したエラーの詳細情報を提供するために、 + Uri\WhatWg\UrlValidationError インスタンスのリストを参照渡しするための &array;。 + + + + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.seealso; + + Uri\WhatWg\Url::parse + Uri\WhatWg\Url::resolve + Uri\Rfc3986\Uri::__construct + + + + diff --git a/reference/uri/uri/whatwg/url/debuginfo.xml b/reference/uri/uri/whatwg/url/debuginfo.xml new file mode 100644 index 0000000000..1a82b0a763 --- /dev/null +++ b/reference/uri/uri/whatwg/url/debuginfo.xml @@ -0,0 +1,60 @@ + + + + + + + Uri\WhatWg\Url::__debugInfo + URL の内部状態を返す + + + + &reftitle.description; + + public arrayUri\WhatWg\Url::__debugInfo + + + + URL の内部状態を返します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + URL の内部状態を &array; として返します。 + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__debugInfo + + + + diff --git a/reference/uri/uri/whatwg/url/equals.xml b/reference/uri/uri/whatwg/url/equals.xml new file mode 100644 index 0000000000..ca564caa28 --- /dev/null +++ b/reference/uri/uri/whatwg/url/equals.xml @@ -0,0 +1,103 @@ + + + + + + + Uri\WhatWg\Url::equals + 2 つの URL が等価かを判定する + + + + &reftitle.description; + + public boolUri\WhatWg\Url::equals + Uri\WhatWg\Urlurl + Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment + + + 2 つの URL が等価かを判定します。 + + + + + &reftitle.parameters; + + + url + + + 現在の URL と比較する URL。 + + + + + comparisonMode + + + フラグメントコンポーネントを比較の対象に含めるか + (Uri\UriComparisonMode::IncludeFragment)、含めないか + (Uri\UriComparisonMode::ExcludeFragment)。デフォルトでは、フラグメントは除外されます。 + + + + + + + + &reftitle.returnvalues; + + 2 つの URL が等価である場合は &true; を、そうでない場合は &false; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::equals</methodname> の基本的な例 + +equals($url2)); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::equals + + + + diff --git a/reference/uri/uri/whatwg/url/getasciihost.xml b/reference/uri/uri/whatwg/url/getasciihost.xml new file mode 100644 index 0000000000..3f0aead58e --- /dev/null +++ b/reference/uri/uri/whatwg/url/getasciihost.xml @@ -0,0 +1,84 @@ + + + + + + Uri\WhatWg\Url::getAsciiHost + ホストコンポーネントを ASCII &string; として取得する + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getAsciiHost + + + + Unicode 文字ではなく Punycode による変換を使用して、ホストコンポーネントを &string; として取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ホストコンポーネントが存在する場合は ASCII &string; としてホストコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getAsciiHost</methodname> の基本的な例 + +getAsciiHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getUnicodeHost + Uri\WhatWg\Url::withHost + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::getHost + + + + diff --git a/reference/uri/uri/whatwg/url/getfragment.xml b/reference/uri/uri/whatwg/url/getfragment.xml new file mode 100644 index 0000000000..40729dc65c --- /dev/null +++ b/reference/uri/uri/whatwg/url/getfragment.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::getFragment + フラグメントコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getFragment + + + + フラグメントコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + フラグメントコンポーネントが存在する場合は &string; としてフラグメントコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getFragment</methodname> の基本的な例 + +getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withFragment + Uri\Rfc3986\Uri::getRawFragment + Uri\Rfc3986\Uri::getFragment + + + + diff --git a/reference/uri/uri/whatwg/url/getpassword.xml b/reference/uri/uri/whatwg/url/getpassword.xml new file mode 100644 index 0000000000..554c75fa44 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getpassword.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::getPassword + パスワードコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getPassword + + + + パスワードコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + パスワードコンポーネントが存在する場合は &string; としてパスワードコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getPassword</methodname> の基本的な例 + +getPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withPassword + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getPassword + + + + diff --git a/reference/uri/uri/whatwg/url/getpath.xml b/reference/uri/uri/whatwg/url/getpath.xml new file mode 100644 index 0000000000..1ea60b2618 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getpath.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::getPath + パスコンポーネントを取得する + + + + &reftitle.description; + + public stringUri\WhatWg\Url::getPath + + + + パスコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + パスコンポーネントを &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getPath</methodname> の基本的な例 + +getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withPath + Uri\Rfc3986\Uri::getRawPath + Uri\Rfc3986\Uri::getPath + + + + diff --git a/reference/uri/uri/whatwg/url/getport.xml b/reference/uri/uri/whatwg/url/getport.xml new file mode 100644 index 0000000000..43046adfa0 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getport.xml @@ -0,0 +1,82 @@ + + + + + + Uri\WhatWg\Url::getPort + ポートコンポーネントを取得する + + + + &reftitle.description; + + public intnullUri\WhatWg\Url::getPort + + + + ポートコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ポートコンポーネントが存在する場合は &integer; としてポートコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getPort</methodname> の基本的な例 + +getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withPort + Uri\Rfc3986\Uri::getPort + + + + diff --git a/reference/uri/uri/whatwg/url/getquery.xml b/reference/uri/uri/whatwg/url/getquery.xml new file mode 100644 index 0000000000..fe50289483 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getquery.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::getQuery + クエリコンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getQuery + + + + クエリコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + クエリコンポーネントが存在する場合は &string; としてクエリコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getQuery</methodname> の基本的な例 + +getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withQuery + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::getQuery + + + + diff --git a/reference/uri/uri/whatwg/url/getscheme.xml b/reference/uri/uri/whatwg/url/getscheme.xml new file mode 100644 index 0000000000..d9a9712e53 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getscheme.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::getScheme + スキームコンポーネントを取得する + + + + &reftitle.description; + + public stringUri\WhatWg\Url::getScheme + + + + スキームコンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + スキームコンポーネントが存在する場合は &string; としてスキームコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getScheme</methodname> の基本的な例 + +getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withScheme + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::getScheme + + + + diff --git a/reference/uri/uri/whatwg/url/getunicodehost.xml b/reference/uri/uri/whatwg/url/getunicodehost.xml new file mode 100644 index 0000000000..bd7c1b2b17 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getunicodehost.xml @@ -0,0 +1,84 @@ + + + + + + Uri\WhatWg\Url::getUnicodeHost + ホストコンポーネントを Unicode &string; として取得する + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getUnicodeHost + + + + ホストコンポーネントを &string; として取得します。Unicode 文字を含む可能性があります。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ホストコンポーネントが存在する場合は Unicode &string; としてホストコンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getUnicodeHost</methodname> の基本的な例 + +getUnicodeHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::withHost + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::getHost + + + + diff --git a/reference/uri/uri/whatwg/url/getusername.xml b/reference/uri/uri/whatwg/url/getusername.xml new file mode 100644 index 0000000000..30c1d6d44b --- /dev/null +++ b/reference/uri/uri/whatwg/url/getusername.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::getUsername + ユーザー名コンポーネントを取得する + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getUsername + + + + ユーザー名コンポーネントを取得します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + ユーザー名コンポーネントが存在する場合は &string; としてユーザー名コンポーネントを返し、存在しない場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getUsername</methodname> の基本的な例 + +getUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withUsername + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + + + + diff --git a/reference/uri/uri/whatwg/url/parse.xml b/reference/uri/uri/whatwg/url/parse.xml new file mode 100644 index 0000000000..0ef5f97afd --- /dev/null +++ b/reference/uri/uri/whatwg/url/parse.xml @@ -0,0 +1,118 @@ + + + + + + Uri\WhatWg\Url::parse + URL をパースする + + + + &reftitle.description; + + public static staticnullUri\WhatWg\Url::parse + stringuri + Uri\WhatWg\UrlnullbaseUrl&null; + arrayerrors&null; + + + URL をパースします。 + + + + + &reftitle.parameters; + + + uri + + + パースする有効な URL 文字列（例: /foo や (例: https://example.com/foo)。 + + + + + baseUrl + + + &string; が渡された場合、uri が相対 URL 文字列であれば、 + uri を baseUrl に適用します。 + &null; が渡されるか、uri が相対 URL 文字列でない場合、 + baseUrl は効果を持ちません。 + + + + + errors + + + パース中に発生したエラーの詳細情報を提供するために、 + Uri\WhatWg\UrlValidationError インスタンスのリストを参照渡しするための &array;。 + + + + + + + + &reftitle.returnvalues; + + 成功した場合は Uri\WhatWg\Url インスタンスを返し、失敗した場合は &null; を返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::parse</methodname> の基本的な例 + +toAsciiString(); +} else { + echo "Invalid URL" +} +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__construct + Uri\WhatWg\Url::resolve + Uri\Rfc3986\Uri::parse + + + + diff --git a/reference/uri/uri/whatwg/url/resolve.xml b/reference/uri/uri/whatwg/url/resolve.xml new file mode 100644 index 0000000000..8ea36fae13 --- /dev/null +++ b/reference/uri/uri/whatwg/url/resolve.xml @@ -0,0 +1,109 @@ + + + + + + + Uri\WhatWg\Url::resolve + 現在のオブジェクトをベース URL として URL を解決する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::resolve + stringuri + arraysoftErrors&null; + + + 現在のオブジェクトをベース URL として、有効な URL 文字列（相対 URL 文字列である可能性もあります）を解決します。 + + + + + &reftitle.parameters; + + + uri + + + 現在のオブジェクトに適用する有効な URL 文字列（例: /foo や https://example.com/foo）。 + + + + + softErrors + + + 参照解決中に発生したソフトエラーの詳細情報を提供するために、 + Uri\WhatWg\UrlValidationError インスタンスのリストを参照渡しするための &array;。 + + + + + + + + &reftitle.returnvalues; + + 新しい Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::resolve</methodname> の基本的な例 + +resolve("/foo"); + +echo $url->toAsciiString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__construct + Uri\WhatWg\Url::parse + Uri\Rfc3986\Uri::resolve + + + + diff --git a/reference/uri/uri/whatwg/url/serialize.xml b/reference/uri/uri/whatwg/url/serialize.xml new file mode 100644 index 0000000000..56c280fe3b --- /dev/null +++ b/reference/uri/uri/whatwg/url/serialize.xml @@ -0,0 +1,61 @@ + + + + + + + Uri\WhatWg\Url::__serialize + Url オブジェクトをシリアライズする + + + + &reftitle.description; + + public arrayUri\WhatWg\Url::__serialize + + + + Uri\WhatWg\Url オブジェクトをシリアライズします。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + シリアライズされた URL を &array; として返します。 + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__unserialize + Uri\Rfc3986\Uri::__serialize + + + + diff --git a/reference/uri/uri/whatwg/url/toasciistring.xml b/reference/uri/uri/whatwg/url/toasciistring.xml new file mode 100644 index 0000000000..a03b52323a --- /dev/null +++ b/reference/uri/uri/whatwg/url/toasciistring.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::toAsciiString + URL を ASCII &string; として再構築する + + + + &reftitle.description; + + public stringUri\WhatWg\Url::toAsciiString + + + + ホストコンポーネントで Unicode 文字ではなく Punycode による変換を使用して、URL を ASCII &string; として再構築します。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 再構築された URL を ASCII &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::toAsciiString</methodname> の基本的な例 + +toAsciiString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::toUnicodeString + Uri\Rfc3986\Uri::toRawString + Uri\Rfc3986\Uri::toString + + + + diff --git a/reference/uri/uri/whatwg/url/tounicodestring.xml b/reference/uri/uri/whatwg/url/tounicodestring.xml new file mode 100644 index 0000000000..b1fa50591e --- /dev/null +++ b/reference/uri/uri/whatwg/url/tounicodestring.xml @@ -0,0 +1,83 @@ + + + + + + Uri\WhatWg\Url::toUnicodeString + URL を Unicode &string; として再構築する + + + + &reftitle.description; + + public stringUri\WhatWg\Url::toUnicodeString + + + + URL を &string; として再構築します。ホストコンポーネントには Unicode 文字が含まれる可能性があります。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 再構築された URL を Unicode &string; として返します。 + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::toUnicodeString</methodname> の基本的な例 + +toUnicodeString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::toAsciiString + Uri\Rfc3986\Uri::toRawString + Uri\Rfc3986\Uri::toString + + + + diff --git a/reference/uri/uri/whatwg/url/unserialize.xml b/reference/uri/uri/whatwg/url/unserialize.xml new file mode 100644 index 0000000000..52d6d1a5cd --- /dev/null +++ b/reference/uri/uri/whatwg/url/unserialize.xml @@ -0,0 +1,80 @@ + + + + + + + Uri\WhatWg\Url::__unserialize + data パラメータを Url オブジェクトにアンシリアライズする + + + + &reftitle.description; + + public voidUri\WhatWg\Url::__unserialize + arraydata + + + data パラメータを Uri\WhatWg\Url オブジェクトにアンシリアライズします。 + + + + + &reftitle.parameters; + + + data + + + array 形式の、シリアライズされたデータ。 + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + 既に初期化済みの URL に対して __unserialize メソッドが呼ばれた場合、Error + がスローされます。 + + + &uri.errors.invalidUriException; + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__serialize + Uri\Rfc3986\Uri::__unserialize + + + + diff --git a/reference/uri/uri/whatwg/url/withfragment.xml b/reference/uri/uri/whatwg/url/withfragment.xml new file mode 100644 index 0000000000..f305e399cf --- /dev/null +++ b/reference/uri/uri/whatwg/url/withfragment.xml @@ -0,0 +1,97 @@ + + + + + + Uri\WhatWg\Url::withFragment + フラグメントコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withFragment + stringnullfragment + + + 新しい URL を作成し、そのフラグメントコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + fragment + + + 新しいフラグメントコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withFragment</methodname> の基本的な例 + +withFragment("bar"); + +echo $url->getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getFragment + Uri\Rfc3986\Uri::withFragment + + + + diff --git a/reference/uri/uri/whatwg/url/withhost.xml b/reference/uri/uri/whatwg/url/withhost.xml new file mode 100644 index 0000000000..bb5b335245 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withhost.xml @@ -0,0 +1,99 @@ + + + + + + + Uri\WhatWg\Url::withHost + ホストコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withHost + stringnullhost + + + 新しい URL を作成し、そのホストコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + host + + + 新しいホストコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withHost</methodname> の基本的な例 + +withHost("example.net"); + +echo $url->getAsciiHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + Uri\Rfc3986\Uri::withHost + + + + diff --git a/reference/uri/uri/whatwg/url/withpassword.xml b/reference/uri/uri/whatwg/url/withpassword.xml new file mode 100644 index 0000000000..cb202b1f8e --- /dev/null +++ b/reference/uri/uri/whatwg/url/withpassword.xml @@ -0,0 +1,99 @@ + + + + + + + Uri\WhatWg\Url::withPassword + パスワードコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPassword + #[\SensitiveParameter]stringnullpassword + + + 新しい URL を作成し、そのパスワードコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + password + + + 新しいパスワードコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withPassword</methodname> の基本的な例 + +withPassword("pass"); + +echo $url->getPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getPassword + Uri\WhatWg\Url::getUsername + Uri\Rfc3986\Uri::withUserInfo + + + + diff --git a/reference/uri/uri/whatwg/url/withpath.xml b/reference/uri/uri/whatwg/url/withpath.xml new file mode 100644 index 0000000000..991c9d6057 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withpath.xml @@ -0,0 +1,98 @@ + + + + + + + Uri\WhatWg\Url::withPath + パスコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPath + stringpath + + + 新しい URL を作成し、そのパスコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + path + + + 新しいパスコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withPath</methodname> の基本的な例 + +withPath("/baz"); + +echo $url->getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getPath + Uri\Rfc3986\Uri::withPath + + + + diff --git a/reference/uri/uri/whatwg/url/withport.xml b/reference/uri/uri/whatwg/url/withport.xml new file mode 100644 index 0000000000..f5034486e9 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withport.xml @@ -0,0 +1,98 @@ + + + + + + + Uri\WhatWg\Url::withPort + ポートコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPort + intnullport + + + 新しい URL を作成し、そのポートコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + port + + + 新しいポートコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withPort</methodname> の基本的な例 + +withPort(443); + +echo $url->getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getPort + Uri\Rfc3986\Uri::withPort + + + + diff --git a/reference/uri/uri/whatwg/url/withquery.xml b/reference/uri/uri/whatwg/url/withquery.xml new file mode 100644 index 0000000000..fb560a12f8 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withquery.xml @@ -0,0 +1,97 @@ + + + + + + Uri\WhatWg\Url::withQuery + クエリコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withQuery + stringnullquery + + + 新しい URL を作成し、そのクエリコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + query + + + 新しいクエリコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withQuery</methodname> の基本的な例 + +withQuery("foo=baz"); + +echo $url->getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getQuery + Uri\Rfc3986\Uri::withQuery + + + + diff --git a/reference/uri/uri/whatwg/url/withscheme.xml b/reference/uri/uri/whatwg/url/withscheme.xml new file mode 100644 index 0000000000..370867c8a1 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withscheme.xml @@ -0,0 +1,98 @@ + + + + + + + Uri\WhatWg\Url::withScheme + スキームコンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withScheme + stringscheme + + + 新しい URL を作成し、そのスキームコンポーネントを変更します。 + + + + + &reftitle.parameters; + + + scheme + + + 新しいスキームコンポーネント。 + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withScheme</methodname> の基本的な例 + +withScheme("http"); + +echo $url->getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getScheme + Uri\Rfc3986\Uri::withScheme + + + + diff --git a/reference/uri/uri/whatwg/url/withusername.xml b/reference/uri/uri/whatwg/url/withusername.xml new file mode 100644 index 0000000000..25f9e80ea8 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withusername.xml @@ -0,0 +1,99 @@ + + + + + + Uri\WhatWg\Url::withUsername + ユーザー名コンポーネントを変更する + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withUsername + stringnullusername + + + 新しい URL を作成し、そのユーザー名コンポーネントを変更します。 + + + + + &reftitle.parameters; + + + username + + + 新しいユーザー名コンポーネント。 + + + + + + + + + &reftitle.returnvalues; + + 変更された Uri\WhatWg\Url インスタンス。 + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withUsername</methodname> の基本的な例 + +withUsername("usr"); + +echo $url->getUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + Uri\Rfc3986\Uri::withUserInfo + + + + diff --git a/reference/uri/uri/whatwg/urlvalidationerror/construct.xml b/reference/uri/uri/whatwg/urlvalidationerror/construct.xml new file mode 100644 index 0000000000..71cfed1e05 --- /dev/null +++ b/reference/uri/uri/whatwg/urlvalidationerror/construct.xml @@ -0,0 +1,73 @@ + + + + + + Uri\WhatWg\UrlValidationError::__construct + UrlValidationError オブジェクトを構築する + + + + &reftitle.description; + + public Uri\WhatWg\UrlValidationError::__construct + stringcontext + Uri\WhatWg\UrlValidationErrorTypetype + boolfailure + + + Uri\WhatWg\UrlValidationError オブジェクトを構築します。 + + + + + &reftitle.parameters; + + + context + + + エラーが検出された時点での入力 URL。 + + + + + type + + + エラーの種類。 + + + + + failure + + + &true; の場合、エラーにより URL は不正として拒否されます。&false; の場合、 + エラーはパース中に自動的に修正されたソフトエラーです。 + + + + + + + diff --git a/reference/url/functions/parse-url.xml b/reference/url/functions/parse-url.xml index 34a8ac4884..3ea372392d 100644 --- a/reference/url/functions/parse-url.xml +++ b/reference/url/functions/parse-url.xml @@ -46,7 +46,7 @@ Uri\Rfc3986\Uri クラスと Uri\WhatWg\Url - クラスは、それぞれ RFC 3986 と WHATWG URL 標準に厳密に従います。 + クラスは、それぞれ RFC 3986 と WHATWG URL Standard に厳密に従います。 新しく書くすべてのコードでこれらのクラスを使用し、 parse_url 関数の既存の使用箇所もこれらのクラスに 移行することを強く推奨します。