# chat

**Repository Path**: qqcode/chat

## Basic Information

- **Project Name**: chat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-31
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简易独立聊天服务 (chat)

本目录是一个最小可用的聊天示例（无框架），由两部分组成：

- 服务端：`start.php`（基于 Workerman，监听 WebSocket，默认端口 `2000`）
- 前端：`public/chat.html`（原生 HTML/JS），资源目录 `public/img/`（头像）和 `public/css/chat.css`

快速运行

1. 安装依赖（如果尚未安装 vendor）：

```bash
cd d:\qdgithub\chat
composer install
```

2. 启动 WebSocket 服务（在 Windows 上建议前台运行，便于查看日志）：

```bash
php start.php start
```

3. 本地预览前端页面（使用 PHP 内置静态服务器）：

```bash
php -S 127.0.0.1:8080 -t public
# 打开 http://127.0.0.1:8080/chat.html
```

要点说明

- WebSocket 默认监听端口：`2000`（见 `start.php`）。
- 前端在首次访问时会在 `localStorage` 中生成 `chat_client_id`，用于向服务端申请一个稳定的 avatar 索引（头像保存在 `public/img/avatar*.png`）。
- 如果要在公网使用建议通过反向代理（例如 nginx）将 TLS/域名请求转发到本地 `2000` 端口并处理 Upgrade 头。

如需我帮助：部署到生产（nginx 配置 / TLS）、增加消息持久化或替换头像资源，都可以继续实现。