[prev in list] [next in list] [prev in thread] [next in thread]
List: php-doc-cvs
Subject: [DOC-CVS] [doc-en] master: document ext-mysqli exception throwing on their respective pages (#1413)
From: Wyatt via GitHub <noreply () php ! net>
Date: 2023-01-27 20:53:21
Message-ID: mjsmkzaHAUibkRIGdGlatHVLzsXj4XZVJQs2a70E () main ! php ! net
[Download RAW message or body]
Author: Wyatt (Parsonswy)
Committer: GitHub (web-flow)
Pusher: kamil-tekiela
Date: 2023-01-27T20:53:43Z
Commit: https://github.com/php/doc-en/commit/63b99082ef83eade08151f8cb528246fded81db9
Raw diff: https://github.com/php/doc-en/commit/63b99082ef83eade08151f8cb528246fded81db9.diff
document ext-mysqli exception throwing on their respective pages (#1413)
Changed paths:
M language-snippets.ent
M reference/mysqli/mysqli/autocommit.xml
M reference/mysqli/mysqli/change-user.xml
M reference/mysqli/mysqli/commit.xml
M reference/mysqli/mysqli/construct.xml
M reference/mysqli/mysqli/kill.xml
M reference/mysqli/mysqli/multi-query.xml
M reference/mysqli/mysqli/next-result.xml
M reference/mysqli/mysqli/options.xml
M reference/mysqli/mysqli/ping.xml
M reference/mysqli/mysqli/prepare.xml
M reference/mysqli/mysqli/query.xml
M reference/mysqli/mysqli/real-connect.xml
M reference/mysqli/mysqli/real-query.xml
M reference/mysqli/mysqli/reap-async-query.xml
M reference/mysqli/mysqli/rollback.xml
M reference/mysqli/mysqli/select-db.xml
M reference/mysqli/mysqli/set-charset.xml
M reference/mysqli/mysqli/store-result.xml
M reference/mysqli/mysqli/use-result.xml
M reference/mysqli/mysqli_result/construct.xml
M reference/mysqli/mysqli_stmt/attr-set.xml
M reference/mysqli/mysqli_stmt/bind-param.xml
M reference/mysqli/mysqli_stmt/construct.xml
M reference/mysqli/mysqli_stmt/execute.xml
M reference/mysqli/mysqli_stmt/fetch.xml
M reference/mysqli/mysqli_stmt/get-result.xml
M reference/mysqli/mysqli_stmt/next-result.xml
M reference/mysqli/mysqli_stmt/prepare.xml
M reference/mysqli/mysqli_stmt/result-metadata.xml
M reference/mysqli/mysqli_stmt/store-result.xml
Diff:
diff --git a/language-snippets.ent b/language-snippets.ent
index 7a8653f3a2a..24f61bd54ab 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -1996,6 +1996,10 @@ prepared statements</link> should be used instead. \
Alternatively, the data must be properly formatted and all strings must be escaped \
using the <function>mysqli_real_escape_string</function>
function.</para></warning>'>
+<!ENTITY mysqli.conditionalexception '<para xmlns="http://docbook.org/ns/docbook">
+If mysqli error reporting is enabled (<constant>MYSQLI_REPORT_ERROR</constant>) and \
the requested operation fails, +a warning is generated. If, in addition, the mode is \
set to <constant>MYSQLI_REPORT_STRICT</constant>, +a \
<classname>mysqli_sql_exception</classname> is thrown instead.</para>'>
<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
diff --git a/reference/mysqli/mysqli/autocommit.xml \
b/reference/mysqli/mysqli/autocommit.xml index 252a071a9d8..f57a2abe50a 100644
--- a/reference/mysqli/mysqli/autocommit.xml
+++ b/reference/mysqli/mysqli/autocommit.xml
@@ -53,6 +53,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/change-user.xml \
b/reference/mysqli/mysqli/change-user.xml index f994331f873..c2e264756ff 100644
--- a/reference/mysqli/mysqli/change-user.xml
+++ b/reference/mysqli/mysqli/change-user.xml
@@ -81,6 +81,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/commit.xml b/reference/mysqli/mysqli/commit.xml
index 1cd3bb3bf7e..d8c3ea4963a 100644
--- a/reference/mysqli/mysqli/commit.xml
+++ b/reference/mysqli/mysqli/commit.xml
@@ -59,6 +59,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="changelog">
&reftitle.changelog;
<para>
diff --git a/reference/mysqli/mysqli/construct.xml \
b/reference/mysqli/mysqli/construct.xml index de7ffd43d55..01b77bdf664 100644
--- a/reference/mysqli/mysqli/construct.xml
+++ b/reference/mysqli/mysqli/construct.xml
@@ -138,10 +138,7 @@
<refsect1 role="errors">
&reftitle.errors;
- <para>
- If <constant>MYSQLI_REPORT_STRICT</constant> is enabled and the attempt to \
connect
- to the requested database fails, a <classname>mysqli_sql_exception</classname> is \
thrown.
- </para>
+ &mysqli.conditionalexception;
</refsect1>
<refsect1 role="examples">
diff --git a/reference/mysqli/mysqli/kill.xml b/reference/mysqli/mysqli/kill.xml
index 878a21b0459..0d23af9c8c2 100644
--- a/reference/mysqli/mysqli/kill.xml
+++ b/reference/mysqli/mysqli/kill.xml
@@ -47,6 +47,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/multi-query.xml \
b/reference/mysqli/mysqli/multi-query.xml index db7adcf4356..ffcc4e69172 100644
--- a/reference/mysqli/mysqli/multi-query.xml
+++ b/reference/mysqli/mysqli/multi-query.xml
@@ -94,6 +94,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/next-result.xml \
b/reference/mysqli/mysqli/next-result.xml index ee23c13e0e4..2998684f95e 100644
--- a/reference/mysqli/mysqli/next-result.xml
+++ b/reference/mysqli/mysqli/next-result.xml
@@ -43,6 +43,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
diff --git a/reference/mysqli/mysqli/options.xml \
b/reference/mysqli/mysqli/options.xml index eecffe3c11f..b96220c36ba 100644
--- a/reference/mysqli/mysqli/options.xml
+++ b/reference/mysqli/mysqli/options.xml
@@ -148,6 +148,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
diff --git a/reference/mysqli/mysqli/ping.xml b/reference/mysqli/mysqli/ping.xml
index 75e091c382c..ae94281a3de 100644
--- a/reference/mysqli/mysqli/ping.xml
+++ b/reference/mysqli/mysqli/ping.xml
@@ -53,6 +53,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/prepare.xml \
b/reference/mysqli/mysqli/prepare.xml index b829973d58b..078414e482c 100644
--- a/reference/mysqli/mysqli/prepare.xml
+++ b/reference/mysqli/mysqli/prepare.xml
@@ -73,6 +73,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/query.xml b/reference/mysqli/mysqli/query.xml
index 224e44cc801..ef26dd61314 100644
--- a/reference/mysqli/mysqli/query.xml
+++ b/reference/mysqli/mysqli/query.xml
@@ -126,6 +126,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/real-connect.xml \
b/reference/mysqli/mysqli/real-connect.xml index c39a1bd6492..faf6661ced7 100644
--- a/reference/mysqli/mysqli/real-connect.xml
+++ b/reference/mysqli/mysqli/real-connect.xml
@@ -198,6 +198,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/real-query.xml \
b/reference/mysqli/mysqli/real-query.xml index 0cd3a170b73..609f0b9ef5d 100644
--- a/reference/mysqli/mysqli/real-query.xml
+++ b/reference/mysqli/mysqli/real-query.xml
@@ -56,6 +56,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/mysqli/mysqli/reap-async-query.xml \
b/reference/mysqli/mysqli/reap-async-query.xml index e66b75671e5..d76d20438bd 100644
--- a/reference/mysqli/mysqli/reap-async-query.xml
+++ b/reference/mysqli/mysqli/reap-async-query.xml
@@ -48,6 +48,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/mysqli/mysqli/rollback.xml \
b/reference/mysqli/mysqli/rollback.xml index 141c0cdda35..1c9550cb3ff 100644
--- a/reference/mysqli/mysqli/rollback.xml
+++ b/reference/mysqli/mysqli/rollback.xml
@@ -59,6 +59,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="changelog">
&reftitle.changelog;
<para>
diff --git a/reference/mysqli/mysqli/select-db.xml \
b/reference/mysqli/mysqli/select-db.xml index 1bbc7c88547..f1ed1189f4f 100644
--- a/reference/mysqli/mysqli/select-db.xml
+++ b/reference/mysqli/mysqli/select-db.xml
@@ -57,6 +57,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/set-charset.xml \
b/reference/mysqli/mysqli/set-charset.xml index f6a69b26b61..2e132c8e82f 100644
--- a/reference/mysqli/mysqli/set-charset.xml
+++ b/reference/mysqli/mysqli/set-charset.xml
@@ -50,6 +50,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli/store-result.xml \
b/reference/mysqli/mysqli/store-result.xml index bfda43edd71..2e66471933b 100644
--- a/reference/mysqli/mysqli/store-result.xml
+++ b/reference/mysqli/mysqli/store-result.xml
@@ -88,6 +88,11 @@
</note>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
diff --git a/reference/mysqli/mysqli/use-result.xml \
b/reference/mysqli/mysqli/use-result.xml index 5434cd9acd4..b5e3145858b 100644
--- a/reference/mysqli/mysqli/use-result.xml
+++ b/reference/mysqli/mysqli/use-result.xml
@@ -57,6 +57,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_result/construct.xml \
b/reference/mysqli/mysqli_result/construct.xml index b5e1cfd26de..159cc32a0df 100644
--- a/reference/mysqli/mysqli_result/construct.xml
+++ b/reference/mysqli/mysqli_result/construct.xml
@@ -54,6 +54,11 @@
</variablelist>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_stmt/attr-set.xml \
b/reference/mysqli/mysqli_stmt/attr-set.xml index da608fad4c3..9037ecbbdae 100644
--- a/reference/mysqli/mysqli_stmt/attr-set.xml
+++ b/reference/mysqli/mysqli_stmt/attr-set.xml
@@ -105,6 +105,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/mysqli/mysqli_stmt/bind-param.xml \
b/reference/mysqli/mysqli_stmt/bind-param.xml index 83839c26ab0..2bff22b1467 100644
--- a/reference/mysqli/mysqli_stmt/bind-param.xml
+++ b/reference/mysqli/mysqli_stmt/bind-param.xml
@@ -110,6 +110,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_stmt/construct.xml \
b/reference/mysqli/mysqli_stmt/construct.xml index ea84881e7e6..c83937865f3 100644
--- a/reference/mysqli/mysqli_stmt/construct.xml
+++ b/reference/mysqli/mysqli_stmt/construct.xml
@@ -45,6 +45,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
diff --git a/reference/mysqli/mysqli_stmt/execute.xml \
b/reference/mysqli/mysqli_stmt/execute.xml index 52e032c0e2f..cd06e48004d 100644
--- a/reference/mysqli/mysqli_stmt/execute.xml
+++ b/reference/mysqli/mysqli_stmt/execute.xml
@@ -62,6 +62,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
diff --git a/reference/mysqli/mysqli_stmt/fetch.xml \
b/reference/mysqli/mysqli_stmt/fetch.xml index 56c57d33697..b1506af169d 100644
--- a/reference/mysqli/mysqli_stmt/fetch.xml
+++ b/reference/mysqli/mysqli_stmt/fetch.xml
@@ -76,6 +76,11 @@
</table>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_stmt/get-result.xml \
b/reference/mysqli/mysqli_stmt/get-result.xml index d7e7c22f81d..b2f8d8d9529 100644
--- a/reference/mysqli/mysqli_stmt/get-result.xml
+++ b/reference/mysqli/mysqli_stmt/get-result.xml
@@ -60,6 +60,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_stmt/next-result.xml \
b/reference/mysqli/mysqli_stmt/next-result.xml index 0deedc96fb2..40c3c6f3be3 100644
--- a/reference/mysqli/mysqli_stmt/next-result.xml
+++ b/reference/mysqli/mysqli_stmt/next-result.xml
@@ -46,6 +46,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
diff --git a/reference/mysqli/mysqli_stmt/prepare.xml \
b/reference/mysqli/mysqli_stmt/prepare.xml index 45be4691366..8691f79dce9 100644
--- a/reference/mysqli/mysqli_stmt/prepare.xml
+++ b/reference/mysqli/mysqli_stmt/prepare.xml
@@ -105,6 +105,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_stmt/result-metadata.xml \
b/reference/mysqli/mysqli_stmt/result-metadata.xml index 8e026c08209..2b91153957d \
100644
--- a/reference/mysqli/mysqli_stmt/result-metadata.xml
+++ b/reference/mysqli/mysqli_stmt/result-metadata.xml
@@ -69,6 +69,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
diff --git a/reference/mysqli/mysqli_stmt/store-result.xml \
b/reference/mysqli/mysqli_stmt/store-result.xml index bcaeba33423..92745737386 100644
--- a/reference/mysqli/mysqli_stmt/store-result.xml
+++ b/reference/mysqli/mysqli_stmt/store-result.xml
@@ -51,6 +51,11 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ &mysqli.conditionalexception;
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example>
--
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic