sqlsrv_fetch_array
Récupère la ligne suivante de données sous forme de tableau indexé numériquement, de tableau associatif ou les deux.
Syntaxe
sqlsrv_fetch_array( resource $stmt[, int $fetchType [, row[, ]offset]])
Paramètres
$stmt : ressource d’instruction correspondant à une instruction exécutée.
$fetchType [FACULTATIF] : constante prédéfinie. Ce paramètre peut prendre l’une des valeurs répertoriées dans le tableau suivant :
| Valeur | Description |
|---|---|
| SQLSRV_FETCH_NUMERIC | La ligne de données suivante est retournée sous forme de tableau numérique. |
| SQLSRV_FETCH_ASSOC | La ligne de données suivante est retournée sous forme de tableau associatif. Les clés de tableau sont les noms des colonnes dans le jeu de résultats. |
| SQLSRV_FETCH_BOTH | La ligne de données suivante est retournée à la fois comme tableau numérique et comme tableau associatif. Il s’agit de la valeur par défaut. |
ligne [FACULTATIF] : Ajoutée dans la version 1.1. L’une des valeurs suivantes, spécifiant la ligne à laquelle accéder dans un jeu de résultats qui utilise un curseur permettant le défilement. (quand vous spécifiez row, vous devez spécifier fetchtype de manière explicite, même si vous spécifiez la valeur par défaut).
- SQLSRV_SCROLL_NEXT
- SQLSRV_SCROLL_PRIOR
- SQLSRV_SCROLL_FIRST
- SQLSRV_SCROLL_LAST
- SQLSRV_SCROLL_ABSOLUTE
- SQLSRV_SCROLL_RELATIVE
Pour plus d’informations sur ces valeurs, consultez Spécification d’un type de curseur et sélection de lignes. La prise en charge du curseur permettant le défilement a été ajoutée dans la version 1.1 du Pilotes Microsoft SQL Server pour PHP.
décaler [FACULTATIF] : Utilisé avec SQLSRV_SCROLL_ABSOLUTE et SQLSRV_SCROLL_RELATIVE pour spécifier la ligne à récupérer. Le premier enregistrement dans le jeu de résultats est 0.
Valeur de retour
Si une ligne de données est récupérée, un tableau est retourné. S’il n’y a plus aucune ligne à récupérer, la valeur null est retournée. Si une erreur se produit, la valeur false est retournée.
En fonction de la valeur du paramètre $fetchType , le tableau retourné peut être un tableauindexé numériquement, un tableauassociatif, ou les deux. Par défaut, un tableau avec des clés numériques et associatives est retourné. Le type de données d’une valeur dans le tableau retourné sera le type de données PHP par défaut. Pour plus d’informations sur les types de données PHP par défaut, consultez Default PHP Data Types.
Notes
Si une colonne sans nom est retournée, la clé associative de l’élément de tableau est une chaîne vide (""). Par exemple, considérez cette instruction Transact-SQL qui insère une valeur dans une table de base de données et récupère la clé primaire générée par le serveur :
INSERT INTO Production.ProductPhoto (LargePhoto) VALUES (?);
SELECT SCOPE_IDENTITY()
Si le jeu de résultats retourné par la partie SELECT SCOPE_IDENTITY() de cette instruction est récupéré sous forme de tableau associatif, la clé de la valeur retournée est une chaîne vide (""), car la colonne retournée n’a pas de nom. Pour éviter ce problème, vous pouvez récupérer le résultat sous forme de tableau numérique, ou spécifier un nom pour la colonne retournée dans l’instruction Transact-SQL. La déclaration suivante constitue un moyen pour spécifier un nom de colonne dans Transact-SQL :
SELECT SCOPE_IDENTITY() AS PictureID
Si un jeu de résultats contient plusieurs colonnes sans nom, la valeur de la dernière colonne sans nom est affectée à la clé de chaîne vide ("").
Exemple de tableau associatif
L’exemple suivant récupère chaque ligne d’un jeu de résultats sous forme d’objet arrayassociatif. L’exemple part du principe que SQL Server et la base de données AdventureWorks sont installés sur l’ordinateur local. Toute la sortie est écrite dans la console quand l’exemple est exécuté à partir de la ligne de commande.
<?php
/* Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
echo "Could not connect.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Set up and execute the query. */
$tsql = "SELECT FirstName, LastName
FROM Person.Contact
WHERE LastName='Alan'";
$stmt = sqlsrv_query( $conn, $tsql);
if( $stmt === false)
{
echo "Error in query preparation/execution.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Retrieve each row as an associative array and display the results.*/
while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC))
{
echo $row['LastName'].", ".$row['FirstName']."\n";
}
/* Free statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>
Exemple de tableau indexé
L’exemple suivant récupère chaque ligne d’un jeu de résultats sous forme de tableau indexé numériquement.
L’exemple récupère, à partir de la table Purchasing.PurchaseOrderDetail de la base de données AdventureWorks, les informations sur les produits qui ont une date spécifique, et dont la quantité en stock (StockQty) est inférieure à la valeur spécifiée.
L’exemple part du principe que SQL Server et la base de données AdventureWorks sont installés sur l’ordinateur local. Toute la sortie est écrite dans la console quand l’exemple est exécuté à partir de la ligne de commande.
<?php
/* Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
echo "Could not connect.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Define the query. */
$tsql = "SELECT ProductID,
UnitPrice,
StockedQty
FROM Purchasing.PurchaseOrderDetail
WHERE StockedQty < 3
AND DueDate='2002-01-29'";
/* Execute the query. */
$stmt = sqlsrv_query( $conn, $tsql);
if ( $stmt )
{
echo "Statement executed.\n";
}
else
{
echo "Error in statement execution.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Iterate through the result set printing a row of data upon each
iteration.*/
while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_NUMERIC))
{
echo "ProdID: ".$row[0]."\n";
echo "UnitPrice: ".$row[1]."\n";
echo "StockedQty: ".$row[2]."\n";
echo "-----------------\n";
}
/* Free statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>
La fonction sqlsrv_fetch_array retourne toujours des données en fonction des Default PHP Data Types. Pour plus d’informations sur la façon de spécifier le type de données PHP, consultez Procédure : spécifier des types de données PHP.
Si un champ sans nom est récupéré, la clé associative de l’élément de tableau est une chaîne vide (""). Pour plus d’informations, consultez sqlsrv_fetch_array.
Voir aussi
Informations de référence sur l’API du pilote SQLSRV
À propos des exemples de code dans la documentation
Guide de programmation pour les pilotes Microsoft pour PHP pour SQL Server
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour