Files
doc-fr/reference/pgsql/functions/pg-set-error-verbosity.xml
George Peter Banyard 8e82164d85 Apply commit c2eca73ef79ebe78cebb34053e41b565af504c4f
[PHP 8.1] Use PgSql objects instead of resources
2021-10-16 20:03:39 +01:00

147 lines
4.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pg-set-error-verbosity" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pg_set_error_verbosity</refname>
<refpurpose>
Détermine la le degré des messages retournés par
<function>pg_last_error</function> et <function>pg_result_error</function>
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>pg_set_error_verbosity</methodname>
<methodparam choice="opt"><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
<methodparam><type>int</type><parameter>verbosity</parameter></methodparam>
</methodsynopsis>
<para>
Détermine la le degré des messages retournés par
<function>pg_last_error</function> et <function>pg_result_error</function>.
</para>
<para>
<function>pg_set_error_verbosity</function> fixe le degré d'erreur et
retourne le paramètre précédant de la connexion. Avec le mode
<constant>PGSQL_ERRORS_TERSE</constant>, les messages retournés inclus la
sévérité, le texte primaire et la position seulement; normalement, cela va
entrer sur une seule ligne. Le mode par défaut
(<constant>PGSQL_ERRORS_DEFAULT</constant>) produit des messages qui incluent
les messages ci-dessus et des détails, des astuces ou les champs en
contexte (ces messages peuvent être étendus sur plusieurs lignes). Le mode
<constant>PGSQL_ERRORS_VERBOSE</constant> tous les champs disponibles. Le
changement du degré des messages n'affecte pas les messages disponibles qui
proviennent des résultats déjà existants, mais seulement les messages des
résultats créés par la suite.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
&pgsql.parameter.connection-with-unspecified-default;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>verbosity</parameter></term>
<listitem>
<para>
Le degré de message d'erreur :
<constant>PGSQL_ERRORS_TERSE</constant>,
<constant>PGSQL_ERRORS_DEFAULT</constant>
ou <constant>PGSQL_ERRORS_VERBOSE</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Le degré de message d'erreur précédant :
<constant>PGSQL_ERRORS_TERSE</constant>,
<constant>PGSQL_ERRORS_DEFAULT</constant>
ou <constant>PGSQL_ERRORS_VERBOSE</constant>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&pgsql.changelog.connection-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>pg_set_error_verbosity</function></title>
<programlisting role="php">
<![CDATA[
<?php
$dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");
if (!pg_connection_busy($dbconn)) {
pg_send_query($dbconn, "select * from nexistepas;");
}
pg_set_error_verbosity($dbconn, PGSQL_ERRORS_VERBOSE);
$res1 = pg_get_result($dbconn);
echo pg_result_error($res1);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pg_last_error</function></member>
<member><function>pg_result_error</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->