Document the compression-algorithms connection option; WL #14012

git-svn-id: https://svn.php.net/repository/phpdoc/ja/trunk@350586 c90b9560-bf6c-de11-be94-00142212c4b1

Author: Yoshinari Takaoka

reference/mysql_xdevapi/functions/mysql-xdevapi.getsession.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision: 345646 $ -->
-<!-- EN-Revision: 7c132f15ad1e8eaf80020a76f1340d9d0400e271 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: b0a34b2fce160f558e3c81bf73121d16c9d56eb8 Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="function.mysql-xdevapi-getsession" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -103,6 +103,24 @@
               このオプションは 8.0.20 で追加されました。
             </para>
           </listitem>
+          <listitem>
+            <para>
+              オプションの <literal>compression-algorithms</literal> 属性は、
+              好みの圧縮アルゴリズム(および好みの優先順) を定義します:
+              <literal>zstd_stream</literal> (エイリアス: zstd),
+              <literal>lz4_message</literal> (エイリアス: lz4),
+              <literal>deflate_stream</literal> (エイリアス: deflate, zlib) が指定できます。
+              デフォルトでは、(システムで利用可能かどうかに依存しますが)
+              lz4_message, zstd_stream, deflate_stream の順番が使われます。
+              たとえば、compression-algorithms=[lz4,zstd_stream] という値を渡した場合、
+              lz4 が利用可能であれば lz4 を使いますが、そうでない場合は、zstd_stream が使われます。
+              lz4, zstd_stream 双方が利用できない場合、振る舞いは compression の値に依存します。
+              たとえば、compression=required の場合、エラーが出て接続は失敗します。
+            </para>
+            <para>
+              このオプションは 8.0.22 で追加されました。
+            </para>
+          </listitem>
         </itemizedlist>
        </listitem>
       </itemizedlist>
@@ -123,6 +141,7 @@ mysqlx://foobar?ssl-ca=(/path/to/ca.pem)&amp;ssl-crl=(/path/to/crl.pem)
 mysqlx://foo:bar@[localhost:33060, 127.0.0.1:33061]?ssl-mode=disabled
 mysqlx://foo:bar@localhost:33160/?connect-timeout=0
 mysqlx://foo:bar@localhost:33160/?connect-timeout=10&amp;compression=required
+mysqlx://foo:bar@localhost:33160/?connect-timeout=10&amp;compression=required&amp;compression-algorithms=[lz4,zstd_stream]
   </programlisting>
 </example>