{"id":637,"date":"2025-12-08T19:55:48","date_gmt":"2025-12-08T11:55:48","guid":{"rendered":"https:\/\/www.52runoob.com\/?p=637"},"modified":"2025-12-08T19:55:48","modified_gmt":"2025-12-08T11:55:48","slug":"%e5%9f%ba%e4%ba%8ephp%e6%90%ad%e5%bb%ba%e4%b8%80%e4%b8%aaword%e6%96%87%e6%a1%a3%e5%a4%84%e7%90%86%e6%a1%86%e6%9e%b6","status":"publish","type":"post","link":"https:\/\/www.52runoob.com\/index.php\/2025\/12\/08\/%e5%9f%ba%e4%ba%8ephp%e6%90%ad%e5%bb%ba%e4%b8%80%e4%b8%aaword%e6%96%87%e6%a1%a3%e5%a4%84%e7%90%86%e6%a1%86%e6%9e%b6\/","title":{"rendered":"\u57fa\u4e8ePHP\u642d\u5efa\u4e00\u4e2aWord\u6587\u6863\u5904\u7406\u6846\u67b6"},"content":{"rendered":"\n

\u597d\u2014\u2014\u4e0b\u9762\u7ed9\u4f60\u4e00\u4efd\u53ef\u76f4\u63a5\u843d\u5730<\/strong>\u7684\u65b9\u6848\uff1a\u7528 PHP \u642d\u5efa\u4e00\u4e2a\u53ef\u6269\u5c55\u3001\u53ef\u6d4b\u8bd5\u3001\u53ef\u90e8\u7f72\u7684 Word \u6587\u6863\u5904\u7406\u6846\u67b6<\/strong>\uff08\u652f\u6301\u751f\u6210\u3001\u6a21\u677f\u586b\u5145\u3001\u89e3\u6790\u3001\u5408\u5e76\u3001\u8f6c\u6362\u4e3a PDF\/\u56fe\u7247\u3001\u6743\u9650\u4e0e\u9632\u5b8f\u5904\u7406\u3001\u5f02\u6b65\u4efb\u52a1\u4e0e\u6269\u5c55\u63a5\u53e3\uff09\u3002\u6211\u628a\u8bbe\u8ba1\u3001\u5173\u952e\u7ec4\u4ef6\u3001\u4ee3\u7801\u793a\u4f8b\uff08\u53ef\u590d\u5236\uff09\u3001\u90e8\u7f72\u4e0e\u5b89\u5168\u6ce8\u610f\u70b9\u90fd\u5199\u6e05\u695a\uff0c\u6309\u4f60\u80fd\u76f4\u63a5\u5b9e\u73b0\u7684\u987a\u5e8f\u6765\u3002<\/p>\n\n\n\n

\u5982\u679c\u4f60\u60f3\u8ba9\u6211\u628a\u8fd9\u4e9b\u6587\u4ef6\u751f\u6210\u4e3a\u9879\u76ee\u9aa8\u67b6<\/strong>\uff08composer.json\u3001\u793a\u4f8b\u7c7b\u3001API \u8def\u7531\u7b49\uff09\uff0c\u544a\u8bc9\u6211\u4f60\u60f3\u7528\u7684\u6846\u67b6\uff08\u539f\u751f PHP \/ Laravel \/ Slim \/ Lumen\uff09\uff0c\u6211\u53ef\u4ee5\u76f4\u63a5\u8f93\u51fa\u6587\u4ef6\u5185\u5bb9\u3002<\/p>\n\n\n\n

\u76ee\u6807\u529f\u80fd\uff08\u6700\u5c0f\u53ef\u7528\u7248\u672c MVP\uff09<\/h1>\n\n\n\n
    \n
  1. \u4e0a\u4f20 Word\uff08.docx\u3001.doc\u3001.docm\uff09\u5e76\u5b58\u50a8<\/li>\n\n\n\n
  2. \u4ece\u6a21\u677f\u751f\u6210 Word\uff08\u5360\u4f4d\u7b26\u66ff\u6362\uff09<\/li>\n\n\n\n
  3. \u8bfb\u53d6\/\u63d0\u53d6 Word \u6587\u672c\u4e0e\u5143\u6570\u636e<\/li>\n\n\n\n
  4. \u5408\u5e76\u591a\u4e2a Word \u6587\u6863<\/li>\n\n\n\n
  5. \u8f6c\u6362 Word \u2192 PDF\uff08\u6216\u56fe\u7247\uff09<\/li>\n\n\n\n
  6. \u9632\u5b8f\u68c0\u6d4b\u4e0e\u62d2\u7edd\u542b\u5b8f\u7684\u6587\u4ef6\uff08.docm\uff09<\/li>\n\n\n\n
  7. \u652f\u6301\u5f02\u6b65\u4efb\u52a1\uff08\u5927\u6587\u4ef6\/\u8f6c\u6362\u5728\u540e\u53f0\u5904\u7406\uff09<\/li>\n\n\n\n
  8. REST API\uff1a\u4e0a\u4f20\u3001\u521b\u5efa\u3001\u8f6c\u6362\u3001\u4e0b\u8f7d\u3001\u72b6\u6001\u67e5\u8be2<\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n

    \u6280\u672f\u6808\u4e0e\u7b2c\u4e09\u65b9\u5de5\u5177\uff08\u63a8\u8350\uff09<\/h1>\n\n\n\n
      \n
    • PHP \u7248\u672c\uff1a8.1+<\/strong><\/li>\n\n\n\n
    • \u5fc5\u5907\u5e93\uff1a\n
        \n
      • phpoffice\/phpword<\/strong>\u00a0\u2014 \u751f\u6210\u3001\u6a21\u677f\u586b\u5145\u3001\u5408\u5e76\u3001\u8bfb\u5199 .docx\u3002 (composer require phpoffice\/phpword<\/code>)<\/li>\n\n\n\n
      • symfony\/http-foundation<\/strong>\uff08\u6216\u4f7f\u7528\u6846\u67b6\u81ea\u5e26\uff09\u5904\u7406\u6587\u4ef6\u4e0a\u4f20\u3002<\/li>\n\n\n\n
      • league\/flysystem<\/strong>\u00a0\u2014 \u6587\u4ef6\u62bd\u8c61\u5c42\uff08\u672c\u5730 \/ S3\uff09\u3002<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • \u8f6c\u6362\u5de5\u5177\uff08\u5fc5\u987b\u5728\u670d\u52a1\u5668\u5b89\u88c5\uff09\uff1a\n
          \n
        • LibreOffice \/ soffice (headless)<\/strong>\u00a0\u2014 \u63a8\u8350\u7528\u4e8e doc\/docx \u2192 PDF\/PNG \u8f6c\u6362\u3002<\/li>\n\n\n\n
        • \uff08\u53ef\u9009\uff09unoconv<\/strong>\u3001pandoc<\/strong>\uff08\u5f53\u9700\u8981\u66f4\u591a\u683c\u5f0f\u652f\u6301\u65f6\uff09\u3002<\/li>\n<\/ul>\n<\/li>\n\n\n\n
        • \u961f\u5217 \/ \u5f02\u6b65\uff1a\n
            \n
          • RabbitMQ \/ Redis\u961f\u5217 + worker (supervisord)<\/strong>\u00a0\u6216\u8005\u6846\u67b6\u5185\u7f6e\u961f\u5217\uff08Laravel Queue\uff09<\/li>\n<\/ul>\n<\/li>\n\n\n\n
          • \u5b89\u5168\uff1a\n
              \n
            • clamav<\/strong>\u00a0\u6216\u5176\u4ed6\u6740\u6bd2\u626b\u63cf (\u626b\u63cf\u4e0a\u4f20\u6587\u4ef6\u3001\u62e6\u622a\u6076\u610f\u5b8f)<\/li>\n<\/ul>\n<\/li>\n\n\n\n
            • \u5b58\u50a8\uff1a\n
                \n
              • \u672c\u5730\u78c1\u76d8\u6216\u00a0S3<\/strong>\uff08\u5efa\u8bae\u751f\u4ea7\u7528 S3\uff09<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n

                \u67b6\u6784\u8bbe\u8ba1\uff08\u6a21\u5757\u5316\uff09<\/h1>\n\n\n\n
                  \n
                • API<\/code>\u00a0\u5c42\uff1aHTTP \u8def\u7531\u3001\u9a8c\u8bc1\u3001\u8eab\u4efd\uff08JWT \u6216 Session\uff09<\/li>\n\n\n\n
                • Controller<\/code>\u00a0\/\u00a0Handler<\/code>\uff1a\u628a\u8bf7\u6c42\u8f6c\u6362\u6210\u670d\u52a1\u8c03\u7528<\/li>\n\n\n\n
                • Service<\/code>\u00a0\u5c42\uff1aDocumentService<\/code>\u3001TemplateService<\/code>\u3001ConversionService<\/code><\/li>\n\n\n\n
                • Storage<\/code>\u00a0\u5c42\uff1aFlysystem \u9a71\u52a8\uff08local \/ s3\uff09<\/li>\n\n\n\n
                • Worker<\/code>\uff1a\u961f\u5217\u6d88\u8d39\u8005\uff0c\u7528\u4e8e\u8017\u65f6\u4efb\u52a1\uff08\u8f6c\u6362\u3001\u957f\u6587\u4ef6\u89e3\u6790\uff09<\/li>\n\n\n\n
                • DB<\/code>\uff1a\u8bb0\u5f55\u4efb\u52a1\u4e0e\u6587\u6863\u5143\u6570\u636e\uff08MySQL\uff09<\/li>\n\n\n\n
                • Security<\/code>\uff1a\u6587\u4ef6\u7c7b\u578b\u9a8c\u8bc1\u3001\u5b8f\u68c0\u6d4b\u3001\u6740\u6bd2\u626b\u63cf<\/li>\n\n\n\n
                • Logging<\/code>\uff1a\u5904\u7406\u65e5\u5fd7\u548c\u9519\u8bef\uff08\u6bcf\u5929 rotation\uff09<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n

                  \u9879\u76ee\u76ee\u5f55\u793a\u4f8b<\/h1>\n\n\n
                  \ndoc-processor\/\n\u251c\u2500 src\/\n\u2502  \u251c\u2500 Controller\/\n\u2502  \u2502  \u251c\u2500 UploadController.php\n\u2502  \u2502  \u251c\u2500 TemplateController.php\n\u2502  \u251c\u2500 Service\/\n\u2502  \u2502  \u251c\u2500 DocumentService.php\n\u2502  \u2502  \u251c\u2500 TemplateService.php\n\u2502  \u2502  \u251c\u2500 ConversionService.php\n\u2502  \u251c\u2500 Worker\/\n\u2502  \u2502  \u2514\u2500 ConversionWorker.php\n\u2502  \u251c\u2500 Storage\/\n\u2502  \u2502  \u2514\u2500 FilesystemFactory.php\n\u2502  \u2514\u2500 Utils\/\n\u2502     \u2514\u2500 MacroScanner.php\n\u251c\u2500 public\/\n\u2502  \u2514\u2500 index.php\n\u251c\u2500 tests\/\n\u251c\u2500 composer.json\n\u2514\u2500 docker\/\n   \u2514\u2500 Dockerfile + docker-compose.yml\n\n<\/pre><\/div>\n\n\n
                  \n\n\n\n
                  \u5173\u952e\u5b9e\u73b0\uff08\u4ee3\u7801\u793a\u4f8b\u2014\u2014\u6846\u67b6\u65e0\u5173\uff0ccomposer \u53ef\u76f4\u63a5\u8fd0\u884c\uff09<\/h1>\n\n\n\n
                  \u5148\u7ed9 composer.json<\/code> \u4e3b\u8981\u4f9d\u8d56\uff1a<\/p>\n\n\n
                  \n{\n  "require": {\n    "php": "^8.1",\n    "phpoffice\/phpword": "^1.1",\n    "league\/flysystem": "^2.0",\n    "symfony\/http-foundation": "^6.0",\n    "monolog\/monolog": "^2.0"\n  }\n}\n\n<\/pre><\/div>\n\n\n
                  1) \u7b80\u5355\u7684 DocumentService\uff08\u4e0a\u4f20 + \u5b58\u50a8 + \u9632\u5b8f\u68c0\u67e5\uff09<\/h3>\n\n\n
                  \n&lt;?php\nnamespace App\\Service;\n\nuse League\\Flysystem\\FilesystemOperator;\nuse Symfony\\Component\\HttpFoundation\\File\\UploadedFile;\n\nclass DocumentService {\n    private FilesystemOperator $storage;\n    private string $tmpDir;\n    private MacroScanner $scanner;\n\n    public function __construct(FilesystemOperator $storage, MacroScanner $scanner, string $tmpDir = '\/tmp') {\n        $this->storage = $storage;\n        $this->scanner = $scanner;\n        $this->tmpDir = $tmpDir;\n    }\n\n    public function saveUploadedFile(UploadedFile $file, string $ownerId): array {\n        \/\/ \u57fa\u7840\u9a8c\u8bc1\n        $ext = strtolower($file->getClientOriginalExtension());\n        if (!in_array($ext, ['doc','docx','docm'])) {\n            throw new \\InvalidArgumentException('\u4e0d\u652f\u6301\u7684\u6587\u4ef6\u7c7b\u578b');\n        }\n\n        \/\/ \u5b58\u5230\u4e34\u65f6\u4f4d\u7f6e\n        $tmpPath = $this->tmpDir . '\/' . uniqid('upload_') . '.' . $ext;\n        $file->move(dirname($tmpPath), basename($tmpPath));\n\n        \/\/ \u5b8f\u68c0\u6d4b\uff08\u5982\u679c docm\/\u542b\u5b8f\u5c31\u62d2\u7edd\u6216\u9694\u79bb\uff09\n        if ($this->scanner->hasMacros($tmpPath)) {\n            unlink($tmpPath);\n            throw new \\RuntimeException('\u6587\u4ef6\u5305\u542b\u5b8f\uff0c\u88ab\u62d2\u7edd\u4e0a\u4f20');\n        }\n\n        \/\/ \u8fdb\u4e00\u6b65\u53ef\u8c03\u7528 ClamAV \u626b\u63cf...\n\n        \/\/ \u4ee5\u65e5\u671f\u5206\u6876\u5b58\u50a8\n        $dest = "documents\/{$ownerId}\/" . date('Y\/m\/d') . '\/' . basename($tmpPath);\n        $stream = fopen($tmpPath, 'rb');\n        $this->storage->writeStream($dest, $stream);\n        if (is_resource($stream)) fclose($stream);\n        unlink($tmpPath);\n\n        \/\/ \u8fd4\u56de\u5143\u6570\u636e\uff08\u53ef\u5b58 DB\uff09\n        return ['path' => $dest, 'ext' => $ext, 'uploaded_at' => time()];\n    }\n}\n\n<\/pre><\/div>\n\n\n
                  MacroScanner\uff08\u7b80\u5355\u7248\uff09<\/h3>\n\n\n
                  \n&lt;?php\nnamespace App\\Utils;\n\nclass MacroScanner {\n    \/\/ \u7528\u6700\u7b80\u5355\u7684\u65b9\u5f0f\uff1a\u68c0\u6d4b .docm \u6269\u5c55\u6216 docx \u4e2d\u662f\u5426\u542b vbaProject.bin\n    public function hasMacros(string $filePath): bool {\n        $ext = pathinfo($filePath, PATHINFO_EXTENSION);\n        if ($ext === 'docm') return true;\n        if ($ext === 'docx') {\n            \/\/ docx \u5176\u5b9e\u662f zip\uff0c\u68c0\u67e5\u662f\u5426\u542b vbaProject.bin\n            $zip = new \\ZipArchive();\n            if ($zip->open($filePath) === true) {\n                $idx = $zip->locateName('word\/vbaProject.bin', \\ZipArchive::FL_NOCASE);\n                $zip->close();\n                return $idx !== false;\n            }\n        }\n        return false;\n    }\n}\n\n<\/pre><\/div>\n\n\n
                  2) \u6a21\u677f\u586b\u5145\uff08PhpWord Template\uff09<\/h3>\n\n\n
                  \n&lt;?php\nuse PhpOffice\\PhpWord\\TemplateProcessor;\n\nclass TemplateService {\n    public function fillTemplate(string $templatePath, array $vars, string $outPath) {\n        $tp = new TemplateProcessor($templatePath);\n\n        foreach ($vars as $k => $v) {\n            \/\/ \u6a21\u677f\u4e2d\u7528 ${name} \u8fd9\u6837\u7684\u5360\u4f4d\n            $tp->setValue($k, $v);\n        }\n        $tp->saveAs($outPath);\n    }\n}\n\n<\/pre><\/div>\n\n\n
                  \u793a\u4f8b\u6a21\u677f\u4e2d\u5360\u4f4d\u7b26\u7528 ${name}<\/code>\u3001${date}<\/code>\u3002<\/p>\n\n\n\n
                  3) \u8bfb\u53d6 .docx \u6587\u672c\uff08\u7b80\u6613\uff09<\/h3>\n\n\n\n
                  PhpWord \u7684\u8bfb\u53d6\u652f\u6301\u6709\u9650\uff0c\u4f46\u53ef\u4ee5\u7528 Reader:<\/p>\n\n\n
                  \n&lt;?php\nuse PhpOffice\\PhpWord\\IOFactory;\n\nfunction extractTextFromDocx(string $path): string {\n    $phpWord = IOFactory::load($path, 'Word2007');\n    $text = '';\n    foreach ($phpWord->getSections() as $section) {\n        $elements = $section->getElements();\n        foreach ($elements as $el) {\n            if (method_exists($el, 'getText')) $text .= $el->getText() . "\\n";\n        }\n    }\n    return $text;\n}\n\n<\/pre><\/div>\n\n\n
                  \n
                  \u6ce8\u610f\uff1a\u590d\u6742\u6392\u7248\u3001\u8868\u683c\u3001\u9875\u7709\u9875\u811a\u53ef\u80fd\u9700\u8981\u989d\u5916\u5904\u7406\u6216\u7528 LibreOffice \u63d0\u53d6\u6587\u672c\u66f4\u7a33\u59a5\u3002<\/p>\n<\/blockquote>\n\n\n\n
                  4) \u5408\u5e76\u591a\u4e2a docx\uff08PhpWord\uff09<\/h3>\n\n\n\n
                  \u5408\u5e76\u8f83\u590d\u6742\uff0c\u4f46\u601d\u8def\u662f\u628a\u6587\u6863\u5185\u5bb9\u590d\u5236\u5230\u4e3b\u6587\u6863\uff08\u4fdd\u6301\u6837\u5f0f\u53ef\u80fd\u9700\u989d\u5916\u5904\u7406\uff09\u3002\u793a\u4f8b\u53c2\u8003 PhpWord \u7684 addExternalFile()<\/code> \u6216\u5faa\u73af\u62f7\u8d1d\u5143\u7d20\u3002<\/p>\n\n\n\n
                  5) \u8f6c\u6362 Word \u2192 PDF\uff08\u7528 LibreOffice headless\uff09<\/h3>\n\n\n\n
                  \u90e8\u7f72\u670d\u52a1\u5668\u9700\u8981\u5b89\u88c5 LibreOffice\u3002\u547d\u4ee4\u884c\u793a\u4f8b\uff1a<\/p>\n\n\n
                  \nsoffice --headless --convert-to pdf --outdir \/path\/to\/out \/path\/to\/input.docx\n\n<\/pre><\/div>\n\n\n
                  PHP \u8c03\u7528\uff1a<\/p>\n\n\n
                  \nexec("soffice --headless --convert-to pdf --outdir " . escapeshellarg($outDir) . " " . escapeshellarg($inPath), $output, $ret);\nif ($ret !== 0) { throw new \\RuntimeException("\u8f6c\u6362\u5931\u8d25: " . implode("\\n",$output)); }\n\n<\/pre><\/div>\n\n\n
                  \u5982\u679c\u8981\u628a PDF \u8f6c\u56fe\u7247\u53ef\u4f7f\u7528 pdftoppm<\/code> \u6216 ImageMagick<\/code>\uff08\u6ce8\u610f\u5b89\u5168\u4e0e\u6027\u80fd\uff09\u3002<\/p>\n\n\n\n
                  \n\n\n\n
                  \u5b89\u5168\u6ce8\u610f\uff08\u5fc5\u987b\u6267\u884c\uff09<\/h1>\n\n\n\n
                    \n
                  1. \u62d2\u7edd\u5305\u542b\u5b8f\u7684\u6587\u4ef6<\/strong>\u00a0\u6216\u9694\u79bb\u5904\u7406\uff08.docm \u5fc5\u614e\uff09<\/li>\n\n\n\n
                  2. \u5bf9\u4e0a\u4f20\u6587\u4ef6\u505a malware scan\uff08ClamAV\uff09<\/strong><\/li>\n\n\n\n
                  3. \u4e0d\u8981\u53cd\u5e8f\u5217\u5316\u7528\u6237\u63d0\u4ea4\u6570\u636e<\/strong>\uff08\u548c serialize \u76f8\u5173\uff09<\/li>\n\n\n\n
                  4. \u9650\u5236\u6587\u4ef6\u5927\u5c0f<\/strong>\uff08\u5982 50MB\uff09\uff0c\u8d85\u5927\u6587\u4ef6\u5fc5\u987b\u8d70\u5206\u7247\u4e0a\u4f20\u4e0e\u540e\u53f0\u5904\u7406<\/li>\n\n\n\n
                  5. \u5bf9\u5916\u90e8\u547d\u4ee4\u4f7f\u7528 escapeshellarg\u3001\u9650\u5236\u8fd0\u884c\u7528\u6237<\/strong>\uff08\u4e0d\u8981\u4ee5 root \u6267\u884c soffice\uff09<\/li>\n\n\n\n
                  6. \u4f7f\u7528 CDN\/S3 \u505a\u516c\u5f00\u4e0b\u8f7d\uff0c\u7b7e\u540d URL<\/strong>\uff08\u77ed\u671f\u6709\u6548\uff09<\/li>\n\n\n\n
                  7. \u65e5\u5fd7\u9690\u79c1<\/strong>\uff1a\u4e0d\u5728\u65e5\u5fd7\u5199\u5165\u6587\u4ef6\u5185\u5bb9\uff08\u654f\u611f\u5185\u5bb9\uff09<\/li>\n<\/ol>\n\n\n\n
                    \n\n\n\n
                    \u6027\u80fd\u4e0e\u53ef\u6269\u5c55\u6027\u5efa\u8bae<\/h1>\n\n\n\n