# php_manual

id: openssl_pbkdf2
type: function
doc:
<comment>Description:</comment>
  Génère une chaîne PKCS5 v2 PBKDF2
  
  <strong>openssl_pbkdf2()</strong> calcule PBKDF2 (Password-Based Key Derivation Function 2), une fonction de
  dérivation de clé définit dans PKCS5 v2.

<comment>Param:</comment>
  <info>string</info>  <strong>$password</strong>     Mot de passe depuis lequel la clé dérivé est générée.
  <info>string</info>  <strong>$salt</strong>         PBKDF2 recommande un sel cryptographique d'au moins 64 bits (8 octets).
  <info>int</info>     <strong>$key_length</strong>   Longueur désirée de la clé de sortie.
  <info>int</info>     <strong>$iterations</strong>   Le nombre d'itérations désiré. NIST  recommande au moins 10 000.
  <info>string</info>  <strong>$digest_algo</strong>  Algorithme de hachage ou de digest optionnel à partir de
                        <strong>openssl_get_md_methods()</strong>.  Par défaut SHA-1.

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne binaire brute ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>hash_pbkdf2()</strong>
   * <strong>openssl_get_md_methods()</strong>


id: openssl_pkcs12_export
type: function
doc:
<comment>Description:</comment>
  Exporte un certificat compatible PKCS#12 dans une variable
  
  <strong>openssl_pkcs12_export()</strong> stocke un certificat <strong>$certificate</strong> dans une chaîne nommée <strong>$output</strong> dans un
  format PKCS#12.

<comment>Param:</comment>
  <info></info>                                                      <strong>$x509</strong>         Voir les paramètres
                                                                      clés/Certificats pour une
                                                                      liste de valeurs valides.
  <info>string</info>                                                <strong>$output</strong>       En cas de succès, cette
                                                                      variable contiendra le
                                                                      PKCS#12.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>  Clé privée du fichier PKCS#12.
                                                                      Consultez Public/Private Key
                                                                      Parameters pour obtenir la
                                                                      liste des valeurs valides.
  <info>string</info>                                                <strong>$passphrase</strong>   Mot de passe de chiffrement
                                                                      pour déverrouiller le fichier
                                                                      PKCS#12.
  <info>array</info>                                                 <strong>$options</strong>      Tableau optionnel, les autres
                                                                      clés seront ignorées.
                                                                      CléDescription<return>"extracerts"</return>Tableau
                                                                      de certificats supplémentaires
                                                                      ou d'un certificat unique à
                                                                      inclure dans le fichier
                                                                      PKCS#12.<return>"friendly_name"</return>chaîne
                                                                      à utiliser pour le certificat
                                                                      et la clé fournis

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkcs12_export_to_file
type: function
doc:
<comment>Description:</comment>
  Exporte un certificat compatible PKCS#12
  
  <strong>openssl_pkcs12_export_to_file()</strong> stocke un certificat <strong>$certificate</strong> dans un fichier nommé
  <strong>$output_filename</strong> dans un format de fichier PKCS#12.

<comment>Param:</comment>
  <info></info>                                                      <strong>$x509</strong>             Voir les paramètres
                                                                          clés/Certificats pour une
                                                                          liste de valeurs valides.
  <info>string</info>                                                <strong>$output_filename</strong>  Chemin vers le fichier de
                                                                          sortie.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>      Clé privée du fichier
                                                                          PKCS#12. Voir paramètres
                                                                          Clé/Certificat pour une
                                                                          liste de valeur valide.
  <info>string</info>                                                <strong>$passphrase</strong>       Mot de passe de
                                                                          chiffrement pour
                                                                          déverrouiller le fichier
                                                                          PKCS#12.
  <info>array</info>                                                 <strong>$options</strong>          Tableau optionnel, les
                                                                          autres clés seront
                                                                          ignorées.
                                                                          KeyDescription<return>"extracerts"</return>
                                                                          tableau de certificats
                                                                          supplémentaire ou un
                                                                          certificat unique à
                                                                          inclure dans le fichier
                                                                          PKCS#12.<return>"friendly_name"</return>chaîne
                                                                          de caractères à utiliser
                                                                          pour le certificat et la
                                                                          clé fournit

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkcs12_read
type: function
doc:
<comment>Description:</comment>
  Lit un certificat PKCS#12 dans un tableau
  
  <strong>openssl_pkcs12_read()</strong> lit le certificat PKCS#12 fourni par le paramètre <strong>$pkcs12</strong> dans un tableau
  nommé <strong>$certificates</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$pkcs12</strong>        Le contenu du magasin de certificats, pas son nom de fichier.
  <info>array</info>   <strong>$certificates</strong>  En cas de succès, ce tableau contiendra les données du certificat.
  <info>string</info>  <strong>$passphrase</strong>    Mot de passe de chiffrement pour déverrouiller le fichier PKCS#12.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkcs7_decrypt
type: function
doc:
<comment>Description:</comment>
  Déchiffre un message S/MIME
  
  Déchiffre le message S/MIME contenu dans le fichier <strong>$input_filename</strong>, en utilisant le certificat et
  la clé privée associé par <strong>$certificate</strong> et <strong>$private_key</strong>.

<comment>Param:</comment>
  <info>string</info>                                                     <strong>$input_filename</strong>   
  <info>string</info>                                                     <strong>$output_filename</strong>  Le message déchiffré
                                                                               est écrit dans le
                                                                               fichier spécifié par
                                                                               ce paramètre.
  <info>OpenSSLCertificate|string</info>                                  <strong>$certificate</strong>      
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string|null</info>  <strong>$private_key</strong>      

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkcs7_encrypt
type: function
doc:
<comment>Description:</comment>
  Chiffre un message S/MIME
  
  <strong>openssl_pkcs7_encrypt()</strong> prend le contenu du fichier <strong>$input_filename</strong> et le chiffre en utilisant un
  chiffrement RC2 à 40-bit, de manière que le message ne puisse être lu que par le possesseur de
  <strong>$certificate</strong>.

<comment>Param:</comment>
  <info>string</info>                           <strong>$input_filename</strong>   
  <info>string</info>                           <strong>$output_filename</strong>  
  <info>OpenSSLCertificate|array|string</info>  <strong>$certificate</strong>      Soit un certificat X.509, soit un tableau de
                                                     certificats X.509.
  <info>array|null</info>                       <strong>$headers</strong>          <strong>$headers</strong> est un tableau d'en-têtes qui seront
                                                     ajoutés en tête de message, une fois que les
                                                     données auront été chiffrées.
                                                     
                                                     <strong>$headers</strong> peut être un tableau associatif, dont
                                                     les clés sont les noms d'en-tête, ou bien un
                                                     tableau indexé dont chaque ligne contient un
                                                     en-tête complet.
  <info>int</info>                              <strong>$flags</strong>            <strong>$flags</strong> peut être utilisé pour spécifier des
                                                     options qui affecteront le chiffrement (voir
                                                     les constantes PKCS7).
  <info>int</info>                              <strong>$cipher_algo</strong>      Une des constantes cipher.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkcs7_read
type: function
doc:
<comment>Description:</comment>
  Exporte le fichier PKCS7 vers un tableau de certificats PEM
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>          La chaîne de donnée qui doit être analysé (au format p7b).
  <info>array</info>   <strong>$certificates</strong>  Un tableau de certificats PEM depuis les données d'entrées p7b.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_csr_sign()</strong>


id: openssl_pkcs7_sign
type: function
doc:
<comment>Description:</comment>
  Signe un message S/MIME
  
  <strong>openssl_pkcs7_sign()</strong> prend le contenu du fichier <strong>$input_filename</strong> et le signe en utilisant le
  certificat et la clé privée contenus dans les arguments <strong>$certificate</strong> et <strong>$private_key</strong>.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$input_filename</strong>                   Le fichier
                                                                                          d'entrée
                                                                                          que vous
                                                                                          avez
                                                                                          l'intention
                                                                                          de signer
                                                                                          numériquement.
  <info>string</info>                                                <strong>$output_filename</strong>                  Le fichier
                                                                                          où la
                                                                                          signature
                                                                                          numérique
                                                                                          sera
                                                                                          écrite.
  <info>OpenSSLCertificate|string</info>                             <strong>$certificate</strong>                      Le
                                                                                          certificat
                                                                                          X.509
                                                                                          utilisé
                                                                                          pour
                                                                                          signer
                                                                                          numériquement
                                                                                          <strong>$input_filename</strong>.
                                                                                          Voir
                                                                                          paramètres
                                                                                          Clé/Certificat
                                                                                          pour une
                                                                                          liste de
                                                                                          valeur
                                                                                          valide.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>                      
                                                                                          <strong>$private_key</strong>
                                                                                          est la clé
                                                                                          privée
                                                                                          correspondant
                                                                                          à
                                                                                          <strong>$certificate</strong>.
                                                                                          Voir
                                                                                          paramètres
                                                                                          Clé
                                                                                          Publique/Privée
                                                                                          pour une
                                                                                          liste de
                                                                                          valeur
                                                                                          valide.
  <info>array|null</info>                                            <strong>$headers</strong>                          <strong>$headers</strong>
                                                                                          est un
                                                                                          tableau
                                                                                          d'en-têtes
                                                                                          qui seront
                                                                                          ajoutés
                                                                                          aux
                                                                                          données
                                                                                          chiffrées
                                                                                          (voir la
                                                                                          fonction
                                                                                          <strong>openssl_pkcs7_encrypt()</strong>
                                                                                          pour plus
                                                                                          de détails
                                                                                          sur le
                                                                                          format du
                                                                                          paramètre).
  <info>int</info>                                                   <strong>$flags</strong>                            <strong>$flags</strong>
                                                                                          peut être
                                                                                          utilisé
                                                                                          pour
                                                                                          modifier
                                                                                          la sortie.
                                                                                          Voir les
                                                                                          constantes
                                                                                          PKCS7.
  <info>string|null</info>                                           <strong>$untrusted_certificates_filename</strong>  
                                                                                          <strong>$untrusted_certificates_filename</strong>
                                                                                          spécifie
                                                                                          le nom du
                                                                                          fichier
                                                                                          contenant
                                                                                          un
                                                                                          ensemble
                                                                                          de
                                                                                          certificats
                                                                                          supplémentaires
                                                                                          à inclure
                                                                                          dans la
                                                                                          signature,
                                                                                          qui
                                                                                          pourront
                                                                                          aider le
                                                                                          destinataire
                                                                                          à vérifier
                                                                                          les
                                                                                          données
                                                                                          que vous
                                                                                          utilisez.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkcs7_verify
type: function
doc:
<comment>Description:</comment>
  Vérifie la signature d'un message S/MIME
  
  <strong>openssl_pkcs7_verify()</strong> lit le message S/MIME contenu dans le fichier <strong>$filename</strong> et examine la
  signature digitale.

<comment>Param:</comment>
  <info>string</info>       <strong>$input_filename</strong>                   Chemin vers le message.
  <info>int</info>          <strong>$flags</strong>                            <strong>$flags</strong> sert à modifier la façon dont la signature
                                                 est vérifiée. Voyez les constantes PKCS7. Par
                                                 défaut, la valeur est : PKCS7_DETACHED.
  <info>string|null</info>  <strong>$signers_certificates_filename</strong>    Si le paramètre <strong>$signers_certificates_filename</strong> est
                                                 spécifié, il doit être une chaîne contenant le nom
                                                 d'un fichier qui contient le certificat du
                                                 signataire, au format PEM.
  <info>array</info>        <strong>$ca_info</strong>                          Si le paramètre <strong>$ca_info</strong> est spécifié, il doit
                                                 contenir les informations sur les tiers de
                                                 certificats de confiance utilisé lors de la
                                                 vérification. Voyez vérification des certificats
                                                 pour plus de détails.
  <info>string|null</info>  <strong>$untrusted_certificates_filename</strong>  Si le paramètre <strong>$untrusted_certificates_filename</strong>
                                                 est spécifié, il doit représenter le nom d'un
                                                 fichier contenant un ensemble de certificats
                                                 utilisés comme certificats de peu de confiance.
  <info>string|null</info>  <strong>$content</strong>                          Vous pouvez spécifier un nom de fichier avec le
                                                 paramètre <strong>$content</strong> qui peut être remplit avec les
                                                 données vérifiées, mais avec les informations de
                                                 signature.
  <info>string|null</info>  <strong>$output_filename</strong>                  

<comment>Return:</comment>
  <info>bool|int</info>  Retourne <info>true</info> si la signature est vérifiée, et <info>false</info> sinon (le message a été modifié, ou
            bien le certificat de signature est invalide) ou -1 si une erreur survient.


id: openssl_pkey_derive
type: function
doc:
<comment>Description:</comment>
  Computes shared secret for public value of remote and local DH or ECDH key
  
  <strong>openssl_pkey_derive()</strong> takes a set of a <strong>$public_key</strong> and <strong>$private_key</strong> and derives a shared secret,
  for either DH or EC keys.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$public_key</strong>   <strong>$public_key</strong> is the public key
                                                                      for the derivation. See
                                                                      Public/Private Key parameters
                                                                      for a list of valid values.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>  <strong>$private_key</strong> is the private
                                                                      key for the derivation. See
                                                                      Public/Private Key parameters
                                                                      for a list of valid values.
  <info>int</info>                                                   <strong>$key_length</strong>   If not zero, will set the
                                                                      desired length of the derived
                                                                      secret.

<comment>Return:</comment>
  <info>string|false</info>  The derived secret on success ou <info>false</info> si une erreur survient.


id: openssl_pkey_export
type: function
doc:
<comment>Description:</comment>
  Stocke une représentation exportable de la clé dans une chaîne de caractères
  
  <strong>openssl_pkey_export()</strong> exporte la clé <strong>$key</strong> sous forme de chaîne au format PEM, et la stocke dans la
  variable <strong>$output</strong> (qui est passée par référence).
  
  Vous devez avoir un fichier openssl.cnf valide et installé pour que cette fonction opère
  correctement. Voir les notes se trouvant dans la section concernant l'installation pour plus
  d'informations.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$key</strong>         
  <info>string</info>                                                <strong>$output</strong>      
  <info>string|null</info>                                           <strong>$passphrase</strong>  La clé est éventuellement
                                                                     protégée par le mot de passe
                                                                     <strong>$passphrase</strong>.
  <info>array|null</info>                                            <strong>$options</strong>     <strong>$options</strong> peut être utilisé pour
                                                                     calibrer le processus
                                                                     d'exportation en spécifiant ou
                                                                     remplaçant les options du
                                                                     fichier de configuration
                                                                     d'OpenSSl. Voyez
                                                                     <strong>openssl_csr_new()</strong>  pour plus
                                                                     d'informations sur <strong>$options</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkey_export_to_file
type: function
doc:
<comment>Description:</comment>
  Sauve une clé au format ASCII dans un fichier
  
  <strong>openssl_pkey_export_to_file()</strong> sauve la clé au format ASCII (PEM) <strong>$key</strong> dans le fichier
  <strong>$output_filename</strong>.
  
  Vous devez avoir un fichier openssl.cnf valide et installé pour que cette fonction opère
  correctement. Voir les notes se trouvant dans la section concernant l'installation pour plus
  d'informations.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$key</strong>              
  <info>string</info>                                                <strong>$output_filename</strong>  Chemin du fichier de
                                                                          sortie.
  <info>string|null</info>                                           <strong>$passphrase</strong>       La clé peut éventuellement
                                                                          être protégée par un <strong>$mot
                                                                          de passe</strong>.
  <info>array|null</info>                                            <strong>$options</strong>          <strong>$options</strong> peut être utilisé
                                                                          pour calibrer le processus
                                                                          d'exportation en
                                                                          spécifiant ou remplaçant
                                                                          les options du fichier de
                                                                          configuration d'OpenSSl.
                                                                          Voyez <strong>openssl_csr_new()</strong>
                                                                          pour plus d'informations
                                                                          sur <strong>$options</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_pkey_free
type: function
doc:
<comment>Description:</comment>
  Libère une clé privée
  
  Cette fonction n'a aucun effet. Antérieur à PHP 8.0.0, cette fonction était utilisé pour fermer
  une ressource.
  
  Libère une clé privée créée par la fonction <strong>openssl_pkey_new()</strong>.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey</info>  <strong>$key</strong>  Ressource représentant la clé.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.


id: openssl_pkey_get_details
type: function
doc:
<comment>Description:</comment>
  Retourne un tableau contenant les détails de la clé
  
  Cette fonction retourne les détails de la clé (bits, key, type).

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey</info>  <strong>$key</strong>  Ressource contenant la clé.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau avec les détails de la clé en cas de succès, ou <info>false</info> en cas
               d'échec. Le tableau retourné contient les index <return>bits</return> (nombre de bits), <return>key</return>
               (représentation sous forme de chaîne de caractères de la clé publique) et <return>type</return> (type
               de clé qui est l'un de <info>OPENSSL_KEYTYPE_RSA</info>, <info>OPENSSL_KEYTYPE_DSA</info>, <info>OPENSSL_KEYTYPE_DH</info>,
               <info>OPENSSL_KEYTYPE_EC</info> ou -1, signifiant "inconnu").
               
               En fonction du type de clés utilisées, des détails supplémentaires peuvent être
               retournés. Notez que quelques éléments peuvent ne pas être toujours disponibles.
               
               <info>OPENSSL_KEYTYPE_RSA</info>, une clé de tableau additionnelle appelée <return>"rsa"</return>,  contenant la
               donnée de clé est retournée
               
               <info>OPENSSL_KEYTYPE_DSA</info>, une clé de tableau additionnelle appelée <return>"dsa"</return>,  contenant la
               donnée de clé est retournée
               
               <info>OPENSSL_KEYTYPE_DH</info>, une clé de tableau additionnelle appelée <return>"dh"</return>,  contenant la
               donnée de clé est retournée.
               
               <info>OPENSSL_KEYTYPE_EC</info>, une clé de tableau additionnelle nommé <return>"ec"</return>, contenant les
               données de la clé est retourné.


id: openssl_pkey_get_private
type: function
doc:
<comment>Description:</comment>
  Lit une clé privée
  
  <strong>openssl_pkey_get_private()</strong> analyse la clé <strong>$private_key</strong> et la prépare pour être utilisée par
  d'autres fonctions.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>  <strong>$private_key</strong> peut être l'une
                                                                      des valeurs suivantes :  une
                                                                      chaîne au format
                                                                      file://path/to/file.pem. Le
                                                                      fichier ainsi désigné doit
                                                                      contenir une clé privée ou un
                                                                      certificat au format PEM
                                                                      (éventuellement les deux).
                                                                      Une clé privée au format PEM.
                                                                      
                                                                      une chaîne au format
                                                                      file://path/to/file.pem. Le
                                                                      fichier ainsi désigné doit
                                                                      contenir une clé privée ou un
                                                                      certificat au format PEM
                                                                      (éventuellement les deux).
                                                                      
                                                                      Une clé privée au format PEM.
  <info>string|null</info>                                           <strong>$passphrase</strong>   Le paramètre optionnel
                                                                      <strong>$passphrase</strong> doit être utilisé
                                                                      si la clé spécifiée est
                                                                      chiffrée (protégée par un mot
                                                                      de passe).

<comment>Return:</comment>
  <info>OpenSSLAsymmetricKey|false</info>  Retourne une instance de <class>OpenSSLAsymmetricKey</class> cas de succès, ou <info>false</info>
                              si une erreur survient.


id: openssl_pkey_get_public
type: function
doc:
<comment>Description:</comment>
  Extrait une clé publique d'un certificat, et la prépare
  
  <strong>openssl_pkey_get_public()</strong> extrait la clé publique du certificat <strong>$public_key</strong> et la prépare pour
  être utilisée par les autres fonctions.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$public_key</strong>  <strong>$public_key</strong> peut avoir l'une
                                                                     des valeurs suivantes :  Une
                                                                     instance de
                                                                     <class>OpenSSLAsymmetricKey</class>.  Une
                                                                     chaîne au format
                                                                     file://path/to/file.pem. Le
                                                                     fichier ainsi désigné doit
                                                                     contenir une clé publique ou un
                                                                     certificat au format PEM
                                                                     (éventuellement les deux).  Une
                                                                     clé publique au format PEM.
                                                                     
                                                                     Une instance de
                                                                     <class>OpenSSLAsymmetricKey</class>.
                                                                     
                                                                     Une chaîne au format
                                                                     file://path/to/file.pem. Le
                                                                     fichier ainsi désigné doit
                                                                     contenir une clé publique ou un
                                                                     certificat au format PEM
                                                                     (éventuellement les deux).
                                                                     
                                                                     Une clé publique au format PEM.

<comment>Return:</comment>
  <info>OpenSSLAsymmetricKey|false</info>  Retourne une instance de <class>OpenSSLAsymmetricKey</class> en cas de succès, ou
                              <info>false</info> si une erreur survient.


id: openssl_pkey_new
type: function
doc:
<comment>Description:</comment>
  Génère une nouvelle clé privée
  
  <strong>openssl_pkey_new()</strong> génère une nouvelle clé privée. Comment obtenir le composant publique de la clé
  est démontré dans un exemple ci-dessous.
  
  Vous devez avoir un fichier openssl.cnf valide et installé pour que cette fonction opère
  correctement. Voir les notes se trouvant dans la section concernant l'installation pour plus
  d'informations.

<comment>Param:</comment>
  <info>array|null</info>  <strong>$options</strong>  Vous pouvez calibrer la génération de la clé (comme le nombre de  bits) en
                        utilisant le paramètre <strong>$options</strong>. Voir la fonction <strong>openssl_csr_new()</strong> pour
                        plus de détails sur  <strong>$options</strong>.

<comment>Return:</comment>
  <info>OpenSSLAsymmetricKey|false</info>  Retourne une instance de <class>OpenSSLAsymmetricKey</class> en cas de succès, <info>false</info>
                              en cas d'erreur.


id: openssl_private_decrypt
type: function
doc:
<comment>Description:</comment>
  Déchiffre des données avec une clé privée
  
  <strong>openssl_private_decrypt()</strong> déchiffre <strong>$data</strong> qui a été chiffrée précédemment avec
  <strong>openssl_public_encrypt()</strong>, puis stocke le résultat dans la variable <strong>$decrypted_data</strong>.
  
  Vous pouvez utiliser cette fonction, par exemple pour déchiffrer des données  qui ne sont censées
  être disponibles que pour vous.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$data</strong>            
  <info>string</info>                                                <strong>$decrypted_data</strong>  
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>     <strong>$private_key</strong> doit être la
                                                                         clé privée utilisée pour
                                                                         chiffrer les données.
  <info>int</info>                                                   <strong>$padding</strong>         <strong>$padding</strong> peut être
                                                                         <info>OPENSSL_PKCS1_PADDING</info>,
                                                                         <info>OPENSSL_SSLV23_PADDING</info>,
                                                                         <info>OPENSSL_PKCS1_OAEP_PADDING</info>
                                                                         ou <info>OPENSSL_NO_PADDING</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_public_encrypt()</strong>
   * <strong>openssl_public_decrypt()</strong>


id: openssl_private_encrypt
type: function
doc:
<comment>Description:</comment>
  Chiffre des données avec une clé privée
  
  <strong>openssl_private_encrypt()</strong> chiffre les données <strong>$data</strong> avec la clé privée <strong>$private_key</strong> et stocke le
  résultat dans <strong>$encrypted_data</strong>. Les données chiffrées peuvent être déchiffrées avec la fonction
  <strong>openssl_public_decrypt()</strong>.
  
  Cette fonction peut être utilisée pour signer les données (ou leurs chiffrements) pour prouver
  qu'elles n'ont pas été écrites par une autre personne.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$data</strong>            
  <info>string</info>                                                <strong>$encrypted_data</strong>  
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>     
  <info>int</info>                                                   <strong>$padding</strong>         Le paramètre <strong>$padding</strong> peut
                                                                         être <info>OPENSSL_PKCS1_PADDING</info>
                                                                         ou <info>OPENSSL_NO_PADDING</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_public_encrypt()</strong>
   * <strong>openssl_public_decrypt()</strong>


id: openssl_public_decrypt
type: function
doc:
<comment>Description:</comment>
  Déchiffre des données avec une clé publique
  
  <strong>openssl_public_decrypt()</strong> déchiffre les données <strong>$data</strong> qui ont été chiffrées avec la fonction
  <strong>openssl_private_encrypt()</strong> et stocke le résultat dans <strong>$decrypted_data</strong>.
  
  Vous pouvez utiliser cette fonction pour vérifier si le message a été écrit par le propriétaire de
  la clé privée.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$data</strong>            
  <info>string</info>                                                <strong>$decrypted_data</strong>  
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$public_key</strong>      <strong>$public_key</strong> doit être la
                                                                         clé publique qui a été
                                                                         utilisée pour chiffrer les
                                                                         données.
  <info>int</info>                                                   <strong>$padding</strong>         <strong>$padding</strong> peut être
                                                                         <info>OPENSSL_PKCS1_PADDING</info> ou
                                                                         <info>OPENSSL_NO_PADDING</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_private_encrypt()</strong>
   * <strong>openssl_private_decrypt()</strong>


id: openssl_public_encrypt
type: function
doc:
<comment>Description:</comment>
  Chiffre des données avec une clé publique
  
  <strong>openssl_public_encrypt()</strong> chiffre les données <strong>$data</strong> avec la clé publique <strong>$public_key</strong> et stocke le
  résultat dans <strong>$encrypted_data</strong>. Les données chiffrées peuvent être déchiffrées avec la fonction
  <strong>openssl_private_decrypt()</strong>.
  
  Cette fonction peut être utilisée pour chiffrer un message qui pourra être lu uniquement par le
  propriétaire de la clé privée. Elle peut être également utilisée pour stocker des données
  sécurisées dans une base de données.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$data</strong>            
  <info>string</info>                                                <strong>$encrypted_data</strong>  Contiendra le résultat du
                                                                         chiffrage.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$public_key</strong>      La clé publique.
  <info>int</info>                                                   <strong>$padding</strong>         <strong>$padding</strong> peut être
                                                                         <info>OPENSSL_PKCS1_PADDING</info>,
                                                                         <info>OPENSSL_SSLV23_PADDING</info>,
                                                                         <info>OPENSSL_PKCS1_OAEP_PADDING</info>
                                                                         ou <info>OPENSSL_NO_PADDING</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_private_encrypt()</strong>
   * <strong>openssl_private_decrypt()</strong>


id: openssl_random_pseudo_bytes
type: function
doc:
<comment>Description:</comment>
  Génère une chaine pseudo-aléatoire d'octets
  
  Génère une chaîne de caractères pseudo-aléatoire d'octets, dont la longueur est spécifiée par le
  paramètre <strong>$length</strong>.
  
  Indique également si l'algorithme fort de cryptologie a été utilisé pour produire ces octets
  pseudo-aléatoires, en utilisant le paramètre <strong>$strong_result</strong>.

<comment>Param:</comment>
  <info>int</info>   <strong>$length</strong>         La taille désirée pour la chaine d'octets. Doit être un nombre entier
                        positif inférieur ou égal à <return>2147483647</return>. PHP va tenter de transtyper ce
                        paramètre en un entier non nul pour l'utiliser.
  <info>bool</info>  <strong>$strong_result</strong>  Si fourni, détermine si l'algorithme de cryptologie utilisé était
                        cryptographiquement fort, i.e. sécurisé pour être utilisé avec GPG, les mots
                        de passe, etc. <info>true</info> si il l'est, <info>false</info> sinon.

<comment>Return:</comment>
  <info>string</info>  Retourne la chaine d'octets générée.

<comment>See Also:</comment>
   * <strong>random_bytes()</strong>
   * <strong>bin2hex()</strong>
   * <strong>crypt()</strong>
   * <strong>random_int()</strong>


id: openssl_seal
type: function
doc:
<comment>Description:</comment>
  Scelle des données
  
  <strong>openssl_seal()</strong> scelle (chiffre) les données <strong>$data</strong> en utilisant la <strong>$cipher_algo</strong> fournit avec une
  clé secrète générée aléatoirement. La clé est chiffrée avec chaque clé publique associée à
  <strong>$public_key</strong> et chaque clé ainsi chiffrée est retournée dans <strong>$encrypted_keys</strong>. Cela signifie que
  vous pouvez envoyer des données scellées à plusieurs destinataires (en supposant que chacun ait
  reçu la clé publique). Chaque destinataire doit recevoir les données chiffrées et la clé
  d'enveloppe, qui a été chiffrée avec la clé publique du destinataire.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>            Les données à sceller
  <info>string</info>  <strong>$sealed_data</strong>     Les données scellées.
  <info>array</info>   <strong>$encrypted_keys</strong>  Tableau des clés chiffrées.
  <info>array</info>   <strong>$public_key</strong>      Tableau d'instances <class>OpenSSLAsymmetricKey</class> contenant les clés publiques.
  <info>string</info>  <strong>$cipher_algo</strong>     La méthode de chiffrement.  La valeur par défaut (<return>'RC4'</return>) est considéré
                           non-sécurisé. Il est vivement recommandé de spécifier explicitement une
                           méthode de chiffrement sûr.
                           
                           La valeur par défaut (<return>'RC4'</return>) est considéré non-sécurisé. Il est vivement
                           recommandé de spécifier explicitement une méthode de chiffrement sûr.
  <info>string</info>  <strong>$iv</strong>              Le vecteur d'initialisation.

<comment>Return:</comment>
  <info>int|false</info>  Retourne la longueur des données scellées en cas de succès, et <info>false</info> sinon. En cas de
             succès, les données scellées sont placées dans le paramètre <strong>$sealed_data</strong>, et les clés
             d'enveloppe dans <strong>$encrypted_keys</strong>.

<comment>See Also:</comment>
   * <strong>openssl_open()</strong>


id: openssl_sign
type: function
doc:
<comment>Description:</comment>
  Signe les données
  
  <strong>openssl_sign()</strong> calcule la signature des données <strong>$data</strong> en générant une signature digitale
  cryptographique en utilisant la clé privée associée avec le paramètre <strong>$private_key</strong>. Notez que les
  données elles-mêmes ne sont pas chiffrées.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$data</strong>         La chaîne de données que vous
                                                                      souhaitez signer.
  <info>string</info>                                                <strong>$signature</strong>    Si l'appel à la fonction est
                                                                      un succès, la signature sera
                                                                      retournée dans le paramètre
                                                                      <strong>$signature</strong>.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>  <class>OpenSSLAsymmetricKey</class> - une
                                                                      clé, retournée par la fonction
                                                                      <strong>openssl_get_privatekey()</strong>
                                                                      
                                                                      <info>string</info> - une clé au format
                                                                      PEM.
  <info>string|int</info>                                            <strong>$algorithm</strong>    <info>int</info> - une des signatures
                                                                      d'algorithmes.
                                                                      
                                                                      <info>string</info> - une chaîne valide
                                                                      retournée par la fonction
                                                                      <strong>openssl_get_md_methods()</strong>, par
                                                                      exemple :
                                                                      "sha256WithRSAEncryption" ou
                                                                      "sha384".

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_verify()</strong>


id: openssl_spki_export
type: function
doc:
<comment>Description:</comment>
  Exporte un PEM valide formaté comme une clé publique signée
  
  Exporte un PEM valide formaté comme une clé publique signée.

<comment>Param:</comment>
  <info>string</info>  <strong>$spki</strong>  Une clé publique signée valide

<comment>Return:</comment>
  <info>string|false</info>  Retourne le PEM associé formaté en clé publique, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_spki_new()</strong>
   * <strong>openssl_spki_verify()</strong>
   * <strong>openssl_spki_export_challenge()</strong>
   * <strong>openssl_get_md_methods()</strong>
   * <strong>openssl_csr_new()</strong>
   * <strong>openssl_csr_sign()</strong>


id: openssl_spki_export_challenge
type: function
doc:
<comment>Description:</comment>
  Exporte le challenge associé avec la clé publique signée
  
  Exporte le challenge associé avec la clé publique signée.

<comment>Param:</comment>
  <info>string</info>  <strong>$spki</strong>  Une clé publique signée valide

<comment>Return:</comment>
  <info>string|false</info>  Retourne le challenge associé sous la forme d'une chaîne de caractères ou <info>false</info> en
                cas d'échec.

<comment>See Also:</comment>
   * <strong>openssl_spki_new()</strong>
   * <strong>openssl_spki_verify()</strong>
   * <strong>openssl_spki_export()</strong>
   * <strong>openssl_get_md_methods()</strong>
   * <strong>openssl_csr_new()</strong>
   * <strong>openssl_csr_sign()</strong>


id: openssl_spki_new
type: function
doc:
<comment>Description:</comment>
  Génère une clé publique signée et effectue un challenge
  
  Génère une clé publique signée en utilisant un algorithme de hachage spécifié.

<comment>Param:</comment>
  <info>OpenSSLAsymmetricKey</info>  <strong>$private_key</strong>  <strong>$private_key</strong> doit être une clé privée qui a été précédemment
                                      générée par la fonction <strong>openssl_pkey_new()</strong> (ou sinon, obtenu
                                      depuis une fonction de la famille openssl_pkey). La portion
                                      publique de la clé sera utilisée pour signer le CSR.
  <info>string</info>                <strong>$challenge</strong>    Le challenge associé à associer avec le SPKAC
  <info>int</info>                   <strong>$digest_algo</strong>  L'algorithme digest. Voir openssl_get_md_method().

<comment>Return:</comment>
  <info>string|false</info>  Retourne une clé publique signée sous la forme d'une chaîne de caractères ou <info>false</info>
                en cas d'échec.

<comment>See Also:</comment>
   * <strong>openssl_spki_verify()</strong>
   * <strong>openssl_spki_export_challenge()</strong>
   * <strong>openssl_spki_export()</strong>
   * <strong>openssl_get_md_methods()</strong>
   * <strong>openssl_csr_new()</strong>
   * <strong>openssl_csr_sign()</strong>


id: openssl_spki_verify
type: function
doc:
<comment>Description:</comment>
  Vérifie une clé publique signée, et effectue un challenge
  
  Vérifie une clé publique signée, et effectue un challenge.

<comment>Param:</comment>
  <info>string</info>  <strong>$spki</strong>  Une clé publique signée valide

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_spki_new()</strong>
   * <strong>openssl_spki_export_challenge()</strong>
   * <strong>openssl_spki_export()</strong>
   * <strong>openssl_get_md_methods()</strong>
   * <strong>openssl_csr_new()</strong>
   * <strong>openssl_csr_sign()</strong>


id: openssl_verify
type: function
doc:
<comment>Description:</comment>
  Vérifie une signature
  
  <strong>openssl_verify()</strong> vérifie que la signature <strong>$signature</strong> est correcte pour les données <strong>$data</strong>, et avec
  la clé publique <strong>$public_key</strong>. Cette clé doit être la clé publique correspondant à la clé privée
  utilisée lors de la signature.

<comment>Param:</comment>
  <info>string</info>                                                <strong>$data</strong>        La chaîne de données utilisé
                                                                     pour générer la signature
  <info>string</info>                                                <strong>$signature</strong>   Une chaîne brute binaire,
                                                                     générée par la fonction
                                                                     <strong>openssl_sign()</strong> ou signification
                                                                     similaire
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$public_key</strong>  <class>OpenSSLAsymmetricKey</class> - une clé,
                                                                     retourné par la fonction
                                                                     <strong>openssl_get_publickey()</strong>
                                                                     
                                                                     <info>string</info> - une clé au format PEM,
                                                                     par exemple : <return>-----BEGIN PUBLIC
                                                                     KEY-----
                                                                     MIIBCgK...</return>.
  <info>string|int</info>                                            <strong>$algorithm</strong>   <info>int</info> - une des signatures
                                                                     d'algorithmes.
                                                                     
                                                                     <info>string</info> - une chaîne valide
                                                                     retournée par la fonction
                                                                     <strong>openssl_get_md_methods()</strong>, par
                                                                     exemple :
                                                                     "sha1WithRSAEncryption" ou
                                                                     "sha512". Algorithme par
                                                                     défaut: "OPENSSL_ALGO_SHA1".

<comment>Return:</comment>
  <info>int|false</info>  Retourne 1 si la signature est correcte, 0 si elle est incorrecte et -1 ou <info>false</info> si une
             erreur survient.

<comment>See Also:</comment>
   * <strong>openssl_sign()</strong>


