EAN-8 en PHP
Zoals je in mijn vorige blogpost over EAN-13 kon lezen, heb ik een class in PHP geschreven waarmee je zelf EAN-13 barcodes kunt genereren. Nadat ik de code met jullie had gedeeld voelde ik gelijk de noodzaak om ook EAN-8 te implementeren. De hoofdreden? Omdat EAN-8 zoveel lijkt op EAN-13! Dat zou dus inhouden dat de uitbreiding niet al te moeilijk moet zijn, nietwaar?
EAN-13 versie 1.01
Toen ik de code van EAN-13 aandachtig bekeek besefte ik mij dat deze welliswaar een hoop functies bevat die ik in EAN-8 zou gebruiken, maar dat hij toch niet flexibel genoeg was om gelijk te kunnen gebruiken. Ik zou natuurlijk simpelweg de code kunnen kopiëren en waarnodig aanpassen, maar dan maak je niet optimaal gebruik van de mogelijkheden van classes. Ik besloot derhalve om eerst EAN-13 te modificeren zodat deze ook voor EAN-8 gebruikt zou kunnen worden.
Aan de abstract-class heb ik de volgende properties toegevoegd:
1 2 3 4 5 6 7 8 9 10 11 12
<?php
abstract class digitBarCodes {
//A single bitArray
protected $leftGuard = array();
//A single bitArray
protected $rightGuard = array();
//Array containing bitArray(s)
protected $centerGuards = array();
protected $barcodeGuardLength = 50;
protected $barcodeLength = 40;
/* Rest staat hieronder gewoon */
Deze modificaties zijn nodig omdat wij de guards (aan 't begin van de barcode, halverwege en aan 't einde van de barcode) pas in de generateBarcodeImage-functie zullen gebruiken. Dit zodat we de guards langer kunnen maken dan de andere code. De belangrijkste reden is dat we later de code in cijfers onder de barcode kunnen printen zodat mensen de code kunnen intypen als de barcode niet werkt. Dit om te voldoen aan de "echte" standaard.
Verder zie je dat ik de lengte van de barcode en de guards hier specificeer zodat je deze later indien nodig gemakkelijk kunt verlengen.
generateBarcodeImage revised
Uiteraard hebben we nu een nieuwe generateBarcodeImage-functie nodig. Deze functie is gemodificeert t.o.v. de vorige versie in de zin dat de guards nu apart worden getekend, zodat deze in een andere lengte getekend kunnen worden. De $imageWidth berekening die we voorheen hadden hebben we ook aangepast zodat de afbeelding in elk geval breed genoeg is om de hele barcode te kunnen printen.
Bovendien is deze functie nu subtiel gewijzigd om een door mij ontdekte bug tegen te gaan. De vorige versie was zo gemaakt worden dat als de $size-parameter groot genoeg was, er een deel van de eerste streep kan missen. Hierdoor zou mogelijkerwijs de eerste lijn kunnen wegvallen, waardoor de barcode onbruikbaar is. Daarom gebruik ik nu $xPos+$size. De barcode schuift hierdoor in z'n geheel naar rechts. Ik heb hier uiteraard rekening mee gehouden bij de $imageWidth-berekening, om te voorkomen dat nu de laatste lijn zou kunnen wegvallen.
De gereviseerde code is als volgt:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
<?php
public function generateBarcodeImage($bitArray, $size=1) {
$imageWidth = count($bitArray, COUNT_RECURSIVE) - count($bitArray);
$imageWidth += count($this->leftGuard);
$imageWidth += count($this->centerGuards, COUNT_RECURSIVE) - count($this->centerGuards);
$imageWidth += count($this->rightGuard);
$imageWidth += $size;
$image = imagecreate(($imageWidth * $size), ($this->barcodeGuardLength * $size));
imagecolorallocate($image, 255, 255, 255); // White background
$imColorBarcode = imagecolorallocate($image, 0, 0, 0); // Black color
$xPos = 0;
foreach ($this->leftGuard AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeGuardLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
foreach ($bitArray AS $index => $bitArray) {
foreach ($bitArray AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
if (isset($this->centerGuards[$index])) {
foreach ($this->centerGuards[$index] AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeGuardLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
}
}
foreach ($this->rightGuard AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeGuardLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
return $image;
}
De toevoeging noodzakelijk om de EAN13Barcode-class te laten functioneren stammen af van de hierboven genoemde wijzigingen. Ik geef ze derhalve zonder hier al te veel over uit te leggen, maar lees anders het commentaar in de code zelf.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
<?php
class EAN13Barcode extends digitBarCodes {
protected $codeLengthNoCheckum = 12;
protected $codeLength = 1;
protected $leftGuard = array(1, 0, 1);
protected $rightGuard = array(1, 0, 1);
protected $centerGuards = array(5 => array(0, 1, 0, 1, 0));
protected $encodeStartDigit = 1;
/* codeLookupTable en alle methods staan hier */
/* (...) */
/*De getBitarray functie is nu voorzien van een optionele parameter
waarmee je een bitArray krijgt zonder de guards, wat nodig is voor
de generateBarcodeImage. Die functie voegt namenlijk zelf
de guards toe op de juiste locatie */
public function getBitarray($code, $includeGuards=true) {
$code = $this->getValidatedCode($code);
if ($code == false) {
return false;
}
$return = array();
if ($includeGuards) {
$return[] = $this->leftGuard;
}
$structureMask = str_split($this->getStructureMask($code));
foreach (str_split(substr($code, $this->encodeStartDigit)) AS $index => $digit) {
$return[] = $this->encode($digit, $structureMask[$index]);
if (isset($this->centerGuards[$index]) AND $includeGuards) {
$return[] = $this->centerGuards[$index];
}
}
if ($includeGuards) {
$return[] = $this->rightGuard;
}
return $return;
}
}
Verder heb alle functies van "private" naar "protected" gezet zodat eventuele extending classes deze kunnen overrulen.
En dan nu: EAN-8
Door het voorwerk wat wij hebben gedaan, is het schrijven van de EAN-8 class zeer simpel geworden. We zullen de nieuwe class extenden vanuit de EAN13Barcode class, met een aantal andere properties:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
<?php
class EAN8Barcode extends EAN13Barcode {
protected $codeLengthNoCheckum = 7;
protected $codeLength = 1;
protected $centerGuards = array(3 => array(0, 1, 0, 1, 0));
protected $encodeStartDigit = 0;
protected function getStructureMask($code) {
if (!ctype_digit($code)) {
return false;
}
return 'LLLLRRRR';
}
}
Echt waar, zo simpel is 't nu om EAN-8 te implementeren nu we EAN-13 al gedaan hebben. Je ziet dat we de properties anders ingesteld hebben en een nieuwe getStructureMask-functie geschreven. Dit is genoeg om een legitieme EAN-8 code te genereren, echt waar! Probeer maar!
Het resultaat
De gehele code (v1.01):
ean8-13.class.php
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426
<?php
/**
* Barcode abstract
*
* @author Floris Luiten <www.florisluiten.nl>
* @package DigitBarCodes
* @version $Id: digitbarcodes (abstract.php), v1.01 2011/02/12 $
* @copyright Please contact author for copyright information, but
* in general these rules apply:
*
* - Want to use this code to learn how to write your own
* classes or teach others how to code? Go ahead! Please
* give me credits in a proper way. Also, I'd love to hear
* your from you how you used this code.
*
* - Want to use this code to generate a library for personal
* use? Please, go ahead! I'd love to hear from you how
* this code helped you and where you have applied it.
*
* - Want to make money off this code? Please don't do that
* without consulting me first. If you really don't want
* to contact me for whatever reason, donate a FAIR amount
* to charity, in relation to how much money you make.
*/
/**
* Abstract class for barcodes containing digits only
*
* @package DigitBarCodes
* @author Floris Luiten <www.florisluiten.nl>
* @abstract
*/
abstract class digitBarCodes {
/**
* The bitArray for the left guard
* @access protected
* @var array
*/
protected $leftGuard = array();
/**
* The bitArray for the right guard
* @access protected
* @var array
*/
protected $rightGuard = array();
/**
* A multi-dimensional array containing the center guards.
*
* @example array(4 => (1, 0, 1)) Will insert the guard 101 at
* position 4
* @access protected
* @var array
*/
protected $centerGuards = array();
/**
* Declares the height of a guard
* @access protected
* @var integer
*/
protected $barcodeGuardLength = 50;
/**
* Declares the height of a regular bar
* @access protected
* @var integer
*/
protected $barcodeLength = 40;
/**
* Dummy function for returning the checksum based on the
* code. Returns false if no checksum could be generated
*
* @param integer The code
* @return integer|False The checksum as digit or False
* when no checksum could be created
*/
abstract public function calculateChecksum($code);
/**
* Dummy function to generate a bitArray from the code.
* This bitArray can be used to render the actual
* barcode as an image.
* Returns False when no bitArray could be generated,
* for example when the checksum failed or non-valid
* characters were found.
*
* @param string The code with or without the checksum
* @param array|False A bitArray or False otherwise
*/
abstract public function getBitarray($code);
/**
* Dummy function to return the code if it's valid,
* if no checksum is provided the return will include this
*
* @param string The code to check
* @param string|False The valid code or False otherwise
*/
abstract public function getValidatedCode($code);
/**
* Bitwise NOT on a bitArray (an array containing 0 or 1's)
*
* @param array The bitArray
* @return array The NOT bitArray
*/
public function bitArrayNOT($bits) {
foreach ($bits AS $index => $bit) {
$bits[$index] = 1 ^ $bit;
}
return $bits;
}
/**
* Convert a bitArray to an integer
*
* @param array The bitarray
* @return integer The integer
*/
public function bitArrayToInteger($bits) {
$bitValue = 1;
$sum = 0;
foreach (array_reverse($bits) AS $index => $bit) {
$sum += $bit * $bitValue;
$bitValue *= 2;
}
return $sum;
}
/**
* Function generate the barcode based on the code. It first checks
* the checksum or creates it if it's missing.
*
* @param string The code (with or without the checksum)
* @param integer optional An optional size
*/
public function getBarcodeImage($code, $size=1) {
$code = $this->getValidatedCode($code);
if ($code == false) {
return false;
}
return $this->generateBarcodeImage($this->getBitarray($code, false), $size);
}
/**
* Generates an image containing the barcode to use
* in printing or on screen.
*
* @param array The bitarray containing the code
* @param integer optional An optional size (default: @default)
*/
public function generateBarcodeImage($bitArray, $size=1) {
$imageWidth = count($bitArray, COUNT_RECURSIVE) - count($bitArray);
$imageWidth += count($this->leftGuard);
$imageWidth += count($this->centerGuards, COUNT_RECURSIVE) - count($this->centerGuards);
$imageWidth += count($this->rightGuard);
$imageWidth += $size;
$image = imagecreate(($imageWidth * $size), ($this->barcodeGuardLength * $size));
imagecolorallocate($image, 255, 255, 255); // White background
$imColorBarcode = imagecolorallocate($image, 0, 0, 0); // Black color
$xPos = 0;
foreach ($this->leftGuard AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeGuardLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
foreach ($bitArray AS $index => $bitArray) {
foreach ($bitArray AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
if (isset($this->centerGuards[$index])) {
foreach ($this->centerGuards[$index] AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeGuardLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
}
}
foreach ($this->rightGuard AS $bit) {
if ($bit == 1) {
$this->imagelinethick($image, $xPos+$size, 0, $xPos+$size, ($this->barcodeGuardLength * $size), $imColorBarcode, $size);
}
$xPos += $size;
}
return $image;
}
/**
* Draw a line on the image of a specific width.
*
* @link http://nl.php.net/manual/en/function.imageline.php
*
* @param resource The image resource
* @param integer The x1
* @param integer The y1
* @param integer The x2
* @param integer The y2
* @param resource The color
* @param integer The thickness of the line
* @return boolean True on success, FALSE otherwise
*/
private function imagelinethick($image, $x1, $y1, $x2, $y2, $color, $thick = 1) {
if ($thick == 1) {
return imageline($image, $x1, $y1, $x2, $y2, $color);
}
$t = $thick / 2 - 0.5;
if ($x1 == $x2 || $y1 == $y2) {
return imagefilledrectangle($image, round(min($x1, $x2) - $t), round(min($y1, $y2) - $t), round(max($x1, $x2) + $t), round(max($y1, $y2) + $t), $color);
}
$k = ($y2 - $y1) / ($x2 - $x1);
$a = $t / sqrt(1 + pow($k, 2));
$points = array(
round($x1 - (1+$k)*$a), round($y1 + (1-$k)*$a),
round($x1 - (1-$k)*$a), round($y1 - (1+$k)*$a),
round($x2 + (1+$k)*$a), round($y2 - (1-$k)*$a),
round($x2 + (1-$k)*$a), round($y2 + (1+$k)*$a),
);
imagefilledpolygon($image, $points, 4, $color);
return imagepolygon($image, $points, 4, $color);
}
}
/**
* Class for EAN-13 codes
*
* @package DigitBarCodes
*/
class EAN13Barcode extends digitBarCodes {
protected $codeLengthNoCheckum = 12;
protected $codeLength = 1;
protected $leftGuard = array(1, 0, 1);
protected $rightGuard = array(1, 0, 1);
protected $centerGuards = array(5 => array(0, 1, 0, 1, 0));
protected $encodeStartDigit = 1;
protected $codeLookupTable = array(
'L' => array(
'0' =>
array(0, 0, 0, 1, 1, 0, 1),
'1' =>
array(0, 0, 1, 1, 0, 0, 1),
'2' =>
array(0, 0, 1, 0, 0, 1, 1),
'3' =>
array(0, 1, 1, 1, 1, 0, 1),
'4' =>
array(0, 1, 0, 0, 0, 1, 1),
'5' =>
array(0, 1, 1, 0, 0, 0, 1),
'6' =>
array(0, 1, 0, 1, 1, 1, 1),
'7' =>
array(0, 1, 1, 1, 0, 1, 1),
'8' =>
array(0, 1, 1, 0, 1, 1, 1),
'9' =>
array(0, 0, 0, 1, 0, 1, 1)
));
/**
* Function for returning the checksum based on the input.
* Returns false if no checksum could be generated
*
* @param string The barcode
* @return integer The checksum as digit
*/
public function calculateChecksum($code) {
if (!ctype_digit($code) OR !ctype_digit($code)) {
return false;
}
$sum = 0;
foreach (str_split(strrev($code)) AS $index => $digit) {
//Thank god PHP thinks 1 & 0 == 0
$sum += (1 & $index) ? $digit : $digit * 3;
}
return ($sum % 10 == 0) ? 0 : 10 - ($sum % 10);
}
/**
* Function to generate a bitArray from the code.
* This bitArray can be used to render the actual
* barcode as an image.
*
* @param string The code with or without the checksum
* @param boolean optional Include guards? (default: true)
* @return array|False A bitArray or False otherwise
*/
public function getBitarray($code, $includeGuards=true) {
$code = $this->getValidatedCode($code);
if ($code == false) {
return false;
}
$return = array();
if ($includeGuards) {
$return[] = $this->leftGuard;
}
$structureMask = str_split($this->getStructureMask($code));
foreach (str_split(substr($code, $this->encodeStartDigit)) AS $index => $digit) {
$return[] = $this->encode($digit, $structureMask[$index]);
if (isset($this->centerGuards[$index]) AND $includeGuards) {
$return[] = $this->centerGuards[$index];
}
}
if ($includeGuards) {
$return[] = $this->rightGuard;
}
return $return;
}
/**
* Function to return the code if it's valid, if no if no checksum is
* provided the return will include this
*
* @param string The code to check
* @param string|False The valid code or False otherwise
*/
public function getValidatedCode($code) {
if (!ctype_digit($code) OR !ctype_digit($code)) {
return false;
}
if (strlen($code) == $this->codeLengthNoCheckum) {
return $code . $this->calculateChecksum($code);
} elseif (strlen($code) == ($this->codeLengthNoCheckum + $this->codeLength)) {
if ($this->calculateChecksum(substr($code, 0, (0 - $this->codeLength))) != substr($code, (0 - $this->codeLength))) {
return false;
}
return $code;
}
return false;
}
/**
* Returns the mask to use for the EAN-13 code
*
* @param string The code (with or without the checksum)
* @return string The mask to use
*/
protected function getStructureMask($code) {
if (!ctype_digit($code)) {
return false;
}
switch (substr($code, 0, 1)) {
case '0':
return 'LLLLLLRRRRRR';
case '1':
return 'LLGLGGRRRRRR';
case '2':
return 'LLGGLGRRRRRR';
case '3':
return 'LLGGGLRRRRRR';
case '4':
return 'LGLLGGRRRRRR';
case '5':
return 'LGGLLGRRRRRR';
case '6':
return 'LGGGLLRRRRRR';
case '7':
return 'LGLGLGRRRRRR';
case '8':
return 'LGLGGLRRRRRR';
case '9':
return 'LGGLGLRRRRRR';
}
return false; //Even though we can never actually reach this
}
/**
* Returns the L/G/R-code for the integer for usage with EAN-13
*
* @param integer The integer to encode
* @param string The codebase (R/G/L)
* @return integer The encoded integer
*/
protected function encode($integer, $codeBase) {
if ($codeBase == 'R') {
return $this->bitArrayNOT($this->codeLookupTable['L'][$integer]);
} elseif ($codeBase == 'G') {
return array_reverse($this->bitArrayNOT($this->codeLookupTable['L'][$integer]));
} else {
return $this->codeLookupTable['L'][$integer];
}
}
}
/**
* Class for EAN-8, based on the EAN-13 class
*
* @package DigitBarCodes
*/
class EAN8Barcode extends EAN13Barcode {
protected $codeLengthNoCheckum = 7;
protected $codeLength = 1;
protected $centerGuards = array(3 => array(0, 1, 0, 1, 0));
protected $encodeStartDigit = 0;
/**
* Returns the mask to use for the EAN-8 code
*
* @param string The code (with or without the checksum)
* @return string The mask to use
*/
protected function getStructureMask($code) {
if (!ctype_digit($code)) {
return false;
}
return 'LLLLRRRR';
}
}
Uiteraard is deze PHP implementatie van EAN-8 en EAN-13 te downloaden.
Bekijk andere blog posts