PhpMyAdmin启用双因子认证（2FA），及异常问题排查

首先示例下启用2FA的过程，文末会附上一些遇到的问题，及原因和解决方案。

1. 启用双因素身份认证

2. 使用2FA工具扫码或手动录入密钥，然后在下面的输入框中输入工具上生成的动态code,并点击启用双因素身份认证。

2FA工具可以使用华为云等app.
这里只是示例图片，不用为我的key泄露担心。

3. 然后退出账号，重新登录，可以看到会要求输入动态认证代码。

以上是正常情形下的流程，但是配置过程中难免会遇到其它一些问题。

1. 配置后未生效。 pma再配置未成功写入时，可能不展示错误。
   解决方案：检查是否启用了phpMyAdmin configuration storage，通常是将安装目录下的sql/create_table执行，创建pma需要的存储表。 检查用户是否有写上面表的权限；

2. 查看服务器日志，如nginx, 发现下面错误：

FastCGI sent in stderr: "PHP message: PHP Fatal error: Uncaught Error: Call to undefined method BaconQrCode\Renderer\Image\SvgImageBackEnd::getQRCodeInline() in xxxxxxx/vendor/pragmarx/google2fa-qrcode/src/Google2FA.php:64

• 1

解决方案：这个通常是pma与依赖不兼容，造成的。删除vendor， composer.lock,然后重新compoer install;

3. pma会使用多种可选方案来生成二维码图片，如下面是其源码

public function getImageBackend() { if (empty($this->imageBackEnd)) { $this->imageBackEnd = !$this->imagickIsAvailable() ? new SvgImageBackEnd() : new ImagickImageBackEnd(); } $this->setImageBackEnd($this->imageBackEnd); return $this->imageBackEnd; }

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

可以看到再未安装php-imagick扩展时，是使用的矢量图， 如果安装了php-imagick扩展则会使用 ImagickImageBackEnd生成图片（这种情形下有时候，图片大小不受控制。）

4. 如果遇到其它错误，看一查看日志，或者跟踪源码执行来定位问题。