Vergleichen von Ausführungsfunktionen

PHP-Treiber herunterladen

Beide Treiber können eine Anweisung einmal ausführen oder eine Anweisung für wiederholte Ausführung vorbereiten. Verwenden Sie Parameter für von Benutzern bereitgestellte Werte, selbst wenn Sie eine Abfrage nur einmal ausführen.

Wähle die Ausführungs-API getrennt davon aus, wie du die Ergebnisse abrufst. Die Vorbereitung einer Abfrage holt ihre Zeilen nicht, und das Puffern eines Ergebnisses macht eine Abfrage nicht parametrisiert. Die folgenden Beispiele bereiten eine schreibgeschützte Abfrage einmal vor, führen sie zweimal mit unterschiedlichen Werten aus und verbrauchen jedes Ergebnis vor der nächsten Ausführung.

sqlsrv_query() bereitet in einem Aufruf vor, führt aus und gibt eine Statement-Ressource zurück. sqlsrv_prepare() gibt eine Anweisungsressource zurück, ohne sie auszuführen; rufen Sie sqlsrv_execute() für jede Ausführung auf. PDO query() führt aus und gibt PDOStatement zurück, während exec() eine betroffene Zeilenanzahl statt eines Ergebnisobjekts zurückgibt. Ein erfolgreicher exec() kann 0 zurückgeben, also vergleiche eine Fehlschlagsrückgabe mit === false, nicht if (!$count).

PDO::query() akzeptiert kein Array von Parameterwerten. Seine optionalen Argumente konfigurieren das Abrufen. Für parametrisierte PDO_SQLSRV Abfragen verwenden Sie prepare() und execute().

Einmal vorbereiten ermöglicht es dir, einen Statement-Handle mit anderen Werten wiederzuverwenden. Das ist keine Garantie, dass der Server seinen Ausführungsplan niemals neu kompiliert. PDO_SQLSRV verwendet standardmäßig die vorbereitete Ausführung von Anweisungen, einschließlich für PDO::query(); das Attribut „direct-query“ steuert diese separate Auswahl.

Einmal vorbereiten und wiederholt ausführen

Dies sind separate, vollständige Kommandozeilenprogramme. Installiere und lade die ausgewählte Erweiterung und setze SQL_SERVER, SQL_DATABASE, , SQL_USERund SQL_PASSWORD in der PHP-Prozessumgebung. Verwenden Sie eine SQL Server-Testdatenbank und ein vom Client vertrauenswürdiges Serverzertifikat. Für die Umgebungseinrichtung und passwortlose Alternativen siehe Verbinden mit dem Server.

Speichere den tatsächlichen Datenbanknamen, Benutzernamen und Passwort in den Umgebungsvariablen. Beide Programme maskieren diese Werte einmal, indem sie schließende geschweifte Klammern verdoppeln und jeden Wert in geschweifte Klammern einschließen, wie es die ODBC-ähnliche Verbindungshandhabung des PHP-Treibers verlangt. Das Escapen von Verbindungswerten ist getrennt von der Bindung von Abfrageparametern.

Die Programme führen eine Transact-SQL (T-SQL)-Abfrage über zwei Inlinezeilen aus, ohne eine Tabelle zu erstellen oder Daten zu ändern. Speichere jedes Programm in einer eigenen .php Datei und führe es mit php <file>aus. Es ist keine Beispieldatenbank erforderlich.

SQLSRV

Übergeben Sie $productId per Referenz mit &$productId. Jedes sqlsrv_execute() verwendet dann seinen aktuellen Wert. SQLSRV_FETCH_ASSOC gibt ein Array zurück, das Spaltennamen als Schlüssel verwendet. Ein Ergebnis bedeutet, dass es keine Zeilen mehr gibt; false zeigt null einen Fehler an.

