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

Cách bật module Swoole cho PHP trong ServBay ​

ServBay là môi trường phát triển Web cục bộ mạnh mẽ, tích hợp hàng loạt công cụ và tiện ích mở rộng cần thiết cho lập trình viên, trong đó có Swoole - tiện ích mở rộng PHP hiệu suất cao. Swoole là một engine giao tiếp mạng bất đồng bộ, song song, hiệu năng cao được thiết kế cho PHP, giúp tăng đáng kể hiệu suất và khả năng mở rộng của ứng dụng PHP. Bài viết này sẽ hướng dẫn bạn chi tiết cách kích hoạt Swoole trong ServBay, tận dụng tối đa sức mạnh của nó để xây dựng các ứng dụng và dịch vụ PHP tối ưu hơn.

Giới thiệu về framework Swoole ​

Swoole là một dự án mã nguồn mở, mang đến cho PHP các tính năng cao cấp như I/O bất đồng bộ, coroutine (đồng bộ bất đồng bộ), đa tiến trình tương tự Node.js. Nhờ đó, lập trình viên PHP có thể vượt qua rào cản của các mô hình web server truyền thống (Apache/Nginx + PHP-FPM), xây dựng các dịch vụ lưu trú bộ nhớ hiệu suất cao, bao gồm:

  • Cổng API hiệu suất cao
  • Ứng dụng giao tiếp thời gian thực (WebSocket)
  • Máy chủ game
  • Ứng dụng Internet of Things (IoT)
  • Dịch vụ nền và xử lý tác vụ

Các đặc điểm nổi bật của Swoole ​

  1. Hiệu suất cao: Sử dụng system call như epoll/kqueue để thực hiện I/O bất đồng bộ không chặn, kết hợp đa luồng/đa tiến trình/coroutine để đạt thông lượng cao, độ trễ thấp.
  2. Bất đồng bộ & Coroutine: Cung cấp khả năng coroutine, giúp bạn viết code bất đồng bộ theo phong cách tuần tự, nâng cao hiệu quả phát triển.
  3. Thành phần phong phú: Tích hợp sẵn HTTP, WebSocket, TCP, UDP server/client, connection pool, timer, quản lý tiến trình v.v.
  4. Dễ tích hợp: Tương thích với nhiều framework PHP phổ biến (Laravel, Symfony, ThinkPHP v.v.), hoặc dùng để xây dựng ứng dụng gốc thuần Swoole.

Hỗ trợ Swoole module trên ServBay ​

ServBay đã tích hợp sẵn tiện ích mở rộng Swoole cho nhiều phiên bản PHP, bạn không cần tải hoặc biên dịch thủ công. ServBay tự động quản lý phiên bản Swoole phù hợp với từng phiên bản PHP mà bạn chọn.

Hiện tại, ServBay hỗ trợ bật Swoole cho các phiên bản PHP sau:

  • PHP 5.6
  • Dòng PHP 7.x
  • Dòng PHP 8.x (bao gồm PHP 8.5)

ServBay sẽ tự động lựa chọn và cung cấp file mở rộng Swoole tương thích khi bạn chọn PHP version.

Các yêu cầu cần thiết ​

Trước khi bật Swoole, đảm bảo rằng:

  • Bạn đã cài đặt và chạy ServBay thành công.
  • Bạn đã cài và chọn phiên bản PHP mong muốn dùng Swoole trong ServBay.

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

ServBay cung cấp hai cách để kích hoạt Swoole: Giao diện đồ họa (GUI) và chỉnh sửa file cấu hình thủ công. Khuyên bạn ưu tiên giao diện GUI vì nhanh chóng và trực quan.

Bật Swoole qua ServBay GUI (Khuyên dùng) ​

Đây là cách đơn giản và nhanh nhất để bật Swoole:

  1. Mở giao diện đồ họa ServBay.
  2. Ở thanh điều hướng bên trái, chọn Languages (Ngôn ngữ).
  3. Nhấn vào PHP.
  4. Trong danh sách phiên bản PHP bên phải, tìm phiên bản bạn muốn bật Swoole (vd: PHP 8.3), đảm bảo phiên bản này đang được chọn (vòng tròn xanh).
  5. Nhấn nút Extensions (Tiện ích mở rộng) bên phải phiên bản PHP đó.
  6. Trong danh sách hiện ra, tìm swoole extension.
  7. Nhấn công tắc bên trái của swoole để bật lên (công tắc chuyển sang màu xanh).
  8. Nhấn Save (Lưu) hoặc Apply (Áp dụng) ở dưới cùng cửa sổ.
  9. ServBay sẽ nhắc bạn khởi động lại dịch vụ PHP để tải extension mới. Nhấn nút Restart (Khởi động lại).

