acelaya / zf2-acqrcode
QR Code generation module for Zend Framework 2 based on Endroid QR code
Installs: 29 668
Dependents: 0
Suggesters: 0
Security: 0
Stars: 8
Watchers: 6
Forks: 6
Open Issues: 1
Requires
- php: ^5.6 | ^7.0
- endroid/qrcode: ^1.6
- zendframework/zend-eventmanager: ^3.0
- zendframework/zend-http: ^2.6
- zendframework/zend-modulemanager: ^2.7
- zendframework/zend-mvc: ^3.0
- zendframework/zend-router: ^3.0
- zendframework/zend-servicemanager: ^3.0
- zendframework/zend-stdlib: ^3.0
- zendframework/zend-view: ^2.8
Requires (Dev)
- phpunit/phpunit: ^5.7 | ^6.0
- satooshi/php-coveralls: dev-master
- squizlabs/php_codesniffer: ^2.0
This package is not auto-updated.
Last update: 2022-02-01 12:37:42 UTC
README
This Zend Framework module allows you to easily generate QR codes by using the Endroid QR Code library, by Endroid.
It has been based on the EndroidQrCodeBundle Symfony bundle.
Installation
The preferred installation method is by using composer. Just require this package with composer
composer require acelaya/zf2-acqrcode
and update your dependencies with composer php composer.phar update
After that you just need to add the module to the list of enabled modules in you application.config.php
file
'modules' => array( 'Application', 'ZfcUser', 'ZfcBase', 'Acelaya\QrCode' // <-- This line will do the job )
Usage
The module can be used in many ways. It includes a route which points to a controller which returns the QR code image as a response.
You can simply use that route to create your own QR codes by passing four simple arguments. The message to be encoded, the extension of the image (jpeg, png or gif), the size of the image and the padding.
In your view template do something like this.
<img src="<?php echo $this->url('acelaya-qrcode', ['message' => 'This is a QR code example']) ?>"> <img src="<?php echo $this->url('acelaya-qrcode', ['message' => 'Another QR code', 'extension' => 'gif']) ?>"> <img src="<?php echo $this->url('acelaya-qrcode', ['message' => 'Something bigger', 'extension' => 'png', 'size' => '600']) ?>"> <img src="<?php echo $this->url('acelaya-qrcode', ['message' => 'Custom padding code', 'extension' => 'png', 'size' => '500', 'padding' => '20']) ?>">
By default the extension is jpeg, the size is 200 and the padding is 10. The message has to be provided.
Default values can be customized by copying the file vendor/acelaya/zf2-acqrcode/config/qr_code.global.php.dist
to config/autoload/qr_code.global.php
and replacing any of the params defined there.
The view helper
To ease that task, a view helper is provided. By using it you can directly render img tags pointing to that QR code or just get the assembled route just like you would do with the url
view helper.
All the methods in this view helper get the 4 params in the same order; the message, the extension, the size and finally the padding.
<?php echo $this->qrCode()->renderImg('The message', 'png', 300, 20); ?>
This will produce this image
<img src="/qr-code/generate/The%20message/png/300/20">
If you need additional attributes in the img tag, if the last argument is an array, it will be treated as the attributes and their values.
<?php echo $this->qrCode()->renderImg('The message', 'png', ['title' => 'This is a cool QR code', 'class' => 'img-thumbnail']); ?>
This will produce this image:
<img src="/qr-code/generate/The%20message/png" title="This is a cool QR code" class="img-thumbnail">
You can also render a base64-encoded image, instead of using an internal route. This is very useful when you need to render URLs, which is one of the most common use cases.
<?php echo $this->qrCode()->renderBase64Img('http://www.alejandrocelaya.com/skills', 'gif', 350, 5, ['title' => 'This is a cool QR code', 'class' => 'img-thumbnail']) ?>
This will produce this image:
<img src="data:image/gif;base64,12345...AaBbCcDd...YyZz" title="This is a cool QR code" class="img-thumbnail">
In both cases, if your application is XHTML, the image tag will be automatically closed with />
. If it is HTML5 it will be closed with just >
If you just need to get the route, this view helper is a shortcut to the url
view helper when used like this.
<div> <h2>This is a nice title</h2> <div style="background: url(<?php echo $this->qrCode('The message', 'png') ?>);"></div> </div>
If you need additional route options to be used, it can be done like this.
<div> <h2>This is a nice title</h2> <div style="background: url(<?php echo $this->qrCode()->setRouteOptions(['force_canonical' => true])->assembleRoute('The message', 'png') ?>);"></div> </div>
The service
If that view helper does not fit your needs, or you need to do something else with the QR codes, like saving them to some storage system, you can directly use the QrCodeService
.
It has been registered with the key Acelaya\QrCode\Service\QrCodeService
in order for you to inject it to any of your own services.
The returned object is a Acelaya\QrCode\Service\QrCodeService
which implements Acelaya\QrCode\Service\QrCodeServiceInterface
.
/** @var \Zend\ServiceManager\ServiceLocatorInterface $sm */ $service = $sm->get('Acelaya\QrCode\Service\QrCodeService'); $content = $service->getQrCodeContent('http://www.alejandrocelaya.com/contact', 'png'); // Save the image to disk file_put_contents('/path/to/file.png', $content);
The getQrCodeContent
method accepts the four params in the same order ($message
, $extension
, $size
, $padding
), being the first, the only mandatory argument.
Additionally you can pass a Zend\Controller\Plugin\Params
object as the first param, in order to get the information from route params, ignoring the rest of the arguments passed.
// In a controller... /** @var \Zend\ServiceManager\ServiceLocatorInterface $sm */ $service = $sm->get('Acelaya\QrCode\Service\QrCodeService'); $content = $service->getQrCodeContent($this->params()); // Save the image to disk file_put_contents('/path/to/file.png', $content);
Testing
This module includes all its unit tests and follows dependency injection and abstraction for you to be able to test any component that depend on its classes.