id: openssl_x509_check_private_key
type: function
doc:
<comment>Description:</comment>
  Vérifie si une clé privée correspond à un certificat
  
  Vérifie si le paramètre <strong>$private_key</strong> fourni est la clé privée qui correspond à <strong>$certificate</strong>.
  
  Cette fonction ne vérifie pas si KEY est effectivement une clé privée ou pas. Elle compare
  simplement le matériel publique (par exemple exponent et modulo d'une clé RSA) et/ou les
  paramètres de clé (par exemple les paramètres EC d'une clé EC) d'une paire de clé.
  
  Ceci signifie, par exemple, qu'une clé publique pourrait être fournit pour <strong>$private_key</strong> et la
  fonction peut retourner <info>true</info>.

<comment>Param:</comment>
  <info>OpenSSLCertificate|string</info>                             <strong>$certificate</strong>  Le certificat.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$private_key</strong>  La clé privée.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$private_key</strong> est la clé privée qui correspond à <strong>$certificate</strong>, ou <info>false</info>
        sinon.


id: openssl_x509_checkpurpose
type: function
doc:
<comment>Description:</comment>
  Vérifie l'usage d'un certificat
  
  <strong>openssl_x509_checkpurpose()</strong> examine le certificat spécifié par <strong>$certificate</strong>, pour voir s'il peut
  être utilisé pour une opération particulière <strong>$purpose</strong>.

<comment>Param:</comment>
  <info>OpenSSLCertificate|string</info>  <strong>$certificate</strong>                  Le certificat examiné.
  <info>int</info>                        <strong>$purpose</strong>                      Utilisation de
                                                           <strong>openssl_x509_checkpurpose()</strong>ConstanteDescriptionX509_PURPOSE_SSL_CLIENT
                                                           Est-ce que le certificat peut être
                                                           utilisé avec le client d'une connexion
                                                           SSL ? X509_PURPOSE_SSL_SERVER Est-ce que
                                                           le certificat peut être utilisé avec le
                                                           serveur d'une connexion SSL ?
                                                           X509_PURPOSE_NS_SSL_SERVER Est-ce que le
                                                           certificat peut être utilisé avec un
                                                           serveur Netscape d'une connexion SSL ?
                                                           X509_PURPOSE_SMIME_SIGN Est-ce que le
                                                           certificat peut être utilisé pour signer
                                                           des courriers à la norme S/MIME ?
                                                           X509_PURPOSE_SMIME_ENCRYPT Est-ce que le
                                                           certificat peut être utilisé pour
                                                           chiffrer un courrier au format S/MIME ?
                                                           X509_PURPOSE_CRL_SIGN Est-ce que le
                                                           certificat peut être utilisé pour
                                                           chiffrer une liste de révocation de
                                                           certificats ? (CRL)? X509_PURPOSE_ANY
                                                           Est-ce que le certificat peut être
                                                           utilisé pour n'importe lequel de ces cas
                                                           ?  Ces options ne sont pas des champs de
                                                           bits :  vous ne pouvez en passer qu'une
                                                           seule à la fois.
  <info>array</info>                      <strong>$ca_info</strong>                      <strong>$ca_info</strong> doit être un tableau de
                                                           dossiers/fichiers de CA de confiance
                                                           comme décrit dans la Vérification des
                                                           certificats.
  <info>string|null</info>                <strong>$untrusted_certificates_file</strong>  Si spécifié, est le nom d'un fichier au
                                                           format PEM contenant les certificats qui
                                                           pourront aider lors de la vérification du
                                                           certificat, même si une confiance limitée
                                                           doit leur être portée.

<comment>Return:</comment>
  <info>bool|int</info>  Retourne <info>true</info> si le certificat peut être utilisé pour un but particulier, <info>false</info> s'il ne
            le peut pas, ou -1 si une erreur survient.


id: openssl_x509_export
type: function
doc:
<comment>Description:</comment>
  Exporte un certificat vers une chaîne de caractères
  
  <strong>openssl_x509_export()</strong> stocke un certificat <strong>$certificate</strong> dans le fichier <strong>$output</strong> au format PEM.

<comment>Param:</comment>
  <info></info>        <strong>$x509</strong>     Voir les paramètres clés/Certificats pour une liste de valeurs valides.
  <info>string</info>  <strong>$output</strong>   En cas de succès, contiendra le PEM.
  <info>bool</info>    <strong>$no_text</strong>  Le paramètre optionnel <strong>$notext</strong> affecte le niveau verbeux de l'affichage ;
                    s'il vaut <info>false</info>, des informations humainement lisibles seront ajoutées dans
                    l'affichage.
                    Par défaut, le paramètre <strong>$notext</strong> vaut <info>true</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_x509_export_to_file
type: function
doc:
<comment>Description:</comment>
  Exporte un certificat vers un fichier
  
  <strong>openssl_x509_export_to_file()</strong> stocke un certificat <strong>$certificate</strong> dans le fichier <strong>$output_filename</strong>
  au format PEM.

<comment>Param:</comment>
  <info></info>        <strong>$x509</strong>             Voir les paramètres clés/Certificats pour une liste de valeurs valides.
  <info>string</info>  <strong>$output_filename</strong>  Chemin du fichier de sortie.
  <info>bool</info>    <strong>$no_text</strong>          Le paramètre optionnel <strong>$notext</strong> affecte le niveau verbeux de l'affichage
                            ;
                            s'il vaut <info>false</info>, des informations humainement lisibles seront ajoutées
                            dans l'affichage.
                            Par défaut, le paramètre <strong>$notext</strong> vaut <info>true</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: openssl_x509_fingerprint
type: function
doc:
<comment>Description:</comment>
  Calcule l'empreinte, ou le digest d'un certificat X.509 donné
  
  La fonction <strong>openssl_x509_fingerprint()</strong> retourne le digest d'un certificat <strong>$certificate</strong> sous la
  forme d'une chaîne de caractères.

<comment>Param:</comment>
  <info></info>        <strong>$x509</strong>         Voir les paramètres clés/Certificats pour une liste de valeurs valides.
  <info>string</info>  <strong>$digest_algo</strong>  La méthode de digest ou l'algorithme de hachage à utiliser, par exemple
                        "sha256", l'un de <strong>openssl_get_md_methods()</strong>.
  <info>bool</info>    <strong>$binary</strong>       Lorsque définit à <info>true</info>, affiche les données brutes binaires. <info>false</info> affiche
                        en hexits minuscules.

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères contenant l'empreinte calculé du certificat sous
                la forme d'hexits minuscule sauf si <strong>$binary</strong> est définit à <info>true</info> dans ce cas la
                représentation brute binaire du message digest est retournée.
                
                Retourne <info>false</info> en cas d'échec.


id: openssl_x509_free
type: function
doc:
<comment>Description:</comment>
  Libère les ressources prises par un certificat
  
  Cette fonction n'a aucun effet. Antérieur à PHP 8.0.0, cette fonction était utilisé pour fermer
  une ressource.
  
  <strong>openssl_x509_free()</strong> libère les ressources mémoire prises par le certificat <strong>$certificate</strong>.

<comment>Param:</comment>
  <info>OpenSSLCertificate</info>  <strong>$certificate</strong>  

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.


id: openssl_x509_parse
type: function
doc:
<comment>Description:</comment>
  Analyse un certificat X509
  
  <strong>openssl_x509_parse()</strong> analyse le certificat X509 <strong>$certificate</strong>, et retourne les informations
  contenues dedans, y compris le sujet (<return>subject</return>), nom (<return>name</return>), émetteur (<return>issuer name</return>), dates de début
  et de fin (<return>valid from date</return> et <return>valid to date</return>), etc.

<comment>Param:</comment>
  <info>OpenSSLCertificate|string</info>  <strong>$certificate</strong>  Certificat X509. Voir paramètre de Clé/Certificat pour
                                           une list de valeur valide.
  <info>bool</info>                       <strong>$short_names</strong>  <strong>$short_names</strong> contrôle l'indexation des données dans le
                                           tableau : si <strong>$short_names</strong> vaut <info>true</info> (valeur par défaut),
                                           alors les champs seront indexés avec la forme courte des
                                           noms, sinon, les noms longs seront utilisés. (par
                                           exemple, <return>CN</return> est le nom court de <return>commonName</return>).

<comment>Return:</comment>
  <info>array|false</info>  La structure des données retournées est (délibérément) non documentée, car elle est
               sujette à des changements sans préavis.


id: openssl_x509_read
type: function
doc:
<comment>Description:</comment>
  Analyse un certificat X.509 et retourne un objet
  
  <strong>openssl_x509_read()</strong> analyse le certificat <strong>$certificate</strong> et retourne un objet <class>OpenSSLCertificate</class>
  pour celui-ci.

<comment>Param:</comment>
  <info>OpenSSLCertificate|string</info>  <strong>$certificate</strong>  Certificat X509. Voir paramètres clés/certificats  pour
                                           la liste des valeurs valides.

<comment>Return:</comment>
  <info>OpenSSLCertificate|false</info>  Retourne un <class>OpenSSLCertificate</class> en cas de succès ou <info>false</info> si une erreur
                            survient.


id: openssl_x509_verify
type: function
doc:
<comment>Description:</comment>
  Vérifie la signature digitale d'un certificat x509 par rapport à une clé publique
  
  La fonction <strong>openssl_x509_verify()</strong> vérifie que le certificat <strong>$certificate</strong> a été signé par la clé
  privée correspondant à la clé publique <strong>$public_key</strong>.

<comment>Param:</comment>
  <info></info>                                                      <strong>$x509</strong>        Voir les paramètres
                                                                     clés/Certificats pour une liste
                                                                     de valeurs valides.
  <info>OpenSSLAsymmetricKey|OpenSSLCertificate|array|string</info>  <strong>$public_key</strong>  <class>OpenSSLAsymmetricKey</class> - une clé,
                                                                     retournée par la fonction
                                                                     <strong>openssl_get_publickey()</strong>
                                                                     
                                                                     <info>string</info> - une clé formatée PEM,
                                                                     par exemple, <return>-----BEGIN PUBLIC
                                                                     KEY-----
                                                                     MIIBCgK...</return>.

<comment>Return:</comment>
  <info>int</info>  Retourne 1 si la signature est correcte, 0 si elle est incorrecte, et -1 si une erreur
       survient.

<comment>See Also:</comment>
   * <strong>openssl_verify()</strong>
   * <strong>openssl_get_publickey()</strong>


id: ord
type: function
doc:
<comment>Description:</comment>
  Convertit le premier octet d'une chaîne en une valeur entre 0 et 255
  
  Interprète la valeur binaire du premier octet de <strong>$character</strong> en tant qu'un entier non signé entre 0
  et 255.
  
  Si la chaîne de caractères est dans un encodage sur un octet tel que ASCII, ISO-8859, ou Windows
  1252, ceci est équivalent à retourner la position d'un caractère dans la table de correspondance
  de l'encodage. Cependant, il est à noter que cette fonction n'est pas conscient d'aucun encodage
  de chaîne de caractères, et en particulier n'identifiera jamais une valeur de point de code
  Unicode dans un encodage multioctet tel que UTF-8 ou UTF-16.
  
  Cette fonction complète <strong>chr()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$character</strong>  Un caractère.

<comment>Return:</comment>
  <info>int</info>  Un entier entre 0 et 255.

<comment>See Also:</comment>
   * <strong>chr()</strong>
   * Table ASCII
   * <strong>mb_ord()</strong>
   * <strong>IntlChar::ord()</strong>


id: output_add_rewrite_var
type: function
doc:
<comment>Description:</comment>
  Ajoute une règle de réécriture d'URL
  
  Cette fonction ajoute une nouvelle paire nom/valeur au mécanisme de réécriture d'URL. Le nom et la
  valeur sera ajouté aux URL (en tant que paramètre GET) et aux formulaires (en tant que champs
  cachés) de la même façon que pour les identifiants de session lorsque la réécriture d'URL est
  activée avec session.use_trans_sid.
  
  Ce comportement est contrôlé par les options url_rewriter.tags et url_rewriter.hosts du php.ini.
  
  Il est à noter que cette fonction ne peut être appellé avec succès au plus une fois par requête.
  
  L'appel à cette fonction démarre implicitement la temporisation de sortie si elle n'est pas déjà
  activée.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>   Le nom de la variable.
  <info>string</info>  <strong>$value</strong>  La valeur de la variable.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>output_reset_rewrite_vars()</strong>
   * <strong>ob_flush()</strong>
   * <strong>ob_list_handlers()</strong>
   * url_rewriter.tags
   * url_rewriter.hosts
   * session.trans_sid_tags
   * session.trans_sid_hosts


id: output_reset_rewrite_vars
type: function
doc:
<comment>Description:</comment>
  Annule la réécriture d'URL
  
  Cette fonction annule la règle de réécriture et efface toutes les variables de réécriture
  précédemment définies avec la fonction <strong>output_add_rewrite_var()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>output_add_rewrite_var()</strong>
   * <strong>ob_flush()</strong>
   * <strong>ob_list_handlers()</strong>
   * url_rewriter.tags
   * url_rewriter.hosts
   * session.trans_sid_tags
   * session.trans_sid_hosts


id: pack
type: function
doc:
<comment>Description:</comment>
  Compacte des données dans une chaîne binaire
  
  Compacte les arguments <strong>$args</strong> dans une chaîne binaire, suivant le format <strong>$format</strong>.
  
  Le concept vient du Perl et tout le formatage fonctionne de la même façon qu'en Perl, mais
  quelques formats manquent encore (comme "<return>u</return>").
  
  Notez que la distinction entre signé et non signé n'affecte que la fonction <strong>unpack()</strong>, tandis que
  la fonction <strong>pack()</strong> fournira le même résultat pour les deux formats.

<comment>Param:</comment>
  <info>string</info>  <strong>$format</strong>  La chaîne de caractères <strong>$format</strong> consiste en des codes de format suivis par un
                   argument répéteur optionnel. Le répéteur peut être soit une valeur entière, soit
                   <return>*</return> pour une répétition jusqu'à la fin des données d'entrées. Pour a, A, h, H, le
                   répéteur spécifie combien de caractères d'une donnée est pris, pour @, c'est la
                   position absolue où l'on insère les prochaines données, pour tout le reste, le
                   répéteur spécifie combien d'arguments de données sont consommés et compactés dans
                   la chaîne binaire résultante.
                   
                   Les formats actuellement acceptés sont : Caractères de formatage pour
                   <strong>pack()</strong>CodeDescriptionaNUL - Une chaîne complétée avec <info>null</info>ASPACE - Une chaîne
                   complétée avec un espacehChaîne hexadécimale h, bit de poids faible en
                   premierHChaîne hexadécimale H, bit de poids fort en premiercCaractère
                   signéCCaractère non signésentier court signé (toujours sur 16 bits, ordre des
                   octets dépendant de la machine)Sentier court non signé (toujours 16 bits, ordre
                   des octets dépendant de la machine)nentier court non signé (toujours 16 bits,
                   ordre des octets big endian)ventier court non signé (toujours 16 bits, ordre des
                   octets little endian)ientier signé (taille et ordre des octets dépendants de la
                   machine)Ientier non signé (taille et ordre des octets dépendants de la
                   machine)lentier long signé (toujours 32 bits, ordre des octets dépendant de la
                   machine)Lentier long non signé (toujours 32 bits, ordre des octets dépendant de
                   la machine)Nentier long non signé (toujours 32 bits, ordre des octets big
                   endian)Ventier long non signé (toujours 32 bits, ordre des octets little
                   endian)qentier doublement long signé (toujours 64 bits, ordre des octets
                   dépendant de la machine)Qentier doublement long non signé (toujours 64 bits,
                   ordre des octets dépendant de la machine)Jentier doublement long non signé
                   (toujours 64 bits, ordre des octets big endian)Pentier doublement long non signé
                   (toujours 64 bits, ordre des octets little endian)fnombre à virgule flottante
                   (taille et représentation dépendantes de la machine)gnombre à virgule flottante
                   (taille dépendantes de la machine, ordre des octets little endian)Gnombre à
                   virgule flottante (taille dépendantes de la machine, ordre des octets big
                   endian)dnombre à virgule flottante double (taille et représentation dépendantes
                   de la machine)enombre à virgule flottante double (taille dépendantes de la
                   machine, ordre des octets little endian)Enombre à virgule flottante double
                   (taille dépendantes de la machine, ordre des octets big endian)xcaractère
                   NULXRecule d'un caractèreZChaîne complétée par la valeur NULL@Remplit avec des
                   NUL jusqu'à la position absolue
  <info>mixed</info>   <strong>$values</strong>  

<comment>Return:</comment>
  <info>string</info>  Retourne une chaîne de caractères binaire contenant les données.

<comment>See Also:</comment>
   * <strong>unpack()</strong>


id: parallel\Channel::__construct
type: function
doc:
<comment>Description:</comment>
  Channel Construction
  
  Shall make an anonymous unbuffered channel
  
  Shall make an anonymous buffered channel with the given capacity

<comment>Param:</comment>
  <info>int</info>  <strong>$capacity</strong>  May be <info>Channel::Infinite</info> or a positive integer


id: parallel\Channel::close
type: function
doc:
<comment>Description:</comment>
  Closing
  
  Shall close this channel

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Channel::make
type: function
doc:
<comment>Description:</comment>
  Access
  
  Shall make an unbuffered channel with the given name
  
  Shall make a buffered channel with the given name and capacity

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>      The name of the channel.
  <info>int</info>     <strong>$capacity</strong>  May be <info>Channel::Infinite</info> or a positive integer

<comment>Return:</comment>
  <info>Channel</info>  


id: parallel\Channel::open
type: function
doc:
<comment>Description:</comment>
  Access
  
  Shall open the channel with the given name

<comment>Return:</comment>
  <info>Channel</info>  


id: parallel\Channel::recv
type: function
doc:
<comment>Description:</comment>
  Sharing
  
  Shall recv a value from this channel

<comment>Return:</comment>
  <info>mixed</info>  


id: parallel\Channel::send
type: function
doc:
<comment>Description:</comment>
  Sharing
  
  Shall send the given value on this channel

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events::addChannel
type: function
doc:
<comment>Description:</comment>
  Targets
  
  Shall watch for events on the given <strong>$channel</strong>

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events::addFuture
type: function
doc:
<comment>Description:</comment>
  Targets
  
  Shall watch for events on the given <strong>$future</strong>

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events::poll
type: function
doc:
<comment>Description:</comment>
  Polling
  
  Shall poll for the next event

<comment>Return:</comment>
  <info>parallel\Events\Event|null</info>  Should there be no targets remaining, <info>null</info> shall be returned
                              
                              Should this be a non-blocking loop, and blocking would occur, <info>null</info>
                              shall be returned
                              
                              Otherwise, the <class>parallel\Events\Event</class> returned describes the event.


id: parallel\Events::remove
type: function
doc:
<comment>Description:</comment>
  Targets
  
  Shall remove the given <strong>$target</strong>

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events::setBlocking
type: function
doc:
<comment>Description:</comment>
  Behaviour
  
  By default when events are polled for, blocking will occur (at the PHP level) until the first
  event can be returned: Setting blocking mode to <info>false</info> will cause poll to return control if the
  first target polled is not ready.
  
  This differs from setting a timeout of 0 with parallel\Events::setTimeout, since a timeout of 0,
  while allowed, will cause an exception  to be raised, which may be extremely slow or wasteful if
  what is really desired is non-blocking behaviour.
  
  A non-blocking loop effects the return value of parallel\Events::poll, such that it may be <info>null</info>
  before all events have been processed.
  
  Shall set blocking mode

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events::setInput
type: function
doc:
<comment>Description:</comment>
  Input
  
  Shall set <strong>$input</strong> for this event loop

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events::setTimeout
type: function
doc:
<comment>Description:</comment>
  Behaviour
  
  By default when events are polled for, blocking will occur (at the PHP level) until the first
  event can be returned: Setting the timeout causes an exception to be thrown when the timeout is
  reached.
  
  This differs from setting blocking mode to <info>false</info> with parallel\Events::setBlocking, which will not
  cause an exception to be thrown.
  
  Shall set the timeout in microseconds

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events\Input::add
type: function
doc:
<comment>Description:</comment>
  Inputs
  
  Shall set input for the given target

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events\Input::clear
type: function
doc:
<comment>Description:</comment>
  Inputs
  
  Shall remove input for all targets

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Events\Input::remove
type: function
doc:
<comment>Description:</comment>
  Inputs
  
  Shall remove input for the given target

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Future::cancel
type: function
doc:
<comment>Description:</comment>
  Cancellation
  
  Shall try to cancel the task
  
  If task is running, it will be interrupted.
  
  Internal function calls in progress cannot be interrupted.

<comment>Return:</comment>
  <info>bool</info>  


id: parallel\Future::cancelled
type: function
doc:
<comment>Description:</comment>
  State Detection
  
  Shall indicate if the task was cancelled

<comment>Return:</comment>
  <info>bool</info>  


id: parallel\Future::done
type: function
doc:
<comment>Description:</comment>
  State Detection
  
  Shall indicate if the task is completed

<comment>Return:</comment>
  <info>bool</info>  


id: parallel\Future::value
type: function
doc:
<comment>Description:</comment>
  Resolution
  
  Shall return (and if necessary wait for) return from task

<comment>Return:</comment>
  <info>mixed</info>  


id: parallel\Runtime::__construct
type: function
doc:
<comment>Description:</comment>
  Runtime Construction
  
  Shall construct a new runtime without bootstrapping.
  
  Shall construct a bootstrapped runtime.

<comment>Param:</comment>
  <info>string</info>  <strong>$bootstrap</strong>  The location of a bootstrap file, generally an autoloader.


id: parallel\Runtime::close
type: function
doc:
<comment>Description:</comment>
  Runtime Graceful Join
  
  Shall request that the runtime shutsdown.
  
  Tasks scheduled for execution will be executed before the shutdown occurs.

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Runtime::kill
type: function
doc:
<comment>Description:</comment>
  Runtime Join
  
  Shall attempt to force the runtime to shutdown.
  
  Tasks scheduled for execution will not be executed, the currently running task shall be
  interrupted.
  
  Internal function calls in progress cannot be interrupted.

<comment>Return:</comment>
  <info>void</info>  


id: parallel\Runtime::run
type: function
doc:
<comment>Description:</comment>
  Execution
  
  Shall schedule <strong>$task</strong> for execution in parallel.
  
  Shall schedule <strong>$task</strong> for execution in parallel, passing <strong>$argv</strong> at execution time.

<comment>Param:</comment>
  <info>Closure</info>  <strong>$task</strong>  A <class>Closure</class> with specific characteristics.
  <info>array</info>    <strong>$argv</strong>  An <info>array</info> of arguments with specific characteristics to be passed to <strong>$task</strong> at
                  execution time.

<comment>Return:</comment>
  <info>Future|null</info>  The return <info>parallel\Future</info> must not be ignored when the task contains a return or
               throw statement.


id: parallel\Sync::__construct
type: function
doc:
<comment>Description:</comment>
  Construction
  
  Shall construct a new synchronization object with no value
  
  Shall construct a new synchronization object containing the given scalar value


id: parallel\Sync::__invoke
type: function
doc:
<comment>Description:</comment>
  Synchronization
  
  Shall exclusively enter into the critical code


id: parallel\Sync::get
type: function
doc:
<comment>Description:</comment>
  Access
  
  Shall atomically return the synchronization objects value

<comment>Return:</comment>
  <info>scalar</info>  


id: parallel\Sync::notify
type: function
doc:
<comment>Description:</comment>
  Synchronization
  
  Shall notify one (by default) or all threads waiting on the synchronization object


id: parallel\Sync::set
type: function
doc:
<comment>Description:</comment>
  Access
  
  Shall atomically set the value of the synchronization object


id: parallel\Sync::wait
type: function
doc:
<comment>Description:</comment>
  Synchronization
  
  Shall wait for notification on this synchronization object


id: parallel\bootstrap
type: function
doc:
<comment>Description:</comment>
  Bootstrapping
  
  Shall use the provided <strong>$file</strong> to bootstrap all runtimes created for automatic scheduling via
  <strong>parallel\run()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$file</strong>  Path to the file to bootstrap all runtimes.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * 


id: parallel\run
type: function
doc:
<comment>Description:</comment>
  Execution
  
  Shall schedule <strong>$task</strong> for execution in parallel.
  
  Shall schedule <strong>$task</strong> for execution in parallel, passing <strong>$argv</strong> at execution time.

<comment>Param:</comment>
  <info>Closure</info>  <strong>$task</strong>  A <class>Closure</class> with specific characteristics.
  <info>array</info>    <strong>$argv</strong>  An <info>array</info> of arguments with specific characteristics to be passed to <strong>$task</strong> at
                  execution time.

<comment>Return:</comment>
  <info>Future|null</info>  The return <info>parallel\Future</info> must not be ignored when the task contains a return or
               throw statement.

<comment>See Also:</comment>
   * 


id: parse_ini_file
type: function
doc:
<comment>Description:</comment>
  Analyse un fichier de configuration
  
  <strong>parse_ini_file()</strong> charge le fichier <strong>$filename</strong> et retourne les configurations qui s'y trouvent sous
  forme d'un tableau associatif.
  
  La structure des fichiers de configuration lus est similaire à celle de php.ini.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>          Le nom du fichier de configuration à analyser. Si un chemin relatif est
                             utilisé, il est évalué relatif au dossier courrant actuel, puis selon
                             le include_path.
  <info>bool</info>    <strong>$process_sections</strong>  En passant le paramètre <strong>$process_sections</strong> à <info>true</info>, vous obtiendrez un
                             tableau multidimensionnel avec les noms des sections. La valeur par
                             défaut de ce paramètre est <info>false</info>
  <info>int</info>     <strong>$scanner_mode</strong>      Peut être <info>INI_SCANNER_NORMAL</info> (défaut) ou <info>INI_SCANNER_RAW</info>. Si
                             <info>INI_SCANNER_RAW</info> est fourni, alors les valeurs en option ne seront pas
                             analysées.
                             
                             À parti de PHP 5.6.1 peut aussi être spécifié comme <info>INI_SCANNER_TYPED</info>.
                             Dans ce mode les booléens, null et entiers sont préservés tant que
                             possible.
                             Les chaines de caractères <return>"true"</return>, <return>"on"</return> et <return>"yes"</return>
                             sont converties vers <info>true</info>. <return>"false"</return>, <return>"off"</return>, <return>"no"</return>
                             et <return>"none"</return> sont considérés comme <info>false</info>. <return>"null"</return> est converti en <info>null</info> dans
                             ce mode. De plus toutes les chaines de caractères numériques sont
                             converties en entier si possible.

<comment>Return:</comment>
  <info>array|false</info>  La configuration est retournée sous la forme d'un tableau associatif en cas de
               succès, et <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>parse_ini_string()</strong>


id: parse_ini_string
type: function
doc:
<comment>Description:</comment>
  Analyse une chaîne de configuration
  
  <strong>parse_ini_string()</strong> retourne la configuration dans la chaîne <strong>$ini_string</strong> dans un tableau
  associatif.
  
  La structure de la chaîne doit être la même que celle du fichier php.ini.

<comment>Param:</comment>
  <info>string</info>  <strong>$ini_string</strong>        Le contenu de type ini à analyser.
  <info>bool</info>    <strong>$process_sections</strong>  En activant le paramètre <strong>$process_sections</strong> avec <info>true</info>, vous obtiendrez
                             un tableau multidimensionnel, avec les noms de sections et de
                             directives. La valeur par  défaut du paramètre <strong>$process_sections</strong> est
                             <info>false</info>
  <info>int</info>     <strong>$scanner_mode</strong>      Peut prendre les valeurs des constantes <info>INI_SCANNER_NORMAL</info>  (par
                             défaut) ou <info>INI_SCANNER_RAW</info>. Si  <info>INI_SCANNER_RAW</info> est utilisé, les
                             valeurs des  options ne seront pas analysées.
                             
                             À parti de PHP 5.6.1 peut aussi être spécifié comme <info>INI_SCANNER_TYPED</info>.
                             Dans ce mode les booléens, null et entiers sont préservés tant que
                             possible.
                             Les chaines de caractères <return>"true"</return>, <return>"on"</return> et <return>"yes"</return>
                             sont converties vers <info>true</info>. <return>"false"</return>, <return>"off"</return>, <return>"no"</return>
                             et <return>"none"</return> sont considérés comme <info>false</info>. <return>"null"</return> est converti en <info>null</info> dans
                             ce mode. De plus toutes les chaines de caractères numériques sont
                             converties en entier si possible.

<comment>Return:</comment>
  <info>array|false</info>  Les directives sont retournées sous forme de tableau <info>array</info>  en cas de succès, et
               <info>false</info> en cas d'erreur.

<comment>See Also:</comment>
   * <strong>parse_ini_file()</strong>


id: parse_str
type: function
doc:
<comment>Description:</comment>
  Analyse une chaîne de caractères d'une variable
  
  Analyse la chaîne de caractères <strong>$string</strong> comme s'il s'agissait des paramètres passés via l'URL.
  Toutes les variables qu'elle y repère sont alors créées, avec leurs valeurs respectives (ou dans
  le tableau si <strong>$result</strong> est fourni).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  La chaîne d'entrée.
  <info>array</info>   <strong>$result</strong>  Si le second paramètre <strong>$result</strong> est fourni, les variables y seront stockées, sous
                   forme d'un tableau indexé.
                   
                   L'utilisation de cette fonction sans le paramètre <strong>$result</strong>  est trés fortement
                   découragé et déconseillé  à partir de PHP 7.2. À partir de PHP 8.0.0, le
                   paramètre <strong>$result</strong> est obligatoire.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>parse_url()</strong>
   * <strong>pathinfo()</strong>
   * <strong>http_build_query()</strong>
   * <strong>urldecode()</strong>


id: parse_url
type: function
doc:
<comment>Description:</comment>
  Analyse une URL et retourne ses composants
  
  Cette fonction analyse une URL et retourne un tableau associatif contenant tous les éléments qui y
  sont présents. Les valeurs des éléments du tableau NE sont PAS URL décodés
  
  Cette fonction n'est pas faite pour valider l'URL fournie, elle ne fait que la découper en parties
  listées ci-dessous. Les URL partielles et invalides sont également acceptées, la fonction
  <strong>parse_url()</strong> fera de son mieux pour les analyser correctement.

<comment>Param:</comment>
  <info>string</info>  <strong>$url</strong>        L'URL à analyser.
  <info>int</info>     <strong>$component</strong>  Peut être une des constantes parmi <info>PHP_URL_SCHEME</info>, <info>PHP_URL_HOST</info>, <info>PHP_URL_PORT</info>,
                      <info>PHP_URL_USER</info>, <info>PHP_URL_PASS</info>, <info>PHP_URL_PATH</info>, <info>PHP_URL_QUERY</info> ou <info>PHP_URL_FRAGMENT</info>
                      pour récupérer uniquement une partie de l'URL en tant que chaîne de caractères
                      (sauf lorsque <info>PHP_URL_PORT</info> est fourni ; dans ce cas, la valeur retournée sera
                      un entier).

<comment>Return:</comment>
  <info>int|string|array|null|false</info>  Pour les URL vraiment mal formées, <strong>parse_url()</strong> peut retourner <info>false</info>.
                               
                               Si le paramètre <strong>$component</strong> est omis, un <info>array</info> associatif est
                               retourné. Au moins un élément sera présent dans le tableau. Voici les
                               clés potentielles de ce tableau: scheme - e.g. http
                               hostportuserpasspathquery - après le point d'interrogation "<return>?</return>"
                               fragment - après le croisillon (dièse) "<return>#</return>"
                               
                               scheme - e.g. http
                               
                               host
                               
                               port
                               
                               user
                               
                               pass
                               
                               path
                               
                               query - après le point d'interrogation "<return>?</return>"
                               
                               fragment - après le croisillon (dièse) "<return>#</return>"
                               
                               Si le paramètre <strong>$component</strong> est spécifié, <strong>parse_url()</strong> retourne une
                               <info>string</info> (ou un entier dans le cas d'utilisation de la constante
                               <info>PHP_URL_PORT</info>)au lieu d'un <info>array</info>. Si le composant demandé n'existe pas
                               dans l'URL, <info>null</info> sera retourné. À partir de PHP 8.0.0, <strong>parse_url()</strong>
                               distingue entre les fragments et requêtes absentes et vides :
                               
                               
                               
                               Précédemment tout les cas résultaient en la requête et le fragment
                               étant <info>null</info>.
                               
                               À noter que les caractères de contrôle (cf. <strong>ctype_cntrl()</strong>) dans les
                               composants sont remplacés par un tiret du bas (<return>_</return>).

<comment>See Also:</comment>
   * <strong>pathinfo()</strong>
   * <strong>parse_str()</strong>
   * <strong>http_build_query()</strong>
   * <strong>dirname()</strong>
   * <strong>basename()</strong>
   * RFC 3986


id: passthru
type: function
doc:
<comment>Description:</comment>
  Exécute un programme externe et affiche le résultat brut
  
  <strong>passthru()</strong> est similaire à la fonction  <strong>exec()</strong> car les deux exécutent la commande  <strong>$command</strong>. Si
  l'argument  <strong>$result_code</strong> est présent, le code de statut de réponse UNIX y sera placé. Cette
  fonction  devrait être préférée aux commandes <strong>exec()</strong>  ou <strong>system()</strong> lorsque le résultat attendu est
  de type  binaire, et doit être passé tel quel à un navigateur. Une utilisation classique de cette
  fonction est l'exécution de l'utilitaire pbmplus qui peut retourner une image. En fixant le
  résultat du contenu (Content-Type) à <return>image/gif</return>  puis en appelant pbmplus pour obtenir une image
  gif, vous pouvez  créer des scripts PHP qui retournent des images.

<comment>Param:</comment>
  <info>string</info>  <strong>$command</strong>      La commande à exécuter.
  <info>int</info>     <strong>$result_code</strong>  Si l'argument <strong>$result_code</strong> est présent, le statut retourné par la commande
                        Unix sera placé dans cette variable.

<comment>Return:</comment>
  <info>false|null</info>  Cette fonction retourne <info>null</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>exec()</strong>
   * <strong>system()</strong>
   * <strong>popen()</strong>
   * <strong>escapeshellcmd()</strong>
   * les guillemets obliques


id: password_algos
type: function
doc:
<comment>Description:</comment>
  Récupère tous les identifiants des algorithmes de hachage de mots de passe disponibles
  
  Retourne une liste complète de tous les identifiants des algorithmes de hachage de mots de passe
  enregistrés, sous la forme d'un tableau de chaîne de caractères.

<comment>Return:</comment>
  <info>array</info>  Retourne tous les identifiants des algorithmes de hachage de mots de passe disponibles.


id: password_get_info
type: function
doc:
<comment>Description:</comment>
  Retourne des informations à propos du hachage fourni
  
  Lorsqu'il est passé un hachage valide, créée par un algorithme supporté par la fonction
  <strong>password_hash()</strong>, cette fonction retournera un tableau d'information à propos de ce dernier.

<comment>Param:</comment>
  <info>string</info>  <strong>$hash</strong>  Un hachage créé par la fonction <strong>password_hash()</strong>.

<comment>Return:</comment>
  <info>array</info>  Retourne un tableau associatif contenant trois éléments : <return>algo</return>, qui doit correspondre à une
         constante de l'algorithme de mot de passe <return>algoName</return>, qui correspond au nom humainement
         lisible de l'algorithme <return>options</return>, qui contient les options fournies lors de l'appel de la
         fonction <strong>password_hash()</strong>
         
         <return>algo</return>, qui doit correspondre à une constante de l'algorithme de mot de passe
         
         <return>algoName</return>, qui correspond au nom humainement lisible de l'algorithme
         
         <return>options</return>, qui contient les options fournies lors de l'appel de la fonction <strong>password_hash()</strong>


id: password_hash
type: function
doc:
<comment>Description:</comment>
  Crée une clé de hachage pour un mot de passe
  
  La fonction <strong>password_hash()</strong> crée un nouveau hachage en utilisant un algorithme de hachage fort et
  irréversible.
  
  Les algorithmes suivants sont actuellement supportés :
  
  <info>PASSWORD_DEFAULT</info> - Utilisation de l'algorithme bcrypt (par défaut depuis PHP 5.5.0). Notez que
  cette constante est concue pour changer dans le temps, au fur et à mesure que des algorithmes plus
  récents et plus forts sont ajoutés à PHP. Pour cette raison, la longueur du résultat issu de cet
  algorithme peut changer dans le temps, il est donc recommandé de stocker le résultat dans une
  colonne de la base de données qui peut contenir au moins 60 caractères (255 caractères peut être
  un très bon choix). <info>PASSWORD_BCRYPT</info> - Utilisation de l'algorithme <info>CRYPT_BLOWFISH</info> pour créer la clé
  de hachage. Ceci va créer une clé de hachage standard <strong>crypt()</strong> utilisant l'identifiant "$2y$". Le
  résultat sera toujours une chaîne de 60 caractères,  ou <info>false</info> si une erreur survient.
  <info>PASSWORD_ARGON2I</info> - Utilise l'algorithme de hachage Argon2i pour créer le hachage. Cet algorithme
  est seulement disponible si PHP a été compilé avec le support d'Argon2 <info>PASSWORD_ARGON2ID</info> - Utilise
  l'algorithme de hachage Argon2id pour créer le hachage. Cet algorithme est seulement disponible si
  PHP a été compilé avec le support d'Argon2
  
  <info>PASSWORD_DEFAULT</info> - Utilisation de l'algorithme bcrypt (par défaut depuis PHP 5.5.0). Notez que
  cette constante est concue pour changer dans le temps, au fur et à mesure que des algorithmes plus
  récents et plus forts sont ajoutés à PHP. Pour cette raison, la longueur du résultat issu de cet
  algorithme peut changer dans le temps, il est donc recommandé de stocker le résultat dans une
  colonne de la base de données qui peut contenir au moins 60 caractères (255 caractères peut être
  un très bon choix).
  
  <info>PASSWORD_BCRYPT</info> - Utilisation de l'algorithme <info>CRYPT_BLOWFISH</info> pour créer la clé de hachage. Ceci va
  créer une clé de hachage standard <strong>crypt()</strong> utilisant l'identifiant "$2y$". Le résultat sera
  toujours une chaîne de 60 caractères,  ou <info>false</info> si une erreur survient.
  
  <info>PASSWORD_ARGON2I</info> - Utilise l'algorithme de hachage Argon2i pour créer le hachage. Cet algorithme
  est seulement disponible si PHP a été compilé avec le support d'Argon2
  
  <info>PASSWORD_ARGON2ID</info> - Utilise l'algorithme de hachage Argon2id pour créer le hachage. Cet algorithme
  est seulement disponible si PHP a été compilé avec le support d'Argon2
  
  Options supportées pour <info>PASSWORD_BCRYPT</info>:
  
  <return>salt</return> - pour fournir manuellement un salt à utiliser lors du hachage du mot de passe. Notez que
  cette option empêchera la génération automatique.  Si omis, un salt aléatoire sera généré par la
  fonction <strong>password_hash()</strong> pour chaque mot de passe haché. C'est le mode de fonctionnement prévu.
  L'option Salt est obsolète. Il est préférable d'utiliser simplement le sel qui est généré par
  défaut. À partir de PHP 8.0.0, un sel explicitement fournit est ignoré. <return>cost</return> - détermine le coût
  algorithmique qui doit être utilisé. Des exemples de ces valeurs peuvent être trouvés sur la page
  de la documentation de la fonction <strong>crypt()</strong>.  Si omis, la valeur par défaut <return>10</return> sera utilisée. C'est
  un bon compromis, mais vous pourriez vouloir l'augmenter suivant votre architecture.
  
  <return>salt</return> - pour fournir manuellement un salt à utiliser lors du hachage du mot de passe. Notez que
  cette option empêchera la génération automatique.
  
  Si omis, un salt aléatoire sera généré par la fonction <strong>password_hash()</strong> pour chaque mot de passe
  haché. C'est le mode de fonctionnement prévu.
  
  L'option Salt est obsolète. Il est préférable d'utiliser simplement le sel qui est généré par
  défaut. À partir de PHP 8.0.0, un sel explicitement fournit est ignoré.
  
  <return>cost</return> - détermine le coût algorithmique qui doit être utilisé. Des exemples de ces valeurs peuvent
  être trouvés sur la page de la documentation de la fonction <strong>crypt()</strong>.
  
  Si omis, la valeur par défaut <return>10</return> sera utilisée. C'est un bon compromis, mais vous pourriez vouloir
  l'augmenter suivant votre architecture.
  
  Options supporté pour <info>PASSWORD_ARGON2I</info> et <info>PASSWORD_ARGON2ID</info> :
  
  <return>memory_cost</return> (<info>int</info>) - Mémoire maximale  (en kilo octets binaire) pouvant être utilisée pour calculer
  le hachage Argon2. Par  défaut à  <info>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</info>. <return>time_cost</return> (<info>int</info>) - Durée
  maximale de  temps qu'il peut prendre pour calculer le hachage Argon2. Par  défaut à
  <info>PASSWORD_ARGON2_DEFAULT_TIME_COST</info>. <return>threads</return> (<info>int</info>) - Nombre de threads à  utiliser pour calculer le
  hachage Argon2. Par défaut à  <info>PASSWORD_ARGON2_DEFAULT_THREADS</info>.  Uniquement disponible quand PHP
  utilise libargon2, et non l'implementation libsodium.
  
  <return>memory_cost</return> (<info>int</info>) - Mémoire maximale  (en kilo octets binaire) pouvant être utilisée pour calculer
  le hachage Argon2. Par  défaut à  <info>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</info>.
  
  <return>time_cost</return> (<info>int</info>) - Durée maximale de  temps qu'il peut prendre pour calculer le hachage Argon2. Par
  défaut à  <info>PASSWORD_ARGON2_DEFAULT_TIME_COST</info>.
  
  <return>threads</return> (<info>int</info>) - Nombre de threads à  utiliser pour calculer le hachage Argon2. Par défaut à
  <info>PASSWORD_ARGON2_DEFAULT_THREADS</info>.
  
  Uniquement disponible quand PHP utilise libargon2, et non l'implementation libsodium.

<comment>Param:</comment>
  <info>string</info>           <strong>$password</strong>  Le mot de passe utilisateur.
                              
                              L'utilisation de la constante <info>PASSWORD_BCRYPT</info> pour l'algorithme fera
                              que le paramètre <strong>$password</strong> sera tronqué à une longueur maximale de 72
                              octets.
  <info>string|int|null</info>  <strong>$algo</strong>      Une constantes de l'algorithme
                              de mot de passe représentant l'algorithme à utiliser lors du hachage
                              du mot de passe.
  <info>array</info>            <strong>$options</strong>   Un tableau associatif contenant les options. Voir aussi les constantes
                              de l'algorithme de mot de passe pour une documentation sur les options
                              supportées pour chaque algorithme.
                              
                              Si omis, un salt aléatoire sera créé et le cost par défaut sera
                              utilisé.

<comment>Return:</comment>
  <info>string</info>  Retourne le mot de passe haché.
          
          L'algorithme utilisé, le coût et le salt sont contenus dans le hachage retourné. Aussi,
          toutes les informations utiles pour vérifier ce dernier y sont incluses. Ceci permet à la
          fonction <strong>password_verify()</strong> de vérifier le hachage sans avoir besoin de stocker séparément
          ces informations.

<comment>See Also:</comment>
   * <strong>password_verify()</strong>
   * <strong>password_needs_rehash()</strong>
   * <strong>crypt()</strong>
   * <strong>sodium_crypto_pwhash_str()</strong>


id: password_needs_rehash
type: function
doc:
<comment>Description:</comment>
  Vérifie que le hachage fourni est conforme à l'algorithme et aux options spécifiées
  
  Cette fonction vérifie que le hachage fourni correspond à l'algorithme et aux options spécifiées.
  Si ce n'est pas le cas, le hachage devrait être re-généré.

<comment>Param:</comment>
  <info>string</info>           <strong>$hash</strong>     Un hachage créé par la fonction <strong>password_hash()</strong>.
  <info>string|int|null</info>  <strong>$algo</strong>     Une constantes de l'algorithme
                             de mot de passe représentant l'algorithme à utiliser lors du hachage du
                             mot de passe.
  <info>array</info>            <strong>$options</strong>  Un tableau associatif contenant les options. Voir aussi les constantes
                             de l'algorithme de mot de passe pour une documentation sur les options
                             supportées pour chaque algorithme.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le hachage doit être re-généré pour correspondre aux paramètres <strong>$algo</strong> et
        <strong>$options</strong> fournis, ou <info>false</info> sinon.


id: password_verify
type: function
doc:
<comment>Description:</comment>
  Vérifie qu'un mot de passe correspond à un hachage
  
  Vérifie que le hachage fourni correspond bien au mot de passe fourni. La fonction
  <strong>password_verify()</strong> est compatible avec la fonction <strong>crypt()</strong>. Ainsi, un mot de passe haché par la
  fonction <strong>crypt()</strong> peut être utilisé avec la fonction <strong>password_verify()</strong>.
  
  Notez que la fonction <strong>password_hash()</strong> retourne l'algorithme, le "cost", et le salt comme parties
  du hachage retourné. Toutefois, toutes les informations nécessaires pour vérifier le hachage y
  sont incluses. Ceci permet à la fonction de vérifier le hachage sans avoir besoin d'un stockage
  séparé pour les informations concernant l'algorithme et le salt.
  
  Cette fonction est sans danger contre les attaques sur le temps.

<comment>Param:</comment>
  <info>string</info>  <strong>$password</strong>  Le mot de passe utilisateur.
  <info>string</info>  <strong>$hash</strong>      Un hachage créé par la fonction <strong>password_hash()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le mot de passe et le hachage correspondent, ou <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>password_needs_rehash()</strong>
   * <strong>password_hash()</strong>
   * l'implémentation en espace utilisateur
   * <strong>sodium_crypto_pwhash_str_verify()</strong>


id: pathinfo
type: function
doc:
<comment>Description:</comment>
  Retourne des informations sur un chemin système
  
  <strong>pathinfo()</strong> retourne des informations sur le chemin <strong>$path</strong>, sous forme de chaine ou de tableau
  associatif, ceci dépend du paramètre <strong>$flags</strong>.
  
  Pour plus d'informations sur la lecture du chemin courant, lisez la section sur les variables
  prédéfinies.
  
  <strong>pathinfo()</strong> opère naivement sur la chaîne d'entrée, et n'est pas conscient des systèmes de fichiers
  actuel, ou des composants de chemins tel que "<return>..</return>".
  
  Sur les systèmes Windows uniquement, le caractère <return>\</return> sera interprété comme un séparateur de
  répertoire. Sur les autres systèmes, il sera traité comme n'importe quel autre caractère.
  
  La fonction <strong>pathinfo()</strong> est sensible à la configuration locale, aussi, si vous voulez qu'elle
  analyse correctement un chemin contenant les caractères sur plusieurs octets, la locale
  correspondante doit être définie en utilisant la fonction <strong>setlocale()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>   Le chemin à analyser.
  <info>int</info>     <strong>$flags</strong>  Spécifie quel élément sera retourné. Vous pouvez passer l'une des constantes
                  <info>PATHINFO_DIRNAME</info>, <info>PATHINFO_BASENAME</info>, <info>PATHINFO_EXTENSION</info> et <info>PATHINFO_FILENAME</info>.
                  
                  Si <strong>$flags</strong> n'est pas renseigné, tous les éléments sont retournés.

<comment>Return:</comment>
  <info>array|string</info>  Si <strong>$flags</strong> n'est pas utilisé, cette fonction retournera un tableau associatif
                contenant les éléments suivants : <return>dirname</return>, <return>basename</return>, <return>extension</return> (s'il y en a), et
                <return>filename</return>.
                
                Si <strong>$path</strong> contient plus d'une extension, <info>PATHINFO_EXTENSION</info> retourne uniquement le
                dernier et <info>PATHINFO_FILENAME</info> va supprimer uniquement le dernier également (voir le
                premier exemple ci-dessous).
                
                Si <strong>$path</strong> n'a pas d'extension, l'élément <return>extension</return> ne sera pas retourné (voir le
                second exemple ci-après).
                
                Si <return>basename</return> du paramètre <strong>$path</strong> commence par un point, les caractères suivants sont
                interprétés comme l' <return>extension</return>, et le <return>filename</return> sera vide (voir le troisième exemple
                ci-dessous).
                
                Si <strong>$flags</strong> est utilisé, cette fonction retournera une chaîne de caractères contenant
                les éléments.

