PHP 8.1 在 Win10 上必须将 php.exe 所在目录（如 C:\php）加入系统 Path，并设置 PHP_HOME 和 PHPRC，否则 php -v 会报“不是内部或外部命令”或配置不生效；因 Windows 仅精确匹配 Path 中的可执行文件目录，且 PHP 8.1 默认不再自动查找 php.ini，必须通过 PHPRC 显式指定。
直接说结论：PHP 8.1 在 Win10 上必须把 php.exe 所在目录（如 C:\php）加进系统 Path，同时建议补全 PHP_HOME 和 PHPRC——否则 php -v 会失败，或扩展加载异常、配置不生效。
为什么 php -v 报“不是内部或外部命令”
这是最常见现象，本质是 Windows 找不到 php.exe。Win10 不会自动扫描子目录，只认 Path 中**精确到可执行文件所在目录**的路径（不是上层父目录，更不是 C:\）。比如你解压 PHP 到 C:\php，而 php.exe 就在该目录下，那就要把 C:\php 加入 Path，不是 C:\php\ext，也不是 C:\php\php.ini。
常见错误操作包括：
- 只添加了
C:\php\ext（这是扩展目录，不是可执行目录） - 复制粘贴时多了一个空格或中文顿号，导致路径无效
- 用的是 ZIP 包但没解压——Win10 不支持直接运行压缩包里的
php.exe - 下载的是 Thread Safe (TS) 版却配给 Apache，或选了 Non-Thread Safe (NTS) 版却想用
php -S内置服务器（其实 NTS 更适合 CLI）
PHP_HOME 和 PHPRC 不是可选项，是稳定运行的关键
很多教程说“可加可不加”，但在 PHP 8.1+ 实际使用中，缺一不可：
立即学习“PHP免费学习笔记（深入）”；
-
PHP_HOME：值为 PHP 安装根目录（如C:\php），不带\bin或\php.exe；它本身不被 CLI 直接读取，但composer、phpunit等工具依赖它定位扩展和配置 -
PHPRC：值为php.ini所在目录（通常就是C:\php）；PHP 8.1 默认不再从PATH目录自动找php.ini，必须显式指定，否则所有extension=、date.timezone都不生效 - 顺序很重要：先设
PHP_HOME和PHPRC，再改Path；否则php -i | findstr "Configuration"会显示Loaded Configuration File => (none)
验证是否真生效：别只信 php -v
php -v 成功只说明找到了可执行文件，不代表配置就对了。真正验证要分三步：
- 运行
php -v：确认有版本输出，且无Warning: Failed to load config file - 运行
php --ini：输出应类似：Configuration File (php.ini) Path: C:\WINDOWS<br>Loaded Configuration File: C:\php\php.ini<br>Scan for additional .ini files in: (none)<br>Additional .ini files parsed: (none)
其中Loaded Configuration File必须是你设的PHPRC路径下的php.ini - 运行
php -m | findstr "mbstring curl"：确保常用扩展已启用（前提是php.ini里已取消注释extension=mbstring等）
如果 php --ini 显示 Loaded Configuration File => (none)，99% 是 PHPRC 没设对，或者 php.ini 文件名拼错（比如写成 php_ini 或 php.ini.bak）。
PowerShell 一键设置（管理员权限运行）
如果你习惯脚本化操作，避免图形界面点错，可用以下 PowerShell 命令一次性写入（替换 C:\php 为你的实际路径）：
[Environment]::SetEnvironmentVariable("PHP_HOME", "C:\php", "Machine")<br>[Environment]::SetEnvironmentVariable("PHPRC", "C:\php", "Machine")<br>$path = [Environment]::GetEnvironmentVariable("Path", "Machine")<br>if ($path -notlike "*C:\php*") {<br> [Environment]::SetEnvironmentVariable("Path", "$path;C:\php", "Machine")<br>}
执行后需重启当前 CMD/PowerShell 窗口，或运行 refreshenv（需先安装 choco install refreshenv）。
最后提醒一句：Win10 的环境变量修改不会立即对已打开的命令行生效，哪怕你刚点完“确定”。关掉所有 CMD/PowerShell，重新开一个再测——这个细节，90% 的人第一次都会忽略。
