ServBay

Tiếng Việt

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Türkçe
Italiano

Tiếng Việt

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Türkçe
Italiano

Appearance

Xây Dựng Ứng Dụng PHP Hiệu Năng Cao Với Swoole Trên ServBay ​

ServBay là một môi trường phát triển web local được thiết kế dành riêng cho lập trình viên, được tích hợp sẵn nhiều nền tảng ngôn ngữ, cơ sở dữ liệu và công cụ hỗ trợ, giúp đơn giản hóa quy trình phát triển local. Bài viết này sẽ hướng dẫn bạn cách tận dụng extension Swoole trong môi trường ServBay để tăng sức mạnh cho ứng dụng PHP của mình, từ đó xây dựng các dịch vụ mạng hiệu năng cao.

Swoole Là Gì? ​

Swoole là một engine truyền thông mạng song song, hiệu năng cao dựa trên coroutine, được thiết kế dành riêng cho PHP. Được viết hoàn toàn bằng C, Swoole cung cấp cho PHP khả năng lập trình mạng bất đồng bộ, song song và dựa trên coroutine. Nhờ đó, lập trình viên PHP có thể vượt qua giới hạn mô hình request-response của các web server truyền thống (như Apache/Nginx + PHP-FPM) để xử lý hiệu quả các tác vụ đồng thời lớn, ví dụ như xây dựng web server chạy thường trú trong bộ nhớ, xử lý tác vụ bất đồng bộ, dịch vụ truyền thông thời gian thực (ví dụ WebSocket), và nhiều hơn nữa.

Những điểm nổi bật của Swoole:

  • Hiệu năng cao: Được phát triển bằng ngôn ngữ C, hỗ trợ I/O bất đồng bộ, đa tiến trình/đa luồng.
  • Coroutine: Hỗ trợ coroutine nhẹ, giúp bạn viết code bất đồng bộ theo phong cách đồng bộ, đơn giản hóa mô hình lập trình.
  • Đa dạng giao thức: Hỗ trợ native nhiều giao thức mạng: TCP, UDP, HTTP, WebSocket,...
  • Dễ sử dụng: Cung cấp API rõ ràng, phù hợp với thói quen lập trình PHP.
  • Thường trú trong bộ nhớ: Ứng dụng có thể chạy như một tiến trình thường trực, giảm bớt overhead khởi tạo môi trường trong mỗi request như PHP truyền thống.

Với Swoole, PHP không còn đơn thuần là ngôn ngữ viết web script mà có thể đảm nhiệm các ứng dụng mạng phức tạp với yêu cầu hiệu năng cao.

Bật Swoole Trong ServBay ​

Một trong những mục tiêu thiết kế của ServBay là giúp lập trình viên dễ dàng quản lý và sử dụng các extension PHP cũng như các môi trường phát triển khác nhau. Swoole, extension chủ chốt cho phát triển PHP hiệu năng cao hiện đại, đã được tích hợp sẵn trên ServBay. Bạn chỉ cần một vài thao tác đơn giản để kích hoạt.

Điều kiện:

  • Đã cài đặt và chạy ServBay.
  • Đảm bảo trong ServBay đã có ít nhất một phiên bản PHP.

Các bước kích hoạt:

  1. Mở giao diện ứng dụng ServBay.
  2. Đi đến mục “Packages” hoặc trình quản lý phiên bản PHP. (Lưu ý: tên menu tùy vào phiên bản ServBay, thường nằm ở giao diện chính hoặc phần cài đặt)
  3. Chọn phiên bản PHP mà bạn muốn kích hoạt Swoole.
  4. Tìm phần cài đặt extension Swoole và đánh dấu bật tính năng này. Thường các extension đã được build sẵn ở dạng danh sách hoặc nút bật/tắt.
  5. Lưu thay đổi và thực hiện khởi động lại ServBay hoặc dịch vụ PHP tương ứng (theo hướng dẫn). ServBay sẽ tự động cấu hình môi trường PHP để nạp extension Swoole.

Sau khi hoàn thành các bước trên, bạn đã có thể sử dụng Swoole trong phiên bản PHP đã chọn. Có thể xác minh bằng cách dùng lệnh php -m và kiểm tra xem swoole có xuất hiện trong danh sách extension đã tải hay chưa.

TIP

ServBay mặc định khuyến nghị bạn đặt mã nguồn website và các file dự án vào thư mục /Applications/ServBay/www để tiện cho việc quản lý, cấu hình website. Các ví dụ trong bài viết này cũng sẽ sử dụng đường dẫn đề xuất này.

Xây Dựng Web Server HTTP Đơn Giản Với Swoole ​

Phần tiếp theo, chúng ta cùng tạo một server HTTP cơ bản bằng Swoole để minh họa cách xử lý các request web.

Bước 1: Tạo thư mục dự án

Mở Terminal, tạo và di chuyển vào thư mục dự án mới. Làm theo khuyến nghị của ServBay, đặt dự án dưới /Applications/ServBay/www:

bash
cd /Applications/ServBay/www
mkdir servbay-swoole-http
cd servbay-swoole-http

