Linux 与 Windows 的 PHP 编译和运行路径机制完全不同:--prefix、php.ini 查找、extension_dir、扩展格式及路径分隔符等均不可互换,必须按各自系统 ABI 和运行时约束分别处理。

PHP 源码编译时 --prefix 在 Linux 和 Windows 上根本不是一回事
Windows 下不能直接编译 PHP 源码——官方不支持、没人维护、configure 脚本压根跑不起来。所谓“Windows 编译 PHP”,实际是用 Visual Studio + nmake 配合 buildconf.js 和 configure.js 生成项目文件,路径约定也完全不同。
Linux 下的 --prefix=/usr/local/php 会决定 bin/、lib/、etc/ 的默认落点;而 Windows 的 configure.js 用的是 --prefix=C:\php-sdk\phpdev\vc17\x64 这类路径,且只影响构建中间产物位置,最终安装靠 nmake snap 打包成 ZIP,没有真正的“系统级安装”概念。
- Linux 编译依赖
autoconf、libtool、gcc,路径解析走 POSIX 标准 - Windows 编译依赖 Microsoft Build Tools,路径中反斜杠、驱动器号、空格都会导致
configure.js解析失败 -
--with-config-file-path在 Linux 默认是$prefix/etc,在 Windows 默认是C:\php(硬编码进二进制),改不了
php.ini 加载路径差异直接导致配置失效
Linux 下 PHP 启动时按顺序查找:--with-config-file-path 指定路径 → 编译时 --prefix 下的 etc/php.ini → 环境变量 PHPRC → 当前目录 → ./。而 Windows 下只认两个地方:C:\php\php.ini(硬编码 fallback)和 GetModuleFileName() 所在目录下的 php.ini ——哪怕你用 --with-config-file-path=C:\myapp\conf 编译,运行时也不会去那里找。
- Windows 不读
PHPRC环境变量(除非用 CLI 且显式加-c参数) - Apache 模块模式下,Windows 版 PHP 会优先检查 Apache
ServerRoot目录下的php.ini - CLI 模式下可用
php -c C:\myapp\php.ini -v强制指定,但 Web SAPI(如 apache2handler)不支持该参数
扩展路径 extension_dir 的默认值在两端完全不可互换
Linux 编译后默认 extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20220829"(含 ZTS/TS 标识和 API 版本号);Windows 默认是 "ext"(相对路径),实际加载时拼到 GetModuleFileName() 所在目录下,比如 C:\php\ext\php_mysqli.dll。
立即学习“PHP免费学习笔记(深入)”;
- Linux 的
.so扩展不能直接拷到 Windows 的ext目录下,反之亦然 - Windows 的扩展名必须是
.dll,且必须用对应 VC 版本(VC15/VC17/VC19)和线程模型(NTS/TS)编译,混用直接报PHP Warning: Unable to load dynamic library 'php_mysqli.dll' - Linux 下可通过
php-config --extension-dir查真实路径;Windows 下只能看phpinfo()输出或源码里PHP_EXTENSION_DIR宏定义
符号链接、大小写、路径分隔符这些细节真会卡住部署
Linux 下 /usr/local/php/bin/php 可以是符号链接,php -m 仍能正确解析扩展路径;Windows 下 php.exe 若放在符号链接目录(如 NTFS junction),GetModuleFileName() 返回的是目标路径,但 php.ini 查找逻辑仍基于快捷方式所在位置,极易错配。
- Linux 文件系统区分大小写,
extension=php_curl.so和extension=php_CURL.so是两个不同文件;Windows 不区分,但加载时会按小写名匹配,大小写混乱可能触发重复加载警告 - Linux 用
/,Windows 用\,但 PHP 内部多数路径处理函数(如dirname()、realpath())在 Windows 上也接受/,唯独extension_dirini 设置里写/会导致找不到 DLL(必须用\或双反斜杠) -
open_basedir在 Windows 下路径必须带驱动器号(C:\www),写\www或/www全无效
./configure 和 Windows 的 configure.js 是两套完全独立的逻辑;路径不是改个斜杠就能跨平台,每个环节都得按目标系统的 ABI、加载机制和运行时约束来对齐。











