Procédure : Spécifier des types de données PHP

Télécharger le pilote PHP

Quand vous utilisez le pilote PDO_SQLSRV, vous pouvez spécifier le type de données PHP lors de la récupération des données à partir du serveur avec PDOStatement::bindColumn et PDOStatement::bindParam. Pour plus d’informations, consultez PDOStatement::bindColumn et PDOStatement::bindParam .

Les étapes suivantes récapitulent la manière de spécifier des types de données PHP lors de la récupération des données à partir du serveur à l’aide du pilote SQLSRV :

1. Configurez et exécutez une requête Transact-SQL avec sqlsrv_query ou la combinaison de sqlsrv_prepare/sqlsrv_execute.

2. Rendez une ligne de données disponible pour la lecture avec sqlsrv_fetch.

3. Récupérez les données de champ d’une ligne retournée à l’aide de sqlsrv_get_field avec le type de données PHP souhaité spécifié en tant que troisième paramètre facultatif. Si le troisième paramètre facultatif n’est pas spécifié, les données sont retournées selon les types PHP par défaut. Pour plus d’informations sur les types de retour PHP par défaut, consultez Default PHP Data Types.

   Pour plus d’informations sur les constantes utilisées pour spécifier le type de données PHP, consultez la section PHPTYPE de Constantes (pilotes Microsoft pour PHP pour SQL Server).

 Exemple

L’exemple suivant récupère des lignes de la table Production.ProductReview de la base de données AdventureWorks. Dans chaque ligne retournée, le champ ReviewDate est récupéré sous forme de chaîne et le champ Comments sous forme de flux. Les données de flux apparaissent à l’aide de la fonction fpassthru PHP.

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 the Transact-SQL query. */  
$tsql = "SELECT ReviewerName,   
                ReviewDate,  
                Rating,   
                Comments   
         FROM Production.ProductReview   
         WHERE ProductID = ?   
         ORDER BY ReviewDate DESC";  
  
/* Set the parameter value. */  
$productID = 709;  
$params = array( $productID);  
  
/* Execute the query. */  
$stmt = sqlsrv_query($conn, $tsql, $params);  
if( $stmt === false )  
{  
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve and display the data. The first and third fields are  
retrieved according to their default types, strings. The second field  
is retrieved as a string with 8-bit character encoding. The fourth  
field is retrieved as a stream with 8-bit character encoding.*/  
while ( sqlsrv_fetch( $stmt))  
{  
   echo "Name: ".sqlsrv_get_field( $stmt, 0 )."\n";  
   echo "Date: ".sqlsrv_get_field( $stmt, 1,   
                       SQLSRV_PHPTYPE_STRING( SQLSRV_ENC_CHAR))."\n";  
   echo "Rating: ".sqlsrv_get_field( $stmt, 2 )."\n";  
   echo "Comments: ";  
   $comments = sqlsrv_get_field( $stmt, 3,   
                            SQLSRV_PHPTYPE_STREAM(SQLSRV_ENC_CHAR));  
   fpassthru( $comments);  
   echo "\n";   
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>  

Dans l’exemple, le fait de récupérer le deuxième champ (ReviewDate) sous forme de chaîne permet de préserver la précision à la milliseconde du type de données DATETIME SQL Server. Par défaut, le type de données DATETIME SQL Server est récupéré sous la forme d’un objet DateTime PHP dans lequel la précision à la milliseconde est perdue.

La récupération du quatrième champ (Comments) sous forme de flux est indiquée à des fins de démonstration. Par défaut, le type de données SQL Server nvarchar(3850) est récupérée sous la forme d’une chaîne, ce qui est acceptable dans la plupart des situations.

Notes

La fonction sqlsrv_field_metadata fournit un moyen d’obtenir des informations de champ, y compris des informations de type, avant d’exécuter une requête.

Voir aussi

Récupération de données

À propos des exemples de code dans la documentation

Procédure : Récupérer des paramètres de sortie à l’aide du pilote SQLSRV

Procédure : Récupérer des paramètres d’entrée et de sortie à l’aide du pilote SQLSRV