
本文旨在解决在使用docusign php sdk通过jwt认证集成后,下载已完成签署的文档时可能遇到的空文档问题。该问题通常是由于sdk 6.5版本的一个已知缺陷导致。教程将提供两种解决方案:推荐升级sdk至6.5.1及更高版本,或在无法立即升级时,通过特定的代码片段手动读取文件流内容来确保正确下载已签署的pdf文档。
在使用DocuSign PHP SDK与您的应用程序(如Laravel)集成并成功完成文档签署流程后,下载已签署的完整文档(包括CoC,即签署证书)是一个常见的需求。然而,部分用户在使用SDK的getDocument方法时,可能会遇到下载到的PDF文件为空的问题。本教程将深入分析此问题的原因,并提供详细的解决方案。
当尝试通过DocuSign PHP SDK下载已签署的信封文档时,即使getDocument方法返回了一个SplFileObject实例,并指向了一个临时文件路径,最终保存到本地的PDF文件却是空的。
以下是常见的下载代码片段,它可能在特定SDK版本中导致问题:
use DocuSign\eSign\Api\EnvelopesApi;
use DocuSign\eSign\Client\ApiClient;
// 假设 $apiClient, $account_id, $envelope_id 已经正确初始化
$envelope_api = new EnvelopesApi($apiClient);
// 尝试获取合并后的文档(包含CoC)
$tmpFile = $envelope_api->getDocument($account_id, 'combined', $envelope_id);
// 尝试将临时文件内容写入到本地文件
// 这个问题通常表现为 $tmpFile->getPathname() 存在,但文件内容未被正确读取
$savCert = file_put_contents("signed_document.pdf", file_get_contents($tmpFile->getPathname()));
// 此时,signed_document.pdf 文件可能为空尽管$tmpFile变量是一个SplFileObject实例,其内部显示指向一个有效的临时文件路径(例如 C:\Users\AppData\Local\Temp\19F.tmp),但直接使用file_get_contents($tmpFile->getPathname())可能无法正确读取其内容。
立即学习“PHP免费学习笔记(深入)”;
经过分析,此问题是DocuSign PHP SDK 6.5版本中的一个已知缺陷。在该版本中,getDocument方法返回的SplFileObject对象在某些情况下,其内部文件指针可能没有被正确地定位到文件开头,或者在读取时存在其他内部处理问题,导致直接通过文件路径读取时无法获取到实际内容。
解决此问题主要有两种方法:推荐升级SDK版本,或者在无法立即升级时,采用手动处理文件流的临时方案。
DocuSign 官方已在 6.5.1版本中修复了此问题。因此,最直接且推荐的解决方案是将您的DocuSign PHP SDK更新到6.5.1或更高版本。
您可以通过Composer更新您的项目依赖:
composer update docusign/esign-client
或者,如果您在composer.json中指定了精确版本,请将其更新为^6.5.1或更高:
{
"require": {
"docusign/esign-client": "^6.5.1"
}
}更新SDK后,您原有的下载代码应该能够正常工作,无需额外修改。
如果您由于项目限制或其他原因无法立即升级SDK版本,可以在SDK 6.5版本中使用以下代码片段作为临时解决方案。此方法通过显式地重置SplFileObject的文件指针并手动读取其内容来绕过问题。
use DocuSign\eSign\Api\EnvelopesApi;
use DocuSign\eSign\Client\ApiClient;
// 假设 $apiClient, $account_id, $envelope_id 已经正确初始化
$envelope_api = new EnvelopesApi($apiClient);
// 获取合并后的文档(包含CoC)
$tmpFile = $envelope_api->getDocument($account_id, 'combined', $envelope_id);
// 关键步骤:
// 1. 将文件指针重置到文件开头
$tmpFile->rewind();
// 2. 读取文件的全部内容
$contents = $tmpFile->fread($tmpFile->fstat()['size']);
// 将读取到的内容写入到本地文件
file_put_contents("signed_document.pdf", $contents);
// 此时,signed_document.pdf 将包含正确的文档内容代码解释:
为了更好地展示,以下是一个包含两种解决方案的完整示例框架:
<?php
require_once(__DIR__ . '/vendor/autoload.php'); // 根据您的项目路径调整
use DocuSign\eSign\Api\EnvelopesApi;
use DocuSign\eSign\Client\ApiClient;
use DocuSign\eSign\Client\ApiException;
// --- DocuSign API 客户端配置 (示例,请替换为您的实际配置) ---
$config = new DocuSign\eSign\Configuration();
$config->setHost("https://demo.docusign.net/restapi"); // 使用沙盒环境或生产环境URL
$config->addDefaultHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN"); // 替换为您的JWT或OAuth Access Token
$apiClient = new ApiClient($config);
$envelope_api = new EnvelopesApi($apiClient);
// --- 替换为您的实际账户ID和信封ID ---
$account_id = "YOUR_ACCOUNT_ID";
$envelope_id = "YOUR_ENVELOPE_ID";
try {
// 获取合并后的文档(包含CoC)
$tmpFile = $envelope_api->getDocument($account_id, 'combined', $envelope_id);
// --- 根据您的SDK版本选择以下任一方法 ---
// 方法一:推荐 - 适用于SDK 6.5.1及更高版本
// if (version_compare(ApiClient::VERSION, '6.5.1', '>=')) {
// $savCert = file_put_contents("signed_document_v6_5_1_plus.pdf", file_get_contents($tmpFile->getPathname()));
// echo "文档已使用SDK 6.5.1+方法下载到 signed_document_v6_5_1_plus.pdf\n";
// } else {
// 方法二:针对SDK 6.5版本的手动处理
$tmpFile->rewind(); // 将文件指针重置到文件开头
$contents = $tmpFile->fread($tmpFile->fstat()['size']); // 读取全部内容
file_put_contents("signed_document_v6_5_workaround.pdf", $contents);
echo "文档已使用SDK 6.5 workaround方法下载到 signed_document_v6_5_workaround.pdf\n";
// }
} catch (ApiException $e) {
echo "下载文档时发生错误: " . $e->getMessage() . "\n";
// 打印详细错误信息
if ($e->getResponseBody()) {
echo "API 响应体: " . $e->getResponseBody() . "\n";
}
} catch (Exception $e) {
echo "发生未知错误: " . $e->getMessage() . "\n";
}
?>DocuSign PHP SDK 6.5版本中下载已签署文档为空的问题,是由于SDK内部处理文件流的一个bug。最推荐的解决方案是升级SDK到6.5.1或更高版本。如果无法立即升级,则可以通过手动重置SplFileObject的文件指针并读取其全部内容来作为临时 workaround。遵循本教程的指导,您可以确保您的应用程序能够正确地下载和保存DocuSign已签署的文档。
以上就是DocuSign PHP SDK: 解决下载已签署文档为空的问题的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号