# digininja/dvwa architecture

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

- Interactive diagram: https://gitdiagram.com/digininja/dvwa
- Repository: https://github.com/digininja/dvwa

## Overview

DVWA is a PHP web application for practicing common web vulnerabilities at selectable difficulty levels. A learner signs in, chooses a vulnerability lab, submits an attack-oriented exercise, and can consult help or view source. The repository also contains a separate API with health, login, user, and order capabilities. The README establishes the training purpose and difficulty levels; sampled page code shows framework startup and difficulty-based source selection. Many lab implementations and API routes are unsampled, so their internal links are not inferred.

Main entry points: [`dvwa/includes/dvwaPage.inc.php`](https://github.com/digininja/dvwa/blob/master/dvwa/includes/dvwaPage.inc.php) (Page Framework), [`vulnerabilities/api/src/GenericController.php`](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/GenericController.php) (Generic Responses), [`vulnerabilities/api/src/UserController.php`](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/UserController.php) (User Controller), [`index.php`](https://github.com/digininja/dvwa/blob/master/index.php) (DVWA Pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Application Platform"]
  node_web_app["DVWA Pages<br/>[index.php]"]
  node_page_framework["Page Framework<br/>[dvwaPage.inc.php]"]
  node_mysql_driver["MySQL Driver<br/>[MySQL.php]"]
end

subgraph group_labs["Vulnerability Labs"]
  node_sql_lab["SQL Injection<br/>[index.php]"]
  node_blind_sql_lab["Blind SQLi<br/>[index.php]"]
  node_access_lab["Access Control<br/>[index.php]"]
  node_access_rules["Access Variants<br/>[impossible.php]"]
  node_captcha_lab["Insecure CAPTCHA<br/>[index.php]"]
  node_brute_lab["Brute Force<br/>[index.php]"]
  node_cryptography_lab["Cryptography<br/>[index.php]"]
  node_xss_labs["Cross-Site Scripting<br/>[index.php]"]
  node_file_labs["File Attacks<br/>[index.php]"]
end

subgraph group_api["API Service"]
  node_api_service["API Service<br/>[index.php]"]
  node_api_health["Health Endpoints"]
  node_api_generic["Generic Responses"]
  node_api_login["Login Controller"]
  node_api_auth["Token Service<br/>[Login.php]"]
  node_api_token["Token Encoding<br/>[Token.php]"]
  node_api_users["User Controller<br/>[UserController.php]"]
  node_api_orders["Order Controller"]
end

subgraph group_api_models["API Domain Models"]
  node_user_model["User Model<br/>[User.php]"]
  node_order_model["Order Model<br/>[Order.php]"]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_web_app
node_web_app -->|"loads"| node_page_framework
node_web_app -->|"references"| node_mysql_driver
node_learner -->|"practices"| node_sql_lab
node_learner -->|"practices"| node_blind_sql_lab
node_learner -->|"practices"| node_access_lab
node_learner -->|"practices"| node_captcha_lab
node_learner -->|"practices"| node_brute_lab
node_learner -->|"practices"| node_cryptography_lab
node_learner -->|"practices"| node_xss_labs
node_learner -->|"practices"| node_file_labs
node_access_lab -->|"loads"| node_page_framework
node_access_lab -->|"selects"| node_access_rules
node_sql_lab -->|"loads"| node_page_framework
node_blind_sql_lab -->|"loads"| node_page_framework
node_captcha_lab -->|"loads"| node_page_framework
node_captcha_lab -->|"uses CAPTCHA helper"| node_api_service
node_api_login -->|"creates tokens"| node_api_auth
node_api_auth -->|"encodes tokens"| node_api_token
node_api_users -->|"constructs users"| node_user_model
node_api_users -->|"references orders"| node_order_model
node_api_orders -->|"constructs orders"| node_order_model
node_api_login -->|"dispatches errors"| node_api_generic
node_api_users -->|"dispatches errors"| node_api_generic
node_api_orders -->|"dispatches errors"| node_api_generic
node_api_health -->|"dispatches errors"| node_api_generic

click node_web_app "https://github.com/digininja/dvwa/blob/master/index.php"
click node_page_framework "https://github.com/digininja/dvwa/blob/master/dvwa/includes/dvwaPage.inc.php"
click node_mysql_driver "https://github.com/digininja/dvwa/blob/master/dvwa/includes/DBMS/MySQL.php"
click node_sql_lab "https://github.com/digininja/dvwa/blob/master/vulnerabilities/sqli/index.php"
click node_blind_sql_lab "https://github.com/digininja/dvwa/blob/master/vulnerabilities/sqli_blind/index.php"
click node_access_lab "https://github.com/digininja/dvwa/blob/master/vulnerabilities/bac/index.php"
click node_access_rules "https://github.com/digininja/dvwa/blob/master/vulnerabilities/bac/source/impossible.php"
click node_captcha_lab "https://github.com/digininja/dvwa/blob/master/vulnerabilities/captcha/index.php"
click node_brute_lab "https://github.com/digininja/dvwa/blob/master/vulnerabilities/brute/index.php"
click node_cryptography_lab "https://github.com/digininja/dvwa/blob/master/vulnerabilities/cryptography/index.php"
click node_xss_labs "https://github.com/digininja/dvwa/blob/master/vulnerabilities/xss_s/index.php"
click node_file_labs "https://github.com/digininja/dvwa/blob/master/vulnerabilities/fi/index.php"
click node_api_service "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/index.php"
click node_api_health "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/HealthController.php"
click node_api_generic "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/GenericController.php"
click node_api_login "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/LoginController.php"
click node_api_auth "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/Login.php"
click node_api_token "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/Token.php"
click node_api_users "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/UserController.php"
click node_api_orders "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/OrderController.php"
click node_user_model "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/User.php"
click node_order_model "https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/Order.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_web_app,node_page_framework,node_mysql_driver toneBlue
class node_sql_lab,node_blind_sql_lab,node_access_lab,node_access_rules,node_captcha_lab,node_brute_lab,node_cryptography_lab,node_xss_labs,node_file_labs toneAmber
class node_api_service,node_api_health,node_api_generic,node_api_login,node_api_auth,node_api_token,node_api_users,node_api_orders toneMint
class node_user_model,node_order_model toneRose
class node_learner toneIndigo
```

## Components

### Application Platform

- [DVWA Pages](https://github.com/digininja/dvwa/blob/master/index.php): `index.php`
- [Page Framework](https://github.com/digininja/dvwa/blob/master/dvwa/includes/dvwaPage.inc.php): `dvwa/includes/dvwaPage.inc.php`
- [MySQL Driver](https://github.com/digininja/dvwa/blob/master/dvwa/includes/DBMS/MySQL.php): `dvwa/includes/DBMS/MySQL.php`

### Vulnerability Labs

- [SQL Injection](https://github.com/digininja/dvwa/blob/master/vulnerabilities/sqli/index.php): `vulnerabilities/sqli/index.php`
- [Blind SQLi](https://github.com/digininja/dvwa/blob/master/vulnerabilities/sqli_blind/index.php): `vulnerabilities/sqli_blind/index.php`
- [Access Control](https://github.com/digininja/dvwa/blob/master/vulnerabilities/bac/index.php): `vulnerabilities/bac/index.php`
- [Access Variants](https://github.com/digininja/dvwa/blob/master/vulnerabilities/bac/source/impossible.php): `vulnerabilities/bac/source/impossible.php`
- [Insecure CAPTCHA](https://github.com/digininja/dvwa/blob/master/vulnerabilities/captcha/index.php): `vulnerabilities/captcha/index.php`
- [Brute Force](https://github.com/digininja/dvwa/blob/master/vulnerabilities/brute/index.php): `vulnerabilities/brute/index.php`
- [Cryptography](https://github.com/digininja/dvwa/blob/master/vulnerabilities/cryptography/index.php): `vulnerabilities/cryptography/index.php`
- [Cross-Site Scripting](https://github.com/digininja/dvwa/blob/master/vulnerabilities/xss_s/index.php): `vulnerabilities/xss_s/index.php`
- [File Attacks](https://github.com/digininja/dvwa/blob/master/vulnerabilities/fi/index.php): `vulnerabilities/fi/index.php`

### API Service

- [API Service](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/index.php): `vulnerabilities/api/index.php`
- [Health Endpoints](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/HealthController.php): `vulnerabilities/api/src/HealthController.php`
- [Generic Responses](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/GenericController.php): `vulnerabilities/api/src/GenericController.php`
- [Login Controller](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/LoginController.php): `vulnerabilities/api/src/LoginController.php`
- [Token Service](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/Login.php): `vulnerabilities/api/src/Login.php`
- [Token Encoding](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/Token.php): `vulnerabilities/api/src/Token.php`
- [User Controller](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/UserController.php): `vulnerabilities/api/src/UserController.php`
- [Order Controller](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/OrderController.php): `vulnerabilities/api/src/OrderController.php`

### API Domain Models

- [User Model](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/User.php): `vulnerabilities/api/src/User.php`
- [Order Model](https://github.com/digininja/dvwa/blob/master/vulnerabilities/api/src/Order.php): `vulnerabilities/api/src/Order.php`

### Other components

- **Learner**

## Connections

- Learner → DVWA Pages: opens (evidence: `README.md`)
- DVWA Pages → Page Framework: loads (evidence: `index.php`)
- DVWA Pages → MySQL Driver: references (evidence: `index.php`)
- Learner → SQL Injection: practices (evidence: `README.md`)
- Learner → Blind SQLi: practices (evidence: `README.md`)
- Learner → Access Control: practices (evidence: `README.md`)
- Learner → Insecure CAPTCHA: practices (evidence: `README.md`)
- Learner → Brute Force: practices (evidence: `README.md`)
- Learner → Cryptography: practices (evidence: `README.md`)
- Learner → Cross-Site Scripting: practices (evidence: `README.md`)
- Learner → File Attacks: practices (evidence: `README.md`)
- Access Control → Page Framework: loads (evidence: `vulnerabilities/bac/index.php`)
- Access Control → Access Variants: selects (evidence: `vulnerabilities/bac/index.php`)
- SQL Injection → Page Framework: loads (evidence: `vulnerabilities/sqli/index.php`)
- Blind SQLi → Page Framework: loads (evidence: `vulnerabilities/sqli_blind/index.php`)
- Insecure CAPTCHA → Page Framework: loads (evidence: `vulnerabilities/captcha/index.php`)
- Insecure CAPTCHA → API Service: uses CAPTCHA helper (evidence: `vulnerabilities/captcha/index.php`)
- Login Controller → Token Service: creates tokens (evidence: `vulnerabilities/api/src/LoginController.php`)
- Token Service → Token Encoding: encodes tokens (evidence: `vulnerabilities/api/src/Login.php`)
- User Controller → User Model: constructs users (evidence: `vulnerabilities/api/src/UserController.php`)
- User Controller → Order Model: references orders (evidence: `vulnerabilities/api/src/UserController.php`)
- Order Controller → Order Model: constructs orders (evidence: `vulnerabilities/api/src/OrderController.php`)
- Login Controller → Generic Responses: dispatches errors (evidence: `vulnerabilities/api/src/LoginController.php`)
- User Controller → Generic Responses: dispatches errors (evidence: `vulnerabilities/api/src/UserController.php`)
- Order Controller → Generic Responses: dispatches errors (evidence: `vulnerabilities/api/src/OrderController.php`)
- Health Endpoints → Generic Responses: dispatches errors (evidence: `vulnerabilities/api/src/HealthController.php`)
