使用PHP将HTML生成PDF或图片：采用 laravel-snappy

barryvdh/laravel-snappy 笔记：

再次强调，laravel-snappy 是对 knplabs/knp-snappy 的 laravel 集成，而底层使用的是 wkhtmltopdf/wkhtmltoimage 包

1.安装 wkhtmltopdf
	1>从 wkhtmltopdf 官方安装：
		https://wkhtmltopdf.org/downloads.html

	2>作为 composer 的依赖来安装：
		https://github.com/KnpLabs/snappy#wkhtmltopdf-binary-as-composer-dependencies

		32位系统：
			composer require h4cc/wkhtmltopdf-i386 0.12.x
			composer require h4cc/wkhtmltoimage-i386 0.12.x

		64位系统：
			composer require h4cc/wkhtmltopdf-amd64 0.12.x
			composer require h4cc/wkhtmltoimage-amd64 0.12.x				

	注意：
		我们系统，可能缺少一些依赖包，例如：libXrender，我们需要自己手动安装

2.测试 wkhtmltopdf 安装是否成功
	直接在命令行运行 wkhtmltopdf 命令

	使用第二种方式来安装(作为 composer 依赖安装)，安装后的目录位于：
		/vendor/h4cc/wkhtmltoimage-amd64/bin
		/vendor/h4cc/wkhtmltopdf-amd64/bin

	注意：
		vagrant 用户需要进行如下操作，来避免出现的 126 报错：
			1>将下载的二进制软件，移动到不在同步文件夹中的路径，例如：
				cp vendor/h4cc/wkhtmltoimage-amd64/bin/wkhtmltoimage-amd64 /usr/local/bin/
				cp vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64 /usr/local/bin/

			2>添加可执行权限：
				chmod +x /usr/local/bin/wkhtmltoimage-amd64 
				chmod +x /usr/local/bin/wkhtmltopdf-amd64

3.barryvdh/laravel-snappy 安装 & 使用
	1>composer 安装：
		composer require barryvdh/laravel-snappy

	laravel 5.5 已经使用了包自动发现，我们不需要手动添加 'ServiceProvider/Facade'。如果使用了 'laravel-dompdf'，可能会产生冲突。这种情况下，需要手动来注册 Facade，来解决这个问题(没打算使用，有使用的，万一冲突了，记得这个提示！)

	2>config/app.php
		providers:
			Barryvdh\Snappy\ServiceProvider::class,

		aliases：
			'PDF' => Barryvdh\Snappy\Facades\SnappyPdf::class,
			'SnappyImage' => Barryvdh\Snappy\Facades\SnappyImage::class,

	3>发布配置文件：
		php artisan vendor:publish --provider="Barryvdh\Snappy\ServiceProvider"

		配置文件中，我们主要是需要修改，wkhtmltopdf 和 wkhtmltoimage 的路径

	4>使用：
		1.使用 App 容器：
			$snappy = App::make('snappy.pdf');
			$html = '<h1>dongxuemin</h1>';

			// 从 HTML 字符串生成 PDF
			$snappy->generateFromHtml($html, '/tmp/test.pdf');

			// 从 URL 链接生成 PDF
			$snappy->generate('http://www.github.com', '/tmp/test.php');

			// 获取转换后的 PDF 字符串
			$pdf_response = $snappy->getOutputFromHtml($html);
			// 直接输出到浏览器下载
			return response($pdf_response, 200, [
		        'Content-Type'          => 'application/pdf',
		        'Content-Disposition'   => 'attachment; filename="file.pdf"'
			]);

		2.使用封装(wrapper)：
			$pdf = App::make('snappy.pdf.wrapper');
			$html = '<h1>dongxuemin</h1>';

			// 加载 HTML
			$pdf->loadHTML($html);
			return $pdf->inline();

		3.使用 Facade：

			// 从 blade 模板加载
			$pdf = PDF::loadView('invoice.blade.php', $view_data)
			return $pdf->download('invoice.pdf');

			// 链式调用：
			return PDF::loadFile('http://www.github.com')->inline('github.pdf');

			// 改变方向和纸张大小
			PDF::loadHTML($html)
				->setPaper('a4')					// 纸张大小
				->setOrientation('landscape')		// 方向
				->setOption('margin-bottom', 0)		// 其他设置
				->save('myfile.pdf');				// 存储
				// ->output();						// 得到输出字符串

		4.更多信息和参数设置，参考 wkhtmltopdf 文档：
			http://wkhtmltopdf.org/usage/wkhtmltopdf.txt

4.总结完后，实战操作了下：
	mac 系统使用 '第二种' 安装方法，报错：
		/xxx/wkhtmltopdf-amd64 cannot execute binary file
	搜索了半天，没找到有用的解决方法，只有采用 '第一种' 安装方法，官网下载软件包