mysqli_stmt::attr_set
mysqli_stmt_attr_set
(PHP 5)
mysqli_stmt::attr_set -- mysqli_stmt_attr_set — Modifie le comportement d'une requête préparée
Description
Style orienté objet
$attr
, int $mode
)Style procédural
Modifie le comportement d'une requête préparée. Cette fonction peut être appelée plusieurs fois pour définir plusieurs attributs.
Liste de paramètres
-
stmt
-
Style procédural uniquement : Un identifiant de requête retourné par la fonction mysqli_stmt_init().
-
attr
-
L'attribut que vous voulez définir. Il peut avoir une des valeurs suivantes :
Valeurs des attributs Caractère Description MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH Si défini à 1, la fonction mysqli_stmt_store_result() mettra à jour la valeur de la méta-donnée MYSQL_FIELD->max_length. MYSQLI_STMT_ATTR_CURSOR_TYPE Type du curseur permettant l'ouverture de la requête lorsque la fonction mysqli_stmt_execute() est appelée. mode
peut valoir MYSQLI_CURSOR_TYPE_NO_CURSOR (par défaut) ou MYSQLI_CURSOR_TYPE_READ_ONLY.MYSQLI_STMT_ATTR_PREFETCH_ROWS Nombre de lignes à récupérer depuis le serveur en une fois lors de l'utilisation d'un curseur. mode
peut être compris entre 1 et la valeur maximale d'un type long non-signé. Par défaut, vaut 1.Si vous utilisez l'option MYSQLI_STMT_ATTR_CURSOR_TYPE avec MYSQLI_CURSOR_TYPE_READ_ONLY, un curseur sera ouvert pour la requête lors de l'appel à la fonction mysqli_stmt_execute(). S'il y a déjà un curseur d'ouvert depuis un précédent appel à la fonction mysqli_stmt_execute(), il sera fermé avant d'en ouvrir un nouveau. La fonction mysqli_stmt_reset() ferme également tous les curseurs avant de préparer la requête pour une ré-exécution. La fonction mysqli_stmt_free_result() ferme tout curseur ouvert.
Si vous ouvrez un curseur pour une requête préparée, la fonction mysqli_stmt_store_result() n'est pas nécessaire.
-
mode
-
La valeur à assigner à l'attribut.