Laravel 9集成barryvdh/laravel-dompdf实例化报错求助

问题背景 #

在Laravel 9中使用barryvdh/laravel-dompdf（版本^2.0）从表单数据生成PDF，操作步骤如下：

• 执行composer require barryvdh/laravel-dompdf安装包
• 在config/app.php中注册服务提供者与别名：

'aliases' => Facade::defaultAliases()->merge([
        'PDF' => Barryvdh\DomPDF\PDF::class,
 ])->toArray(),

'providers' => [
        Barryvdh\DomPDF\ServiceProvider::class,
 ],

• 控制器代码：

use Barryvdh\DomPDF\PDF;
use Dompdf\Dompdf;

class ResumeController extends Controller
{
    public function generate(Request $request)
    {
        // 生成简历HTML
        $html = '<h1>' . $request->input('name') . '</h1>';
        $html .= '<p>Email: ' . $request->input('email') . '</p>';
        $html .= '<p>Phone: ' . $request->input('phone') . '</p>';
        $html .= '<p>Address: ' . $request->input('address') . '</p>';

        $pdf = new PDF();
        $pdf->loadHTML($html);
        return $pdf->download('resume.pdf');
    }
}

首次运行报错：

Too few arguments to function Barryvdh\DomPDF\PDF::__construct(), 0 passed in C:\xampp\htdocs\resume-maker\app\Http\Controllers\ResumeController.php on line 21 and exactly 4 expected

修改代码后又报错：

Barryvdh\DomPDF\PDF::__construct(): Argument #1 ($dompdf) must be of type Dompdf\Dompdf, array given, called in C:\xampp\htdocs\resume-maker\app\Http\Controllers\ResumeController.php on line 30

问题原因 #

Barryvdh\DomPDF\PDF是Laravel框架封装后的类，其构造函数需要依赖Dompdf\Dompdf实例、配置数组、文件系统实例以及字符串类型的默认纸张方向这4个参数，这些参数均由Laravel服务容器自动注入，不能直接通过new PDF()的方式手动实例化。直接实例化会导致缺少必要依赖参数或参数类型不匹配，进而触发报错。

正确解决方法 #

以下三种方式均可正确生成PDF：

方法1：使用PDF Facade #

利用已注册的PDF别名，直接调用Facade静态方法：

use Illuminate\Http\Request;
use PDF; // 使用Facade别名

class ResumeController extends Controller
{
    public function generate(Request $request)
    {
        $html = '<h1>' . $request->input('name') . '</h1>';
        $html .= '<p>Email: ' . $request->input('email') . '</p>';
        $html .= '<p>Phone: ' . $request->input('phone') . '</p>';
        $html .= '<p>Address: ' . $request->input('address') . '</p>';

        return PDF::loadHTML($html)->download('resume.pdf');
    }
}

方法2：依赖注入 #

通过控制器方法参数注入Barryvdh\DomPDF\PDF实例：

use Illuminate\Http\Request;
use Barryvdh\DomPDF\PDF;

class ResumeController extends Controller
{
    public function generate(Request $request, PDF $pdf)
    {
        $html = '<h1>' . $request->input('name') . '</h1>';
        $html .= '<p>Email: ' . $request->input('email') . '</p>';
        $html .= '<p>Phone: ' . $request->input('phone') . '</p>';
        $html .= '<p>Address: ' . $request->input('address') . '</p>';

        $pdf->loadHTML($html);
        return $pdf->download('resume.pdf');
    }
}

方法3：使用辅助函数 #

调用Laravel提供的pdf()辅助函数：

use Illuminate\Http\Request;

class ResumeController extends Controller
{
    public function generate(Request $request)
    {
        $html = '<h1>' . $request->input('name') . '</h1>';
        $html .= '<p>Email: ' . $request->input('email') . '</p>';
        $html .= '<p>Phone: ' . $request->input('phone') . '</p>';
        $html .= '<p>Address: ' . $request->input('address') . '</p>';

        return pdf()->loadHTML($html)->download('resume.pdf');
    }
}

额外提示 #

如需自定义配置（如纸张大小、方向），可在调用loadHTML()后追加配置方法：

return PDF::loadHTML($html)
           ->setPaper('a4', 'landscape') // 设置A4横向纸张
           ->download('resume.pdf');

内容的提问来源于stack exchange，提问作者Pouya Vaghefi