使用bacon/bacon-qr-code生成二维码失败问题求助

我之前也踩过BaconQrCode生成二维码的坑，咱们一步步来排查你遇到的问题：

一、无图片场景下无法生成文件的排查点 #

• 检查目录写入权限：你要生成的qrcode.png所在的目录，有没有给PHP进程写入权限？比如在Linux服务器上，web服务进程（通常是www-data）有没有权限创建文件？可以先手动在目标目录创建个空文件试试，或者用PHP代码var_dump(is_writable(dirname('qrcode.png')));来验证权限是否正常。
• 确认依赖扩展是否安装：BaconQrCode的PNG渲染需要GD或者Imagick扩展支持，你可以通过phpinfo()查看GD扩展是否已经启用，如果没装的话得先安装对应扩展。
• 检查命名空间是否正确引入：如果你的代码里没有提前用use语句引入类，直接用全命名空间的话要确保拼写没错，或者在文件开头加上：

  use BaconQrCode\Renderer\Image\Png;
  use BaconQrCode\Writer;
  

  避免因为类找不到导致静默失败。

二、直接echo无法显示图片的解决方法 #

直接输出图片内容时，浏览器需要知道这是图片类型的响应，所以必须先设置正确的HTTP头，还要确保输出前没有任何多余内容：

<?php
// 必须先设置响应头，而且要在任何输出之前
header('Content-Type: image/png');

$renderer = new \BaconQrCode\Renderer\Image\Png();
$renderer->setHeight(256);
$renderer->setWidth(256);
$writer = new \BaconQrCode\Writer($renderer);
// 直接输出二维码内容
$writer->writeString('Hello World!');
?>

注意：如果你的PHP文件开头有空白字符、或者之前有echo的调试内容，都会导致响应头无法正确发送，图片就会显示破碎，所以要确保输出前没有任何多余输出。

完整可运行示例 #

<?php
use BaconQrCode\Renderer\Image\Png;
use BaconQrCode\Writer;

// 生成到文件的示例
$outputPath = 'qrcode.png';
$renderer = new Png();
$renderer->setHeight(256);
$renderer->setWidth(256);
$writer = new Writer($renderer);

if (is_writable(dirname($outputPath))) {
    $writer->writeFile('Hello World!', $outputPath);
    echo "二维码已成功生成到 {$outputPath}";
} else {
    echo "错误：目标目录没有写入权限，请检查权限设置";
}
?>

内容的提问来源于stack exchange，提问作者Jean Ouédraogo