<comment>See Also:</comment>
   * <strong>dirname()</strong>
   * <strong>basename()</strong>
   * <strong>parse_url()</strong>
   * <strong>realpath()</strong>


id: pclose
type: function
doc:
<comment>Description:</comment>
  Ferme un processus de pointeur de fichier
  
  Ferme un processus de pointeur de fichier ouvert avec la fonction <strong>popen()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$handle</strong>  Le pointeur de fichier doit être valide, et avoir été ouvert correctement par
                     <strong>popen()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne le statut final du processus exécuté ou <return>-1</return> en cas d'echec.
       
       Si PHP a été compilé avec l'option de configuration --enable-sigchild, la valeur retournée de
       cette fonction sera indéfinie.

<comment>See Also:</comment>
   * <strong>popen()</strong>


id: pcntl_alarm
type: function
doc:
<comment>Description:</comment>
  Planifie une alarme pour délivrer un signal
  
  Créé un compte à rebours qui enverra un signal <info>SIGALRM</info> au processus après <strong>$seconds</strong> secondes. Tout
  appel à <strong>pcntl_alarm()</strong> annulera les comptes à rebours précédemment configurés.

<comment>Param:</comment>
  <info>int</info>  <strong>$seconds</strong>  Le nombre de secondes à attendre. Si <strong>$seconds</strong> vaut <return>0</return>, aucune nouvelle alarme ne
                 sera créée.

<comment>Return:</comment>
  <info>int</info>  Retourne le temps en seconde qui reste avant l'exécution de l'alarme précédente, ou <return>0</return> si
       aucune alarme n'était planifiée.


id: pcntl_async_signals
type: function
doc:
<comment>Description:</comment>
  Enable/disable asynchronous signal handling or return the old setting
  
  If the <strong>$enable</strong> parameter is <info>null</info>, <strong>pcntl_async_signals()</strong> returns whether asynchronous signal
  handling is enabled. Otherwise, asynchronous signal handling is enabled or disabled.

<comment>Param:</comment>
  <info>bool|null</info>  <strong>$enable</strong>  Whether asynchronous signal handling should be enabled.

<comment>Return:</comment>
  <info>bool</info>  When used as getter (<strong>$enable</strong> parameter is <info>null</info>) it returns whether asynchronous signal
        handling is enabled. When used as setter (<strong>$enable</strong> parameter is not <info>null</info>), it returns whether
        asynchronous signal handling was enabled before the function call.

<comment>See Also:</comment>
   * declare


id: pcntl_errno
type: function
doc:
<comment>Description:</comment>
  Alias de pcntl_get_last_error
  
  Cette fonction est un alias de :  <strong>pcntl_get_last_error()</strong>


