Como resolver o erro “TCPDF ERROR: Incorrect output destination”

TCPDF ERROR: Incorrect output destination

Neste tutorial, vamos entender por que esse erro acontece, o que ele significa
e como corrigir corretamente, com exemplos simples e práticos.

O que significa esse erro?

O TCPDF gera o PDF em memória e, ao final do processo, você precisa informar
para onde esse arquivo será enviado. Isso é feito pelo método Output():

$pdf->Output($nomeDoArquivo, $destino);

O erro Incorrect output destination ocorre quando o valor
informado no segundo parâmetro ($destino) é inválido ou está sendo
usado de forma incorreta.

Destinos válidos do método Output()

O TCPDF aceita apenas alguns destinos específicos:

• I – Exibe o PDF diretamente no navegador
• D – Força o download do arquivo
• F – Salva o PDF em um arquivo no servidor
• S – Retorna o PDF como uma string

Qualquer valor diferente desses causará o erro.

Exemplo correto: exibir o PDF no navegador

$pdf = new TCPDF();
$pdf->AddPage();
$pdf->SetFont('helvetica', '', 12);
$pdf->Write(0, 'Olá, este é um PDF gerado com TCPDF.');

$pdf->Output('exemplo.pdf', 'I');

Nesse caso, o destino I está correto e o PDF será exibido
diretamente no navegador.

Erro comum: usar um destino inválido

Exemplo incorreto:

$pdf->Output('exemplo.pdf', 'DOWNLOAD');

O valor DOWNLOAD não é reconhecido pelo TCPDF.

Forma correta:

$pdf->Output('exemplo.pdf', 'D');

Erro comum: salvar arquivo sem caminho válido

Ao utilizar o destino F, é obrigatório informar o caminho completo
onde o arquivo será salvo.

Exemplo incorreto:

$pdf->Output('relatorio.pdf', 'F');

Exemplo correto:

$caminho = __DIR__ . '/pdfs/relatorio.pdf';
$pdf->Output($caminho, 'F');

Certifique-se de que a pasta exista e que o PHP tenha permissão de escrita.

Erro comum: saída enviada antes do PDF

Qualquer saída enviada ao navegador antes da geração do PDF pode causar erros,
como echo, var_dump ou até espaços em branco fora do PHP.

Exemplo problemático:

echo "Teste";
$pdf->Output('arquivo.pdf', 'I');

Para evitar isso, limpe o buffer de saída antes de gerar o PDF:

if (ob_get_length()) {
    ob_end_clean();
}

$pdf->Output('arquivo.pdf', 'I');

Exemplo: salvar o PDF e depois forçar o download

$arquivo = __DIR__ . '/pdfs/nota_fiscal.pdf';

// Salva o PDF no servidor
$pdf->Output($arquivo, 'F');

// Força o download
header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="nota_fiscal.pdf"');
readfile($arquivo);
exit;

O erro TCPDF ERROR: Incorrect output destination está quase sempre
relacionado ao uso incorreto do método Output(). Com atenção aos
destinos válidos e ao controle da saída do PHP, o problema é resolvido de forma
simples e definitiva.