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).
• 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
- new COM('Word.Application'): Avvia processo `WINWORD.EXE` (visibile in Task Manager)
- Documents->Open(): Apre il file. Parametri: percorso, conferma conversioni (false), sola lettura (true)
- ExportAsFixedFormat(..., 17): Esporta in PDF (formato 17 = PDF). Meglio di PrintOut: genera file, non stampa su stampante fisica
- Close/Quit: Fondamentale rilasciare risorse. Senza, restano processi Word orfani → esaurimento memoria/licenze
- 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.
- Come disinstallare un aggiornamento rapido (hotfix) di Windows
- Come impostare uno screensaver su Windows 10/11
Windows 2016
- Come riparare WMI su Windows XP
- Leggere i log di Windows Firewall
- Come usare il vocoder in Audacity (effetto voce robotica)
- Come stampare un modello (template) in Word, Publisher o Paint
- Come scaricare MapleStory su Mac (per trasferirlo su Windows)
- Come reinstallare il font Century Gothic su Windows
- Come cambiare le immagini dello screensaver su Windows
- Riavviare un computer Dell: metodi standard e forzati