Windows下PHP脚本更新Path环境变量切换PHP版本遇阻

问题本质 #

• putenv()只能修改当前PHP进程的环境变量，完全不影响系统/用户级Path，也无法同步到其他进程
• 直接修改注册表HKCU\Environment的Path后，Windows不会主动通知所有进程更新环境变量——手动打开环境变量窗口点确定能生效，是因为这个操作会触发系统发送WM_SETTINGCHANGE刷新消息

核心解决方案 #

在脚本修改注册表后，添加触发系统刷新环境变量的命令，让后续启动的CMD自动读取新的Path值。同时优化脚本中的不稳定逻辑。

修改后的完整脚本 #

// 加载可用PHP版本
$laragon_php_paths = 'D:\www-servers\laragon\bin\php';
// 过滤掉当前目录和上级目录，重置数组索引
$php_paths = array_values(array_filter(scandir($laragon_php_paths), fn($dir) => $dir !== '.' && $dir !== '..'));
$path_var_name = "Path";

// 备份用户环境变量注册表
$date = new DateTime();
exec('REG EXPORT HKCU\Environment "BackupUserEnvironment_' . $date->format('YmdHisv') . '.reg"');

// 读取用户Path环境变量
exec('REG QUERY HKCU\Environment /v ' . $path_var_name, $output, $result);
if ($result !== 0) {
    die('读取用户Path注册表项失败');
}
// 用正则提取Path值，避免依赖空格分割的不稳定逻辑
$path_value = trim(preg_replace('/^\s*Path\s+REG_EXPAND_SZ\s+/', '', $output[2]));
// 分割Path并过滤空元素
$path_array = array_filter(explode(';', $path_value));

// 定位当前PHP路径在Path中的位置及版本
$the_key = null;
$current_php_version = null;
foreach ($path_array as $key => $path_item) {
    if (strpos($path_item, $laragon_php_paths) !== false) {
        $the_key = $key;
        $current_php_version = basename($path_item);
        break; // 找到第一个匹配项即停止
    }
}

// 输出可选PHP版本
echo '可用PHP版本:' . PHP_EOL . PHP_EOL;
foreach ($php_paths as $index => $dir) {
    $display_index = $index + 1;
    echo '    [' . $display_index . '] ' . $dir;
    if ($dir === $current_php_version) {
        echo ' [当前版本]';
    }
    echo PHP_EOL;
}

// 获取用户选择
echo PHP_EOL;
echo '选择PHP版本: ';
$fd = fopen('php://stdin', 'r');
$choice = (int) trim(fgets($fd));
fclose($fd);
echo PHP_EOL;

// 处理选择并更新Path数组
$changed = false;
if ($choice > 0 && $choice <= count($php_paths)) {
    $new_php_version = $php_paths[$choice - 1]; // 修正数组索引匹配逻辑
    if ($the_key !== null) {
        // 替换已存在的PHP路径
        $path_array[$the_key] = $laragon_php_paths . '\\' . $new_php_version;
    } else {
        // Path中无PHP路径则添加到开头
        array_unshift($path_array, $laragon_php_paths . '\\' . $new_php_version);
    }
    $changed = true;
    echo '已切换PHP版本为: ' . $new_php_version . PHP_EOL;
} else {
    echo '无效选择，未做任何修改.' . PHP_EOL;
}

// 更新注册表并刷新环境变量
if ($changed) {
    $new_path = implode(';', $path_array);
    // 处理注册表转义：%需要替换为%%
    $escaped_path = str_replace('%', '%%', $new_path);
    $cmd = 'REG ADD HKCU\Environment /f /t REG_EXPAND_SZ /v ' . $path_var_name . ' /d "' . $escaped_path . '"';
    
    exec($cmd, $reg_output, $reg_result);
    if ($reg_result !== 0) {
        die('更新注册表Path项失败');
    }

    // 触发系统刷新环境变量，让新CMD窗口自动读取新值
    exec('rundll32.exe user32.dll,UpdatePerUserSystemParameters 1 True');
    echo '环境变量已刷新，新的PHP版本将在新CMD窗口中生效.' . PHP_EOL;
}

关键优化点 #

1. 环境变量刷新：添加rundll32.exe user32.dll,UpdatePerUserSystemParameters 1 True命令，触发系统发送WM_SETTINGCHANGE消息，无需手动打开环境变量窗口
2. 注册表值提取：用正则替代固定空格分割，避免因注册表输出格式变化导致的解析错误
3. 数组索引修正：修复原脚本中选择版本时的索引错误，匹配数组实际起始位置
4. 空元素处理：过滤Path中的空元素，避免产生多余分号
5. 错误检查：添加注册表读写的结果校验，避免静默失败

内容的提问来源于stack exchange，提问作者Glob Dug