phpenv 不适合部署 webtrees，因其仅为 php 版本管理工具，不提供 apache/nginx、mysql 或 web 界面支持；webtrees 是 lamp 应用，依赖完整 web 服务器环境与数据库服务，而 phpenv 仅切换 cli 下的 php 二进制文件，无法满足其运行所需。
phpEnv 不能直接安装或运行 Webtrees。 它不是 Webtrees 的部署工具，而是用于管理多个 PHP 版本的命令行工具，仅作用于 CLI 环境，不提供 Apache/Nginx、MySQL 或 Web 界面支持。
为什么 phpEnv 不适合搭 Webtrees
Webtrees 是一个典型的 LAMP（Linux/Apache/MySQL/PHP）Web 应用，依赖：Apache 或 Nginx 处理 HTTP 请求，MySQL 存储家谱数据，以及完整的 PHP 运行时（含 php_mbstring、php_gd2、php_openssl 等扩展）。而 phpenv 只负责切换不同版本的 php 命令行二进制文件，它本身不启动 Web 服务器，也不管理数据库服务。
常见误操作包括：
- 在终端执行
phpenv install 8.1.12后以为 Webtrees 就能跑起来 —— 实际访问http://localhost会显示 404 或连接被拒绝 - 手动把 Webtrees 文件放进
~/.phpenv/versions/8.1.12/目录下 —— 这个路径是 PHP 解释器的安装根目录，不是 Web 文档根目录 - 试图用
php -S localhost:8000启动 Webtrees —— 内置服务器不支持重写规则（.htaccess），会导致路由失效、CSS/JS 加载失败、GEDCOM 导入报 500
真正能搭 Webtrees 的替代方案（Windows 用户优先）
如果你在 Windows 上想快速跑起 Webtrees，应该用集成环境，而不是 phpenv：
-
PHPStudy：开箱即用，图形界面一键启停Apache+MySQL+ 指定PHP版本（推荐PHP 8.1），Webtrees 只需解压到www目录，浏览器访问http://localhost/webtrees即可开始安装向导 -
XAMPP：同样成熟稳定，注意安装后需手动启用Apache和MySQL服务，并确认php.ini中已开启extension=mbstring和extension=gd -
Docker Desktop（进阶）：可用官方webtrees/webtrees镜像，但需额外配置 MySQL 容器和卷映射，对新手门槛略高
如果你坚持要用 phpEnv，必须补全缺失组件
仅当你是 Linux/macOS 用户，且已有 Apache 或 Nginx、MySQL 独立运行的前提下，phpenv 才有意义：
- 先确保系统级
Apache已安装并监听80端口，文档根目录为/var/www/html（Ubuntu）或/Library/WebServer/Documents（macOS） - 用
phpenv install 8.1.12安装 PHP，再执行phpenv global 8.1.12切换全局版本 - 手动编辑系统 PHP 配置（如
/etc/php/8.1/apache2/php.ini），启用必要扩展：extension=mbstring.so、extension=gd.so、extension=mysqli.so - 重启
apache2服务（sudo systemctl restart apache2），否则新 PHP 版本不会生效 - Webtrees 必须放在 Apache 文档根目录下，不能放在
phpenv的任何子目录中
最容易被忽略的一点：Webtrees 的 config 目录必须可写，data 目录必须存在且由 Web 服务器进程（如 www-data 或 _www）拥有权限 —— 这类问题和 phpenv 无关，但常被误认为是版本切换失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
