在使用PHP DocuSign SDK下载已完成签名的文档时，用户可能会遇到下载文件内容为空的问题。这通常是由于SDK 6.5版本中的一个已知bug导致。本文将详细介绍两种解决方案：升级DocuSign PHP SDK到6.5.1或更高版本，或者在不升级的情况下，通过手动调整文件流读取方式来正确获取文档内容。
在使用DocuSign PHP SDK与Laravel等PHP应用集成时，下载已完成签名的文档是常见的需求。然而，部分用户在尝试下载由EnvelopesApi->getDocument()方法返回的文档时，可能会发现下载的文件内容为空。本文将深入分析这一问题的原因，并提供两种有效的解决方案。
问题分析
当使用DocuSign PHP SDK的EnvelopesApi类通过getDocument()方法获取已签名的文档时，该方法会返回一个SplFileObject实例，指向一个存储在服务器临时目录中的文件。原始的代码片段可能如下所示：
use DocuSigneSignApiEnvelopesApi;use DocuSigneSignClientApiClient;// ... 初始化 $apiClient, $account_id, $envelope_id ...$envelope_api = new EnvelopesApi($apiClient);try { $tmpFile = $envelope_api->getDocument($account_id, 'combined', $envelope_id); // 此时 $tmpFile 是一个 SplFileObject，指向临时文件，例如 C:UsersAppDataLocalTemp19F.tmp // 尝试直接读取临时文件路径的内容 $savCert = file_put_contents("signed_document.pdf", file_get_contents($tmpFile->getPathname())); if ($savCert !== false) { echo "文档下载成功并保存为 signed_document.pdf"; } else { echo "文档保存失败。"; }} catch (DocuSigneSignApiException $e) { echo "DocuSign API 错误: " . $e->getMessage();} catch (Exception $e) { echo "发生错误: " . $e->getMessage();}
SplFileObject是一个流式对象，它在内部维护一个文件指针。当getDocument()方法返回$tmpFile时，其内部文件指针可能已经不在文件开头。直接使用file_get_contents($tmpFile->getPathname())会尝试重新打开该临时文件并读取其内容。然而，在DocuSign PHP SDK的6.5版本中，存在一个已知的bug。这个bug可能导致在SplFileObject被返回后，即使文件系统层面文件已存在，其内容也无法通过外部路径名读取工具（如file_get_contents）正确获取，或者文件指针的初始位置不正确，从而导致读取到的内容为空或不完整。正确的做法是利用SplFileObject自身的流操作方法来确保从文件开头完整读取内容。
立即学习“PHP免费学习笔记（深入）”；
解决方案
针对此问题，主要有两种解决方案：升级SDK版本或手动调整文件流读取方式。
方案一：升级DocuSign PHP SDK版本
DocuSign官方已在SDK 6.5.1版本中修复了此bug。因此，最推荐和最直接的解决方案是将您的DocuSign PHP SDK升级到6.5.1或更高版本。
您可以通过Composer更新您的项目依赖：
composer update docusign/esign-client
或者，如果您在 composer.json 中指定了版本，请确保其允许更新到6.5.1或更高版本，例如：
"require": { "docusign/esign-client": "^6.5.1" // 确保版本范围包含 6.5.1 或更高}
更新后，您的原有代码通常无需修改即可正常工作。
方案二：手动读取文件流（适用于无法升级SDK的情况）
如果您由于项目限制或其他原因暂时无法升级SDK版本，您可以通过手动操作SplFileObject来正确读取文件内容。关键在于确保文件指针回到文件开头，并使用SplFileObject自身的读取方法。
use DocuSigneSignApiEnvelopesApi;use DocuSigneSignClientApiClient;use SplFileObject; // 确保引入 SplFileObject// ... 初始化 $apiClient, $account_id, $envelope_id ...$envelope_api = new EnvelopesApi($apiClient);try { /** @var SplFileObject $tmpFile */ $tmpFile = $envelope_api->getDocument($account_id, 'combined',
以上就是解决PHP DocuSign SDK下载已签名文档为空的问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1334323.html
微信扫一扫 
支付宝扫一扫 
