phpenv不提供图形化ip控制界面,黑白名单须手动修改nginx(allow/deny)或apache(.htaccess+require)配置文件,且需确认服务器类型、https单独配置、代理环境下修正真实ip获取。

phpEnv 本身不提供图形化 IP 访问控制界面,所有黑白名单必须通过直接修改 Nginx 或 Apache 的站点配置文件实现 —— 这和宝塔、LNMP 等环境逻辑一致,但 phpEnv 默认不封装这些功能,需手动操作。
确认 Web 服务器类型再动手
phpEnv 支持切换 Nginx 和 Apache,黑白名单写法完全不同,不能混用:
- 运行
phpenv list或查看 phpEnv 控制台顶部状态栏,确认当前启用的是nginx还是apache - Nginx 模式下:黑白名单只能写在
server块或location块内,用allow/deny指令 - Apache 模式下:必须用
.htaccess(需确保AllowOverride All已启用),规则为Require ip 192.168.1.100或Require not ip 203.0.113.5 - 切勿在 Nginx 配置里写 Apache 语法,或反过来;否则重载会失败,
nginx -t报错提示类似unknown directive "Require"
nginx 模式:在 phpEnv 站点配置中加 allow/deny
phpEnv 的 Nginx 配置文件路径通常为:/phpenv/nginx/vhost/your-site.conf(Windows 下是 C:\phpEnv\nginx\vhost\your-site.conf)
- 编辑该文件,在
server { ... }块内、任意location外的位置插入规则(推荐放在root指令下方) - 白名单示例(仅允许两个 IP,其余全拒):
allow 127.0.0.1;<br>allow 203.0.113.25;<br>deny all;
- 黑名单示例(禁止特定 IP,其余放行):
deny 192.168.100.50;<br>deny 203.0.113.0/24;
- 改完后必须执行
phpenv nginx reload(Windows 下点 phpEnv 控制台的「重载 Nginx」按钮),否则不生效 - 注意:HTTPS 站点要单独在
listen 443 ssl对应的server块里重复写一遍,HTTP 和 HTTPS 是两个独立上下文
apache 模式:用 .htaccess 实现,但需先检查 AllowOverride
phpEnv 的 Apache 配置默认可能禁用 .htaccess 覆盖,必须先确认:
- 打开
/phpenv/apache/conf/extra/httpd-vhosts.conf,找到对应站点的<directory></directory>块 - 确保里面有
AllowOverride All(不是None),否则.htaccess规则完全被忽略 - 在站点根目录(如
/phpenv/www/your-site/)新建或编辑.htaccess文件 - 白名单写法:
Require ip 127.0.0.1<br>Require ip 192.168.5.0/24
- 黑名单写法:
Require all granted<br>Require not ip 203.0.113.100
- 保存后执行
phpenv apache restart(Windows 下点「重启 Apache」)
真实 IP 获取失效?你大概率被代理了
如果规则写了却总不生效(比如本地测试显示拒绝,但实际从公司网络访问却被放行),极可能是 phpEnv 前面套了反向代理、NAT 或开发工具(如 Charles、Fiddler),导致 $remote_addr 或 $_SERVER['REMOTE_ADDR'] 变成代理 IP:
- Nginx 下:检查是否用了
proxy_pass,若有,必须配set_real_ip_from+real_ip_header X-Forwarded-For,否则allow/deny判的是代理地址 - PHP 层判断时:不要只读
$_SERVER['REMOTE_ADDR'],应优先用$_SERVER['HTTP_X_FORWARDED_FOR']或$_SERVER['HTTP_X_REAL_IP'](需代理明确设置了这些头) - 简单验证方式:在 PHP 文件里输出
print_r($_SERVER);,看哪些HTTP_*头存在且值合理
规则越靠近请求入口(Nginx 层)越可靠,PHP 层校验只是兜底;但只要代理链没正确透传真实 IP,两者都会误判。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