Bước 2: Viết script server

Trong thư mục servbay-swoole-http, tạo file server.php với nội dung sau:

php
<?php

use Swoole\Http\Server;
use Swoole\Http\Request;
use Swoole\Http\Response;

// Tạo instance server HTTP Swoole
// Lắng nghe trên mọi địa chỉ mạng (0.0.0.0), cổng 9501
$server = new Server("0.0.0.0", 9501);

// Đăng ký hàm callback cho sự kiện 'start'
// Sẽ được gọi khi server khởi động thành công
$server->on("start", function (Server $server) {
    echo "Swoole HTTP server is started at http://0.0.0.0:9501\n";
    // Có thể ghi lại PID tiến trình chính, tiến trình quản lý, v.v. tại đây
});

// Đăng ký callback cho sự kiện 'request'
// Sẽ được gọi khi có HTTP request mới gửi đến
$server->on("request", function (Request $request, Response $response) {
    // Thiết lập header phản hồi
    $response->header("Content-Type", "text/plain");

    // Xử lý logic dựa vào path hoặc tham số request
    $path = $request->server['request_uri'] ?? '/';
    $content = "Hello ServBay!";

    if ($path === '/info') {
        $content = "Request path: " . $path . "\n";
        $content .= "Method: " . $request->server['request_method'] . "\n";
        $content .= "Client IP: " . $request->server['remote_addr'] . "\n";
        // Có thể lấy thêm thông tin yêu cầu thông qua object $request
    }

    // Gửi nội dung response và kết thúc request
    $response->end($content);
});

// Khởi động server
$server->start();

Script trên tạo một server HTTP bằng Swoole lắng nghe tại cổng 9501. Khi có request gửi tới, server phản hồi bằng chuỗi text đơn giản "Hello ServBay!". Nếu truy cập đường dẫn /info, server sẽ trả về thông tin về request nhận được.

Bước 3: Chạy server Swoole

Đảm bảo Terminal đang ở thư mục servbay-swoole-http. Dùng phiên bản PHP đã bật Swoole trong ServBay để chạy script:

bash
php server.php

Nếu mọi thứ đúng, bạn sẽ thấy terminal in ra:

bash
Swoole HTTP server is started at http://0.0.0.0:9501

Điều này xác nhận server đang hoạt động và lắng nghe cổng 9501.

Bước 4: Truy cập server Swoole

Mở trình duyệt web, truy cập các địa chỉ sau:

  • http://localhost:9501
  • http://localhost:9501/info

Trình duyệt sẽ hiển thị lần lượt Hello ServBay! hoặc thông tin về request tùy endpoint.

Để dừng server, hãy quay lại cửa sổ terminal chạy script và nhấn Ctrl + C.

Xử Lý Kết Nối WebSocket Với Swoole ​

Swoole hỗ trợ native giao thức WebSocket, rất phù hợp để xây dựng ứng dụng truyền thông thời gian thực như chatroom, game server, push data realtime...

Bước 1: Tạo script server WebSocket

Trong thư mục /Applications/ServBay/www/servbay-swoole-http (hoặc tạo một thư mục mới như servbay-swoole-websocket), tạo file websocket_server.php với nội dung:

php
<?php

use Swoole\WebSocket\Server;
use Swoole\Http\Request;
use Swoole\WebSocket\Frame;

// Tạo instance server WebSocket Swoole
// Server WebSocket kế thừa server HTTP nên cũng có thể xử lý HTTP request
$server = new Server("0.0.0.0", 9502); // Lắng nghe cổng 9502

// Đăng ký sự kiện 'start' khi server khởi động
$server->on("start", function (Server $server) {
    echo "Swoole WebSocket server is started at ws://0.0.0.0:9502\n";
});

// Đăng ký sự kiện 'open'
// Được gọi khi có kết nối WebSocket mới thành công
// Object $request chứa thông tin kết nối, vd: $request->fd là file descriptor
$server->on("open", function (Server $server, Request $request) {
    echo "connection open: {$request->fd}\n";
    // Có thể gửi thông điệp chào mừng tới client
    $server->push($request->fd, "Welcome to ServBay WebSocket Demo!");
});

// Đăng ký sự kiện 'message'
// Được gọi khi server nhận được message WebSocket từ client
// Object $frame chứa nội dung message ($frame->data) và fd của client gửi
$server->on("message", function (Server $server, Frame $frame) {
    echo "received message from {$frame->fd}: {$frame->data}\n";
    // Gửi lại message cho client hoặc broadcast cho tất cả
    // Ví dụ: gửi lại cho người gửi
    $server->push($frame->fd, "Hello, you sent: {$frame->data}");

    // Ví dụ broadcast (cần duy trì danh sách connection, hoặc dùng vòng lặp)
    // foreach ($server->connections as $fd) {
    //     if ($fd != $frame->fd) { // Không gửi cho bản thân người gửi
    //         $server->push($fd, "User {$frame->fd} says: {$frame->data}");
    //     }
    // }
});

// Đăng ký sự kiện 'close'
// Được gọi khi client ngắt kết nối
$server->on("close", function ($ser, $fd) {
    echo "connection close: {$fd}\n";
});

