PHP Webman如何部署至Linux服务器_生产环境高可用配置【指南】-php教程-PHP中文网

webman在linux生产环境稳定运行需绕过五大断点：php扩展（pcntl/posix/event）必须真启用且未被disable_functions屏蔽；8787端口须空闲并放行防火墙；runtime等目录权限须与systemd用户（如www-data或nginx）严格一致；nginx反代需透传connection/upgrade头并禁用敏感路径；systemd服务必须配置user、group、workingdirectory及restart策略，且所有环节用户身份统一。

php webman如何部署至linux服务器_生产环境高可用配置【指南】

Webman 在 Linux 生产环境能稳定跑起来，前提是绕过五个典型断点：PHP 扩展缺失、端口被占、权限错配、Nginx 反代配置漏项、systemd 服务没落进用户上下文。其他都是锦上添花。

检查 `pcntl`、`posix`、`event` 是否真启用

Webman 启动失败却没报错？十有八九是扩展“看似加载实则被禁”。php -m 显示在列表里不等于能用，还要看 disable_functions 和 php.ini 加载顺序。

执行 php --ri pcntl，若输出含 Directive => Local Value 行，说明扩展已激活；若只显示模块名但无详情，大概率被 disable_functions 屏蔽
检查 php.ini 中 disable_functions 是否包含 pcntl_fork、pcntl_waitpid、posix_kill —— Webman 的进程管理全靠这几个函数
event 扩展不是可选，而是高并发下的性能分水岭；Ubuntu/Debian 需额外装 php-event 包，CentOS/RHEL 要用 pecl install event 编译，且必须确认 libevent 系统库已存在

Nginx 反向代理必须显式透传 `Connection` 和 `Upgrade` 头

默认 proxy_pass 配置下 WebSocket 或长连接会静默降级为 HTTP/1.1 短连接，导致心跳断开、推送失效。这不是 Webman 的 bug，是 Nginx 默认行为。

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

在 location / 块中必须添加：

proxy_http_version 1.1;
proxy_set_header Connection "upgrade";
proxy_set_header Upgrade $http_upgrade;

proxy_pass http://127.0.0.1:8787 后不能加斜杠（即不要写成 .../8787/），否则路由前缀会被截断，config/route.php 里定义的 /api/v1 会变成 //api/v1
务必屏蔽 /runtime、/config、/vendor 路径，加一条 location ~ ^/(runtime|config|vendor) { return 403; }

用 `systemd` 管理服务时，`User` 和 `Group` 必须与 `runtime/` 目录归属一致

很多人把服务跑起来了，但第二天发现日志不写了、session 消失了、缓存失效——根本原因是 systemd 启动的进程用户和 runtime 目录所有者不匹配，Linux 权限机制直接拒绝写入。

Ubuntu/Debian 下设 User=www-data，同时运行 sudo chown -R www-data:www-data runtime/
CentOS/RHEL 下设 User=nginx，对应执行 sudo chown -R nginx:nginx runtime/
WorkingDirectory 必须设为项目根目录（如 /var/www/webman），否则 start.php 读不到 config/app.php
别漏掉 Restart=always 和 RestartSec=3，Webman 进程意外退出后才能自动拉起

`composer install --no-dev --optimize-autoloader` 必须在目标服务器执行

本地 vendor 目录直接打包上传到服务器？危险。不同系统架构（x86_64 vs ARM64）、PHP 版本、扩展 ABI 兼容性都会导致 opcache 编译失败或 ext-redis 扩展调用崩溃。

上传代码时排除 vendor/、.env、node_modules/，只传源码和 composer.lock
在服务器上执行 php -d memory_limit=-1 composer install --no-dev --optimize-autoloader，-d memory_limit=-1 防止 Composer 因内存不足中断
--optimize-autoloader 生成 vendor/autoload_classmap.php，类加载速度提升 30%+，生产环境不加等于裸奔
完成后立即删掉 composer.lock 文件（可选但推荐），避免后续误执行 composer update

真正卡住人的从来不是「怎么配」，而是「配完谁在跑」——systemd 里写的 User、Nginx 配置里写的 user、chown 命令里写的用户、PHP-FPM pool 里写的 user，这四个必须指向同一个账号，少一个对不上，Permission denied 就在日志里安静躺着等你翻三遍。