id: pcntl_exec
type: function
doc:
<comment>Description:</comment>
  Exécute le programme indiqué dans l'espace courant de processus
  
  Exécute le programme indiqué dans l'espace courant de processus.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>      <strong>$path</strong> doit être le chemin vers un binaire exécutable ou un script avec un
                     chemin valide pointant vers un exécutable à la première ligne (par exemple,
                     <return>#!/usr/local/bin/perl</return>).  Voir les pages d'aide de votre système concernant
                     <return>execve(2)</return> pour plus d'informations.
  <info>array</info>   <strong>$args</strong>      <strong>$args</strong> est un tableau d'arguments sous la forme de chaînes de caractères passées
                     au programme.
  <info>array</info>   <strong>$env_vars</strong>  <strong>$env_vars</strong> est un tableau de chaînes de caractères qui sont passées au programme
                     comme variables d'environnement. Le tableau est de la forme nom =&gt; valeur,
                     la clé est le nom de la variable d'environnement et la valeur est la valeur de
                     cette variable.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>false</info>.


id: pcntl_fork
type: function
doc:
<comment>Description:</comment>
  Duplique le process courant
  
  <strong>pcntl_fork()</strong> crée un processus fils, qui ne diffère du processus père que par l'identifiant de
  processus et l'identifiant PPID. Reportez-vous à la page de man fork(2) pour avoir des détails sur
  le comportement de cette fonction sur votre système.

<comment>Return:</comment>
  <info>int</info>  En cas de succès, le PID (identifiant de processus) du fils est retourné dans le processus
       père, et 0 est retourné dans le processus fils. En cas d'échec, -1 est retourné dans le
       contexte du père, aucun processus fils ne sera créé et PHP générera une erreur.

<comment>See Also:</comment>
   * <strong>pcntl_rfork()</strong>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_signal()</strong>
   * <strong>cli_set_process_title()</strong>


id: pcntl_get_last_error
type: function
doc:
<comment>Description:</comment>
  Récupère le numéro de l'erreur générée par la dernière fonction pcntl utilisée
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Return:</comment>
  <info>int</info>  Returns error code.

<comment>See Also:</comment>
   * <strong>pcntl_strerror()</strong>


id: pcntl_getpriority
type: function
doc:
<comment>Description:</comment>
  Retourne la priorité d'un processus
  
  <strong>pcntl_getpriority()</strong> retourne la priorité de  <strong>$process_id</strong>. Comme les niveaux de priorités changent
  entre les types de systèmes et les versions de kernel, lisez la page de manuel getpriority(2) de
  votre système pour des détails spécifiques.

<comment>Param:</comment>
  <info>int|null</info>  <strong>$process_id</strong>  Si <info>null</info>, l'identifiant du processus courant est utilisé.
  <info>int</info>       <strong>$mode</strong>        Une constante parmi <info>PRIO_PGRP</info>, <info>PRIO_USER</info>, <info>PRIO_PROCESS</info>, <info>PRIO_DARWIN_BG</info> ou
                         <info>PRIO_DARWIN_THREAD</info>.

<comment>Return:</comment>
  <info>int|false</info>  <strong>pcntl_getpriority()</strong> retourne la priorité du processus ou <info>false</info> en cas d'erreur. Une
             valeur numérique plus petite rend la planification plus favorable.
             
             Cette fonction peut retourner <info>false</info>, mais elle peut aussi retourner une valeur
             équivalent à <info>false</info>. Veuillez lire la section sur les booléens pour plus d'informations.
             Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

<comment>See Also:</comment>
   * <strong>pcntl_setpriority()</strong>


id: pcntl_rfork
type: function
doc:
<comment>Description:</comment>
  Manipulates process resources
  
  Manipulates process resources.

<comment>Param:</comment>
  <info>int</info>  <strong>$flags</strong>   The <strong>$flags</strong> parameter determines which resources of the invoking process (parent) are
                shared by the new process (child) or initialized to their default values.
                
                <strong>$flags</strong> is the logical OR of some subset of: <info>RFPROC</info>: If set a new process is created;
                otherwise changes affect the current process. <info>RFNOWAIT</info>: If set, the child process
                will be dissociated from the parent. Upon exit the child will not leave a status for
                the parent to collect. <info>RFFDG</info>: If set, the invoker's file descriptor table is copied;
                otherwise the two processes share a single table. <info>RFCFDG</info>: If set, the new process
                starts with a clean file descriptor table. Is mutually exclusive with <return>RFFDG</return>.
                <info>RFLINUXTHPN</info>: If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread
                exit for the child. This is intended to do Linux clone exit parent notification.
  <info>int</info>  <strong>$signal</strong>  The signal number.

<comment>Return:</comment>
  <info>int</info>  On success, the PID of the child process is returned in the parent's thread of execution, and
       a <return>0</return> is returned in the child's thread of execution.  On failure, a <return>-1</return> will be returned in the
       parent's context, no child process will be created, and a PHP error is raised.

<comment>See Also:</comment>
   * <strong>pcntl_fork()</strong>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_signal()</strong>
   * <strong>cli_set_process_title()</strong>


id: pcntl_setpriority
type: function
doc:
<comment>Description:</comment>
  Change la priorité d'un processus
  
  <strong>pcntl_setpriority()</strong> change la priorité de <strong>$process_id</strong> à <strong>$priority</strong>.

<comment>Param:</comment>
  <info>int</info>       <strong>$priority</strong>    <strong>$priority</strong> est généralement une valeur allant de  <return>-20</return> à <return>20</return>. La priorité par
                         défaut est <return>0</return> tandis qu'une valeur numérique plus petite favorise une
                         meilleure planification. Comme les niveaux de priorité changent entre les
                         types de systèmes et les versions de kernel, lisez la page de manuel
                         getpriority(2) de votre système pour des détails  spécifiques.
  <info>int|null</info>  <strong>$process_id</strong>  Si <info>null</info>, l'identifiant du processus courant est utilisé.
  <info>int</info>       <strong>$mode</strong>        Une constante parmi <info>PRIO_PGRP</info>, <info>PRIO_USER</info>, <info>PRIO_PROCESS</info>, <info>PRIO_DARWIN_BG</info> ou
                         <info>PRIO_DARWIN_THREAD</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pcntl_getpriority()</strong>
   * <strong>pcntl_setpriority()</strong>


id: pcntl_signal
type: function
doc:
<comment>Description:</comment>
  Installe un gestionnaire de signaux
  
  <strong>pcntl_signal()</strong> installe un nouveau gestionnaire de signaux ou remplace le gestionnaire de signaux
  courant pour le signal indiqué par le paramètre <strong>$signal</strong>.

<comment>Param:</comment>
  <info>int</info>           <strong>$signal</strong>            Le numéro du signal.
  <info>callable|int</info>  <strong>$handler</strong>           Le gestionnaire de signaux. Peut être un <info>callable</info>, qui sera
                                   appelé pour gérer le signal, ou bien l'une des deux constantes
                                   globales <info>SIG_IGN</info> ou <info>SIG_DFL</info>, qui vont, respectivement, ignorer le
                                   signal ou restaurer le gestionnaire de signaux par défaut.
                                   
                                   Si un <info>callable</info> est fourni, il doit implémenter la signature
                                   suivante :
                                   
                                   <info>void</info>handler<info>int</info><strong>$signo</strong><info>mixed</info><strong>$siginfo</strong><strong>$signal</strong> Le signal à gérer.
                                   <strong>$siginfo</strong> Si le système d'exploitation supporte les structures
                                   siginfo_t, ceci sera un tableau d'informations du signal qui
                                   dépendent du signal.
                                   
                                   Le signal à gérer.
                                   
                                   Si le système d'exploitation supporte les structures siginfo_t,
                                   ceci sera un tableau d'informations du signal qui dépendent du
                                   signal.
                                   
                                   Notez que lorsque vous configurez le gestionnaire avec une
                                   méthode d'objet, le compteur de référence de l'objet est
                                   incrémenté, ce qui le rend persistant jusqu'à ce que vous
                                   changiez le gestionnaire de signaux pour un autre, ou que le
                                   script se termine.
  <info>int</info>           <strong>$signal</strong>            Le signal à gérer.
  <info>mixed</info>         <strong>$siginfo</strong>           Si le système d'exploitation supporte les structures siginfo_t,
                                   ceci sera un tableau d'informations du signal qui dépendent du
                                   signal.
  <info>bool</info>          <strong>$restart_syscalls</strong>  Le paramètre optionnel <strong>$restart_syscalls</strong> spécifie si l'appel
                                   système de redémarrage (restarting) doit être utilisé lorsque ce
                                   signal arrive.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pcntl_fork()</strong>
   * <strong>pcntl_waitpid()</strong>


id: pcntl_signal_dispatch
type: function
doc:
<comment>Description:</comment>
  Appelle les gestionnaires de signaux pour chaque signal en attente
  
  La fonction <strong>pcntl_signal_dispatch()</strong> appelle les  gestionnaires de signaux installés par
  <strong>pcntl_signal()</strong> pour chaque signal en attente.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pcntl_signal()</strong>
   * <strong>pcntl_sigprocmask()</strong>
   * <strong>pcntl_sigwaitinfo()</strong>
   * <strong>pcntl_sigtimedwait()</strong>


id: pcntl_signal_get_handler
type: function
doc:
<comment>Description:</comment>
  Récupère le gestionnaire courant pour le signal spécifié
  
  La fonction <strong>pcntl_signal_get_handler()</strong> va récupérer le gestionnaire courant pour le <strong>$signal</strong>
  spécifié.

<comment>Param:</comment>
  <info>int</info>  <strong>$signal</strong>  Le numéro du signal.

<comment>Return:</comment>
  <info>callable|int</info>  Cette fonction peut retourner une valeur entière qui réfère soit à <info>SIG_DFL</info> ou à
                <info>SIG_IGN</info>. Si un gestionnaire personnalisé a été définit, ce <info>callable</info> est retourné.

<comment>See Also:</comment>
   * <strong>pcntl_signal()</strong>


id: pcntl_sigprocmask
type: function
doc:
<comment>Description:</comment>
  Liste et configure les signaux bloqués
  
  La fonction <strong>pcntl_sigprocmask()</strong> ajoute, retire ou configure les signaux bloqués, en fonction du
  paramètre <strong>$mode</strong>.

<comment>Param:</comment>
  <info>int</info>    <strong>$mode</strong>         Configure le comportement de <strong>pcntl_sigprocmask()</strong>. Les valeurs possibles sont
                       :  <info>SIG_BLOCK</info> : ajout le signal à la liste des signaux bloquésé.<info>SIG_UNBLOCK</info>:
                       retire le signal de la liste des signaux bloqués. <info>SIG_SETMASK</info> : remplace la
                       liste actuelle de signaux bloqués par une nouvelle liste.
  <info>array</info>  <strong>$signals</strong>      Liste de signaux.
  <info>array</info>  <strong>$old_signals</strong>  Le paramètre <strong>$old_signals</strong> est un tableau qui contient la liste précédente des
                       signaux bloqués.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pcntl_sigwaitinfo()</strong>
   * <strong>pcntl_sigtimedwait()</strong>


id: pcntl_sigtimedwait
type: function
doc:
<comment>Description:</comment>
  Attend un signal dans un délai donné
  
  La fonction <strong>pcntl_sigtimedwait()</strong> opère exactement comme <strong>pcntl_sigwaitinfo()</strong> hormis le fait qu'elle
  prend deux paramètres supplémentaires : <strong>$seconds</strong> et <strong>$nanoseconds</strong>, qui établissent une durée
  maximale d'attente.

<comment>Param:</comment>
  <info>array</info>  <strong>$signals</strong>      Une liste de signaux à attendre.
  <info>array</info>  <strong>$info</strong>         Le paramètre <strong>$info</strong> reçoit les informations du signal, sous forme de tableau.
                       Voyez  <strong>pcntl_sigwaitinfo()</strong>.
  <info>int</info>    <strong>$seconds</strong>      Délai d'attente maximal en secondes.
  <info>int</info>    <strong>$nanoseconds</strong>  Délai d'attente maximal en nanosecondes.

<comment>Return:</comment>
  <info>int|false</info>  <strong>pcntl_sigtimedwait()</strong> retourne un numéro du signal en cas de succès,  ou <info>false</info> si une
             erreur survient.

<comment>See Also:</comment>
   * <strong>pcntl_sigprocmask()</strong>
   * <strong>pcntl_sigwaitinfo()</strong>


id: pcntl_sigwaitinfo
type: function
doc:
<comment>Description:</comment>
  Attend un signal
  
  La fonction <strong>pcntl_sigwaitinfo()</strong> suspend son exécution jusqu'à la réception d'un des signaux,
  indiqué dans <strong>$signals</strong>. Si un des signaux est déjà en attente (i.e., bloqué par
  <strong>pcntl_sigprocmask()</strong>),  <strong>pcntl_sigwaitinfo()</strong> se termine immédiatement.

<comment>Param:</comment>
  <info>array</info>  <strong>$signals</strong>  Un tableau de signaux à attendre.
  <info>array</info>  <strong>$info</strong>     Le paramètre <strong>$info</strong> reçoit un tableau contenant les informations sur le signal.
                   
                   Les éléments suivants sont toujours disponibles pour tous les signaux : signo :
                   numéro de signalerrno : un numéro d'erreurcode : code de signal
                   
                   Les éléments suivants peuvent être disponibles pour le signal  <info>SIGCHLD</info> : status :
                   valeur de sortie ou signalutime : temps utilisateur consomméstime : temps système
                   consommépid : numéro de processus appelantuid : identifiant de l'utilisateur
                   appelant, ou du processus appelant
                   
                   Les éléments suivants peuvent être disponibles pour les signaux <info>SIGILL</info>, <info>SIGFPE</info>,
                   <info>SIGSEGV</info> et <info>SIGBUS</info> : addr : adresse mémoire qui a causé l'erreur
                   
                   Les éléments suivants peuvent être disponibles pour le signal  <info>SIGPOLL</info> :  band :
                   événement de bandfd : numéro de pointeur de fichier

<comment>Return:</comment>
  <info>int|false</info>  Retourne un numéro du signal en cas de succès, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pcntl_sigprocmask()</strong>
   * <strong>pcntl_sigtimedwait()</strong>


id: pcntl_strerror
type: function
doc:
<comment>Description:</comment>
  Récupère le message d'erreur système associé avec l'errno fourni
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>int</info>  <strong>$error_code</strong>  

<comment>Return:</comment>
  <info>string</info>  Retourne la description de l'erreur.

<comment>See Also:</comment>
   * <strong>pcntl_get_last_error()</strong>


id: pcntl_unshare
type: function
doc:
<comment>Description:</comment>
  Dissociates parts of the process execution context
  
  <strong>pcntl_unshare()</strong> allows a process to disassociate parts of its execution context that are currently
  being shared with other processes. The main use of <strong>pcntl_unshare()</strong> is to allow a process to
  control its shared execution context without creating a new process.

<comment>Param:</comment>
  <info>int</info>  <strong>$flags</strong>  The <strong>$flags</strong> parameter is a bitmask that specifies which parts of the execution context
               should be unshared. This parameter is specified by ORing together zero or more of the
               <return>CLONE_*</return> constants:
               <info>CLONE_NEWNS</info><info>CLONE_NEWIPC</info><info>CLONE_NEWUTS</info><info>CLONE_NEWNET</info><info>CLONE_NEWPID</info><info>CLONE_NEWUSER</info><info>CLONE_NEWCGROUP</info>

<comment>Return:</comment>
  <info>bool</info>  Returns <return>0</return> on success, <return>-1</return> otherwise. On failure it sets an error code, that can be retrieved
        with <strong>pcntl_get_last_error()</strong>.

<comment>See Also:</comment>
   * PCNTL Constants
   * <strong>pcntl_get_last_error()</strong>


id: pcntl_wait
type: function
doc:
<comment>Description:</comment>
  Attend ou retourne le statut d'un processus fils
  
  <strong>pcntl_wait()</strong> suspend l'exécution du processus courant jusqu'à ce qu'un des processus fils soit
  terminé, ou qu'un signal soit envoyé pour terminer le processus courant ou  pour appeler un
  gestionnaire. Si le processus est déjà terminé au moment de l'appel de la fonction, c'est-à-dire
  si le processus est un zombie, alors la fonction se termine immédiatement. Toutes les ressources
  système utilisées par le processus fils sont libérées. Lisez le manuel de votre système à wait(2)
  pour avoir des détails spécifiques sur le fonctionnement de wait() sur celui-ci.
  
  Cette fonction est équivalente à appeler la fonction <strong>pcntl_waitpid()</strong> avec un <strong>$process_id</strong> valant <return>-1</return>
  et aucun <strong>$flags</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  <strong>pcntl_wait()</strong> va stocker les informations de statut dans le paramètre <strong>$status</strong> qui
                peut être lu avec les fonctions suivantes : <strong>pcntl_wifexited()</strong>, <strong>pcntl_wifstopped()</strong>,
                <strong>pcntl_wifsignaled()</strong>, <strong>pcntl_wexitstatus()</strong>, <strong>pcntl_wtermsig()</strong> et <strong>pcntl_wstopsig()</strong>.
  <info>int</info>  <strong>$flags</strong>   Si wait3 est disponible sur votre système (c'est le cas de la plupart des systèmes
                BSD-), vous pouvez ajouter le paramètre optionnel <strong>$flags</strong>. S'il n'est pas fourni,
                wait() sera utilisé pour l'appel système. Si wait3 n'est pas disponible, le
                paramètre <strong>$flags</strong> n'aura pas d'effet. La valeur de <strong>$flags</strong> est la combinaison de zéro
                ou plusieurs des constantes suivantes : Valeurs possibles pour <strong>$flags</strong><return>WNOHANG</return> Termine
                immédiatement si aucun processus ne s'est terminé. <return>WUNTRACED</return> Termine pour les
                processus qui sont stoppés, et pour ceux dont le résultat n'a pas été rapporté.

<comment>Return:</comment>
  <info>int</info>  <strong>pcntl_wait()</strong> retourne l'identifiant de processus qui s'est terminé, -1 en cas d'erreur ou
       zéro si WNOHANG a été fourni comme option (disponible sur les systèmes wait3), et qu'aucun
       processus fils n'était disponible.

<comment>See Also:</comment>
   * <strong>pcntl_fork()</strong>
   * <strong>pcntl_signal()</strong>
   * <strong>pcntl_wifexited()</strong>
   * <strong>pcntl_wifstopped()</strong>
   * <strong>pcntl_wifsignaled()</strong>
   * <strong>pcntl_wexitstatus()</strong>
   * <strong>pcntl_wtermsig()</strong>
   * <strong>pcntl_wstopsig()</strong>
   * <strong>pcntl_waitpid()</strong>


id: pcntl_waitpid
type: function
doc:
<comment>Description:</comment>
  Attend la fin de l'exécution d'un processus fils
  
  Suspend l'exécution du processus courant jusqu'à ce qu'un processus fils spécifié par le paramètre
  <strong>$process_id</strong> ait terminé, qu'un signal ait mis fin à ce processus ou qu'un signal ait appelé un
  gestionnaire de signaux.
  
  Si le processus fils identifié par <strong>$process_id</strong> est déjà terminé au moment de l'appel de cette
  fonction (on les appelle des processus "zombie"), la fonction se termine immédiatement. Toute
  ressource système utilisée par le processus fils est libérée. Reportez-vous à la page de man
  waitpid(2) pour avoir des détails sur le comportement de cette fonction sur votre système.

<comment>Param:</comment>
  <info>int</info>  <strong>$process_id</strong>  La valeur de <strong>$process_id</strong> peut être une parmi les suivantes : Valeurs possibles
                    pour <strong>$process_id</strong><return>\< -1</return> attend que tous les processus fils dont l'identifiant de
                    groupe est égal à la valeur absolue de <strong>$process_id</strong> soient terminés. <return>-1</return> attend
                    que tous les processus fils soient terminés. Ceci est le même comportement que
                    celui de la fonction <strong>pcntl_wait()</strong>. <return>0</return> attend que tous les processus fils dont
                    l'identifiant de groupe est égal à celui du processus courant soient terminés.
                    <return>&gt; 0</return> attend que le processus fils dont l'identifiant est égal à <strong>$process_id</strong>
                    soit terminé.
                    
                    Si <strong>$process_id</strong> vaut <return>-1</return>, cela équivaut à utiliser la fonction <strong>pcntl_wait()</strong> (moins
                    <strong>$flags</strong>).
  <info>int</info>  <strong>$status</strong>      <strong>pcntl_waitpid()</strong> enregistrera des informations sur le statut courant du processus
                    dans le paramètre <strong>$status</strong>, auquel on peut accéder grâce aux fonctions suivantes
                    : <strong>pcntl_wifexited()</strong>, <strong>pcntl_wifstopped()</strong>, <strong>pcntl_wifsignaled()</strong>,
                    <strong>pcntl_wexitstatus()</strong>, <strong>pcntl_wtermsig()</strong> et <strong>pcntl_wstopsig()</strong>.
  <info>int</info>  <strong>$flags</strong>       Le paramètre <strong>$flags</strong> peut prendre la valeur zéro, ou plusieurs des constantes
                    globales suivantes (combinez les avec l'opérateur <return>OR</return>) : Valeurs possibles de
                    <strong>$flags</strong><return>WNOHANG</return> retourne immédiatement si aucun processus fils ne s'est terminé.
                    <return>WUNTRACED</return> retourne lorsque les processus fils sont arrêtés et que leur statut
                    n'a pas été mis à jour.

<comment>Return:</comment>
  <info>int</info>  <strong>pcntl_waitpid()</strong> retourne l'identifiant de processus du processus fils qui s'est terminé, ou
       bien -1 en cas d'erreur ou encore zéro si <info>WNOHANG</info> a été utilisée et qu'aucun processus fils
       n'était disponible.

<comment>See Also:</comment>
   * <strong>pcntl_fork()</strong>
   * <strong>pcntl_signal()</strong>
   * <strong>pcntl_wifexited()</strong>
   * <strong>pcntl_wifstopped()</strong>
   * <strong>pcntl_wifsignaled()</strong>
   * <strong>pcntl_wexitstatus()</strong>
   * <strong>pcntl_wtermsig()</strong>
   * <strong>pcntl_wstopsig()</strong>


id: pcntl_wexitstatus
type: function
doc:
<comment>Description:</comment>
  Retourne le code d'un processus fils terminé
  
  Retourne le code de retour du processus fils. Cette fonction n'est utile que si la fonction
  <strong>pcntl_wifexited()</strong> a retourné <info>true</info>.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  Le paramètre
                <strong>$status</strong> est le paramètre status passé à un appel
                de <strong>pcntl_waitpid()</strong> ayant réussi.

<comment>Return:</comment>
  <info>int|false</info>  Retourne le code de retour. Si la fonctionnalité n'est pas prise en charge par le
             système d'exploitation, <info>false</info> est retourné.

<comment>See Also:</comment>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_wifexited()</strong>


id: pcntl_wifexited
type: function
doc:
<comment>Description:</comment>
  Vérifie si le code de retour représente une fin normale
  
  Retourne <info>true</info> si le processus fils a retourné un code qui représente une fin normale.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  Le paramètre
                <strong>$status</strong> est le paramètre status passé à un appel
                de <strong>pcntl_waitpid()</strong> ayant réussi.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le processus fils a retourné un code qui représente une fin normale, <info>false</info>
        sinon.

<comment>See Also:</comment>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_wexitstatus()</strong>


id: pcntl_wifsignaled
type: function
doc:
<comment>Description:</comment>
  Retourne true si le code statut représente une fin due à un signal
  
  Retourne <info>true</info> si le processus fils sort car un signal n'a pu être reçu.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  Le paramètre
                <strong>$status</strong> est le paramètre status passé à un appel
                de <strong>pcntl_waitpid()</strong> ayant réussi.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le processus fils sort car un signal n'a pu être reçu, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_signal()</strong>


id: pcntl_wifstopped
type: function
doc:
<comment>Description:</comment>
  Retourne true si le processus fils est stoppé
  
  Retourne <info>true</info> si le processus fils est stoppé ; cela n'est possible que si l'appel à
  <strong>pcntl_waitpid()</strong> a été fait avec l'option  <return>WUNTRACED</return>.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  Le paramètre
                <strong>$status</strong> est le paramètre status passé à un appel
                de <strong>pcntl_waitpid()</strong> ayant réussi.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le processus fils est stoppé, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>pcntl_waitpid()</strong>


id: pcntl_wstopsig
type: function
doc:
<comment>Description:</comment>
  Retourne le signal qui a causé l'arrêt du processus fils
  
  Retourne le numéro du signal qui a causé l'arrêt du processus fils. Cette fonction est uniquement
  utile si <strong>pcntl_wifstopped()</strong> a retourné <info>true</info>.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  Le paramètre
                <strong>$status</strong> est le paramètre status passé à un appel
                de <strong>pcntl_waitpid()</strong> ayant réussi.

<comment>Return:</comment>
  <info>int|false</info>  Retourne le numéro du signal. Si la fonctionnalité n'est pas prise en charge par le
             système d'exploitation, <info>false</info> est retourné.

<comment>See Also:</comment>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_wifstopped()</strong>


id: pcntl_wtermsig
type: function
doc:
<comment>Description:</comment>
  Retourne le signal qui a provoqué la fin du processus fils
  
  Retourne le numéro du signal qui a provoqué la fin du processus fils. Cette fonction est
  uniquement utile si <strong>pcntl_wifsignaled()</strong> retourne <info>true</info>.

<comment>Param:</comment>
  <info>int</info>  <strong>$status</strong>  Le paramètre
                <strong>$status</strong> est le paramètre status passé à un appel
                de <strong>pcntl_waitpid()</strong> ayant réussi.

<comment>Return:</comment>
  <info>int|false</info>  Retourne le numéro du signal. Si la fonctionnalité n'est pas prise en charge par le
             système d'exploitation, <info>false</info> est retourné.

<comment>See Also:</comment>
   * <strong>pcntl_waitpid()</strong>
   * <strong>pcntl_signal()</strong>
   * <strong>pcntl_wifsignaled()</strong>


id: pfsockopen
type: function
doc:
<comment>Description:</comment>
  Ouvre un socket de connexion Internet ou Unix persistante
  
  <strong>pfsockopen()</strong> se comporte exactement comme <strong>fsockopen()</strong> mais la connexion ouverte le reste, même
  après la fin du script. C'est la version persistante de <strong>fsockopen()</strong>.

<comment>Return:</comment>
  <info>resource|false</info>  <strong>pfsockopen()</strong> retourne un pointeur de fichier qui peut être utilisé avec d'autres
                  functions de fichier (tel que <strong>fgets()</strong>, <strong>fgetss()</strong>, <strong>fwrite()</strong>, <strong>fclose()</strong>, et <strong>feof()</strong>),
                  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>fsockopen()</strong>


id: pg_affected_rows
type: function
doc:
<comment>Description:</comment>
  Retourne le nombre de lignes affectées
    
  
  <strong>pg_affected_rows()</strong> retourne le nombre de lignes affectées par les requêtes de type <return>INSERT</return>, <return>UPDATE</return>
  et <return>DELETE</return>.
  
  Depuis PostgreSQL 9.0 et suivants, le serveur retourne le nombre de lignes sélectionnées. Pour les
  versions antérieures, PostgreSQL retourne 0 pour les SELECT.
  
  Auparavant, cette fonction s'appelait <strong>pg_cmdtuples()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).

<comment>Return:</comment>
  <info>int</info>  Le nombre de lignes affectées par la requête. S'il n'y a pas de tuple affecté, la fonction
       retournera <return>0</return>.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_query_params()</strong>
   * <strong>pg_execute()</strong>
   * <strong>pg_num_rows()</strong>


id: pg_cancel_query
type: function
doc:
<comment>Description:</comment>
  Annule une requête asynchrone
    
  
  <strong>pg_cancel_query()</strong> annule la requête asynchrone, démarrée avec <strong>pg_send_query()</strong>,
  <strong>pg_send_query_params()</strong> ou <strong>pg_send_execute()</strong>.  Vous ne pouvez pas annuler une requête démarrée avec
  <strong>pg_query()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_send_query()</strong>
   * <strong>pg_connection_busy()</strong>


id: pg_client_encoding
type: function
doc:
<comment>Description:</comment>
  Lit l'encodage du client
    
  
  PostgreSQL supporte la conversion automatique entre le serveur et le client pour certains jeux de
  caractères. <strong>pg_client_encoding()</strong> retourne l'encodage du client. La chaîne de retour sera un des
  encodages standards de PostgreSQL.
  
  Cette fonction requiert PostgreSQL version 7.0 ou plus récent. Si la bibliothèque libpq est
  compilée sans le support de l'encodage multioctets, <strong>pg_client_encoding()</strong> retournera toujours
  <return>SQL_ASCII</return>. Le support de l'encodage dépend de la version de PostgreSQL. Référez-vous à la
  documentation de PostgreSQL sur les encodages supportés.
  
  Auparavant, cette fonction s'appelait <strong>pg_clientencoding()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  L'encodage du client.

<comment>See Also:</comment>
   * <strong>pg_set_client_encoding()</strong>


id: pg_close
type: function
doc:
<comment>Description:</comment>
  Termine une connexion PostgreSQL
    
  
  <strong>pg_close()</strong> ferme la connexion au serveur PostgreSQL associé à <strong>$connection</strong>.
  
  Il n'est généralement pas nécessaire de fermer une connexion non persistante, car elles sont
  automatiquement fermées à la fin d'un script.
  
  Si des instances de <class>PgSql\Lob</class> qui ont été ouverts avec cette connexion, ne fermez pas la connexion
  avant d'avoir fermé toutes les instances de <class>PgSql\Lob</class>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>true</info>  Retourne toujours <info>true</info>.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>


id: pg_connect
type: function
doc:
<comment>Description:</comment>
  Établit une connexion PostgreSQL
    
  
  <strong>pg_connect()</strong> ouvre une connexion à une base de données PostgreSQL grâce à la chaîne de connexion
  <strong>$connection_string</strong>.
  
  Si un deuxième appel à <strong>pg_connect()</strong> est fait avec les mêmes arguments, aucune nouvelle connexion
  ne sera établie à moins que vous ne passiez <info>PGSQL_CONNECT_FORCE_NEW</info> à <strong>$flags</strong>, mais la connexion
  précédente sera retournée.
  
  L'ancienne syntaxe  $conn = pg_connect("host", "port", "options", "tty", "dbname")  est obsolète.

<comment>Param:</comment>
  <info>string</info>  <strong>$connection_string</strong>  La chaîne <strong>$connection_string</strong> peut être vide pour utiliser tous les
                              paramètres par défaut ou elle peut contenir un ou plusieurs paramètres
                              de configuration séparés par des espaces. Chaque paramètre de
                              configuration est sous la forme <return>code = valeur</return>. Les espaces autour du
                              signe égal sont optionnels. Pour écrire une valeur vide ou une valeur
                              contenant des espaces, entourez cette valeur avec des apostrophes, par
                              exemple : <return>code = 'une valeur'</return>. Les apostrophes et les antislashs à
                              l'intérieur de la valeur doivent être échappés par un antislash,
                              c'est-à-dire \' et \\.
                              
                              Les mots-clé actuellement reconnus sont : <strong>$host</strong>, <strong>$hostaddr</strong>, <strong>$port</strong>,
                              <strong>$dbname</strong> (valeur par défaut: <strong>$user</strong>), <strong>$user</strong>, <strong>$password</strong>,
                              <strong>$connect_timeout</strong>, <strong>$options</strong>, <strong>$tty</strong> (ignoré), <strong>$sslmode</strong>, <strong>$requiressl</strong>
                              (obsolète, utilisez <strong>$sslmode</strong>) et <strong>$service</strong>. La liste de ces arguments
                              dépend de la version de votre serveur PostgreSQL.
                              
                              Le paramètre <strong>$options</strong> peut être utilisé pour passer des paramètres
                              pour la ligne de commande invoquant le serveur.
  <info>int</info>     <strong>$flags</strong>              Si <info>PGSQL_CONNECT_FORCE_NEW</info> est passé en argument, alors une nouvelle
                              connexion sera créée, même si la chaîne <strong>$connection_string</strong> est
                              identique à celle de la connexion existante.
                              
                              Si <info>PGSQL_CONNECT_ASYNC</info> est fourni, la connexion sera établie de façon
                              asynchrone. Le statut de la connexion peut être vérifié via la
                              fonction <strong>pg_connect_poll()</strong> ou via la fonction <strong>pg_connection_status()</strong>.

<comment>Return:</comment>
  <info>PgSql\Connection|false</info>  Retourne une instance de <class>PgSql\Connection</class> en cas de succès,  ou <info>false</info> si
                          une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_pconnect()</strong>
   * <strong>pg_close()</strong>
   * <strong>pg_host()</strong>
   * <strong>pg_port()</strong>
   * <strong>pg_tty()</strong>
   * <strong>pg_options()</strong>
   * <strong>pg_dbname()</strong>


id: pg_connect_poll
type: function
doc:
<comment>Description:</comment>
  Test le statut d'une tentative de connexion asynchrone PostgreSQL en cours
    
  
  La fonction <strong>pg_connect_poll()</strong> teste le statut d'une connexion PostgreSQL créée en appelant la
  fonction <strong>pg_connect()</strong> avec l'option <info>PGSQL_CONNECT_ASYNC</info>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>int</info>  Retourne la constante <info>PGSQL_POLLING_FAILED</info>, <info>PGSQL_POLLING_READING</info>, <info>PGSQL_POLLING_WRITING</info>,
       <info>PGSQL_POLLING_OK</info>, ou la constante <info>PGSQL_POLLING_ACTIVE</info>.


id: pg_connection_busy
type: function
doc:
<comment>Description:</comment>
  Vérifie si la connexion PostgreSQL est occupée
   
  
  <strong>pg_connection_busy()</strong> détermine si la connexion est occupée. Si elle est occupée, une requête a
  déjà été  lancée, et est en cours. Si <strong>pg_get_result()</strong> est utilisée, elle sera alors bloquée.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si la connexion est occupée, sinon <info>false</info>.

<comment>See Also:</comment>
   * <strong>pg_connection_status()</strong>
   * <strong>pg_get_result()</strong>


id: pg_connection_reset
type: function
doc:
<comment>Description:</comment>
  Relance la connexion au serveur PostgreSQL
    
  
  <strong>pg_connection_reset()</strong> effectue une reconnexion au serveur, avec les mêmes paramètres que lors de
  la connexion précédente avec <strong>$connection</strong>. Cette fonction est pratique pour le traitement des
  erreurs.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>
   * <strong>pg_pconnect()</strong>
   * <strong>pg_connection_status()</strong>


id: pg_connection_status
type: function
doc:
<comment>Description:</comment>
  Lit le statut de la connexion PostgreSQL
    
  
  <strong>pg_connection_status()</strong> retourne le statut de la connexion <strong>$connection</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>int</info>  <info>PGSQL_CONNECTION_OK</info> ou  <info>PGSQL_CONNECTION_BAD</info>.

<comment>See Also:</comment>
   * <strong>pg_connection_busy()</strong>


id: pg_consume_input
type: function
doc:
<comment>Description:</comment>
  Lit l'entrée de la connexion
  
  La fonction <strong>pg_consume_input()</strong> lit toutes les entrées en attente d'être lues depuis le serveur de
  base de données.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  <info>true</info> en cas de succès, ou <info>false</info> si une erreur survient. Notez que <info>true</info> n'indique pas
        forcément que l'entrée est en attente d'être lue.


id: pg_convert
type: function
doc:
<comment>Description:</comment>
  Convertit des valeurs d'un tableaux associatifs en une forme convenable pour des requêtes SQL
    
  
  <strong>pg_convert()</strong> vérifie et convertit le tableau associatif <strong>$values</strong> en une requête SQL valide. Pour
  que <strong>pg_convert()</strong> fonctionne, il faut que la table <strong>$table_name</strong> existe, et contienne au moins autant
  de colonnes que le tableau <strong>$values</strong> a d'éléments. Les noms des champs de <strong>$table_name</strong> doivent
  correspondre aux index du tableau dans <strong>$values</strong>. Retourne un tableau avec les valeurs converties en
  cas de succès, et sinon, <info>false</info>.
  
  Les valeurs booléennes sont acceptées et convertie en booléen PostgreSQL. Les représentations de
  valeurs booléennes sous forme de chaînes de caractères sont également supportées. <info>null</info> est
  converti en NULL PostgreSQL.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Nom de la table sur pour laquelle les types seront convertis.
  <info>array</info>             <strong>$values</strong>      Données à être converties.
  <info>int</info>               <strong>$flags</strong>       Un nombre de <info>PGSQL_CONV_IGNORE_DEFAULT</info>,  <info>PGSQL_CONV_FORCE_NULL</info> ou
                                 <info>PGSQL_CONV_IGNORE_NOT_NULL</info>, combiné.

<comment>Return:</comment>
  <info>array|false</info>  Un tableau des valeurs converties,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_meta_data()</strong>
   * <strong>pg_insert()</strong>
   * <strong>pg_select()</strong>
   * <strong>pg_update()</strong>
   * <strong>pg_delete()</strong>


id: pg_copy_from
type: function
doc:
<comment>Description:</comment>
  Insère des lignes dans une table à partir d'un tableau
    
  
  <strong>pg_copy_from()</strong> insère les éléments du tableau <strong>$rows</strong> dans une table. Cette fonction utilise la
  commande SQL interne <return>COPY FROM</return>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Nom de la table dans laquelle <strong>$rows</strong> sera copié.
  <info>array</info>             <strong>$rows</strong>        Un tableau de données à être copié à l'intérieur de <strong>$table_name</strong>.
                                 Chaque valeur dans <strong>$rows</strong> devient une ligne dans <strong>$table_name</strong>. Chaque
                                 valeur dans <strong>$rows</strong> devrait être une chaîne délimitée par des valeurs
                                 à insérer à l'intérieur de chaque champ. Les valeurs doivent être
                                 terminées par un saut à la ligne.
  <info>string</info>            <strong>$separator</strong>   Le marqueur qui sépare les valeurs pour chaque champ dans chaque
                                 élément de <strong>$rows</strong>. Par défaut <return>\t</return>.
  <info>string</info>            <strong>$null_as</strong>     Comment les valeurs <return>NULL</return> de SQL sont représentées dans <strong>$rows</strong>. Par
                                 défaut <return>\\N</return> (<return>"\\\\N"</return>).

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_copy_to()</strong>


id: pg_copy_to
type: function
doc:
<comment>Description:</comment>
  Copie une table dans un tableau
    
  
  <strong>pg_copy_to()</strong> copie la table  <strong>$table_name</strong> dans un tableau. Cette fonction utilise la commande
  interne SQL <return>COPY TO</return> pour insérer les tableaux.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Nom de la table à partir de laquelle les données dans <strong>$rows</strong> seront
                                 copiées.
  <info></info>                  <strong>$delimiter</strong>   Le marqueur qui sépare les valeurs pour chaque champ dans chaque
                                 élément de <strong>$rows</strong>. Par défaut <return>\t</return>.
  <info>string</info>            <strong>$null_as</strong>     Comment les valeurs <return>NULL</return> de SQL sont représentées dans <strong>$rows</strong>. Par
                                 défaut <return>\\N</return> (<return>"\\\\N"</return>).

<comment>Return:</comment>
  <info>array|false</info>  Un tableau avec un élément pour chaque ligne de données <return>COPY</return>,  ou <info>false</info> si une erreur
               survient.

<comment>See Also:</comment>
   * <strong>pg_copy_from()</strong>


id: pg_dbname
type: function
doc:
<comment>Description:</comment>
  Retourne le nom de la base de données PostgreSQL
    
  
  <strong>pg_dbname()</strong> retourne le nom de la base de données PostgreSQL associée à la connexion <strong>$connection</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de type <info>string</info> contenant le nom de la base de données associée à la connexion
          <strong>$connection</strong>.


id: pg_delete
type: function
doc:
<comment>Description:</comment>
  Efface des lignes PostgreSQL
    
  
  <strong>pg_delete()</strong> efface les lignes d'une table spécifiées par les clés et valeur du tableau associatif
  <strong>$conditions</strong>.
  
  Si <strong>$flags</strong> est fournit, <strong>pg_convert()</strong> est appliqué à <strong>$conditions</strong> avec les drapeaux fournit.
  
  Par défaut <strong>pg_delete()</strong> passe des valeurs brutes. Les valeurs doivent être échappé ou le drapeau
  <info>PGSQL_DML_ESCAPE</info> doit être spécifié dans <strong>$flags</strong>. <info>PGSQL_DML_ESCAPE</info> met des guillemets et échappe
  les paramètres/identifiants. Par conséquent, les noms de table/colonnes deviennent sensible à la
  casse.
  
  Notez que ni l'échappement ni les requêtes préparer peuvent protéger des requêtes LIKE, JSON,
  Tableaux, Regex, etc. Ces paramètres devraient être traité en fonction de leur contexte. C'est à
  dire échapper/valider les valeurs.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Nom de la table depuis laquelle les lignes seront effacées.
  <info>array</info>             <strong>$conditions</strong>  Un tableau où les clés sont les noms des champs de la table
                                 <strong>$table_name</strong> et où les valeurs sont les valeurs de ces champs qui
                                 sont à effacés.
  <info>int</info>               <strong>$flags</strong>       Toute combinaison des valeurs suivantes : <info>PGSQL_CONV_FORCE_NULL</info>,
                                 <info>PGSQL_DML_NO_CONV</info>, <info>PGSQL_DML_ESCAPE</info>, <info>PGSQL_DML_EXEC</info>,
                                 <info>PGSQL_DML_ASYNC</info> ou <info>PGSQL_DML_STRING</info>. Si <info>PGSQL_DML_STRING</info> fait
                                 partie du paramètre <strong>$flags</strong> alors, la requête sera retournée.
                                 Lorsque la constante <info>PGSQL_DML_NO_CONV</info> ou la constante
                                 <info>PGSQL_DML_ESCAPE</info> est définie,aucun appel à la fonction <strong>pg_convert()</strong>
                                 ne sera faite en interne.

<comment>Return:</comment>
  <info>string|bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
               Retourne une chaîne de caractères si <info>PGSQL_DML_STRING</info> est passé dans le paramètre
               <strong>$flags</strong>.

<comment>See Also:</comment>
   * <strong>pg_convert()</strong>


id: pg_end_copy
type: function
doc:
<comment>Description:</comment>
  Synchronise avec le serveur PostgreSQL
    
  
  <strong>pg_end_copy()</strong> synchronise le client PostgreSQL (normalement un processus serveur web) avec le
  serveur PostgreSQL, après une opération de copie faite par <strong>pg_put_line()</strong>. <strong>pg_end_copy()</strong> doit être
  utilisé, autrement le serveur PostgreSQL ne sera plus synchronisé avec le client et émettra une
  erreur.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_put_line()</strong>


id: pg_escape_bytea
type: function
doc:
<comment>Description:</comment>
  Protège une chaîne pour insertion dans un champ bytea
    
  
  <strong>pg_escape_bytea()</strong> protège les caractères de la chaîne <strong>$data</strong> avec le mode bytea. La chaîne protégée
  est retournée.
  
  Lorsque vous utilisez une commande <return>SELECT</return> avec des données de type bytea,  PostgreSQL retourne des
  valeurs octales, préfixées avec des antislashs '\' (par exemple \032). Les utilisateurs doivent
  effectuer la conversion en format binaire manuellement.
  
  <strong>pg_escape_bytea()</strong> requiert PostgreSQL 7.2 ou plus récent. Avec PostgreSQL 7.2.0 et 7.2.1, les
  données bytea doivent être transtypée  lorsque vous activez le support des chaînes de caractères
  multioctets. C'est-à-dire <return>INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);</return>.
  PostgreSQL 7.2.2 ou plus récent ne requiert pas cette manipulation. Toutefois, si le client et le
  serveur n'utilisent pas le même jeu de caractères, il peut arriver des erreurs. Il faut alors
  forcer le transtypage manuellement.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$data</strong>        Une chaîne de caractères contenant du texte ou des données binaires
                                 qui seront insérées dans la colonne bytea.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant les données échappées.

<comment>See Also:</comment>
   * <strong>pg_unescape_bytea()</strong>
   * <strong>pg_escape_string()</strong>


id: pg_escape_identifier
type: function
doc:
<comment>Description:</comment>
  Protège un identifiant pour l'insertion dans un champ texte.
    
  
  <strong>pg_escape_identifier()</strong> protège un identifiant (exemple: table, nom de champ) pour une requête en
  base de données. Le résultat est une chaîne de caractère protégée pour PostgreSQL.
  <strong>pg_escape_identifier()</strong> ajoute des guillemets avant et après les données. Les utilisateurs ne
  doivent donc pas ajouter de guillemets. L'utilisation de cette fonction est recommandée pour les
  les identifiants des requêtes. Pour les données brutes SQL (c'est à dire les paramètres, excepté
  de type bytea), <strong>pg_escape_literal()</strong> ou <strong>pg_escape_string()</strong> doit être utilisé. Pour les champs de
  type bytea il est nécessaire d'utiliser <strong>pg_escape_bytea()</strong>.
  
  Cette fonction a une protection de code interne et peut être utilisée pour PostgreSQL 8.4 ou moins
  récent.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$data</strong>        Une chaîne de caractères contenant du texte à protéger.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant les données protégées.

<comment>See Also:</comment>
   * <strong>pg_escape_literal()</strong>
   * <strong>pg_escape_bytea()</strong>
   * <strong>pg_escape_string()</strong>


id: pg_escape_literal
type: function
doc:
<comment>Description:</comment>
  Protège une requête SQL littérale à insérer dans un champ texte
    
  
  <strong>pg_escape_literal()</strong> protège une requête SQL littérale pour le requêtage à la base de données
  PostgreSQL. Le résultats retournée est une chaîne de caractère protégé au format PostgreSQL.
  <strong>pg_escape_literal()</strong> ajoute des simples  quotes avant et après les données. Les utilisateurs ne
  doivent donc pas ajouter des simples quotes. L'utilisation de cette fonction est recommandée à la
  place de <strong>pg_escape_string()</strong>.  Si la colonne est de type bytea, il convient d'utiliser à la place
  la fonction<strong>pg_escape_bytea()</strong>.  Pour protéger les identifiants (par exemple les noms de table, nom
  de champs), il convient d'utiliser la fonction <strong>pg_escape_identifier()</strong>.
  
  Cette fonction a une protection de code interne et peut être utilisée pour PostgreSQL 8.4 ou moins
  récent.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$data</strong>        Une chaîne de caractères contenant du texte à protéger.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant les données protégées.

<comment>See Also:</comment>
   * <strong>pg_escape_identifier()</strong>
   * <strong>pg_escape_bytea()</strong>
   * <strong>pg_escape_string()</strong>


id: pg_escape_string
type: function
doc:
<comment>Description:</comment>
  Protège une chaîne de caractères pour une requête SQL
    
  
  <strong>pg_escape_string()</strong> protège une chaîne de caractères pour l'insérer dans la base de données. Elle
  retourne la chaîne ainsi protégée au format PostgreSQL. L'utilisation de cette fonction est
  recommandée, à la place de <strong>addslashes()</strong>. Si le type de la colonne est bytea, <strong>pg_escape_bytea()</strong>
  doit plutôt être utilisée. La fonction <strong>pg_escape_identifier()</strong> doit être utilisée pour échapper les
  identifiants (i.e. noms de tables, noms de champs).
  
  Cette fonction requiert PostgreSQL 7.2 ou plus récent.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$data</strong>        Une chaîne de caractères contenant le texte à échapper.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant les données échappées.

<comment>See Also:</comment>
   * <strong>pg_escape_bytea()</strong>


id: pg_execute
type: function
doc:
<comment>Description:</comment>
  Exécute une requête préparée PostGreSQL
    
  
  Envoie une requête pour exécuter une requête préparée avec les paramètres donnés et attend le
  résultat.
  
  <strong>pg_execute()</strong> est comme <strong>pg_query_params()</strong>,  mais la commande qui sera exécutée est spécifiée en
  nommant une requête préalablement préparée, au lieu de donner une chaîne en tant que requête.
  Cette caractéristique permet aux commandes qui seront utilisées à plusieurs reprises d'être
  analysées et planifiées qu'une seule fois, plutôt que d'être exécutées chaque fois. La requête
  doit avoir été préalablement préparée dans la session courante. <strong>pg_execute()</strong> est supportée
  seulement avec les versions PostgreSQL 7.4 ou plus récentes; la commande échouera si vous
  l'utilisez avec des versions antérieures.
  
  Les paramètres sont identiques à la fonction <strong>pg_query_params()</strong> à l'exception du nom de la requête
  préparée qui est donnée à la place de la requête sous forme de chaîne.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$stmtname</strong>    Le nom de la requête préparée à exécuter. Si une chaîne vide est
                                 spécifiée (""), alors la requête qui n'est pas nommée est exécutée.
                                 Le nom doit avoir été précédemment préparé en utilisant
                                 <strong>pg_prepare()</strong>, <strong>pg_send_prepare()</strong> ou une commande SQL <return>PREPARE</return>.
  <info>array</info>             <strong>$params</strong>      Un tableau de valeurs de paramètres pour substituer les variables
                                 $1, $2, etc. dans la requête préparée originale. Le nombre
                                 d'éléments présents dans le tableau doit concorder avec le nombre
                                 de variables à remplacer.
                                 
                                 Les éléments sont convertis en chaînes de caractères en appelant
                                 cette fonction.

<comment>Return:</comment>
  <info>PgSql\Result|false</info>  Une instance de <class>PgSql\Result</class> en cas de succès,  ou <info>false</info> si une erreur
                      survient.

<comment>See Also:</comment>
   * <strong>pg_prepare()</strong>
   * <strong>pg_send_prepare()</strong>
   * <strong>pg_query_params()</strong>


id: pg_fetch_all
type: function
doc:
<comment>Description:</comment>
  Lit toutes les lignes d'un résultat
    
  
  <strong>pg_fetch_all()</strong> retourne un tableau qui contient toutes les lignes de <strong>$result</strong>.
  
  Cette fonction définit les champs NULL à la valeur PHP <info>null</info>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$mode</strong>    Un paramètre optionnel qui contrôle la façon dont le <info>array</info> retourné est
                         indexé.
                         <strong>$mode</strong> est une constante qui peut prendre les valeurs suivantes :
                         <info>PGSQL_ASSOC</info>, <info>PGSQL_NUM</info> et <info>PGSQL_BOTH</info>.
                         En utilisant <info>PGSQL_NUM</info>, la fonction retournera un tableau avec des indices
                         numériques,
                         en utilisant <info>PGSQL_ASSOC</info>, elle retournera seulement des indices associatifs
                         tandis que <info>PGSQL_BOTH</info> retournera à la fois des indices numériques et
                         associatifs.

<comment>Return:</comment>
  <info>array</info>  Un tableau <info>array</info> de toutes les lignes dans le jeu de résultats. Chaque ligne est un tableau
         de valeurs des champs indexée par le nom des champs.

<comment>See Also:</comment>
   * <strong>pg_fetch_row()</strong>
   * <strong>pg_fetch_array()</strong>
   * <strong>pg_fetch_object()</strong>
   * <strong>pg_fetch_result()</strong>


id: pg_fetch_all_columns
type: function
doc:
<comment>Description:</comment>
  Récupère toutes les lignes d'une colonne de résultats particulière en tant que tableau
    
  
  <strong>pg_fetch_all_columns()</strong> retourne un tableau qui contient toutes les lignes (enregistrements) d'une
  colonne particulière d'une ressource de résultats.
  
  Cette fonction définit les champs NULL à la valeur PHP <info>null</info>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field</strong>   Numéro de la colonne. Par défaut la première colonne si non-spécifié.

<comment>Return:</comment>
  <info>array</info>  Un tableau contenant toutes les valeurs d'une colonne du résultat.

<comment>See Also:</comment>
   * <strong>pg_fetch_all()</strong>


id: pg_fetch_array
type: function
doc:
<comment>Description:</comment>
  Lit une ligne de résultat PostgreSQL dans un tableau
    
  
  <strong>pg_fetch_array()</strong> retourne un tableau qui contient la ligne demandée.
  
  <strong>pg_fetch_array()</strong> est une version évoluée de <strong>pg_fetch_row()</strong>. En plus de proposer un tableau à
  indice numérique, elle peut aussi enregistrer les données dans un tableau associatif, en utilisant
  les noms des champs comme clés. Ces deux fonctions utilisent le tableau associatif par défaut.
  
  Cette fonction définit les champs NULL à la valeur PHP <info>null</info>.
  
  <strong>pg_fetch_array()</strong> n'est pas significativement plus lente que <strong>pg_fetch_row()</strong> et elle apporte un
  confort d'utilisation appréciable.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int|null</info>      <strong>$row</strong>     Numéro de la ligne à récupérer. Les lignes sont numérotées  en commençant à
                         0. Si l'argument est omis ou s'il vaut <info>null</info>, la ligne suivante est
                         récupérée.
  <info>int</info>           <strong>$mode</strong>    Un paramètre optionnel qui contrôle la façon dont le <info>array</info> retourné est
                         indexé.
                         <strong>$mode</strong> est une constante qui peut prendre les valeurs suivantes :
                         <info>PGSQL_ASSOC</info>, <info>PGSQL_NUM</info> et <info>PGSQL_BOTH</info>.
                         En utilisant <info>PGSQL_NUM</info>, la fonction retournera un tableau avec des indices
                         numériques,
                         en utilisant <info>PGSQL_ASSOC</info>, elle retournera seulement des indices associatifs
                         tandis que <info>PGSQL_BOTH</info> retournera à la fois des indices numériques et
                         associatifs.

<comment>Return:</comment>
  <info>array|false</info>  Un tableau à indice numérique (commençant à 0), associatif (indexé avec le nom des
               champs) ou les deux. Chaque valeur dans le tableau est représentée comme une chaîne
               (chaîne de caractères). Les valeurs <info>null</info> de la base de données sont retournées <info>null</info>.
               
               <info>false</info> est retournée si <strong>$row</strong> excède le nombre de lignes dans le jeu de résultats, n'a
               plus de ligne disponible ou tout autre erreur. Tenter de récupérer le résultat d'une
               requête autre que SELECT retournera aussi <info>false</info>.

<comment>See Also:</comment>
   * <strong>pg_fetch_row()</strong>
   * <strong>pg_fetch_object()</strong>
   * <strong>pg_fetch_result()</strong>


id: pg_fetch_assoc
type: function
doc:
<comment>Description:</comment>
  Lit une ligne de résultat PostgreSQL sous forme de tableau associatif 
    
  
  <strong>pg_fetch_assoc()</strong> retourne un tableau associatif qui  contient la ligne en cours dans le résultat
  <strong>$result</strong>.
  
  <strong>pg_fetch_assoc()</strong> est équivalent d'appeler <strong>pg_fetch_row()</strong> avec <info>PGSQL_ASSOC</info> comme troisième
  paramètre (qui est optionnel). Cela retournera seulement un tableau associatif. Si vous avez
  besoin d'indices numériques, utilisez <strong>pg_fetch_row()</strong>.
  
  Cette fonction définit les champs NULL à la valeur PHP <info>null</info>.
  
  <strong>pg_fetch_assoc()</strong> n'est pas significativement plus lente que <strong>pg_fetch_row()</strong> et elle apporte un
  confort d'utilisation appréciable.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int|null</info>      <strong>$row</strong>     Numéro de la ligne à récupérer. Les lignes sont numérotées en commençant à
                         0. Si l'argument est omis ou s'il vaut <info>null</info>, la ligne suivante est
                         récupérée.

<comment>Return:</comment>
  <info>array|false</info>  Un tableau à indice associatif (par nom de champ). Chaque valeur dans le tableau est
               représentée comme une chaîne de caractères. Les valeurs <info>null</info> de la base de données
               sont retournées <info>null</info>.
               
               <info>false</info> est retournée si <strong>$row</strong> excède le nombre de lignes dans le jeu de résultats, n'a
               plus de ligne disponible ou tout autre erreur.

<comment>See Also:</comment>
   * <strong>pg_fetch_row()</strong>
   * <strong>pg_fetch_array()</strong>
   * <strong>pg_fetch_object()</strong>
   * <strong>pg_fetch_result()</strong>


id: pg_fetch_object
type: function
doc:
<comment>Description:</comment>
  Lit une ligne de résultat PostgreSQL dans un objet
    
  
  <strong>pg_fetch_object()</strong> retourne un objet ainsi que ses propriétés qui correspond aux noms des champs de
  la ligne. La fonction peut optionnellement instancier un objet d'une classe spécifique et passer
  les paramètres au constructeur de cette classe.
  
  Cette fonction définit les champs NULL à la valeur PHP <info>null</info>.
  
  Du point de vue vitesse, la fonction est identique à <strong>pg_fetch_array()</strong> et est presque aussi rapide
  que <strong>pg_fetch_row()</strong> (la différence est insignifiante).

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>            Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>,
                                   <strong>pg_query_params()</strong>, ou <strong>pg_execute()</strong> (entre autres).
  <info>int|null</info>      <strong>$row</strong>               Numéro de la ligne à récupérer. Les lignes sont numérotées en
                                   commençant à 0. Si l'argument est omis ou s'il vaut <info>null</info>, la
                                   ligne suivante est récupérée.
  <info>string</info>        <strong>$class</strong>             Le nom de la classe à instancier, fixe les propriétés de
                                   celles-ci et ses valeurs de retour. Si rien n'est spécifié, un
                                   objet de style <class>stdClass</class> est retourné.
  <info>array</info>         <strong>$constructor_args</strong>  Paramètre optionnel de type <info>array</info> pour passer des arguments au
                                   constructeur de la classe <strong>$class</strong>.

<comment>Return:</comment>
  <info>object|false</info>  Un objet de type <info>object</info> avec les attributs pour chaque champ dans le jeu de
                résultats. Les valeurs <info>null</info> de la base de données sont retournées <info>null</info>.
                
                <info>false</info> est retournée si <strong>$row</strong> excède le nombre de lignes dans le jeu de résultats, n'a
                plus de ligne disponible ou tout autre erreur.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_fetch_array()</strong>
   * <strong>pg_fetch_assoc()</strong>
   * <strong>pg_fetch_row()</strong>
   * <strong>pg_fetch_result()</strong>


id: pg_fetch_result
type: function
doc:
<comment>Description:</comment>
  Retourne les valeurs d'un résultat
  
  <strong>pg_fetch_result()</strong> retourne la valeur d'une ligne et d'un champ (colonne) en particulier à partir
  d'une instance <class>PgSql\Result</class>.
  
  Cette fonction peut s'appeler <strong>pg_result()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$row</strong>     Numéro de la ligne à récupérer. Les lignes sont numérotées de 0 en montant.
                         Si l'argument est omis, la ligne suivante est récupérée.
  <info>mixed</info>         <strong>$field</strong>   Une chaîne de type <info>string</info> représentant le nom du champ (colonne) à
                         récupérer, sinon un entier de type <info>int</info> représentant le numéro du champ à
                         récupérer. Les champs sont numérotés de 0 en montant.

<comment>Return:</comment>
  <info>string|false|null</info>  Les booléens sont retournés comme des "t" ou "f".   Tous les autres types, y
                     compris les tableaux, sont retournés sous forme de chaînes formatées, de la
                     même manière que PostgreSQL vous les afficherait dans le client psql. Les
                     valeurs NULL de la base de données sont retournées NULL.
                     
                     <info>false</info> est retournée si <strong>$row</strong> excède le nombre de lignes dans le jeu de
                     résultats, n'a plus de ligne disponible ou tout autre erreur.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_fetch_array()</strong>


id: pg_fetch_row
type: function
doc:
<comment>Description:</comment>
  Lit une ligne dans un tableau
  
  <strong>pg_fetch_row()</strong> lit une ligne dans le résultat associé à l'instance <strong>$result</strong>.
  
  Cette fonction définit les champs NULL à la valeur PHP <info>null</info>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int|null</info>      <strong>$row</strong>     Numéro de la ligne à récupérer. Les lignes sont numérotées en commençant à
                         0. Si l'argument est omis ou s'il vaut <info>null</info>, la ligne suivante est
                         récupérée.
  <info>int</info>           <strong>$mode</strong>    Un paramètre optionnel qui contrôle la façon dont le <info>array</info> retourné est
                         indexé.
                         <strong>$mode</strong> est une constante qui peut prendre les valeurs suivantes :
                         <info>PGSQL_ASSOC</info>, <info>PGSQL_NUM</info> et <info>PGSQL_BOTH</info>.
                         En utilisant <info>PGSQL_NUM</info>, la fonction retournera un tableau avec des indices
                         numériques,
                         en utilisant <info>PGSQL_ASSOC</info>, elle retournera seulement des indices associatifs
                         tandis que <info>PGSQL_BOTH</info> retournera à la fois des indices numériques et
                         associatifs.

<comment>Return:</comment>
  <info>array|false</info>  Un tableau de type <info>array</info>, indexé de 0 en montant, avec chaque valeur représentée
               comme une chaîne (chaîne de caractères). Les valeurs <info>null</info> de la base de données sont
               retournées <info>null</info>.
               
               <info>false</info> est retournée si <strong>$row</strong> excède le nombre de lignes dans le jeu de résultats, n'a
               plus de ligne disponible ou tout autre erreur.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_fetch_array()</strong>
   * <strong>pg_fetch_object()</strong>
   * <strong>pg_fetch_result()</strong>


id: pg_field_is_null
type: function
doc:
<comment>Description:</comment>
  Teste si un champ PostgreSQL est à null
    
  
  <strong>pg_field_is_null()</strong> teste si un champ dans une instance <class>PgSql\Result</class> est un <return>NULL</return> SQL ou pas.
  
  Auparavant, cette fonction s'appelait <strong>pg_fieldisnull()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$row</strong>     Numéro de la ligne à récupérer. Les lignes sont numérotées de 0 en montant.
                         Si l'argument est omis, la ligne suivante est récupérée.
  <info>mixed</info>         <strong>$field</strong>   Numéro du champ (commençant à 0) de type <info>int</info> ou le nom du champ de type
                         <info>string</info>.

<comment>Return:</comment>
  <info>int</info>  Retourne <return>1</return> si le champ de la ligne donnée est <info>null</info>, <return>0</return> s'il n'est pas <info>null</info>. <info>false</info> est
       retournée si la ligne n'est pas dans le tableau ou tout autre erreur.


id: pg_field_name
type: function
doc:
<comment>Description:</comment>
  Retourne le nom d'un champ PostgreSQL
    
  
  <strong>pg_field_name()</strong> retourne le nom du champ qui occupe la colonne numéro <strong>$field</strong> dans le résultat
  <strong>$result</strong>. La numérotation des champs commence à 0.
  
  Auparavant, cette fonction s'appelait <strong>pg_fieldname()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field</strong>   Numéro du champ, commençant à 0.

<comment>Return:</comment>
  <info>string</info>  Le nom du champ.

<comment>See Also:</comment>
   * <strong>pg_field_num()</strong>


id: pg_field_num
type: function
doc:
<comment>Description:</comment>
  Retourne le numéro d'une colonne
    
  
  <strong>pg_field_num()</strong> retourne le numéro de la colonne, dont le nom est <strong>$field</strong>, dans le résultat <strong>$result</strong>.
  
  Auparavant, cette fonction s'appelait <strong>pg_fieldnum()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>string</info>        <strong>$field</strong>   Le nom du champ. Le nom donné est traité comme un identifiant dans une
                         commande SQL, c'est-à-dire qu'il est mis en minuscule sauf s'il est cité
                         deux fois.

<comment>Return:</comment>
  <info>int</info>  Le numéro du champ (commençant à 0) ou -1 en cas d'erreur.

<comment>See Also:</comment>
   * <strong>pg_field_name()</strong>


id: pg_field_prtlen
type: function
doc:
<comment>Description:</comment>
  Retourne la taille imprimée
    
  
  <strong>pg_field_prtlen()</strong> retourne la taille imprimée (nombre de caractères) d'une valeur donnée dans un
  résultat PostgreSQL. La numérotation des lignes commence à 0. <strong>pg_field_prtlen()</strong> retourne <info>false</info> en
  cas d'erreur.
  
  Le paramètre <strong>$field_name_or_number</strong> peut être passé soit en tant qu'entier, soit en tant que chaîne
  de caractères. S'il est passé en tant qu'entier, PHP l'identifie comme le numéro d'un champ,
  sinon, comme le nom d'un champ.
  
  Voir l'exemple donné à la page de la documentation de la fonction <strong>pg_field_name()</strong>.
  
  Auparavant, cette fonction s'appelait <strong>pg_fieldprtlen()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info></info>              <strong>$row</strong>     Numéro de la ligne dans le résultat. Les lignes sont numérotées à partir de
                         0 en montant. Si ce paramètre n'est pas fourni, la ligne en cours est
                         récupérée.

<comment>Return:</comment>
  <info>int</info>  Le nombre de caractères imprimés.

<comment>See Also:</comment>
   * <strong>pg_field_size()</strong>


id: pg_field_size
type: function
doc:
<comment>Description:</comment>
  Retourne la taille interne de stockage d'un champ donné
    
  
  <strong>pg_field_size()</strong> retourne la taille interne de stockage d'un champ donné, en octets.
  
  Auparavant, cette fonction s'appelait <strong>pg_fieldsize()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field</strong>   Numéro du champ, commençant à 0.

<comment>Return:</comment>
  <info>int</info>  La taille du stockage interne d'un champ (en octets). -1 signifie un champ à grandeur
       variable.

<comment>See Also:</comment>
   * <strong>pg_field_prtlen()</strong>
   * <strong>pg_field_type()</strong>


id: pg_field_table
type: function
doc:
<comment>Description:</comment>
  Retourne le nom ou l'oid d'une table
  
  <strong>pg_field_table()</strong> retourne le nom de la table à laquelle le champ appartient ou l'oid de la table
  si le paramètre <strong>$oid_only</strong> vaut <info>true</info>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>    Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                           <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field</strong>     Numéro du champ, commençant à 0.
  <info>bool</info>          <strong>$oid_only</strong>  Par défaut, le nom de la table à laquelle le champ appartient est
                           retourné mais si le paramètre <strong>$oid_only</strong> est défini à <info>true</info>, alors, ce sera
                           l'oid qui sera retourné.

<comment>Return:</comment>
  <info>string|int|false</info>  En cas de succès, le nom de la table ou l'oid,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_field_name()</strong>
   * <strong>pg_field_type()</strong>


id: pg_field_type
type: function
doc:
<comment>Description:</comment>
  Retourne le type d'un champ PostgreSQL donné par index
    
  
  <strong>pg_field_type()</strong> retourne une chaîne contenant le type de base du champ donné par son index <strong>$field</strong>.
  
  Si le champ utilise un domaine PostgreSQL (plutôt que d'un type basic), c'est le nom du domaine
  sous-jacent qui est retourné, plutôt que le nom du domaine en tant que tel.
  
  Auparavant, cette fonction s'appelait <strong>pg_fieldtype()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field</strong>   Numéro du champ, commençant à 0.

<comment>Return:</comment>
  <info>string</info>  Une <info>string</info> contenant le nom de base du type de champ.

<comment>See Also:</comment>
   * <strong>pg_field_prtlen()</strong>
   * <strong>pg_field_name()</strong>
   * <strong>pg_field_type_oid()</strong>


id: pg_field_type_oid
type: function
doc:
<comment>Description:</comment>
  Retourne le type ID (OID) pour le numéro du champ correspondant
    
  
  <strong>pg_field_type_oid()</strong> retourne un entier contenant le OID du type de base du champ <strong>$field</strong> donné dans
  l'instance<strong>$result</strong>.
  
  Vous pouvez obtenir plus d'informations à propos du type de champ en interrogeant la table système
  de PostgreSQL <strong>pg_type()</strong> avec le OID obtenu par cette fonction.
  
  Si le champ utilise un domaine PostgreSQL (plutôt que d'un type basic), c'est le OID du domaine
  sous-jacent qui est retourné, plutôt que le OID du domaine en tant que tel.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field</strong>   Numéro du champ, commençant à 0.

<comment>Return:</comment>
  <info>string|int</info>  Le OID du type de base du champ.

<comment>See Also:</comment>
   * <strong>pg_field_type()</strong>
   * <strong>pg_field_prtlen()</strong>
   * <strong>pg_field_name()</strong>


id: pg_flush
type: function
doc:
<comment>Description:</comment>
  Envoi les données de requête sortante sur la connexion
  
  La fonction <strong>pg_flush()</strong> envoie toutes les données sortantes de requête en attente d'être envoyées
  sur la connexion.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>int|bool</info>  Retourne <info>true</info> si l'envoi a réussi, ou si aucune donnée n'est en attente d'envoi, <return>0</return> si
            une partie des données en attente ont été envoyées mais qu'il en reste encore ou <info>false</info>
            si une erreur survient.


id: pg_free_result
type: function
doc:
<comment>Description:</comment>
  Libère la mémoire
    
  
  <strong>pg_free_result()</strong> libère la mémoire et les données associées avec l'instance <class>PgSql\Result</class>.
  
  <strong>pg_free_result()</strong> n'est vraiment utile que si vous risquez d'utiliser trop de mémoire durant votre
  script. La mémoire occupée par les résultats est automatiquement libérée à la fin du script.
  
  Auparavant, cette fonction s'appelait <strong>pg_freeresult()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_query_params()</strong>
   * <strong>pg_execute()</strong>


id: pg_get_notify
type: function
doc:
<comment>Description:</comment>
  Lit le message SQL NOTIFY
    
  
  <strong>pg_get_notify()</strong> reçoit le message de NOTIFY envoyé par une commande SQL <return>NOTIFY</return>. Pour lire le
  message associé, utilisez la commande <return>LISTEN</return>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>int</info>               <strong>$mode</strong>        Un paramètre optionnel qui contrôle la façon dont le <info>array</info> retourné
                                 est indexé.
                                 <strong>$mode</strong> est une constante qui peut prendre les valeurs suivantes :
                                 <info>PGSQL_ASSOC</info>, <info>PGSQL_NUM</info> et <info>PGSQL_BOTH</info>.
                                 En utilisant <info>PGSQL_NUM</info>, la fonction retournera un tableau avec des
                                 indices numériques,
                                 en utilisant <info>PGSQL_ASSOC</info>, elle retournera seulement des indices
                                 associatifs
                                 tandis que <info>PGSQL_BOTH</info> retournera à la fois des indices numériques
                                 et associatifs.

<comment>Return:</comment>
  <info>array|false</info>  Un tableau contenant le nom du message <return>NOTIFY</return>. Si le serveur supporte, le tableau
               contient aussi la version du serveur et la charge utile (payload). Sinon, si aucun
               <return>NOTIFY</return> n'est en attente, alors <info>false</info> sera retourné.

<comment>See Also:</comment>
   * <strong>pg_get_pid()</strong>


id: pg_get_pid
type: function
doc:
<comment>Description:</comment>
  Lit l'identifiant de processus du serveur PostgreSQL
    
  
  <strong>pg_get_pid()</strong> lit l'identifiant de processus du serveur PostgreSQL. L'identifiant de processus est
  pratique pour  vérifier si un message de <return>NOTIFY</return> a été envoyé via <strong>pg_get_notify()</strong> par un autre
  processus ou pas.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>int</info>  L'identifiant du processus du serveur.

<comment>See Also:</comment>
   * <strong>pg_get_notify()</strong>


id: pg_get_result
type: function
doc:
<comment>Description:</comment>
  Lit un résultat PostgreSQL asynchrone
    
  
  <strong>pg_get_result()</strong> récupère l'instance <class>PgSql\Result</class> d'une requête asynchrone exécutée par
  <strong>pg_send_query()</strong>, <strong>pg_send_query_params()</strong>, ou <strong>pg_send_execute()</strong>.
  
  <strong>pg_send_query()</strong> et les autres fonctions de requête asynchrone peuvent envoyer plusieurs requêtes à
  un serveur PostgreSQL et <strong>pg_get_result()</strong> est utilisé pour obtenir chaque résultat de requête, un
  par un.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>PgSql\Result|false</info>  Une instance de <class>PgSql\Result</class>, ou <info>false</info> s'il n'y a plus de résultat disponible.

<comment>See Also:</comment>
   * <strong>pg_send_query()</strong>


id: pg_host
type: function
doc:
<comment>Description:</comment>
  Retourne le nom d'hôte
    
  
  <strong>pg_host()</strong> retourne le nom d'hôte associé à l'instance de connexion PostgreSQL.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  Une chaîne contenant le nom de l'ordinateur hôte de <strong>$connection</strong> ou une chaîne vide en cas
          d'erreur.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>
   * <strong>pg_pconnect()</strong>


id: pg_insert
type: function
doc:
<comment>Description:</comment>
  Insère un tableau dans une table
    
  
  <strong>pg_insert()</strong> insère les <strong>$values</strong> dans la table <strong>$table_name</strong>.
  
  Si <strong>$flags</strong> est spécifié, <strong>pg_convert()</strong> est appliqué à <strong>$values</strong> avec les drapeaux fournit.
  
  Par défaut <strong>pg_insert()</strong> passe des valeurs brutes. Les valeurs doivent être échappé ou le drapeau
  <info>PGSQL_DML_ESCAPE</info> doit être spécifié dans <strong>$flags</strong>. <info>PGSQL_DML_ESCAPE</info> met des guillemets et échappe
  les paramètres/identifiants. Par conséquent, les noms de table/colonnes deviennent sensible à la
  casse.
  
  Notez que ni l'échappement ni les requêtes préparer peuvent protéger des requêtes LIKE, JSON,
  Tableaux, Regex, etc. Ces paramètres devraient être traité en fonction de leur contexte. C'est à
  dire échapper/valider les valeurs.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Nom de la table dans laquelle les lignes seront insérées. La table
                                 <strong>$table_name</strong> doit avoir au moins autant de colonnes que <strong>$values</strong> a
                                 d'éléments.
  <info>array</info>             <strong>$values</strong>      Un tableau dont les clés sont les noms des champs dans la table
                                 <strong>$table_name</strong>, et où les valeurs sont les valeurs de ces champs qui
                                 seront insérés.
  <info>int</info>               <strong>$flags</strong>       Toutes combinaisons de constantes parmi <info>PGSQL_CONV_OPTS</info>,
                                 <info>PGSQL_DML_NO_CONV</info>, <info>PGSQL_DML_ESCAPE</info>, <info>PGSQL_DML_EXEC</info>,
                                 <info>PGSQL_DML_ASYNC</info> ou <info>PGSQL_DML_STRING</info>. Si  <info>PGSQL_DML_STRING</info> fait
                                 partie du paramètre <strong>$flags</strong>, alors la requête sera retournée.
                                 Lorsque la constante <info>PGSQL_DML_NO_CONV</info> ou la constante
                                 <info>PGSQL_DML_ESCAPE</info> est définie, aucun appel à la fonction
                                 <strong>pg_convert()</strong> ne sera effectuée en interne.

<comment>Return:</comment>
  <info>PgSql\Result|string|bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur
                            survient.. Ou retourne une chaîne de caractères si <info>PGSQL_DML_STRING</info> est
                            fournit via <strong>$flags</strong>.

<comment>See Also:</comment>
   * <strong>pg_convert()</strong>


id: pg_last_error
type: function
doc:
<comment>Description:</comment>
  Lit le dernier message d'erreur sur la connexion
    
  
  <strong>pg_last_error()</strong> retourne le dernier message d'erreur pour une connexion <strong>$connection</strong>.
  
  Les messages d'erreur peuvent être écrasés par des appels internes à l'extension PostgreSQL
  (libpq) : il se peut que le message retourné ne soit pas approprié, notamment si plusieurs erreurs
  ont eu lieu dans le module.
  
  Utilisez <strong>pg_result_error()</strong>, <strong>pg_result_error_field()</strong>, <strong>pg_result_status()</strong> et <strong>pg_connection_status()</strong>
  pour améliorer la gestion des erreurs.
  
  Auparavant, cette fonction s'appelait <strong>pg_errormessage()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant le dernier message d'erreur sur la connexion
          <strong>$connection</strong>.

<comment>See Also:</comment>
   * <strong>pg_result_error()</strong>
   * <strong>pg_result_error_field()</strong>


id: pg_last_notice
type: function
doc:
<comment>Description:</comment>
  Retourne la dernière note du serveur PostgreSQL
    
  
  <strong>pg_last_notice()</strong> retourne la dernière note du serveur PostgreSQL sur la connexion <strong>$connection</strong>
  spécifiée. Le serveur PostgreSQL envoie des notes dans plusieurs cas,  par exemple lors de
  création d'une colonne <return>SERIAL</return> dans une table.
  
  Avec <strong>pg_last_notice()</strong>, vous pouvez éviter des requêtes inutiles en vérifiant si des notes sont
  liées ou pas à votre transaction.
  
  Le suivi des notes peut être rendu optionnel en mettant à 1 la directive de configuration
  <return>pgsql.ignore_notice</return> du  fichier php.ini.
  
  L'enregistrement des notes peut être rendu optionnel en mettant la directive de configuration
  <return>pgsql.log_notice</return> du php.ini à 0. À moins que <return>pgsql.ignore_notice</return> ne soit à 0, les notes ne seront
  pas enregistrées.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>int</info>               <strong>$mode</strong>        L'un de <info>PGSQL_NOTICE_LAST</info> (pour retourner la dernière note),
                                 <info>PGSQL_NOTICE_ALL</info> (pour retourner toutes les notes), or
                                 <info>PGSQL_NOTICE_CLEAR</info> (pour effacer les notes).

<comment>Return:</comment>
  <info>array|string|bool</info>  Une chaîne de caractères contenant la dernière note sur la connexion
                     <strong>$connection</strong> avec <info>PGSQL_NOTICE_LAST</info>, un tableau avec <info>PGSQL_NOTICE_ALL</info>, un
                     booléen avec <info>PGSQL_NOTICE_CLEAR</info>.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_last_error()</strong>


id: pg_last_oid
type: function
doc:
<comment>Description:</comment>
  Retourne l'identifiant de la dernière ligne
    
  
  <strong>pg_last_oid()</strong> sert à récupérer le OID assigné à une ligne insérée.
  
  Le champ OID est devenu optionnel depuis PostgreSQL 7.2 et ne sera plus présent par défaut dans
  PostgreSQL 8.1. Lorsque le champ OID n'est pas présent dans la table, le programmeur doit utiliser
  <strong>pg_result_status()</strong> pour vérifier si la ligne a été correctement insérée.
  
  Pour obtenir la valeur d'un champ <return>SERIAL</return> dans une ligne insérée, il est nécessaire d'utiliser la
  fonction <return>CURRVAL</return> de PostgreSQL en nommant la séquence à qui la dernière valeur est requise. Si le
  nom de la séquence est inconnu, la fonction PostgreSQL 8.0 <return>pg_get_serial_sequence</return> est nécessaire.
  
  PostgreSQL 8.1 a une fonction <return>LASTVAL</return> qui retourne la valeur de la séquence la plus récemment
  utilisée de la session. Ceci permet d'éviter de nommer la séquence, la table ou la colonne.
  
  Auparavant, cette fonction s'appelait <strong>pg_getlastoid()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).

<comment>Return:</comment>
  <info>string|int|false</info>  Un entier ou chaîne de caractères contenant le OID assigné à la plus récente
                    ligne insérée dans la connexion <strong>$connection</strong> spécifiée ou <info>false</info> en cas d'erreur
                    ou de OID indisponible.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_result_status()</strong>


id: pg_lo_close
type: function
doc:
<comment>Description:</comment>
  Ferme un objet de grande taille PostgreSQL
    
  
  <strong>pg_lo_close()</strong> ferme un objet large.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_loclose()</strong>.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>  Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_open()</strong>
   * <strong>pg_lo_create()</strong>
   * <strong>pg_lo_import()</strong>


id: pg_lo_create
type: function
doc:
<comment>Description:</comment>
  Crée un objet de grande taille PostgreSQL
    
  
  <strong>pg_lo_create()</strong> crée un objet de grande taille et retourne son OID. Les modes d'accès PostgreSQL
  <info>INV_READ</info>, <info>INV_WRITE</info> et <info>INV_ARCHIVE</info> ne sont pas supportés : l'objet peut toujours être créé avec
  des droits d'accès en lecture et écriture. Le mode <info>INV_ARCHIVE</info> a été supprimé des bases PostgreSQL
  (version 6.3 et ultérieur).
  
  Pour utiliser un objet de grande taille, il est  nécessaire de le faire dans une transaction.
  
  Au lieu d'utiliser l'interface d'objet de grande taille ((qui n'a aucun contrôle d'accès et qui
  est encombrant à utiliser), essayez la colonne de type bytea de PostgreSQL et <strong>pg_escape_bytea()</strong>.
  
  Auparavant, cette fonction s'appelait <strong>pg_locreate()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>mixed</info>             <strong>$object_id</strong>   Si le paramètre <strong>$object_id</strong> est fourni, la fonction essayera de
                                 créer un objet large avec cet identifiant, sinon, un identifiant
                                 d'objet disponible sera assigné par le serveur. Ce paramètre dépend
                                 d'une fonctionnalité qui est apparue avec PostgreSQL 8.1.

<comment>Return:</comment>
  <info>int</info>  Un objet large OID,  ou <info>false</info> si une erreur survient.


id: pg_lo_export
type: function
doc:
<comment>Description:</comment>
  Exporte un objet de grande taille vers un fichier
    
  
  <strong>pg_lo_export()</strong> prend un objet de grande taille de la base de données PostgreSQL et sauvegarde son
  contenu dans un fichier local au système.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_loexport()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>int</info>               <strong>$oid</strong>         Le OID de l'objet de grande taille dans la base de données.
  <info>string</info>            <strong>$pathname</strong>    Le chemin d'accès complet ainsi que le fichier dans lequel il sera
                                 écrit l'objet de grande taille sur le système du client.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_import()</strong>


id: pg_lo_import
type: function
doc:
<comment>Description:</comment>
  Importe un objet de grande taille depuis un fichier
    
  
  <strong>pg_lo_import()</strong> crée un nouvel objet de grande taille dans la base de données en utilisant un
  fichier dans le système de fichiers en tant que données sources.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_loimport()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$pathname</strong>    Le chemin d'accès complet ainsi que le fichier dans lequel il sera
                                 lu l'objet de grande taille sur le système du client.
  <info>mixed</info>             <strong>$object_id</strong>   Si le paramètre <strong>$object_id</strong> est fourni, la fonction essayera de
                                 créer un objet large avec cette identifiant, sinon, un identifiant
                                 d'objet disponible sera assigné par le serveur. Ce paramètre dépend
                                 d'une fonctionnalité qui est apparue avec PostgreSQL 8.1.

<comment>Return:</comment>
  <info>int</info>  Le OID du nouvel objet de grande taille créé,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_export()</strong>
   * <strong>pg_lo_open()</strong>


id: pg_lo_open
type: function
doc:
<comment>Description:</comment>
  Ouvre un objet de grande taille PostgreSQL
    
  
  <strong>pg_lo_open()</strong> ouvre un objet large dans la base de donnée et retourne une instance de <class>PgSql\Lob</class>
  pour qu'il puisse être manipulé.
  
  Ne fermer pas la connexion à la base de données avant de fermer l'instance <class>PgSql\Lob</class>.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_loopen()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>int</info>               <strong>$oid</strong>         Le OID de l'objet de grande taille dans la base de données.
  <info>string</info>            <strong>$mode</strong>        Peut être "r" pour lecture seule, "w" pour écriture seule ou "rw"
                                 pour lecture et écriture.

<comment>Return:</comment>
  <info>PgSql\Lob|false</info>  Une instance <class>PgSql\Lob</class>,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_close()</strong>
   * <strong>pg_lo_create()</strong>


id: pg_lo_read
type: function
doc:
<comment>Description:</comment>
  Lit un objet de grande taille
    
  
  <strong>pg_lo_read()</strong> lit au plus <strong>$length</strong> octets d'un objet de grande taille, et retourne les données sous
  la forme d'une chaîne.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_loread()</strong>.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>     Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.
  <info>int</info>        <strong>$length</strong>  Un nombre maximal d'octets à retourner. Cet argument est optionnel.

<comment>Return:</comment>
  <info>string|false</info>  Une chaîne contenant <strong>$length</strong> octets de l'objet de grande taille ou <info>false</info> en cas
                d'erreur.

<comment>See Also:</comment>
   * <strong>pg_lo_read_all()</strong>


id: pg_lo_read_all
type: function
doc:
<comment>Description:</comment>
  Lit un objet de grande taille en totalité
    
  
  <strong>pg_lo_read_all()</strong> lit un objet de grande taille en totalité et le passe directement au client,
  après les en-têtes adéquates. Cette fonction est prévue pour transmettre des sons ou des images.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_loreadall()</strong>.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>  Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.

<comment>Return:</comment>
  <info>int</info>  Nombre d'octets lu.

<comment>See Also:</comment>
   * <strong>pg_lo_read()</strong>


id: pg_lo_seek
type: function
doc:
<comment>Description:</comment>
  Modifie la position dans un objet de grande taille
    
  
  <strong>pg_lo_seek()</strong> modifie la position du pointeur dans l'instance <class>PgSql\Lob</class>.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>     Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.
  <info>int</info>        <strong>$offset</strong>  Le nombre d'octets de déplacement.
  <info>int</info>        <strong>$whence</strong>  Une de ces constantes <info>PGSQL_SEEK_SET</info> (positionne à partir du début de
                      l'objet),  <info>PGSQL_SEEK_CUR</info> (positionne à partir de la position courante) ou
                      <info>PGSQL_SEEK_END</info> (positionne à partir de la fin de l'objet).

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_tell()</strong>


id: pg_lo_tell
type: function
doc:
<comment>Description:</comment>
  Retourne la position courante dans un objet de grande taille PostgreSQL
    
  
  <strong>pg_lo_tell()</strong> retourne la position courante (à partir du début) du pointeur de lecture sur l'objet
  de grande taille <strong>$large_object</strong>.
  
  Pour utiliser une interface avec un objet de grande taille, il est nécessaire de l'inclure dans un
  bloc de transaction.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>  Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.

<comment>Return:</comment>
  <info>int</info>  La position courante du pointeur (en nombre d'octets) à partir du début de l'objet de grande
       taille. S'il y a une erreur, la valeur retournée sera négative.

<comment>See Also:</comment>
   * <strong>pg_lo_seek()</strong>


id: pg_lo_truncate
type: function
doc:
<comment>Description:</comment>
  Tronque un objet large
  
  <strong>pg_lo_truncate()</strong> tronque une instance <class>PgSql\Lob</class>.
  
  Pour utiliser l'interface des objets larges, il est nécessaire de l'enfermer dans un verrou de
  transaction.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>   Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.
  <info>int</info>        <strong>$size</strong>  Le nombre d'octets à tronquer.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_tell()</strong>


id: pg_lo_unlink
type: function
doc:
<comment>Description:</comment>
  Efface un objet de grande taille PostgreSQL
    
  
  <strong>pg_lo_unlink()</strong> efface l'objet de grande taille dont l'identifiant est <strong>$oid</strong>, pour la connexion
  <strong>$connection</strong>.  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
  
  Pour utiliser un objet de grande taille (<return>lo</return>), il est  nécessaire de le faire dans une transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_lounlink()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>int</info>               <strong>$oid</strong>         Le OID de l'objet de grande taille dans la base de données.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_lo_create()</strong>
   * <strong>pg_lo_import()</strong>


id: pg_lo_write
type: function
doc:
<comment>Description:</comment>
  Écrit un objet de grande taille PostgreSQL
  
  <strong>pg_lo_write()</strong> écrit des données à l'intérieur d'un objet de grande taille à la position courante.
  
  Pour manipuler un objet de grande taille (<return>lo</return>), il est nécessaire de placer les opérations dans un
  bloc de transaction.
  
  Auparavant, cette fonction s'appelait <strong>pg_lowrite()</strong>.

<comment>Param:</comment>
  <info>PgSql\Lob</info>  <strong>$lob</strong>     Une instance <class>PgSql\Lob</class>, retourné par <strong>pg_lo_open()</strong>.
  <info>string</info>     <strong>$data</strong>    Les données à être écrites dans l'objet de grande taille. Si <strong>$length</strong> est un
                      <info>int</info> et est inférieur à la grandeur de <strong>$data</strong>, seul les <strong>$length</strong> premiers octets
                      y seront écrits.
  <info>int|null</info>   <strong>$length</strong>  Un nombre maximal d'octets à écrire. Il doit être supérieur à zéro et
                      inférieur à la grandeur de <strong>$data</strong>. Cet argument est optionnel, s'il est omis,
                      il prendra par défaut la grandeur de <strong>$data</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Le nombre d'octets écrit dans l'objet de grande taille ou <info>false</info> en cas d'erreur.

<comment>See Also:</comment>
   * <strong>pg_lo_create()</strong>
   * <strong>pg_lo_open()</strong>


id: pg_meta_data
type: function
doc:
<comment>Description:</comment>
  Lit les métadonnées de la table PostgreSQL
    
  
  <strong>pg_meta_data()</strong> retourne la définition de la table  <return>table_name</return> sous forme de tableau.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Le nom de la table.
  <info>bool</info>              <strong>$extended</strong>    Drapeau pour retourner les méta-données étendus. Par défaut, vaut
                                 <info>false</info>.

<comment>Return:</comment>
  <info>array|false</info>  Un tableau de la table de définition,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_convert()</strong>


id: pg_num_fields
type: function
doc:
<comment>Description:</comment>
  Retourne le nombre de champ
    
  
  <strong>pg_num_fields()</strong> retourne le nombre de champs  (ou colonnes) d'une instance <class>PgSql\Result</class>.
  
  Auparavant, cette fonction s'appelait <strong>pg_numfields()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).

<comment>Return:</comment>
  <info>int</info>  Le nombre de champs (ou colonne) dans le jeu de résultats. En cas d'erreur, -1 est retourné.

<comment>See Also:</comment>
   * <strong>pg_num_rows()</strong>
   * <strong>pg_affected_rows()</strong>


id: pg_num_rows
type: function
doc:
<comment>Description:</comment>
  Retourne le nombre de lignes PostgreSQL
    
  
  <strong>pg_num_rows()</strong> retourne le nombre de lignes d'une instance <class>PgSql\Result</class>.
  
  Auparavant, cette fonction s'appelait <strong>pg_numrows()</strong>.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).

<comment>Return:</comment>
  <info>int</info>  Le nombre de lignes dans le jeu de résultats. En cas d'erreur, <return>-1</return> est retourné.

<comment>See Also:</comment>
   * <strong>pg_num_fields()</strong>
   * <strong>pg_affected_rows()</strong>


id: pg_options
type: function
doc:
<comment>Description:</comment>
  Retourne les options PostgreSQL
    
  
  <strong>pg_options()</strong> retourne une chaîne contenant les options de la connexion PostgreSQL <strong>$connection</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  Une chaîne contenant les options de <strong>$connection</strong>.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>


id: pg_parameter_status
type: function
doc:
<comment>Description:</comment>
  Consulte un paramètre de configuration courant du serveur
    
  
  Consulte un paramètre de configuration courant du serveur.
  
  Certaines valeurs de paramètres sont retournées par le serveur automatiquement lors du démarrage
  de la connexion ou lorsqu'une valeur change. <strong>pg_parameter_status()</strong> peut être utilisée pour
  interroger ces configurations. La fonction retourne la valeur courante du paramètre s'il et connu
  ou <info>false</info> si le paramètre est inconnu.
  
  Les paramètres retournés par PostgreSQL 8.0 sont <return>server_version</return>,  <return>server_encoding</return>,
  <return>client_encoding</return>,  <return>is_superuser</return>, <return>session_authorization</return>,  <return>DateStyle</return>, <return>TimeZone</return> et <return>integer_datetimes</return>.
  (<return>server_encoding</return>, <return>TimeZone</return> et  <return>integer_datetimes</return> n'étaient pas retournés dans les versions
  antérieures à 8.0.) Notez que  <return>server_version</return>, <return>server_encoding</return> et <return>integer_datetimes</return>  ne peuvent
  changer après le démarrage de PostgreSQL.
  
  Les serveurs PostgreSQL 7.3 ou de versions inférieures ne retournent pas de paramètres de
  configurations, <strong>pg_parameter_status()</strong> inclut une logique pour obtenir des valeurs pour
  <return>server_version</return> et <return>client_encoding</return> quand même. Les applications devraient utiliser
  <strong>pg_parameter_status()</strong> au lieu du code ad hoc pour déterminer ces valeurs.
  
  Sur les versions des serveurs PostgreSQL 7.4 et antérieures, le changement de <return>client_encoding</return> avec
  <return>SET</return> après le démarrage de la connexion ne sera pas réfléchie par <strong>pg_parameter_status()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$param_name</strong>  Les valeurs possibles de <strong>$param_name</strong> sont <return>server_version</return>,
                                 <return>server_encoding</return>, <return>client_encoding</return>, <return>is_superuser</return>,
                                 <return>session_authorization</return>, <return>DateStyle</return>, <return>TimeZone</return> et <return>integer_datetimes</return>. Il
                                 est à noter que cette valeur est sensible à la casse.

<comment>Return:</comment>
  <info>string</info>  Une chaîne contenant la valeur du paramètre, <info>false</info> en cas d'échec ou du paramètre
          <strong>$param_name</strong> invalide.


id: pg_pconnect
type: function
doc:
<comment>Description:</comment>
  Établit une connexion PostgreSQL persistante
    
  
  <strong>pg_pconnect()</strong> retourne une instance <class>PgSql\Connection</class> de connexion persistante.
  
  Si un second appel est fait à <strong>pg_pconnect()</strong> avec le même <strong>$connection_string</strong> comme étant une
  connexion existante, la connexion existante sera retournée à moins que vous ne passez
  <info>PGSQL_CONNECT_FORCE_NEW</info> à <strong>$flags</strong>.
  
  Pour activer les connexions persistantes, la directive de configuration pgsql.allow_persistent du
  php.ini doit être mise à "On" (ce qui est sa valeur par défaut). Le nombre maximal de connexions
  peut être limité grâce  à la directive de configuration pgsql.max_persistent dans le fichier
  php.ini (par défaut, elle vaut -1, c'est à dire pas de limite). Le nombre total de connexions peut
  être configuré avec la directive pgsql.max_links du fichier php.ini.
  
  <strong>pg_close()</strong> ne refermera pas les connexions persistantes générées par <strong>pg_pconnect()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$connection_string</strong>  La chaîne <strong>$connection_string</strong> peut être vide pour utiliser tous les
                              paramètres par défaut ou elle peut contenir un ou plusieurs paramètres
                              de configuration séparés par des espaces. Chaque paramètre de
                              configuration est sous la forme <return>code = valeur</return>. Les espaces autour du
                              signe égal sont optionnels. Pour écrire une valeur vide ou une valeur
                              contenant des espaces, entourez cette valeur avec des apostrophes, par
                              exemple : <return>code = 'une valeur'</return>. Les apostrophes et les antislashs à
                              l'intérieur de la valeur doivent être échappés par un antislash,
                              c'est-à-dire \' et \\.
                              
                              Les mots-clé actuellement reconnus sont : <strong>$host</strong>, <strong>$hostaddr</strong>, <strong>$port</strong>,
                              <strong>$dbname</strong>, <strong>$user</strong>, <strong>$password</strong>, <strong>$connect_timeout</strong>, <strong>$options</strong>, <strong>$tty</strong> (ignoré),
                              <strong>$sslmode</strong>, <strong>$requiressl</strong> (obsolète, utilisez <strong>$sslmode</strong>) et <strong>$service</strong>. La
                              liste de ces arguments dépend de la version de votre serveur
                              PostgreSQL.
  <info>int</info>     <strong>$flags</strong>              Si <info>PGSQL_CONNECT_FORCE_NEW</info> est passé en argument, alors une nouvelle
                              connexion sera créée, même si la chaîne <strong>$connection_string</strong> est
                              identique à celle de la connexion existante.

<comment>Return:</comment>
  <info>PgSql\Connection|false</info>  Retourne une instance de <class>PgSql\Connection</class> en cas de succès,  ou <info>false</info> si
                          une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>
   * 
     Connexions Persistantes


id: pg_ping
type: function
doc:
<comment>Description:</comment>
  Ping la connexion à la base
    
  
  <strong>pg_ping()</strong> ping la connexion à la base de données et essaie de se reconnecter si la connexion est
  perdue.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_connection_status()</strong>
   * <strong>pg_connection_reset()</strong>


id: pg_port
type: function
doc:
<comment>Description:</comment>
  Retourne le numéro de port
    
  
  <strong>pg_port()</strong> retourne le numéro de port de la connexion donnée par <strong>$connection</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant le numéro du port du serveur de base de données
          identifié par <strong>$connection</strong> ou une chaîne vide en cas d'erreur.


id: pg_prepare
type: function
doc:
<comment>Description:</comment>
  Envoie une requête pour créer une requête préparée avec les paramètres
     donnés et attend l'exécution
    
  
  <strong>pg_prepare()</strong> crée une requête préparée pour une exécution ultérieure avec <strong>pg_execute()</strong> ou
  <strong>pg_send_execute()</strong>.  Cette caractéristique permet aux commandes qui seront utilisées à plusieurs
  reprises d'être analysées et planifiées qu'une seule fois, plutôt que d'être exécutées chaque
  fois. <strong>pg_prepare()</strong> est supportée seulement avec les versions PostgreSQL 7.4 ou plus récentes; la
  commande échouera si vous l'utilisez avec des versions antérieures.
  
  La fonction crée une requête préparée nommée <strong>$stmtname</strong> à partir de la chaîne <strong>$query</strong>, celle-ci doit
  contenir qu'une seule commande SQL. <strong>$stmtname</strong> peut être vide ("") pour créer une requête qui n'est
  pas nommée. Dans ce cas, les requêtes qui existaient et qui se trouvaient sans noms sont
  automatiquement remplacées; autrement, il y aura une erreur si le nom de la requête est déjà
  défini dans la session courante. Si des paramètres sont utilisés, ils sont référés à $1, $2, etc.
  dans <strong>$query</strong>.
  
  Des requêtes préparées à utiliser avec <strong>pg_prepare()</strong> peuvent être aussi créées en exécutant la
  requête SQL <return>PREPARE</return>. (Par contre, <strong>pg_prepare()</strong> est plus flexible puisqu'elle ne nécessite pas que
  les types des paramètres soit préspécifiés.) De plus, bien qu'il n'y a pas de fonction PHP pour
  supprimer une requête préparée, la requête SQL <return>DEALLOCATE</return> peut être utilisé pour ce motif.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$stmtname</strong>    Le nom à donner à la requête préparée. Il doit être unique à chaque
                                 session. Si une chaîne vide est spécifiée ("") alors une requête
                                 sans nom est créée, écrasant les requêtes sans noms précédemment
                                 définies.
  <info>string</info>            <strong>$query</strong>       La requête SQL avec ses paramètres. Elle doit contenir seulement
                                 une seule requête. Plusieurs requêtes séparées par des
                                 points-virgules ne sont pas autorisées. Si des paramètres sont
                                 utilisés, ils sont référés à $1, $2, etc.

<comment>Return:</comment>
  <info>PgSql\Result|false</info>  Une instance <class>PgSql\Result</class> en cas de succès,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_execute()</strong>
   * <strong>pg_send_execute()</strong>


id: pg_put_line
type: function
doc:
<comment>Description:</comment>
  Envoie une chaîne au serveur PostgreSQL
    
  
  <strong>pg_put_line()</strong> envoie une chaîne (terminée par <info>null</info>) au serveur PostgreSQL. Ceci est nécessaire en
  conjonction avec une commande <return>COPY FROM</return> PostgreSQL.
  
  <return>COPY</return> est un chargement très rapide des données supporté par PostgreSQL. Les données sont passées
  sans être analysées et dans une simple transaction.
  
  Une alternative plutôt que d'utiliser la commande brute <strong>pg_put_line()</strong> est d'utiliser
  <strong>pg_copy_from()</strong>. C'est une interface bien plus simple.
  
  Notez que l'application doit explicitement ajouter les deux caractères "\." à la fin de la chaîne
  pour indiquer au serveur qu'elle a finit d'envoyer des données, avant d'appeler <strong>pg_end_copy()</strong>.
  
  L'utilisation de <strong>pg_put_line()</strong> cause sur la plupart des objets de grande taille à échouer,
  incluant <strong>pg_lo_read()</strong> et <strong>pg_lo_tell()</strong>. Vous pouvez utiliser <strong>pg_copy_from()</strong> et <strong>pg_copy_to()</strong> à la
  place.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$data</strong>        Une ligne de texte à envoyer directement au serveur PostgreSQL. Un
                                 caractère d'arrêt <info>null</info> est automatiquement ajouté.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_end_copy()</strong>


id: pg_query
type: function
doc:
<comment>Description:</comment>
  Exécute une requête PostgreSQL
    
  
  <strong>pg_query()</strong> exécute la requête <strong>$query</strong> sur la base de données spécifiée <strong>$connection</strong>.
  <strong>pg_query_params()</strong> doit être préféré dans la plupart des cas.
  
  Si une erreur se produit et <info>false</info> est retourné, les détails de l'erreur peuvent être récupérés en
  utilisant la fonction <strong>pg_last_error()</strong> si la connexion est valide.
  
   Bien que <strong>$connection</strong> puisse être omis, il n'est pas recommandé de le faire, car il peut se
  révéler difficile de retrouver les bogues dans les scripts.
  
  Bien que <strong>$connection</strong> puisse être omis, il n'est pas recommandé de le faire, car il peut se révéler
  difficile de retrouver les bogues dans les scripts.
  
  Auparavant, cette fonction s'appelait <strong>pg_exec()</strong>. <strong>pg_exec()</strong> est toujours disponible pour des
  raisons de compatibilité, mais les utilisateurs sont encouragés à utiliser le nouveau nom.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$query</strong>       La requête ou les requêtes SQL à être exécutées. Lorsque plusieurs
                                 requêtes sont passées à la fonction, elles sont automatiquement
                                 exécutées comme étant une transaction, à moins qu'il y aille les
                                 commandes BEGIN/COMMIT incluses dans la requête. Cependant,
                                 l'utilisation de transactions multiples dans un seul appel de
                                 fonction n'est pas recommandée.
                                 
                                 L'inperpolation des chaînes de caractères fournies par
                                 l'utilisateur est extrèmement dangereux et vous devez garder en
                                 tête l'ensemble des vulnérabilités concernant les injections SQL.
                                 Dans la plupart des cas, la fonction <strong>pg_query_params()</strong> doit être
                                 préférée ; il est préférable de passer les valeurs fournies par
                                 l'utilisateur comme paramètres, plutôt que de les substituer dans
                                 la requête.
                                 
                                 Toutes données utilisateur substituées directement dans la chaîne
                                 de la requête doivent être proprement échappées.

<comment>Return:</comment>
  <info>PgSql\Result|false</info>  Une instance <class>PgSql\Result</class> en cas de succès,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>
   * <strong>pg_pconnect()</strong>
   * <strong>pg_fetch_array()</strong>
   * <strong>pg_fetch_object()</strong>
   * <strong>pg_num_rows()</strong>
   * <strong>pg_affected_rows()</strong>


id: pg_query_params
type: function
doc:
<comment>Description:</comment>
  Envoie une commande au serveur et attend le résultat, avec les capacités de
     passer des paramètres séparément de la commande texte SQL
    
  
  Envoie une commande au serveur et attend le résultat, avec les capacités de passer des paramètres
  séparément de la commande texte SQL.
  
  <strong>pg_query_params()</strong> est comme <strong>pg_query()</strong>,  mais offre des fonctionnalités additionnelles : les
  valeurs des paramètres peuvent être spécifiées séparément de la ligne de commande propre.
  <strong>pg_query_params()</strong> est supportée seulement avec les versions PostgreSQL 7.4 ou plus récentes; la
  commande échouera si vous l'utilisez avec des versions antérieures.
  
  Si des paramètres sont utilisés, ils sont référés à $1, $2, etc. dans <strong>$query</strong>. Le même paramètre
  peut survenir plus d'une fois dans la requête <strong>$query</strong> ; la même valeur sera utilisée dans ce cas.
  <strong>$params</strong> spécifie les valeurs actuelles des paramètres. Une valeur <info>null</info> dans ce tableau signifie
  que le paramètre correspondant est SQL <info>null</info>.
  
  Le principal avantage de <strong>pg_query_params()</strong> sur <strong>pg_query()</strong> est que les valeurs des paramètres
  peuvent être séparées de la requête <strong>$query</strong>, par conséquent, on évite les échappements de
  caractères ennuyeux et source d'erreurs. Contrairement à <strong>pg_query()</strong>, <strong>pg_query_params()</strong> permet
  seulement une seule commande SQL dans la chaîne donnée. (Il peut y avoir des points-virgules à
  l'intérieur mais pas plus d'une seule commande.)

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$query</strong>       La requête SQL avec ses paramètres. Elle doit contenir seulement
                                 une seule requête. Plusieurs requêtes séparées par des
                                 points-virgules ne sont pas autorisées. Si des paramètres sont
                                 utilisés, ils sont référés à $1, $2, etc.
                                 
                                 Les valeurs fournies par l'utilisateur doivent toujours être
                                 passées comme paramètres, et non interpolées dans la chaîne de
                                 requête, où elles peuvent potentiellement former des injections SQL
                                 et introduire des bogues lorsque ces données contiennent des
                                 guillemets. Si pour une raison quelconque vous ne pouvez pas
                                 utiliser de paramètres, assurez-vous que les valeurs interpolées
                                 sont proprement échappées.
  <info>array</info>             <strong>$params</strong>      Un tableau de valeurs de paramètres pour substituer les variables
                                 $1, $2, etc. dans la requête préparée originale. Le nombre
                                 d'éléments présents dans le tableau doit concorder avec le nombre
                                 de variables à remplacer.
                                 
                                 Les valeurs attendues pour les champs <return>bytea</return> ne sont pas supportées
                                 comme paramètres. Utilisez plutôt la fonction <strong>pg_escape_bytea()</strong> ou
                                 utilisez les fonctions sur les objets larges.

<comment>Return:</comment>
  <info>PgSql\Result|false</info>  Une instance <class>PgSql\Result</class> en cas de succès,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>


id: pg_result_error
type: function
doc:
<comment>Description:</comment>
  Lit le message d'erreur associé à un résultat
    
  
  <strong>pg_result_error()</strong> retourne le message  d'erreur associé au résultat <strong>$result</strong>. Par conséquent,
  l'utilisateur a des chances d'obtenir un message d'erreur plus approprié que via <strong>pg_last_error()</strong>.
  
  La fonction <strong>pg_result_error_field()</strong> peut donner bien plus de détails sur les erreurs que
  <strong>pg_result_error()</strong>.
  
  Comme <strong>pg_query()</strong> retourne <info>false</info> si la requête échoue, vous devez utiliser <strong>pg_send_query()</strong> et
  <strong>pg_get_result()</strong> pour récupérer la ressource de résultat.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères. Retourne une chaîne vide s'il n'y a aucune
                erreur. S'il y a une erreur associée avec le paramètre <strong>$result</strong>, <info>false</info> sera retourné.

<comment>See Also:</comment>
   * <strong>pg_result_error_field()</strong>
   * <strong>pg_query()</strong>
   * <strong>pg_send_query()</strong>
   * <strong>pg_get_result()</strong>
   * <strong>pg_last_error()</strong>
   * <strong>pg_last_notice()</strong>


id: pg_result_error_field
type: function
doc:
<comment>Description:</comment>
  Retourne un champ individuel d'un rapport d'erreur
    
  
  <strong>pg_result_error_field()</strong> retourne un des champs détaillés de message d'erreur qui sont associés à
  la ressource <strong>$result</strong>. Cette fonction est disponible seulement sur les serveurs PostgreSQL 7.4 ou
  supérieurs. Le champ d'erreur est spécifié par <strong>$field_code</strong>.
  
  Puisque <strong>pg_query()</strong> et <strong>pg_query_params()</strong> retourne <info>false</info> si la requête échoue, vous devez utiliser
  <strong>pg_send_query()</strong> et <strong>pg_get_result()</strong> pour obtenir le jeu de résultats.
  
  Si vous avez besoin d'obtenir plus d'informations sur l'erreur lors de l'échec des requêtes avec
  <strong>pg_query()</strong>, utilisez <strong>pg_set_error_verbosity()</strong> et <strong>pg_last_error()</strong> et analyser ensuite le résultat.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>      Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>,
                             ou <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$field_code</strong>  Les valeurs possibles de <strong>$field_code</strong> sont : <info>PGSQL_DIAG_SEVERITY</info>,
                             <info>PGSQL_DIAG_SQLSTATE</info>, <info>PGSQL_DIAG_MESSAGE_PRIMARY</info>,
                             <info>PGSQL_DIAG_MESSAGE_DETAIL</info>, <info>PGSQL_DIAG_MESSAGE_HINT</info>,
                             <info>PGSQL_DIAG_STATEMENT_POSITION</info>, <info>PGSQL_DIAG_INTERNAL_POSITION</info> (PostgreSQL
                             8.0+ seulement), <info>PGSQL_DIAG_INTERNAL_QUERY</info> (PostgreSQL 8.0+ seulement),
                             <info>PGSQL_DIAG_CONTEXT</info>, <info>PGSQL_DIAG_SOURCE_FILE</info>, <info>PGSQL_DIAG_SOURCE_LINE</info> ou
                             <info>PGSQL_DIAG_SOURCE_FUNCTION</info>.

<comment>Return:</comment>
  <info>string|false|null</info>  Retourne une chaîne contenant le contenu du champ d'erreur, <info>null</info> si le champ
                     n'existe pas ou <info>false</info> en cas d'échec.

<comment>See Also:</comment>
   * <strong>pg_result_error()</strong>


id: pg_result_seek
type: function
doc:
<comment>Description:</comment>
  Définit la position de la ligne dans un résultat
  
  <strong>pg_result_seek()</strong> choisit la ligne  <strong>$offset</strong> comme ligne courante dans le résultat <strong>$result</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                     <strong>pg_execute()</strong> (entre autres).
  <info>int</info>       <strong>$row</strong>     Ligne à déplacer la position interne dans le jeu de résultats <strong>$result</strong>. Les
                     lignes sont numérotées à partir de zéro.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_fetch_row()</strong>
   * <strong>pg_fetch_assoc()</strong>
   * <strong>pg_fetch_array()</strong>
   * <strong>pg_fetch_object()</strong>
   * <strong>pg_fetch_result()</strong>


id: pg_result_status
type: function
doc:
<comment>Description:</comment>
  Lit le statut du résultat
  
  <strong>pg_result_status()</strong> retourne le statut du résultat <strong>$result</strong> ou la commande d'exécution de PostgreSQL
  associée au résultat.

<comment>Param:</comment>
  <info>PgSql\Result</info>  <strong>$result</strong>  Une instance <class>PgSql\Result</class>, retourné par <strong>pg_query()</strong>, <strong>pg_query_params()</strong>, ou
                         <strong>pg_execute()</strong> (entre autres).
  <info>int</info>           <strong>$mode</strong>    Soit <info>PGSQL_STATUS_LONG</info> pour retourner un statut numérique de <strong>$result</strong> ou
                         <info>PGSQL_STATUS_STRING</info> pour retourner le tag de la commande de <strong>$result</strong>. Si
                         l'argument n'est pas spécifié, <info>PGSQL_STATUS_LONG</info> est la valeur par défaut.

<comment>Return:</comment>
  <info>string|int</info>  Les valeurs de retour possibles sont  <info>PGSQL_EMPTY_QUERY</info>, <info>PGSQL_COMMAND_OK</info>,
              <info>PGSQL_TUPLES_OK</info>, <info>PGSQL_COPY_OUT</info>, <info>PGSQL_COPY_IN</info>, <info>PGSQL_BAD_RESPONSE</info>,
              <info>PGSQL_NONFATAL_ERROR</info> et <info>PGSQL_FATAL_ERROR</info> si <info>PGSQL_STATUS_LONG</info> est spécifié.
              Autrement, une chaîne contenant le tag de la commande PostgreSQL est retourné.

<comment>See Also:</comment>
   * <strong>pg_connection_status()</strong>


id: pg_select
type: function
doc:
<comment>Description:</comment>
  Effectue une sélection PostgreSQL
    
  
  <strong>pg_select()</strong> sélectionne les enregistrements par <strong>$conditions</strong> qui est au format <return>field=&gt;value</return>.
  Lorsque la requête réussit, elle retourne un tableau contenant tous les enregistrements et champs
  qui vérifient la condition spécifiée par<strong>$conditions</strong>.
  
  Si <strong>$flags</strong> est spécifié, <strong>pg_convert()</strong> est appliqué à <strong>$values</strong> avec les drapeaux fournit.
  
  Si le paramètre <strong>$mode</strong> est défini, la valeur de retour sera sous la forme d'un tableau indexé avec
  <info>PGSQL_NUM</info>, un tableau associatif avec <info>PGSQL_ASSOC</info> (par défaut), ou les deux avec <info>PGSQL_BOTH</info>.
  
  Par défaut <strong>pg_delete()</strong> passe des valeurs brutes. Les valeurs doivent être échappé ou l'option
  PGSQL_DML_ESCAPE doit être fournit. PGSQL_DML_ESCAPE met des guillemets et échappe les
  paramètres/idantifiants. Par conséquent, les noms de table/colonnes doivent être sensible à la
  casse.
  
  Notez que ni l'échappement ni les requêtes préparer peuvent protéger des requêtes LIKE, JSON,
  Tableaux, Regex, etc. Ces paramètres devraient être traité en fonction de leur contexte. C'est à
  dire échapper/valider les valeurs.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Nom de la table à partir de laquelle sélectionner les lignes.
  <info>array</info>             <strong>$conditions</strong>  Un <info>array</info> dont les clés sont les noms des champs dans la table
                                 <strong>$table_name</strong>, et dont les valeurs sont les conditions qu'une ligne
                                 doit remplir pour être récupérée.
  <info>int</info>               <strong>$flags</strong>       Un nombre quelconque de <info>PGSQL_CONV_FORCE_NULL</info>, <info>PGSQL_DML_NO_CONV</info>,
                                 <info>PGSQL_DML_ESCAPE</info>, <info>PGSQL_DML_EXEC</info>, <info>PGSQL_DML_ASYNC</info> ou
                                 <info>PGSQL_DML_STRING</info> combinés. Si <info>PGSQL_DML_STRING</info> fait partie des
                                 <strong>$flags</strong>, alors la chaîne de requête est renvoyée. Lorsque
                                 <info>PGSQL_DML_NO_CONV</info> ou <info>PGSQL_DML_ESCAPE</info> est activé, <strong>pg_convert()</strong>
                                 n'est pas appelée en interne.
  <info>int</info>               <strong>$mode</strong>        Un nombre quelconque de <info>PGSQL_ASSOC</info>, <info>PGSQL_NUM</info> ou <info>PGSQL_BOTH</info>. Si
                                 <info>PGSQL_ASSOC</info> est défini, la valeur de retour sera un <info>array</info>
                                 associatif, avec <info>PGSQL_NUM</info>, la valeur de retour sera un <info>array</info>
                                 indexé numériquement, et avec <info>PGSQL_BOTH</info>, la valeur de retour sera
                                 à la fois un <info>array</info> associatif et numériquement indexé.

<comment>Return:</comment>
  <info>array|string|false</info>  Retourne une <info>string</info> si <info>PGSQL_DML_STRING</info> est fournit via <strong>$flags</strong>, sinon ceci
                      retourne un <info>array</info> en cas de succès,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>pg_convert()</strong>


id: pg_send_execute
type: function
doc:
<comment>Description:</comment>
  Envoie une requête pour exécuter une requête préparée avec des paramètres
     donnés, sans attendre le(s) résultat(s)
    
  
  Envoie une requête pour exécuter une requête préparée avec des paramètres donnés, sans attendre
  le(s) résultat(s).
  
  Cette fonction est similaire à <strong>pg_send_query_params()</strong>, mais la commande qui sera exécutée est
  spécifiée en nommant une requête préalablement préparée, au lieu de donner une chaîne en tant que
  requête. Les paramètres de la fonctions sont gérés de la même manière que <strong>pg_execute()</strong>. Comme
  <strong>pg_execute()</strong>, la fonction ne fonctionnera pas sur les versions antérieures à PostgreSQL 7.4.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>      Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$statement_name</strong>  Le nom de la requête préparée à exécuter. Si une chaîne vide
                                     est spécifiée (""), alors la requête qui n'est pas nommée est
                                     exécutée. Le nom doit avoir été précédemment préparé en
                                     utilisant <strong>pg_prepare()</strong>, <strong>pg_send_prepare()</strong> ou une commande SQL
                                     <return>PREPARE</return>.
  <info>array</info>             <strong>$params</strong>          Un tableau de valeurs de paramètres pour substituer les
                                     variables $1, $2, etc. dans la requête préparée originale. Le
                                     nombre d'éléments présents dans le tableau doit concorder avec
                                     le nombre de variables à remplacer.

<comment>Return:</comment>
  <info>int|bool</info>  Retourne <info>true</info> en cas de succès, <info>false</info> ou <return>0</return> en cas d'échec. Utilisez <strong>pg_get_result()</strong> pour
            déterminer le résultat de la requête.

<comment>See Also:</comment>
   * <strong>pg_prepare()</strong>
   * <strong>pg_send_prepare()</strong>
   * <strong>pg_execute()</strong>


id: pg_send_prepare
type: function
doc:
<comment>Description:</comment>
  Envoie une requête pour créer une requête préparée avec les paramètres
     donnés, sans attendre la fin de son exécution
    
  
  Envoie une requête pour créer une requête préparée avec les paramètres donnés, sans attendre la
  fin de son exécution.
  
  Cette fonction est la version asynchrone de <strong>pg_prepare()</strong> : elle retourne <info>true</info> si elle a été
  capable de répartir la requête et <info>false</info> si elle n'a pas été capable. Après un appel réussi,
  appelez <strong>pg_get_result()</strong> pour déterminer si le serveur a créé correctement la requête préparée. Les
  paramètres de la fonctions sont gérés de la même manière que <strong>pg_execute()</strong>. Comme <strong>pg_execute()</strong>, la
  fonction ne fonctionnera pas sur les versions antérieures à PostgreSQL 7.4.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>      Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$statement_name</strong>  Le nom à donner à la requête préparée. Il doit être unique à
                                     chaque session. Si une chaîne vide est spécifiée ("") alors une
                                     requête sans nom est créée, écrasant les requêtes sans nom
                                     précédemment définies.
  <info>string</info>            <strong>$query</strong>           La requête SQL avec ses paramètres. Elle doit contenir
                                     seulement une seule requête. Plusieurs requêtes séparées par
                                     des points-virgules ne sont pas autorisées. Si des paramètres
                                     sont utilisés, ils sont référés à $1, $2, etc.

<comment>Return:</comment>
  <info>int|bool</info>  Retourne <info>true</info> en cas de succès, <info>false</info> ou <return>0</return> en cas d'échec. Utilisez <strong>pg_get_result()</strong> pour
            déterminer le résultat de la requête.

<comment>See Also:</comment>
   * <strong>pg_connect()</strong>
   * <strong>pg_pconnect()</strong>
   * <strong>pg_execute()</strong>
   * <strong>pg_send_execute()</strong>
   * <strong>pg_send_query_params()</strong>


id: pg_send_query
type: function
doc:
<comment>Description:</comment>
  Exécute une requête PostgreSQL asynchrone
    
  
  <strong>pg_send_query()</strong> envoie une requête ou des requêtes de manière asynchrone à la connexion
  <strong>$connection</strong>. Contrairement à <strong>pg_query()</strong>, elle peut envoyer plusieurs requêtes à la fois au serveur
  PostgreSQL et obtenir les résultats un par un en utilisant <strong>pg_get_result()</strong>.
  
  L'exécution du script n'est pas bloquée durant l'exécution des requêtes. Utilisez
  <strong>pg_connection_busy()</strong> pour vérifier si la connexion est occupée (c'est-à-dire la requête est en
  train d'être exécutée). Les requêtes peuvent être annulées avec <strong>pg_cancel_query()</strong>.
  
  Bien que l'on puisse envoyer plusieurs requêtes en même temps, il n'est pas possible d'envoyer
  plusieurs requêtes sur une connexion occupée. Si une requête est envoyée alors que la connexion
  est occupée, elle attendra que la requête précédente soit terminée et perdra tous ses résultats.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  La ressource de connexion de la base de données PostgreSQL.
  <info>string</info>            <strong>$query</strong>       La requête ou les requêtes SQL à être exécutées.
                                 
                                 Les données contenues dans la requête doivent être échappées
                                 proprement.

<comment>Return:</comment>
  <info>int|bool</info>  Retourne <info>true</info> en cas de succès, <info>false</info> ou <return>0</return> en cas d'échec. Utilisez <strong>pg_get_result()</strong> pour
            déterminer le résultat de la requête.

<comment>See Also:</comment>
   * <strong>pg_query()</strong>
   * <strong>pg_cancel_query()</strong>
   * <strong>pg_get_result()</strong>
   * <strong>pg_connection_busy()</strong>


id: pg_send_query_params
type: function
doc:
<comment>Description:</comment>
  Envoie une commande et sépare les paramètres au serveur sans attendre le(s)
     résultat(s)
    
  
  Envoie une commande et sépare les paramètres au serveur sans attendre le(s) résultat(s).
  
  Cette fonction est équivalente à <strong>pg_send_query()</strong> à l'exception que les paramètres de la requête
  peuvent être spécifiés séparément de la chaîne de requête <strong>$query</strong>. Les paramètres de la fonctions
  sont gérés de la même manière que <strong>pg_execute()</strong>. Comme <strong>pg_execute()</strong>, la fonction ne fonctionnera
  pas sur les versions antérieures à PostgreSQL 7.4 et elle n'autorise qu'une seule commande par
  requête.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$query</strong>       La requête SQL avec ses paramètres. Elle doit contenir seulement
                                 une seule requête. Plusieurs requêtes séparées par des
                                 points-virgules ne sont pas autorisées. Si des paramètres sont
                                 utilisés, ils sont référés à $1, $2, etc.
  <info>array</info>             <strong>$params</strong>      Un tableau de valeurs de paramètres pour substituer les variables
                                 $1, $2, etc. dans la requête préparée originale. Le nombre
                                 d'éléments présents dans le tableau doit concorder avec le nombre
                                 de variables à remplacer.

<comment>Return:</comment>
  <info>int|bool</info>  Retourne <info>true</info> en cas de succès, <info>false</info> ou <return>0</return> en cas d'échec. Utilisez <strong>pg_get_result()</strong> pour
            déterminer le résultat de la requête.

<comment>See Also:</comment>
   * <strong>pg_send_query()</strong>


id: pg_set_client_encoding
type: function
doc:
<comment>Description:</comment>
  Choisit l'encodage du client PostgreSQL
    
  
  <strong>pg_set_client_encoding()</strong> fixe l'encodage du client. Elle retourne 0 en cas de succès et -1 en cas
  d'erreur.
  
  PostgreSQL convertira automatiquement les données dans l'encodage de la base de données vers
  l'encodage du client.
  
  Auparavant, cette fonction s'appelait <strong>pg_setclientencoding()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>string</info>            <strong>$encoding</strong>    L'encodage client demandé. Un de ces constantes : <return>SQL_ASCII</return>,
                                 <return>EUC_JP</return>,  <return>EUC_CN</return>, <return>EUC_KR</return>, <return>EUC_TW</return>,  <return>UNICODE</return>, <return>MULE_INTERNAL</return>, <return>LATINX</return>
                                 (X=1...9),  <return>KOI8</return>, <return>WIN</return>, <return>ALT</return>, <return>SJIS</return>,  <return>BIG5</return> ou <return>WIN1250</return>.
                                 
                                 La liste exacte des encodages disponibles dépend de votre version
                                 PostgreSQL, alors vérifiez votre manuel PostgreSQL pour une liste
                                 plus spécifique.

<comment>Return:</comment>
  <info>int</info>  Retourne <return>0</return> en cas de succès ou <return>-1</return> en cas d'erreur.

<comment>See Also:</comment>
   * <strong>pg_client_encoding()</strong>


id: pg_set_error_context_visibility
type: function
doc:
<comment>Description:</comment>
  Détermine la visibilité des messages d'erreur du contexte retournés par pg_last_error
           et pg_result_error
        
  
  Détermine la visibilité des messages d'erreur du contexte retournés par <strong>pg_last_error()</strong> et
  <strong>pg_result_error()</strong>

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>int</info>               <strong>$visibility</strong>  La visibilité requise : <info>PGSQL_SHOW_CONTEXT_NEVER</info>,
                                 <info>PGSQL_SHOW_CONTEXT_ERRORS</info> ou <info>PGSQL_SHOW_CONTEXT_ALWAYS</info>.

<comment>Return:</comment>
  <info>int</info>  Le niveau de visibilité précédent : <info>PGSQL_SHOW_CONTEXT_NEVER</info>, <info>PGSQL_SHOW_CONTEXT_ERRORS</info> ou
       <info>PGSQL_SHOW_CONTEXT_ALWAYS</info>.

<comment>See Also:</comment>
   * <strong>pg_last_error()</strong>
   * <strong>pg_result_error()</strong>


id: pg_set_error_verbosity
type: function
doc:
<comment>Description:</comment>
  Détermine la le degré des messages retournés par
     pg_last_error et pg_result_error
    
  
  Détermine la le degré des messages retournés par <strong>pg_last_error()</strong> et <strong>pg_result_error()</strong>.
  
  <strong>pg_set_error_verbosity()</strong> fixe le degré d'erreur et retourne le paramètre précédant de la
  connexion. Avec le mode <info>PGSQL_ERRORS_TERSE</info>, 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 (<info>PGSQL_ERRORS_DEFAULT</info>) 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 <info>PGSQL_ERRORS_VERBOSE</info> 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.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est pas spécifié,
                                 la connexion par défaut est utilisé. La connexion par défaut est la
                                 dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong> À partir
                                 de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
                                 
                                 À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                 obsolète.
  <info>int</info>               <strong>$verbosity</strong>   Le degré de message d'erreur :  <info>PGSQL_ERRORS_TERSE</info>,
                                 <info>PGSQL_ERRORS_DEFAULT</info> ou <info>PGSQL_ERRORS_VERBOSE</info>.

<comment>Return:</comment>
  <info>int</info>  Le degré de message d'erreur précédant : <info>PGSQL_ERRORS_TERSE</info>, <info>PGSQL_ERRORS_DEFAULT</info> ou
       <info>PGSQL_ERRORS_VERBOSE</info>.

<comment>See Also:</comment>
   * <strong>pg_last_error()</strong>
   * <strong>pg_result_error()</strong>


id: pg_socket
type: function
doc:
<comment>Description:</comment>
  Récupère un gestionnaire de lecture seul sur le socket sous-jacent d'une connexion PostgreSQL
    
  
  La fonction <strong>pg_socket()</strong> retourne une ressource en lecture seule correspondant au socket
  sous-jacent de la connexion PostgreSQL fournie.
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>resource|false</info>  Une ressource de socket en cas de succès ou <info>false</info> si une erreur survient.


id: pg_trace
type: function
doc:
<comment>Description:</comment>
  Active le suivi d'une connexion PostgreSQL
    
  
  <strong>pg_trace()</strong> active le suivi des communications entre PHP et le serveur PostgreSQL. Cet historique
  sera enregistré dans un fichier. Pour comprendre ces lignes, il faut être familier avec le
  protocole de communication interne à PostgreSQL.
  
  Pour ceux qui le ne sont pas, elles peuvent être utiles pour suivre les requêtes et les erreurs :
  avec la commande grep '^To backend' trace.log, vous pourrez voir les requêtes réellement envoyées
  au serveur PostgreSQL. Pour plus d'informations, référez-vous à la  Documentation PostgreSQL.

<comment>Param:</comment>
  <info>string</info>                 <strong>$filename</strong>    Le chemin complet et le nom du fichier dans lequel le suivi
                                      sera enregistré. Comme <strong>fopen()</strong>.
  <info>string</info>                 <strong>$mode</strong>        Le mode d'accès optionnel, comme <strong>fopen()</strong>.
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
  <info>int</info>                    <strong>$trace_mode</strong>  Un mode de trace facultatif avec les constantes suivantes :
                                      <info>PGSQL_TRACE_SUPPRESS_TIMESTAMPS</info> et <info>PGSQL_TRACE_REGRESS_MODE</info>

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>fopen()</strong>
   * <strong>pg_untrace()</strong>


id: pg_transaction_status
type: function
doc:
<comment>Description:</comment>
  Retourne le statut de la transaction en cours du serveur
    
  
  Retourne le statut de la transaction en cours du serveur.
  
  <strong>pg_transaction_status()</strong> donnera de mauvais résultats lorsque vous l'utiliserez avec un serveur
  PostgreSQL 7.3 qui a le paramètre <return>autocommit</return> désactivé. La fonctionnalité de autocommit est
  obsolète et n'existe plus dans les versions de serveur plus récentes.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.

<comment>Return:</comment>
  <info>int</info>  Le statut peut être <info>PGSQL_TRANSACTION_IDLE</info> (actuellement inactif), <info>PGSQL_TRANSACTION_ACTIVE</info>
       (une commande est en cours), <info>PGSQL_TRANSACTION_INTRANS</info> (inactif, dans un bloc de transaction
       valide), ou <info>PGSQL_TRANSACTION_INERROR</info> (inactif, dans un bloc de transaction en échec).
       <info>PGSQL_TRANSACTION_UNKNOWN</info> est retourné si la connexion est mauvaise. <info>PGSQL_TRANSACTION_ACTIVE</info>
       est retourné seulement si la requête a été envoyée au serveur et que celle-ci n'a pas été
       encore complétée.


id: pg_tty
type: function
doc:
<comment>Description:</comment>
  Retourne le nom de TTY associé à la connexion
    
  
  <strong>pg_tty()</strong> retourne le nom de TTY de la connexion associée à <strong>$connection</strong>.
  
  <strong>pg_tty()</strong> est obsolète, depuis le serveur ne fait plus attention à la configuration TTY, mais
  demeure pour des raisons de compatibilités.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>string</info>  Une chaîne contenant le débogue TTY de la connexion <strong>$connection</strong>.


id: pg_unescape_bytea
type: function
doc:
<comment>Description:</comment>
  Supprime la protection d'une chaîne de type bytea
    
  
  <strong>pg_unescape_bytea()</strong> supprime la protection des caractères de type bytea. Elle retourne la chaîne
  de caractères protégée, pouvant contenir des données binaires.
  
  Lorsque vous utilisez une commande <return>SELECT</return>  avec des données de type bytea,  PostgreSQL retourne
  des valeurs  octales, préfixées avec des antislashs \ (e.g. \032). Les utilisateurs doivent
  effectuer la conversion en format binaire eux-mêmes.
  
  <strong>pg_escape_bytea()</strong> requiert PostgreSQL 7.2 ou plus récent. Avec PostgreSQL 7.2.0 et 7.2.1, les
  données de type bytea doivent être transtypée  lorsque vous activez le support des chaînes de
  caractères multioctets. i.e. <return>INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);</return>.
  PostgreSQL 7.2.2 ou plus récent ne requiert pas cette manipulation. Toutefois, si le client et le
  serveur n'utilisent pas le même jeu de caractères, il peut arriver des erreurs. Il faut alors
  forcer le transtypage manuellement pour éviter cette erreur.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Une chaîne de caractères contenant les données bytea PostgreSQL à être converties
                   en chaîne de caractères binaire PHP.

<comment>Return:</comment>
  <info>string</info>  Une chaîne de caractères contenant les données protégées.

<comment>See Also:</comment>
   * <strong>pg_escape_bytea()</strong>
   * <strong>pg_escape_string()</strong>


id: pg_untrace
type: function
doc:
<comment>Description:</comment>
  Termine le suivi d'une connexion PostgreSQL
    
  
  <strong>pg_untrace()</strong> termine le suivi d'une connexion PostgreSQL, initiée avec <strong>pg_trace()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>true</info>  Retourne toujours <info>true</info>.

<comment>See Also:</comment>
   * <strong>pg_trace()</strong>


id: pg_update
type: function
doc:
<comment>Description:</comment>
  Modifie les lignes d'une table
    
  
  <strong>pg_update()</strong> modifie les lignes de la table <strong>$table_name</strong>, qui vérifient la condition <strong>$conditions</strong>
  avec <strong>$values</strong>.
  
  Si <strong>$flags</strong> est spécifié, <strong>pg_convert()</strong> est appliqué à <strong>$values</strong> avec les drapeaux fournit.
  
  Par défaut <strong>pg_update()</strong> passe des valeurs brutes. Les valeurs doivent être échappé ou le drapeau
  <info>PGSQL_DML_ESCAPE</info> doit être spécifié dans <strong>$flags</strong>. <info>PGSQL_DML_ESCAPE</info> met des guillemets et échappe
  les paramètres/identifiants. Par conséquent, les noms de table/colonnes deviennent sensible à la
  casse.
  
  Notez que ni l'échappement ni les requêtes préparer peuvent protéger des requêtes LIKE, JSON,
  Tableaux, Regex, etc. Ces paramètres devraient être traité en fonction de leur contexte. C'est à
  dire échapper/valider les valeurs.

<comment>Param:</comment>
  <info>PgSql\Connection</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>.
  <info>string</info>            <strong>$table_name</strong>  Le nom de la table dans laquelle les lignes seront mises à jour.
  <info>array</info>             <strong>$values</strong>      Un tableau dont les clés sont les noms des champs dans la table
                                 <strong>$table_name</strong>, et où les valeurs  sont les lignes correspondantes qui
                                 seront mises à jour.
  <info>array</info>             <strong>$conditions</strong>  Un tableau dont les clés sont les noms des champs dans la table
                                 <strong>$table_name</strong>, et où les valeurs sont les conditions à remplir par
                                 les lignes pour être mises à jour.
  <info>int</info>               <strong>$flags</strong>       Toutes combinaisons de constantes parmi <info>PGSQL_CONV_FORCE_NULL</info>,
                                 <info>PGSQL_DML_NO_CONV</info>, <info>PGSQL_DML_ESCAPE</info>, <info>PGSQL_DML_EXEC</info>,
                                 <info>PGSQL_DML_ASYNC</info> ou <info>PGSQL_DML_STRING</info>. Si <info>PGSQL_DML_STRING</info> fait
                                 partie du paramètre <strong>$flags</strong>, alors la requête sera retournée.
                                 Lorsque la constante <info>PGSQL_DML_NO_CONV</info> ou la constante
                                 <info>PGSQL_DML_ESCAPE</info> est définie, aucun appel à la fonction
                                 <strong>pg_convert()</strong> ne sera réalisé en interne.

<comment>Return:</comment>
  <info>string|bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
               Retourne une chaîne de caractères si <info>PGSQL_DML_STRING</info> est passé via le paramètre
               <strong>$flags</strong>.

<comment>See Also:</comment>
   * <strong>pg_convert()</strong>


id: pg_version
type: function
doc:
<comment>Description:</comment>
  Retourne un tableau avec les versions du client, du protocole et du serveur (si disponible)
    
  
  <strong>pg_version()</strong> retourne un tableau avec les versions du client, du protocole et du serveur. Les
  versions du protocole et du serveur ne sont disponibles que si PHP a été compilé avec PostgreSQL
  7.4 ou supérieur.
  
  Pour plus d'informations sur le serveur, utilisez <strong>pg_parameter_status()</strong>.

<comment>Param:</comment>
  <info>PgSql\Connection|null</info>  <strong>$connection</strong>  Une instance <class>PgSql\Connection</class>. Quand <strong>$connection</strong> est <info>null</info>, la
                                      connexion par défaut est utilisé. La connexion par défaut est
                                      la dernière connexion faite par <strong>pg_connect()</strong> ou <strong>pg_pconnect()</strong>
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.
                                      
                                      À partir de PHP 8.1.0, utiliser la connexion par défaut est
                                      obsolète.

<comment>Return:</comment>
  <info>array</info>  Retourne un tableau avec les clés <return>client</return>, <return>protocol</return> et <return>server</return> et valeurs (si disponibles).

<comment>See Also:</comment>
   * <strong>pg_parameter_status()</strong>


id: php_ini_loaded_file
type: function
doc:
<comment>Description:</comment>
  Récupère le chemin d'un fichier php.ini chargé
  
  Vérifie si un fichier php.ini est chargé, et récupère son chemin.

<comment>Return:</comment>
  <info>string|false</info>  Le chemin du fichier php.ini chargé, ou <info>false</info> si aucun n'a été chargé.

<comment>See Also:</comment>
   * <strong>php_ini_scanned_files()</strong>
   * <strong>phpinfo()</strong>
   * Le fichier de configuration


id: php_ini_scanned_files
type: function
doc:
<comment>Description:</comment>
  Retourne la liste des fichiers .ini analysés dans les dossiers de configuration supplémentaires
  
  <strong>php_ini_scanned_files()</strong> retourne une liste de noms de fichiers de configuration analysés après
  php.ini. Cette liste est au format CSV. Les dossiers examinés sont définis par une option de
  configuration lors de la compilation, et optionnellement par une variable d'environnement lors de
  l'exécution : plus d'information sont disponible dans le guide d'installation.
  
  Les fichiers de configuration retournés incluent le chemin entier.

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères où les fichiers .ini sont séparés par des virgules
                en cas de succès. Chaque virgule est suivie d'un retour à la ligne. Si la directive
                de configuration --with-config-file-scan-dir n'a pas était définit et que la
                variable d'environnement PHP_INI_SCAN_DIR n'est pas définit, <info>false</info> est retourné. Si
                c'était définit et que le dossier était vide, une chaîne vide est retournée. Si un
                fichier est méconnaissable, le fichier sera quand même inclus dans la chaîne de
                caractères retourné mais entraînera également une erreur PHP. Cette erreur PHP sera
                visible à la fois au moment de la compilation et lors de l'utilisation de
                <strong>php_ini_scanned_files()</strong>.

<comment>See Also:</comment>
   * <strong>ini_set()</strong>
   * <strong>phpinfo()</strong>
   * <strong>php_ini_loaded_file()</strong>


id: php_sapi_name
type: function
doc:
<comment>Description:</comment>
  Retourne le type d'interface utilisée entre le serveur web et PHP
  
  Retourne une chaîne en minuscule qui décrit le type d'interface (l'API, SAPI serveur) que PHP
  utilise. Par exemple, en PHP CLI, cette chaîne sera "cli" tandis qu'avec Apache, elle pourra avoir
  plusieurs valeurs différentes suivant le SAPI exact utilisé. Les valeurs possibles sont listées
  ci-dessous.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le type de l'interface, sous la forme d'une chaîne de caractères en
                minuscule,  ou <info>false</info> si une erreur survient.
                
                Voici une liste non exhaustive des valeurs possibles :  <return>apache</return>,  <return>apache2handler</return>,
                <return>cgi</return> (jusqu'en PHP 5.3), <return>cgi-fcgi</return>, <return>cli</return>, <return>cli-server</return>, <return>embed</return>, <return>fpm-fcgi</return>, <return>litespeed</return>,
                <return>phpdbg</return>.

<comment>See Also:</comment>
   * PHP_SAPI


id: php_strip_whitespace
type: function
doc:
<comment>Description:</comment>
  Retourne la source sans commentaires, ni espaces blancs
  
  Retourne le code source PHP du paramètre <strong>$filename</strong> en ayant supprimé les commentaires ainsi que
  les espaces. Cela peut être utile pour comparer la quantité de code avec la quantité de
  commentaire dans votre code. Cela revient à utiliser la commande php -w depuis la ligne de
  commande.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers le fichier PHP.

<comment>Return:</comment>
  <info>string</info>  Le code source nettoyé sera retourné en cas de succès ou une chaîne vide en cas d'échec.
          
          Cette fonction respecte la valeur de la directive INI  short_open_tag.


id: php_uname
type: function
doc:
<comment>Description:</comment>
  Retourne les informations sur le système d'exploitation
  
  <strong>php_uname()</strong> retourne une description sur le système  d'exploitation sur lequel tourne PHP. C'est
  la même chaîne que celle que vous voyez en haut du <strong>phpinfo()</strong>.  Si vous voulez juste savoir le nom
  du système d'exploitation, utilisez plutôt la constante <info>PHP_OS</info> mais gardez à l'esprit que cette
  constante contient le nom du système sur lequel PHP a été compilé.
  
  Sur certaines vieilles plate-formes Unix, il n'est pas possible de déterminer les informations
  courantes de l'OS, auquel cas cette fonction se contente de retourner le nom de l'OS sur lequel
  PHP a été compilé. Cela n'arrivera que si votre bibliothèque <return>uname()</return>  n'existe pas ou ne
  fonctionne pas.

<comment>Param:</comment>
  <info>string</info>  <strong>$mode</strong>  <strong>$mode</strong> est un seul caractère qui définit quelles seront les informations à retourner
                 : <return>'a'</return>: par défaut, contient tous les modes  de la séquence <return>"s n r v m"</return>. <return>'s'</return>: nom du
                 système d'exploitation.  Par exemple, <return>FreeBSD</return>. <return>'n'</return>: nom de l'hôte. Par exemple,
                 <return>localhost.example.com</return>. <return>'r'</return>: nom de la version. Par exemple, <return>5.1.2-RELEASE</return>. <return>'v'</return>:
                 information sur la version.  Varie énormément suivant le système d'exploitation.
                 <return>'m'</return>: type de la machine.  Par exemple, <return>i386</return>.
                 
                 <return>'a'</return>: par défaut, contient tous les modes  de la séquence <return>"s n r v m"</return>.
                 
                 <return>'s'</return>: nom du système d'exploitation.  Par exemple, <return>FreeBSD</return>.
                 
                 <return>'n'</return>: nom de l'hôte. Par exemple,   <return>localhost.example.com</return>.
                 
                 <return>'r'</return>: nom de la version. Par exemple, <return>5.1.2-RELEASE</return>.
                 
                 <return>'v'</return>: information sur la version.  Varie énormément suivant le système
                 d'exploitation.
                 
                 <return>'m'</return>: type de la machine.  Par exemple, <return>i386</return>.

<comment>Return:</comment>
  <info>string</info>  Retourne la description, sous la forme d'une chaîne de caractères.

<comment>See Also:</comment>
   * <strong>phpversion()</strong>
   * <strong>php_sapi_name()</strong>
   * <strong>phpinfo()</strong>


id: php_user_filter
type: class
doc:
<comment>Description:</comment>
  Les enfants de cette classe sont passés à la fonction <strong>stream_filter_register()</strong>. Il est à noter que
  la méthode __construct n'est pas appelée; à la place, php_user_filter::onCreate devrait être
  utilisé pour l'initialisation.


id: php_user_filter::filter
type: function
doc:
<comment>Description:</comment>
  Appelé lors de l'application d'un filtre
  
  Cette méthode est appelée lorsque les données sont lues depuis le flux attaché, ou écrites sur le
  flux attaché (lors de l'utilisation de la fonction <strong>fread()</strong> ou la fonction <strong>fwrite()</strong>).

<comment>Param:</comment>
  <info>resource</info>  <strong>$in</strong>        Le paramètre <strong>$in</strong> est une ressource pointant vers un <return>bucket brigade</return> qui
                       contient un ou plusieurs objets <return>bucket</return> contenant les données à filtrer.
  <info>resource</info>  <strong>$out</strong>       Le paramètre <strong>$out</strong> est une ressource pointant vers un second <return>bucket brigade</return>
                       dans lequel vos <return>bucket</return> modifiés doivent être placés.
  <info>int</info>       <strong>$consumed</strong>  Le paramètre <strong>$consumed</strong>, qui doit toujours être déclaré par référence, doit
                       être incrémenté par la longueur des données filtrés par votre filtre. Dans la
                       plupart des cas, cela signifie que vous devez incrémenter le paramètre
                       <strong>$consumed</strong> par <return>$bucket-&gt;datalen</return> pour chaque <return>$bucket</return>.
  <info>bool</info>      <strong>$closing</strong>   Si le flux est dans un processus de fermeture (et donc, c'est la dernière
                       passe via la chaîne de filtrage), le paramètre <strong>$closing</strong> sera défini à <info>true</info>.

<comment>Return:</comment>
  <info>int</info>  La méthode filter doit retourner au final une de ces trois valeurs. Valeur
       retournéeSignification<info>PSFS_PASS_ON</info> Le processus de filtrage s'est terminé avec succès, et les
       données sont disponibles dans le paramètre <strong>$out</strong> <return>bucket brigade</return>. <info>PSFS_FEED_ME</info> Le processus de
       filtrage s'est terminé avec succès, cependant, aucune donnée n'est disponible pour être
       retourné. Plus de données sont requis depuis le flux ou avant filtrage. <info>PSFS_ERR_FATAL</info>
       (défaut) Le filtre a rencontré une erreur fatale et ne peut continuer.


id: php_user_filter::onClose
type: function
doc:
<comment>Description:</comment>
  Appelé lors de la fermeture du filtre
  
  Cette méthode est appelée lors de la fermeture du filtre (typiquement, c'est aussi le cas lors de
  la fermeture du flux), et est exécutée après l'appel à la méthode <return>flush</return>. Si des ressources avaient
  été allouées ou initialisées pendant <return>onCreate()</return>, c'est alors le moment de les détruire ou de les
  rendre à disposition.

<comment>Return:</comment>
  <info>void</info>  La valeur retournée est ignorée.


id: php_user_filter::onCreate
type: function
doc:
<comment>Description:</comment>
  Appelé lors de la création du filtre
  
  Cette méthode est appelée lors de l'instanciation de l'objet de la classe de filtrage. Si votre
  filtre alloue ou initialise d'autres ressources (comme un buffer), c'est la place pour le faire.
  
  Lorsque votre filtre est instancié et que <return>yourfilter-&gt;onCreate()</return> est appelé, un nombre de
  propriétés sera disponible comme montré dans la table ci-dessous.
  
  PropriétésContenus<return>FilterClass-&gt;filtername</return> Une chaîne contenant le nom utilisé pour instancier
  le filtre. Les filtres peuvent être enregistrés sous plusieurs noms ou avec des jokers. Utilisez
  cette propriété pour déterminer quel est le nom qui a été utilisé. <return>FilterClass-&gt;params</return> Le
  contenu du pramètre <strong>$params</strong> passé à la fonction <strong>stream_filter_append()</strong> ou la fonction
  <strong>stream_filter_prepend()</strong>. <return>FilterClass-&gt;stream</return> La ressource du flux à filtrer. Ne peut être
  disponible que lors de l'appel à la méthode filter lorsque le paramètre <return>closing</return> est défini à
  <info>false</info>.

<comment>Return:</comment>
  <info>bool</info>  Votre implémentation de cette méthode doit retourner <info>false</info> si une erreur survient, ou <info>true</info>
        en cas de succès.


id: phpcredits
type: function
doc:
<comment>Description:</comment>
  Affiche les crédits de PHP
  
  Affiche la liste des développeurs PHP, des modules, etc. Elle génère le code HTML approprié pour
  insérer les informations dans une page.

<comment>Param:</comment>
  <info>int</info>  <strong>$flags</strong>  Pour générer une page personnalisée sur les crédits, il faut utiliser le paramètre
               <strong>$flags</strong>.
               
               Paramètres prédéfinis de <strong>phpcredits()</strong>NomDescriptionCREDITS_ALL Tous les crédits,
               équivalent à : <info>CREDITS_DOCS</info> + <info>CREDITS_GENERAL</info> + <info>CREDITS_GROUP</info> + <info>CREDITS_MODULES</info> +
               <info>CREDITS_FULLPAGE</info>. La fonction génère alors une page HTML complète. CREDITS_DOCSLes
               crédits du groupe de documentationCREDITS_FULLPAGE En général, ce paramètre est
               utilisé avec d'autres constantes. Il indique que la page ainsi générée doit être une
               page HTML complète, avec toutes les balises nécessaires. CREDITS_GENERAL Crédits
               Généraux : conception et design du langage, auteurs de PHP et du module SAPI.
               CREDITS_GROUPUne liste des développeurs principauxCREDITS_MODULES Une liste des
               extensions de PHP, et leurs auteurs CREDITS_SAPI Une liste des API serveur pour PHP
               et leurs auteurs

<comment>Return:</comment>
  <info>true</info>  Retourne toujours <info>true</info>.

<comment>See Also:</comment>
   * <strong>phpversion()</strong>
   * <strong>phpinfo()</strong>


id: phpdbg_break_file
type: function
doc:
<comment>Description:</comment>
  Insère un point d'arrêt dans une ligne d'un fichier
  
  Insère un point d'arrêt à la ligne <strong>$line</strong> dans le fichier <strong>$file</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$file</strong>  Le nom du fichier.
  <info>int</info>     <strong>$line</strong>  Le numéro de la ligne.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_break_function()</strong>
   * <strong>phpdbg_break_method()</strong>
   * <strong>phpdbg_break_next()</strong>
   * <strong>phpdbg_clear()</strong>


id: phpdbg_break_function
type: function
doc:
<comment>Description:</comment>
  Insère un point d'arrêt à l'entrée d'une fonction
  
  Insère un point d'arrêt à l'entrée de la fonction <strong>$function</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$function</strong>  Le nom de la fonction.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_break_file()</strong>
   * <strong>phpdbg_break_method()</strong>
   * <strong>phpdbg_break_next()</strong>
   * <strong>phpdbg_clear()</strong>


id: phpdbg_break_method
type: function
doc:
<comment>Description:</comment>
  Insère un point d'arrêt à l'entrée d'une méthode
  
  Insère un point d'arrêt à l'entrée de la méthode <strong>$method</strong> de la classe <strong>$class</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$class</strong>   Le nom de la classe.
  <info>string</info>  <strong>$method</strong>  Le nom de la méthode.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_break_file()</strong>
   * <strong>phpdbg_break_function()</strong>
   * <strong>phpdbg_break_next()</strong>
   * <strong>phpdbg_clear()</strong>


id: phpdbg_break_next
type: function
doc:
<comment>Description:</comment>
  Insère un point d'arrêt au prochain opcode
  
  Insère un point d'arrêt au prochain opcode.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_break_file()</strong>
   * <strong>phpdbg_break_function()</strong>
   * <strong>phpdbg_break_method()</strong>
   * <strong>phpdbg_clear()</strong>


id: phpdbg_clear
type: function
doc:
<comment>Description:</comment>
  Supprime tous les points d'arrêt
  
  Supprime tous les points d'arrêt qui ont été définis, soit via une des fonctions <strong>phpdbg_break_*()</strong>,
  ou interactivement via la console.
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_break_file()</strong>
   * <strong>phpdbg_break_function()</strong>
   * <strong>phpdbg_break_method()</strong>
   * <strong>phpdbg_break_next()</strong>


id: phpdbg_color
type: function
doc:
<comment>Description:</comment>
  Définie la couleur de certaines éléments
  
  Définie la couleur <strong>$color</strong> pour l'élément <strong>$element</strong>.

<comment>Param:</comment>
  <info>int</info>     <strong>$element</strong>  Une des constantes <info>PHPDBG_COLOR_*</info>.
  <info>string</info>  <strong>$color</strong>    Le nom de la couleur. Peut être <return>white</return>, <return>red</return>, <return>green</return>, <return>yellow</return>, <return>blue</return>, <return>purple</return>, <return>cyan</return> ou
                    <return>black</return>, et, optionnellement, avec les compléments <return>-bold</return> ou <return>-underline</return> ; par
                    exemple <return>white-bold</return> ou <return>green-underline</return>.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_prompt()</strong>


id: phpdbg_end_oplog
type: function
doc:
<comment>Description:</comment>
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>array</info>  <strong>$options</strong>  

<comment>Return:</comment>
  <info>array|null</info>  


id: phpdbg_exec
type: function
doc:
<comment>Description:</comment>
  Tente de définir le contexte d'exécution
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>string</info>  <strong>$context</strong>  

<comment>Return:</comment>
  <info>string|bool</info>  Si le contexte d'exécution a été défini avec succès, ce contexte sera retourné. Si le
               contexte d'exécution n'a pas été défini, <info>true</info> sera retourné. Si une erreur est
               survenue pendant la définition du contexte, <info>false</info> sera retourné et un erreur de
               niveau <info>E_WARNING</info> sera émise.


id: phpdbg_get_executable
type: function
doc:
<comment>Description:</comment>
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>array</info>  <strong>$options</strong>  

<comment>Return:</comment>
  <info>array</info>  


id: phpdbg_prompt
type: function
doc:
<comment>Description:</comment>
  Définie l'invite de commande
  
  Définie l'invite de commande pour la chaîne <strong>$string</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  La chaîne à utiliser comme invite de commande.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>phpdbg_color()</strong>


id: phpdbg_start_oplog
type: function
doc:
<comment>Description:</comment>
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.


id: phpinfo
type: function
doc:
<comment>Description:</comment>
  Affiche de nombreuses informations sur la configuration de PHP
  
  Affiche de nombreuses informations sur PHP, concernant sa configuration courante : options de
  compilation, extensions, version, informations sur le serveur, et l'environnement (lorsqu'il est
  compilé comme module), environnement PHP, informations sur le système, chemins, valeurs générales
  et locales de configuration, en-têtes HTTP et la licence PHP.
  
  Comme tous les systèmes sont configurés différemment, <strong>phpinfo()</strong> sert généralement à vérifier la
  configuration ainsi que les variables prédéfinies, pour une plate-forme donnée.
  
  <strong>phpinfo()</strong> est un bon outil de débogage, car il affiche le contenu de toutes les variables EGPCS
  (Environnement, GET, POST, Cookie, Serveur).

<comment>Param:</comment>
  <info>int</info>  <strong>$flags</strong>  L'affichage peut être personnalisé en utilisant une ou plusieurs des constantes
               suivantes. Elles sont combinables avec l' opérateur sur les bits ou , et doivent être
               passées dans le paramètre <strong>$flags</strong>. Vous pouvez aussi additionner ces constantes.
               
               Options de <strong>phpinfo()</strong>Nom de la constanteValeurDescriptionINFO_GENERAL1 La ligne de
               configuration, le chemin du php.ini, la date de compilation, le serveur web, le
               système, etc. INFO_CREDITS2 Les crédits de PHP. Voir aussi <strong>phpcredits()</strong>.
               INFO_CONFIGURATION4 Valeurs courantes locales et générales des directives PHP. Voyez
               aussi la fonction <strong>ini_get()</strong>. INFO_MODULES8 Modules chargés et leur configuration
               spécifique. Voir aussi la fonction <strong>get_loaded_extensions()</strong>. INFO_ENVIRONMENT16
               Informations sur les variables d'environnement, qui sont disponibles dans la variable
               $_ENV. INFO_VARIABLES32 Affiche toutes les variables prédéfinies, issues de
               l'environnement, la méthode GET, la méthode POST, les cookies et le serveur.
               INFO_LICENSE64 La licence PHP. Voir aussi la FAQ de la licence. INFO_ALL-1 Affiche
               toutes les informations suscitées.

<comment>Return:</comment>
  <info>true</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>phpversion()</strong>
   * <strong>phpcredits()</strong>
   * <strong>ini_get()</strong>
   * <strong>ini_set()</strong>
   * <strong>get_loaded_extensions()</strong>
   * les variables prédéfinies


id: phpversion
type: function
doc:
<comment>Description:</comment>
  Retourne le numéro de la version courante de PHP
  
  Retourne le numéro de la version courante de PHP.

<comment>Param:</comment>
  <info>string|null</info>  <strong>$extension</strong>  Un nom d'extension, optionnel.

<comment>Return:</comment>
  <info>string|false</info>  Retourne la version actuelle de PHP en tant que <info>string</info>. Si un argument <info>string</info> est
                fournit au paramètre <strong>$extension</strong>, <strong>phpversion()</strong> retourne la version de cette
                extension, ou <info>false</info> s'il n'y a pas d'information de version associé ou cette
                extension n'est pas activé.

<comment>See Also:</comment>
   * les constantes PHP_VERSION
   * <strong>version_compare()</strong>
   * <strong>phpinfo()</strong>
   * <strong>phpcredits()</strong>
   * <strong>zend_version()</strong>


id: pi
type: function
doc:
<comment>Description:</comment>
  Retourne la valeur de pi
  
  Retourne une approximation de pi. De plus, vous pouvez utiliser la constante <info>M_PI</info>, qui retourne un
  résultat identique à la fonction  <strong>pi()</strong>.

<comment>Return:</comment>
  <info>float</info>  La valeur de pi en tant que nombre décimal.


id: png2wbmp
type: function
doc:
<comment>Description:</comment>
  Convertit une image PNG en image WBMP
  
  Convertit une image PNG en image WBMP.

<comment>Param:</comment>
  <info>string</info>  <strong>$pngname</strong>      Chemin vers le fichier PNG.
  <info>string</info>  <strong>$wbmpname</strong>     Chemin vers le fichier final WBMP.
  <info>int</info>     <strong>$dest_height</strong>  Hauteur de l'image de destination.
  <info>int</info>     <strong>$dest_width</strong>   Largeur de l'image de destination.
  <info>int</info>     <strong>$threshold</strong>    Valeur du seuil, entre 0 et 8 inclus.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>jpeg2wbmp()</strong>


id: popen
type: function
doc:
<comment>Description:</comment>
  Crée un processus de pointeur de fichier
  
  Crée un processus de pointeur de fichier, exécuté en effectuant un fork de la commande fournie par
  le paramètre <strong>$command</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$command</strong>  La commande
  <info>string</info>  <strong>$mode</strong>     Le mode. Soit <return>'r'</return> pour lecture, soit <return>'w'</return> pour l'écriture.
                    
                    Sur Windows, <strong>popen()</strong> utilise le mode texte par défaut, c.à.d. tout caractères <return>\n</return>
                    écrit ou lu du pipe sera traduit en <return>\r\n</return>. Si ceci n'est pas désiré, le mode
                    binaire peut être enforcé en définissant le <strong>$mode</strong> à <return>'rb'</return> et <return>'wb'</return>,
                    respectivement.

<comment>Return:</comment>
  <info>resource|false</info>  Retourne un pointeur de fichier identique à celui retourné par <strong>fopen()</strong>, hormis le
                  fait qu'il sera unidirectionnel (lecture seule, ou écriture seule), et doit être
                  terminé par <strong>pclose()</strong>. Ce pointeur peut être utilisé avec <strong>fgets()</strong>, <strong>fgetss()</strong> et
                  <strong>fwrite()</strong>. Lorsque le mode est 'r', le pointeur de fichier retourné équivaut au
                  STDOUT de la commande, et lorsque le mode est 'w', le pointeur de fichier retourné
                  équivaut au STDIN de la commande.
                  
                  Si une erreur survient, la fonction retournera <info>false</info>.

<comment>See Also:</comment>
   * <strong>pclose()</strong>
   * <strong>fopen()</strong>
   * <strong>proc_open()</strong>


id: pos
type: function
doc:
<comment>Description:</comment>
  Alias de current
  
  Cette fonction est un alias de :  <strong>current()</strong>


id: posix_access
type: function
doc:
<comment>Description:</comment>
  Détermine l'accessibilité d'un fichier
    
  
  <strong>posix_access()</strong> vérifie les permissions utilisateurs pour un fichier.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Le nom du fichier à tester.
  <info>int</info>     <strong>$flags</strong>     Un masque constitué d'une ou plusieurs constantes parmi <info>POSIX_F_OK</info>, <info>POSIX_R_OK</info>,
                     <info>POSIX_W_OK</info> et <info>POSIX_X_OK</info>.
                     
                     <info>POSIX_R_OK</info>, <info>POSIX_W_OK</info> et <info>POSIX_X_OK</info> vérifie si, respectivement, le fichier
                     existe et a les permissions en lecture, écriture et exécution. <info>POSIX_F_OK</info>
                     vérifie uniquement si le fichier existe.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_get_last_error()</strong>
   * <strong>posix_strerror()</strong>


id: posix_ctermid
type: function
doc:
<comment>Description:</comment>
  Retourne le chemin du terminal
  
  Génère une chaîne de caractères qui représente le nom du chemin du terminal courant du processus.
  En cas d'erreur, cette fonction définira l'errno, qui pourra être récupéré en utilisant la
  fonction <strong>posix_get_last_error()</strong>

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères représentant le nom du chemin du terminal courant
                en cas de succès. Sinon, <info>false</info> est retourné et errno est défini, qui pourra être
                récupérer en utilisant la fonction <strong>posix_get_last_error()</strong>.

<comment>See Also:</comment>
   * <strong>posix_ttyname()</strong>
   * <strong>posix_get_last_error()</strong>


id: posix_eaccess
type: function
doc:
<comment>Description:</comment>
  Determine accessibility of a file
    
  
  <strong>posix_eaccess()</strong> checks the effective user's permission of a file

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  The name of a file to be tested.
  <info>int</info>     <strong>$flags</strong>     A mask consisting of one or more of <info>POSIX_F_OK</info>, <info>POSIX_R_OK</info>, <info>POSIX_W_OK</info> and
                     <info>POSIX_X_OK</info>.
                     
                     <info>POSIX_R_OK</info>, <info>POSIX_W_OK</info> and <info>POSIX_X_OK</info> request checking whether the file exists
                     and has read, write and execute permissions, respectively. <info>POSIX_F_OK</info> just
                     requests checking for the existence of the file.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_get_last_error()</strong>
   * <strong>posix_strerror()</strong>
   * <strong>posix_access()</strong>


id: posix_errno
type: function
doc:
<comment>Description:</comment>
  Alias de posix_get_last_error
  
  Cette fonction est un alias de :  <strong>posix_get_last_error()</strong>.


id: posix_fpathconf
type: function
doc:
<comment>Description:</comment>
  Returns the value of a configurable limit
  
  Returns the value of a configurable limit from <strong>$name</strong> for a file descriptor <strong>$resource</strong>

<comment>Param:</comment>
  <info>resource|int</info>  <strong>$file_descriptor</strong>  Le descripteur de fichier, qui doit être soit une ressource de
                                  fichier, soit un entier. Un entier est supposé être un descripteur
                                  de fichier qui peut être passé directement à l'appel système
                                  sous-jacent.
  <info>int</info>           <strong>$name</strong>             The name of the configurable limit, one of the following.
                                  <info>POSIX_PC_LINK_MAX</info>, <info>POSIX_PC_MAX_CANON</info> <info>POSIX_PC_MAX_INPUT</info>,
                                  <info>POSIX_PC_NAME_MAX</info> <info>POSIX_PC_PATH_MAX</info>, <info>POSIX_PC_PIPE_BUF</info>
                                  <info>POSIX_PC_CHOWN_RESTRICTED</info>, <info>POSIX_PC_NO_TRUNC</info>
                                  <info>POSIX_PC_ALLOC_SIZE_MIN</info>, <info>POSIX_PC_SYMLINK_MAX</info>

<comment>Return:</comment>
  <info>int|false</info>  Returns the configurable limit or <info>false</info>.

<comment>See Also:</comment>
   * <strong>posix_pathconf()</strong>


id: posix_get_last_error
type: function
doc:
<comment>Description:</comment>
  Lit le dernier numéro d'erreur généré par la dernière fonction POSIX qui a échoué
  
  Retourne le numéro d'erreur retourné par la dernière fonction POSIX qui a échoué. Si vous le
  message d'erreur associé au numéro d'erreur, utilisez <strong>posix_strerror()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne le numéro de la dernière erreur survenue lors d'un appel à une fonction POSIX. Si
       aucune erreur n'existe, <return>0</return> sera retourné.

<comment>See Also:</comment>
   * <strong>posix_strerror()</strong>


id: posix_getcwd
type: function
doc:
<comment>Description:</comment>
  Chemin du dossier de travail courant
  
  Retourne le chemin absolu du dossier de travail courant. En cas d'erreur, la fonction définira
  l'errno, qui pourra être récupéré en utilisant la fonction <strong>posix_get_last_error()</strong>

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères représentant le nom du chemin absolu en cas de
                succès. Si une erreur survient, retourne <info>false</info> et définit l'errno qui pourra être
                récupéré en utilisant la fonction <strong>posix_get_last_error()</strong>.


id: posix_getegid
type: function
doc:
<comment>Description:</comment>
  Retourne l'ID effectif du groupe du processus courant
  
  Retourne l'ID effectif du groupe du processus courant.

<comment>Return:</comment>
  <info>int</info>  Retourne un entier représentant l'ID effectif du groupe.

<comment>See Also:</comment>
   * <strong>posix_getgrgid()</strong>
   * <strong>posix_getgid()</strong>
   * <strong>posix_setgid()</strong>


id: posix_geteuid
type: function
doc:
<comment>Description:</comment>
  Retourne l'UID effectif de l'utilisateur du processus courant
  
  Retourne l'UID effectif de l'utilisateur du processus courant. Reportez-vous à <strong>posix_getpwuid()</strong>
  pour obtenir le nom d'utilisateur.

<comment>Return:</comment>
  <info>int</info>  Retourne l'ID de l'utilisateur, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>posix_getpwuid()</strong>
   * <strong>posix_getuid()</strong>
   * <strong>posix_setuid()</strong>
   * POSIX man page GETEUID(2)


id: posix_getgid
type: function
doc:
<comment>Description:</comment>
  Retourne l'UID du groupe du processus courant
  
  Retourne l'ID réel du groupe du processus courant.

<comment>Return:</comment>
  <info>int</info>  Retourne l'ID réel du groupe, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>posix_getgrgid()</strong>
   * <strong>posix_getegid()</strong>
   * <strong>posix_setgid()</strong>
   * POSIX man page GETGID(2)


id: posix_getgrgid
type: function
doc:
<comment>Description:</comment>
  Retourne des informations sur un groupe
  
  Retourne des informations sur un groupe.

<comment>Param:</comment>
  <info>int</info>  <strong>$group_id</strong>  L'identifiant du groupe.

<comment>Return:</comment>
  <info>array|false</info>  Les éléments du tableau retourné sont : Les informations du
               groupeÉlémentDescriptionname Cet élément contient le nom du groupe. C'est un nom
               abrégé, habituellement, moins de 16 caractères, représentant le nom du groupe et non
               le nom du groupe complet. passwd Cet élément contient le mot de passe du groupe,
               crypté. Par exemple, sous les systèmes employant les mots de passe "shadow", un
               astérisque est retourné. gid ID du groupe, doit être le même que le paramètre
               <strong>$group_id</strong> utilisé lors de l'appel à la fonction. members C'est un tableau de chaînes
               de caractères représentant tous les membres du groupe.  The function returns <info>false</info> on
               failure.

<comment>See Also:</comment>
   * <strong>posix_getegid()</strong>
   * <strong>posix_getgrnam()</strong>
   * <strong>filegroup()</strong>
   * <strong>stat()</strong>
   * POSIX man page GETGRNAM(3)


id: posix_getgrnam
type: function
doc:
<comment>Description:</comment>
  Retourne des informations sur un groupe
  
  Récupère les informations d'un groupe donné.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>  Le nom du groupe

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau en cas de succès,  ou <info>false</info> si une erreur survient. Les éléments
               du tableau retourné sont : Les informations du groupeÉlémentDescriptionname Cet
               élément contient le nom du groupe. C'est un nom abrégé, habituellement, contenant
               moins de 16 caractères. C'est le même que le paramètre <strong>$name</strong> utilisé lors de l'appel
               à la fonction. passwd Cet élément contient le mot de passe du groupe, crypté. Par
               exemple, sous un système utilisant les mots de passes "shadow", un astérisque est
               retourné. gid L'ID du groupe, sous un format numérique. members C'est un tableau de
               chaînes de caractères pour tous les membres du groupe.

<comment>See Also:</comment>
   * <strong>posix_getegid()</strong>
   * <strong>posix_getgrgid()</strong>
   * <strong>filegroup()</strong>
   * <strong>stat()</strong>
   * POSIX man page GETGRNAM(3)


id: posix_getgroups
type: function
doc:
<comment>Description:</comment>
  Retourne les identifiants du groupe du processus courant
  
  Retourne les identifiants du groupe du processus courant.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau contenant les identifiants du groupe du processus courant,  ou
               <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_getgrgid()</strong>


id: posix_getlogin
type: function
doc:
<comment>Description:</comment>
  Retourne le login
  
  Retourne le login de l'utilisateur qui possède le processus courant.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le login de l'utilisateur, sous la forme d'une chaîne de caractères,  ou
                <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_getpwnam()</strong>
   * POSIX man page GETLOGIN(3)


id: posix_getpgid
type: function
doc:
<comment>Description:</comment>
  Retourne l'id du groupe de processus
  
  Retourne l'id du groupe de processus pour le processus <strong>$process_id</strong> ou <info>false</info> si une erreur
  survient.

<comment>Param:</comment>
  <info>int</info>  <strong>$process_id</strong>  L'identifiant du processus.

<comment>Return:</comment>
  <info>int|false</info>  Retourne l'identifiant, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>posix_getppid()</strong>
   * man page SETPGID(2)


id: posix_getpgrp
type: function
doc:
<comment>Description:</comment>
  Retourne l'identifiant du groupe de processus
  
  Retourne l'identifiant du groupe de processus du processus courant.

<comment>Return:</comment>
  <info>int</info>  Retourne l'identifiant, sous la forme d'un entier.

<comment>See Also:</comment>
   * Reportez-vous à POSIX.1 et
     à getpgrp(2) dans le manuel de votre système POSIX pour
     plus d'informations sur les groupes de processus.


id: posix_getpid
type: function
doc:
<comment>Description:</comment>
  Retourne l'identifiant du processus courant
  
  Retourne l'identifiant du processus courant.

<comment>Return:</comment>
  <info>int</info>  Retourne l'identifiant, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>posix_kill()</strong>
   * POSIX man page GETPID(2)


id: posix_getppid
type: function
doc:
<comment>Description:</comment>
  Retourne l'identifiant du processus parent
  
  Retourne l'identifiant du processus parent du processus courant.

<comment>Return:</comment>
  <info>int</info>  Retourne l'identifiant, sous la forme d'un entier.


id: posix_getpwnam
type: function
doc:
<comment>Description:</comment>
  Retourne des informations sur un utilisateur
  
  Retourne un tableau d'informations sur un utilisateur.

<comment>Param:</comment>
  <info>string</info>  <strong>$username</strong>  Un nom alphanumérique d'utilisateur.

<comment>Return:</comment>
  <info>array|false</info>  En cas de succès, un tableau avec les éléments suivants est retourné, sinon, <info>false</info> :
               Le tableau descriptif d'un utilisateurÉlémentDescriptionname Le nom contient le nom
               de l'utilisateur. Généralement, c'est un nom court, de moins de 16 caractères, mais
               ce n'est pas son nom réel et complet. Cette valeur devrait correspondre au paramètre
               <strong>$username</strong> et, donc, il est redondant. passwd Contient le mot de passe de
               l'utilisateur, chiffré. Souvent, dans les systèmes utilisant les mots de passe
               "fantômes", un astérisque est retourné. uid L'UID de l'utilisateur. gid L'ID du
               groupe de l'utilisateur. Utilisez la fonction <strong>posix_getgrgid()</strong> pour connaître le nom
               du groupe, et ses membres. gecos GECOS est un terme obsolète qui fait référence aux
               données de finger, sur un système Honeywell. Le champ, cependant, a survécu, et son
               contenu a été formalisé par POSIX. Le champ contient une liste, séparée par des
               virgules, qui contient le nom complet de l'utilisateur, son téléphone professionnel,
               son numéro de téléphone bureau et son numéro de téléphone personnel. Sur la plupart
               des systèmes, seul le nom est disponible. dir Cet élément contient le chemin absolu
               jusqu'au dossier racine de l'utilisateur. shell Cet élément contient le chemin absolu
               jusqu'au dossier d'exécution du shell de l'utilisateur.

<comment>See Also:</comment>
   * <strong>posix_getpwuid()</strong>
   * POSIX man page GETPWNAM(3)


id: posix_getpwuid
type: function
doc:
<comment>Description:</comment>
  Retourne des informations sur un utilisateur
  
  Retourne un tableau d'informations sur un utilisateur référencé par son ID.

<comment>Param:</comment>
  <info>int</info>  <strong>$user_id</strong>  L'identifiant de l'utilisateur.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau associatif contenant les éléments suivants : Le tableau de
               description d'un utilisateurÉlémentDescriptionname Le nom contient le nom de
               l'utilisateur. Généralement, c'est un nom court, de moins de 16 caractères, mais ce
               n'est pas son nom réel et complet. passwd Contient le mot de passe de l'utilisateur,
               chiffré. Souvent, dans les systèmes utilisant les mots de passe "fantômes", un
               astérisque est retourné. uid Cette valeur devrait correspondre au paramètre <strong>$user_id</strong>
               et, donc, il est redondant. gid L'ID du groupe de l'utilisateur. Utilisez la fonction
               <strong>posix_getgrgid()</strong> pour connaître le nom du groupe, et ses membres. gecos GECOS est un
               terme obsolète qui fait référence aux données de <return>finger</return>, sur un système Honeywell. Le
               champ, cependant, a survécu et son contenu a été formalisé par POSIX. Le champ
               contient une liste, séparée par des virgules, qui contient le nom complet de
               l'utilisateur, son téléphone professionnel, son numéro de bureau et son numéro de
               téléphone personnel. Sur la plupart des systèmes, seul le nom est disponible. dir Cet
               élément contient le chemin absolu jusqu'au dossier racine de l'utilisateur. shell Cet
               élément contient le chemin absolu jusqu'au dossier d'exécution du shell de
               l'utilisateur.  The function returns <info>false</info> on failure.

<comment>See Also:</comment>
   * <strong>posix_getpwnam()</strong>
   * POSIX man page GETPWNAM(3)


id: posix_getrlimit
type: function
doc:
<comment>Description:</comment>
  Retourne des informations concernant les limites des ressources système
  
  <strong>posix_getrlimit()</strong> retourne un tableau d'informations concernant les limites soft et hard de la
  ressource courante.
  
  Chaque ressource a une limite soft et hard d'associées. La limite
  soft correspond à la valeur que le noyau force pour la ressource
  correspondante. La limite hard agit comme un plafond de la limite soft.
  Un processus non privilégié ne peut que définir sa limite soft en une
  valeur comprise entre 0 et la limite hard, ce qui ne fera qu'abaisser
  sa limite hard.

<comment>Param:</comment>
  <info>int|null</info>  <strong>$resource</strong>  Si <info>null</info> toutes les limites des ressources seront récupérées. Sinon, seules
                       les limites du type de ressource fourni seront renvoyées.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau associatif d'éléments pour chaque limite définie. Chaque limite a
               une limite soft et hard. Liste des limites possibles retournéesNom de la
               limiteDescription de la limitecore La taille maximale du cœur du fichier. Lorsqu'elle
               vaut 0, aucun cœur de fichier n'est créé. Lorsque le cœur des fichiers est plus grand
               que sa taille, il sera tronqué à cette taille. totalmem La taille maximale de la
               mémoire du processus, en octets. virtualmem La taille maximale de la mémoire
               virtuelle du processus, en octets. data La taille maximale du segment de données pour
               le processus, en octets. stack La taille maximale de la pile du processus, en octets.
               rss Le nombre maximal de pages virtuelles résident en RAM. maxproc Le nombre maximal
               de processus qui peuvent être créés pour l'ID utilisateur réel du processus appelé.
               memlock Le nombre maximal d'octets de mémoires pouvant être verrouillés en RAM. cpu
               Le temps que le processus est autorisé à utiliser le CPU. filesize La taille maximale
               du segments de données pour le processus, en octets. openfiles le nombre maximal de
               pointeurs de fichiers ouverts.  The function returns <info>false</info> on failure.

<comment>See Also:</comment>
   * man page GETRLIMIT(2)
   * <strong>posix_setrlimit()</strong>


id: posix_getsid
type: function
doc:
<comment>Description:</comment>
  Retourne le sid du processus
  
  Retourne l'ID de session du processus <strong>$process_id</strong>. L'ID de session d'un processus est l'ID du
  groupe du processus du gestionnaire de session.

<comment>Param:</comment>
  <info>int</info>  <strong>$process_id</strong>  L'identifiant du processus. S'il est défini à 0, le processus courant est
                    utilisé. Si un <strong>$process_id</strong> invalide est fourni, alors <info>false</info> est retourné et une
                    erreur est définie et pourra être récupérée avec la fonction
                    <strong>posix_get_last_error()</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Retourne l'identifiant, sous la forme d'un entier,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_getpgid()</strong>
   * <strong>posix_setsid()</strong>
   * POSIX man page GETSID(2)


id: posix_getuid
type: function
doc:
<comment>Description:</comment>
  Retourne l'ID de l'utilisateur du processus courant
  
  Retourne l'ID de l'utilisateur du processus courant.

<comment>Return:</comment>
  <info>int</info>  Retourne l'identifiant, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>posix_getpwuid()</strong>
   * POSIX man page GETUID(2)


id: posix_initgroups
type: function
doc:
<comment>Description:</comment>
  Calcule la liste des accès de groupe
  
  Calcule la liste des accès de groupe pour l'utilisateur spécifié par son nom.

<comment>Param:</comment>
  <info>string</info>  <strong>$username</strong>  L'utilisateur pour lequel on doit calculer la liste.
  <info>int</info>     <strong>$group_id</strong>  Typiquement, le numéro du groupe depuis le fichier de mot de passe.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * La page du manuel Unix d'initgroups(3).


id: posix_isatty
type: function
doc:
<comment>Description:</comment>
  Détermine si un pointeur de fichier est un terminal interactif
  
  Détermine si le pointeur de fichier <strong>$file_descriptor</strong> se réfère à un type de terminal de
  périphérique valide.

<comment>Param:</comment>
  <info>resource|int</info>  <strong>$file_descriptor</strong>  Le descripteur de fichier, qui doit être soit une ressource de
                                  fichier, soit un entier. Un entier est supposé être un descripteur
                                  de fichier qui peut être passé directement à l'appel système
                                  sous-jacent.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$file_descriptor</strong> est un pointeur de fichier connecté à un terminal, <info>false</info>
        sinon.

<comment>See Also:</comment>
   * <strong>posix_ttyname()</strong>
   * <strong>stream_isatty()</strong>


id: posix_kill
type: function
doc:
<comment>Description:</comment>
  Envoie un signal à un processus
  
  Envoie le signal <strong>$signal</strong> au processus <strong>$process_id</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$process_id</strong>  L'identifiant du processus.
  <info>int</info>  <strong>$signal</strong>      Une des constantes de signals PCNTL.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * 
     Reportez-vous à la page de manuel de kill(2) de votre
     système POSIX, qui contient plus de détails sur
     les identifiants négatifs de processus, les pid
     spéciaux 0 et -1, et le signal numéro 0.
    


id: posix_mkfifo
type: function
doc:
<comment>Description:</comment>
  Crée un fichier FIFO (first in, first out) (un pipe nommé)
  
  <strong>posix_mkfifo()</strong> crée un fichier spécial <return>FIFO</return> qui existe dans le système de fichiers, et sert de
  point de communication bidirectionnel pour les processus.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>     Chemin vers le fichier <return>FIFO</return>.
  <info>int</info>     <strong>$permissions</strong>  Le second paramètre <strong>$permissions</strong> doit être au format octal (i.e. 0644). Les
                        droits donnés à la nouvelle pile <return>FIFO</return> dépendent aussi de la configuration de
                        la fonction <strong>umask()</strong>. Les droits créées sont <return>(mode & ~umask)</return>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: posix_mknod
type: function
doc:
<comment>Description:</comment>
  Crée un fichier spécial ou ordinaire (POSIX.1)
    
  
  Crée un fichier spécial ou ordinaire.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Le fichier à créer.
  <info>int</info>     <strong>$flags</strong>     Ce paramètre est construit par une manipulation de bits ou par des types de
                     fichier (une des constantes suivantes : <info>POSIX_S_IFREG</info>, <info>POSIX_S_IFCHR</info>,
                     <info>POSIX_S_IFBLK</info>, <info>POSIX_S_IFIFO</info> ou <info>POSIX_S_IFSOCK</info>) et des permissions.
  <info>int</info>     <strong>$major</strong>     L'identifiant majeur du dispositif du noyau (requis lorsque vous utilisez
                     <info>S_IFCHR</info> ou <info>S_IFBLK</info>).
  <info>int</info>     <strong>$minor</strong>     L'identifiant mineur du dispositif du noyau.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_mkfifo()</strong>


id: posix_pathconf
type: function
doc:
<comment>Description:</comment>
  Returns the value of a configurable limit
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.
  
  Returns the value of a configurable limit from <strong>$name</strong> for a <strong>$file</strong>

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>  The name of the file whose limit you want to get.
  <info>int</info>     <strong>$name</strong>  The name of the configurable limit, one of the following. <info>POSIX_PC_LINK_MAX</info>,
                 <info>POSIX_PC_MAX_CANON</info> <info>POSIX_PC_MAX_INPUT</info>, <info>POSIX_PC_NAME_MAX</info> <info>POSIX_PC_PATH_MAX</info>,
                 <info>POSIX_PC_PIPE_BUF</info> <info>POSIX_PC_CHOWN_RESTRICTED</info>, <info>POSIX_PC_NO_TRUNC</info>
                 <info>POSIX_PC_ALLOC_SIZE_MIN</info>, <info>POSIX_PC_SYMLINK_MAX</info>

<comment>Return:</comment>
  <info>int|false</info>  Returns the configurable limit or <info>false</info>.

<comment>See Also:</comment>
   * <strong>posix_fpathconf()</strong>


id: posix_setegid
type: function
doc:
<comment>Description:</comment>
  Modifie le GID réel du processus courant
  
  Modifie l'identifiant de groupe réel du processus courant. C'est une fonction de haut niveau, et
  vous aurez besoin des droits appropriés (généralement ceux du super utilisateur), sur votre
  système, pour l'utiliser.

<comment>Param:</comment>
  <info>int</info>  <strong>$group_id</strong>  L'ID du groupe.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_getgrgid()</strong>
   * <strong>posix_getgid()</strong>
   * <strong>posix_setgid()</strong>


id: posix_seteuid
type: function
doc:
<comment>Description:</comment>
  Modifie l'identifiant d'utilisateur réel (UID) du processus courant
  
  Définit l'identifiant du véritable utilisateur du processus courant. C'est une fonction de haut
  niveau, et vous aurez besoin des droits appropriés (généralement ceux du super utilisateur), sur
  votre système, pour l'utiliser.

<comment>Param:</comment>
  <info>int</info>  <strong>$user_id</strong>  L'ID de l'utilisateur.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_geteuid()</strong>
   * <strong>posix_setuid()</strong>
   * <strong>posix_getuid()</strong>


id: posix_setgid
type: function
doc:
<comment>Description:</comment>
  Fixe le GID effectif du processus courant
  
  Fixe le GID effectif du processus courant. C'est une fonction privilégiée et vous devez avoir les
  privilèges appropriés (habituellement root) sur le système pour pouvoir l'exécuter. L'ordre
  approprié est d'abord <strong>posix_setgid()</strong>, puis <strong>posix_setuid()</strong>.
  
  Si l'appelant est le super-utilisateur, cette fonction définira également l'ID effectif du groupe.

<comment>Param:</comment>
  <info>int</info>  <strong>$group_id</strong>  L'ID du groupe.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_getgrgid()</strong>
   * <strong>posix_getgid()</strong>


id: posix_setpgid
type: function
doc:
<comment>Description:</comment>
  Fixe l'identifiant de groupe de processus
  
  Ajoute le processus <strong>$process_id</strong> au groupe d'id <strong>$process_group_id</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$process_id</strong>        L'ID du processus.
  <info>int</info>  <strong>$process_group_id</strong>  L'ID du groupe du processus.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * 
     Reportez-vous à POSIX.1 et setsid(2) dans le manuel de votre
     système POSIX pour plus d'informations sur le contrôle
     de tâche.
    


id: posix_setrlimit
type: function
doc:
<comment>Description:</comment>
  Définit les limites pour une ressource système
  
  <strong>posix_setrlimit()</strong> définit les limites douces et dure pour un ressource système donné.
  
  Chaque ressource a une limite soft et hard d'associées. La limite
  soft correspond à la valeur que le noyau force pour la ressource
  correspondante. La limite hard agit comme un plafond de la limite soft.
  Un processus non privilégié ne peut que définir sa limite soft en une
  valeur comprise entre 0 et la limite hard, ce qui ne fera qu'abaisser
  sa limite hard.

<comment>Param:</comment>
  <info>int</info>  <strong>$resource</strong>    La constante de limite de ressource correspondant à la limite qui sera définit.
  <info>int</info>  <strong>$soft_limit</strong>  La limite douce, dans n'importe quelle unité la limite de ressource nécessite,
                    ou <info>POSIX_RLIMIT_INFINITY</info>.
  <info>int</info>  <strong>$hard_limit</strong>  La limite dure, dans n'importe quelle unité la limite de ressource nécessite, ou
                    <info>POSIX_RLIMIT_INFINITY</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * man page SETRLIMIT(2)
   * <strong>posix_getrlimit()</strong>


id: posix_setsid
type: function
doc:
<comment>Description:</comment>
  Fait du processus courant un chef de session
  
  Fait du processus courant un chef de session.

<comment>Return:</comment>
  <info>int</info>  Retourne l'identifiant de session, ou -1 si une erreur survient.

<comment>See Also:</comment>
   * 
     Reportez-vous à POSIX.1 et setsid(2) dans le manuel de
     votre système POSIX pour plus d'informations sur le contrôle
     de tâche.
    


id: posix_setuid
type: function
doc:
<comment>Description:</comment>
  Fixe l'UID effective du processus courant
  
  Fixe l'UID effective de l'utilisateur du processus courant. Vous devez avoir les privilèges
  nécessaires (traditionnellement ceux du root) sur votre système pour le faire.

<comment>Param:</comment>
  <info>int</info>  <strong>$user_id</strong>  L'ID de l'utilisateur.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>posix_setgid()</strong>
   * <strong>posix_seteuid()</strong>
   * <strong>posix_getuid()</strong>
   * <strong>posix_geteuid()</strong>


id: posix_strerror
type: function
doc:
<comment>Description:</comment>
  Lit le message d'erreur associé à un numéro d'erreur POSIX
  
  Retourne le message d'erreur POSIX associé au numéro d'erreur <strong>$error_code</strong>. Vous pouvez récupérer
  le paramètre <strong>$error_code</strong> en appelant la fonction <strong>posix_get_last_error()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$error_code</strong>  Un numéro d'erreur POSIX, retourné par la fonction <strong>posix_get_last_error()</strong>. Si
                    défini à <return>0</return>, alors, la chaîne de caractères <return>"Success"</return> est retournée.

<comment>Return:</comment>
  <info>string</info>  Retourne le message d'erreur, sous la forme d'une chaîne de caractères.

<comment>See Also:</comment>
   * <strong>posix_get_last_error()</strong>


id: posix_sysconf
type: function
doc:
<comment>Description:</comment>
  Returns system runtime information
  
  Returns system runtime information.

<comment>Param:</comment>
  <info>int</info>  <strong>$conf_id</strong>  Identifier of the variable with the following constants <info>POSIX_SC_ARG_MAX</info>,
                 <info>POSIX_SC_PAGESIZE</info> <info>POSIX_SC_NPROCESSORS_CONF</info>, <info>POSIX_SC_NPROCESSORS_ONLN</info>

<comment>Return:</comment>
  <info>int</info>  Returns the numeric value related to <strong>$conf_id</strong>


id: posix_times
type: function
doc:
<comment>Description:</comment>
  Utilisation des ressources
  
  Retourne des informations sur l'utilisation courante du CPU.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau avec les informations sur l'utilisation du CPU. Les indices sont
               :  ticks - nombre de ticks depuis le dernier démarrage.  utime - temps utilisateur
               utilisé par le processus courant.  stime - temps système utilisé par le processus
               courant.  cutime - temps utilisateur utilisé par le processus courant et ses enfants.
               cstime - temps système utilisé par le processus courant et ses enfants.  The function
               returns <info>false</info> on failure.
               
               ticks - nombre de ticks depuis le dernier démarrage.
               
               utime - temps utilisateur utilisé par le processus courant.
               
               stime - temps système utilisé par le processus courant.
               
               cutime - temps utilisateur utilisé par le processus courant et ses enfants.
               
               cstime - temps système utilisé par le processus courant et ses enfants.


id: posix_ttyname
type: function
doc:
<comment>Description:</comment>
  Retourne le nom de device du terminal
  
  Retourne une chaîne de caractères pour le chemin absolu du terminal courant qui est ouvert sur le
  pointeur de fichier. <strong>$file_descriptor</strong>.

<comment>Param:</comment>
  <info>resource|int</info>  <strong>$file_descriptor</strong>  Le descripteur de fichier, qui doit être soit une ressource de
                                  fichier, soit un entier. Un entier est supposé être un descripteur
                                  de fichier qui peut être passé directement à l'appel système
                                  sous-jacent.

<comment>Return:</comment>
  <info>string|false</info>  En cas de succès, retourne une chaîne de caractères correspondant au chemin absolu
                de <strong>$file_descriptor</strong>. En cas d'erreur, retourne <info>false</info>.

<comment>See Also:</comment>
   * <strong>posix_isatty()</strong>
   * <strong>stream_isatty()</strong>


id: posix_uname
type: function
doc:
<comment>Description:</comment>
  Retourne le nom du système
  
  Retourne des informations sur le système.
  
  Posix impose que vous n'ayez pas d'à priori sur le format des chaînes, c'est-à-dire que vous ne
  devez pas vous attendre à avoir forcément trois chiffres pour la version, par exemple.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau associatif avec des informations sur le système. Les indices du
               tableau sont :  sysname : nom du système d'exploitation (exemple : Linux)  nodename :
               nom du système (i.e. <return>valiant</return>)  release : édition du système d'exploitation (i.e.
               <return>2.2.10</return>)  version : version du système d'exploitation (e.e. <return>#4 Tue Jul 20 17:01:36
               MEST 1999</return>)  machine : architecture système (i.e. <return>i586</return>)  domainname : Nom de domaine
               (i.e. <return>example.com</return>)
               
               sysname : nom du système d'exploitation (exemple : Linux)
               
               nodename : nom du système (i.e. <return>valiant</return>)
               
               release : édition du système d'exploitation (i.e. <return>2.2.10</return>)
               
               version : version du système d'exploitation (e.e. <return>#4 Tue Jul 20 17:01:36 MEST 1999</return>)
               
               machine : architecture système (i.e. <return>i586</return>)
               
               domainname : Nom de domaine (i.e. <return>example.com</return>)
               
               domainname est une extension GNU et ne fait pas partie de POSIX.1, ce champ n'est
               donc accessible que sur les systèmes GNU ou lors de l'utilisation de la GNU libc.
               
               The function returns <info>false</info> on failure.


id: pow
type: function
doc:
<comment>Description:</comment>
  Expression exponentielle
  
  Retourne <strong>$num</strong> élevé à la puissance <strong>$exponent</strong>.
  
  Il est possible d'utiliser l'opérateur ** à la place.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$num</strong>       La base à utiliser
  <info>mixed</info>  <strong>$exponent</strong>  L'exposent

<comment>Return:</comment>
  <info>int|float|object</info>  <strong>$num</strong> élevé à la puissance <strong>$exponent</strong>. Si les arguments ne sont pas des entiers
                    négatifs, et que le résultat peut être représenté sous la forme d'un entier, le
                    résultat sera entier, sinon s'il sera retourné en tant que nombre décimal.

<comment>See Also:</comment>
   * <strong>exp()</strong>
   * <strong>sqrt()</strong>
   * <strong>bcpow()</strong>
   * <strong>gmp_pow()</strong>


id: preg_filter
type: function
doc:
<comment>Description:</comment>
  Recherche et remplace avec une expression rationnelle
  
  <strong>preg_filter()</strong> est identique à  <strong>preg_replace()</strong>, mais elle ne fait que retourner les occurrences
  trouvées (éventuellement transformées). Pour plus de détails sur le fonctionnement de cette
  fonction, voyez <strong>preg_replace()</strong>.

<comment>Return:</comment>
  <info>string|array|null</info>  Retourne un tableau si le paramètre <strong>$subject</strong> est de type tableau ou une chaîne
                     de caractères autrement.
                     
                     Si aucune occurrence n'est trouvée ou si une erreur survient, un tableau vide
                     sera retourné lorsque le paramètre <strong>$subject</strong> est un tableau ou <info>null</info> sinon.

<comment>See Also:</comment>
   * Les Patterns PCRE
   * <strong>preg_quote()</strong>
   * <strong>preg_replace()</strong>
   * <strong>preg_replace_callback()</strong>
   * <strong>preg_grep()</strong>
   * <strong>preg_last_error()</strong>


id: preg_grep
type: function
doc:
<comment>Description:</comment>
  Retourne un tableau avec les résultats de la recherche
  
  <strong>preg_grep()</strong> retourne un tableau qui contient les éléments de <strong>$array</strong> qui satisfont le masque
  <strong>$pattern</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$pattern</strong>  Le motif à chercher, sous la forme d'une chaîne de caractères.
  <info>array</info>   <strong>$array</strong>    Le tableau d'entrée.
  <info>int</info>     <strong>$flags</strong>    Si cette option vaut <info>PREG_GREP_INVERT</info>, cette fonction retourne les éléments du
                    tableau <strong>$input</strong> qui ne correspondent  pas au motif <strong>$pattern</strong>.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau indexé, en utilisant les clés du tableau <strong>$array</strong> d'entrée,  ou
               <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * Les Patterns PCRE
   * <strong>preg_quote()</strong>
   * <strong>preg_match_all()</strong>
   * <strong>preg_filter()</strong>
   * <strong>preg_last_error()</strong>


id: preg_last_error
type: function
doc:
<comment>Description:</comment>
  Retourne le code erreur de la dernière expression PCRE exécutée
  
  Retourne le code erreur de la dernière regex PCRE exécutée.
  
  Exemple avec <strong>preg_last_error()</strong>
  ]]>L'exemple ci-dessus va afficher :
  
  L'exemple ci-dessus va afficher :

<comment>Return:</comment>
  <info>int</info>  Retourne une des constantes suivantes (expliquées sur cette page):
       <info>PREG_NO_ERROR</info><info>PREG_INTERNAL_ERROR</info><info>PREG_BACKTRACK_LIMIT_ERROR</info> (voir aussi
       pcre.backtrack_limit)<info>PREG_RECURSION_LIMIT_ERROR</info> (voir aussi
       pcre.recursion_limit)<info>PREG_BAD_UTF8_ERROR</info><info>PREG_BAD_UTF8_OFFSET_ERROR</info><info>PREG_JIT_STACKLIMIT_ERROR</info>

<comment>See Also:</comment>
   * <strong>preg_last_error_msg()</strong>


id: preg_last_error_msg
type: function
doc:
<comment>Description:</comment>
  Returns the error message of the last PCRE regex execution
  
  Returns the error message of the last PCRE regex execution.

<comment>Return:</comment>
  <info>string</info>  Returns the error message on success, or <return>"No error"</return> if no error has occurred.

<comment>See Also:</comment>
   * <strong>preg_last_error()</strong>


id: preg_match
type: function
doc:
<comment>Description:</comment>
  Effectue une recherche de correspondance avec une expression rationnelle standard
  
  Analyse <strong>$subject</strong> pour trouver l'expression qui correspond à <strong>$pattern</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$pattern</strong>  Le masque à chercher, sous la forme d'une chaîne de caractères.
  <info>string</info>  <strong>$subject</strong>  La chaîne d'entrée.
  <info>array</info>   <strong>$matches</strong>  Si <strong>$matches</strong> est fourni, il sera rempli par les résultats de la recherche.
                    $matches[0] contiendra le texte qui satisfait le masque complet, $matches[1]
                    contiendra le texte qui satisfait la première parenthèse capturante, etc.
  <info>int</info>     <strong>$flags</strong>    Le paramètre <strong>$flags</strong> peut être une combinaison des drapeaux suivants :
                    <info>PREG_OFFSET_CAPTURE</info> Si cette option est activée, toutes les sous-chaînes qui
                    satisfont le masque seront aussi identifiées par leur offset (en octets). Notez
                    que cela modifie la valeur de <strong>$matches</strong> qui devient un tableau dont chaque
                    élément est un tableau contenant la chaîne correspondant au masque à l'offset <return>0</return>
                    ainsi que l'offset de la chaîne dans <strong>$subject</strong> à l'offset <return>1</return>.
                    ]]>L'exemple ci-dessus va afficher : Array ( [0] => foobarbaz [1] => 0 )
                     [1] => Array ( [0] => foo [1] => 0 )
                     [2] => Array ( [0] => bar [1] => 3 )
                     [3] => Array ( [0] => baz [1] => 6 )
                    
                    )
                    ]]> <info>PREG_UNMATCHED_AS_NULL</info> Si ce drapeau est passé, les sous-masques non
                    satisfait sont rapportés en tant que <info>null</info> ; sinon ils sont rapportés en tant que
                    chaîne de caractères vide.
                    ]]>L'exemple ci-dessus va afficher : string(2) "ac" [1]=> string(1) "a" [2]=>
                    string(0) "" [3]=> string(1) "c"
                    }
                    array(4) { [0]=> string(2) "ac" [1]=> string(1) "a" [2]=> NULL [3]=> string(1)
                    "c"
                    }
                    ]]> 
                    
                    Si cette option est activée, toutes les sous-chaînes qui satisfont le masque
                    seront aussi identifiées par leur offset (en octets). Notez que cela modifie la
                    valeur de <strong>$matches</strong> qui devient un tableau dont chaque élément est un tableau
                    contenant la chaîne correspondant au masque à l'offset <return>0</return> ainsi que l'offset de
                    la chaîne dans <strong>$subject</strong> à l'offset <return>1</return>.
                    ]]>L'exemple ci-dessus va afficher : Array ( [0] => foobarbaz [1] => 0 )
                     [1] => Array ( [0] => foo [1] => 0 )
                     [2] => Array ( [0] => bar [1] => 3 )
                     [3] => Array ( [0] => baz [1] => 6 )
                    
                    )
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
                    
                    Si ce drapeau est passé, les sous-masques non satisfait sont rapportés en tant
                    que <info>null</info> ; sinon ils sont rapportés en tant que chaîne de caractères vide.
                    ]]>L'exemple ci-dessus va afficher : string(2) "ac" [1]=> string(1) "a" [2]=>
                    string(0) "" [3]=> string(1) "c"
                    }
                    array(4) { [0]=> string(2) "ac" [1]=> string(1) "a" [2]=> NULL [3]=> string(1)
                    "c"
                    }
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
  <info>array</info>   <strong>$matches</strong>  Si cette option est activée, toutes les sous-chaînes qui satisfont le masque
                    seront aussi identifiées par leur offset (en octets). Notez que cela modifie la
                    valeur de <strong>$matches</strong> qui devient un tableau dont chaque élément est un tableau
                    contenant la chaîne correspondant au masque à l'offset <return>0</return> ainsi que l'offset de
                    la chaîne dans <strong>$subject</strong> à l'offset <return>1</return>.
                    ]]>L'exemple ci-dessus va afficher : Array ( [0] => foobarbaz [1] => 0 )
                     [1] => Array ( [0] => foo [1] => 0 )
                     [2] => Array ( [0] => bar [1] => 3 )
                     [3] => Array ( [0] => baz [1] => 6 )
                    
                    )
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
  <info>int</info>     <strong>$offset</strong>   Normalement, la recherche commence au début de la chaîne  <strong>$subject</strong>. Le paramètre
                    optionnel <strong>$offset</strong> peut être utilisé pour spécifier une position pour le début de
                    la recherche (en octets).
                    
                    Utiliser le paramètre <strong>$offset</strong> ne revient pas à passer substr($subject, $offset)
                    à <strong>preg_match_all()</strong> à la place de la chaîne <strong>$subject</strong>, car <strong>$pattern</strong> peut contenir
                    des assertions comme ^, $ ou (?\<=x). Comparez :
                    ]]>L'exemple ci-dessus va afficher : avec cet exemple : 
                    ]]> produira :  Array ( [0] => def [1] => 0 )
                    
                    )
                    ]]> Sinon, pour éviter l'usage de <strong>substr()</strong>, utiliser  l'assertion <return>\G</return> plutôt que
                    l'ancre <return>^</return>, ou le modificateur <return>A</return>, tous les deux fonctionne avec le paramètre
                    <strong>$offset</strong>.
                    
                    L'exemple ci-dessus va afficher :
                    
                    avec cet exemple :
                    
                    produira :
                    
                    Sinon, pour éviter l'usage de <strong>substr()</strong>, utiliser  l'assertion <return>\G</return> plutôt que
                    l'ancre <return>^</return>, ou le modificateur <return>A</return>, tous les deux fonctionne avec le paramètre
                    <strong>$offset</strong>.

