mysqli::execute_query

Applicable à la version PHP (PHP 8> = 8.2.0)

illustrer

Style orienté objet

 public mysqli::execute_query(string $query, ?array $params = null): mysqli_result|bool

Style de processus

 mysqli_execute_query(mysqli $mysql, string $query, ?array $params = null): mysqli_result|bool

Préparez les requêtes SQL, liez les paramètres et exécutez des requêtes. La méthode MySQLI :: EXECUTE_QUERY () est un raccourci vers MySQLI :: Prepare (), MySQLI_STMT :: bind_param (), mysqli_stmt :: execute () et mysqli_stmt :: get_result ().

Un modèle d'instruction peut contenir des marques de paramètres zéro ou plus (?) - également appelées espaces réservées. Les valeurs des paramètres doivent être fournies sous forme de tableau à l'aide du paramètre params.

Des instructions de prétraitement sont créées en bas, mais ne sont jamais exposées en dehors de la fonction. Il est impossible d'accéder aux propriétés d'une instruction comme l'accès à l'objet mysqli_stmt. En raison de cette limitation, les informations d'état sont copiées dans l'objet MySQLI et ses méthodes peuvent être utilisées, telles que MySQLI_AFFected_Rows () ou MySqli_error ().

Avis

Si l'instruction transmise à mysqli_execute_query () est plus longue que le max_allowed_packet du serveur, le code d'erreur renvoyé variera en fonction du système d'exploitation. Le comportement est le suivant:

Retourner le code d'erreur 1153 sur Linux. Le message d'erreur signifie que le paquet résultant est plus grand que les octets max_allowed_packet.

Renvoie le code d'erreur 2006 sur Windows. Ce message d'erreur indique que le serveur a disparu.

paramètre
mysql
Style de procédure uniquement: un objet mysqli renvoyé par mysqli_connect () ou mysqli_init ().

requête
Requête, comme une chaîne. Il doit être composé d'une seule instruction SQL.

Les instructions SQL peuvent contenir des marques de paramètres zéro ou plus représentées par des marques de questions (?) Dans des emplacements appropriés.

Avis:

Ces balises ne sont légales qu'à certains endroits des instructions SQL. Par exemple, ils peuvent être utilisés dans la liste des valeurs () de l'instruction d'insertion (spécifiant les valeurs de colonne pour une ligne), ou ils sont autorisés à spécifier des valeurs de comparaison par rapport aux colonnes dans la clause où. Cependant, ils ne sont pas autorisés à être utilisés pour les identifiants (tels que les noms de table ou de colonne).

paramètres
Un tableau de liste facultatif avec autant d'éléments que le nombre de paramètres liés dans l'instruction SQL en cours d'exécution. Chaque valeur est traitée comme une chaîne.