Webman启动失败、访问8787无响应、composer install报错，主因是PHP版本＜7.4或pcntl/posix扩展未启用；必须用composer create-project初始化，启动前确保runtime/可写、start.php有执行权，并前台运行验证日志输出。
Webman 启动失败、访问 8787 端口没反应、composer install 报错 —— 这些不是配置太复杂，而是几个关键环节没对齐。只要 PHP 版本 ≥7.4、pcntl 和 posix 扩展已启用，就能跑起来。
确认 PHP 环境是否真正满足 Webman 要求
Webman 不是“装完 PHP 就能跑”，它依赖底层进程控制能力。很多报错（比如 pcntl_fork() is not available 或启动后立即退出）都源于扩展缺失或被禁用。
-
php -v必须输出 7.4 或更高版本；PHP 8.0+ 更稳，尤其在高并发下 -
php -m | grep -E '^(pcntl|posix|event)$'要能同时看到这三项 ——event非强制但强烈推荐，能显著提升 IO 性能 - Windows 用户注意：
pcntl和posix在 Windows 下不可用，必须用 WSL2 或 Linux 服务器环境 - 宝塔面板用户：进「软件商店」→「PHP 设置」→「禁用函数」列表里，确保
pcntl_fork、pcntl_waitpid、posix_kill等未被勾选禁用
用 composer create-project 替代 git clone
直接克隆仓库容易漏掉 vendor 自动加载逻辑或触发权限问题，composer create-project 是官方推荐的初始化方式，它会自动执行 post-root-package-install 脚本，生成正确结构。
- 执行：
composer create-project workerman/webman（不加bash，那是文档笔误） - 完成后目录里应有
app/、config/、start.php等标准结构，且vendor/autoload.php可被正常加载 - 如果提示
zlib_decode(): data error或下载卡住，换国内镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com - 不要手动修改
composer.json后再composer update—— Webman 的依赖锁定很严格，随意升级可能破坏 workerman 内核兼容性
启动服务前必须检查 start.php 权限与运行模式
php start.php start 看似简单，但实际运行时会 fork 子进程。若当前用户无权写入 runtime/ 目录，或 SELinux/AppArmor 开启，服务会静默失败。
- 确保
runtime/目录可写：chmod -R 755 runtime/（Linux）或chown -R www-data:www-data runtime/（Nginx 用户场景） - 首次启动建议先前台运行：
php start.php start（不带-d），观察终端输出是否有Workerman[start.php] start in DEBUG mode和 worker 进程 PID 列表 - 若看到
PHP Warning: file_put_contents(.../pid): failed to open stream: Permission denied，说明pid_file路径（默认runtime/start.pid）不可写 - 生产环境务必用
php start.php start -d后台运行，但调试阶段永远优先看前台日志
验证服务是否真正在监听 8787 端口
浏览器打不开 http://localhost:8787，不等于 Webman 没启动 —— 它可能在监听 127.0.0.1:8787，而你的请求发到了 localhost（DNS 解析或 hosts 干扰）；也可能被防火墙拦截。
- 用命令确认端口状态：
lsof -i :8787（macOS/Linux）或netstat -ano | findstr :8787（Windows WSL） - 如果看到
LISTEN但浏览器仍打不开，试试curl -v http://127.0.0.1:8787—— 绕过 DNS 和 hosts 影响 - 云服务器（如阿里云、腾讯云）必须在安全组中放行 8787 端口，否则即使本地
curl成功，外网也访问不到 - 宝塔用户注意：Webman 是独立 HTTP 服务，**不能**直接绑定到宝塔创建的「网站」，需额外配置反向代理（指向
127.0.0.1:8787）
最常被忽略的一点：Webman 的 config/server.php 中 listen 默认是 '0.0.0.0:8787'，但某些 Docker 或容器化环境会限制绑定地址，改成 '127.0.0.1:8787' 反而更稳妥 —— 不是所有网络栈都支持通配符监听。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
