phpEnv不内置Koken支持，需手动部署：确认PHP≥7.2且启用curl、gd、mbstring等扩展；将Koken源码放至phpEnv网站根目录并设storage子目录可写；配置Apache伪静态及本地域名（如koken.test），避免localhost子路径访问。
phpEnv 本身不内置 Koken 支持，也不能直接“安装 Koken”——它只是个 Windows 下的轻量 PHP + Apache + MySQL 集成环境，用来跑 PHP 网站。Koken 是一个独立的、基于 PHP 的摄影师画廊 CMS，需要手动部署，且对环境有明确要求。
你真正要做的，是用 phpEnv 提供的 Apache 和 PHP 运行时，把 Koken 源码放进去，再配好权限和伪静态。过程中最容易卡在 PHP 扩展缺失、重写规则失效、或目录不可写这三处。
确认 phpEnv 的 PHP 版本和扩展是否达标
Koken 官方要求：PHP ≥ 7.2（推荐 7.4+），必须启用以下扩展：-
curl（用于远程资源拉取） -
gd（缩略图生成必需） -
mbstring（多字节字符串处理） -
openssl（HTTPS 请求与加密） -
json（配置解析） -
xml（RSS/Atom 输出）
在 phpEnv 中检查方式：
打开「软件设置 → 环境设置 → PHP 设置」，点开当前启用的 PHP 版本 → 查看「已启用扩展」列表。
若缺 gd 或 mbstring，勾选后点「应用」，phpEnv 会自动重启服务并加载。
注意：phpEnv 自带的 PHP 7.3+ 通常已含这些扩展，但部分精简版可能关了 gd；若没看到，别自己编译——换用 phpEnv 官网提供的「完整版」安装包更省事。
把 Koken 源码放进 phpEnv 的 Web 目录并设好权限
Koken 不支持子目录部署（即不能放在 http://localhost/koken/），必须绑定到根域名或虚拟主机根路径。
- 下载最新版 Koken（从 koken.me/download 获取 ZIP 包）
- 解压后，把整个文件夹内容（不是外层文件夹，是
app/、storage/、index.php等）复制到phpEnv的网站根目录，例如：C:\phpEnv\www\koken\ - 确保以下目录可写（Windows 下右键 → 属性 → 安全 → 编辑 → 给
IIS_IUSRS或Users组「修改」权限）：
–storage/cache/
–storage/logs/
–storage/sessions/
–storage/uploads/
如果跳过权限设置，安装向导会卡在「Checking permissions」或报错 mkdir(): Permission denied —— 这不是 PHP 报错，是 Windows 文件系统拦截。
立即学习“PHP免费学习笔记（深入）”；
配置 Apache 伪静态和站点入口
Koken 依赖 URL 重写（如访问 /albums 而非 index.php?/albums），phpEnv 默认 Apache 配置里 mod_rewrite 是开启的，但关键在两点：
- 确认
C:\phpEnv\www\koken\.htaccess文件存在且未被 Windows 隐藏（有些解压工具会过滤掉点开头的文件） - 在
phpEnv中新增站点时，「网站根目录」必须指向C:\phpEnv\www\koken\（不能指向上层www），且「域名」建议填koken.test这类本地域名（而非localhost/koken） - 然后去
phpEnv的「高级设置」里打开「新增站点后自动写入 hosts」，它会帮你往C:\Windows\System32\drivers\etc\hosts加一行：127.0.0.1 koken.test
如果用 localhost/koken 访问，Apache 无法正确匹配 .htaccess 里的重写规则，所有请求都会 404 或跳回首页——这是最常被忽略的部署陷阱。
运行 Koken 安装向导并避开常见失败点
浏览器访问 http://koken.test（不是 http://localhost/koken），进入安装流程：
- 数据库配置填：
host: 127.0.0.1，port: 3306，name: koken（需提前在 phpEnv 的 phpMyAdmin 里新建空库） - 管理员账号密码任意，但邮箱必须真实可用（Koken 后续邮件通知依赖它）
- 安装完成后，立即检查
storage/logs/app.log—— 若有Failed to create thumbnail，说明gd没生效或图像函数被禁用（查php.ini是否含disable_functions = exec,passthru,shell_exec，Koken 需要exec来调用系统图像工具作备选）
Koken 的「媒体上传」和「缩略图生成」高度依赖底层图像处理能力，phpEnv 默认关闭了 exec，而 Koken 在 gd 失效时会 fallback 到命令行工具（如 ImageMagick），所以要么开 exec，要么确保 gd 全功能可用——这点文档几乎不提，但实际部署中超过六成失败源于此。
