phpEnv不能直接安装Lychee，它仅用于切换PHP版本，不处理Web服务、数据库、权限等部署环节；Lychee需手动配置环境、下载源码、启用扩展、设置权限并完成数据库初始化。
phpEnv 不能直接安装 Lychee —— 它不是包管理器，也不提供一键部署功能。 你看到的“phpEnv 安装 Lychee”说法，大概率是混淆了环境工具和应用部署流程。phpEnv 是一个用于快速切换 PHP 版本的本地开发工具（类似 pyenv），它不处理 Web 服务配置、数据库初始化或 Lychee 的安装向导逻辑。
为什么 phpEnv 无法“安装”Lychee
Lychee 是一个完整的 PHP Web 应用，依赖：
- Web 服务器（Apache/Nginx）路由和重写支持（如
.htaccess或location / { try_files $uri $uri/ /index.php?$query_string; }） - MySQL/MariaDB 实例及可写权限的数据库
- 特定 PHP 扩展（
exif、gd、mysqli、zip等）必须在当前激活的 PHP 版本中启用 -
uploads/和data/目录需有实际文件系统写权限（phpEnv 不自动处理这些）
phpEnv 只负责帮你 switch 到某个 PHP 版本（比如 phpenv local 8.2.10），但后续所有 Web 服务、数据库、权限、配置都得你手动配好。
在 phpEnv 环境下跑 Lychee 的真实步骤
假设你已用 phpEnv 装好 PHP 8.2，并通过 phpenv local 8.2.10 激活：
立即学习“PHP免费学习笔记（深入）”；
- 用
git clone https://gitcode.com/gh_mirrors/ly/Lychee.git下载源码到你的 Web 根目录（如~/Sites/lychee） - 确保
php -m | grep -E "exif|gd|mysqli|zip"输出里包含全部必需模块；缺哪个就去对应 PHP 的php.ini里取消注释或补装（例如 Ubuntu 上sudo apt install php8.2-gd php8.2-mysql） - 启动一个最小 Web 服务：
cd lychee && php -S localhost:8000 -t public/（注意：Lychee v4+ 使用public/为 Web 根，不是项目根） - 手动创建 MySQL 数据库（
CREATE DATABASE lychee CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;），并确保data/config.php或.env（v5+）里填对了DB_HOST、DB_DATABASE、DB_USERNAME、DB_PASSWORD - 访问
http://localhost:8000/install—— 如果报错500 Internal Server Error，先检查php -i | grep error_reporting是否显示错误，再看php -S终端输出的具体异常
常见失败点：权限、路径、PHP 模块三连击
绝大多数“phpEnv 下 Lychee 打不开”问题，其实卡在这三个地方：
-
chmod -R 755 uploads/ data/——750在 CLI 模式下可能因用户组不一致导致 Web 进程（如php -S）无权写入，改755更稳妥 - 误把整个 Lychee 目录设为 Web 根，而没指向
public/子目录（v4/v5 必须如此，否则index.php不在根，路由失效） -
exif_read_data()报错或缩略图空白：说明exif扩展未加载，或图片本身无 EXIF（Lychee 会 fallback，但部分功能受限） - 安装页提示 “Database connection failed”：不是密码错，而是
php -S启动时默认用 CLI SAPI，而 CLI 的php.ini和 Web SAPI 的常不同 —— 请确认你改的是 CLI 对应的php.ini（运行php --ini查看路径）
真正麻烦的从来不是下载代码，而是让 PHP 进程以正确的身份、加载正确的模块、读写正确的路径、连接正确的数据库——phpEnv 只管其中“PHP 版本”这一环，剩下全是你的事。