<comment>Return:</comment>
  <info>int|false</info>  <strong>preg_match()</strong> retourne 1 si le <strong>$pattern</strong> fourni correspond, 0 s'il ne correspond pas, ou
             <info>false</info> si une erreur survient.
             
             Cette fonction peut retourner <info>false</info>, mais elle peut aussi retourner une valeur
             équivalent à <info>false</info>. Veuillez lire la section sur les booléens pour plus d'informations.
             Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

<comment>See Also:</comment>
   * Masques PCRE
   * <strong>preg_quote()</strong>
   * <strong>preg_match_all()</strong>
   * <strong>preg_replace()</strong>
   * <strong>preg_split()</strong>
   * <strong>preg_last_error()</strong>
   * <strong>preg_last_error_msg()</strong>


id: preg_match_all
type: function
doc:
<comment>Description:</comment>
  Expression rationnelle globale
  
  Analyse <strong>$subject</strong> pour trouver l'expression <strong>$pattern</strong> et met les résultats dans <strong>$matches</strong>, dans
  l'ordre spécifié par <strong>$flags</strong>.
  
  Après avoir trouvé un premier résultat, la recherche continue jusqu'à la fin de la chaîne.

<comment>Param:</comment>
  <info>string</info>  <strong>$pattern</strong>  Le masque à chercher, sous la forme d'une chaîne de caractères.
  <info>string</info>  <strong>$subject</strong>  La chaîne d'entrée.
  <info>array</info>   <strong>$matches</strong>  Tableau contenant tous les résultats, dans un tableau multidimensionnel ordonné
                    suivant le paramètre <strong>$flags</strong>.
  <info>int</info>     <strong>$flags</strong>    Peut prendre une des deux valeurs suivantes (notez bien qu'il est incohérent
                    d'utiliser <info>PREG_PATTERN_ORDER</info> avec <info>PREG_SET_ORDER</info> ) : <info>PREG_PATTERN_ORDER</info> L'ordre
                    est tel que $matches[0] est un tableau qui contient les résultats qui satisfont
                    le masque complet, $matches[1] est un tableau qui contient les résultats qui
                    satisfont la première parenthèse capturante, etc.
                    ]]>L'exemple ci-dessus va afficher :exemple : , ceci est un test
                    exemple : , ceci est un test
                    ]]> Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le
                    masque complet, et $out[1] est un tableau qui contient les balises entre &gt; et
                    \<.  Si le masque contient des sous-masque nommés, $matches contiendra en plus des entrées qui auront pour clés les noms des sous-masques.  Si le masque contient des sous-masques nommés en double, seul le sous-masque le plus à droite sera enregistré dans $matches[NAME].
                    ]]>L'exemple ci-dessus va afficher :  [1] => bar
                    )
                    ]]> <info>PREG_SET_ORDER</info> Les résultats sont classés de telle façon que $matches[0]
                    contient la première série de résultats, $matches[1] contient la deuxième, etc.
                    ]]>L'exemple ci-dessus va afficher :exemple : , exemple :
                    ceci est un test, ceci est un test
                    ]]> <info>PREG_OFFSET_CAPTURE</info> Si ce drapeau est passé, toutes les sous-chaînes qui
                    satisfont le masque seront aussi identifiées par leur offset (en octets). Notez
                    que cela modifie la valeur de <strong>$matches</strong> en un tableau de tableau où chaque
                    élément est un tableau contenant  la sous-chaîne satisfaite à l'index <return>0</return> et
                    l'index de celle-ci dans la chaîne <strong>$subject</strong> à l'index <return>1</return>.
                    ]]>L'exemple ci-dessus va afficher : Array ( [0] => Array ( [0] => foobarbaz [1]
                    => 0 )
                     )
                     [1] => Array ( [0] => Array ( [0] => foo [1] => 0 )
                     )
                     [2] => Array ( [0] => Array ( [0] => bar [1] => 3 )
                     )
                     [3] => Array ( [0] => Array ( [0] => baz [1] => 6 )
                     )
                    
                    )
                    ]]> <info>PREG_UNMATCHED_AS_NULL</info> Si ce drapeau est passé, les sous-masques non
                    satisfait sont rapportés en tant que <info>null</info> ; sinon ils sont rapportés en tant que
                    chaîne de caractères vide.
                    
                    L'ordre est tel que $matches[0] est un tableau qui contient les résultats qui
                    satisfont le masque complet, $matches[1] est un tableau qui contient les
                    résultats qui satisfont la première parenthèse capturante, etc.
                    
                    
                    ]]>L'exemple ci-dessus va afficher :exemple : , ceci est un test
                    exemple : , ceci est un test
                    ]]> Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le
                    masque complet, et $out[1] est un tableau qui contient les balises entre &gt; et
                    \<.
                    
                    L'exemple ci-dessus va afficher :
                    
                    Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le masque
                    complet, et $out[1] est un tableau qui contient les balises entre &gt; et \<.
                    
                    Si le masque contient des sous-masque nommés, $matches contiendra en plus des
                    entrées qui auront pour clés les noms des sous-masques.
                    
                    Si le masque contient des sous-masques nommés en double, seul le sous-masque le
                    plus à droite sera enregistré dans $matches[NAME].
                    ]]>L'exemple ci-dessus va afficher :  [1] => bar
                    )
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
                    
                    Les résultats sont classés de telle façon que $matches[0] contient la première
                    série de résultats, $matches[1] contient la deuxième, etc.
                    ]]>L'exemple ci-dessus va afficher :exemple : , exemple :
                    ceci est un test, ceci est un test
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
                    
                    Si ce drapeau est passé, toutes les sous-chaînes qui satisfont le masque seront
                    aussi identifiées par leur offset (en octets). Notez que cela modifie la valeur
                    de <strong>$matches</strong> en un tableau de tableau où chaque élément est un tableau contenant
                    la sous-chaîne satisfaite à l'index <return>0</return> et l'index de celle-ci dans la chaîne
                    <strong>$subject</strong> à l'index <return>1</return>.
                    ]]>L'exemple ci-dessus va afficher : Array ( [0] => Array ( [0] => foobarbaz [1]
                    => 0 )
                     )
                     [1] => Array ( [0] => Array ( [0] => foo [1] => 0 )
                     )
                     [2] => Array ( [0] => Array ( [0] => bar [1] => 3 )
                     )
                     [3] => Array ( [0] => Array ( [0] => baz [1] => 6 )
                     )
                    
                    )
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
                    
                    Si ce drapeau est passé, les sous-masques non satisfait sont rapportés en tant
                    que <info>null</info> ; sinon ils sont rapportés en tant que chaîne de caractères vide.
                    
                    Si <strong>$order</strong> est omis, <info>PREG_PATTERN_ORDER</info> est utilisé par défaut.
  <info>array</info>   <strong>$matches</strong>  Si ce drapeau est passé, toutes les sous-chaînes qui satisfont le masque seront
                    aussi identifiées par leur offset (en octets). Notez que cela modifie la valeur
                    de <strong>$matches</strong> en un tableau de tableau où chaque élément est un tableau contenant
                    la sous-chaîne satisfaite à l'index <return>0</return> et l'index de celle-ci dans la chaîne
                    <strong>$subject</strong> à l'index <return>1</return>.
                    ]]>L'exemple ci-dessus va afficher : Array ( [0] => Array ( [0] => foobarbaz [1]
                    => 0 )
                     )
                     [1] => Array ( [0] => Array ( [0] => foo [1] => 0 )
                     )
                     [2] => Array ( [0] => Array ( [0] => bar [1] => 3 )
                     )
                     [3] => Array ( [0] => Array ( [0] => baz [1] => 6 )
                     )
                    
                    )
                    ]]>
                    
                    L'exemple ci-dessus va afficher :
  <info>int</info>     <strong>$offset</strong>   Normalement, la recherche commence au début de la chaîne  <strong>$subject</strong>. Le paramètre
                    optionnel <strong>$offset</strong> peut être utilisé pour spécifier une position pour le début de
                    la recherche (en octets).
                    
                    Utiliser le paramètre <strong>$offset</strong> ne revient pas à passer substr($subject, $offset)
                    à  <strong>preg_match_all()</strong> à la place de la chaîne  <strong>$subject</strong>, car  <strong>$pattern</strong> peut
                    contenir des assertions comme ^, $ ou (?\<=x). Lisez la documentation  sur la fonction <strong>preg_match()</strong> pour des exemples.

