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 文件系统拦截。
配置 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 全功能可用——这点文档几乎不提,但实际部署中超过六成失败源于此。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











