必须严格按顺序执行：确认PHP（7.4+）和Composer已安装并加入PATH；用composer create-project workerman/webman创建完整项目骨架；运行脚本解除pcntl等函数禁用并重启PHP服务；执行php start.php start，用netstat/lsof验证2345端口监听，浏览器访问http://127.0.0.1:2345出现欢迎页即成功。
Workerman新手想在本地电脑上一次性装好运行环境，避免反复重装、端口冲突、函数禁用导致服务启动失败，必须严格按顺序执行以下操作。
确认PHP和Composer已就位
这一步跳过会导致后续所有命令报错“command not found”。打开终端（Windows用CMD或Git Bash，macOS/Linux用Terminal），依次执行：
php -v → 查看PHP版本，【必须为7.4或8.0+】；
composer --version → 若提示“不是内部或外部命令”，说明Composer未安装或未加入系统PATH；
若任一命令失败，请先安装PHP（推荐使用XAMPP/WAMP/MAMP集成包）并手动将PHP和Composer路径添加进系统环境变量，否则无法继续。
一键安装Workerman项目骨架
不要直接 composer require workerman/workerman —— 这只装框架库，不带路由、配置、启动脚本，新手根本跑不起来。
方法一：创建全新Webman项目（推荐）
在空白文件夹内执行：composer create-project workerman/webman；
等待下载完成，会自动生成完整可运行结构，含 start.php、config/、app/ 等目录；
方法二：已有ThinkPHP项目接入
进入TP5.1+项目根目录，执行：composer require topthink/think-worker；
【注意：必须是TP5.1.20+且已启用命令行模式，否则会提示“Class think\Console not found”】。
解除关键PHP函数禁用
Workerman依赖 pcntl_fork、posix_kill、proc_open 等函数，很多一键环境（如宝塔、WAMP）默认禁用它们。
第一步：运行检测脚本：curl -sS https://www.workerman.net/webman/fix-disable-functions | php；
第二步：若输出显示“以下函数被禁用”，则需手动编辑 php.ini；
找到 disable_functions = 行，删除其中的 pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_exec,pcntl_kill,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,proc_open,proc_get_status,shell_exec,system,passthru,exec；
第三步：重启PHP服务（Apache/Nginx/PHP-FPM），再运行 php -m | grep pcntl 确认扩展已加载。
启动服务并验证端口监听
进入项目根目录（含 start.php 的目录），执行：
第一步：php start.php start → 启动开发模式（前台运行，方便看日志）；
第二步：观察终端是否输出 Workerman[xxx] start in DEBUG mode 及进程PID列表；
第三步：另开一个终端，执行 netstat -ano | findstr :2345（Windows）或 lsof -i :2345（macOS/Linux）；
若看到 LISTEN 状态且 PID 对应刚启动的 php 进程，则服务已成功监听；
第四步：浏览器访问 http://127.0.0.1:2345，出现 Webman 默认欢迎页即为安装成功。
