PHP DocuSign集成：解决下载已签署文档为空的问题

use DocuSign\eSign\Api\EnvelopesApi;
use DocuSign\eSign\Client\ApiClient;

// 假设 $apiClient, $account_id, $envelope_id 已经正确初始化
$envelope_api = new EnvelopesApi($apiClient);

// 获取文档，'combined' 表示获取所有文档的合并版本
$tmpFile = $envelope_api->getDocument($account_id, 'combined', $envelope_id);

// 尝试保存文件，但可能导致下载的PDF为空
$savCert = file_put_contents("signed_document.pdf", file_get_contents($tmpFile->getPathname()));

composer update docusign/esign-client

use DocuSign\eSign\Api\EnvelopesApi;
use DocuSign\eSign\Client\ApiClient;
use SplFileObject; // 确保引入 SplFileObject

// 假设 $apiClient, $account_id, $envelope_id 已经正确初始化
$envelopeApi = new EnvelopesApi($apiClient);

// 获取文档
/** @var SplFileObject $tmpFile */
$tmpFile = $envelopeApi->getDocument($account_id, 'combined', $envelope_id);

// 检查 $tmpFile 是否是 SplFileObject 实例
if ($tmpFile instanceof SplFileObject) {
    // 关键步骤：重置文件指针到文件开头
    $tmpFile->rewind();

    // 读取文件的全部内容
    // fstat()['size'] 获取文件大小，确保读取所有内容
    $contents = $tmpFile->fread($tmpFile->fstat()['size']);

    // 将内容保存到本地文件
    $savCert = file_put_contents("signed_document.pdf", $contents);

    if ($savCert !== false) {
        echo "文档已成功保存为 signed_document.pdf\n";
    } else {
        echo "文档保存失败。\n";
    }
} else {
    echo "获取文档失败，返回的不是 SplFileObject 实例。\n";
}

<?php

require_once(__DIR__ . '/vendor/autoload.php'); // 假设您的 Composer autoload 文件在此处

use DocuSign\eSign\Api\EnvelopesApi;
use DocuSign\eSign\Client\ApiClient;
use DocuSign\eSign\Client\Auth\OAuth;
use DocuSign\eSign\Configuration;
use DocuSign\eSign\Model\EnvelopeDefinition;
use DocuSign\eSign\Model\Signer;
use DocuSign\eSign\Model\RecipientViewRequest;
use SplFileObject;

// --- 配置 DocuSign 客户端 ---
// 请替换为您的实际凭据
$integratorKey = 'YOUR_INTEGRATOR_KEY';
$userId = 'YOUR_USER_ID'; // 通常是DocuSign账户管理员的GUID
$rsaPrivateKey = file_get_contents('YOUR_PRIVATE_KEY.pem'); // 私钥文件路径
$apiHost = 'https://demo.docusign.net/restapi'; // 沙箱环境，生产环境请使用 'https://www.docusign.net/restapi'

$config = new Configuration();
$config->setHost($apiHost);

$apiClient = new ApiClient($config);

try {
    // JWT 认证
    $oauth = new OAuth();
    $oauth->setAccessToken($apiClient->generateJWTUserToken($integratorKey, $userId, $rsaPrivateKey, $apiHost, 3600));
    $config->setAccessToken($oauth->getAccessToken());

    // 获取账户信息以获取 account_id
    $account = $apiClient->getUserInfo($oauth->getAccessToken())->getAccounts()[0];
    $account_id = $account->getAccountId();

    echo "DocuSign 认证成功，Account ID: " . $account_id . "\n";

    // --- 假设您已经有一个信封ID ---
    // 替换为您的实际已完成签署的信封ID
    $envelope_id = 'YOUR_COMPLETED_ENVELOPE_ID'; 

    // 初始化 EnvelopesApi
    $envelopeApi = new EnvelopesApi($apiClient);

    echo "正在尝试下载信封 ID: " . $envelope_id . " 的已签署文档...\n";

    /** @var SplFileObject $tmpFile */
    $tmpFile = $envelopeApi->getDocument($account_id, 'combined', $envelope_id);

    if ($tmpFile instanceof SplFileObject) {
        // 方案二：SDK 6.5 兼容性代码
        // 如果您已升级SDK到 6.5.1+，可以删除以下三行
        $tmpFile->rewind();
        $contents = $tmpFile->fread($tmpFile->fstat()['size']);
        $filePath = "signed_document_" . $envelope_id . ".pdf";
        $savCert = file_put_contents($filePath, $contents);

        // 如果已升级SDK到 6.5.1+，则直接使用以下代码
        // $filePath = "signed_document_" . $envelope_id . ".pdf";
        // $savCert = file_put_contents($filePath, file_get_contents($tmpFile->getPathname()));


        if ($savCert !== false) {
            echo "文档已成功保存为 " . $filePath . "，大小：" . round($savCert / 1024, 2) . " KB\n";
        } else {
            echo "文档保存失败。\n";
        }
    } else {
        echo "获取文档失败，返回的不是 SplFileObject 实例。\n";
    }

} catch (\DocuSign\eSign\Client\ApiException $e) {
    echo "DocuSign API 错误: " . $e->getMessage() . "\n";
    // 打印更详细的错误信息
    if ($e->getResponseBody()) {
        echo "Response Body: " . $e->getResponseBody() . "\n";
    }
} catch (Exception $e) {
    echo "一般错误: " . $e->getMessage() . "\n";
}
?>