phpenv仅管理php版本切换，不涉及数据库；需搭配php-build插件、系统编译依赖、正确path配置及独立数据库工具（如docker）使用。
phpenv 本身不管理数据库，它只管 PHP 版本切换；所谓“phpEnv 全能手册”是常见误解——你真正需要的是 phpenv + 独立数据库工具的组合方案。
phpenv install 命令为什么总失败？
执行 phpenv install 8.3.13 报错，大概率不是 phpenv 问题，而是缺编译依赖或插件未装：
- 确认已安装
php-build插件：运行ls $(phpenv root)/plugins/，应看到php-build目录；没看到就执行git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - Ubuntu/Debian 系统必须提前装依赖：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS 用户注意：若用 Homebrew，需确保
openssl@3、zlib、libxml2已brew install，并设环境变量：export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH" - 报 “configure: error: unrecognized options” 类错误，说明
PHP_BUILD_CONFIGURE_OPTS里写了过时参数，比如--with-mysql（PHP 7.4+ 已移除），应改用--with-pdo-mysql
phpenv local 和 .php-version 文件谁优先？
两者是一回事：phpenv local 8.2.20 的本质就是在当前目录生成一个 .php-version 文件，内容就是 8.2.20。但要注意几个实际细节：
- 文件必须是纯文本、无 BOM、末尾无空行，否则 phpenv 读取失败，
php -v会回退到 global 版本 - 如果父目录也有
.php-version，**不会继承**；phpenv 只认当前目录或向上逐级查找，直到找到第一个为止 - Git 提交时建议把
.php-version加入版本控制，团队协作时能强制统一基础运行环境 - 想临时覆盖项目设置？用
phpenv shell 7.4.33，退出终端即失效，不影响.php-version
为什么 php -v 显示的还是系统自带 PHP？
这是最常被忽略的路径冲突问题：phpenv 的 shims 机制依赖 $HOME/.phpenv/shims 在 $PATH 中**优先于其他 PHP 路径**。
- 检查当前
php来源：which php—— 正常应输出/home/xxx/.phpenv/shims/php；如果显示/usr/bin/php或/opt/homebrew/bin/php，说明 phpenv 的 shims 没生效 - 确认
~/.phpenv/bin和~/.phpenv/shims都在$PATH开头位置：echo $PATH | tr ':' '\n' | head -5 - 常见陷阱：在
~/.bashrc里写export PATH="/usr/local/bin:$PATH"，结果把系统路径塞到了最前；应改为export PATH="$HOME/.phpenv/shims:$HOME/.phpenv/bin:$PATH" - 改完配置后必须
source ~/.bashrc（或对应 shell 文件），且phpenv rehash一次，让 shims 重新生成符号链接
数据库管理得靠谁？
phpenv 不提供 MySQL、PostgreSQL 或 SQLite 管理功能，它连数据库二进制文件都不碰。你需要自己搭配：
- 本地开发推荐
docker-compose：用官方镜像启动 MySQL 8.0 + Redis + Adminer，phpenv管 PHP，Docker 管服务，互不干扰 - Mac 用户可选
brew services start mysql@8.0，但注意版本号要和 PHP 扩展匹配（如pdo_mysql编译时需对应 MySQL 头文件） - Windows 用户别折腾 WSL 下的 MySQL 编译，直接用 XAMPP 或 Laragon，它们自带面板，
phpenv切换 PHP 后，只要扩展开启（extension=pdo_mysql）就能连 - 连接测试别只跑
php -v，一定要写个test-db.php：<?php $pdo = new PDO('mysql:host=127.0.0.1;port=3306', 'root', ''); echo "OK"; ?>，再执行php test-db.php
真正的难点从来不在安装命令是否敲对，而在于 PATH 顺序、shims 是否重建、以及你有没有意识到 phpenv 只是“PHP 的开关”，不是“全栈环境”。数据库、Web 服务器、缓存服务，都得各司其职，手动拼好。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