Chờ dịch vụ khởi động lại xong, module Swoole đã được bật thành công.

Chỉnh sửa file cấu hình thủ công (Nâng cao) ​

Nếu cần cấu hình chi tiết hơn hoặc muốn tự kiểm soát, bạn có thể kích hoạt Swoole bằng cách sửa file ini của PHP.

  1. Xác định thư mục cấu hình conf.d tương ứng với phiên bản PHP bạn dùng. Thư mục này chứa các file cấu hình tiện ích mở rộng PHP, ServBay tự động tải mọi file .ini trong đây. Ví dụ với PHP 8.3, đường dẫn thường là:

    /Applications/ServBay/etc/php/8.3/conf.d/

    Nếu bạn cài ServBay ở nơi khác, hãy sửa lại đường dẫn cho đúng với cài đặt của mình.

  2. Tại thư mục này, tìm và mở file swoole.ini.

  3. Mặc định, dòng bật Swoole có thể bị chú thích bởi dấu ;. Tìm đoạn sau:

    ini
    [Swoole]
; Uncomment the following line to enable Swoole
;extension = swoole.so

  4. Xóa dấu ; để bỏ chú thích dòng extension = swoole.so:

    ini
    [Swoole]
; Uncomment the following line to enable Swoole
extension = swoole.so

  5. Lưu lại file swoole.ini.

  6. Quay lại giao diện GUI ServBay hoặc bảng quản lý dịch vụ, chọn PHP tương ứng và nhấn nút khởi động lại.

Sau khi dịch vụ khởi động lại, module Swoole sẽ được tải thành công theo cấu hình.

Kiểm tra Swoole đã được bật thành công chưa ​

Cách kiểm tra phổ biến nhất là dùng hàm phpinfo() để xem các module PHP đã được nạp.

  1. Tại thư mục gốc một website do ServBay quản lý (vd: /Applications/ServBay/www/servbay.demo/public/), tạo file tên là phpinfo.php.
  2. Mở file phpinfo.php và thêm vào:
    php
    <?php
phpinfo();
?>
  3. Đảm bảo website servbay.demo đã được tạo ra trên ServBay và trỏ đến đúng thư mục chứa file.
  4. Truy cập file này qua trình duyệt, ví dụ: https://servbay.demo/phpinfo.php.
  5. Trên trang phpinfo, cuộn xuống hoặc dùng tìm kiếm (Ctrl+F hoặc Cmd+F) với từ khóa "swoole".

Nếu bạn thấy thông tin về Swoole hiển thị (version, tuỳ chọn cấu hình…), nghĩa là module đã được bật và tải thành công.

Ảnh chụp màn hình phpinfo hiển thị Swoole đã được tải trong PHP trên ServBayMinh họa: Tìm thông tin Swoole trong trang phpinfo

Ví dụ sử dụng Swoole ​

Sau khi bật Swoole, bạn có thể bắt đầu viết ứng dụng với Swoole. Sau đây là ví dụ đơn giản về cách tạo một HTTP server cơ bản bằng Swoole.

Mã mẫu: Tạo HTTP server đơn giản với Swoole ​

  1. Tạo thư mục dự án Trong thư mục phát triển của bạn (vd: dưới /Applications/ServBay/www/), tạo một thư mục mới cho dự án, ví dụ my-swoole-app. Bên trong tạo tiếp thư mục public để chứa file vào trang.

    bash
    cd /Applications/ServBay/www/
mkdir my-swoole-app
cd my-swoole-app
mkdir public

  2. Tạo file vào server public/index.php

    php
    <?php

require __DIR__ . '/../vendor/autoload.php'; // Nếu bạn cài thêm thư viện khác qua Composer

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

// Tạo instance HTTP server, lắng nghe trên mọi IP cục bộ (0.0.0.0), cổng 9501
$server = new Server("0.0.0.0", 9501);

// Tuỳ chỉnh tham số máy chủ (tùy chọn)
// $server->set([
//     'worker_num' => 4, // Số lượng tiến trình worker
//     'daemonize' => false, // Có chạy nền hay không
// ]);

// Lắng nghe sự kiện yêu cầu HTTP
$server->on("request", function (Request $request, Response $response) {
    // Thiết lập header phản hồi
    $response->header("Content-Type", "text/plain");

    // Trả về nội dung phản hồi
    $response->end("Hello ServBay with Swoole!");
});

// Lắng nghe sự kiện server khởi động (tùy chọn)
$server->on("start", function (Server $server) {
    echo "Swoole http server is started at http://0.0.0.0:9501\n";
});

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

