Como especificar tipos de dados do PHP

Baixar o driver PHP

Ao usar o driver PDO_SQLSRV, você pode especificar o tipo de dados do PHP ao recuperar dados do servidor com PDOStatement::bindColumn e PDOStatement::bindParam. Consulte PDOStatement::bindColumn e PDOStatement::bindParam para obter mais informações.

As etapas a seguir resumem como especificar tipos de dados do PHP ao recuperar dados do servidor usando o driver SQLSRV:

1. Configurar e executar uma consulta Transact-SQL com sqlsrv_query ou uma combinação de sqlsrv_prepare/sqlsrv_execute.

2. Disponibilize a próxima linha de dados para leitura com sqlsrv_fetch.

3. Recupere os dados de um campo de uma linha retornada usando sqlsrv_get_field com o tipo de dados do PHP desejado especificado como o terceiro parâmetro opcional. Se o terceiro parâmetro opcional não for especificado, os dados serão retornados de acordo com os tipos do PHP padrão. Para obter informações sobre tipos do PHP retornados padrão, consulte Default PHP Data Types.

   Para saber mais sobre as constantes usadas para especificar o tipo de dados do PHP, confira a seção PHPTYPEs de Constantes (Drivers da Microsoft para PHP para SQL Server).

Exemplo

O exemplo a seguir recupera linhas da tabela Production.ProductReview do banco de dados AdventureWorks. Em cada linha retornada, o campo ReviewDate é recuperado como uma cadeia de caracteres, e o campo Comments é recuperado como um fluxo. Os dados de fluxo são exibidos com o uso da função fpassthru do PHP.

O exemplo supõe que o SQL Server e o banco de dados AdventureWorks estejam instalados no computador local. Toda a saída será gravada no console quando o exemplo for executado da linha de comando.

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

No exemplo, a recuperação do segundo campo (ReviewDate) como uma cadeia de caracteres preserva a precisão de milissegundos do tipo de dados DATETIME do SQL Server. Por padrão, o tipo de dados DATETIME do SQL Server é recuperado como um objeto DateTime do PHP, no qual a precisão de milissegundos é perdida.

A recuperação do quarto campo (Comments) como um fluxo tem fins de demonstração. Por padrão, o tipo de dados nvarchar (3850) do SQL Server é recuperado como uma cadeia de caracteres, que é aceitável para a maioria das situações.

Observação

A função sqlsrv_field_metadata fornece uma maneira de obter informações de campo, incluindo informações de tipo, antes de executar uma consulta.

Consulte Também

Recuperando dados

Sobre exemplos de código na documentação

Como recuperar parâmetros de saída usando o driver SQLSRV

Como recuperar parâmetros de entrada e de saída usando o driver SQLSRV