# picqer/php-barcode-generator architecture

> Architecture diagram of the GitHub repository picqer/php-barcode-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/picqer/php-barcode-generator
- Repository: https://github.com/picqer/php-barcode-generator

## Overview

This is a framework-independent PHP 1D barcode library. Its main workflow accepts input through a barcode type encoder, builds a structured Barcode from bars and spaces, then renders that model as SVG, PNG, JPG, or HTML. A legacy generator facade also selects encoders by type and offers format-specific wrappers. The README documents the broader symbology and renderer support; several implementations are represented by their exact source directories because their code was not sampled. Connections below are limited to shown calls or explicit README workflow statements.

Main entry points: [`src/BarcodeGenerator.php`](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGenerator.php) (Type dispatch), [`src/Barcode.php`](https://github.com/picqer/php-barcode-generator/blob/main/src/Barcode.php) (Barcode model), [`src/BarcodeBar.php`](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeBar.php) (Bar element), [`src/Renderers/PngRenderer.php`](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/PngRenderer.php) (PNG renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_encoding["Barcode encoding"]
  node_code128["Code 128<br/>[TypeCode128.php]"]
  node_code39["Code 39<br/>[TypeCode39.php]"]
  node_imb["Intelligent Mail"]
  node_symbologies["Other symbologies"]
end

subgraph group_model["Barcode model"]
  node_barcode["Barcode model<br/>[Barcode.php]"]
  node_bar["Bar element<br/>[BarcodeBar.php]"]
end

subgraph group_rendering["Image rendering"]
  node_renderer_interface["Renderer contract"]
  node_svg["SVG renderer<br/>[SvgRenderer.php]"]
  node_html["HTML renderer<br/>[HtmlRenderer.php]"]
  node_dynamic_html["Dynamic HTML"]
  node_png["PNG renderer<br/>[PngRenderer.php]"]
  node_jpg["JPG renderer<br/>[JpgRenderer.php]"]
end

subgraph group_compat["Generator API"]
  node_generator["Type dispatch"]
  node_generator_html["HTML wrapper"]
  node_generator_dynamic["Dynamic wrapper"]
  node_generator_png["PNG wrapper"]
  node_generator_jpg["JPG wrapper"]
  node_generator_svg["SVG wrapper"]
end

subgraph group_support["Encoding support"]
  node_helpers["Encoding helpers"]
  node_exceptions["Barcode exceptions"]
end

node_user(("Library caller"))

node_user -->|"chooses type"| node_code128
node_user -->|"chooses type"| node_code39
node_user -->|"chooses type"| node_imb
node_user -->|"chooses type"| node_symbologies
node_code128 -->|"builds"| node_barcode
node_code128 -->|"adds bars"| node_bar
node_code39 -->|"builds"| node_barcode
node_code39 -->|"adds bars"| node_bar
node_imb -->|"builds"| node_barcode
node_imb -->|"adds bars"| node_bar
node_barcode -->|"stores"| node_bar
node_user -->|"renders model"| node_svg
node_user -->|"renders model"| node_html
node_user -->|"renders model"| node_png
node_user -->|"renders model"| node_jpg
node_user -->|"renders model"| node_dynamic_html
node_svg -->|"reads bars"| node_barcode
node_svg -->|"reads elements"| node_bar
node_html -->|"reads bars"| node_barcode
node_html -->|"reads elements"| node_bar
node_dynamic_html -->|"reads bars"| node_barcode
node_dynamic_html -->|"reads elements"| node_bar
node_png -->|"reads bars"| node_barcode
node_png -->|"reads elements"| node_bar
node_jpg -->|"delegates to"| node_png
node_generator -->|"selects encoder"| node_code128
node_generator -->|"selects encoder"| node_code39
node_generator -->|"selects encoder"| node_imb
node_generator -->|"selects encoder"| node_symbologies
node_generator_html -->|"gets barcode"| node_generator
node_generator_html -->|"renders with"| node_html
node_generator_png -->|"gets barcode"| node_generator
node_generator_png -->|"renders with"| node_png
node_generator_jpg -->|"gets barcode"| node_generator
node_generator_jpg -->|"renders with"| node_jpg
node_generator_svg -->|"gets barcode"| node_generator
node_generator_svg -->|"renders with"| node_svg

click node_code128 "https://github.com/picqer/php-barcode-generator/blob/main/src/Types/TypeCode128.php"
click node_code39 "https://github.com/picqer/php-barcode-generator/blob/main/src/Types/TypeCode39.php"
click node_imb "https://github.com/picqer/php-barcode-generator/blob/main/src/Types/TypeIntelligentMailBarcode.php"
click node_symbologies "https://github.com/picqer/php-barcode-generator/tree/main/src/Types"
click node_barcode "https://github.com/picqer/php-barcode-generator/blob/main/src/Barcode.php"
click node_bar "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeBar.php"
click node_renderer_interface "https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/RendererInterface.php"
click node_svg "https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/SvgRenderer.php"
click node_html "https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/HtmlRenderer.php"
click node_dynamic_html "https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/DynamicHtmlRenderer.php"
click node_png "https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/PngRenderer.php"
click node_jpg "https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/JpgRenderer.php"
click node_generator "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGenerator.php"
click node_generator_html "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorHTML.php"
click node_generator_dynamic "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorDynamicHTML.php"
click node_generator_png "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorPNG.php"
click node_generator_jpg "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorJPG.php"
click node_generator_svg "https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorSVG.php"
click node_helpers "https://github.com/picqer/php-barcode-generator/tree/main/src/Helpers"
click node_exceptions "https://github.com/picqer/php-barcode-generator/tree/main/src/Exceptions"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_code128,node_code39,node_imb,node_symbologies toneBlue
class node_barcode,node_bar toneAmber
class node_renderer_interface,node_svg,node_html,node_dynamic_html,node_png,node_jpg toneMint
class node_generator,node_generator_html,node_generator_dynamic,node_generator_png,node_generator_jpg,node_generator_svg toneRose
class node_helpers,node_exceptions,node_user toneIndigo
```

## Components

### Barcode encoding

- [Code 128](https://github.com/picqer/php-barcode-generator/blob/main/src/Types/TypeCode128.php): `src/Types/TypeCode128.php`
- [Code 39](https://github.com/picqer/php-barcode-generator/blob/main/src/Types/TypeCode39.php): `src/Types/TypeCode39.php`
- [Intelligent Mail](https://github.com/picqer/php-barcode-generator/blob/main/src/Types/TypeIntelligentMailBarcode.php): `src/Types/TypeIntelligentMailBarcode.php`
- [Other symbologies](https://github.com/picqer/php-barcode-generator/tree/main/src/Types): `src/Types`

### Barcode model

- [Barcode model](https://github.com/picqer/php-barcode-generator/blob/main/src/Barcode.php): `src/Barcode.php`
- [Bar element](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeBar.php): `src/BarcodeBar.php`

### Image rendering

- [Renderer contract](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/RendererInterface.php): `src/Renderers/RendererInterface.php`
- [SVG renderer](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/SvgRenderer.php): `src/Renderers/SvgRenderer.php`
- [HTML renderer](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/HtmlRenderer.php): `src/Renderers/HtmlRenderer.php`
- [Dynamic HTML](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/DynamicHtmlRenderer.php): `src/Renderers/DynamicHtmlRenderer.php`
- [PNG renderer](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/PngRenderer.php): `src/Renderers/PngRenderer.php`
- [JPG renderer](https://github.com/picqer/php-barcode-generator/blob/main/src/Renderers/JpgRenderer.php): `src/Renderers/JpgRenderer.php`

### Generator API

- [Type dispatch](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGenerator.php): `src/BarcodeGenerator.php`
- [HTML wrapper](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorHTML.php): `src/BarcodeGeneratorHTML.php`
- [Dynamic wrapper](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorDynamicHTML.php): `src/BarcodeGeneratorDynamicHTML.php`
- [PNG wrapper](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorPNG.php): `src/BarcodeGeneratorPNG.php`
- [JPG wrapper](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorJPG.php): `src/BarcodeGeneratorJPG.php`
- [SVG wrapper](https://github.com/picqer/php-barcode-generator/blob/main/src/BarcodeGeneratorSVG.php): `src/BarcodeGeneratorSVG.php`

### Encoding support

- [Encoding helpers](https://github.com/picqer/php-barcode-generator/tree/main/src/Helpers): `src/Helpers`
- [Barcode exceptions](https://github.com/picqer/php-barcode-generator/tree/main/src/Exceptions): `src/Exceptions`

### Other components

- **Library caller**

## Connections

- Library caller → Code 128: chooses type
- Library caller → Code 39: chooses type
- Library caller → Intelligent Mail: chooses type
- Library caller → Other symbologies: chooses type
- Code 128 → Barcode model: builds (evidence: `src/Types/TypeCode128.php`)
- Code 128 → Bar element: adds bars (evidence: `src/Types/TypeCode128.php`)
- Code 39 → Barcode model: builds (evidence: `src/Types/TypeCode39.php`)
- Code 39 → Bar element: adds bars (evidence: `src/Types/TypeCode39.php`)
- Intelligent Mail → Barcode model: builds (evidence: `src/Types/TypeIntelligentMailBarcode.php`)
- Intelligent Mail → Bar element: adds bars (evidence: `src/Types/TypeIntelligentMailBarcode.php`)
- Barcode model → Bar element: stores (evidence: `src/Barcode.php`)
- Library caller → SVG renderer: renders model
- Library caller → HTML renderer: renders model
- Library caller → PNG renderer: renders model
- Library caller → JPG renderer: renders model
- Library caller → Dynamic HTML: renders model
- SVG renderer → Barcode model: reads bars (evidence: `src/Renderers/SvgRenderer.php`)
- SVG renderer → Bar element: reads elements (evidence: `src/Renderers/SvgRenderer.php`)
- HTML renderer → Barcode model: reads bars (evidence: `src/Renderers/HtmlRenderer.php`)
- HTML renderer → Bar element: reads elements (evidence: `src/Renderers/HtmlRenderer.php`)
- Dynamic HTML → Barcode model: reads bars (evidence: `src/Renderers/DynamicHtmlRenderer.php`)
- Dynamic HTML → Bar element: reads elements (evidence: `src/Renderers/DynamicHtmlRenderer.php`)
- PNG renderer → Barcode model: reads bars (evidence: `src/Renderers/PngRenderer.php`)
- PNG renderer → Bar element: reads elements (evidence: `src/Renderers/PngRenderer.php`)
- JPG renderer → PNG renderer: delegates to (evidence: `src/Renderers/JpgRenderer.php`)
- Type dispatch → Code 128: selects encoder (evidence: `src/BarcodeGenerator.php`)
- Type dispatch → Code 39: selects encoder (evidence: `src/BarcodeGenerator.php`)
- Type dispatch → Intelligent Mail: selects encoder (evidence: `src/BarcodeGenerator.php`)
- Type dispatch → Other symbologies: selects encoder (evidence: `src/BarcodeGenerator.php`)
- HTML wrapper → Type dispatch: gets barcode (evidence: `src/BarcodeGeneratorHTML.php`)
- HTML wrapper → HTML renderer: renders with (evidence: `src/BarcodeGeneratorHTML.php`)
- PNG wrapper → Type dispatch: gets barcode (evidence: `src/BarcodeGeneratorPNG.php`)
- PNG wrapper → PNG renderer: renders with (evidence: `src/BarcodeGeneratorPNG.php`)
- JPG wrapper → Type dispatch: gets barcode (evidence: `src/BarcodeGeneratorJPG.php`)
- JPG wrapper → JPG renderer: renders with (evidence: `src/BarcodeGeneratorJPG.php`)
- SVG wrapper → Type dispatch: gets barcode (evidence: `src/BarcodeGeneratorSVG.php`)
- SVG wrapper → SVG renderer: renders with (evidence: `src/BarcodeGeneratorSVG.php`)
