Usage-Overview.html 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248
  1. <!DOCTYPE html>
  2. <html class="writer-html5" lang="en" >
  3. <head>
  4. <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  6. <title>Overview &mdash; PHP-QRCode main
  7. Manual</title>
  8. <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  9. <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  10. <!--[if lt IE 9]>
  11. <script src="_static/js/html5shiv.min.js"></script>
  12. <![endif]-->
  13. <script src="_static/jquery.js"></script>
  14. <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
  15. <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
  16. <script src="_static/doctools.js"></script>
  17. <script src="_static/sphinx_highlight.js"></script>
  18. <script src="_static/js/theme.js"></script>
  19. <link rel="index" title="Index" href="genindex.html" />
  20. <link rel="search" title="Search" href="search.html" />
  21. <link rel="next" title="Installation" href="Usage-Installation.html" />
  22. <link rel="prev" title="PHP-QRCode Manual" href="index.html" />
  23. </head>
  24. <body class="wy-body-for-nav">
  25. <div class="wy-grid-for-nav">
  26. <nav data-toggle="wy-nav-shift" class="wy-nav-side">
  27. <div class="wy-side-scroll">
  28. <div class="wy-side-nav-search" >
  29. <a href="index.html" class="icon icon-home">
  30. PHP-QRCode
  31. </a>
  32. <div role="search">
  33. <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
  34. <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
  35. <input type="hidden" name="check_keywords" value="yes" />
  36. <input type="hidden" name="area" value="default" />
  37. </form>
  38. </div>
  39. </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
  40. <p class="caption" role="heading"><span class="caption-text">Usage</span></p>
  41. <ul class="current">
  42. <li class="toctree-l1 current"><a class="current reference internal" href="#">Overview</a><ul>
  43. <li class="toctree-l2"><a class="reference internal" href="#features">Features</a></li>
  44. <li class="toctree-l2"><a class="reference internal" href="#requirements">Requirements</a></li>
  45. <li class="toctree-l2"><a class="reference internal" href="#framework-integration">Framework Integration</a></li>
  46. </ul>
  47. </li>
  48. <li class="toctree-l1"><a class="reference internal" href="Usage-Installation.html">Installation</a><ul>
  49. <li class="toctree-l2"><a class="reference internal" href="Usage-Installation.html#installation-with-composer">Installation with Composer</a><ul>
  50. <li class="toctree-l3"><a class="reference internal" href="Usage-Installation.html#composer-json">composer.json</a><ul>
  51. <li class="toctree-l4"><a class="reference internal" href="Usage-Installation.html#version-switch">Version switch</a></li>
  52. </ul>
  53. </li>
  54. <li class="toctree-l3"><a class="reference internal" href="Usage-Installation.html#terminal">Terminal</a></li>
  55. </ul>
  56. </li>
  57. <li class="toctree-l2"><a class="reference internal" href="Usage-Installation.html#manual-installation">Manual installation</a><ul>
  58. <li class="toctree-l3"><a class="reference internal" href="Usage-Installation.html#can-i-use-this-library-without-using-composer">Can i use this library without using composer?</a></li>
  59. </ul>
  60. </li>
  61. <li class="toctree-l2"><a class="reference internal" href="Usage-Installation.html#supported-php-versions-extension-requirements">Supported PHP versions &amp; extension requirements</a></li>
  62. <li class="toctree-l2"><a class="reference internal" href="Usage-Installation.html#imagemagick">ImageMagick</a></li>
  63. </ul>
  64. </li>
  65. <li class="toctree-l1"><a class="reference internal" href="Usage-Quickstart.html">Quickstart</a><ul>
  66. <li class="toctree-l2"><a class="reference internal" href="Usage-Quickstart.html#import-the-library">Import the library</a></li>
  67. <li class="toctree-l2"><a class="reference internal" href="Usage-Quickstart.html#create-your-first-qr-code">Create your first QR Code</a><ul>
  68. <li class="toctree-l3"><a class="reference internal" href="Usage-Quickstart.html#configuration">Configuration</a></li>
  69. </ul>
  70. </li>
  71. <li class="toctree-l2"><a class="reference internal" href="Usage-Quickstart.html#reading-qr-codes">Reading QR Codes</a></li>
  72. <li class="toctree-l2"><a class="reference internal" href="Usage-Quickstart.html#notes">Notes</a></li>
  73. </ul>
  74. </li>
  75. <li class="toctree-l1"><a class="reference internal" href="Usage-Advanced-usage.html">Advanced usage</a><ul>
  76. <li class="toctree-l2"><a class="reference internal" href="Usage-Advanced-usage.html#configuration-via-qroptions">Configuration via <code class="docutils literal notranslate"><span class="pre">QROptions</span></code></a><ul>
  77. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#supply-an-iterable-of-options">Supply an <code class="docutils literal notranslate"><span class="pre">iterable</span></code> of options</a></li>
  78. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#load-and-save-json">Load and save JSON</a></li>
  79. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#extending-the-qroptions-class">Extending the <code class="docutils literal notranslate"><span class="pre">QROptions</span></code> class</a></li>
  80. </ul>
  81. </li>
  82. <li class="toctree-l2"><a class="reference internal" href="Usage-Advanced-usage.html#qrcode-methods"><code class="docutils literal notranslate"><span class="pre">QRCode</span></code> methods</a><ul>
  83. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#save-to-file">Save to file</a></li>
  84. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#render-a-qrmatrix-instance">Render a <code class="docutils literal notranslate"><span class="pre">QRMatrix</span></code> instance</a></li>
  85. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#mixed-mode">Mixed mode</a></li>
  86. <li class="toctree-l3"><a class="reference internal" href="Usage-Advanced-usage.html#qr-code-reader">QR Code reader</a></li>
  87. </ul>
  88. </li>
  89. </ul>
  90. </li>
  91. </ul>
  92. <p class="caption" role="heading"><span class="caption-text">Appendix</span></p>
  93. <ul>
  94. <li class="toctree-l1"><a class="reference internal" href="Appendix-License.html">License</a></li>
  95. </ul>
  96. </div>
  97. </div>
  98. </nav>
  99. <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
  100. <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
  101. <a href="index.html">PHP-QRCode</a>
  102. </nav>
  103. <div class="wy-nav-content">
  104. <div class="rst-content">
  105. <div role="navigation" aria-label="Page navigation">
  106. <ul class="wy-breadcrumbs">
  107. <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
  108. <li class="breadcrumb-item active">Overview</li>
  109. <li class="wy-breadcrumbs-aside">
  110. <a href="https://github.com/chillerlan/php-qrcode/blob/main/docs/Usage-Overview.md" class="fa fa-github"> Edit on GitHub</a>
  111. </li>
  112. </ul>
  113. <hr/>
  114. </div>
  115. <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
  116. <div itemprop="articleBody">
  117. <section id="overview">
  118. <h1>Overview<a class="headerlink" href="#overview" title="Permalink to this heading"></a></h1>
  119. <section id="features">
  120. <h2>Features<a class="headerlink" href="#features" title="Permalink to this heading"></a></h2>
  121. <ul class="simple">
  122. <li><p>Creation of <a class="reference external" href="https://www.qrcode.com/en/codes/model12.html">Model 2 QR Codes</a>, <a class="reference external" href="https://www.qrcode.com/en/about/version.html">Version 1 to 40</a></p></li>
  123. <li><p><a class="reference external" href="https://www.qrcode.com/en/about/error_correction.html">ECC Levels</a> L/M/Q/H supported</p></li>
  124. <li><p>Mixed mode support (encoding modes can be combined within a QR symbol). Supported modes:</p>
  125. <ul>
  126. <li><p>numeric</p></li>
  127. <li><p>alphanumeric</p></li>
  128. <li><p>8-bit binary</p></li>
  129. <li><p>13-bit double-byte kanji (Japanese, Shift-JIS) and hanzi (simplified Chinese, GB2312/GB18030) as <a class="reference external" href="https://www.chinesestandard.net/PDF/English.aspx/GBT18284-2000">defined in GBT18284-2000</a></p></li>
  130. </ul>
  131. </li>
  132. <li><p>Flexible, easily extensible output modules, built-in support for the following output formats:</p>
  133. <ul>
  134. <li><p><a class="reference external" href="https://www.php.net/manual/book.image">GdImage</a></p></li>
  135. <li><p><a class="reference external" href="https://www.php.net/manual/book.imagick">ImageMagick</a></p></li>
  136. <li><p>Markup types: SVG, HTML, etc.</p></li>
  137. <li><p>String types: JSON, plain text, etc.</p></li>
  138. <li><p>Encapsulated Postscript (EPS)</p></li>
  139. <li><p>PDF via <a class="reference external" href="https://github.com/setasign/fpdf">FPDF</a></p></li>
  140. </ul>
  141. </li>
  142. <li><p>QR Code reader (via GD and ImageMagick)</p></li>
  143. </ul>
  144. </section>
  145. <section id="requirements">
  146. <h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this heading"></a></h2>
  147. <ul class="simple">
  148. <li><p>PHP 7.4+</p>
  149. <ul>
  150. <li><p><a class="reference external" href="https://www.php.net/manual/book.mbstring.php"><code class="docutils literal notranslate"><span class="pre">ext-mbstring</span></code></a></p></li>
  151. <li><p>optional:</p>
  152. <ul>
  153. <li><p><a class="reference external" href="https://www.php.net/manual/book.fileinfo.php"><code class="docutils literal notranslate"><span class="pre">ext-fileinfo</span></code></a> (required by <code class="docutils literal notranslate"><span class="pre">QRImagick</span></code> output)</p></li>
  154. <li><p><a class="reference external" href="https://www.php.net/manual/book.image"><code class="docutils literal notranslate"><span class="pre">ext-gd</span></code></a></p></li>
  155. <li><p><a class="reference external" href="https://github.com/Imagick/imagick"><code class="docutils literal notranslate"><span class="pre">ext-imagick</span></code></a> with <a class="reference external" href="https://imagemagick.org">ImageMagick</a> installed</p></li>
  156. <li><p><a class="reference external" href="https://github.com/setasign/fpdf"><code class="docutils literal notranslate"><span class="pre">setasign/fpdf</span></code></a> for the PDF output module</p></li>
  157. </ul>
  158. </li>
  159. </ul>
  160. </li>
  161. </ul>
  162. <p>For the QR Code reader, either <code class="docutils literal notranslate"><span class="pre">ext-gd</span></code> or <code class="docutils literal notranslate"><span class="pre">ext-imagick</span></code> is required!</p>
  163. </section>
  164. <section id="framework-integration">
  165. <h2>Framework Integration<a class="headerlink" href="#framework-integration" title="Permalink to this heading"></a></h2>
  166. <ul class="simple">
  167. <li><p>Drupal:</p>
  168. <ul>
  169. <li><p><a class="reference external" href="https://www.drupal.org/project/tfa">Two-factor Authentication <code class="docutils literal notranslate"><span class="pre">tfa</span></code></a> (Drupal 8+)</p></li>
  170. <li><p><a class="reference external" href="https://www.drupal.org/project/ga_login">Google Authenticator Login <code class="docutils literal notranslate"><span class="pre">ga_login</span></code></a> (deprecated, Drupal 7)</p></li>
  171. </ul>
  172. </li>
  173. <li><p>Symfony</p>
  174. <ul>
  175. <li><p><a class="reference external" href="https://github.com/jonasarts/phpqrcode-bundle">phpqrcode-bundle</a></p></li>
  176. </ul>
  177. </li>
  178. <li><p>WordPress:</p>
  179. <ul>
  180. <li><p><a class="reference external" href="https://github.com/sjinks/wp-two-factor-auth">wp-two-factor-auth</a></p></li>
  181. <li><p><a class="reference external" href="https://wordpress.org/plugins/simple-2fa/">simple-2fa</a></p></li>
  182. <li><p><a class="reference external" href="https://github.com/qriouslad/floating-share-button">floating-share-button</a></p></li>
  183. </ul>
  184. </li>
  185. <li><p>WoltLab Suite</p>
  186. <ul>
  187. <li><p><a class="reference external" href="http://pluginstore.woltlab.com/file/3007-two-step-verification/">two-step-verification</a></p></li>
  188. </ul>
  189. </li>
  190. <li><p>other uses:</p>
  191. <ul>
  192. <li><p><a class="reference external" href="https://github.com/chillerlan/php-qrcode/network/dependents">dependents</a> / <a class="reference external" href="https://github.com/chillerlan/php-qrcode/network/dependents?dependent_type=PACKAGE">packages</a></p></li>
  193. <li><p><a class="reference external" href="https://github.com/appwrite/appwrite">Appwrite</a></p></li>
  194. <li><p><a class="reference external" href="https://github.com/CachetHQ/Cachet">Cachet</a></p></li>
  195. <li><p><a class="reference external" href="https://github.com/GEANT/CAT">GÉANT CAT</a></p></li>
  196. <li><p><a class="reference external" href="https://github.com/it-novum/openITCOCKPIT">openITCOCKPIT</a></p></li>
  197. <li><p><a class="reference external" href="https://github.com/area17/twill">twill</a></p></li>
  198. <li><p><a class="reference external" href="https://github.com/jbroadway/elefant">Elefant CMS</a></p></li>
  199. </ul>
  200. </li>
  201. <li><p>Articles:</p>
  202. <ul>
  203. <li><p><a class="reference external" href="https://www.twilio.com/blog/create-qr-code-in-php">Twilio: How to Create a QR Code in PHP</a> (featuring v4.3.x)</p></li>
  204. </ul>
  205. </li>
  206. </ul>
  207. </section>
  208. </section>
  209. </div>
  210. </div>
  211. <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
  212. <a href="index.html" class="btn btn-neutral float-left" title="PHP-QRCode Manual" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
  213. <a href="Usage-Installation.html" class="btn btn-neutral float-right" title="Installation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
  214. </div>
  215. <hr/>
  216. <div role="contentinfo">
  217. <p>&#169; Copyright 2023, smiley.</p>
  218. </div>
  219. </footer>
  220. </div>
  221. </div>
  222. </section>
  223. </div>
  224. <script>
  225. jQuery(function () {
  226. SphinxRtdTheme.Navigation.enable(true);
  227. });
  228. </script>
  229. </body>
  230. </html>