mitmario.dev

Ändern und löschen

PHP Sandbox 4 Min Lesezeit 4 BeispieleLektion 5 von 9

Abhaken lässt sich auch eine Notiz, deren Nummer es gar nicht gibt. Für die Datenbank ist das kein Fehler. Das UPDATE läuft durch und trifft nichts, und wenn du nicht nachfragst, hältst du die Notiz für erledigt.

INSERT, UPDATE und DELETE ändern etwas an einer Tabelle, und sie laufen alle gleich. Vorbereitet wird mit prepare(), die Werte gehen an execute(), und danach fragt man nach, was passiert ist. Werte kommen auch hier nur über Platzhalter hinein. Ohne Ausnahme.

INSERT INTO notizen (titel) VALUES (:titel) legt an, UPDATE notizen SET erledigt = 1 WHERE id = :id ändert, und DELETE FROM notizen WHERE id = :id entfernt. Nach einem INSERT willst du meistens die Nummer der neuen Zeile wissen. Nach UPDATE und DELETE willst du wissen, ob überhaupt etwas getroffen wurde.

Die Nummer der neuen Zeile

Einfügen, und die Nummer, die dabei herauskommt
<?php

declare(strict_types=1);

// Einfuegen, und die Nummer, die dabei herauskommt.

require __DIR__ . "/vorbereiten.php";

$einfuegen = $db->prepare("INSERT INTO notizen (titel) VALUES (:titel)");

$einfuegen->execute([":titel" => "Zucker"]);

echo "Die neue Nummer ist: ";
var_dump($db->lastInsertId());

echo "Als Zahl gebraucht, also mit (int) davor: ";
var_dump((int) $db->lastInsertId());

$einfuegen->execute([":titel" => "Mehl"]);
$einfuegen->execute([":titel" => "Salz"]);

echo "\nNach zwei weiteren steht dort die letzte, nicht die erste:\n";
echo "  ", $db->lastInsertId(), "\n";

echo "\nUnd nach einem UPDATE steht dort immer noch dieselbe Zahl:\n";
$db->prepare("UPDATE notizen SET erledigt = 1 WHERE id = :id")->execute([":id" => 1]);
echo "  ", $db->lastInsertId(), "\n";

$db->lastInsertId() gibt die Nummer der zuletzt eingefügten Zeile zurück. Die brauchst du zum Beispiel, um gleich danach auf die neue Notiz weiterzuleiten, um sie in einer zweiten Tabelle zu verknüpfen oder um sie dem Nutzer zu nennen.

Der Rückgabewert ist ein Text und keine Zahl, im var_dump steht string(1) "4". Eine Datenbank kann auch Schlüssel vergeben, die in keine ganze Zahl von PHP passen, und deshalb kommt Text zurück. Brauchst du eine Zahl, schreibst du (int) davor.

Ohne declare(strict_types=1) ginge es auch ohne das (int). Eine Funktion mit dem Rückgabetyp int nähme dann den Text "4" klaglos an und machte selbst eine 4 daraus, denn PHP wandelt zwischen Zahl und Zahlentext hin und her. Mit strict_types, wie in den Dateien dieses Kurses, wird daraus ein TypeError. Mit dem (int) sieht man außerdem, dass hier eine Umwandlung passiert, statt sie PHP zu überlassen.

Und „zuletzt“ heißt wirklich zuletzt. Nach drei eingefügten Zeilen steht dort die Nummer der dritten. Brauchst du alle drei Nummern, holst du jede direkt nach ihrem execute() ab. Ein UPDATE dazwischen ändert den Wert übrigens nicht, dort wird ja nichts eingefügt.

Hat das etwas getroffen?

Wie viele Zeilen hat das getroffen?
<?php

declare(strict_types=1);

// Wie viele Zeilen hat das getroffen?

require __DIR__ . "/vorbereiten.php";

$erledigen = $db->prepare("UPDATE notizen SET erledigt = 1 WHERE id = :id");

$erledigen->execute([":id" => 2]);
echo "UPDATE auf Notiz 2:   ", $erledigen->rowCount(), "\n";

$erledigen->execute([":id" => 2]);
echo "Noch einmal dieselbe: ", $erledigen->rowCount(), "\n";

$erledigen->execute([":id" => 99]);
echo "UPDATE auf Notiz 99:  ", $erledigen->rowCount(), "\n";

$loeschen = $db->prepare("DELETE FROM notizen WHERE id = :id");
$loeschen->execute([":id" => 3]);
echo "DELETE auf Notiz 3:   ", $loeschen->rowCount(), "\n";

$alle = $db->query("SELECT * FROM notizen");

echo "\nUnd bei einem SELECT:\n";
echo "  rowCount() sagt:  ", $alle->rowCount(), "\n";
echo "  wirklich da sind: ", count($alle->fetchAll()), "\n";

$stmt->rowCount() sagt nach einem UPDATE oder DELETE, wie viele Zeilen betroffen waren. Meistens ist die Antwort 1. Wichtig ist der Fall, in dem sie 0 ist. Dann gab es die Zeile nicht, und das Programm sollte nicht so tun, als hätte es geklappt.

