必须设置path、phprc和php_home三环境变量:path指向含php.exe的目录(如c:\php84),phprc指向php.ini所在目录以加载配置,php_home供工具识别;每步修改后需重启终端验证php -v、php --ini及扩展与时区。

Windows 10 部署 PHP 8.4.1(当前最新稳定版)时,环境变量设置必须精准、分步验证,不能只加 PATH 就完事。PHP 8.1 起默认不自动加载 php.ini,PATH 错误或 PHPRC 缺失都会导致 php -v 报错、扩展不加载、时区失效等静默失败。
一、确认 php.exe 所在目录并添加到系统 PATH
PATH 必须填 含 php.exe 的完整目录路径,不是父目录,也不是子目录,也不能带反斜杠或引号:
- 例如你解压 PHP 到
C:\php84,且该目录下直接有php.exe→ 正确添加:C:\php84 - 错误写法:
C:\php84\(末尾反斜杠)、"C:\php84"(带引号)、C:\php84\php.exe(指向文件,非目录)、C:\php84\ext(子目录) - 打开「此电脑」→「属性」→「高级系统设置」→「环境变量」→「系统变量」→ 找到 Path →「编辑」→「新建」→ 粘贴路径 →「确定」
二、必须设置 PHPRC 指向 php.ini 所在目录
PHP 8.4.1 不再从 PATH 目录搜索配置文件。若不设 PHPRC,php --ini 会显示 Loaded Configuration File => (none),所有 extension=、date.timezone 全部失效:
- 在「环境变量」→「系统变量」→「新建」→ 变量名:PHPRC,变量值:
C:\php84(和 PATH 值一致,不含 php.exe) - 确保
C:\php84\php.ini文件存在(把php.ini-development复制重命名为php.ini)
三、推荐补充 PHP_HOME(方便 Composer、PHPUnit 等工具识别)
虽然非强制,但多数现代 PHP 工具依赖它定位扩展和配置目录:
- 同样在「系统变量」中「新建」→ 变量名:PHP_HOME,变量值:
C:\php84 - 注意:PHP_HOME 值是目录路径,不是可执行文件路径,也不含
\bin或\php.exe
四、验证三步缺一不可
每改完一次环境变量,必须关闭所有已打开的 CMD/PowerShell/VS Code 终端,重新打开一个全新窗口再测试:
-
php -v→ 显示版本号(如PHP 8.4.1),说明 PATH 生效 -
php --ini→ “Loaded Configuration File” 行明确显示C:\php84\php.ini,说明 PHPRC 生效 -
php -m | findstr "mbstring"→ 有输出,说明扩展已加载;再试php -r "echo date_default_timezone_get();"应返回Asia/Shanghai等正确时区
不复杂但容易忽略
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











