Joomla在phpEnv中需手动部署：先确认PHP≥8.1并启用curl、mbstring等扩展，再将解压后的文件放入指定Web根目录，数据库主机填127.0.0.1而非localhost，安装后必须手动删除installation目录。
phpEnv 本身不直接提供 Joomla 安装功能，它只是一个 Windows 下的 PHP 多版本环境管理工具（类似 XAMPP 但更轻量），Joomla 必须手动部署到 phpEnv 托管的 Web 根目录中，并确保 PHP、MySQL 和扩展满足要求。直接双击安装包或点“一键安装 Joomla”会失败。
确认 phpEnv 的 PHP 版本与扩展是否达标
Joomla 4.x/5.x 要求 PHP ≥ 8.1（官方最低为 8.0.2，但实际运行建议 8.1+），且必须启用 curl、mbstring、xml、json、zip、gd、openssl 等扩展。phpEnv 默认可能只启用了基础扩展：
- 打开 phpEnv 控制面板 → “PHP 设置” → 查看当前激活的 PHP 版本（如
php-8.2.9-nts） - 点击“php.ini 配置” → 搜索
extension=行，确认以下行未被注释（即前面没有分号;）：extension=mbstringextension=curlextension=gdextension=zipextension=opensslextension=xml - 若修改了
php.ini，必须重启 phpEnv 的 Apache/Nginx 服务才生效
把 Joomla 文件放对位置，否则 403 或 500 错误
phpEnv 的 Web 根目录不是固定为 htdocs，而是由你创建站点时指定的路径。常见错误是把 Joomla 解压到 phpEnv 安装目录下的 www 或 htdocs 里，但该目录未必被当前站点监听：
- 在 phpEnv 控制面板 → “网站管理” → 点击“添加网站”，填写域名（如
joomla.test）、端口（如8080）、根目录（如D:\joomla-site） - 下载 Joomla 最新版 ZIP 包（推荐从
https://downloads.joomla.org/cms/joomla5获取），解压全部内容到你刚设的根目录（如D:\joomla-site），确保index.php直接位于该目录下 - 不要保留原始压缩包里的
en-GB或installation上级文件夹；解压后应是D:\joomla-site\administrator\、D:\joomla-site\index.php这样的结构 - 访问
http://joomla.test:8080（或你设的对应地址），而不是http://localhost/joomla—— 后者只适用于 XAMPP 类默认配置
数据库连接失败？重点检查 MySQL 用户权限和 socket 路径
phpEnv 内置的 MySQL（通常是 MariaDB）默认监听 127.0.0.1:3306，但 Joomla 安装向导填 localhost 时，PHP 可能尝试走 Unix socket（Windows 下无效），导致连接超时或报错 Connection refused：
立即学习“PHP免费学习笔记（深入）”；
- 安装前，先用 phpEnv 自带的 phpMyAdmin（通常在
http://localhost:8080/phpmyadmin）登录，确认 MySQL 正常运行，用户名密码可用（默认常为root/ 空） - 在 Joomla 安装的“数据库配置”页，主机名不要填
localhost，改填127.0.0.1 - 数据库名需提前在 phpMyAdmin 中新建（如
joomla5），字符集选utf8mb4_general_ci - 如果仍报错
mysqli::real_connect(): (HY000/1045): Access denied for user，说明用户无库权限：进 phpMyAdmin → “用户账户” → 编辑root用户 → “全局权限”勾选全部，或为新用户授权该库
安装完成后务必删掉 installation 目录
这是硬性安全步骤，不是可选项。phpEnv 不会自动帮你删，漏掉会导致任何人都能重新触发安装向导、覆盖现有数据甚至执行任意代码：
- 安装成功页面出现后，立即关闭浏览器，不要点“进入后台”
- 打开文件资源管理器，进入你的 Joomla 根目录（如
D:\joomla-site） - 删除整个
installation文件夹（不是里面的文件，是整个文件夹） - 再访问
http://joomla.test:8080/administrator登录后台；若还能打开http://joomla.test:8080/installation，说明没删干净
phpEnv 环境下 Joomla 的最大隐性坑在于：它不接管应用生命周期，所有路径、权限、扩展开关都得你亲手核对，任何一步跳过或凭经验猜测，都会卡在“白屏”“500”或“数据库拒绝连接”上。尤其是 PHP 版本和 extension_dir 路径，一旦错配，连 index.php 都不会解析。
