文章目录
- WebSocket(RFC 6455): 全双工通信(Full-duplex) 单个TCP连接(持久连接) 低延迟(< 50ms) 替代HTTP轮询(Polling) vs HTTP轮询: HTTP轮询:频繁发起HTTP请求(浪费资源) WebSocket:建立连接后,服务端主动推送(高效)
- 传统WordPress(静态): 评论需要刷新页面才能看到 通知需要手动检查 无协同编辑(多人同时编辑冲突) 实时WordPress: 新评论实时显示(无需刷新) 通知实时推送(类似Facebook) 协同编辑(类似Google Docs)
- // server.js const WebSocket = require('ws'); const express = require('express'); const cors = require('cors'); const http = require('http'); const app = express(); app.use(cors()); app.use(express.json()); // 创建HTTP服务器 const server = http.createServer(app); // 创建WebSocket服务器 const wss = new WebSocket.Server({ server }); // 存储连接的客户端 const clients = new Map(); wss.on('connection', (ws, req) => { console.log('新客户端连接'); // 分配客户端ID const clientId = Date.now(); clients.set(ws, clientId); // 接收消息 ws.on('message', (message) => { const data = JSON.parse(message); // 广播消息给所有客户端 clients.forEach((id, client) => { if (client.readyState === WebSocket.OPEN) { client.send(JSON.stringify({ type: 'new_comment', postId: data.postId, comment: data.comment, author: data.author, })); } }); }); // 连接关闭 ws.on('close', () => { console.log('客户端断开连接'); clients.delete(ws); }); }); // REST API:获取在线用户数 app.get('/api/online-users', (req, res) => { res.json({ count: clients.size }); }); const PORT = process.env.PORT || 8080; server.listen(PORT, () => { console.log(`WebSocket服务器运行在端口 ${PORT}`); });
- # 开发模式(自动重载) npx nodemon server.js
-
- jQuery(document).ready(function($) { // 连接WebSocket服务器 const ws = new WebSocket('wss://realtime.example.com:8080'); // 连接成功 ws.onopen = () => { console.log('WebSocket连接成功'); }; // 接收消息 ws.onmessage = (event) => { const data = JSON.parse(event.data); if (data.type === 'new_comment') { // 显示新评论(无需刷新) $('#comments').append(` ${data.author}: ${data.comment} `); } }; // 提交评论时,通过WebSocket广播 $('#commentform').on('submit', function(e) { e.preventDefault(); const comment = $('#comment').val(); const postId = $('#post_id').val(); const author = $('#author').val(); // 发送到WebSocket服务器 ws.send(JSON.stringify({ type: 'new_comment', postId: postId, comment: comment, author: author, })); // 同时提交到WordPress(持久化) $(this).submit(); // 正常提交 }); });
- // 安装WP REST API扩展(允许WebSocket服务器调用) add_action('rest_api_init', 'register_comment_endpoint'); function register_comment_endpoint() { register_rest_route('wp/v2', '/add_comment', [ 'methods' => 'POST', 'callback' => 'add_comment_callback', 'permission_callback' => '__return_true', ]); } function add_comment_callback($request) { $params = $request->get_json_params(); $comment_id = wp_insert_comment([ 'comment_post_ID' => $params['post_id'], 'comment_content' => $params['comment'], 'comment_author' => $params['author'], 'comment_approved' => 1, ]); return rest_ensure_response(['comment_id' => $comment_id]); }
-
- -- 创建通知表 CREATE TABLE wp_notifications ( id BIGINT AUTO_INCREMENT PRIMARY KEY, user_id BIGINT NOT NULL, type VARCHAR(50) NOT NULL, -- 'comment', 'like', 'follow' content TEXT NOT NULL, link VARCHAR(255) NOT NULL, is_read TINYINT DEFAULT 0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP );
- // 当有新评论时,创建通知 add_action('wp_insert_comment', 'create_notification', 10, 2); function create_notification($comment_id, $comment) { $post = get_post($comment->comment_post_ID); $post_author_id = $post->post_author; global $wpdb; $wpdb->insert('wp_notifications', [ 'user_id' => $post_author_id, 'type' => 'comment', 'content' => $comment->comment_content, 'link' => get_permalink($post->ID) . '#comment-' . $comment_id, 'is_read' => 0, 'created_at' => current_time('mysql'), ]); // 通过WebSocket推送通知 push_notification($post_author_id, [ 'type' => 'new_notification', 'content' => $comment->comment_content, 'link' => get_permalink($post->ID), ]); } function push_notification($user_id, $data) { // 调用Node.js WebSocket服务器API $ch = curl_init('https://realtime.example.com:8080/push'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ 'user_id' => $user_id, 'data' => $data, ])); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); curl_exec($ch); curl_close($ch); }
- // 连接WebSocket(接收通知) const ws = new WebSocket('wss://realtime.example.com:8080'); ws.onmessage = (event) => { const data = JSON.parse(event.data); if (data.type === 'new_notification') { // 显示通知气泡 showNotification(data.content, data.link); // 更新未读计数 updateUnreadCount(); } }; function showNotification(content, link) { // 桌面通知(浏览器权限) if (Notification.permission === 'granted') { new Notification('新通知', { body: content, icon: '/icon.png', tag: link, }); } // 页面内通知(类似Facebook下拉) $('#notification-dropdown').prepend(` ${content} `); }
-
- # 安装ShareDB npm install sharedb ws express
- // collaborative-server.js const ShareDB = require('sharedb'); const WebSocket = require('ws'); const express = require('express'); const app = express(); const server = require('http').createServer(app); const wss = new WebSocket.Server({ server }); const backend = new ShareDB(); const connection = backend.connect(); wss.on('connection', (ws) => { const stream = WebSocketJSONStream(ws); backend.listen(stream); }); server.listen(8080, () => { console.log('协同编辑服务器运行在端口 8080'); }); // 使用WebSocketJSONStream(需要安装) // npm install @teamwork/websocket-json-stream
- // 协同编辑(使用ShareDB) import { Connection } from 'sharedb/lib/client'; const socket = new WebSocket('wss://realtime.example.com:8080'); const connection = new Connection(socket); // 打开文档(按Post ID) const doc = connection.get('posts', postId); doc.subscribe((err) => { if (err) throw err; // 初始化内容 if (!doc.type) { doc.create('text'); // 创建Text类型(支持协同编辑) } // 绑定到textarea const textarea = document.getElementById('post-content'); textarea.value = doc.data; // 监听本地修改 textarea.addEventListener('input', () => { doc.submitOp([{ retain: textarea.value.length }]); // 简化示例 }); // 监听远程修改 doc.on('op', (op, source) => { if (!source) { textarea.value = doc.data; // 更新内容 } }); });
- # /etc/nginx/sites-available/realtime.example.com server { listen 80; server_name realtime.example.com; location / { proxy_pass http://localhost:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; # 超时设置(WebSocket长连接) proxy_read_timeout 86400; proxy_send_timeout 86400; } }
- # 使用Let's Encrypt certbot --nginx -d realtime.example.com
-
- // 使用Redis Pub/Sub(多服务器之间同步消息) const redis = require('redis'); const publisher = redis.createClient(); const subscriber = redis.createClient(); // 订阅频道 subscriber.subscribe('wp_comments'); // 接收消息 subscriber.on('message', (channel, message) => { // 广播给所有WebSocket客户端 wss.clients.forEach((client) => { if (client.readyState === WebSocket.OPEN) { client.send(message); } }); }); // 发布消息 function broadcast(message) { publisher.publish('wp_comments', JSON.stringify(message)); }
- // SSE(简单场景:只需要服务端推送,不需要客户端发送) app.get('/events', (req, res) => { res.setHeader('Content-Type', 'text/event-stream'); res.setHeader('Cache-Control', 'no-cache'); res.setHeader('Connection', 'keep-alive'); // 每隔5秒推送一次 const intervalId = setInterval(() => { res.write(`data: ${JSON.stringify({ time: new Date() })}\n\n`); }, 5000); // 客户端断开连接 req.on('close', () => { clearInterval(intervalId); }); }); // 前端JavaScript(SSE客户端) const eventSource = new EventSource('/events'); eventSource.onmessage = (event) => { const data = JSON.parse(event.data); console.log('新数据:', data); };
- | 场景 | 技术方案 | 理由 | |------|----------|------| | 实时评论 | WebSocket | 双向通信 | | 实时通知 | WebSocket + SSE | 低延迟 | | 协同编辑 | ShareDB + WebSocket | 冲突解决 | | 股票/加密货币价格 | SSE | 单向推送足够 |
- WebSocket让WordPress拥有实时功能。2026年,实时用户体验已成为标准。 立即行动:用Node.js + WebSocket为你的WordPress添加实时评论功能!
本文详解如何为WordPress添加实时功能(实时评论、通知、协同编辑)。
WebSocket(RFC 6455):
- 全双工通信(Full-duplex)
- 单个TCP连接(持久连接)
- 低延迟(< 50ms)
- 替代HTTP轮询(Polling)
vs HTTP轮询:
- HTTP轮询:频繁发起HTTP请求(浪费资源)
- WebSocket:建立连接后,服务端主动推送(高效)
传统WordPress(静态):
- 评论需要刷新页面才能看到
- 通知需要手动检查
- 无协同编辑(多人同时编辑冲突)
实时WordPress:
- 新评论实时显示(无需刷新)
- 通知实时推送(类似Facebook)
- 协同编辑(类似Google Docs)
# 创建项目目录
mkdir wp-realtime && cd wp-realtime
npm init -y
npm install ws express cors dotenv
npm install -D nodemon
// server.js
const WebSocket = require('ws');
const express = require('express');
const cors = require('cors');
const http = require('http');
const app = express();
app.use(cors());
app.use(express.json());
// 创建HTTP服务器
const server = http.createServer(app);
// 创建WebSocket服务器
const wss = new WebSocket.Server({ server });
// 存储连接的客户端
const clients = new Map();
wss.on('connection', (ws, req) => {
console.log('新客户端连接');
// 分配客户端ID
const clientId = Date.now();
clients.set(ws, clientId);
// 接收消息
ws.on('message', (message) => {
const data = JSON.parse(message);
// 广播消息给所有客户端
clients.forEach((id, client) => {
if (client.readyState === WebSocket.OPEN) {
client.send(JSON.stringify({
type: 'new_comment',
postId: data.postId,
comment: data.comment,
author: data.author,
}));
}
});
});
// 连接关闭
ws.on('close', () => {
console.log('客户端断开连接');
clients.delete(ws);
});
});
// REST API:获取在线用户数
app.get('/api/online-users', (req, res) => {
res.json({ count: clients.size });
});
const PORT = process.env.PORT || 8080;
server.listen(PORT, () => {
console.log(`WebSocket服务器运行在端口 ${PORT}`);
});
# 开发模式(自动重载)
npx nodemon server.js
node server.js
jQuery(document).ready(function($) {
// 连接WebSocket服务器
const ws = new WebSocket('wss://realtime.example.com:8080');
// 连接成功
ws.onopen = () => {
console.log('WebSocket连接成功');
};
// 接收消息
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
if (data.type === 'new_comment') {
// 显示新评论(无需刷新)
$('#comments').append(`
${data.author}: ${data.comment}
`);
}
};
// 提交评论时,通过WebSocket广播
$('#commentform').on('submit', function(e) {
e.preventDefault();
const comment = $('#comment').val();
const postId = $('#post_id').val();
const author = $('#author').val();
// 发送到WebSocket服务器
ws.send(JSON.stringify({
type: 'new_comment',
postId: postId,
comment: comment,
author: author,
}));
// 同时提交到WordPress(持久化)
$(this).submit(); // 正常提交
});
});
// 安装WP REST API扩展(允许WebSocket服务器调用)
add_action('rest_api_init', 'register_comment_endpoint');
function register_comment_endpoint() {
register_rest_route('wp/v2', '/add_comment', [
'methods' => 'POST',
'callback' => 'add_comment_callback',
'permission_callback' => '__return_true',
]);
}
function add_comment_callback($request) {
$params = $request->get_json_params();
$comment_id = wp_insert_comment([
'comment_post_ID' => $params['post_id'],
'comment_content' => $params['comment'],
'comment_author' => $params['author'],
'comment_approved' => 1,
]);
return rest_ensure_response(['comment_id' => $comment_id]);
}
-- 创建通知表
CREATE TABLE wp_notifications (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
user_id BIGINT NOT NULL,
type VARCHAR(50) NOT NULL, -- 'comment', 'like', 'follow'
content TEXT NOT NULL,
link VARCHAR(255) NOT NULL,
is_read TINYINT DEFAULT 0,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);
// 当有新评论时,创建通知
add_action('wp_insert_comment', 'create_notification', 10, 2);
function create_notification($comment_id, $comment) {
$post = get_post($comment->comment_post_ID);
$post_author_id = $post->post_author;
global $wpdb;
$wpdb->insert('wp_notifications', [
'user_id' => $post_author_id,
'type' => 'comment',
'content' => $comment->comment_content,
'link' => get_permalink($post->ID) . '#comment-' . $comment_id,
'is_read' => 0,
'created_at' => current_time('mysql'),
]);
// 通过WebSocket推送通知
push_notification($post_author_id, [
'type' => 'new_notification',
'content' => $comment->comment_content,
'link' => get_permalink($post->ID),
]);
}
function push_notification($user_id, $data) {
// 调用Node.js WebSocket服务器API
$ch = curl_init('https://realtime.example.com:8080/push');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'user_id' => $user_id,
'data' => $data,
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_exec($ch);
curl_close($ch);
}
// 连接WebSocket(接收通知)
const ws = new WebSocket('wss://realtime.example.com:8080');
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
if (data.type === 'new_notification') {
// 显示通知气泡
showNotification(data.content, data.link);
// 更新未读计数
updateUnreadCount();
}
};
function showNotification(content, link) {
// 桌面通知(浏览器权限)
if (Notification.permission === 'granted') {
new Notification('新通知', {
body: content,
icon: '/icon.png',
tag: link,
});
}
// 页面内通知(类似Facebook下拉)
$('#notification-dropdown').prepend(`
`);
}
# 安装ShareDB
npm install sharedb ws express
// collaborative-server.js
const ShareDB = require('sharedb');
const WebSocket = require('ws');
const express = require('express');
const app = express();
const server = require('http').createServer(app);
const wss = new WebSocket.Server({ server });
const backend = new ShareDB();
const connection = backend.connect();
wss.on('connection', (ws) => {
const stream = WebSocketJSONStream(ws);
backend.listen(stream);
});
server.listen(8080, () => {
console.log('协同编辑服务器运行在端口 8080');
});
// 使用WebSocketJSONStream(需要安装)
// npm install @teamwork/websocket-json-stream
// 协同编辑(使用ShareDB)
import { Connection } from 'sharedb/lib/client';
const socket = new WebSocket('wss://realtime.example.com:8080');
const connection = new Connection(socket);
// 打开文档(按Post ID)
const doc = connection.get('posts', postId);
doc.subscribe((err) => {
if (err) throw err;
// 初始化内容
if (!doc.type) {
doc.create('text'); // 创建Text类型(支持协同编辑)
}
// 绑定到textarea
const textarea = document.getElementById('post-content');
textarea.value = doc.data;
// 监听本地修改
textarea.addEventListener('input', () => {
doc.submitOp([{ retain: textarea.value.length }]); // 简化示例
});
// 监听远程修改
doc.on('op', (op, source) => {
if (!source) {
textarea.value = doc.data; // 更新内容
}
});
});
# 安装PM2
npm install -g pm2
pm2 start server.js --name wp-realtime
pm2 status
pm2 logs wp-realtime
pm2 startup
pm2 save
# /etc/nginx/sites-available/realtime.example.com
server {
listen 80;
server_name realtime.example.com;
location / {
proxy_pass http://localhost:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
# 超时设置(WebSocket长连接)
proxy_read_timeout 86400;
proxy_send_timeout 86400;
}
}
# 使用Let's Encrypt
certbot --nginx -d realtime.example.com
// 使用Redis Pub/Sub(多服务器之间同步消息)
const redis = require('redis');
const publisher = redis.createClient();
const subscriber = redis.createClient();
// 订阅频道
subscriber.subscribe('wp_comments');
// 接收消息
subscriber.on('message', (channel, message) => {
// 广播给所有WebSocket客户端
wss.clients.forEach((client) => {
if (client.readyState === WebSocket.OPEN) {
client.send(message);
}
});
});
// 发布消息
function broadcast(message) {
publisher.publish('wp_comments', JSON.stringify(message));
}
// SSE(简单场景:只需要服务端推送,不需要客户端发送)
app.get('/events', (req, res) => {
res.setHeader('Content-Type', 'text/event-stream');
res.setHeader('Cache-Control', 'no-cache');
res.setHeader('Connection', 'keep-alive');
// 每隔5秒推送一次
const intervalId = setInterval(() => {
res.write(`data: ${JSON.stringify({ time: new Date() })}\n\n`);
}, 5000);
// 客户端断开连接
req.on('close', () => {
clearInterval(intervalId);
});
});
// 前端JavaScript(SSE客户端)
const eventSource = new EventSource('/events');
eventSource.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log('新数据:', data);
};
| 场景 | 技术方案 | 理由 |
|------|----------|------|
| 实时评论 | WebSocket | 双向通信 |
| 实时通知 | WebSocket + SSE | 低延迟 |
| 协同编辑 | ShareDB + WebSocket | 冲突解决 |
| 股票/加密货币价格 | SSE | 单向推送足够 |
WebSocket让WordPress拥有实时功能。2026年,实时用户体验已成为标准。
立即行动:用Node.js + WebSocket为你的WordPress添加实时评论功能!

评论(0)