URI の正規化の説明とコード例を原文に追従

language-snippets.ent

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8648d1cda141537b5dbd403a0bf0e6eb8c086e9d Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: takagi Status: ready -->
 <!-- Credits: hirokawa,haruki,shimooka,mumumu,jdkfx -->
 
 <!--
@@ -4473,6 +4473,20 @@ local: {
   </simpara>
 '>
 
+<!ENTITY uri.normalization '
+  <simpara>
+   RFC 3986 に従って、16 進数のトリプレットは大文字に変換され、パーセントエンコードされた非予約文字はデコードされ、
+   スキームコンポーネントとホストコンポーネントは小文字に正規化され、パスからドットセグメントが削除されます。
+  </simpara>
+'>
+
+<!ENTITY uri.non-normalization '
+  <simpara>
+   16 進数のトリプレットは大文字に変換されず、パーセントエンコードされた非予約文字はエンコードされたまま残り、
+   スキームコンポーネントとホストコンポーネントは指定された通りの大文字小文字を保ち、ドットセグメントはパスに残ります。
+  </simpara>
+'>
+
 <!-- UOPZ snippets -->
 
 <!ENTITY uopz.warn.removed.function-5-0-0 '<warning

reference/uri/uri.whatwg.urlvalidationerrortype.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8352249a84d0b91b38c741ff1c256061127dbfbb Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 <reference xml:id="enum.uri-whatwg-urlvalidationerrortype" role="enum" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook">
  <title>Uri\WhatWg\UrlValidationErrorType Enum</title>
  <titleabbrev>Uri\WhatWg\UrlValidationErrorType</titleabbrev>
@@ -107,7 +107,10 @@
 
      <enumitem>
       <enumidentifier>Ipv4InIpv6InvalidCodePoint</enumidentifier>
-      <enumitemdescription>IPv4 アドレス構文を持つ IPv6 アドレスです。</enumitemdescription>
+      <enumitemdescription>
+       IPv4 アドレス構文を持つ IPv6 アドレスです。IPv4 のパートが空であるか、
+       パートに ASCII 数字以外の文字や先頭のゼロが含まれているか、パートの数が多すぎます。
+      </enumitemdescription>
      </enumitem>
 
      <enumitem>

reference/uri/uri/rfc3986/uri/getfragment.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getfragment" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されたフラグメントコンポーネントを取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/gethost.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.gethost" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されたホストコンポーネントを取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getpassword.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getpassword" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    ユーザー情報コンポーネントから、正規化されたパスワードの部分（最初の <literal>:</literal> 文字より後ろのテキスト）を取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getpath.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getpath" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されたパスコンポーネントを取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getquery.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getquery" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されたクエリコンポーネントを取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawfragment.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c5ff5efb9c44487de448c0294af6f6b214f87594 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawfragment" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されていないフラグメントコンポーネントを取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawhost.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawhost" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されていないホストコンポーネントを取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawpassword.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawpassword" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    ユーザー情報コンポーネントから、正規化されていないパスワードの部分（最初の <literal>:</literal> 文字より後ろのテキスト）を取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawpath.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawpath" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されていないパスコンポーネントを取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawquery.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawquery" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されていないクエリコンポーネントを取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawscheme.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawscheme" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されていないスキームコンポーネントを取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawuserinfo.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawuserinfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されていないユーザー情報コンポーネントを取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getrawusername.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getrawusername" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -18,6 +18,7 @@
    ユーザー情報コンポーネントから、正規化されていないユーザー名の部分
    （最初の <literal>:</literal> 文字より前のテキスト）を取得します。
   </simpara>
+  &uri.non-normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getscheme.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getscheme" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されたスキームコンポーネントを取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getuserinfo.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getuserinfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,7 @@
   <simpara>
    正規化されたユーザー情報コンポーネントを取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/getusername.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.getusername" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -18,6 +18,7 @@
    ユーザー情報コンポーネントから、正規化されたユーザー名の部分
    （最初の <literal>:</literal> 文字より前のテキスト）を取得します。
   </simpara>
+  &uri.normalization;
  </refsect1>
 
  <refsect1 role="parameters">

reference/uri/uri/rfc3986/uri/parse.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8e2cfbdce0cd028a6521c6e073f148e0f7efac7c Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 <refentry xml:id="uri-rfc3986-uri.parse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::parse</refname>
@@ -58,14 +58,14 @@
    <programlisting role="php">
 <![CDATA[
 <?php
+
 $uri = \Uri\Rfc3986\Uri::parse("https://example.com");
 
 if ($uri !== null) {
     echo "Valid URI: " . $uri->toString();
 } else {
     echo "Invalid URI";
 }
-?>
 ]]>
    </programlisting>
    &example.outputs;

reference/uri/uri/rfc3986/uri/resolve.xml

@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.resolve" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Uri\Rfc3986\Uri::resolve</refname>
-  <refpurpose>現在のオブジェクトをベース URL として URI を解決する</refpurpose>
+  <refpurpose>現在のオブジェクトをベース URI として URI を解決する</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,7 +15,7 @@
    <methodparam><type>string</type><parameter>uri</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   現在のオブジェクトをベース URL として URI（相対参照である可能性もあります）を解決します。
+   現在のオブジェクトをベース URI として URI（相対参照である可能性もあります）を解決します。
   </simpara>
  </refsect1>
 
@@ -52,11 +52,11 @@
    <programlisting role="php">
 <![CDATA[
 <?php
+
 $uri = new \Uri\Rfc3986\Uri("https://example.com");
 $uri = $uri->resolve("/foo");
 
 echo $uri->toRawString();
-?>
 ]]>
    </programlisting>
    &example.outputs;

reference/uri/uri/rfc3986/uri/torawstring.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 39596f1226fd3b502bfbba09068ad6701235426f Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 9bf8b904f30d04adcccd3e202c9e870b79284789 Maintainer: KentarouTakeda Status: ready -->
 
 <refentry xml:id="uri-rfc3986-uri.torawstring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,11 @@
   <simpara>
    正規化されていない URI を &string; として再構築します。
   </simpara>
+  &uri.non-normalization;
+  <simpara>
+   IPv6 ホストは例外です。パースされた形式から再構築されるため、
+   入力がどの表記であっても、完全に展開された小文字の形式で返されます。
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">