echo "Swoole server stopped.\n"; // Dòng này chỉ chạy khi server đã dừng

    Lưu ý: Dòng require __DIR__ . '/../vendor/autoload.php'; chỉ cần giữ lại nếu bạn có cài đặt các thư viện liên quan Swoole qua Composer (như swoole/ide-helper hoặc framework Swoole). Nếu chỉ chạy code thuần Swoole, bạn có thể xóa dòng này.

  3. Chạy server qua dòng lệnh Mở Terminal của ServBay hoặc Terminal hệ thống, truy cập vào thư mục dự án (/Applications/ServBay/www/my-swoole-app/). Đảm bảo terminal hiện tại đang dùng đúng PHP do ServBay quản lý (chạy which php để kiểm tra, hoặc dùng terminal của ServBay).

    Chạy lệnh sau để khởi động Swoole server:

    sh
    php public/index.php

    Nếu thành công, terminal sẽ hiển thị thông báo giống như "Swoole http server is started at http://0.0.0.0:9501".

    Chạy Swoole server qua dòng lệnhMinh họa: Chạy server Swoole ở Terminal

  4. Kiểm tra truy cập Khi server đang chạy, mở trình duyệt và truy cập http://localhost:9501. Bạn sẽ thấy nội dung "Hello ServBay with Swoole!".

    Để dừng Swoole server, nhấn Ctrl + C trong terminal.

Lưu ý khi sử dụng ​

  • Cách chạy: Ví dụ trên minh họa cách khởi động server Swoole trực tiếp qua dòng lệnh, thích hợp cho các dịch vụ lưu trú bộ nhớ. Với web-app truyền thống (Laravel, Symfony, WordPress...), bạn vẫn sẽ chạy dưới PHP-FPM và proxy qua Caddy hoặc Nginx. Nếu muốn chạy các framework PHP trong môi trường Swoole (như Hyperf, Swoole-Laravel...), thường sẽ dùng script khởi động riêng do framework cung cấp - cách chạy tương tự ví dụ trên, là một tiến trình độc lập.
  • Xung đột cổng: Server Swoole sẽ chiếm port đã chọn (ở ví dụ là 9501), hãy đảm bảo port này không bị chương trình khác chiếm.
  • Log lỗi: Lỗi hoặc output của Swoole thường in trực tiếp ra terminal hoặc ghi vào file log như cấu hình.

Câu hỏi thường gặp (FAQ) ​

Hỏi: Tôi đã bật Swoole trong GUI ServBay nhưng không thấy thông tin Swoole trên trang phpinfo(), phải làm sao?

Đáp: Vui lòng kiểm tra lại các điểm sau:

  1. Đảm bảo bạn đang xem đúng trang phpinfo() của phiên bản PHP đã kích hoạt Swoole. ServBay có thể chạy song song nhiều phiên bản PHP; hãy chắc chắn truy cập website/dùng dòng lệnh với đúng PHP version.
  2. Sau khi bật Swoole nhớ lưu và khởi động lại dịch vụ PHP tương ứng trong GUI ServBay.
  3. Nếu bạn sửa file swoole.ini thủ công, kiểm tra lại đường dẫn file, tên file, và đảm bảo dòng extension = swoole.so không bị chú thích.

Hỏi: Khi chạy ví dụ Swoole bị lỗi Class 'Swoole\Http\Server' not found, nguyên nhân?

Đáp: Lỗi này thường là do tiện ích mở rộng Swoole chưa được tải vào môi trường PHP đang dùng. Hãy kiểm tra lại quy trình bật Swoole ở trên, đồng thời chắc chắn bạn đang chạy lệnh php public/index.php bằng chính PHP do ServBay quản lý, đã bật Swoole. Chạy lệnh php -m | grep swoole để chắc chắn PHP CLI hiện tại đã nạp module Swoole.

Tổng kết ​

Với ServBay, việc bật tiện ích mở rộng Swoole cho PHP trở nên cực kỳ dễ dàng. Dù qua giao diện đồ họa trực quan hay chỉnh sửa file cấu hình thủ công, bạn đều có thể nhanh chóng kích hoạt Swoole cho các phiên bản PHP mong muốn, từ đó mở ra thế giới phát triển ứng dụng web hiệu năng cao, bất đồng bộ. Nhờ sức mạnh của Swoole, bạn dễ dàng xây dựng các dịch vụ PHP phản hồi nhanh, khả năng song song vượt trội, khai thác tối đa tiềm năng của PHP cho phát triển web hiện đại. ServBay mang đến hệ thống quản lý môi trường tiện lợi, cho phép bạn tập trung vào code thay vì loay hoay với cấu hình.