Alle Artikel
PHPE-CommerceRefactoringUXLogistik

Saubere Adressdaten im E-Commerce: Trennung von Straße & Hausnummer über 16 PHP-Dateien

Doppelte Hausnummern durch Browser-Autofill, verrutschte PLZ auf Versandlabels und keine Änderung an der Datenbank-Struktur: Wie ich Straße und Hausnummer im Frontend getrennt und über 16 PHP-Dateien sauber normalisiert habe.

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

  1. Kein address-line1 / address-line2: Auf beiden getrennten Feldern darf niemals dieses Autofill-Attribut sitzen.
  2. 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-6 oder Stiege/Tür-Angaben wie 12/3/4.
  • Postleitzahlen: 5 Ziffern für Deutschland (DE), 4 Ziffern zwischen 1010 und 9992 fü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.

Alle Artikel26. August 2026