phpEnv离线安装需提前在联网机打包PHP源码、系统依赖包(.deb/.rpm)及构建工具,拷贝至离线机后执行phpenv install --skip-existing 8.3.13,并确保权限、TMPDIR和扩展配置正确。

phpEnv 本身没有官方“离线安装包”概念,它不是预编译好的二进制分发版,而是依赖本地编译的版本管理工具。所谓“离线安装”,本质是把编译 PHP 所需的一切——源码、依赖库、构建工具——提前在有网机器上打包好,再搬到目标环境手动构建。
为什么直接下载 phpEnv 无法解决离线问题
phpEnv 只是一个 shell 脚本调度器,真正执行 phpenv install 8.3.13 时,它会调用 php-build 插件去下载 PHP 源码、检查系统依赖、配置 ./configure 参数、运行 make && make install。整个过程必须联网下载源码(如 php-8.3.13.tar.gz)和自动检测缺失依赖——这两步在无网络时必然失败。
- 你 clone 的
phpenv仓库本身只有几百 KB,不包含任何 PHP 二进制或源码 -
phpenv install命令默认从 php.net 下载源码,无法跳过 - 即使提前放好
php-8.3.13.tar.gz到$(phpenv root)/cache/,仍可能因缺少autoconf、libssl-dev等系统级依赖而中断编译
离线安装必须准备的三类文件
在有网机器上一次性收集齐以下内容,拷贝到离线机后才能完成构建:
-
PHP 源码包:例如
php-8.3.13.tar.gz,从https://www.php.net/distributions/下载,放到离线机的$(phpenv root)/cache/目录(路径可通过phpenv root查看) -
系统依赖的离线安装包:
- Ubuntu/Debian:
build-essential、autoconf、libssl-dev、libxml2-dev、zlib1g-dev等对应的.deb文件(用apt-get download获取) - CentOS/RHEL:
gcc、autoconf、openssl-devel、libxml2-devel、zlib-devel等对应的.rpm文件(用yumdownloader获取)
- Ubuntu/Debian:
-
构建工具链本身:如
make、gcc、re2c、bison—— 这些通常已预装,但若离线机是精简系统,需一并打包
离线环境下执行安装的准确命令流程
确保已手动安装完所有系统依赖(dpkg -i *.deb 或 rpm -i *.rpm),且 phpenv 和 php-build 插件已就位后,执行:
立即学习“PHP免费学习笔记(深入)”;
phpenv install --skip-existing 8.3.13
关键点说明:
-
--skip-existing强制跳过远程下载,只从cache/目录读取源码包 - 若报错提示
configure: error: no acceptable C compiler found,说明gcc或make缺失,不是 PHP 源码问题 - 若卡在
checking for OpenSSL support...,大概率是libssl-dev(或openssl-devel)未正确安装,而非 OpenSSL 运行时库 - 每次
phpenv install成功后,务必运行phpenv rehash,否则php命令仍不可用
容易被忽略的权限与路径细节
离线安装最常栽在两个隐形环节:
-
$(phpenv root)/versions/目录需对当前用户有完整读写权限,否则make install会因无法创建子目录而静默失败 - 某些企业离线环境禁用了
/tmp执行权限,而php-build默认在/tmp解压源码;可临时设export TMPDIR="$HOME/tmp"并提前mkdir -p $HOME/tmp -
phpenv install不会自动启用常用扩展(如opcache、pdo_mysql),需通过PHP_BUILD_CONFIGURE_OPTS预设,例如:PHP_BUILD_CONFIGURE_OPTS="--enable-opcache --with-pdo-mysql" phpenv install 8.3.13



