<comment>Return:</comment>
  <info>int|false</info>  Retourne le nombre de résultats qui satisfont le masque complet, ou <info>false</info> si une erreur
             survient.

<comment>See Also:</comment>
   * Masques PCRE
   * <strong>preg_quote()</strong>
   * <strong>preg_match()</strong>
   * <strong>preg_replace()</strong>
   * <strong>preg_split()</strong>
   * <strong>preg_last_error()</strong>


id: preg_quote
type: function
doc:
<comment>Description:</comment>
  Protection des caractères spéciaux des expressions régulières
  
  <strong>preg_quote()</strong> ajoute un antislash devant chaque caractère de la chaîne <strong>$str</strong> faisant partie de la
  syntaxe des expressions régulières. Cela est très utile si vous avez une chaîne qui va servir de
  masque, mais qui est générée durant l'exécution.
  
  Les caractères spéciaux qui seront protégés sont les suivants : <return>. \ + * ? [ ^ ] $ ( ) { } = !
  \< &gt; | : - #</return>
  
  Notez que <return>/</return> n'est pas un caractère spécial d'expression régulière.
  
  Notez que <strong>preg_quote()</strong> n'est pas destiné à être appliqué aux chaînes de caractères $replacement de
  <strong>preg_replace()</strong> etc.

