必须将php.exe所在目录(如c:\phpenv\php)加入系统path,并设置phprc指向php.ini所在目录(通常同为c:\phpenv\php),php 8.1+才可正常识别命令并加载配置;还需复制php.ini-development为php.ini、启用必要扩展及时区,推荐增设php_home。

要在Windows命令行任意位置执行php -v、php --ini等命令,必须让系统准确识别php.exe位置并加载正确的php.ini配置文件,否则会报“不是内部或外部命令”或显示Loaded Configuration File => (none)。
添加PHP目录到系统PATH
第一步:确认php.exe所在完整路径,例如C:\phpEnv\php(该目录下必须直接存在php.exe文件)。
第二步:右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,在“系统变量”区域找到Path,点击“编辑”→“新建”→粘贴刚才确认的路径【C:\phpEnv\php】。
第三步:关闭所有已打开的CMD、PowerShell、VS Code终端窗口,重新打开一个全新CMD,运行where php——若输出C:\phpEnv\php\php.exe,则PATH生效;若无输出,说明路径未生效或填错层级。
注意:路径末尾不能带反斜杠\,也不能加英文引号;填C:\phpEnv或C:\phpEnv\php\ext都会失败。
设置PHPRC指向php.ini所在目录
PHP 8.1+默认不再从PATH目录自动查找php.ini,只设PATH无法加载配置。必须额外设置PHPRC环境变量。
方法一:在“环境变量”→“系统变量”中点击“新建”,变量名填PHPRC,变量值填【C:\phpEnv\php】(即php.ini所在目录,不是php.exe所在目录的上层父目录)。
方法二:若php.ini放在其他位置(如C:\phpEnv\config),则PHPRC值必须精确填写该路径,且确保该路径下确实存在php.ini文件。
验证方式:CMD中运行php --ini,观察“Loaded Configuration File”后是否显示你设定的路径;若仍为(none),请检查PHPRC是否拼写错误、路径是否多出空格、是否遗漏了保存操作。
准备并启用php.ini配置文件
官方ZIP包解压后只有php.ini-development和php.ini-production两个模板文件,没有真正的php.ini。
将php.ini-development复制一份,重命名为php.ini,放入PHP安装根目录(如C:\phpEnv\php)。
用记事本或VS Code打开该php.ini,搜索;extension_dir = "ext",删除分号并确认ext文件夹真实存在——若路径不对,后续扩展(如pdo_mysql)将全部加载失败。
取消以下几行前的分号以启用基础扩展:
;extension=mbstring
;extension=gd
;extension=mysqli
;extension=pdo_mysql
搜索;date.timezone =,修改为date.timezone = Asia/Shanghai,避免时间相关函数报Warning。
可选但强烈推荐:设置PHP_HOME
在“环境变量”→“系统变量”中新增变量PHP_HOME,值为PHP安装根目录(如C:\phpEnv\php),不含php.exe。
Composer、phpunit、某些IDE插件依赖PHP_HOME定位扩展和配置,不设会导致“Could not find driver”等模糊报错。
这一步操作起来很简单,直接在系统变量里新增一行即可。
验证三步法
每完成上述任一环节,都需在全新CMD中依次运行以下三条命令:
php -v → 显示版本号且无报错
php --ini → Loaded Configuration File明确指向你设的路径
php -m | findstr "mbstring" → 输出mbstring表示扩展已启用
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











