Saubere Adressdaten im E-Commerce: Trennung von Straße & Hausnummer über 16 PHP-Dateien
Jeder Online-Shop-Betreiber kennt dieses alltägliche Problem: Im Standard-Checkout gibt es ein einziges Textfeld für die Straße. Kunden tippen ihre Adresse ein – mal ohne Hausnummer, mal mit Komma, mal verdreht – und bei der Übergabe an Versanddienstleister passiert genau das, was zu Retouren führt: doppelte Hausnummern oder abgeschnittene Angaben auf dem gedruckten Versandlabel.
Ende August 2026 habe ich die Erfassung komplett auf zwei getrennte Felder umgestellt – ohne die bestehende Datenbank- oder Warenwirtschafts-Schnittstelle umbauen zu müssen.
1. Die Herausforderung: Zwei Felder vorne, ein Feld hinten
In der Datenbank (address_book, orders) sowie in der angebundenen Warenwirtschaft existiert nur ein einziges Feld für die Straßenzeile (street_address). Eine Änderung des Datenbank-Schemas hätte sofort alle Export- und Synchronisationsprozesse zerschossen.
Die Architektur-Entscheidung war deshalb klar: Splitting und Zusammenführen passieren ausschließlich im PHP-Code.
- Beim Speichern: Straße und Hausnummer werden getrennt validiert, normalisiert und erst direkt vor dem DB-Write wieder sauber kombiniert.
- Beim Bearbeiten (Altdaten): Bestehende Adressen aus der Datenbank werden beim Laden automatisch auf die beiden Felder aufgeteilt.
2. Die tückische Browser-Autofill-Falle
Bei der Umsetzung stolperte ich über ein klassisches Browser-Problem: Gibt man dem Straßenfeld das Standard-HTML-Attribut autocomplete="address-line1", füllen Chrome oder Safari dort die komplette Zeile inklusive Hausnummer ein (z. B. "Musterstraße 15") – und schreiben dieselbe Zahl gleichzeitig ins Hausnummern-Feld ("15").
Fügt das Backend beides blind zusammen, entsteht exakt die Dublette, die man verhindern wollte: "Musterstraße 15 15".
Meine Lösung auf zwei Ebenen
- Kein
address-line1/address-line2: Auf beiden getrennten Feldern darf niemals dieses Autofill-Attribut sitzen. - Serverseitige Normalisierung: Eine zentrale Funktion prüft vor dem Speichern, ob die Hausnummer bereits am Ende des Straßennamens steht, und bereinigt Duplikate automatisch – mit einer wichtigen Ausnahme: Straßen, bei denen die Zahl zum Namen gehört (wie "Straße 14" oder "B 27"), bleiben unangetastet.
3. Länder-Validierung (DE & AT) und Bestandskunden-Schutz
Zusätzlich habe ich präzise Regeln eingebaut:
- Straße: Muss echte Buchstaben enthalten – reine Zahlenangaben (typische Verwechslung mit der PLZ) werden sofort abgefangen.
- Hausnummer: Erlaubt deutsche und österreichische Formate wie
12,12a,2-6oder Stiege/Tür-Angaben wie12/3/4. - Postleitzahlen: 5 Ziffern für Deutschland (
DE), 4 Ziffern zwischen1010und9992für Österreich (AT). - Checkout-Guard für Altkunden: Bestandskunden haben oft noch Alt-Adressen ohne Hausnummer gespeichert. Ein Checkout-Guard prüft bei jedem Bestellschritt, ob eine gültige Hausnummer vorhanden ist, und leitet bei Bedarf direkt zur Korrektur weiter.
4. Refactoring über 16 PHP-Dateien
Damit die neue Logik wirklich durchgängig greift, mussten 16 PHP-Dateien angepasst werden – von einer zentralen Funktionsdatei über Sprachkonstanten bis zu sämtlichen Controllern und Smarty-Templates:
- Kunden-Registrierung und Gast-Checkout
- Kunden-Adressbuch und Kontobearbeitung
- Checkout-Adressprüfung und Checkout-Speicherung
- Admin-Bestellbearbeitung und E-Mail-/Druckausgabe
Seit der Umstellung gehören doppelte Hausnummern und fehlende Angaben auf den Versandlabels der Vergangenheit an.