Skip to content

[Sync-En] mysqli_stmt::$insert_id and finally: sync with doc-en #3690

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 1 commit into from
Oct 15, 2026
Merged

[Sync-En] mysqli_stmt::$insert_id and finally: sync with doc-en #3690

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions language/control-structures/finally.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 6af4cd5be387fcb28cabfca49f0d9109ebfc660f Maintainer: lacatoire Status: ready -->

<sect1 xml:id="control-structures.finally" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>finally</title>
Expand Down Expand Up @@ -27,15 +27,15 @@ function inverse($x) {

try {
echo inverse(5) . "\n";
} catch (\DivisionByZeroError $e) {
} catch (DivisionByZeroError $e) {
echo 'Erreur attrapée : ', $e->getMessage(), "\n";
} finally {
echo "Premier finally.\n";
}

try {
echo inverse(0) . "\n";
} catch (\DivisionByZeroError $e) {
} catch (DivisionByZeroError $e) {
echo 'Erreur attrapée : ', $e->getMessage(), "\n";
} finally {
echo "Second finally.\n";
Expand Down Expand Up @@ -250,7 +250,7 @@ function generate()
try {
yield 1;
yield 2;
} catch (\Exception $e) {
} catch (Exception $e) {
echo 'catch';
} finally {
echo "finally\n";
Expand Down Expand Up @@ -297,7 +297,7 @@ function generate()
try {
yield 1;
yield 2;
} catch (\Exception $e) {
} catch (Exception $e) {
echo 'catch';
} finally {
echo "finally\n";
Expand Down Expand Up @@ -454,7 +454,7 @@ function generate()
try {
yield 1;
yield 2;
} catch (\Exception $e) {
} catch (Exception $e) {
echo 'catch';
} finally {
echo "finally interne\n";
Expand Down
122 changes: 113 additions & 9 deletions reference/mysqli/mysqli_stmt/insert-id.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5d8dfb31071496ffd2d51609ba098e6c9a3ce0d2 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: aa135ef2689157299c23fd4b8eb8c4f70733deaa Maintainer: yannick Status: ready -->
<refentry xml:id="mysqli-stmt.insert-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysqli_stmt::$insert_id</refname>
<refname>mysqli_stmt_insert_id</refname>
<refpurpose>Récupère l'ID généré par la dernière requête INSERT</refpurpose>
<refpurpose>Retourne la valeur générée pour une colonne AUTO_INCREMENT par la dernière requête exécutée</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
Expand All @@ -18,11 +16,117 @@
<type class="union"><type>int</type><type>string</type></type><methodname>mysqli_stmt_insert_id</methodname>
<methodparam><type>mysqli_stmt</type><parameter>statement</parameter></methodparam>
</methodsynopsis>

&warn.undocumented.func;

<simpara>
Retourne l'ID généré par une requête <literal>INSERT</literal> ou
<literal>UPDATE</literal> sur une table avec une colonne ayant l'attribut
<literal>AUTO_INCREMENT</literal>. Dans le cas d'une requête
<literal>INSERT</literal> multilignes, elle retourne la première valeur
générée automatiquement qui a été insérée avec succès. Si
<literal>LAST_INSERT_ID(expr)</literal> est utilisé pour définir la valeur
de <literal>AUTO_INCREMENT</literal>, ou dans une requête
<literal>UPDATE</literal>, la valeur de <literal>expr</literal> est
retournée à la place.
</simpara>
<simpara>
Retourne <literal>0</literal> si la requête n'a pas modifié de valeur
<literal>AUTO_INCREMENT</literal>.
</simpara>
</refsect1>


<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
&mysqli.stmt.description;
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
La valeur du champ <literal>AUTO_INCREMENT</literal> modifié par la
requête. Retourne zéro si la requête n'a pas encore été exécutée ou si
elle n'a pas modifié de valeur <literal>AUTO_INCREMENT</literal>.
</simpara>
<simpara>
La valeur est propre à l'objet de requête. Elle n'est pas affectée par les
autres requêtes exécutées sur la même connexion après cette requête, ni
par les requêtes émises via d'autres connexions ou clients.
</simpara>
<note>
<simpara>
Si le nombre est plus grand que la valeur maximale d'un entier, il sera
retourné sous forme de &string;.
</simpara>
</note>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Exemple avec <varname>mysqli_stmt::$insert_id</varname></title>
<simpara>&style.oop;</simpara>
<programlisting role="php">
<![CDATA[
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

$mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City");

$stmt = $mysqli->prepare("INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)");

$name = 'Stuttgart';
$countryCode = 'DEU';
$district = 'Stuttgart';
$population = 617000;
$stmt->bind_param('sssi', $name, $countryCode, $district, $population);
$stmt->execute();

printf("Le nouvel enregistrement a l'ID %d.\n", $stmt->insert_id);
]]>
</programlisting>
<simpara>&style.procedural;</simpara>
<programlisting role="php">
<![CDATA[
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City");

$stmt = mysqli_prepare($link, "INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)");

$name = 'Stuttgart';
$countryCode = 'DEU';
$district = 'Stuttgart';
$population = 617000;
mysqli_stmt_bind_param($stmt, 'sssi', $name, $countryCode, $district, $population);
mysqli_stmt_execute($stmt);

printf("Le nouvel enregistrement a l'ID %d.\n", mysqli_stmt_insert_id($stmt));
]]>
</programlisting>
&examples.outputs;
<screen>
<![CDATA[
Le nouvel enregistrement a l'ID 1.
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;

<simplelist>
<member><function>mysqli_insert_id</function></member>
<member><function>mysqli_stmt_affected_rows</function></member>
<member><function>mysqli_stmt_execute</function></member>
</simplelist>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Expand Down
Loading