# night-have-dreams/php-cgi-injector architecture

> Architecture diagram of the GitHub repository night-have-dreams/php-cgi-injector, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/night-have-dreams/php-cgi-injector
- Repository: https://github.com/night-have-dreams/php-cgi-injector

## Overview

##### Project type and purpose
- This is a CLI-based penetration-testing tool (a Python exploit framework) for automating PHP-CGI parameter-injection attacks (CVE-2024-4577 & CVE-2024-8926).
- It provides an interactive terminal UI, payload management, WAF bypass plugin system, Tor integration, file upload/download, logging, and detailed/force modes.

##### File structure
- Top-level scripts:
- banner.py – ASCII/intro UI
- exploit.py – main orchestration (CLI parser → exploit engine → interaction loop)
- bypass_manager.py – loads and orchestrates bypass modules
- tor_helper.py – encapsulates Tor session setup
- requirements.txt – library deps (requests, requests-tor, rich, etc.)
- tamper_example_template.txt – template for custom bypass scripts
- Directory “bypass_modules/”: each tamper_*.py is a plugin that mutates or obfuscates payloads or headers.
- README.md provides command-line options, modes, features, and the plugin model.

##### README for additional insights
- CLI flags control target URL, timeouts, delays, verbosity, Tor, bypass, force-mode, CGI endpoints.
- After detecting a vulnerability, the user enters an interactive exploit menu with modes: shell, custom PHP, upload, download, target switch, parameter settings.
- Bypass modules implement various WAF evasion strategies.

a. Main components to represent:
1) User / CLI Interface
2) Argument Parser & Controller (exploit.py)
3) Exploit Engine / Workflow Manager
4) HTTP Request Handler (with or without Tor)
5) Bypass Manager & Tamper Modules (plugin layer)
6) Payload Manager (predefined + custom combos)
7) Response Processor & Interactive Menu
8) File I/O (download/, log files)
9) External Components: Target PHP-CGI server, Tor network
10) Utility Modules: banner.py, tor_helper.py
b. Relationships and interactions:
- User issues CLI command → Argument Parser sets flags.
- Controller invokes Exploit Engine.
- For each request, Exploit Engine calls Bypass Manager to apply active tamper modules to payload and headers.
- Request Handler sends HTTP(s) to the target (directly or via tor_helper).
- Response returns to Response Processor, which dispatches to the interactive menu or logging subsystem.
- In upload/download modes, File I/O reads/writes to local FS.
- Payload Manager feeds payload templates or user-provided code into the engine.
c. Architectural patterns and design principles:
- Plugin architecture: bypass modules drop-in under bypass_modules/ and are discovered/loaded dynamically.
- Separation of concerns: CLI parsing, engine logic, HTTP transport, tampering, UI.
- Modular extensibility: new bypass scripts via template.
- Utility layering: tor_helper abstracts Tor vs. direct requests.
d. Key technologies and libraries:
- Python 3.x
- requests, urllib3 for HTTP
- requests-tor for Tor integration
- rich for terminal UI/animations
- chardet for encoding detection

## Diagram (Mermaid)

```mermaid
flowchart TD
    User((User)):::external
    User --> Banner["Banner UI"]:::external
    Banner --> Parser["Arg Parser & Controller"]:::core
    Parser --> Engine["Exploit Engine / Workflow Manager"]:::core
    Engine --> BypassMgr["Bypass Manager & Plugin Loader"]:::plugin
    Engine --> PayloadMgr["Payload Manager"]:::core
    Engine --> HTTPHandler["HTTP Request Handler"]:::transport

    subgraph "Tamper Modules" 
        direction TB
        TM1["tamper_append_adad.py"]:::plugin
        TM2["tamper_cgi_case_mixer.py"]:::plugin
        TM3["tamper_cgipath_garbage.py"]:::plugin
        TM4["tamper_insert_dummy_element.py"]:::plugin
        TM5["tamper_payload_shuffle.py"]:::plugin
        TM6["tamper_phpfilter_wrap.py"]:::plugin
        TM7["tamper_phpinput_to_data.py"]:::plugin
        TM8["tamper_random_useragent.py"]:::plugin
        TM9["tamper_redirect_status.py"]:::plugin
        TM10["tamper_xff_ip_bypass.py"]:::plugin
    end

    BypassMgr --> TM1
    BypassMgr --> TM2
    BypassMgr --> TM3
    BypassMgr --> TM4
    BypassMgr --> TM5
    BypassMgr --> TM6
    BypassMgr --> TM7
    BypassMgr --> TM8
    BypassMgr --> TM9
    BypassMgr --> TM10

    PayloadMgr --> PayloadTpl["tamper_example_template.txt"]:::plugin

    HTTPHandler --> Direct["Direct HTTP Logic"]:::transport
    HTTPHandler --> TorHelper["Tor Session Handler"]:::transport

    TorHelper --> TorNet((Tor Network)):::external
    Direct --> Target((Target PHP-CGI Server)):::external
    TorHelper --> Target

    Target --> Response["Response Processor & Interactive Menu"]:::core
    Response --> Interactive["Interactive Menu Loop"]:::core
    Interactive --> Engine

    Response --> FileIO["File I/O (upload/download, logging)"]:::external
    FileIO --> Storage["Local File System"]:::external

    click Banner "https://github.com/night-have-dreams/php-cgi-injector/blob/main/banner.py"
    click Parser "https://github.com/night-have-dreams/php-cgi-injector/blob/main/exploit.py"
    click Engine "https://github.com/night-have-dreams/php-cgi-injector/blob/main/exploit.py"
    click Response "https://github.com/night-have-dreams/php-cgi-injector/blob/main/exploit.py"
    click FileIO "https://github.com/night-have-dreams/php-cgi-injector/blob/main/exploit.py"
    click TorHelper "https://github.com/night-have-dreams/php-cgi-injector/blob/main/tor_helper.py"
    click BypassMgr "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_manager.py"
    click TM1 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_append_adad.py"
    click TM2 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_cgi_case_mixer.py"
    click TM3 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_cgipath_garbage.py"
    click TM4 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_insert_dummy_element.py"
    click TM5 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_payload_shuffle.py"
    click TM6 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_phpfilter_wrap.py"
    click TM7 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_phpinput_to_data.py"
    click TM8 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_random_useragent.py"
    click TM9 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_redirect_status.py"
    click TM10 "https://github.com/night-have-dreams/php-cgi-injector/blob/main/bypass_modules/tamper_xff_ip_bypass.py"
    click PayloadTpl "https://github.com/night-have-dreams/php-cgi-injector/blob/main/tamper_example_template.txt"

    classDef core fill:#9f6,stroke:#333,stroke-width:1px
    classDef transport fill:#6cf,stroke:#333,stroke-width:1px
    classDef plugin fill:#fc6,stroke:#333,stroke-width:1px
    classDef external fill:#ccc,stroke:#333,stroke-width:1px
```
