Hướng dẫn cài đặt
Workerman thực chất là một gói mã PHP, nếu môi trường PHP của bạn đã được cài đặt, bạn chỉ cần tải mã nguồn Workerman hoặc demo xuống là có thể chạy.
Cài đặt bằng Composer:
composer require workerman/workermanLưu ý
Một số gương mẫu proxy của composer không đầy đủ, hãy sử dụng lệnh trêncomposer config -g --unset repos.packagistđể xóa proxy
Người dùng Windows (cần đọc)
Bắt đầu từ phiên bản workerman3.5.3, workerman đã có thể hỗ trợ đồng thời cả hệ thống windows và linux.
Người dùng Windows cần cấu hình biến môi trường php.
=== Các phần bên dưới chỉ áp dụng cho môi trường Linux workerman, người dùng Windows hãy bỏ qua ===
Kiểm tra môi trường hệ thống Linux
Hệ thống Linux có thể sử dụng script sau để kiểm tra môi trường PHP trên máy có đáp ứng yêu cầu chạy Workerman hay không.
curl -Ss https://www.workerman.net/check | php
Nếu script trên hiển thị tất cả là ok, thì điều đó có nghĩa là đáp ứng yêu cầu của Workerman, bạn có thể trực tiếp truy cập trang web chính thức để tải ví dụ về và chạy.
Nếu không phải tất cả đều ok, hãy tham khảo tài liệu bên dưới để cài đặt các phần mở rộng bị thiếu.
(Chú ý: script kiểm tra không kiểm tra phần mở rộng event, nếu số kết nối đồng thời trong công việc lớn hơn 1024, bạn phải cài đặt phần mở rộng event và tối ưu hóa kernel Linux, phương pháp cài đặt phần mở rộng tham khảo dưới đây)
Cài đặt phần mở rộng bị thiếu trong môi trường PHP hiện có
Cài đặt phần mở rộng pcntl và posix:
Hệ thống centos
Nếu PHP được cài đặt thông qua yum, hãy chạy lệnh yum install php-process để cài đặt phần mở rộng pcntl và posix.
Nếu cài đặt thất bại hoặc PHP không phải được cài đặt bằng yum, hãy tham khảo phần Phụ lục - Cài đặt phần mở rộng phương pháp 3 cài đặt bằng cách biên dịch mã nguồn.
Hệ thống debian/ubuntu/mac os
Tham khảo phần Phụ lục - Cài đặt phần mở rộng phương pháp 3 cài đặt bằng cách biên dịch mã nguồn.
Cài đặt phần mở rộng event:
Để hỗ trợ số lượng kết nối đồng thời lớn hơn, bạn cần cài đặt phần mở rộng event và tối ưu hóa kernel Linux. Phương pháp cài đặt như sau:
Hệ thống centos
1、Cài đặt gói libevent-devel phụ thuộc của phần mở rộng event, chạy lệnh
yum install libevent-devel -y
# Nếu không thể cài đặt, hãy thử sử dụng lệnh bên dưới
# yum install libevent2-devel -y2、Cài đặt phần mở rộng event, chạy lệnh
(phần mở rộng event yêu cầu PHP>=5.4)
pecl install eventLưu ý: Khi xuất hiện thông báo:Include libevent OpenSSL support [yes] : hãy nhập no và nhấn enter, các câu hỏi khác chỉ cần nhấn enter.
3、Chạyphp --ini tìm và mở file php.ini, thêm cấu hình sau vào dòng cuối cùng
extension=event.soCài đặt trên hệ thống debian/ubuntu
1、Cài đặt gói libevent-dev phụ thuộc của phần mở rộng event, chạy lệnh
apt-get install libevent-dev -y
# Nếu không thể cài đặt, hãy thử lệnh sau
# apt-get install libevent2-dev -y2、Cài đặt phần mở rộng event, chạy lệnh
pecl install eventLưu ý: Khi xuất hiện thông báo:Include libevent OpenSSL support [yes] : hãy nhập no và nhấn enter, các câu hỏi khác chỉ cần nhấn enter.
3、Chạyphp --ini tìm và mở file php.ini, thêm cấu hình sau vào dòng cuối cùng
extension=event.soHướng dẫn cài đặt trên hệ thống mac os
Hệ thống mac thường được sử dụng làm máy phát triển, không cần phải cài đặt phần mở rộng event.
Cài đặt hệ thống mới (cài đặt PHP+ phần mở rộng mới)
Hướng dẫn cài đặt trên hệ thống centos
1、Chạy lệnh (bước này bao gồm cài đặt chương trình chính php-cli cũng như các gói pcntl, posix, thư viện libevent và chương trình git)
yum install php-cli php-process git gcc php-devel php-pear libevent-devel -y2、Cài đặt phần mở rộng event, chạy lệnh
(Lưu ý: phần mở rộng event yêu cầu PHP>=5.4)
pecl install eventLưu ý: Khi xuất hiện thông báo:Include libevent OpenSSL support [yes] : hãy nhập no và nhấn enter, các câu hỏi khác chỉ cần nhấn enter.
3、Chạyphp --ini tìm và mở file php.ini, thêm cấu hình sau vào dòng cuối cùng
extension=event.so4、Chạy lệnh (bước này là tải chương trình chính Workerman từ github)
git clone https://github.com/walkor/Workerman5、Tham khảo Hướng dẫn bắt đầu - Phần ví dụ đơn giản viết file entry để chạy.
Hoặc tải demo đã đóng gói từ trang web chính thức và chạy.
Hướng dẫn cài đặt trên hệ thống debian/ubuntu
1、Chạy lệnh (bước này bao gồm cài đặt chương trình chính php-cli, thư viện libevent và chương trình git)
apt-get install php-cli git gcc php-pear php-dev libevent-dev -y2、Cài đặt phần mở rộng event, chạy lệnh
(Lưu ý: phần mở rộng event yêu cầu PHP>=5.4)
pecl install eventLưu ý: Khi xuất hiện thông báo:Include libevent OpenSSL support [yes] : hãy nhập no và nhấn enter, các câu hỏi khác chỉ cần nhấn enter.
3、Chạyphp --ini tìm và mở file php.ini, thêm cấu hình sau vào dòng cuối cùng
extension=event.so4、Chạy lệnh (bước này là tải chương trình chính Workerman từ github)
git clone https://github.com/walkor/Workerman5、Tham khảo Hướng dẫn bắt đầu - Phần ví dụ đơn giản viết file entry để chạy.
Hoặc tải demo đã đóng gói từ trang web chính thức và chạy.
Hướng dẫn cài đặt trên hệ thống mac os
Phương pháp 1: Hệ điều hành mac đi kèm PHP Cli, nhưng có thể thiếu phần mở rộng pcntl.
1、Tham khảo phần Phụ lục - Cài đặt phần mở rộng phương pháp 3 cài đặt phần mở rộng pcntl bằng cách biên dịch mã nguồn.
2、Tham khảo phần Phụ lục - Cài đặt phần mở rộng phương pháp 4 cài đặt phần mở rộng event bằng cách sử dụng phpize (bước này có thể bỏ qua vì đây là máy phát triển).
3、Tải chương trình chính Workerman từ https://www.workerman.net/download/workermanzip, hoặc tải ví dụ từ trang web chính thức và chạy.
Phương pháp 2: Cài đặt PHP và các phần mở rộng tương ứng bằng lệnh brew
1、Chạy lệnh sau để cài đặt công cụ brew (nếu bạn đã cài đặt brew, có thể bỏ qua bước này)
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"2、Chạy lệnh sau để cài đặt php
brew install php3、Chạy lệnh sau để cài đặt phần mở rộng event
brew install php-event 4、Tải ví dụ từ trang web chính thức và chạy
Giới thiệu về phần mở rộng Event
Phần mở rộng Event không phải là bắt buộc, khi công việc cần hỗ trợ lớn hơn 1000 kết nối đồng thời, nên cài đặt Event, có thể hỗ trợ rất nhiều kết nối đồng thời. Nếu số lượng kết nối đồng thời trong công việc tương đối thấp, chẳng hạn như dưới 1000 kết nối đồng thời, thì có thể không cần cài đặt.
Câu hỏi thường gặp
1、Nếu xuất hiện lỗi sau checking for include/event2/event.h... not found, hãy thử xóa thư viện libevent-dev(el) và cài đặt lại libevent2-dev(el).
Hệ thống centos: yum remove libevent-devel && yum install libevent2-devel
Hệ thống debian/ubuntu: apt-get remove libevent-dev && apt-get install libevent2-dev
2、Nếu xuất hiện lỗi sau NOTICE: PHP message: PHP Warning: PHP Startup: Unable to load dynamic library '.../event.so' - ..../event.so: undefined symbol: php_sockets_le_socket in Unknown on line 0。
Vui lòng thay đổi thứ tự tải của event.so và socket.so, tức là trong php.ini hãy viết extension=socket.so trước extension=event.so, để phần mở rộng socket được tải trước.