Procedimientos: Especificación de los tipos de datos PHP

Descargar controlador PHP

Cuando se utiliza el controlador PDO_SQLSRV, puede especificar el tipo de datos PHP cuando se recuperan datos del servidor con PDOStatement::bindColumn y PDOStatement::bindParam. Vea PDOStatement::bindColumn y PDOStatement::bindParam para obtener más información.

En los pasos siguientes se resume cómo especificar los tipos de datos PHP cuando se recuperan datos del servidor mediante el controlador SQLSRV:

1. Configure y ejecute una consulta de Transact-SQL con sqlsrv_query, o bien la combinación de sqlsrv_prepare/sqlsrv_execute.

2. Haga que una fila de datos esté disponible para su lectura con sqlsrv_fetch.

3. Recupere los datos de campo de una fila devuelta mediante sqlsrv_get_field con el tipo de datos PHP deseado especificado como el tercer parámetro opcional. Si no se especifica el tercer parámetro opcional, los datos se devuelven según los tipos de datos PHP predeterminado. Para obtener información sobre los tipos de valor devueltos de PHP predeterminado, consulte Default PHP Data Types.

   Para obtener información sobre las constantes que se usan para especificar el tipo de datos PHP, consulte la sección de PHPTYPE de Constantes (Controladores de Microsoft para PHP para SQL Server).

Ejemplo

En el ejemplo siguiente se recuperan las filas de la tabla Production.ProductReview de la base de datos de AdventureWorks. En cada fila devuelta, el campo ReviewDate se recupera como una cadena, y el campo Comments, como una secuencia. Los datos de la secuencia se muestran mediante la función PHP fpassthru .

En el ejemplo se da por hecho que SQL Server y la base de datos AdventureWorks están instalados en el equipo local. Los resultados se agregan a la consola cuando se ejecuta el ejemplo en la línea de comandos.

<?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);  
?>  

En el ejemplo, al recuperar el segundo campo (ReviewDate) como una cadena se conserva la precisión de milisegundos del tipo de datos DATETIME de SQL Server. De forma predeterminada, el tipo de datos DATETIME de SQL Server se recupera como un objeto DateTime PHP en el que se pierde la precisión de milisegundos.

La recuperación del cuarto campo (Comments) como una secuencia se realiza con fines demostrativos. De forma predeterminada, el tipo de datos nvarchar(3850) de SQL Server se recupera como una cadena, lo que resulta aceptable en la mayoría de las situaciones.

Nota

La función sqlsrv_field_metadata proporciona una forma de obtener información de los campos, incluidos los datos de los tipos, antes de ejecutar una consulta.

Consulte también

Recuperación de datos

Sobre los ejemplos de código de la documentación

Procedimientos: Recuperación de los parámetros de salida con el controlador SQLSRV

Procedimientos: Recuperación de los parámetros de entrada y salida con el controlador SQLSRV