phpEnv不推荐用于Omeka S：需手动启用mod_rewrite、PHP≥8.1、intl/gd/xml等扩展，并配置虚拟主机指向public目录，否则易出现500错误、404或安装卡死。
phpEnv 本身不支持直接安装 Omeka，因为它是 Windows 下的轻量级 PHP 环境套件（基于 Apache + PHP + MySQL），但默认不带 mod_rewrite 启用、不预装 mbstring 和 intl 扩展、且 PHP 版本常卡在 7.4 或更低——而 Omeka S（当前主流版本）明确要求 PHP ≥ 8.1、启用 mod_rewrite、并依赖 gd、xml、curl、json 等扩展。
换句话说：用 phpEnv 跑 Omeka S 是可能的，但需要手动补全一堆缺失项；跑老版 Omeka Classic（≤ 2.8）更勉强，但已不推荐（安全更新已停止）。
确认 phpEnv 是否真适合你的 Omeka 需求
如果你只是想本地快速试用 Omeka S 做数字馆藏展示，phpEnv 不是首选。它缺乏对现代 PHP 生态的维护节奏，升级 PHP 或切换模块极麻烦。实际中更容易遇到：
-
500 Internal Server Error—— 多因mod_rewrite未生效或.htaccess被 Apache 忽略 -
Class 'IntlDateFormatter' not found——intl扩展未启用或 DLL 文件缺失 - 后台上传图片失败、缩略图空白 ——
gd扩展未加载或配置里禁用了getimagesize() - 安装向导卡在「检查依赖」页 ——
mbstring.func_overload被设为非 0（Omeka S 明确要求为 0）
真正省事的做法：改用 Docker（官方有 omeka/omeka-s 镜像）或 XAMPP（PHP 8.2+ 版本可手动开启所需模块）。
立即学习“PHP免费学习笔记（深入）”；
如果坚持用 phpEnv 搭 Omeka S：必须做的 4 项手动配置
以 phpEnv v2.1.2（含 PHP 8.2.12）为例，安装前需先修正环境：
- 打开
phpEnv\Apache24\conf\httpd.conf，取消注释：LoadModule rewrite_module modules/mod_rewrite.so - 在同一文件中，找到
<Directory "D:/phpEnv/www">区块，把AllowOverride None改成AllowOverride All - 打开
phpEnv\php\php.ini，确保以下行未被注释且值正确：extension=mbstringextension=intlextension=gdextension=curlextension=xmlmbstring.func_overload = 0 - 下载对应 PHP 版本的
icu*.dll和php_intl.dll（需匹配线程安全 TS / NTS 及架构），放进phpEnv\php\ext\，并在php.ini中确认intl.default_locale = en_US
改完重启 phpEnv 的 Apache 服务，再用 php -m | findstr intl 验证扩展是否载入成功。
Omeka S 安装时绕过 phpEnv 的路径陷阱
phpEnv 默认网站根目录是 D:\phpEnv\www\，但 Omeka S 要求入口文件 index.php 必须在 Web 可访问路径下，且其上一级不能被直接浏览（即 application/、config/ 等目录需在 Web 根目录之外）。常见错误操作是直接解压 Omeka S 到 www\omeka-s\ 并访问 http://localhost/omeka-s —— 这会导致路由和静态资源 404。
- 正确做法：把 Omeka S 解压到
D:\phpEnv\omeka-s\（与www同级），然后修改phpEnv\Apache24\conf\extra\httpd-vhosts.conf，新增虚拟主机：
<VirtualHost *:80>
DocumentRoot "D:/phpEnv/omeka-s/public"
ServerName omeka.local
<Directory "D:/phpEnv/omeka-s/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
- 接着在系统
C:\Windows\System32\drivers\etc\hosts加一行：127.0.0.1 omeka.local - 重启 Apache，访问
http://omeka.local即可进入安装向导
为什么你大概率会卡在数据库连接或重写规则上
最常被忽略的是两点：
-
phpEnv自带的 MySQL 服务名不是localhost，而是127.0.0.1；Omeka S 安装时若填localhost，PDO 会尝试走 socket 连接（Windows 下不支持），导致「Connection refused」——必须填127.0.0.1 - 即使
mod_rewrite开了、.htaccess也生效，Omeka S 的前端路由仍可能返回 404，原因是public/.htaccess里RewriteBase /写死了根路径；如果用了虚拟主机指向public/，这行必须删掉或改成空
这些细节没有报错提示，只表现为页面空白或跳转失败，排查起来比换工具还耗时。
