ledc/webman

webman配置模板，一键安装常用组件！

v8.3.13 2025-11-10 02:14 UTC

Requires

• php: >=8.3
• ext-bcmath: *
• ext-curl: *
• ext-json: *
• ext-openssl: *
• ext-pdo: *
• ext-posix: *
• ext-redis: *
• illuminate/database: >=12.21
• illuminate/events: >=12.21
• illuminate/pagination: >=12.21
• illuminate/redis: >=12.21
• ledc/container: >=8.2
• ledc/crypt: >=8.1
• ledc/curl: >=8.1
• ledc/locker: >=2.0
• ledc/macroable: >=8.0
• ledc/phinx: >=8.0
• ledc/pipeline: >=8.0
• ledc/redis-queue: >=8.2
• ledc/snowflake: >=2.0
• ledc/webman-user: >=8.2
• monolog/monolog: >=3.9
• symfony/cache: >=7.3
• symfony/lock: >=7.3
• symfony/var-dumper: >=7.3
• topthink/think-container: >=3.0
• topthink/think-helper: >=3.1
• topthink/think-validate: >=3.0
• vlucas/phpdotenv: >=5.6
• webman/admin: ^2.1
• webman/cache: >=2.1
• webman/console: >=2.1
• webman/database: >=2.1
• webman/event: >=1.0
• webman/rate-limiter: >=1.1
• webman/redis: >=2.1
• webman/redis-queue: >=2.1
• workerman/crontab: >=1.0
• workerman/webman-framework: ^2.1

MIT

• david

README

安装 Installation

composer require ledc/webman

忽略扩展安装

composer require ledc/webman --ignore-platform-req=ext-redis --ignore-platform-req=ext-posix -W

运行环境

PHP版本：>=8.3

nginx配置

最佳实践，静态文件优先

location ^~ / {
  try_files $uri $uri/ @webman;
}
location @webman
{
  proxy_http_version 1.1;
  proxy_read_timeout 120s;
  proxy_set_header Connection "";
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header REMOTE-HOST $remote_addr;
  proxy_pass http://127.0.0.1:8787;
}

方案1，静态文件优先

location ^~ / {
  proxy_http_version 1.1;
  proxy_set_header Connection "";
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  # 代理条件:文件不存在&目录内不存在index.html
  set $should_proxy 1;
  if (-f $request_filename) {
    set $should_proxy 0;
  }
  set $index_file "${request_filename}/index.html";
  if (-f $index_file) {
    set $should_proxy 0;
  }
  # 是否执行代理
  if ($should_proxy = 1) {
    proxy_pass http://127.0.0.1:8787;
  }
}

方案2，静态文件优先

webman官方推荐的方案

location ^~ / {
  proxy_http_version 1.1;
  proxy_set_header Connection "";
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  if (!-f $request_filename){
    proxy_pass http://127.0.0.1:8787;
  }
}

方案3，静态文件优先

适合静态打包/pages路径的项目

location ^~ / {
  # 默认访问、index.html 或 /pages 开头的路径，返回 index.html
  location ~* (^/$|^/index\.html$|^/pages/) {
    try_files $uri $uri/ /index.html;
  }
  proxy_http_version 1.1;
  proxy_set_header Connection "";
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  if (!-f $request_filename){
    proxy_pass http://127.0.0.1:8787;
  }
}

长连接

location = /websocket
{
  proxy_pass http://127.0.0.1:8788;
  proxy_read_timeout 300s;
  proxy_http_version 1.1;
  proxy_set_header Host $host;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "Upgrade";
  proxy_set_header X-Real-IP $remote_addr;
}