<?php
$config = [];
foreach (['SQL_SERVER', 'SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
    $value = getenv($name);
    if ($value === false || $value === '') {
        throw new RuntimeException("Set $name before running this example.");
    }
    $config[$name] = $value;
}
foreach (['SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
    $config[$name] = '{' . str_replace('}', '}}', $config[$name]) . '}';
}
$conn = sqlsrv_connect($config['SQL_SERVER'], [
    'Database' => $config['SQL_DATABASE'],
    'UID' => $config['SQL_USER'],
    'PWD' => $config['SQL_PASSWORD'],
    'Encrypt' => true,
    'TrustServerCertificate' => false,
    'LoginTimeout' => 30,
    'CharacterSet' => 'UTF-8',
]);
if ($conn === false) {
    throw new RuntimeException(print_r(sqlsrv_errors(), true));
}

$sql = "SELECT Name FROM (VALUES (1, 'Bike'), (2, 'Helmet')) AS Product(ProductId, Name) WHERE ProductId = ?";
$productId = 1;
$stmt = null;
try {
    $stmt = sqlsrv_prepare($conn, $sql, [&$productId], ['QueryTimeout' => 30]);
    if ($stmt === false) {
        throw new RuntimeException(print_r(sqlsrv_errors(), true));
    }
    foreach ([1 => 'Bike', 2 => 'Helmet'] as $productId => $expected) {
        if (!sqlsrv_execute($stmt)) {
            throw new RuntimeException(print_r(sqlsrv_errors(), true));
        }
        $names = [];
        while (($row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC)) !== null) {
            if ($row === false) {
                throw new RuntimeException(print_r(sqlsrv_errors(), true));
            }
            $names[] = $row['Name'];
        }
        if ($names !== [$expected]) {
            throw new RuntimeException('Expected exactly one matching product.');
        }
        echo $names[0], PHP_EOL;
    }
} finally {
    if (is_resource($stmt)) {
        sqlsrv_free_stmt($stmt);
    }
    sqlsrv_close($conn);
}

PDO_SQLSRV

Binde $productId einmal mit bindParam(). Jeder execute() liest seinen aktuellen Wert aus. PDO::PARAM_INT spezifiziert den PHP/PDO-Bindungstyp des Parameters; er kontrolliert nicht den PHP-Typ der aus dem Ergebnis abgerufenen Spalten. Stellen Sie den Ausnahmemodus so ein, dass ein Datenbankfehler die Ausführung unterbricht, anstatt für ein leeres Ergebnis gehalten zu werden.

<?php
$config = [];
foreach (['SQL_SERVER', 'SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
    $value = getenv($name);
    if ($value === false || $value === '') {
        throw new RuntimeException("Set $name before running this example.");
    }
    $config[$name] = $value;
}
foreach (['SQL_DATABASE', 'SQL_USER', 'SQL_PASSWORD'] as $name) {
    $config[$name] = '{' . str_replace('}', '}}', $config[$name]) . '}';
}
$server = $config['SQL_SERVER'];
$database = $config['SQL_DATABASE'];
$pdo = new PDO(
    "sqlsrv:Server=$server;Database=$database;Encrypt=true;"
    . "TrustServerCertificate=false;LoginTimeout=30",
    $config['SQL_USER'],
    $config['SQL_PASSWORD'],
    [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::SQLSRV_ATTR_ENCODING => PDO::SQLSRV_ENCODING_UTF8,
    ]
);
$sql = "SELECT Name FROM (VALUES (1, 'Bike'), (2, 'Helmet')) AS Product(ProductId, Name) WHERE ProductId = ?";
$stmt = null;
try {
    $stmt = $pdo->prepare($sql, [PDO::SQLSRV_ATTR_QUERY_TIMEOUT => 30]);
    $productId = 1;
    $stmt->bindParam(1, $productId, PDO::PARAM_INT);
    foreach ([1 => 'Bike', 2 => 'Helmet'] as $productId => $expected) {
        $stmt->execute();
        $names = $stmt->fetchAll(PDO::FETCH_COLUMN);
        if ($names !== [$expected]) {
            throw new RuntimeException('Expected exactly one matching product.');
        }
        echo $names[0], PHP_EOL;
        $stmt->closeCursor();
    }
} finally {
    $stmt = null;
    $pdo = null;
}

Jedes Beispiel druckt:

Bike
Helmet

Werte in einem Array, das an PDO's execute() übergeben wird, werden als PDO::PARAM_STR behandelt. Wenn SQL einen ganzzahligen Parameter verlangt, wie zum Beispiel eine parametrisierte TOP Zählung, rufen Sie bindValue() mit PDO::PARAM_INT auf und rufen Sie dann execute() ohne Array auf.

Werte binden, ohne die Abfrage zu ändern

Ein Parametermarker stellt einen Wert dar, nicht einen Tabellennamen, Spaltennamen, Schlüsselwort oder Sortierrichtung. Setze keine Anführungszeichen um ?. Für eine dynamische Kennung oder ASC/DESC, wählen Sie aus einer von der Anwendung gesteuerten Erlaubnisliste aus, anstatt nicht vertrauenswürdigen Text zu verketten. Für eine IN Liste gib pro Wert einen Marker an.

Halten Sie die referenzierten Variablen aktiv, während Sie die vorbereitete Anweisung ausführen. Das SQLSRV-Programm ändert die gebundene Variable, anstatt das Parameterarray zu ersetzen. Das PDO-Programm ruft execute() nach der Bindung bewusst ohne Array auf; mischen Sie dieses Muster nicht mit arraybasierter Ausführung.

Ausgabewerte aus gespeicherten Prozeduren erfordern eine eigene Handhabung, einschließlich des Abschlusses der Prozedurergebnisse. Schließen Sie das Verhalten der Ausgabeparameter nicht aus diesen reinen Eingabebeispielen ab. Weitere Informationen finden Sie unter Verwendung von Richtungsparametern.

Ausführungs- und Fetch-Verhalten konfigurieren

Die Beispiele liefern wenige Ergebnisse. fetchAll() lädt jede Zeile in den PHP-Speicher; benutze eine Fetch-Schleife für ein großes Ergebnis. Eine Abfrage, die keine Übereinstimmungen liefert, ist kein Ausführungsfehler. SQLSRV meldet das Ende des Resultsets als null von sqlsrv_fetch_array(); PDO meldet es als false von fetch(). Ein SQL NULL innerhalb einer abgerufenen Zeile bleibt PHP null.

Verwende keine Zeilenzählung SELECT als einzigen Erfolgscheck. Nur-vorwärts-Cursor bieten nicht die gleichen Zeilenzählfunktionen wie gepufferte oder scrollbare Cursor. Holen und zählen Sie die benötigten Zeilen oder verwenden Sie eine separate COUNT Abfrage. Für cursorspezifische Optionen und Einschränkungen siehe Einen Cursortyp angeben und Zeilen auswählen.

Fehler und Abschlussergebnisse behandeln

Überprüfen Sie SQLSRV-Vorbereitungs-, Ausführungs- und Abrufvorgänge getrennt. Ein erfolgreiches Vorbereiten beweist nicht, dass die Ausführung erfolgreich sein wird: Der Server kann Parameterwerte, Berechtigungen oder die Anweisung zur Ausführungszeit ablehnen. Erfassen Sie sqlsrv_errors() sofort, wenn eine Operation false zurückgibt. SQLSRV behandelt viele Warnungen standardmäßig als Fehler, daher inspizieren Sie die vollständige Sammlung.

Bei PDO werfen Verbindungsausfälle und Datenbankfehler im Ausnahmemodus PDOException. Überprüfen Sie dessen SQLSTATE- und Treiberfehlerinformationen in geschützten Anwendungsdiagnostiken; geben Sie keinen Ausnahmetext oder keine Zugangsdaten in einer HTTP-Antwort zurück. prepare() Das erfolgreiche Ausführen ist kein Beweis dafür, dass die Anweisung bereits ausgeführt wurde.

Die Beispiele geben ihre Anweisungen frei und schließen ihre Verbindungen in finally. Sie beginnen keine Transaktion. Verwenden Sie eine explizite Transaktion , wenn mehrere Schreibvorgänge entweder gemeinsam committen müssen oder alle zurückgerollt werden müssen. Die Wiederverwendung eines Prepared Statement gruppiert die Schreibvorgänge nicht zu einer Transaktion.

Unterschiede zwischen Zielplattform und Implementierung

Die Prepare/Execute-APIs und PHP-Referenzregeln gehören zu den Erweiterungen und PHP/PDO. Das SQL-Ziel entscheidet, welche T-SQL-Anweisungen und -Typen unterstützt werden, und ODBC führt die zugrunde liegende Kommunikation durch. Eine einmalige Vorbereitung kann wiederholte Arbeit reduzieren, garantiert aber keinen bestimmten Serverausführungsplan oder eine Beschleunigung.

Die Eingabebindungsmuster gelten für SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance, Azure Synapse Analytics, SQL Database in Microsoft Fabric und Warehouse in Microsoft Fabric. Diese Programme verwenden SQL-Authentifizierung bei SQL Server. Für das Azure-Onboarding bevorzugen Sie die Microsoft Entra-Authentifizierung. Beide Fabric-Produkte erfordern dies, und Warehouse erfordert außerdem das Deaktivieren von Multiple Active Result Sets (MARS). Überprüfen Sie die Unterstützung des ausgewählten Ziels für Schemaänderungen, Transaktionen und gespeicherte Prozeduren, bevor Sie SQL Server-Code wiederverwenden. Für Unterschiede bei Endpunkten und Authentifizierung siehe Azure- und Fabric-Verbindungen.

Verwandte Inhalte

• SQLSRV-Treiber-API-Referenz
• PDO_SQLSRV Treiberreferenz
• Programmieranleitung für die Microsoft-Treiber für PHP für SQL Server