如何在PHP应用中无需账号密码访问登录保护的URL以供wkhtmltopdf生成PDF

解决方案 #

你这个需求完全不用搭复杂的API或者OAuth体系，下面三个方案从易到难，优先选第一个就可以解决问题：

方案1：直接传HTML内容，绕开HTTP请求（首推） #

这个方案完全不需要走网络请求，自然不存在授权、跨域的问题，是最适合你场景的方案：

1. 先在PHP里渲染好你要转PDF的页面的完整HTML内容，用输出缓冲获取即可
2. 直接把HTML字符串传给wkhtmltopdf的phpwrapper，不用调用URL
   示例代码：

// 引入wkhtmltopdf的类
use mikehaertl\wkhtmlto\Pdf;

// 渲染你要转PDF的本地PHP页面内容
ob_start();
// 这里替换成你要转PDF的PHP文件的绝对路径
require __DIR__ . '/your-target-page.php';
$htmlContent = ob_get_clean();

// 初始化PDF实例，开启本地文件访问权限避免静态资源加载失败
$pdf = new Pdf([
    'enable-local-file-access' => true,
    'encoding' => 'UTF-8'
]);
// 直接传入HTML内容，不需要加URL
$pdf->addPage($htmlContent);

// 保存或者输出PDF
if (!$pdf->saveAs(__DIR__ . '/output.pdf')) {
    echo $pdf->getError();
}

优点：零安全配置、请求速度最快、完全避开网络权限问题；只需要注意页面里的CSS、图片等静态资源用绝对路径即可。

方案2：本地IP白名单限制，不需要传凭证 #

如果确实需要走HTTP请求的方式调用URL，直接给目标页面加IP校验即可，只有服务器本地的请求能访问，外部请求全部拦截，有两种实现方式：

方式A：改PHP代码（新手推荐，不用改Apache配置）

在你要转PDF的目标页面最开头加如下代码：

// 允许访问的IP只有本地回环地址
$allowIps = ['127.0.0.1', '::1'];
if (!in_array($_SERVER['REMOTE_ADDR'], $allowIps)) {
    http_response_code(403);
    exit('Access Denied');
}

方式B：改Apache配置/.htaccess

在站点根目录的.htaccess文件里添加如下规则，替换成你要限制的文件名或者路径：

<Files "your-target-page.php">
    Require ip 127.0.0.1
    Require ip ::1
</Files>

优点：不需要传任何凭证，配置简单；缺点是限制粒度为IP，所有本地发起的请求都能访问该页面。

方案3：自定义Token校验，灵活可控 #

如果你需要更精细的权限控制，可以用简单的字符串校验，不需要复杂的认证体系：

1. 先在你的公共配置文件里定义一个不会对外暴露的随机字符串作为Token，比如32位以上的随机字符
2. 调用wkhtmltopdf的时候，把这个Token作为查询参数拼到URL里
3. 在目标页面开头校验Token是否匹配，不匹配直接拦截
   示例代码：

// 配置文件里定义，不要泄露到前端代码
define('PDF_EXPORT_TOKEN', '你自己生成的随机字符串，比如a9sd87f6a5s4df3as2df1g0h9j8k7l6');

// --- 发起PDF生成请求的代码里 ---
$pdfUrl = 'http://localhost/your-target-page.php?pdf_token=' . PDF_EXPORT_TOKEN;
$pdf->addPage($pdfUrl);

// --- 目标页面开头加的校验代码 ---
if (!isset($_GET['pdf_token']) || $_GET['pdf_token'] !== PDF_EXPORT_TOKEN) {
    http_response_code(403);
    exit('Access Denied');
}

如果要进一步提升安全性，还可以给Token加过期时间，比如拼上当前时间戳，校验时判断是否在5分钟有效期内即可。

内容的提问来源于stack exchange，提问作者Andy Hayes