* Conoscenza del computer >> sistemi >  >> Windows 2016

Come visualizzare un documento Word nel browser con PHP (COM)

Visualizzare un documento Word (.doc/.docx) direttamente nel browser via PHP è possibile su Windows Server con Microsoft Word installato, usando l'estensione COM di PHP. Non funziona su Linux/hosting condiviso standard. È una tecnica legacy (anni 2000), oggi sostituita da librerie pure PHP (PhpOffice\PhpWord) o conversione server-side (LibreOffice headless).

⚠ LIMITAZIONI CRITICHE:
• Richiede Windows Server + MS Word licenza installato
• COM è lento, instabile, non scalabile (un'istanza Word per richiesta)
• Problemi permessi DCOM, "Interactive User", sicurezza
• Non usare in produzione per siti pubblici
• Alternative moderne: PhpWord (lettura/scrittura .docx), LibreOffice headless (conversione PDF), OnlyOffice/Nextcloud (visualizzazione web)

Prerequisiti

  • Windows Server 2016/2019/2022
  • Microsoft Word (Office 2016/2019/2021/365) installato e attivato
  • PHP 7.x/8.x con estensione php_com_dotnet.dll abilitata in `php.ini`:
    `extension=com_dotnet`
  • Configurazione DCOM per Word:
    `dcomcnfg` → Servizi componenti → Computer → Risorse → Il mio computer → Configurazione DCOM → Microsoft Word Document → Proprietà → Identità → Utente interattivo (o utente specifico con permessi)

Codice PHP base (solo dimostrativo)

<?php
// Configurazione
$wordPath = 'C:\inetpub\wwwroot\docs\documento.docx'; // Percorso assoluto fisico

try {
    // Istanzia COM Word
    $word = new COM('Word.Application') or die('Impossibile istanziare Word.Application');
    $word->Visible = false; // Non mostrare UI
    $word->DisplayAlerts = false; // Sopprimi alert

    // Apri documento
    $doc = $word->Documents->Open($wordPath, false, true); // ReadOnly=true

    // Opzione A: Stampa su PDF temporaneo (migliore per visualizzazione)
    $pdfPath = sys_get_temp_dir() . '\doc_' . uniqid() . '.pdf';
    $doc->ExportAsFixedFormat($pdfPath, 17); // 17 = wdExportFormatPDF
    $doc->Close(false);
    $word->Quit();
    $word = null;

    // Invia PDF al browser
    if (file_exists($pdfPath)) {
        header('Content-Type: application/pdf');
        header('Content-Disposition: inline; filename="documento.pdf"');
        header('Content-Length: ' . filesize($pdfPath));
        readfile($pdfPath);
        unlink($pdfPath); // Pulisci temp
        exit;
    }
} catch (com_exception $e) {
    if (isset($doc)) $doc->Close(false);
    if (isset($word)) { $word->Quit(); $word = null; }
    die('Errore COM: ' . $e->getMessage());
}
?>

Spiegazione passaggi

  1. new COM('Word.Application'): Avvia processo `WINWORD.EXE` (visibile in Task Manager)
  2. Documents->Open(): Apre il file. Parametri: percorso, conferma conversioni (false), sola lettura (true)
  3. ExportAsFixedFormat(..., 17): Esporta in PDF (formato 17 = PDF). Meglio di PrintOut: genera file, non stampa su stampante fisica
  4. Close/Quit: Fondamentale rilasciare risorse. Senza, restano processi Word orfani → esaurimento memoria/licenze
  5. readfile(): Invia il PDF generato al browser come `inline` (visualizza) non `attachment` (scarica)

Gestione errori e robustezza

  • Avvolgi in `try/catch (com_exception $e)`
  • Sempre `finally` o blocco `catch` che chiude `$doc` e `$word`
  • Timeout: `set_time_limit(120)` (Word può essere lento su file grandi)
  • Lock file: usa `flock()` o coda job (database + worker) per evitare concorrenza su stesso file
  • Pulizia processi orfani: script cron `taskkill /im WINWORD.EXE /f` periodico

Alternative MODERNE (consigliate)

1. PhpOffice\PhpWord (Pure PHP, nessun Word richiesto)

composer require phpoffice/phpword

// Leggi .docx
$phpWord = \PhpOffice\PhpWord\IOFactory::load('documento.docx');
// Render HTML (semplice)
$htmlWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'HTML');
$htmlWriter->save('php://output');

Legge .docx, .odt, .rtf, .html. Scrive .docx, .pdf (via dompdf/tcpdf), .html. Gira ovunque (Linux, hosting condiviso).

2. LibreOffice Headless (Conversione server-side potente)

# Server Linux: apt install libreoffice
# PHP:
$cmd = 'libreoffice --headless --convert-to pdf --outdir /tmp ' . escapeshellarg($docxPath);
exec($cmd, $output, $returnVar);
// Poi invia /tmp/documento.pdf al browser

Supporta .doc, .docx, .odt, .rtf, .xls, .ppt → PDF perfetto. Usato in produzione da Nextcloud, OnlyOffice, Alfresco.

3. OnlyOffice Document Server / NextCloud Office (Visualizzazione web completa)

Server separato (Docker) che rende documenti Office nel browser (editor/viewer tipo Google Docs). API WOPI/JSON. Soluzione enterprise.

4. API Cloud (Microsoft Graph, Google Docs API, Adobe PDF Services)

Upload → conversione → visualizzazione. Costi per volume, zero manutenzione server.

Conclusione

Il metodo COM + Word è legacy, fragile, solo Windows Server dedicato. Per nuovi progetti: PhpWord (lettura/scrittura), LibreOffice headless (conversione PDF affidabile), OnlyOffice (visualizzazione/edit web). Usa COM solo per migrazione vecchi sistemi intranet non riscrivibili.

Windows 2016