<comment>Param:</comment>
  <info>string</info>       <strong>$str</strong>        La chaîne d'entrée.
  <info>string|null</info>  <strong>$delimiter</strong>  Si l'argument optionnel <strong>$delimiter</strong> est fourni, il sera aussi échappé.
                           Ceci est pratique pour échapper le délimiteur requis par les fonctions
                           PCRE. Le slash <return>/</return> est le délimiteur le plus répandu.

<comment>Return:</comment>
  <info>string</info>  Retourne la chaîne protégée.

<comment>See Also:</comment>
   * Masques PCRE
   * <strong>escapeshellcmd()</strong>


id: preg_replace
type: function
doc:
<comment>Description:</comment>
  Rechercher et remplacer par expression rationnelle standard
  
  Analyse <strong>$subject</strong> pour trouver l'expression rationnelle <strong>$pattern</strong> et remplace les résultats par
  <strong>$replacement</strong>.
  
  Pour faire correspondre une chaîne exacte, plutôt qu'une expression rationnelle,  l'utilisation de
  <strong>str_replace()</strong> ou <strong>str_ireplace()</strong>  est recommandée à la place de cette fonction.

<comment>Param:</comment>
  <info>string|array</info>  <strong>$pattern</strong>      Le masque à chercher. Il peut être une chaîne ou un tableau de
                              chaînes.
                              
                              Plusieurs modificateurs PCRE sont également disponibles.
  <info>string|array</info>  <strong>$replacement</strong>  La chaîne ou un tableau de chaînes pour le remplacement. Si ce
                              paramètre est une chaîne et le paramètre <strong>$pattern</strong> est un tableau, tous
                              les masques seront remplacés par cette chaîne. Si les paramètres
                              <strong>$pattern</strong> et  <strong>$replacement</strong> sont des tableaux, chaque <strong>$pattern</strong> sera
                              remplacé par son <strong>$replacement</strong> associé. Si <strong>$replacement</strong> à moins
                              d'éléments que <strong>$pattern</strong>, alors une chaîne vide est utilisée pour le
                              reste des valeurs.
                              
                              <strong>$replacement</strong> peut contenir des références de la forme <return>\n</return> ou <return>$n</return>. Cette
                              dernière forme est recommandée. Ces références seront remplacées  par
                              le texte capturé par la n-ième parenthèse  capturante du masque. n
                              peut prendre des  valeurs de 0 à 99, et <return>\0</return> ou <return>$0</return>,  correspondent au
                              texte de qui satisfait le masque complet. Les parenthèses ouvrantes
                              sont comptées de gauche à droite (en commençant à 1) pour  déterminer
                              le numéro de parenthèse capturante. Il est à noter que dans les chaîne
                              de caractères litéralles les antislashs doivent peut être être
                              échappé.
                              
                              Lorsque vous travaillez avec un masque de remplacement où une
                              référence arrière  est directement suivie par un nombre (i.e.: placer
                              un nombre littéral immédiatement après une référence arrière), vous ne
                              pouvez pas utiliser la syntaxe classique <return>\1</return> pour la référence arrière.
                              <return>\11</return>, par exemple, sera confus pour la fonction <strong>preg_replace()</strong> dans le
                              sens où elle ne saura pas si vous désirez la référence arrière <return>\1</return>
                              suivi du nombre <return>1</return> ou si vous désirez la référence arrière <return>\11</return> suivi de
                              "rien". Dans ce cas, la solution est d'utiliser la syntaxe <return>${1}1</return>. Cela
                              créera une référence arrière isolée <return>$1</return>, suivi du nombre littéral <return>1</return>.
                              
                              Lorsque vous utilisez l'option obsolète <return>e</return>, cette fonction échappe
                              quelques caractères (<return>'</return>, <return>"</return>, <return>\</return> et NULL) dans la chaîne qui remplace les
                              références arrières. Ce comportement se justifie afin d'assurer
                              qu'aucune erreur de syntaxe ne survient lors de l'utilisation des
                              références arrières avec des guillemets simples et doubles  (e.g.
                              <return>'strlen(\'$1\')+strlen("$2")'</return>). Assurez-vous d'être familier avec la
                              syntaxe des chaînes afin de savoir exactement à quoi la chaîne
                              interprétée doit ressembler.
  <info>string|array</info>  <strong>$subject</strong>      La chaîne ou le tableau contenant des chaînes à chercher et à
                              remplacer.
                              
                              Si <strong>$subject</strong> est un tableau, alors l'opération sera appliquée à chacun
                              des éléments du tableau, et le tableau sera retourné.
                              
                              Si le tableau <strong>$subject</strong> est associatif, alors les clés seront
                              préservées dans la valeur retournée.
  <info>int</info>           <strong>$limit</strong>        Le nombre maximal de remplacement pour chaque masque dans chaque
                              chaîne <strong>$subject</strong>. Par défaut, vaut <return>-1</return> (aucune limite).
  <info>int</info>           <strong>$count</strong>        Si fournie, cette variable contiendra le nombre de remplacements
                              effectués.

<comment>Return:</comment>
  <info>string|array|null</info>  <strong>preg_replace()</strong> retourne un tableau si le paramètre <strong>$subject</strong> est un tableau, ou
                     une chaîne sinon.
                     
                     Si des correspondances sont trouvées, le nouveau  <strong>$subject</strong> sera retourné, sinon
                     <strong>$subject</strong> sera retourné à l'identique, ou <info>null</info> si une erreur survient.

<comment>See Also:</comment>
   * Masques PCRE
   * <strong>preg_quote()</strong>
   * <strong>preg_filter()</strong>
   * <strong>preg_match()</strong>
   * <strong>preg_replace_callback()</strong>
   * <strong>preg_split()</strong>
   * <strong>preg_last_error()</strong>
   * <strong>str_replace()</strong>


id: preg_replace_callback
type: function
doc:
<comment>Description:</comment>
  Rechercher et remplacer par expression rationnelle standard en utilisant une fonction de callback
  
  Le comportement de <strong>preg_replace_callback()</strong> est presque identique à celui de <strong>preg_replace()</strong>, hormis
  le fait qu'à la place du paramètre <strong>$replacement</strong>, il faut spécifier une fonction de rappel
  <strong>$callback</strong> qui sera appelée, avec les éléments trouvés en arguments.

<comment>Param:</comment>
  <info>string|array</info>  <strong>$pattern</strong>   Le masque à chercher. Il peut être une chaîne de caractères ou un tableau
                           contenant des chaînes.
  <info>callable</info>      <strong>$callback</strong>  La fonction de rappel qui recevra le tableau d'éléments trouvés dans la
                           chaîne <strong>$subject</strong>. La fonction de rappel doit retourner la chaîne de
                           remplacement. Voici la signature de la fonction de rappel :
                           
                           <info>string</info>handler<info>array</info><strong>$matches</strong>
                           
                           Vous aurez souvent besoin de la fonction <strong>$callback</strong> avec
                           <strong>preg_replace_callback()</strong> à un seul endroit. Dans ce cas, vous pouvez
                           simplement utiliser une fonction anonyme pour déclarer une fonction de
                           rappel pour la fonction <strong>preg_replace_callback()</strong>. En faisant cela, vous
                           concentrez toutes les routines liées à votre remplacement à un seul
                           endroit, et vous ne polluez pas votre espace de noms de fonctions avec
                           des fonctions à usage unique.
                           
                           <strong>preg_replace_callback()</strong> et fonction anonyme
                           ]]>
  <info>string|array</info>  <strong>$subject</strong>   La chaîne ou le tableau de chaînes à chercher et à remplacer.
  <info>int</info>           <strong>$limit</strong>     Le nombre maximal de remplacement pour chaque masque dans chaque chaîne
                           <strong>$subject</strong>. Vaut par défaut <return>-1</return> (aucune limite).
  <info>int</info>           <strong>$count</strong>     Si fournie, cette variable sera remplie avec le nombre de remplacements
                           effectués.
  <info>int</info>           <strong>$flags</strong>     <strong>$flags</strong> peut être une combinaison des drapeaux <info>PREG_OFFSET_CAPTURE</info> et
                           <info>PREG_UNMATCHED_AS_NULL</info>, qui influence le format du tableau de
                           correspondances. Voir la description de <strong>preg_match()</strong> pour plus de détail.

<comment>Return:</comment>
  <info>string|array|null</info>  <strong>preg_replace_callback()</strong> retourne un tableau si le paramètre <strong>$subject</strong> est un
                     tableau, ou, sinon, une chaîne de caractères. Si une erreur survient, la valeur
                     retournée sera <info>null</info>.
                     
                     Si des correspondances sont trouvées, le nouveau sujet sera retourné, sinon
                     <strong>$subject</strong> sera retourné inchangé.

<comment>See Also:</comment>
   * Masques PCRE
   * <strong>preg_replace_callback_array()</strong>
   * <strong>preg_quote()</strong>
   * <strong>preg_replace()</strong>
   * <strong>preg_last_error()</strong>
   * Les fonctions anonymes


