phpenv 管理界面中“站点显示名称”实为网站根目录下的文件夹名,需手动重命名该文件夹并重启phpenv生效;apache/nginx配置中的documentroot或root路径也需同步更新,否则导致500/404错误。

phpEnv 管理界面里没有“站点显示名称”这个配置项
phpEnv 本身不提供类似宝塔「站点名称」或「备注标签」的可视化字段,它的管理界面只展示站点根目录路径、绑定域名、PHP 版本和状态。所谓“站点显示名称”,其实是你在操作系统中给网站目录起的文件夹名,或者你在 hosts + 虚拟主机配置里写的 ServerName —— phpEnv 不读取也不渲染这个值。
想让某个站点在 phpEnv 列表里“看起来有名字”,只能改目录名
phpEnv 的站点列表本质是扫描你指定的网站根目录(比如 D:\phpenv\www)下的子文件夹,每个子文件夹就是一个站点,列表中显示的就是该文件夹的名称。所以:
- 关闭 phpEnv,确保所有服务已停止
- 进入你的网站根目录(如
D:\phpenv\www) - 把原文件夹名(比如
unnamed_site)重命名为有意义的名字,例如onenav-local或my-bookmarks - 重启 phpEnv,列表中就会显示新文件夹名
注意:rename() 是 PHP 唯一可靠的重命名方式,但这里你是手动操作文件系统,不是调用 PHP 函数;只要权限正常、没被进程占用,直接在资源管理器里改就行。
改完目录名后,Apache/Nginx 配置可能需要同步更新
如果你之前配过虚拟主机,DocumentRoot 或 root 指向的是旧路径,那么改名后网站会 500 或 404。检查对应配置:
- Apache:打开
conf/extra/httpd-vhosts.conf,确认DocumentRoot和<directory></directory>路径是否已更新 - Nginx:打开
conf/vhost/*.conf,检查root行是否指向新文件夹全路径(如root D:/phpenv/www/onenav-local;) - hosts 文件不用动,它只管域名解析,和目录名无关
别指望通过 config.php 或 .env 改 phpEnv 的显示名
像 OneNav 的 $site_setting['title'] 只影响网页标题栏和首页显示,和 phpEnv 界面毫无关系;.env 里的 APP_NAME 同理,是应用层标识,phpEnv 完全不读取这些文件。强行往这些地方写“站点名称”,只会让你误以为改对了,结果在管理界面里还是看到一串无意义的文件夹名。
真正容易被忽略的是:phpEnv 列表刷新不自动,改完目录名必须重启软件才能生效;另外,如果用了中文文件夹名,部分旧版 phpEnv 可能识别异常,建议坚持用英文+短横线命名。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











