# litespeedtech/lscache-opencart architecture

> Architecture diagram of the GitHub repository litespeedtech/lscache-opencart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/litespeedtech/lscache-opencart
- Repository: https://github.com/litespeedtech/lscache-opencart

## Overview

LiteSpeed Cache for OpenCart adds page caching, ESI fragments, cache variation, content-change purging, and cache-management actions to OpenCart installations. The main visitor path is handled by the catalog controller, which prepares cache behavior and ESI output for LiteSpeed; administrators can configure settings and trigger purges or recaching. The tree contains parallel OpenCart 2.3, 3.0, and 4.0 implementations. README capabilities such as automatic purging and recaching are retained, but their unsampled internal call paths are not inferred.

Main entry points: [`2.3/upload/catalog/controller/extension/module/lscache.php`](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/catalog/controller/extension/module/lscache.php) (Storefront controller 2.3), [`3.0/upload/catalog/controller/extension/module/lscache.php`](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/catalog/controller/extension/module/lscache.php) (Storefront controller 3.0), [`4.0/catalog/controller/module/lscache.php`](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/catalog/controller/module/lscache.php) (Storefront controller 4.0), [`2.3/upload/admin/controller/extension/module/lscache.php`](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/controller/extension/module/lscache.php) (Admin controls 2.3)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Administration"]
  node_admin_controller_23["Admin controls 2.3<br/>[lscache.php]"]
  node_admin_model_23["Settings model 2.3<br/>[lscache.php]"]
  node_admin_controller_30["Admin controls 3.0<br/>[lscache.php]"]
  node_admin_model_30["Settings model 3.0<br/>[lscache.php]"]
  node_admin_controller_40["Admin controls 4.0<br/>[lscache.php]"]
  node_admin_model_40["Settings model 4.0<br/>[lscache.php]"]
  node_admin_ui_23["Admin settings UI 2.3<br/>[lscache.tpl]"]
  node_admin_ui_30["Admin settings UI 3.0<br/>[lscache.twig]"]
  node_admin_ui_40["Admin settings UI 4.0<br/>[lscache.twig]"]
end

subgraph group_catalog["Storefront caching"]
  node_catalog_controller_23["Storefront controller 2.3<br/>[lscache.php]"]
  node_catalog_model_23["Storefront settings 2.3<br/>[lscache.php]"]
  node_catalog_controller_30["Storefront controller 3.0<br/>[lscache.php]"]
  node_catalog_model_30["Storefront settings 3.0<br/>[lscache.php]"]
  node_catalog_controller_40["Storefront controller 4.0<br/>[lscache.php]"]
  node_catalog_model_40["Storefront settings 4.0<br/>[lscache.php]"]
end

subgraph group_engine["Cache engine"]
  node_cache_base_23["Cache operations 2.3<br/>[lscachebase.php]"]
  node_cache_core_23["Cache core 2.3<br/>[lscachecore.php]"]
  node_cache_base_30["Cache operations 3.0<br/>[lscachebase.php]"]
  node_cache_core_30["Cache core 3.0<br/>[lscachecore.php]"]
  node_cache_base_40["Cache operations 4.0<br/>[lscachebase.php]"]
  node_cache_core_40["Cache core 4.0<br/>[lscachecore.php]"]
end

subgraph group_compat["Platform variants"]
  node_mobile_23["Device detection 2.3<br/>[Mobile_Detect.php]"]
  node_mobile_30["Device detection 3.0<br/>[Mobile_Detect.php]"]
  node_mobile_40["Device detection 4.0<br/>[Mobile_Detect.php]"]
end

node_visitor(("Store visitor"))
node_admin_user(("Administrator"))
node_webserver["LiteSpeed server"]
node_content_changes(("Catalog content changes"))

node_admin_user -->|"manages"| node_admin_controller_40
node_admin_controller_40 -->|"purges cache"| node_cache_core_40
node_admin_controller_40 -.->|"renders"| node_admin_ui_40
node_admin_user -.->|"manages"| node_admin_controller_23
node_admin_user -.->|"manages"| node_admin_controller_30
node_admin_controller_23 -->|"purges cache"| node_cache_core_23
node_admin_controller_30 -->|"purges cache"| node_cache_core_30
node_admin_controller_23 -.->|"renders"| node_admin_ui_23
node_admin_controller_30 -.->|"renders"| node_admin_ui_30
node_admin_controller_23 -.->|"updates settings"| node_admin_model_23
node_admin_controller_30 -.->|"updates settings"| node_admin_model_30
node_admin_controller_40 -.->|"updates settings"| node_admin_model_40
node_visitor -.->|"requests page"| node_catalog_controller_40
node_catalog_controller_40 -.->|"reads settings"| node_catalog_model_40
node_catalog_controller_40 -->|"uses cache core"| node_cache_core_40
node_catalog_controller_40 -.->|"detects device"| node_mobile_40
node_catalog_controller_40 -.->|"sets cache headers"| node_webserver
node_visitor -.->|"requests page"| node_catalog_controller_23
node_visitor -.->|"requests page"| node_catalog_controller_30
node_catalog_controller_23 -.->|"reads settings"| node_catalog_model_23
node_catalog_controller_30 -.->|"reads settings"| node_catalog_model_30
node_catalog_controller_23 -.->|"uses cache core"| node_cache_core_23
node_catalog_controller_30 -.->|"uses cache core"| node_cache_core_30
node_catalog_controller_23 -.->|"detects device"| node_mobile_23
node_catalog_controller_30 -.->|"detects device"| node_mobile_30
node_catalog_controller_23 -.->|"sets cache headers"| node_webserver
node_catalog_controller_30 -.->|"sets cache headers"| node_webserver
node_content_changes -.->|"purges related pages"| node_cache_core_40
node_content_changes -.->|"purges ESI"| node_cache_core_40
node_content_changes -.->|"purges related pages"| node_cache_core_23
node_content_changes -.->|"purges related pages"| node_cache_core_30

