phpenv 无法直接安装 flarum，因其不支持 composer 运行环境，缺少 php cli、禁用必要函数且未预装 flarum 所需扩展；只能通过外部环境构建后手动部署。
phpEnv 不能直接安装 Flarum —— 它不支持 Composer 运行环境，也没有内置 PHP CLI 或可调用的 composer 命令。 你看到的“phpEnv + Flarum”教程，基本都是误传或混淆了 phpEnv 和宝塔、XAMPP 等真正支持命令行操作的环境。
为什么 phpEnv 启动不了 composer create-project flarum/flarum
phpEnv 是一个纯图形化 Windows 集成包（Apache + MySQL + PHP + 控制面板），它的 PHP 是以 Apache 模块方式加载的，php.exe 不在系统 PATH 中，也未暴露 CLI 接口。即使你手动找到它自带的 php.exe（通常在 phpenv\php\php-8.2.0\ 这类路径下），也会遇到以下问题：
-
proc_open、putenv等函数默认被禁用，而 Composer 必须使用它们 - 没有预装
openssl、mbstring、fileinfo扩展（Flarum 强制依赖） - 无法修改
php.ini中的max_execution_time或memory_limit（控制面板里改的只是 Apache 模块配置，CLI 下不生效） - 启动的 Apache 服务不等于你能从 CMD 运行
php -v—— 二者 PHP 实例隔离
想用 phpEnv 跑 Flarum？只能走「伪静态 + 手动部署」路线
如果你坚持用 phpEnv（比如已有多个本地站点依赖它），Flarum 只能作为「已编译完成的 Web 应用」部署，不能通过 Composer 在本地初始化。步骤如下：
- 在另一台有完整 PHP CLI 环境的机器（或 WSL、GitHub Codespaces）上执行：
composer create-project flarum/flarum . --no-dev - 把生成的整个目录（含
public/、vendor/、.env）打包，上传到 phpEnv 的站点根目录（如D:\phpenv\www\flarum.local\） - 确保 phpEnv 中该站点使用的 PHP 版本 ≥ 8.0，且已手动启用扩展：
fileinfo、mbstring、openssl、json、curl、xml - 修改 phpEnv 的 Apache 配置（
phpenv\apache\conf\extra\httpd-vhosts.conf），为该站点添加DocumentRoot指向.../flarum.local/public，并开启AllowOverride All - 在站点根目录下放一个
.htaccess，内容必须包含 Flarum 要求的重写规则（否则/admin、/api404）
注意：.htaccess 里不能用 try_files（那是 Nginx 语法），要换成 Apache 风格的 RewriteRule，例如：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
更现实的选择：换用宝塔或 Laragon
phpEnv 对现代 PHP 应用（尤其是基于 Composer 的 Flarum）本质是错配。真正能跑通 Flarum 的本地方案只有两类：
-
宝塔（Windows 版）：提供完整的终端、PHP CLI、可编辑的
php.ini、一键安装扩展和解除禁用函数，composer可直接运行 - Laragon：轻量、原生支持 Composer、自动 PATH 注册、右键菜单集成命令，比 phpEnv 更贴近开发者工作流
如果你已经装了 phpEnv，又不想重装，唯一可行的折中方案是：用 WSL2 安装 Ubuntu + Nginx + PHP-FPM + Composer，在里面完整搭建 Flarum，再通过 localhost:8080 访问 —— 这样既不冲突 phpEnv，又能保证 Flarum 正常运行。
别在 phpEnv 的 Apache 日志里反复查 500 Internal Server Error；问题不在配置，而在底层能力缺失。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
