L'Altruiste : Le langage PHP - Les fonctions MSQL

Le langage PHP dispose de nombreuses fonctions permettant de travailler sur des bases de données mSQL.

L'utilisation de cette librairie nécessite l'activation de l'option de configuration --with-msql[=répertoire], le répertoire par défaut étant /usr/local/Hughes.

Fonction

Description

$id_resultat | false = msql($nom_base, $requete, $id_connexion);

envoie une requête au serveur mSQL.

$nb_enregistrements = msql_affected_rows($id_resultat);

retourne le nombre d'enregistrements affectées.

true | false = msql_close($id_connexion);

ferme une connexion mSQL.

$id_connexion | false = msql_connect([$nom_hote
[, $port_hote [, $utilisateur [, $mot_passe]]]]);

ouvre une connexion mSQL et retourne un identifiant de connexion.

true | false = msql_create_db($nom_base, $id_connexion);
true | false = msql_createdb($nom_base, $id_connexion);

crée une base de données mSQL.

true | false = msql_data_seek($id_resultat, $num_enregistrement);

déplace le pointeur vers un enregistrement désigné par son numéro.

$nom = msql_dbname($id_resultat, $position);

retourne le nom de la base de données courante.

true | false = msql_drop_db($nom_base, $id_connexion);
true | false = msql_dropdb($nom_base, $id_connexion);

supprime une base de données mSQL.

$message = msql_error();

retourne le message d'erreur.

$tab_valeurs | false = msql_fetch_array($id_resultat
[, MSQL_ASSOC | MSQL_NUM | MSQL_BOTH]);

retourne les valeurs d'un enregistrement dans un tableau associatif (MSQL_ASSOC), indicé (MSQL_NUM) ou les deux (MSQL_BOTH).

$obj_informations = msql_fetch_field($id_resultat, $position_champs);

retourne les informations à propos d'un champs dans un objet dont les propriétés sont :

Propriété	Description
name	représente le nom de la colonne.
table	représente le nom de la table d'où la colonne est originaire.
not_null	retourne -1 si la colonne n'est pas NULL.
primary_key	retourne -1 si la colonne est une clé primaire.
unique	retourne -1 si la colonne est une clé unique.
type	retourne le type de la colonne.

$obj_valeurs | false = msql_fetch_object($id_resultat);

retourne les valeurs d'un enregistrement dans un objet.

$tab_valeurs | false = msql_fetch_row($id_resultat);

retourne les valeurs d'un enregistrement dans un tableau indicé.

$nom = msql_fieldname($id_resultat, $position_champs);

retourne le nom d'un champs.

$position = msql_field_seek($id_resultat $position_champs);

détermine la position du pointeur de champs.

$nom = msql_fieldtable($id_resultat, $position_champs);

retourne le nom de la table d'où provient le champs.

$type = msql_fieldtype($id_resultat, $position_champs);

retourne le type de champs.

$semaphore = msql_fieldflags($id_resultat, $position_champs);

retourne le sémaphore d'un champs.

$longueur = msql_fieldlen($id_resultat, $position_champs);

retourne la longueur d'un champs.

true | false = msql_free_result($id_resultat);
true | false = msql_freeresult($id_resultat);

libère les ressources consommées par le résultat.

$id_liste = msql_list_fields($nom_base, $nom_table);
$id_liste = msql_listfields($nom_base, $nom_table);

retourne la liste des champs dans une table désignée par un identifiant.

$id_liste = msql_list_dbs();
$id_liste = msql_listdbs();

retourne une liste des bases de données mSQL sur un serveur.

$id_liste = msql_list_tables($nom_base);
$id_liste = msql_listtables($nom_base);

retourne une liste des tables mSQL sur une base de données.

$nb_champs = msql_num_fields($id_resultat);
$nb_champs = msql_numfields($id_resultat);

retourne le nombre de champs dans un résultat.

$nb_enregistrements = msql_num_rows($id_resultat);
$nb_enregistrements = msql_numrows($id_resultat);

retourne le nombre d'enregistrements dans un résultat.

$id_connexion | false = msql_pconnect([$nom_hote
[, $port_hote [, $utilisateur [, $mot_passe]]]]);

ouvre une connexion persistante à un serveur mSQL.

$id_resultat | false = msql_query($requete, $id_connexion);

envoie une requête mSQL et retourne un identifiant de résultat.

$chaine_preparee = msql_regcase($expression_reguliere);

prépare une chaîne pour une recherche par expression régulière insensible à la casse.

$valeur | false = msql_result($id_resultat,
$num_enregistrement , $position_champs);

retourne la valeur d'un champs désigné par sa position ou son nom dans un enregistrement.

true | false = msql_select_db($nom_base, $id_connexion);
true | false = msql_selectdb($nom_base, $id_connexion);

sélectionne une base de données mSQL.

$nom = msql_tablename($id_resultat, $position_champs);

retourne le nom de la table d'où est postionné le champs spécifié.

Exemple

<!-- Fichier : formulaire.html -->
<html>
  <body>
  <h3>Ajout d'un enregistrement<h3>
    <form action="traitement.php" method="POST">
      <table border="0" summary="">
        <tr>
          <td>Nom</td>
          <td><input type="text" name="nom"></td>
        </tr>
        <tr>
          <td>Prénom</td>
          <td><input type="text" name="prenom"></td>
        </tr>
        <tr>
          <td>eMail</td>
          <td><input type="text" name="email"></td>
        </tr>
        <tr>
          <td></td>
          <td><input type="submit" name="soumettre" value="Soumettre"></td>
        </tr>
      </table>
    </form>
  </body>
</html>

<!-- Fichier : traitement.html -->
<html>
  <body>
    <h3>Enregistrement ajouté</h3>
    <?php
      $id_connexion = msql_connect("serveur", 1114, "utilisateur", "mot_passe");
              or die("Une erreur s'est produite :<br>" . msql_error());

      msql_select_db($id_connexion, "bd_personnel")
              or die("Une erreur s'est produite :<br>" . msql_error());

      $date_entree = date("d/m/Y");
      $insertion = "insert into tbl_employee "
                    . "values ('$date_entree', '$nom', '$prenom', '$email')";
      msql_query($sock, $insertion)
              or die("Une erreur s'est produite :<br>" . msql_error());

      $resultat = msql_query($sock, "select * from tbl_employee")
              or die("Une erreur s'est produite :<br>" . msql_error());

      $i = 0;
      echo "<table><tr>";
      while($enregistrement = msql_fetch_array($resultat, MSQL_ASSOC))
      {
        $entete = array_keys($enregistrement);
        $contenu = array_values($enregistrement);

        if($i == 0)
        {
          while($cle = array_shift($entete))
          {
            echo "<th>" . $cle . "</th>";
          }
        }

        echo "</tr><tr>";

        while($valeur = array_shift($contenu))
        {
          echo "<td>" . $valeur . "</td>";
        }
        $i++;
      }
      echo "</tr></table>";

      msql_free_result($resultat);

      msql_close($id_connexion);
    %>
  </body>
</html>