必须将c:\php添加到系统path、设置phprc=c:\php,并重启终端,否则php -v报错且配置不生效;验证需三步:php -v显示版本、php --ini显示php.ini路径、php -m确认扩展启用。

Windows手动安装PHP 8.3.14后,必须正确设置系统环境变量,否则php -v会报“不是内部或外部命令”,Composer、Symfony等工具也无法识别PHP。关键不是只加路径,而是加对路径、重启终端、并配合PHPRC才能让配置真正生效。
确认PHP安装路径并准备php.ini
解压官方ZIP包(如php-8.3.14-Win32-vs16-x64.zip)到不含空格和中文的目录,推荐C:\php。进入该目录,确认存在php.exe和php.ini-development。将后者复制重命名为php.ini——这一步不能跳过,否则后续配置无效。
添加PHP路径到系统PATH
PATH必须指向php.exe所在目录,不是上层父目录,也不是ext子目录:
- 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在“系统变量”中找到
Path,点击“编辑” → “新建” - 输入精确路径:C:\php(末尾不带
\,不加引号) - 点击“确定”逐级保存
⚠️ 所有已打开的CMD/PowerShell/VS Code终端必须彻底关闭再重开,否则仍读取旧环境。
必须设置PHPRC变量(PHP 8.1+强制要求)
仅设PATH,PHP 8.3.14默认不会自动加载php.ini,php --ini会显示Loaded Configuration File => (none):
- 仍在“环境变量”窗口,在“系统变量”区域点击“新建”
- 变量名填:PHPRC
- 变量值填:C:\php(即
php.ini所在目录,不含文件名)
这一步确保extension=、date.timezone等配置实际起作用。
验证三步缺一不可
在全新打开的命令提示符中依次执行:
-
php -v—— 应输出PHP 8.3.14 -
php --ini——Loaded Configuration File必须明确显示C:\php\php.ini -
php -m | findstr "mbstring openssl pdo_mysql"—— 三个扩展名应全部出现在结果中
三项全通过,才算PHP 8.3.14环境变量与配置真正就绪。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











