phpenv的nginx默认不含stream模块且不支持bom编码，导致“unknown directive”报错；需用nginx -v确认--with-stream、file -i检查编码、cat -a排查隐藏字符，并避免手动加载模块。
phpEnv 自带的 Nginx 默认不含 stream 模块，也不支持 BOM 编码的配置文件 —— 这是绝大多数 “unknown directive” 报错的根源。
检查 nginx -V 输出里有没有 --with-stream
phpEnv 封装的 Nginx 多为精简版，常禁用非 HTTP 模块。运行：
nginx -V 2>&1 | grep -o -- '--with-stream\|--with-stream=dynamic'
如果无任何输出，说明 stream、grpc_pass、upstream_hash 等指令一律不可用。此时写进配置的 stream { ... } 或 http2 on; 都会触发 unknown directive "stream" 或 unknown directive "http2"。
- 不要尝试手动加
load_module—— phpEnv 的模块目录结构不标准，动态加载大概率失败 - 不要指望改
nginx.conf里加include就能绕过 —— 模块不存在，include只会让错误提前暴露 - 若必须用
stream，建议换用官方编译包或 Docker，phpEnv 不适合四层代理场景
用 file 命令确认配置文件编码是否为 UTF-8 NO BOM
Windows 上用记事本、VS Code（未关 BOM）、Notepad++（UTF-8 with BOM）保存的 .conf 文件，一放到 phpEnv（Linux 环境模拟）就会在开头注入 锘? —— 这就是报错里出现的 unknown directive "锘?"。
- 执行
file -i /path/to/your.conf，正常应输出charset=utf-8；若含charset=utf-8; charset=bom或charset=iso-8859-1，立刻重存 - Linux 下推荐用
vim：打开后输入:set nobomb | set fenc=utf-8 | wq - Mac / Windows 编辑时务必关闭「UTF-8 with BOM」选项，Sublime Text 和 VS Code 设置里都可关
用 nginx -t 定位空格、Tab 和隐藏字符
phpEnv 的 Nginx 对空白符极其敏感：listen 80 ; 中间多一个不可见空格、server_name 后用了 Tab 而非空格、行尾有全角空格，都会被解析成非法指令名，报出类似 unknown directive "" 或 unknown directive " "（中文全角空格）。
- 执行
nginx -t -c /path/to/nginx.conf，注意看报错行号和引号内的内容 —— 引号里如果是空、乱码或奇怪符号，基本就是空白符问题 - 用
cat -A your.conf查看所有隐藏字符：^I是 Tab，M-BM-开头是 BOM， - 别信“复制粘贴没动”，富文本编辑器、网页文档、微信消息里的配置极易混入非 ASCII 空格
真正棘手的不是报错本身，而是错误位置和真实原因经常不一致 —— 比如 unknown directive "proxy_set_header" 其实是因为上一行少了个分号，导致整块被错当成一个指令名。所以每次改完配置，先 cat -A 看一眼，再 nginx -t 测一遍，比反复重启快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
