phpEnv离线使用需提前联网完成三步：下载绿色版安装包、在软件商店下载所有所需组件至缓存目录、确认缓存中存在完整ZIP包；部署时关闭在线功能并手动安装已下载版本。
phpEnv 本身不依赖网络运行，但首次安装、PHP/MySQL 版本下载、插件更新等操作需要联网。离线使用的关键是提前把所有必需组件“搬进”目标机器。
离线安装前必须完成的三件事
你不能在断网后才开始准备。以下动作必须在有网环境完成：
- 从
https://www.phpenv.cn/下载最新版 phpEnv 安装包（推荐绿色版，免注册表、免管理员权限） - 在软件内打开「软件商店」→ 逐个点击你需要的 PHP 版本（如
php-8.3.13、php-7.4.33）、MySQL 版本（如mysql-8.0.33）、Redis、MemCache 等，全部「下载」到本地缓存目录（默认为%APPDATA%\phpEnv\cache） - 确认缓存目录下存在完整压缩包：
php-8.3.13.zip、mysql-8.0.33.zip等，而非仅 .ini 或空文件夹
离线部署时如何跳过网络检测
直接双击运行绿色版 phpEnv.exe 后，若弹出「检查更新」或「连接服务器失败」提示，不要点重试或退出：
- 点击右上角「×」关闭提示框（它只是警告，不影响主程序启动）
- 进入「软件设置」→「高级设置」→ 关闭「启动时自动检查更新」和「启用软件商店在线功能」
- 若仍卡在「加载组件列表」界面，可手动编辑配置文件：
%APPDATA%\phpEnv\config.json，将"enable_online_store"改为false
离线环境下安装 PHP/MySQL 版本的实际操作
phpEnv 的「安装」本质是解压预下载的 ZIP 包并初始化服务配置。只要缓存包完整，全程无需联网：
立即学习“PHP免费学习笔记（深入）”；
- 点击左侧「PHP 版本」→ 右键已下载的
php-8.3.13→ 选择「安装」 - 安装过程会显示「正在解压」「正在初始化配置」，不出现「正在下载」字样即为正常
- 若提示「无法连接远程仓库获取扩展列表」，忽略即可；常用扩展（如
openssl、pdo_mysql）已随 PHP 包内置，无需额外下载 - MySQL 同理：在「数据库」页右键已缓存的
mysql-8.0.33→ 「安装」→ 等待初始化完成
离线项目启动后常见报错与绕过方式
即使环境装好了，某些功能仍可能因缺失网络校验而异常：
-
hosts 自动写入失败：离线机常因权限或 hosts 文件只读导致失败。手动用记事本以管理员身份打开C:\Windows\System32\drivers\etc\hosts，追加一行127.0.0.1 demo.local -
Composer 命令不可用：phpEnv 不自带 Composer。需提前在联网机下载composer-setup.php，再用离线机的 PHP 执行：php composer-setup.php --install-dir=D:\phpEnv\tools，最后把该路径加入系统PATH -
PHP 扩展启用失败（如 curl、gd）：检查php.ini中对应extension=php_curl.dll行是否取消注释；确保extension_dir = "./ext"路径正确，且.dll文件真实存在于ext/目录下
真正麻烦的不是「能不能跑」，而是离线后无法验证组件完整性——比如某个 PHP ZIP 包下载中断却没报错，解压后缺 php.exe 或 libmysql.dll，错误日志只会显示「服务启动失败」，不会告诉你缺哪个文件。建议离线部署前，在联网机用相同版本完整走一遍安装流程，确认 Apache 和 MySQL 都能绿色启动并响应请求，再打包整个 %APPDATA%\phpEnv 目录带走。