click node_admin_controller_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/controller/extension/module/lscache.php"
click node_admin_model_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/model/extension/module/lscache.php"
click node_admin_controller_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/admin/controller/extension/module/lscache.php"
click node_admin_model_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/admin/model/extension/module/lscache.php"
click node_admin_controller_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/admin/controller/module/lscache.php"
click node_admin_model_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/admin/model/module/lscache.php"
click node_admin_ui_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/view/template/extension/module/lscache.tpl"
click node_admin_ui_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/admin/view/template/extension/module/lscache.twig"
click node_admin_ui_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/admin/view/template/module/lscache.twig"
click node_catalog_controller_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/catalog/controller/extension/module/lscache.php"
click node_catalog_model_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/catalog/model/extension/module/lscache.php"
click node_catalog_controller_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/catalog/controller/extension/module/lscache.php"
click node_catalog_model_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/catalog/model/extension/module/lscache.php"
click node_catalog_controller_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/catalog/controller/module/lscache.php"
click node_catalog_model_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/catalog/model/module/lscache.php"
click node_cache_base_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/system/library/lscache/lscachebase.php"
click node_cache_core_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/system/library/lscache/lscachecore.php"
click node_cache_base_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/system/library/lscache/lscachebase.php"
click node_cache_core_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/system/library/lscache/lscachecore.php"
click node_cache_base_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/system/library/lscache/lscachebase.php"
click node_cache_core_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/system/library/lscache/lscachecore.php"
click node_mobile_23 "https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/system/library/Mobile_Detect/Mobile_Detect.php"
click node_mobile_30 "https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/system/library/Mobile_Detect/Mobile_Detect.php"
click node_mobile_40 "https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/system/library/Mobile_Detect/Mobile_Detect.php"

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_admin_controller_23,node_admin_model_23,node_admin_controller_30,node_admin_model_30,node_admin_controller_40,node_admin_model_40,node_admin_ui_23,node_admin_ui_30,node_admin_ui_40 toneBlue
class node_catalog_controller_23,node_catalog_model_23,node_catalog_controller_30,node_catalog_model_30,node_catalog_controller_40,node_catalog_model_40 toneAmber
class node_cache_base_23,node_cache_core_23,node_cache_base_30,node_cache_core_30,node_cache_base_40,node_cache_core_40,node_webserver toneMint
class node_mobile_23,node_mobile_30,node_mobile_40 toneRose
class node_visitor,node_admin_user,node_content_changes toneIndigo
```

## Components

### Administration

- [Admin controls 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/controller/extension/module/lscache.php): `2.3/upload/admin/controller/extension/module/lscache.php`
- [Settings model 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/model/extension/module/lscache.php): `2.3/upload/admin/model/extension/module/lscache.php`
- [Admin controls 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/admin/controller/extension/module/lscache.php): `3.0/upload/admin/controller/extension/module/lscache.php`
- [Settings model 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/admin/model/extension/module/lscache.php): `3.0/upload/admin/model/extension/module/lscache.php`
- [Admin controls 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/admin/controller/module/lscache.php): `4.0/admin/controller/module/lscache.php`
- [Settings model 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/admin/model/module/lscache.php): `4.0/admin/model/module/lscache.php`
- [Admin settings UI 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/admin/view/template/extension/module/lscache.tpl): `2.3/upload/admin/view/template/extension/module/lscache.tpl`
- [Admin settings UI 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/admin/view/template/extension/module/lscache.twig): `3.0/upload/admin/view/template/extension/module/lscache.twig`
- [Admin settings UI 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/admin/view/template/module/lscache.twig): `4.0/admin/view/template/module/lscache.twig`

### Storefront caching

- [Storefront controller 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/catalog/controller/extension/module/lscache.php): `2.3/upload/catalog/controller/extension/module/lscache.php`
- [Storefront settings 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/catalog/model/extension/module/lscache.php): `2.3/upload/catalog/model/extension/module/lscache.php`
- [Storefront controller 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/catalog/controller/extension/module/lscache.php): `3.0/upload/catalog/controller/extension/module/lscache.php`
- [Storefront settings 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/catalog/model/extension/module/lscache.php): `3.0/upload/catalog/model/extension/module/lscache.php`
- [Storefront controller 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/catalog/controller/module/lscache.php): `4.0/catalog/controller/module/lscache.php`
- [Storefront settings 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/catalog/model/module/lscache.php): `4.0/catalog/model/module/lscache.php`

### Cache engine

- [Cache operations 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/system/library/lscache/lscachebase.php): `2.3/upload/system/library/lscache/lscachebase.php`
- [Cache core 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/system/library/lscache/lscachecore.php): `2.3/upload/system/library/lscache/lscachecore.php`
- [Cache operations 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/system/library/lscache/lscachebase.php): `3.0/upload/system/library/lscache/lscachebase.php`
- [Cache core 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/system/library/lscache/lscachecore.php): `3.0/upload/system/library/lscache/lscachecore.php`
- [Cache operations 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/system/library/lscache/lscachebase.php): `4.0/system/library/lscache/lscachebase.php`
- [Cache core 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/system/library/lscache/lscachecore.php): `4.0/system/library/lscache/lscachecore.php`

### Platform variants

- [Device detection 2.3](https://github.com/litespeedtech/lscache-opencart/blob/master/2.3/upload/system/library/Mobile_Detect/Mobile_Detect.php): `2.3/upload/system/library/Mobile_Detect/Mobile_Detect.php`
- [Device detection 3.0](https://github.com/litespeedtech/lscache-opencart/blob/master/3.0/upload/system/library/Mobile_Detect/Mobile_Detect.php): `3.0/upload/system/library/Mobile_Detect/Mobile_Detect.php`
- [Device detection 4.0](https://github.com/litespeedtech/lscache-opencart/blob/master/4.0/system/library/Mobile_Detect/Mobile_Detect.php): `4.0/system/library/Mobile_Detect/Mobile_Detect.php`

### Other components

- **Store visitor**
- **Administrator**
- **LiteSpeed server**
- **Catalog content changes**

## Connections

- Administrator → Admin controls 4.0: manages (evidence: `4.0/admin/controller/module/lscache.php`)
- Admin controls 4.0 → Cache core 4.0: purges cache (evidence: `4.0/admin/controller/module/lscache.php`)
- Admin controls 4.0 → Admin settings UI 4.0: renders
- Administrator → Admin controls 2.3: manages
- Administrator → Admin controls 3.0: manages
- Admin controls 2.3 → Cache core 2.3: purges cache (evidence: `2.3/upload/admin/controller/extension/module/lscache.php`)
- Admin controls 3.0 → Cache core 3.0: purges cache (evidence: `3.0/upload/admin/controller/extension/module/lscache.php`)
- Admin controls 2.3 → Admin settings UI 2.3: renders
- Admin controls 3.0 → Admin settings UI 3.0: renders
- Admin controls 2.3 → Settings model 2.3: updates settings
- Admin controls 3.0 → Settings model 3.0: updates settings
- Admin controls 4.0 → Settings model 4.0: updates settings
- Store visitor → Storefront controller 4.0: requests page
- Storefront controller 4.0 → Storefront settings 4.0: reads settings
- Storefront controller 4.0 → Cache core 4.0: uses cache core (evidence: `4.0/catalog/controller/module/lscache.php`)
- Storefront controller 4.0 → Device detection 4.0: detects device
- Storefront controller 4.0 → LiteSpeed server: sets cache headers
- Store visitor → Storefront controller 2.3: requests page
- Store visitor → Storefront controller 3.0: requests page
- Storefront controller 2.3 → Storefront settings 2.3: reads settings
- Storefront controller 3.0 → Storefront settings 3.0: reads settings
- Storefront controller 2.3 → Cache core 2.3: uses cache core
- Storefront controller 3.0 → Cache core 3.0: uses cache core
- Storefront controller 2.3 → Device detection 2.3: detects device
- Storefront controller 3.0 → Device detection 3.0: detects device
- Storefront controller 2.3 → LiteSpeed server: sets cache headers (evidence: `README.md`)
- Storefront controller 3.0 → LiteSpeed server: sets cache headers (evidence: `README.md`)
- Catalog content changes → Cache core 4.0: purges related pages (evidence: `README.md`)
- Catalog content changes → Cache core 4.0: purges ESI (evidence: `README.md`)
- Catalog content changes → Cache core 2.3: purges related pages (evidence: `README.md`)
- Catalog content changes → Cache core 3.0: purges related pages (evidence: `README.md`)
