宝塔面板下怎么安装Workerman5.2.3

雨萱同学_4063

雨萱同学_4063

2026-10-25

851人浏览

原创

宝塔面板不提供workerman一键安装,需在宝塔php环境中手动集成:启用pcntl、posix及event扩展,用composer安装workerman/workerman:v5.2.3,创建server.php启动脚本并守护运行。

宝塔面板下怎么安装workerman5.2.3

宝塔面板本身不直接提供 Workerman 的一键安装,但你可以通过标准 PHP 环境 + Composer 方式,在宝塔管理的网站或项目目录中集成 Workerman 5.2.3。关键不是“装到面板里”,而是让 Workerman 在宝塔托管的 PHP 环境中正常运行。

确认 PHP 环境支持必要扩展

Workerman 5.x(包括 5.2.3)依赖以下 PHP 扩展,必须启用:

  • pcntl:用于多进程,Linux 下必需(Windows 不支持,不可用)
  • posix:进程控制基础支持
  • event(推荐)或 libevent:提升高并发 I/O 性能(非强制但强烈建议)

在宝塔面板 → 网站 → 对应站点 → PHP 版本 → 设置 → 安装扩展,勾选并安装 pcntl 和 posix;若需 event 扩展,先确认系统已安装 libevent-devel(CentOS/AlmaLinux 运行:yum install libevent-devel -y),再通过宝塔的「PHP 扩展」页面编译安装 event(宝塔 7.9+ 支持一键安装 event 扩展)。

用 Composer 安装 Workerman 5.2.3

进入你的项目根目录(如 /www/wwwroot/myapp),在宝塔终端中执行:

cd /www/wwwroot/myapp
composer require workerman/workerman:v5.2.3

注意:

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • 确保已安装 Composer(宝塔终端执行 composer -v 可验证;未安装则运行 curl -sS https://getcomposer.org/installer | php && mv composer.phar /usr/local/bin/composer)
  • 若提示 proc_open 报错,说明 PHP 禁用了该函数——进入宝塔 PHP 设置 → 禁用函数列表,移除 proc_open
  • 若提示版本冲突,可临时指定 PHP CLI 使用宝塔对应版本,例如:/www/server/php/81/bin/php /usr/local/bin/composer require workerman/workerman:v5.2.3

创建并运行 Workerman 服务脚本

新建一个启动文件,例如 server.php:

<?php use Workerman\Worker;
require_once __DIR__ . '/vendor/autoload.php';

$http_worker = new Worker('http://0.0.0.0:8080');
$http_worker->count = 2;
$http_worker->onMessage = function($connection, $data) {
    $connection->send("Workerman 5.2.3 running OK");
};
Worker::runAll();

保存后,在终端执行启动命令:

php server.php start -d

加 -d 表示守护进程模式。可通过 ps aux | grep server.php 查看是否运行成功。

配合宝塔计划任务做进程守护(可选但推荐)

Workerman 进程可能意外退出。可在宝塔「计划任务」中添加每分钟检测脚本:

  • 任务类型:Shell 脚本
  • 执行周期:N 分钟(建议填 1)
  • 脚本内容:
#!/bin/bash
if ! pgrep -f "server.php" > /dev/null; then
    cd /www/wwwroot/myapp
    /www/server/php/81/bin/php server.php start -d
fi

其中 /www/server/php/81/bin/php 请替换为你实际使用的 PHP 路径(可在宝塔 PHP 设置页查看)。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
开发工具有哪些
开发工具有哪些

开发工具有:1、集成开发环境IDE;2、版本控制系统VCS;3、自动化构建工具;4、测试工具;5、代码分析工具。本专题为大家提供开发工具有哪些的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2806

5

Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

2026.05.20

206

15

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

2026.05.20

222

12

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

2026.05.20

207

13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

20

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

20

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

20

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

2026.10.22

0

10

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

2026.10.22

20

25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
宝塔入门指引手册
宝塔入门指引手册

共0课时 | 0人学习

宝塔官方实践教程
宝塔官方实践教程

共0课时 | 0人学习