Útmutató: Adatok küldése streamként

PHP-illesztőprogram letöltése

Az SQL ServerHEZ készült PHP-illesztőprogramok a PHP-streamek előnyeit használják nagy objektumok kiszolgálóra való küldéséhez. A jelen témakör példái bemutatják, hogyan küldhet adatokat streamként. Az első példa az SQLSRV-illesztővel mutatja be az alapértelmezett viselkedést, amely az összes streamadat elküldése a lekérdezés végrehajtásakor. A második példa az SQLSRV-illesztővel mutatja be, hogyan küldhet egyszerre legfeljebb nyolc kilobájtnyi streamadatot a kiszolgálónak.

A harmadik példa bemutatja, hogyan küldhet streamadatokat a kiszolgálónak a PDO_SQLSRV illesztőprogram használatával.

Példa: Streamadatok küldése végrehajtáskor

Az alábbi példa beszúr egy sort az AdventureWorks adatbázis Production.ProductReview táblájába. Az ügyfél megjegyzései ($comments) streamként nyílnak meg a PHP fopen függvénnyel, majd a lekérdezés végrehajtásakor streamelik a kiszolgálóra.

A példa feltételezi, hogy az SQL Server és az AdventureWorks adatbázis telepítve van a helyi számítógépen. A rendszer minden kimenetet a konzolra ír.

<?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 = "INSERT INTO Production.ProductReview (ProductID,   
                                               ReviewerName,  
                                               ReviewDate,  
                                               EmailAddress,  
                                               Rating,  
                                               Comments)  
         VALUES (?, ?, ?, ?, ?, ?)";  
  
/* Set the parameter values and put them in an array.  
Note that $comments is opened as a stream. */  
$productID = '709';  
$name = 'Customer Name';  
$date = date("Y-m-d");  
$email = 'customer@name.com';  
$rating = 3;  
$data = 'Insert any lengthy comment here.';
$comments = fopen('data:text/plain,'.urlencode($data), 'r');
$params = array($productID, $name, $date, $email, $rating, $comments);
  
/* Execute the query. All stream data is sent upon execution.*/  
$stmt = sqlsrv_query($conn, $tsql, $params);  
if ($stmt === false) {
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
} else {
     echo "The query was successfully executed.";  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>  

Példa: Streamadatok küldése sqlsrv_send_stream_data

A következő példa megegyezik az előző példával, de az összes streamadat végrehajtáskor történő elküldésének alapértelmezett viselkedése ki van kapcsolva. A példa sqlsrv_send_stream_data használ a streamadatok kiszolgálónak való küldéséhez. A rendszer legfeljebb nyolc kilobájtnyi (8 kB) adatot küld minden hívással sqlsrv_send_stream_data. A szkript megszámolja a sqlsrv_send_stream_data által kezdeményezett hívások számát, és megjeleníti a konzolon lévő számokat.

A példa feltételezi, hogy az SQL Server és az AdventureWorks adatbázis telepítve van a helyi számítógépen. A rendszer minden kimenetet a konzolra ír.

<?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 = "INSERT INTO Production.ProductReview (ProductID,   
                                               ReviewerName,  
                                               ReviewDate,  
                                               EmailAddress,  
                                               Rating,  
                                               Comments)  
         VALUES (?, ?, ?, ?, ?, ?)";  
  
/* Set the parameter values and put them in an array.  
Note that $comments is opened as a stream. */  
$productID = '709';  
$name = 'Customer Name';  
$date = date("Y-m-d");  
$email = 'customer@name.com';  
$rating = 3;  
$data = 'Insert any lengthy comment here.';
$comments = fopen('data:text/plain,'.urlencode($data), 'r');
$params = array($productID, $name, $date, $email, $rating, $comments);  
  
/* Turn off the default behavior of sending all stream data at  
execution. */  
$options = array("SendStreamParamsAtExec" => 0);  
  
/* Execute the query. */  
$stmt = sqlsrv_query($conn, $tsql, $params, $options);  
if ($stmt === false) {
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Send up to 8K of parameter data to the server with each call to  
sqlsrv_send_stream_data. Count the calls. */  
$i = 1;  
while (sqlsrv_send_stream_data($stmt)) {
     echo "$i call(s) made.\n";  
     $i++;  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>  

Bár a jelen témakör példái karakteradatokat küldenek a kiszolgálónak, az adatok bármilyen formátumban elküldhetők streamként. Használhatja például a jelen témakörben bemutatott technikákat is, amelyekkel bináris formátumban küldhet képeket streamként.

Példa: Kép küldése streamként

<?php  
   $server = "(local)";   
   $database = "Test";  
   $conn = new PDO( "sqlsrv:server=$server;Database = $database", "", "");  
  
   $binary_source = fopen( "data://text/plain,", "r");  
  
   $stmt = $conn->prepare("insert into binaries (imagedata) values (?)");  
   $stmt->bindParam(1, $binary_source, PDO::PARAM_LOB);   
  
   $conn->beginTransaction();  
   $stmt->execute();  
   $conn->commit();  
?>  

Lásd még:

Adatok frissítése (Microsoft Drivers for PHP for SQL Server)

Adatok beolvasása streamként az SQLSRV-illesztőprogram használatával

Tudnivalók a dokumentációban szereplő példakódokról