In der zweiten Zeile des Beispiels wird dieselbe Notiz noch einmal auf erledigt gesetzt, und dort steht trotzdem 1. Bei SQLite zählt rowCount() die Zeilen, auf die das WHERE gepasst hat, und nicht die, in denen sich ein Wert wirklich geändert hat. Meistens ist das auch die Zahl, die du haben willst. Erwartet hättest du vielleicht eine andere.

Nach einem SELECT ist rowCount() bei SQLite nutzlos. Im Beispiel sagt es 0, obwohl zwei Zeilen da sind. Die Zahl der Treffer liefert count($stmt->fetchAll()). Brauchst du die Zeilen gar nicht, nimmst du eine eigene Abfrage SELECT count(*) FROM ....

Das vergessene WHERE

Ein vergessenes WHERE
<?php

declare(strict_types=1);

// Ein vergessenes WHERE, und die zweite Tabelle zeigt die Folgen.

require __DIR__ . "/vorbereiten.php";

function zeigen(PDO $db, string $wann): void
{
    echo $wann, "\n";

    foreach ($db->query("SELECT id, titel, erledigt FROM notizen ORDER BY id") as $zeile) {
        echo "  ", $zeile["id"], "  ", str_pad($zeile["titel"], 8), "erledigt=", $zeile["erledigt"], "\n";
    }

    echo "\n";
}

zeigen($db, "Vorher:");

$db->exec("UPDATE notizen SET erledigt = 1");

zeigen($db, "Nach UPDATE notizen SET erledigt = 1 ohne WHERE:");

UPDATE notizen SET erledigt = 1 ohne WHERE ist eine vollkommen gültige Anweisung. Sie setzt erledigt in jeder Zeile auf 1. SQLite fragt nicht nach, es gibt keine Warnung, und rückgängig machen lässt es sich nicht. Dasselbe gilt für DELETE FROM notizen, nur ist danach die ganze Tabelle leer.

Ich schreibe das WHERE zuerst und den SET-Teil danach, dann kann es nicht fehlen. Und eine Änderung, bei der ich unsicher bin, fahre ich vorher als SELECT mit demselben WHERE.

Vergessen wird das WHERE zum Beispiel, wenn jemand eine Anweisung in einem Datenbankwerkzeug zusammenbaut und zu früh auf Ausführen klickt. Im Code passiert es, wenn das WHERE aus einer Bedingung entsteht und die Variable dafür leer ist.

Löschen, oder lieber doch nicht

Wirklich löschen, oder nur als gelöscht markieren
<?php

declare(strict_types=1);

// Wirklich loeschen, oder nur als geloescht markieren.

require __DIR__ . "/vorbereiten.php";

$db->exec("ALTER TABLE notizen ADD COLUMN geloescht_am TEXT");

echo "Wirklich löschen. Danach ist die Zeile weg:\n";

$db->prepare("DELETE FROM notizen WHERE id = ?")->execute([1]);

echo "  Zeilen in der Tabelle: ", $db->query("SELECT count(*) FROM notizen")->fetchColumn(), "\n";
echo "  Notiz 1 noch da:       ";
var_dump($db->query("SELECT * FROM notizen WHERE id = 1")->fetch());

echo "\nAls gelöscht markieren. Die Zeile bleibt, die Liste wird kürzer:\n";

$db->prepare("UPDATE notizen SET geloescht_am = ? WHERE id = ?")->execute(["2026-08-29", 2]);

echo "  Zeilen in der Tabelle: ", $db->query("SELECT count(*) FROM notizen")->fetchColumn(), "\n";
echo "  Zeilen in der Liste:   ", $db->query("SELECT count(*) FROM notizen WHERE geloescht_am IS NULL")->fetchColumn(), "\n";
echo "  Notiz 2 sagt:          gelöscht am ", $db->query("SELECT geloescht_am FROM notizen WHERE id = 2")->fetchColumn(), "\n";

DELETE entfernt die Zeile, und danach ist sie weg. Oft ist das auch richtig. In einer Anwendung, die Menschen benutzen, ist es öfter mal falsch, denn jemand löscht versehentlich, jemand will wissen, was letzte Woche in der Liste stand, oder eine zweite Tabelle verweist noch auf die Zeile.

Der übliche Ausweg heißt Soft Delete und ist einfacher, als der Name klingt. Statt zu löschen, wird eine Spalte gesetzt, etwa geloescht_am. Die Zeile bleibt liegen. Überall dort, wo die Liste angezeigt wird, kommt WHERE geloescht_am IS NULL dazu.

Der Haken daran ist, dass diese Bedingung nirgends fehlen darf. Sonst tauchen gelöschte Einträge wieder auf. Für die Notizliste bleibe ich deshalb beim echten DELETE. Für Rechnungen, Bestellungen und alles, was jemand nachvollziehen können muss, ist die Spalte die bessere Wahl.

Auf einen leeren Wert prüft SQL mit IS NULL und nicht mit = NULL. Ein Vergleich mit NULL ergibt weder wahr noch falsch, sondern wieder NULL, und damit trifft WHERE spalte = NULL keine einzige Zeile.

In der Aufgabe legt eine Funktion an, eine hakt ab und eine löscht.

Zum Mitnehmen

INSERT, UPDATE und DELETE laufen wie jede Abfrage mit Platzhaltern. lastInsertId() nennt die neue Nummer als Text, rowCount() die Zahl der getroffenen Zeilen, und ein UPDATE ohne WHERE trifft alle.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.