PAYATHON 2026

如何在 Windows 原生 PHP 中创建 .mylogin.cnf

排障赵师傅

结论

mysql_config_editor 不会通过普通的标准输入管道读取密码。为了关闭输入回显,并防止 echo password | ... 这类调用,它会直接访问当前控制台。因此,把密码写入 proc_open() 创建的 $pipes[0] 没有作用。这里的 $pipes[0] 是匿名管道,与 socket 无关。

在 Windows 原生 PHP 中,可以根据使用场景选择以下方案:

  • 允许用户现场输入密码时,让 mysql_config_editor 继承 PHP CLI 的控制台。
  • 需要全自动输入时,使用 Windows ConPTY 或专用辅助程序。PHP 标准库没有可直接调用的跨平台 TTY/ConPTY 接口。
  • 不要自行生成 .mylogin.cnf。这是 MySQL 的内部格式,没有稳定、公开的写入接口。
  • .mylogin.cnf 只会混淆存储凭据,不能视为安全加密。保护凭据主要依靠文件访问权限。

为什么 proc_open() 的输入管道不起作用

proc_open() 的描述符配置只会重定向三个标准流:

0 = stdin
1 = stdout
2 = stderr

普通批处理中的 set /p 从标准输入读取内容,所以向 $pipes[0] 写入数据可以生效。

密码程序的处理方式不同。为了关闭回显,防止密码从重定向文件或管道传入,程序通常会直接访问终端设备。在 Windows 上,它一般直接读取 Console,而非标准输入句柄。密码提示也可能直接输出到 Console,所以即使 stdout 和 stderr 已经重定向,提示仍会显示在 PHP 所在的终端窗口中。

mysql_config_editor 读取的设备不是 $pipes[0],因此调整阻塞模式、增加 sleep() 或改用 socket 都无法解决这个问题。

允许用户交互输入时的做法

如果 PHP 脚本在真实终端中运行,可以让子进程继承当前控制台,由用户直接输入密码,无须经过 PHP:

<?php

if (PHP_SAPI !== 'cli' || !stream_isatty(STDIN)) {
    throw new RuntimeException(
        'mysql_config_editor 必须从交互式终端运行。'
    );
}

$editor = 'C:\\Program Files\\MySQL\\MySQL Server 8.4\\bin\\mysql_config_editor.exe';

$command = [
    $editor,
    'set',
    '--login-path=app',
    '--host=localhost',
    '--user=myuser',
    '--password',
];

$descriptors = [
    0 => STDIN,
    1 => STDOUT,
    2 => STDERR,
];

$process = proc_open(
    $command,
    $descriptors,
    $pipes,
    null,
    null,
    ['bypass_shell' => true]
);

if (!is_resource($process)) {
    throw new RuntimeException('无法启动 mysql_config_editor。');
}

$exitCode = proc_close($process);

if ($exitCode !== 0) {
    throw new RuntimeException(
        "mysql_config_editor 退出,状态码为 {$exitCode}。"
    );
}

命令使用数组形式,可以省去手工拼接命令行时的引号和转义处理。

这种方式适合 CLI 安装程序,不适用于 PHP-FPM、Apache 模块、IIS FastCGI 等 Web 服务环境。Web 服务进程通常没有可供用户操作的 Console。即使创建 stdin 管道,也无法将其变成控制台输入。

创建登录路径后,可以用以下命令检查。该命令不会显示明文密码:

mysql_config_editor.exe print --all

全自动输入为什么需要 ConPTY

ConPTY 是 Windows 上与 Unix PTY 对应的机制。为了让目标程序认为自己连接到了真实控制台,调用方大致需要执行以下操作:

  1. 创建 ConPTY 的输入和输出管道。
  2. 调用 CreatePseudoConsole()。
  3. 使用带 PROC_THREAD_ATTRIBUTE_PSEUDOCONSOLE 的 STARTUPINFOEX。
  4. 在伪控制台中启动 mysql_config_editor.exe。
  5. 从输出管道读取提示,再向输入管道写入密码。
  6. 操作完成后清理密码缓冲区和所有句柄。

PHP 的 proc_open() 不会代为执行这些步骤。理论上可以通过 FFI 调用 Windows API,但该方案仅适用于 Windows,还必须正确处理结构体布局、宽字符、句柄继承、进程生命周期和错误清理。许多生产环境也会禁用 FFI。

只用 PHP 标准库无法同时为 Windows 和 Unix 提供统一实现。实际可选的方案包括:

  • 使用 expect、unbuffer 等现有工具;
  • 编写使用 ConPTY 的 Windows 辅助程序,并随应用一起分发;
  • 使用有维护的第三方库;
  • 保留人工输入步骤。

专用辅助程序同样属于外部依赖,只是由应用自行携带。

不要把密码放进命令行

不要使用下面这种方式:

mysql_config_editor ... --password=secret1

这个参数形式可能不受支持,而且命令行内容可能被进程查看工具、诊断日志、任务调度器或错误报告记录。环境变量同样不适合用作可靠的秘密存储位置。

如果密码来自 HTTP 请求,也不要把它写入访问日志、异常信息或调试输出。即使最后通过 ConPTY 传递,密码仍会短暂保留在 PHP 和辅助程序的内存中。

是否应该由 PHP 直接创建 .mylogin.cnf

不建议由 PHP 直接创建 .mylogin.cnf。

它不是普通的 INI 文件,而是采用了 MySQL 内部使用的二进制、分块和混淆处理。该格式主要用于避免密码以可直接阅读的文本保存,但拥有文件读取权限的程序仍可恢复其中的凭据。

自行实现写入器会遇到以下问题:

  • 该文件格式不是为第三方写入程序提供的稳定接口;
  • 如果字节序、填充、加密兼容方式或记录布局处理错误,MySQL 会拒绝该文件;
  • PHP OpenSSL 的默认行为未必与 MySQL 的内部实现一致;
  • MySQL 后续版本可能修改内部格式;
  • 能够读取该格式,并不代表可以安全、兼容地写入。

如果业务必须自动生成 .mylogin.cnf,需要选用与目标 MySQL 版本匹配的实现,并通过该版本的 mysql_config_editor print 和实际客户端连接测试兼容性。相比按照零散的格式说明拼装文件,复用对应版本的 MySQL 源代码,或选用明确支持目标版本的维护库,会更稳妥。

文件位置和运行账户也要一致

Windows 上的 .mylogin.cnf 通常保存在运行账户的应用数据目录中,例如:

%APPDATA%\MySQL\.mylogin.cnf

具体路径由启动 mysql_config_editor 的 Windows 身份决定。管理员、普通桌面用户、IIS 应用池账户和计划任务账户可能使用各自不同的 %APPDATA%。

创建文件的账户必须与之后运行 MySQL 客户端的账户一致。同时,应通过 NTFS ACL 限制其他账户读取该文件。将文件设为隐藏,或依赖其二进制格式,都无法保护其中的凭据。

实际建议

对于需要发布给其他用户的 Windows 程序,最简单可靠的流程是在安装阶段以目标用户身份启动 mysql_config_editor,让用户通过真实控制台输入密码。

如果安装过程必须无人值守,就需要引入平台相关组件:Windows 使用 ConPTY 辅助程序,Unix 使用 PTY。如果凭据只供 PHP 连接数据库使用,可以不创建 .mylogin.cnf,改用 Windows Credential Manager、DPAPI 或部署环境提供的秘密管理服务保存密码,并在运行时传给 PDO 或 mysqli。

备注:内容仅供参考。