Windows+Nginx环境下h5ai文件不显示及Zip未识别问题求助

问题1：h5ai不显示Nginx根目录文件 #

• 调整Nginx配置，确保根目录请求被h5ai处理
  打开nginx.conf，修改server块配置，确保root指向你的实际根目录，同时添加try_files规则让所有未匹配到的请求转发到h5ai的入口文件：

  server {
      listen 80;
      server_name localhost;
      root C:/nginx/html; # 替换为你的Nginx根目录绝对路径
      index index.php index.html index.htm;
  
      location / {
          try_files $uri $uri/ /_h5ai/public/index.php$is_args$args;
      }
  
      location ~ \.php$ {
          fastcgi_pass 127.0.0.1:9000; # 确认PHP-FPM服务已启动并监听9000端口
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
  }
  

  配置完成后重启Nginx服务。
• 验证文件权限
  确保Nginx和PHP-FPM运行的用户（通常是当前登录用户或Network Service）对Nginx根目录及所有子文件、文件夹拥有读取权限。
• 检查h5ai基础配置
  打开_h5ai/public/conf/options.json，确认root字段值为"/"，同时showHidden如果设为false，只会显示非隐藏文件，可根据需要调整。

问题2：Zip工具不识别&du命令替代 #

解决Zip工具识别问题 #

• 确认Choco安装的Zip路径：默认在C:\ProgramData\chocolatey\bin\zip.exe
• 修改options.json中的tools配置块，指定Zip的绝对路径：

  "tools": {
      "zip": {
          "enabled": true,
          "cmd": "C:\\ProgramData\\chocolatey\\bin\\zip.exe"
      }
  }
  

  注意路径需用双反斜杠转义，或改用正斜杠"C:/ProgramData/chocolatey/bin/zip.exe"
• 保存配置后重启Nginx和PHP-FPM。

Windows下du命令替代方案 #

• 方案1：安装coreutils获取du命令
  用Choco安装包含du的工具包：

  choco install coreutils -y
  

  安装完成后，在options.json中配置du路径：

  "tools": {
      "du": {
          "enabled": true,
          "cmd": "C:\\ProgramData\\chocolatey\\bin\\du.exe"
      }
  }
  

• 方案2：使用h5ai自带PHP实现（无需额外工具）
  直接禁用du工具，h5ai会自动用PHP计算文件大小，修改options.json：

  "tools": {
      "du": {
          "enabled": false
      }
  }
  

内容的提问来源于stack exchange，提问作者Yeet