// Khởi động server
$server->start();

Script này tạo một server WebSocket trên cổng 9502, định nghĩa các callback cho các sự kiện then chốt: start (khởi động), open (kết nối mới), message (nhận message), close (ngắt kết nối). Khi có message, server sẽ gửi lại message này với prefix "Hello, you sent:" tới client gửi đến.

Bước 2: Chạy server WebSocket

Đảm bảo đang ở thư mục chứa file websocket_server.php. Dùng PHP (đã bật Swoole trong ServBay) để chạy:

bash
php websocket_server.php

Kết quả mong đợi trên terminal:

bash
Swoole WebSocket server is started at ws://0.0.0.0:9502

Xác nhận server WebSocket đã hoạt động và lắng nghe trên cổng 9502.

Bước 3: Kết nối đến server WebSocket

Bạn có thể dùng nhiều cách để kiểm tra connection tới server WebSocket.

Cách A: Dùng công cụ lập trình viên của trình duyệt

Hầu hết trình duyệt hiện đại đều có DevTools (bấm F12), vào tab “Console” hoặc “Network”.

  1. Mở một trang web bất kỳ (ví dụ about:blank).

  2. Vào DevTools, chuyển sang tab “Console”.

  3. Thực thi đoạn JavaScript sau để kết nối:

    javascript
    var ws = new WebSocket("ws://localhost:9502");

ws.onopen = function(event) {
  console.log("WebSocket connection opened:", event);
  ws.send("Hello from Browser!"); // Gửi message ngay khi kết nối thành công
};

ws.onmessage = function(event) {
  console.log("Message from server:", event.data); // Nhận message từ server
};

ws.onerror = function(event) {
  console.error("WebSocket error:", event); // Bắt lỗi
};

ws.onclose = function(event) {
  console.log("WebSocket connection closed:", event); // Đóng kết nối
};

// Có thể gửi thêm message qua ws.send("nội dung")
// Đóng kết nối với ws.close()

  4. Quan sát các log trong console. Đồng thời terminal chạy websocket_server.php cũng sẽ hiển thị log về kết nối và message.

Cách B: Dùng công cụ dòng lệnh wscat

wscat là client WebSocket tiện lợi trên dòng lệnh, được xây dựng bằng Node.js.

  1. Cài đặt wscat: Nếu chưa có Node.js và npm, hãy cài đặt trước. Sau đó dùng npm cài đặt toàn cục:

    bash
    npm install -g wscat

  2. Kết nối tới server WebSocket: Trên terminal chạy lệnh:

    bash
    wscat -c ws://localhost:9502

    Sau khi kết nối thành công, bạn sẽ thấy prompt >.

  3. Gửi message: Nhập bất kỳ thông điệp nào và nhấn Enter:

    bash
    > Hello ServBay via wscat

    Server sẽ nhận và phản hồi lại, thấy dòng reply với < ở đầu:

    bash
    < Hello, you sent: Hello ServBay via wscat

    Terminal chạy websocket_server.php cũng in log tương ứng.

Để ngắt kết nối wscat, nhấn Ctrl + C.

Lưu Ý Khi Sử Dụng ​

  • Xung đột cổng: Đảm bảo cổng server Swoole sử dụng (vd: 9501, 9502) không bị chiếm bởi ứng dụng khác, nếu trùng server sẽ không khởi động được.
  • Phiên bản PHP: Hãy luôn chắc chắn khi chạy các script PHP (server), bạn đang dùng đúng phiên bản PHP đã bật Swoole extension trong ServBay. Có thể kiểm tra phiên bản đang dùng với php -v. ServBay thường cung cấp công cụ chuyển đổi PHP cho terminal rất tiện.
  • Trạng thái extension: Nếu server không khởi động được, hãy kiểm tra lại extension Swoole đã thực sự được kích hoạt ở PHP đang dùng và đã khởi động lại ServBay hoặc PHP service để thiết lập có hiệu lực.
  • Quản lý tiến trình thường trú: Server Swoole là tiến trình thường trú. Môi trường production bạn nên dùng thêm các tool quản lý tiến trình như Supervisor, Systemd, pm2... để giám sát server và tự động khởi động lại khi gặp sự cố. Trong môi trường phát triển local với ServBay, chỉ cần chạy thủ công trên terminal là đủ.

Tổng Kết ​

Với ServBay, bạn hoàn toàn có thể bật và sử dụng extension Swoole một cách dễ dàng để xây dựng, thử nghiệm các ứng dụng PHP hiệu năng cao ngay trên local, dù đó là các dịch vụ HTTP truyền thống hay ứng dụng giao tiếp thời gian thực với WebSocket hiện đại. Sự kết hợp giữa sức mạnh Swoole và sự tiện lợi của ServBay sẽ mở ra nhiều khả năng mới cho lập trình viên PHP, giúp bạn xây dựng ứng dụng tối ưu, mạnh mẽ hơn bao giờ hết. Hãy thử trải nghiệm Swoole cùng ServBay ngay hôm nay!