Usage-Overview.md.txt 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. # Overview
  2. A PHP QR Code generator based on the [implementation by Kazuhiko Arase](https://github.com/kazuhikoarase/qrcode-generator), namespaced, cleaned up, improved and other stuff. <br>
  3. It also features a QR Code reader based on a [PHP port](https://github.com/khanamiryan/php-qrcode-detector-decoder) of the [ZXing library](https://github.com/zxing/zxing).
  4. ## Features
  5. - Creation of [Model 2 QR Codes](https://www.qrcode.com/en/codes/model12.html), [Version 1 to 40](https://www.qrcode.com/en/about/version.html)
  6. - [ECC Levels](https://www.qrcode.com/en/about/error_correction.html) L/M/Q/H supported
  7. - Mixed mode support (encoding modes can be combined within a QR symbol). Supported modes:
  8. - numeric
  9. - alphanumeric
  10. - 8-bit binary
  11. - 13-bit double-byte:
  12. - kanji (Japanese, Shift-JIS)
  13. - hanzi (simplified Chinese, GB2312/GB18030) as [defined in GBT18284-2000](https://www.chinesestandard.net/PDF/English.aspx/GBT18284-2000)
  14. - Flexible, easily extensible output modules, built-in support for the following output formats:
  15. - [GdImage](https://www.php.net/manual/book.image)
  16. - [ImageMagick](https://www.php.net/manual/book.imagick)
  17. - Markup types: SVG, HTML, etc.
  18. - String types: JSON, plain text, etc.
  19. - Encapsulated Postscript (EPS)
  20. - PDF via [FPDF](https://github.com/setasign/fpdf)
  21. - QR Code reader (via GD and ImageMagick)
  22. ## Requirements
  23. - PHP 7.4+
  24. - [`ext-mbstring`](https://www.php.net/manual/book.mbstring.php)
  25. - optional:
  26. - [`ext-fileinfo`](https://www.php.net/manual/book.fileinfo.php) (required by `QRImagick` output)
  27. - [`ext-gd`](https://www.php.net/manual/book.image)
  28. - [`ext-imagick`](https://github.com/Imagick/imagick) with [ImageMagick](https://imagemagick.org) installed
  29. - [`setasign/fpdf`](https://github.com/setasign/fpdf) for the PDF output module
  30. For the QR Code reader, either `ext-gd` or `ext-imagick` is required!
  31. ## Framework Integration
  32. - Drupal:
  33. - [Two-factor Authentication `tfa`](https://www.drupal.org/project/tfa) (Drupal 8+)
  34. - [Google Authenticator Login `ga_login`](https://www.drupal.org/project/ga_login) (deprecated, Drupal 7)
  35. - Symfony
  36. - [phpqrcode-bundle](https://github.com/jonasarts/phpqrcode-bundle)
  37. - WordPress:
  38. - [wp-two-factor-auth](https://github.com/sjinks/wp-two-factor-auth)
  39. - [simple-2fa](https://wordpress.org/plugins/simple-2fa/)
  40. - [floating-share-button](https://github.com/qriouslad/floating-share-button)
  41. - WoltLab Suite
  42. - [two-step-verification](http://pluginstore.woltlab.com/file/3007-two-step-verification/)
  43. - other uses:
  44. - [dependents](https://github.com/chillerlan/php-qrcode/network/dependents) / [packages](https://github.com/chillerlan/php-qrcode/network/dependents?dependent_type=PACKAGE)
  45. - [Appwrite](https://github.com/appwrite/appwrite)
  46. - [Cachet](https://github.com/CachetHQ/Cachet)
  47. - [GÉANT CAT](https://github.com/GEANT/CAT)
  48. - [openITCOCKPIT](https://github.com/it-novum/openITCOCKPIT)
  49. - [twill](https://github.com/area17/twill)
  50. - [Elefant CMS](https://github.com/jbroadway/elefant)
  51. - Articles:
  52. - [Twilio: How to Create a QR Code in PHP](https://www.twilio.com/blog/create-qr-code-in-php) (featuring v4.3.x)
  53. ## Shameless advertising
  54. Hi, please check out some of my other projects that are way cooler than qrcodes!
  55. - [js-qrcode](https://github.com/chillerlan/js-qrcode) - a javascript port of this library
  56. - [php-authenticator](https://github.com/chillerlan/php-authenticator) - a Google Authenticator implementation (see [authenticator example](https://github.com/chillerlan/php-qrcode/blob/main/examples/authenticator.php))
  57. - [php-httpinterface](https://github.com/chillerlan/php-httpinterface) - a PSR-7/15/17/18 implemetation
  58. - [php-oauth-core](https://github.com/chillerlan/php-oauth-core) - an OAuth 1/2 client library along with a bunch of [providers](https://github.com/chillerlan/php-oauth-providers)
  59. - [php-database](https://github.com/chillerlan/php-database) - a database client & querybuilder for MySQL, Postgres, SQLite, MSSQL, Firebird
  60. - [php-tootbot](https://github.com/php-tootbot/tootbot-template) - a Mastodon bot library