# rpedrolm/lxwebsocket_server architecture

> Architecture diagram of the GitHub repository rpedrolm/lxwebsocket_server, 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/rpedrolm/lxwebsocket_server
- Repository: https://github.com/rpedrolm/lxwebsocket_server

## Overview

This repository combines a PHP WebSocket server, browser-side socket client, and small browser GUI helpers. The main workflow accepts browser connections, performs the WebSocket handshake, dispatches received messages to server callbacks, and can broadcast responses; the client negotiates and opens a socket, then routes event messages to registered hooks. TCP and SSL server variants share the socket runtime. The README is empty, and the unsampled compact client and demo files provide limited evidence for additional relationships.

Main entry points: [`LxWebSock.php`](https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxWebSock.php) (Socket runtime), [`lxcdn/LxSocket.dev.js`](https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxSocket.dev.js) (Socket client), [`LxServerTCP.php`](https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxServerTCP.php) (TCP server), [`LxServerSSL.php`](https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxServerSSL.php) (SSL server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["PHP socket server"]
  node_tcp_server["TCP server<br/>[LxServerTCP.php]"]
  node_ssl_server["SSL server<br/>[LxServerSSL.php]"]
  node_socket_runtime["Socket runtime<br/>[LxWebSock.php]"]
end

subgraph group_browser["Browser components"]
  node_socket_client["Socket client<br/>[LxSocket.dev.js]"]
  node_compact_client["Compact client<br/>[LxSocketR.dev.js]"]
  node_gui_tools["GUI tools<br/>[LxGuiTools.js]"]
end

subgraph group_integrations["External services"]
  node_socket_host["Socket host"]
  node_chartjs["Chart.js"]
end

node_browser_user(("Browser user"))

node_browser_user -->|"uses"| node_socket_client
node_socket_client -->|"negotiates and connects"| node_socket_host
node_tcp_server -->|"extends and runs"| node_socket_runtime
node_ssl_server -->|"extends and runs"| node_socket_runtime
node_socket_runtime -->|"dispatches callbacks"| node_tcp_server
node_socket_runtime -->|"dispatches callbacks"| node_ssl_server
node_socket_client -->|"dispatches hooks"| node_socket_client
node_gui_tools -->|"creates charts with"| node_chartjs

click node_tcp_server "https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxServerTCP.php"
click node_ssl_server "https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxServerSSL.php"
click node_socket_runtime "https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxWebSock.php"
click node_socket_client "https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxSocket.dev.js"
click node_compact_client "https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxSocketR.dev.js"
click node_gui_tools "https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxGuiTools.js"

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_tcp_server,node_ssl_server,node_socket_runtime,node_browser_user toneBlue
class node_socket_client,node_compact_client,node_gui_tools toneAmber
class node_socket_host,node_chartjs toneMint
```

## Components

### PHP socket server

- [TCP server](https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxServerTCP.php): `LxServerTCP.php`
- [SSL server](https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxServerSSL.php): `LxServerSSL.php`
- [Socket runtime](https://github.com/rpedrolm/lxwebsocket_server/blob/master/LxWebSock.php): `LxWebSock.php`

### Browser components

- [Socket client](https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxSocket.dev.js): `lxcdn/LxSocket.dev.js`
- [Compact client](https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxSocketR.dev.js): `lxcdn/LxSocketR.dev.js`
- [GUI tools](https://github.com/rpedrolm/lxwebsocket_server/blob/master/lxcdn/LxGuiTools.js): `lxcdn/LxGuiTools.js`

### External services

- **Socket host**
- **Chart.js**

### Other components

- **Browser user**

## Connections

- Browser user → Socket client: uses (evidence: `lxcdn/LxSocket.dev.js`)
- Socket client → Socket host: negotiates and connects (evidence: `lxcdn/LxSocket.dev.js`)
- TCP server → Socket runtime: extends and runs (evidence: `LxServerTCP.php`)
- SSL server → Socket runtime: extends and runs (evidence: `LxServerSSL.php`)
- Socket runtime → TCP server: dispatches callbacks (evidence: `LxWebSock.php`)
- Socket runtime → SSL server: dispatches callbacks (evidence: `LxWebSock.php`)
- Socket client → Socket client: dispatches hooks (evidence: `lxcdn/LxSocket.dev.js`)
- GUI tools → Chart.js: creates charts with (evidence: `lxcdn/LxGuiTools.js`)
