docxmustache

docxmustache สำหรับ Laravel 10.x

คลาสการจัดการเทมเพลต Docx สำหรับ Laravel 10.x ขึ้นอยู่กับภาษาเทมเพลตหนวด คลาสนี้ยังอยู่ภายใต้การพัฒนาอย่างหนักและทำงานได้เหมือนการพิสูจน์แนวคิดในขณะนี้ สิ่งต่าง ๆ จะเปลี่ยนแปลงอย่างรวดเร็วและอาจทำลายสิ่งต่าง ๆ

แพ็คเกจนี้ช่วยให้คุณใช้ไฟล์ docx ที่มีไวยากรณ์หนวดเป็นเทมเพลตเพื่อผสานเอกสารที่มีสไตล์หลากหลายเข้ากับข้อมูลจากแหล่งข้อมูลใด ๆ สามารถแทนที่ข้อความและรูปภาพ และรองรับการจัดรูปแบบ HTML พื้นฐาน (ตัวหนา ตัวเอียง ขีดเส้นใต้)

การติดตั้ง

composer require wrklst/ docxmustache

โปรดตรวจสอบการพึ่งพาด้านล่างและโฟลเดอร์ตัวอย่างสำหรับการกำหนดค่าและการใช้งาน

การแปลง HTML

การแปลง HTML ปัจจุบันเป็นการแปลงพื้นฐานและสนับสนุนเฉพาะการเรียกใช้ข้อความตัวหนา ตัวเอียง และขีดเส้นใต้เท่านั้น และไม่มีการผสมผสานระหว่างข้อความเหล่านี้ กำหนดให้ค่าทั้งหมดที่ไม่ใช่ html ต้องหลีกหนีด้วย htmlspecialchars($value, ENT_COMPAT, 'UTF-8'); และคำนำหน้าเป็น *[[DONOTESCAPE]]* เพื่อให้คลาสรู้ว่าไม่ต้อง Escape html ก่อนที่จะแปลงเป็น openXML

การแทนที่รูปภาพ

รูปภาพจะต้องเป็น URL ที่สามารถเข้าถึงได้พร้อมรูปภาพในรูปแบบที่รองรับ ต้องวางค่า url ลงในช่องคำอธิบายข้อความแสดงแทนของรูปภาพ รูปภาพจะถูกสุ่มตัวอย่างใหม่ตามข้อจำกัดของรูปภาพตัวยึดตำแหน่ง ค่ารูปภาพจะต้องได้รับการจัดรูปแบบโดยมีแท็กหลอกอยู่รอบๆ เช่น: [IMG-REPLACE]http://placehold.it/350x150[/IMG-REPLACE]

ตัวอย่าง

โปรดตรวจสอบตัวอย่างในโฟลเดอร์ตัวอย่างเพื่อทำความเข้าใจพื้นฐานเกี่ยวกับวิธีใช้คลาสนี้

การแปลง DOCX เป็น PDF

การแปลงเป็น PDF จำเป็นต้องติดตั้ง libreoffice-common บนเซิร์ฟเวอร์ (ใช้สำหรับการแปลง) ใช้ sudo apt install libreoffice-common บนเซิร์ฟเวอร์ที่ใช้ ubuntu/debian ของคุณ ติดตั้ง ttf-mscorefonts ด้วยหากคุณต้องการการสนับสนุนแบบอักษร Arial เมื่อแปลงเอกสาร docx เป็น pdf sudo apt-get install ttf-mscorefonts-installer

การพึ่งพาอื่น ๆ

แพ็คเกจนี้ขึ้นอยู่กับฟังก์ชันเฉพาะของ Laravel หลายประการ มันสามารถถูกย้ายไปยังเฟรมเวิร์กอื่น ๆ ได้อย่างง่ายดายหรือถูกย้ายให้เป็นเฟรมเวิร์กที่ไม่เชื่อเรื่องพระเจ้า นอกเหนือจากการพึ่งพา Laravel แล้ว หน้านี้ยังใช้แพ็คเกจต่อไปนี้:

• หนวด/หนวด
• การแทรกแซง/รูปภาพ (ต้องเพิ่มผู้ให้บริการและนามแฝงในการกำหนดค่าแอปของคุณ เช่นเดียวกับ gd หรือ imagick โปรดตรวจสอบรายละเอียดจากหน้าเว็บการแทรกแซงรูปภาพ)

การพึ่งพาเฉพาะของ Laravel (เกี่ยวข้องเฉพาะในกรณีที่ย้ายไปยังสภาพแวดล้อมที่ไม่ใช่ Laravel):

• คลาสการจัดเก็บและไฟล์ขึ้นอยู่กับ Flysystem (สำหรับการเข้าถึงไฟล์ในเครื่องสามารถแทนที่ด้วยวิธี phps ของตัวเอง fopen ฯลฯ )
• SymfonyComponentProcessProcess (สำหรับการแปลง PDF เท่านั้น)

ผลงาน

หากคุณต้องการมีส่วนร่วมในแพ็คเกจนี้ โปรดส่งคำขอดึงและปัญหาที่เกี่ยวข้องและเรายินดีที่จะตรวจสอบและหารือ

เหตุใดจึงใช้โซลูชันเทมเพลต openXML / docx อื่น

มีบางชั้นเรียนที่ช่วยในการเขียนและหรือเปลี่ยนแปลงเนื้อหาของเอกสาร word บางชั้นเรียนมีใบอนุญาตเชิงพาณิชย์และบางส่วนฟรี เพื่อจุดประสงค์เฉพาะของเรา เราไม่ต้องการฟีเจอร์ส่วนใหญ่ที่ไลบรารีหลายๆ แห่งมีอยู่ เราต้องการโซลูชันง่ายๆ ที่ช่วยให้สามารถแทนที่ค่าและรูปภาพ และสำรวจข้อมูลในลักษณะที่ง่ายและตรงไปตรงมา

ไลบรารีอื่นๆ จำนวนมากใช้การโคลนเพื่อทำซ้ำบล็อกด้วยไวยากรณ์เทมเพลตแบบกำหนดเองแทนที่จะใช้ไวยากรณ์เทมเพลตที่มีอยู่ เราใช้ไวยากรณ์หนวดตามปกติเพื่อให้เกิดเนื้อหาซ้ำในหลายมิติตามต้องการ

คลาส PHP อื่นๆ เพื่อจัดการเอกสารคำ openXML:

• openTBS – เล็กแต่แข็งแกร่ง
• PHPWord
• docxtemplater pro (ใบอนุญาต opensource พื้นฐาน / เวอร์ชันฟรี / MIT มีให้ใช้งานในขณะที่เขียน การเปลี่ยนรูปภาพเป็นปลั๊กอินเชิงพาณิชย์)
• docxpresso (เชิงพาณิชย์)
• phpdocx (เชิงพาณิชย์)