Windows 上应选 PHP 官网 NTS ZIP 包(PHP 8.0+ 仅提供 NTS),IIS+FastCGI 必用 NTS;下载时认准 windows.php.net/download,匹配 VC15/VC17 运行库与 x64/x86 架构;php.ini 需从模板复制并配置 extension_dir、启用扩展及 date.timezone;CLI 与 Web 须统一 php.ini 路径;报错多因 DLL 缺失或扩展不兼容,优先安装对应 VC 运行库并逐个排查扩展。

PHP for Windows 官方二进制包怎么选
Windows 上不推荐编译安装,直接用 PHP 官方提供的 Thread Safe (TS) 或 Non-Thread Safe (NTS) ZIP 包最稳妥。关键区别不在“线程安全”字面意思,而在于运行环境:IIS + FastCGI 必须用 NTS;Apache + mod_php(已淘汰)或 nginx + php-fpm 场景下,现代 PHP 8.0+ 实际只维护 NTS 版本。PHP 7.4 是最后一个提供 TS 包的版本,之后官网仅发布 NTS ZIP。
下载时注意三点:
- 认准 windows.php.net/download —— 不是第三方镜像或捆绑包
- 选
VC15或VC17对应你的 Visual C++ 运行库:PHP 8.2/8.3 用VC17(需安装 Microsoft Visual C++ 2022 Redistributable) - 扩展统一用
.dll后缀,但启用前必须确认与 PHP 主版本、TS/NTS 类型、架构(x64/x86)完全匹配,否则PHP Startup: Unable to load dynamic library
解压即用型配置:php.ini 从哪来
官方 ZIP 包里没有 php.ini 文件,只有 php.ini-development 和 php.ini-production 两个模板。开发机选前者,生产环境选后者 —— 差异主要在错误报告级别、显示错误开关、OPcache 默认状态等。
复制任一模板并重命名为 php.ini 后,必须手动修改几处关键项:
立即学习“PHP免费学习笔记(深入)”;
-
extension_dir = "ext"→ 改为绝对路径,例如extension_dir = "C:/php/ext"(路径用正斜杠或双反斜杠) - 启用常用扩展:取消
;extension=openssl、;extension=pdo_mysql等行前的分号,注意 Windows 下扩展名是.dll,不是.so -
date.timezone = Asia/Shanghai必设,否则strtotime()、date()等函数返回 UTC 时间
改完后用命令验证:
php -v若报错或看不到扩展名,说明路径或扩展版本不匹配。
php --ini
php -m | findstr "openssl mysql"
让 PHP 命令行和 Web 服务共用同一套配置
CLI(命令行)和 Web SAPI(如 Apache/nginx)默认读取不同位置的 php.ini,容易出现「网页里 extension 没加载,但 cmd 里能用」这类问题。根本解法是统一指定配置路径:
- CLI 下强制指定:
php -c C:\php\php.ini -v - Web 服务器中,Apache 需在
httpd.conf加:PHPIniDir "C:/php";nginx + php-fpm 则在php-fpm.conf中设php_admin_value[php_ini] = C:/php/php.ini -
环境变量方式(全局但不推荐):
set PHP_INI_SCAN_DIR=C:\php,仅影响当前 CMD 窗口
验证是否生效:在 PHP 脚本中输出 phpinfo(),搜索 Loaded Configuration File,值必须是你期望的路径。
常见启动失败原因与快速排查
运行 php -v 报错,90% 出在 DLL 依赖缺失或版本冲突。典型错误和对应动作如下:
-
The code execution cannot proceed because VCRUNTIME140.dll was not found→ 安装对应 VC 运行库(VC15/VC17),不要试图复制 DLL -
PHP Warning: Module 'xxx' already loaded→ 检查php.ini是否重复写了extension=,或php.ini被多次 include -
Warning: Unknown: failed to open stream: Invalid argument→include_path中含中文路径或未转义的反斜杠,改用正斜杠 - Web 页面空白,且 error_log 显示
Segmentation fault→ 扩展与 PHP 版本不兼容(比如用 PHP 8.2 的redis.dll强行跑在 PHP 8.3 上)
真正麻烦的是扩展之间隐性冲突,比如同时启用 opcache 和某些调试扩展(xdebug 早期版本)。遇到疑难问题,先禁用所有第三方扩展,逐个启用测试。











