Qbix Server

Execution models

🌐 HTTP

Drop files in web/. Static files served from an in-memory cache, PHP scripts forked and executed. Add --workers=N for persistent workers with 100× more concurrent capacity.

fork · octane mode

🔌 WebSocket

One process per connection. User isolation, auth, private state. Socket.IO compatible.

process per connection

🏠 Rooms

One process per room. Shared state for chat, games, collaboration. No Redis needed.

process per room

Project structure

your-project/
├── qbixserver.php
├── config/
│   └── server.json        ← optional config
├── web/                    ← document root
│   ├── index.html          ← replaces this page
│   └── api/hello.php       ← HTTP endpoint
├── handlers/               ← WebSocket + room handlers
│   ├── chat/
│   │   ├── join.php        ← per-connection
│   │   └── room/
│   │       ├── join.php    ← room lifecycle
│   │       ├── message.php ← room event
│   │       └── leave.php
│   └── connect.php         ← on WebSocket connect
├── classes/                ← autoloaded
│   └── ChatRoom.php        ← shared room state
└── errors/                 ← custom error pages (optional)
    └── 404.php

Examples

1. HTTP endpoint

Any file in web/ is served. PHP files are executed in a forked process.

<?php
// web/api/hello.php — visit /api/hello.php?name=Alice
Q_WebServer_State::header('Content-Type: application/json');
echo json_encode([
    'message' => 'Hello, ' . ($_GET['name'] ?? 'world')
]);

2. WebSocket handler

Each connection gets its own process. Configure in config/server.json:

{
  "Q": {
    "webserver": {
      "sockets": {
        "events": {
          "_connect": "connect",
          "chat/join": "chat/join"
        },
        "rooms": {
          "chat/$room": {"handler": "chat/room"}
        }
      }
    }
  }
}

<?php
// handlers/chat/join.php
function chat_join(&$params, &$result) {
    extract($params); // $socket, $event, $data
    $socket->join('chat/' . $data['room'], [
        'name' => $data['name']
    ]);
    $result = ['joined' => $data['room']];
}

3. Rooms — shared state

All members share one process. State lives in class statics.

<?php
// handlers/chat/room/message.php
function chat_room_message(&$params, &$result) {
    extract($params); // $room, $event, $data
    $name = ChatRoom::$names[$room->socketId] ?? 'anon';
    $room->broadcast([
        'event' => 'chat/message',
        'data'  => ['name' => $name, 'text' => $data['text']]
    ]);
}

4. Browser client

<script src="/socket.io/socket.io.js"></script>
<script>
const socket = io({transports: ['websocket']});
socket.emit('chat/join', {room: 'general', name: 'Alice'});
socket.on('chat/message', (d) => console.log(d.name + ': ' + d.text));
socket.emit('chat/message', {text: 'Hello!'});
</script>

Next: Open the Control Panel to set your password, add users, and configure the server. Create web/index.html to replace this page. Read the Getting Started guide for the full walkthrough.