From ee4ad201d2919ce7c9119f3c6f777cf80f4109d1 Mon Sep 17 00:00:00 2001
From: Marcos Marcolin <48370677+marcosmarcolin@users.noreply.github.com>
Date: Sun, 25 Jun 2023 13:14:21 -0300
Subject: [PATCH] docs: update jsonserialize.xml and other mysqli files. (#285)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs: update jsonserialize.xml and other mysqli files.

* Tradução em changelog.

* Linha faltantte.

---------

Co-authored-by: Marcos Marcolin <marcos@ixcsoft.com.br>
Co-authored-by: alfsb <alfsb@users.noreply.github.com>
---
 .../json/jsonserializable/jsonserialize.xml   |  8 +-
 reference/mysqli/mysqli/construct.xml         | 86 ++++++++++-------
 reference/mysqli/mysqli/query.xml             |  4 +-
 reference/mysqli/mysqli/real-connect.xml      | 92 ++++++++++++-------
 reference/mysqli/mysqli/real-query.xml        |  4 +-
 reference/mysqli/mysqli/ssl-set.xml           |  8 +-
 reference/mysqli/mysqli/store-result.xml      |  4 +-
 7 files changed, 129 insertions(+), 77 deletions(-)

diff --git a/reference/json/jsonserializable/jsonserialize.xml b/reference/json/jsonserializable/jsonserialize.xml
index 57c20b7c5..f40da91cf 100644
--- a/reference/json/jsonserializable/jsonserialize.xml
+++ b/reference/json/jsonserializable/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a605fd10c648c8d4cd8315d62a1341323484338e Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: 3d898cf4660609f2c1f55591ffd1556e8cd6d702 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="jsonserializable.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>JsonSerializable::jsonSerialize</refname>
@@ -43,6 +43,7 @@
 <![CDATA[
 <?php
 class ArrayValue implements JsonSerializable {
+    private $array;
     public function __construct(array $array) {
         $this->array = $array;
     }
@@ -77,6 +78,7 @@ echo json_encode(new ArrayValue($array), JSON_PRETTY_PRINT);
 <![CDATA[
 <?php
 class ArrayValue implements JsonSerializable {
+    private $array;
     public function __construct(array $array) {
         $this->array = $array;
     }
@@ -110,8 +112,9 @@ echo json_encode(new ArrayValue($array), JSON_PRETTY_PRINT);
 <![CDATA[
 <?php
 class IntegerValue implements JsonSerializable {
+    private $number;
     public function __construct($number) {
-        $this->number = (integer) $number;
+        $this->number = (int) $number;
     }
 
     public function jsonSerialize() {
@@ -139,6 +142,7 @@ echo json_encode(new IntegerValue(1), JSON_PRETTY_PRINT);
 <![CDATA[
 <?php
 class StringValue implements JsonSerializable {
+    private $string;
     public function __construct($string) {
         $this->string = (string) $string;
     }
diff --git a/reference/mysqli/mysqli/construct.xml b/reference/mysqli/mysqli/construct.xml
index 5da2144de..22f881346 100644
--- a/reference/mysqli/mysqli/construct.xml
+++ b/reference/mysqli/mysqli/construct.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: 2d77c9fe145f74663128006eb71662b0c44e8987 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli.construct" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli::__construct</refname>
@@ -13,31 +13,31 @@
   <para>&style.oop;</para>
   <constructorsynopsis role="mysqli">
    <modifier>public</modifier> <methodname>mysqli::__construct</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>hostname</parameter><initializer>ini_get("mysqli.default_host")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysqli.default_user")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysqli.default_pw")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>database</parameter><initializer>""</initializer></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>ini_get("mysqli.default_port")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>socket</parameter><initializer>ini_get("mysqli.default_socket")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>hostname</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>database</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>port</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>socket</parameter><initializer>&null;</initializer></methodparam>
   </constructorsynopsis>
   <methodsynopsis role="mysqli">
-   <modifier>public</modifier> <type>void</type><methodname>mysqli::connect</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>hostname</parameter><initializer>ini_get("mysqli.default_host")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysqli.default_user")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysqli.default_pw")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>database</parameter><initializer>""</initializer></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>ini_get("mysqli.default_port")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>socket</parameter><initializer>ini_get("mysqli.default_socket")</initializer></methodparam>
+   <modifier>public</modifier> <type>bool</type><methodname>mysqli::connect</methodname>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>hostname</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>database</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>port</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>socket</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
    <type class="union"><type>mysqli</type><type>false</type></type><methodname>mysqli_connect</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>hostname</parameter><initializer>ini_get("mysqli.default_host")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysqli.default_user")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysqli.default_pw")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>database</parameter><initializer>""</initializer></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>ini_get("mysqli.default_port")</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>socket</parameter><initializer>ini_get("mysqli.default_socket")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>hostname</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>database</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>port</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>socket</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Abre uma conexão com o servidor MySQL.
@@ -52,8 +52,8 @@
      <term><parameter>hostname</parameter></term>
      <listitem>
       <para>
-       Pode ser um nome de host ou um endereço IP. O host local é
-       assumido ao passar o valor &null; ou a string "localhost" para este parâmetro.
+       Pode ser um nome de host ou um endereço IP. Ao passar &null;, o valor é recuperado de
+       <link linkend="ini.mysqli.default-host">mysqli.default_host</link>.
        Quando possível, serão usados pipes em vez do protocolo TCP/IP.
        O protocolo TCP/IP é usado se um nome de host e um número de porta forem fornecidos juntos, por ex. <literal>localhost:3308</literal>.
       </para>
@@ -68,7 +68,8 @@
      <term><parameter>username</parameter></term>
      <listitem>
       <para>
-       O nome de usuário do MySQL.
+       O nome de usuário do MySQL ou &null; para assumir o nome de usuário com base no
+       <link linkend="ini.mysqli.default-user">mysqli.default_user</link> opção ini.
       </para>
      </listitem>
     </varlistentry>
@@ -76,10 +77,8 @@
      <term><parameter>password</parameter></term>
      <listitem>
       <para>
-       Se não for fornecido ou for &null;, o servidor MySQL tentará autenticar
-       o usuário apenas nos registros de usuário que não possuem senha. Isso
-       permite que um nome de usuário seja usado com diferentes permissões (dependendo
-       se uma senha é fornecida ou não).
+       A senha do MySQL ou &null; para assumir a senha com base na opção ini
+       <link linkend="ini.mysqli.default-pw">mysqli.default_pw</link>.
       </para>
      </listitem>
     </varlistentry>
@@ -87,8 +86,7 @@
      <term><parameter>database</parameter></term>
      <listitem>
       <para>
-       Se fornecido, especificará o banco de dados padrão a ser usado ao
-       realizar consultas.
+       O banco de dados padrão a ser usado ao realizar consultas ou &null;.
       </para>
      </listitem>
     </varlistentry>
@@ -96,7 +94,8 @@
      <term><parameter>port</parameter></term>
      <listitem>
       <para>
-       Especifica o número da porta para tentar se conectar ao servidor MySQL.
+       O número da porta para tentar conectar ao servidor MySQL ou &null; para assumir a porta com base na opção
+       <link linkend="ini.mysqli.default-port">mysqli.default_port</link>.
       </para>
      </listitem>
     </varlistentry>
@@ -104,7 +103,8 @@
      <term><parameter>socket</parameter></term>
      <listitem>
       <para>
-       Especifica o socket ou pipe nomeado que deve ser usado.
+       O socket ou pipe nomeado que deve ser usado ou &null; para assumir o socket com base na opção ini
+       <link linkend="ini.mysqli.default-socket">mysqli.default_socket</link>.
       </para>
       <note>
        <para>
@@ -141,6 +141,30 @@
   &mysqli.conditionalexception;
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.4.0</entry>
+       <entry>
+        Todos os parâmetros podem ser null.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
diff --git a/reference/mysqli/mysqli/query.xml b/reference/mysqli/mysqli/query.xml
index 4a3930d2e..8d254ab12 100644
--- a/reference/mysqli/mysqli/query.xml
+++ b/reference/mysqli/mysqli/query.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec946465e5ee9dc4dc19f1a28510697066a19eac Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: d470f625f96a83d65464619297cccad7ce46e743 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli.query" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli::query</refname>
@@ -25,6 +25,7 @@
   <para>
    Executa uma <parameter>consulta</parameter> no banco de dados.
   </para>
+  &mysqli.sqlinjection.warning;
   <para>
    Para consultas não-DML (não INSERT, UPDATE ou DELETE),
    esta função é semelhante a chamar
@@ -77,7 +78,6 @@
       <para>
        A string de consulta.
       </para>
-      &mysqli.sqlinjection.warning;
      </listitem>
     </varlistentry>
     <varlistentry>
diff --git a/reference/mysqli/mysqli/real-connect.xml b/reference/mysqli/mysqli/real-connect.xml
index fbeb3151f..0d620723a 100644
--- a/reference/mysqli/mysqli/real-connect.xml
+++ b/reference/mysqli/mysqli/real-connect.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: 2d77c9fe145f74663128006eb71662b0c44e8987 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli.real-connect" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli::real_connect</refname>
@@ -12,25 +12,25 @@
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::real_connect</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>host</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>passwd</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>dbname</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>socket</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>hostname</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>database</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>port</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>socket</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
    <type>bool</type><methodname>mysqli_real_connect</methodname>
-   <methodparam><type>mysqli</type><parameter>link</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>host</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>passwd</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>dbname</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>socket</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
+   <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>hostname</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>database</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>port</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>socket</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    Estabeleça uma conexão com um mecanismo de banco de dados MySQL.
@@ -65,13 +65,13 @@
    <variablelist>
     &mysqli.link.description;
     <varlistentry>
-     <term><parameter>host</parameter></term>
+     <term><parameter>hostname</parameter></term>
      <listitem>
       <para>
-       Pode ser um nome de host ou um endereço IP. Passando o valor &null;
-       ou a string "localhost" para este parâmetro, assume-se o host
-       local. Quando possível, serão usados pipes em vez do
-       protocolo TCP/IP.
+       Pode ser um nome de host ou um endereço IP. Ao passar &null;, o valor é recuperado de
+       <link linkend="ini.mysqli.default-host">mysqli.default_host</link>.
+       Quando possível, serão usados pipes em vez do protocolo TCP/IP.
+       O protocolo TCP/IP é usado se um nome de host e um número de porta forem fornecidos juntos, por ex. <literal>localhost:3308</literal>.
       </para>
      </listitem>
     </varlistentry>
@@ -79,27 +79,25 @@
      <term><parameter>username</parameter></term>
      <listitem>
       <para>
-       O nome de usuário do MySQL.
+       O nome de usuário do MySQL ou &null; para assumir o nome de usuário com base na opção ini
+       <link linkend="ini.mysqli.default-user">mysqli.default_user</link>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>passwd</parameter></term>
+     <term><parameter>password</parameter></term>
      <listitem>
       <para>
-       Se for fornecido ou &null;, o servidor MySQL tentará autenticar
-       o usuário somente com relação aos registros de usuário que não possuem senha. Isso
-       permite que um nome de usuário seja usado com permissões diferentes (dependendo
-       se uma senha foi fornecida ou não).
+       A senha do MySQL ou &null; para assumir a senha com base na opção ini.
+       <link linkend="ini.mysqli.default-pw">mysqli.default_pw</link>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>dbname</parameter></term>
+     <term><parameter>database</parameter></term>
      <listitem>
       <para>
-       Se fornecido, especificará o banco de dados padrão a ser usado ao
-       realizar consultas.
+       O banco de dados padrão a ser usado ao realizar consultas ou &null;.
       </para>
      </listitem>
     </varlistentry>
@@ -107,7 +105,8 @@
      <term><parameter>port</parameter></term>
      <listitem>
       <para>
-       Especifica o número da porta para tentar se conectar ao servidor MySQL.
+       O número da porta para tentar conectar ao servidor MySQL ou &null; para assumir a porta com base na opção
+       <link linkend="ini.mysqli.default-port">mysqli.default_port</link>.
       </para>
      </listitem>
     </varlistentry>
@@ -115,15 +114,16 @@
      <term><parameter>socket</parameter></term>
      <listitem>
       <para>
-       Especifica o soquete ou pipe nomeado que deve ser usado.
+       O socket ou pipe nomeado que deve ser usado ou &null; para assumir o socket com base na opção ini
+       <link linkend="ini.mysqli.default-socket">mysqli.default_socket</link>.
       </para>
       <note>
        <para>
         A especificação do parâmetro <parameter>socket</parameter> não determinará
         explicitamente o tipo de conexão a ser usada ao
         conectar-se ao servidor MySQL. A forma como a conexão é feita com o
-        banco de dados MySQL é determinada pelo parâmetro do
-        <parameter>host</parameter>.
+        banco de dados MySQL é determinada pelo parâmetro
+        <parameter>hostname</parameter>.
        </para>
       </note>
      </listitem>
@@ -203,6 +203,30 @@
   &mysqli.conditionalexception;
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.4.0</entry>
+       <entry>
+        All parameters are now nullable.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
diff --git a/reference/mysqli/mysqli/real-query.xml b/reference/mysqli/mysqli/real-query.xml
index 5efe1079e..9b4497b18 100644
--- a/reference/mysqli/mysqli/real-query.xml
+++ b/reference/mysqli/mysqli/real-query.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: d470f625f96a83d65464619297cccad7ce46e743 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli.real-query" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli::real_query</refname>
@@ -25,6 +25,7 @@
    recuperado ou armazenado usando as funções <function>mysqli_store_result</function> ou
    <function>mysqli_use_result</function>.
   </para>
+  &mysqli.sqlinjection.warning;
   <para>
    Para determinar se uma determinada consulta deve retornar um conjunto de resultados ou não,
    consulte <function>mysqli_field_count</function>.
@@ -42,7 +43,6 @@
       <para>
        A string de consulta.
       </para>
-      &mysqli.sqlinjection.warning;
      </listitem>
     </varlistentry>
    </variablelist>
diff --git a/reference/mysqli/mysqli/ssl-set.xml b/reference/mysqli/mysqli/ssl-set.xml
index c9b2973a8..a27a98e22 100644
--- a/reference/mysqli/mysqli/ssl-set.xml
+++ b/reference/mysqli/mysqli/ssl-set.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: f781803449007bb0e3a96c693e0eee067f7eb466 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli.ssl-set" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli::ssl_set</refname>
@@ -11,7 +11,7 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier>public</modifier> <type>bool</type><methodname>mysqli::ssl_set</methodname>
+   <modifier>public</modifier> <type>true</type><methodname>mysqli::ssl_set</methodname>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>key</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>certificate</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>ca_certificate</parameter></methodparam>
@@ -20,7 +20,7 @@
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <type>bool</type><methodname>mysqli_ssl_set</methodname>
+   <type>true</type><methodname>mysqli_ssl_set</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>key</parameter></methodparam>
    <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>certificate</parameter></methodparam>
@@ -89,7 +89,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Esta função sempre retorna o valor &true;. Se a configuração do SSL
+   &return.true.always; Se a configuração do SSL
    estiver incorreta, <function>mysqli_real_connect</function> retornará um erro
    quando você tentar se conectar.
   </para>
diff --git a/reference/mysqli/mysqli/store-result.xml b/reference/mysqli/mysqli/store-result.xml
index 930e8f200..e34a42d20 100644
--- a/reference/mysqli/mysqli/store-result.xml
+++ b/reference/mysqli/mysqli/store-result.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: 90953eddaa06c6c83faf0dea76c241dfafeaa2a1 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli.store-result" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli::store_result</refname>
@@ -36,7 +36,7 @@
      <term><parameter>mode</parameter></term>
      <listitem>
       <para>
-       A opção que você deseja definir. Pode ser um dos seguintes valores:
+       A opção que você deseja definir. A partir do PHP 8.1, este parâmetro não tem efeito. Pode ser um dos seguintes valores:
        <table xml:id="mysqli.store-result.parameters">
         <title>Valid options</title>
         <tgroup cols="2">