摘要搭建本地开发环境时手动安装 Nginx、PHP、MySQL、Redis 并逐一配置往往耗费大量时间还容易因版本冲突、端口占用等问题卡住。EServer 是一款面向 Windows 和 Mac 的开源 GUI 集成环境将上述常用服务整合到一个界面中支持多版本 PHP/MySQL 共存、一键启动停止、可视化站点管理、内置 Redis 与 Composer 等实用工具。本文将完整介绍 EServer 的核心功能、下载安装步骤、快速上手方法以及常见问题排查帮助你用最短的时间搭好本地开发环境。关键词EServer、本地开发环境、PHP集成环境、Nginx、MySQL、Redis、GUI工具一、什么是 EServerEServer 是一款跨平台的 GUI 集成开发环境前身是 phpEnv经过优化升级后开源发布。它集成了Nginx、Apache、PHP、MySQL、Redis等 Web 开发常用服务目标用户包括前端开发者、PHP 后端工程师以及需要本地调试环境的全栈开发者。与 PHPStudy、Laragon 等同类工具相比EServer 的核心差异在于跨平台支持Windows 和 Mac 同时覆盖以及更高的界面可定制性。项目在 GitHub 上已获得约 470 Star更新频率较高。一句话总结EServer 让你不用再手动装环境打开软件点几下就能跑起一个完整的本地开发站点。二、核心功能亮点2.1 多版本 PHP / MySQL 共存EServer 的“软件商店”允许你按需安装多个版本的 PHP 和 MySQL并在不同项目间灵活切换。对于需要同时维护老项目和新技术栈的开发者这一点非常实用。2.2 一键启动与状态管理所有服务的运行状态在首页清晰可见支持一键启动、一键停止。每个服务的配置文件、日志文件都有快捷入口排查问题时无需在文件系统中反复翻找。2.3 可视化站点管理在“网站”模块中你可以通过图形界面添加站点填写域名、指定根目录EServer 会自动完成 Nginx/Apache 的配置无需手动编辑.conf文件。2.4 内置实用工具箱EServer 内置了命令行工具、TCP 端口进程列表、MySQL 强制改密、Composer等常用工具。遇到端口占用或忘记 MySQL 密码时可以直接在软件内处理不用额外安装第三方工具。2.5 自定义应用扩展从 v4.0.0 版本开始EServer 支持通过配置文件添加自定义应用和服务。Windows 端配置文件位于core/custom/childApp/childApp.jsonMac 端位于/Applications/EServer/custom/childApp/childApp.json。这意味着你可以把 Node.js 服务、Python 脚本等非内置服务也纳入 EServer 的统一管理界面。三、下载与安装3.1 系统要求平台最低要求WindowsWindows 7 SP1 / Server 2008 R2 SP1 及以上的 64 位系统推荐 Windows 10 及以上macOSmacOS Mojave10.14及以上Apple Silicon Mac 需先安装 Rosetta 2Windows 用户还需要安装Microsoft Visual C 2015–2022 运行环境否则部分服务可能无法启动。3.2 下载地址GitHub 官方仓库https://github.com/xianyunleo/EServer打开仓库后在右侧Releases区域下载对应平台的安装包。Mac 用户也可以从第三方软件站如 mac.macxf.com获取但建议优先使用 GitHub Releases以确保文件未被篡改。3.3 安装步骤Windows运行安装程序注意安装路径和解压路径不能包含中文和空格否则可能导致服务启动失败。首次安装后建议重启一次系统确保 VC 运行库生效。macOS下载 DMG 安装包打开后将EServer.app拖入“应用程序”目录即可完成安装。如果系统提示“EServer.app 已损坏无法打开”有两种处理方式前往系统设置 → 隐私与安全性在“允许从以下位置下载的 App”中选择“任何来源”。如果没有该选项在终端执行sudo spctl --master-disable启用。在终端执行sudo xattr -rd com.apple.quarantine /Applications/EServer.app移除隔离属性。Apple Silicon Mac 还需先安装 Rosetta 2softwareupdate --install-rosetta。四、快速上手搭建第一个本地站点4.1 安装 PHP 和 MySQL打开 EServer 后进入“软件商店”选择你需要的 PHP 版本和 MySQL 版本点击安装。安装完成后回到首页即可看到这两个服务的状态点击启动按钮即可运行。4.2 添加一个 PHP 站点在左侧导航栏点击“网站”。点击“添加”按钮。填写项目名称、自定义域名如test.local和网站根目录。点击确认EServer 会自动配置 Nginx 和 PHP 环境。在浏览器中访问你设置的域名如果能看到 PHP 页面说明环境已经跑通。4.3 使用 Redis在“添加项目”中选择 Redis填写项目名称后确认EServer 会自动配置 Redis 服务。之后用任意 Redis 客户端连接默认端口即可使用。五、进阶使用技巧5.1 解决端口冲突本地开发中经常遇到 80 端口被其他程序占用的情况。EServer 的“TCP 端口进程列表”工具可以直接查看哪些进程占用了端口并支持结束进程。如果 Nginx 无法绑定 80 端口也可以将其改为 8080 或其他端口。5.2 强制修改 MySQL 密码忘记 MySQL root 密码时无需重装数据库。在 EServer 工具箱中找到“MySQL 改密”功能即可强制重置密码。5.3 添加自定义服务以 Node.js 为例如果你需要把 Node.js 项目也纳入 EServer 管理可以编辑自定义应用配置文件。在childApp.json中按格式添加一条记录指定启动命令、工作目录和监听端口重启 EServer 后即可在界面中看到新增的服务。六、常见问题QMySQL 无法启动怎么办常见原因是集成环境依赖被破坏或配置文件被修改。优先检查是否安装了 VC 运行库以及数据目录是否被其他程序锁定。QMac 安装后打开报错“已损坏”这是 macOS 对未签名应用的隔离策略导致的按 3.3 节中的两种方法处理即可。Q安装路径有中文运行不正常Windows 端严格要求安装路径无中文和空格。如果已经安装建议卸载后重新安装到纯英文路径下。QEServer 和 PHPStudy / Laragon 怎么选如果你主要使用 Windows 且只做 PHP 开发PHPStudy 生态更成熟如果你需要同时支持 Mac 和 Windows或者希望有更灵活的界面定制和自定义应用管理EServer 是更合适的选择。七、总结EServer 用图形界面解决了本地开发环境搭建中最繁琐的部分服务安装、版本切换、端口管理和站点配置。它开源、跨平台内置的工具箱足够覆盖日常调试需求。如果你厌倦了每次换电脑都要重新配一遍 Nginx 和 PHP或者受够了命令行里排查端口占用EServer 值得放进你的开发工具箱。项目地址https://github.com/xianyunleo/EServer