Barcode
Zend_Validate_Barcode erlaubt es zu prüfen ob ein gegebener Wert als
Barcode repräsentiert werden kann.
Zend_Validate_Barcode unterstützt viele Barcode Standards und kann
sehr einfach mit prorietären Barcode Implementationen erweitert werden. Die folgenden
Barcode Standards werden unterstützt:
CODE25: Oft auch "Two of Five" genannt.
Dieser Barcode hat keine Begrenzung der Länge, muss aber eine gerade Anzahl an
Zeichen enthalten. Es unterstützt nur Ziffern, und die letzt Ziffer kann eine
optionale Checksumme sein welche durch Modulo 10 berechnet wird. Dieser Standard
wird weltweit verwendet und üblicherweise im Handel.
CODE39: CODE39 ist einer der ältesten vorhandenen Codes.
Dieser Barcode hat eine variable Länge. Er unterstützt Ziffern, alphabetische
Zeichen und 7 spezielle Zeichen. Er kann eine optionale Checksumme enthalten welche
durch Modulo 43 berechnet wird. Dieser Standard wird weltweit verwendet und
üblicherweise in der Industrie.
CODE93: CODE93 ist der Nachfolger von CODE39.
Dieser Barcode hat eine variable Länge. Er unterstützt Ziffern, alphabetische
Zeichen und 7 spezielle Zeichen. Er enthält eine Checksumme welche durch Modulo 47
berechnet wird und aus 2 Zeichen besteht. Dieser Standard produziert einen
kompakteren Code als CODE39 und ist sicherer.
EAN8: EAN ist die Abkürzung für "European Article Number".
Dieser Barcode muss eine Länge von 8 Zeichen haben. Er unterstützt nur Ziffern wobei
die letzte Ziffer immer eine Checksumme ist. Dieser Standard wird weltweit
verwendet, hat aber eine sehr begrenzte Reichweite. Er kann auf kleinen Artikeln
gefunden werden wo ein längerer Barcode nicht gedruckt werden könnte.
EAN12: EAN ist die Abkürzung für "European Article Number".
Dieser Barcode muss eine Länge von 12 Zeichen haben. Er unterstützt nur Ziffern
wobei die letzte Ziffer immer eine Checksumme ist welche durch Modulo 10 berechnet
wird. Dieser Standard wird in der USA verwendet und hierbei üblicherweise im Handel.
Er wurde ersetzt durch EAN13.
EAN13: EAN ist die Abkürzung für "European Article Number".
Dieser Barcode muss eine Länge von 13 Zeichen haben. Er unterstützt nur Ziffern
wobei die letzte Ziffer immer eine Checksumme ist welche durch Modulo 10 berechnet
wird. Dieser Standard wird weltweit verwendet, üblicherweise im Handel.
EAN14: EAN ist die Abkürzung für "European Article Number".
Dieser Barcode muss eine Länge von 14 Zeichen haben. Er unterstützt nur Ziffern
wobei die letzte Ziffer immer eine Checksumme ist welche durch Modulo 10 berechnet
wird. Dieser Standard wird weltweit verwendet, üblicherweise im Handel. Er ist der
Nachfolger von EAN13.
GTIN12: GTIN ist die Abkürzung für "Global Trade Item Number".
Dieser Barcode verwendet den gleichen Standard wie EAN12 und ist sein Nachfolger.
Er wird üblicherweise in den USA verwendet.
GTIN13: GTIN ist die Abkürzung für "Global Trade Item Number".
Dieser Barcode verwendet den gleichen Standard wie EAN13 und ist sein Nachfolger.
Er wird weltweit von der Industrie verwendet.
GTIN14: GTIN ist die Abkürzung für "Global Trade Item Number".
Dieser Barcode verwendet den gleichen Standard wie EAN14 und ist sein Nachfolger.
Er wird weltweit verwendet, üblicherweise im Handel.
ITF14: ITF14 ist die GS1 Implementation des Interleaved Two of
Five Barcodes.
Dieser Barcode ist eine spezielle Variante von Interleaved 2 of 5. Er muss eine
Länge von 14 Zeichen haben und basiert auf GTIN14. Er unterstützt nur Ziffern wobei
die letzte Ziffer die Ziffer einer Checksumme ist welche durch Modulo 10 berechnet
wird. Er wird weltweit verwendet, üblicherweise im Handel.
SSCC: SSCC ist die Abkürzung für "Serial Shipping Container
Code".
Dieser Barcode ist eine Variante des EAN Barcodes. Er muss eine Länge von 18 Zeichen
enthalten und unterstützt nur Ziffern. Die letzte Ziffer muss ein Ziffer für eine
Checksumme sein welche durch Modulo 10 berechnet wird. Er wird üblicherweise in der
Transport Industrie verwendet.
UPCA: UPC ist die Abkürzung für "Univeral Product Code".
Dieser Barcode ist der Vorgänger von EAN13. Er muss eine Länge von 12 Zeichen haben
und unterstützt nur Ziffern. Die letzte Ziffer muss die Ziffer einer Checksumme sein
welche durch Modulo 10 berechnet wird. Er wird üblicherweise in den USA verwendet.
UPCE: UPCE ist die kurze Variante von UPCA.
Dieser Barcode ist die kleinere Variante von UPCA. Er muss eine Länge von 6 Zeichen
haben und unterstützt nur Ziffern. Es gibt keine Checksumme in diesem Barcode. Er
wird üblicherweise bei kleinen Produkten verwendet wo ein UPCA Barcode nicht passen
würde.
Grundsätzliche Verwendung
Um zu prüfen ob ein angegebener String ein Barcode ist muss man nur dessen Typ wissen.
Siehe das folgende Beispiel für einen EAN13 Barcode:
isValid($input)) {
// Die Eingabe scheint gültig zu sein
} else {
// Die Eingabe ist ungültig
}
]]>
Optionale Checksumme
Einige Barcodes können mit einer optionalen Checksumme angegeben werden. Diese Barcodes
würden gültig sein, selbst ohne Checksumme. Trotzdem, wenn eine Checksumme angegeben
wird, dann sollte man Sie auch prüfen. Standardmäßig führen diese Barcode Typen keine
Prüfung der Checksumme durch. Durch Verwendung der Option checksum
kann man definieren ob die Checksumme geprüft oder ignoriert wird.
'EAN13',
'checksum' => false,
));
if ($valid->isValid($input)) {
// Die Eingabe scheint gültig zu sein
} else {
// Die Eingabe ist ungültig
}
]]>
Reduzierte Sicherheit durch ausgeschaltete Prüfung der Checksumme
Indem die Prüfung der Checksumme ausgeschaltet wird, verringert man auch die
Sicherheit der verwendeten Barcodes. Zusätzlich sollte man beachten dass man
die Prüfung der Checksumme für jene Barcode Typen ausschalten kann welche einen
Wert für die Checksumme enthalten müssen. Barcodes welche nicht gültig wären
könnten dann als gültig zurückgegeben werden, selbst wenn Sie es nicht sind.
Schreiben eigener Adapter
Man kann eigene Barcode Prüfungen für die Verwendung mit
Zend_Validate_Barcode schreiben; das ist oft notwendig wenn man
mit proprietären Barcodes arbeiten muss. Um eine eigene Barcode Prüfung zu schreiben
benötigt man die folgenden Informationen.
Length: Die Länge welche der Barcode haben muss. Diese kann
einen der folgenden Werte haben:
Integer: Ein Wert größer als 0, was bedeutet das
der Barcode diese Länge haben muss.
-1: Es gibt keine Begrenzung der Länge für diesen
Barcode.
"even": Die Länge dieses Barcodes muss eine gerade
Anzahl an Ziffern enthalten.
"odd": Die Länge dieses Barcodes muss eine ungerade
Anzahl an Ziffern enthalten.
array: Ein Array von Integer Werten. Die Länge
dieses Barcodes muss einer der gesetzten Array Werte haben.
Characters: Ein String der die erlaubten Zeichen für diesen
Barcode enthält. Auhc der Integer Wert 128 ist erlaubt, was für die ersten 128
Zeichen der ASCII Tabelle steht.
Checksum: Ein Strung der als Callback für eine Methode
verwendet wird, welche die Prüfung der Checksumme durchführt.
Die eigene Barcode Prüfung muss
Zend_Validate_Barcode_AdapterAbstract erweitern oder
Zend_Validate_Barcode_AdapterInterface implementieren.
Als Beispiel, erstellen wir eine Prüfung welche eine gerade Anzahl an Zeichen erwartet
welche alle Ziffern und die Zeichen 'ABCDE' enthalten kann, und die eine Checksumme
benötigt.
isValid($input)) {
// Die Eingabe scheint gültig zu sein
} else {
// Die Eingabe ist ungültig
}
]]>