PHPEnv安装Directus教程与配置指南

本文澄清了phpEnv与Directus之间根本性的技术不兼容性：phpEnv作为专为PHP/Apache/MySQL设计的Windows集成环境，完全缺失Node.js、npm及Docker等Directus运行所必需的核心依赖，因此无法安装或托管Directus；文章明确指出在Windows上部署Directus仅有两条可靠路径——Docker Desktop+WSL2（官方首推）或原生Node.js安装，并强调真正易出错的关键在于数据库配置细节（如Docker中DB_HOST需填服务名而非localhost）和环境变量初始化（如ADMIN_EMAIL必须正确设置），而非安装命令本身，帮助开发者避开常见陷阱、直击问题本质。

phpEnv 不能用来安装或运行 Directus。

为什么 phpEnv 和 Directus 不兼容

phpEnv 是一个 Windows 下的「集成环境包」，本质是 Apache + MySQL + PHP 的图形化封装，目标是快速搭起 LAMP 类本地开发环境。而 Directus 是基于 Node.js 的现代 CMS，它依赖 node、npm 或 docker 运行，不走 PHP-FPM 或 Apache CGI 流程。

你用 phpEnv 启动的 Apache 根本不会识别 index.js，也不会执行 npx directus start —— 它连 node 命令都没有。

• phpEnv 自带的「PHP 解释器」对 Directus 没有任何作用
• phpEnv 不提供 npm、pnpm、docker 等 Directus 必需的运行时
• 它的控制面板里没有「启动 Directus」这个选项，也不可能有

Directus 在 Windows 上真正可行的安装路径

别在 phpEnv 里折腾了。Windows 用户跑 Directus 只有两条干净、可验证的路：

• Docker Desktop + WSL2：官方最推荐的方式。拉取 directus/directus:latest 镜像，用 docker run 或 docker-compose.yml 启动，SQLite 或 PostgreSQL 都能直接对接
• Node.js 原生安装：装好官方 Node.js（v18+），然后执行 npm init directus-project my-app，填完数据库配置后 npx directus start

注意：npm init directus-project 会自动创建 .env 文件并引导你设 ADMIN_EMAIL 和 ADMIN_PASSWORD —— 这步漏掉会导致首次访问后台卡在登录页。

如果你已经装了 phpEnv，还能做什么

可以留着它继续跑传统 PHP 项目（比如 Laravel、WordPress），但不要试图让它“托管”Directus。两者进程模型、依赖栈、配置方式完全不同。

• phpEnv 的 Apache 默认监听 80 端口，Directus 默认用 8055，端口不冲突，但也不能共存于同一套服务管理逻辑中
• 想同时运行？可以：phpEnv 开着 Apache，再另开一个终端跑 npx directus start，它们互不干扰，只是彼此无关
• 别改 phpEnv 的配置文件去加 ProxyPass 转发到 localhost:8055 —— 除非你真懂 Apache mod_proxy，否则大概率触发 CORS 或 WebSocket 断连

Directus 的核心复杂点不在安装命令，而在数据库初始化和环境变量语义。比如 DB_CLIENT="mysql" 时，DB_HOST 不能填 localhost（Docker 内部要填服务名 mysql），这种细节比工具链选择更容易导致启动失败。

终于介绍完啦！小伙伴们，这篇关于《PHPEnv安装Directus教程与配置指南》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！