PHP Webman环境搭建指南_手把手教你如何安装Webman高性能框架【入门】-php教程-PHP中文网

webman启动失败主因是pcntl或posix扩展未启用，或proc_open、pcntl_fork等函数被disable_functions禁用；需依次验证php≥7.4、php -m含pcntl/posix、php -i中disable_functions不包含关键函数。

php webman环境搭建指南_手把手教你如何安装webman高性能框架【入门】

Webman 启动失败，八成是 pcntl 或 posix 扩展没启用，或者 proc_open、pcntl_fork 被禁用了——不是版本低，而是函数/扩展被拦在门外。

检查 PHP 是否真满足 Webman 最低要求

Webman 不是“PHP ≥ 7.4”就万事大吉。它依赖底层进程控制能力，必须同时满足三个条件：版本达标、扩展加载、函数未被禁用。

运行 php -v 确认输出为 PHP 7.4.x 或更高（推荐 8.1/8.2）
执行 php -m | grep -E "pcntl|posix"，必须同时看到两行输出；缺一个就启动不了守护模式
运行 php -i | grep disable_functions，输出里不能出现 proc_open、pcntl_fork、pcntl_wait、putenv 等关键词
若发现被禁用，找到 php.ini（用 php --ini 查路径），编辑 disable_functions 行，删掉上述函数，保存后重启 CLI 环境（Linux/macOS 可直接新开终端）

为什么不能用 `composer require workerman/webman`

composer require 只装包，不建骨架。Webman 的 start.php、app/、config/、public/ 等目录结构和自动加载规则，只在 create-project 时生成。

btpanel phpsite 宝塔面板PHP网站

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

下载

错误做法：composer init && composer require workerman/webman → 结果是 vendor 里有代码，但没 start.php，运行报错 Class 'Webman\App' not found
正确命令：composer create-project workerman/webman myapp（myapp 是你的项目名）
网络慢或超时？去 GitHub Releases 下载 webman-x.x.x.zip（不是 Source code），解压后进目录执行 composer install
Windows 用户注意：别双击 start.php，要进 CMD 运行 php start.php start，否则看不到错误输出

`php start.php start` 启动后秒退怎么办

常见于扩展缺失、函数被禁、或 runtime/ 目录不可写。终端没报错，只闪一下就消失，大概率是进程 fork 失败。

先加 -d 参数前台运行：php start.php start -d，强制显示完整错误栈
检查 runtime/ 目录权限：Linux/macOS 执行 ls -ld runtime，确保当前用户有读写权；Windows 检查文件夹属性是否勾选了“只读”
确认 config/server.php 中 'pid_file' 和 'log_file' 路径指向 runtime/ 下，且路径存在（如 runtime/webman.pid）
如果报 pcntl_fork() has been disabled，说明上一步的 disable_functions 没改对，再跑一遍 php -i | grep disable_functions 核对

Nginx 反向代理配置要点

Webman 默认监听 http://0.0.0.0:8787，生产环境必须绑定 127.0.0.1 并用 Nginx 做前置，否则端口暴露风险极高。

先改 start.php：找到 $worker->listen('http://0.0.0.0:8787')，改成 $worker->listen('http://127.0.0.1:8787')

Nginx server 块里加反代配置：

location / {
    proxy_pass http://127.0.0.1:8787;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}