离线无网络环境手动安装PHP开发环境步骤-php教程-PHP中文网

离线安装php开发环境的核心难点是提前备齐所有必需文件并确保配置精准无误。必须准备php主程序、web服务器（apache/nginx）、数据库（mysql）、扩展dll/.so文件、依赖库及php.ini模板；windows需严格配置httpd.conf中loadmodule、phpinidir和addtype三行；linux编译前须打包安装build-essential、libxml2-dev等关键dev包；验证须完成apache+php+test.php访问闭环，且phpinfo()中loaded configuration file路径必须与实际文件完全一致。

离线无网络环境手动安装php开发环境步骤

离线环境装 PHP 开发环境，核心难点不是“能不能装”，而是“哪些文件必须提前准备好、哪些配置不能依赖网络验证”。只要提前把所有二进制包、扩展 DLL、依赖库和配置模板拷全，完全可脱离网络完成部署。

必须提前下载的离线安装包清单

离线环境下，所有组件都得靠本地文件，缺一不可。别只下 PHP 主程序——它跑不起来。

php-8.3.x-Win32-vs16-x64.zip（Windows）或 php-8.3.x.tar.gz（Linux/macOS），注意选 Thread Safe 版本；
对应版本的 php_apache2handler.dll（Windows Apache）或 libphp.so（Linux Apache）；
Apache 2.4.x 的完整安装包（httpd-2.4.xx-win64-VS16.zip 或 .msi）；
MySQL 8.0.x 的离线安装包（mysql-installer-community-8.0.xx.msi 或 mysql-8.0.xx-linux-glibc2.12-x86_64.tar.xz）；
若需 GD、cURL、PDO MySQL 等扩展，提前确认对应 DLL 或 .so 文件已包含在 PHP ext/ 目录中（例如 php_gd.dll、php_pdo_mysql.dll）；
一份可用的 php.ini 模板（推荐从官网下载包里的 php.ini-development 改名而来）。

Windows 下 Apache + PHP 手动加载模块的关键配置

离线时没法用 php -m 验证模块，也不能在线查报错日志路径，所以配置必须一步到位。

在 Apache 的 httpd.conf 中，必须严格按顺序写这三行：

LoadModule php_module "C:/php/php8apache2_4.dll"
PHPIniDir "C:/php"
AddType application/x-httpd-php .php

常见错误：

LoadModule 路径写错（比如漏了 .dll 后缀，或用了 php5apache2_2.dll 配 PHP 8.x）；
PHPIniDir 指向目录而非文件，且该目录下必须存在 php.ini；
没加 AddType，导致 .php 文件被当成纯文本下载；
Apache 启动失败但日志为空——检查 httpd.exe -t 是否能通过语法校验，错误提示会直接打在控制台。

Linux 离线编译 PHP 时最容易漏掉的依赖项

没网络时 ./configure 报 “xxx not found” 就意味着对应开发头文件缺失，不是重试能解决的。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

Ubuntu/Debian 离线编译前，必须提前打包好这些 deb 包并安装：

build-essential（含 gcc、make）；
libxml2-dev（否则 configure 报 “libxml2 not found”）；
libcurl4-openssl-dev（影响 cURL 扩展）；
libjpeg-dev、libpng-dev、libfreetype6-dev（GD 扩展必需）；
libonig-dev（PHP 8.0+ 正则引擎依赖，常被忽略）；
libsqlite3-dev（PDO SQLite 支持）。

编译命令示例（精简版）：

./configure --prefix=/usr/local/php8 \
--with-apxs2=/usr/local/apache2/bin/apxs \
--enable-mbstring --with-curl --with-gd \
--with-pdo-mysql=/usr/local/mysql

离线环境下验证 PHP 是否真正可用的最小闭环

别只跑 php -v ——那只能说明 CLI 模式通了，不代表 Web 能跑。

必须走完这个链路：

启动 Apache（httpd -k start 或 sudo systemctl start apache2）；
在 DocumentRoot 下放一个 test.php，内容仅一行：<?php echo 'OK'; ?>；
用另一台已联网的机器（或手机）访问 http://[服务器IP]/test.php，看是否返回 OK；
如果返回空白或下载文件，立刻检查 Apache 错误日志（logs/error_log）里有没有 PHP Warning: Module 'gd' already loaded 这类重复加载提示——离线时扩展启用冲突比在线更难排查。