PHP में DOCX फ़ाइलों की ईमानदार पीढ़ी। भाग २

नमस्कार, प्रिय प्रभामंडल!
हम PHP का उपयोग करके DOCX उत्पन्न करने के बारे में कहानी जारी रखते हैं।

आज हमें क्या इंतजार है:

• हम सीखेंगे कि किसी दस्तावेज़ में छवियों को कैसे एम्बेड किया जाए;
• अंग्रेजी मीट्रिक इकाइयों के खाते पर प्रकाश डालें;
• आइए, एक्सेल की भावी पीढ़ी के लिए एक रिजर्व बनाएं।

जिन लोगों को पता नहीं है, उन्हें पहले भाग को पढ़ने की सलाह दी जाती है। खैर, जो विषय में - मैं एक कटौती के लिए पूछना ।

एक बार और

लेकिन पहले, पहली चीजें पहले। पिछले लेख के प्रकाशन के बाद से, टिप्पणियों की पर्याप्त संख्या लिखी गई है: भावनात्मक और मामले पर; Github पर PHPDocx परियोजना में कई कांटे हैं। यह सब बताता है कि यह विषय काफी प्रासंगिक है। लेकिन कुछ डेवलपर्स मेरे दृष्टिकोण के बहुत सार को नहीं समझते हैं। और यह दृष्टिकोण विरासत का उपयोग करने के लिए है: जेनरेटर क्लास को ज़िपअर्चिव का वंशज होना चाहिए। सुनो, ठीक है, अगर आप विरासत का उपयोग नहीं करना चाहते हैं, तो PHP 5.4 स्थापित करें और अंत में लक्षण का उपयोग करें ! यह दृष्टिकोण एक संपत्ति के माध्यम से लगातार काम करने की तुलना में अतुलनीय रूप से बेहतर है:

$this->archive->open( … ); $this->archive->addFile( … ); $this->archive->close( .. ); 

मुझे PHP में DOCX उत्पन्न करने की आवश्यकता क्यों है? कुछ डेवलपर्स यह नहीं समझते हैं कि यह बिल्कुल क्यों आवश्यक है। मैंने वर्ड फॉर्मेट में वेब पेज को सेव करना संभव बनाने पर ध्यान केंद्रित किया। व्यक्तिगत रूप से, मैं DOCX प्रारूप में Yandex.Metrica रिपोर्ट को बचाने के लिए अपनी कक्षा का उपयोग करता हूं। SeriyPS ने पूछा कि मैंने टेक्स्ट को लाइनों में क्यों तोड़ दिया? मैंने ऐसा किया, यह मानते हुए कि पाठ डेटाबेस से एक क्षेत्र है, और लाइन ब्रेक एक नया पैराग्राफ है। सामान्य तौर पर, हम स्पष्टता के लिए ऐसा नहीं करेंगे। पैराग्राफ में अपने स्वयं के टूटने बनाओ।
इसके अलावा, हमारे जनरेटर में सबसे सुविधाजनक एपीआई होना चाहिए। मुझे लगता है कि मैं इसे लागू करने में कामयाब रहा। एपीआई में केवल तीन विधियाँ होती हैं: निर्माता, असाइन करना, बनाना।
खैर, बात की, और यह काफी है। चलिए शुरू करते हैं।

नया क्या है

सबसे पहले, मैंने उस लेख में उपयोग किए गए कोड को महत्वपूर्ण रूप से बदल दिया और सभी को एक पूर्ण-ओपन ओपन सोर्स लाइब्रेरी में डाल दिया। अंत में लिंक। और अब अंक के लिए:

1. OfficeDocument और WordDocument वर्ग

जैसा कि हम पहले ही समझ चुके हैं, पुरालेख में मूल रूप से MS Office दस्तावेज़ के लिए आवश्यक फाइलें हैं। शब्द / फ़ोल्डर में एमएस ऑफिस वर्ड डॉक्यूमेंट द्वारा सीधे आवश्यक दस्तावेज होते हैं। समाधान स्वयं सुझाव देता है: एमएस ऑफिस दस्तावेजों के लिए वर्ग को सामान्य बनाने के लिए, और सीधे वर्ड दस्तावेजों के लिए उत्तराधिकारी वर्ग।
मैं तुरंत संरचना का वर्णन करूंगा:

 //      MS Office  class OfficeDocument extends ZipArchive{ __construct($filename, $template_path = '/template/' ); protected function add_rels( $filename, $rels, $path = '' ); protected function pparse( $replace, $content ); } //     MS Word class WordDocument extends OfficeDocument{ public function __construct( $filename, $template_path = '/template/' ) //  ,   API public function assign( $content = '', $return = false ); public function create(); } 

मैंने ऐसा क्यों किया। यह भविष्य के लिए एक आरक्षित है, जिसमें हम XlsxDocument वर्ग के साथ एमएस एक्सेल फाइल जेनरेट करेंगे।
आइए इनसाइड को देखें।

2. डायनेमिक लिंकिंग

डॉक्स फाइल के अंदर _rels / .xml और शब्द / _rels / document.xml.rels फाइलें होती हैं। वे दस्तावेज़ में फ़ाइलें शामिल करते हैं। यदि आप इन संरचनाओं में किसी भी फ़ाइल का वर्णन नहीं करते हैं, तो यह डॉक्स दस्तावेज़ में बस अधिक वजन होगा। इस तरह से आप बस docx के अंदर जानकारी छिपा सकते हैं। हम डिजाइनरों में XML दस्तावेजों के बीच आंतरिक लिंक के सरणियों का निर्माण करेंगे। यहाँ, उदाहरण के लिए, एमएस ऑफिस दस्तावेज़ के लिए लिंक हैं:

  //     MS Office $this->rels = array_merge( $this->rels, array( 'rId3' => array( 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties', 'docProps/app.xml' ), 'rId2' => array( 'http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties', 'docProps/core.xml' ), ) ); 

शामिल फ़ाइल का पहचानकर्ता रिकॉर्ड "rIdN" है। App.xml और core.xml फ़ाइलें स्थिर हैं। XML_rels.xml लिंक विवरण XML फ़ाइल बनाते समय, हम उन्हें add_rels विधि का उपयोग करके संग्रह में पैक करेंगे:

  //   protected function add_rels( $filename, $rels, $path = '' ){ //  XML $xmlstring = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'; //      foreach( $rels as $rId => $params ){ //     , .  ,     $pathfile = empty( $params[2] ) ? $this->path . $path . $params[1] : $params[2]; //     if( $this->addFile( $pathfile , $path . $params[1] ) === false ) die('     ' . $path . $params[1] ); //    $xmlstring .= '<Relationship Id="' . $rId . '" Type="' . $params[0] . '" Target="' . $params[1] . '"/>'; } $xmlstring .= '</Relationships>'; //    $this->addFromString( $path . $filename, $xmlstring ); } 

कृपया ध्यान दें कि Add_rels को OfficeDocument में वर्णित किया गया है, और दोनों वर्गों में उपयोग किया जाता है: OfficeDocument और WordDocument, चूंकि docx फ़ाइल के अंदर दो _rels.xml दस्तावेज़ हैं जो निर्भरता का वर्णन करते हैं। यह ओओपी दृष्टिकोण की जीत है जिसे मैंने प्रस्तावित किया था, और यहां VolCh द्वारा प्रस्तावित कार्यप्रणाली निश्चित रूप से काम नहीं करेगी।
परिणामस्वरूप, हमें एक विशिष्ट _rels मिलता है:

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"> <Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties" Target="docProps/app.xml"/> <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/> <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/> </Relationships> 

हम गतिशील रूप से शब्द / document.xml फ़ाइल को उत्पन्न और कनेक्ट करेंगे। उम्मीद है कि डायनामिक लिंकिंग के साथ यह स्पष्ट है। अब छवि के सम्मिलन के साथ।

छवियों को एम्बेड करना सीखना

सबसे पहले, मैं एक एक्सएमएल टुकड़ा एक प्रयोगात्मक विधि द्वारा प्राप्त करने के लिए document.xml में डाला जाएगा एक शब्द दस्तावेज़ में एक छवि पाने के लिए:

 <w:pw:rsidR="000E3348" w:rsidRDefault="00CD6FED"> <w:r> <w:rPr> <w:noProof/> <w:lang w:eastAsia="ru-RU"/> </w:rPr> <w:drawing> <wp:inline distT="0" distB="0" distL="0" distR="0"> <wp:extent cx="{WIDTH}" cy="{HEIGHT}"/> <wp:effectExtent l="19050" t="0" r="0" b="0"/> <wp:docPr id="2" name=" 2"/> <wp:cNvGraphicFramePr> <a:graphicFrameLocks xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" noChangeAspect="1"/> </wp:cNvGraphicFramePr> <a:graphic xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"> <a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture"> <pic:pic xmlns:pic="http://schemas.openxmlformats.org/drawingml/2006/picture"> <pic:nvPicPr> <pic:cNvPr id="0" name="image.jpg"/> <pic:cNvPicPr/> </pic:nvPicPr> <pic:blipFill> <a:blip r:embed="{RID}"> <a:extLst> <a:ext uri="{28A0092B-C50C-407E-A947-70E740481C1C}"> <a14:useLocalDpi xmlns:a14="http://schemas.microsoft.com/office/drawing/2010/main" val="0"/> </a:ext> </a:extLst> </a:blip> <a:stretch> <a:fillRect/> </a:stretch> </pic:blipFill> <pic:spPr> <a:xfrm> <a:off x="0" y="0"/> <a:ext cx="{WIDTH}" cy="{HEIGHT}"/> </a:xfrm> <a:prstGeom prst="rect"> <a:avLst/> </a:prstGeom> <a:noFill/> <a:ln> <a:noFill/> </a:ln> </pic:spPr> </pic:pic> </a:graphicData> </a:graphic> </wp:inline> </w:drawing> </w:r> </w:p> 

हमें कनेक्ट की गई छवि के पहचानकर्ता के साथ {RID} को बदलना होगा, साथ ही {WIDTH} और {HEIGHT} को पंजीकृत करना होगा।
एक छवि डालने के लिए, साथ ही पाठ सम्मिलित करने के लिए, एक एपीआई विधि जिम्मेदार है - असाइन करें:

  public function assign( $content = '', $return = false ){ // ,   $text .  ,    if( is_file( $content ) ){ //    $block = file_get_contents( $this->path . 'image.xml' ); list( $width, $height ) = getimagesize( $content ); $rid = "rId" . count( $this->word_rels ) . 'i'; $this->word_rels[$rid] = array( "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image", "media/" . $content, //      $content ); $xml = $this->pparse( array( '{WIDTH}' => $width * $this->px_emu, '{HEIGHT}' => $height * $this->px_emu, '{RID}' => $rid, ), $block ); } else{ //    $block = file_get_contents( $this->path . 'p.xml' ); $xml = $this->pparse( array( '{TEXT}' => $content, ), $block ); } //   ,    XML,  if( $return ) return $xml; else $this->content .= $xml; } 

जो लोग कोड पढ़ सकते हैं वे नोटिस करेंगे कि विधि एक मुश्किल मीट्रिक प्रणाली का उपयोग करती है। इसे अंग्रेजी मीट्रिक इकाइयाँ (EMU) कहा जाता है। आप इसके बारे में अंग्रेज़ी विकिपीडिया पर पढ़ सकते हैं। संक्षेप में: आप एक संख्या से गुणा करके px से EMU प्राप्त कर सकते हैं। केवल यहाँ विकिपीडिया पर यह लिखा है कि यह संख्या 12,700 है। मुझे प्रायोगिक तौर पर पता चला कि यह 8625 है। इस कारक के साथ, चित्र को पिक्सेल द्वारा पिक्सेल प्रदर्शित किया गया था।
और हां, हम छवि फ़ाइल को सीधे लिंक संरचना से जोड़ते हैं:

  $rid = "rId" . count( $this->word_rels ) . 'i'; $this->word_rels[$rid] = array( "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image", "media/" . $content, //      $content ); 

परिणामस्वरूप

नतीजतन, हमें एक पूर्ण पुस्तकालय मिला। अब हम इसे इस तरह उपयोग कर सकते हैं:

 //   include 'PHPDocx_0.9.2.php'; //     .   $w = new WordDocument( ".docx" ); //   assign /****************************** / / $w->assign( 'text' ); / $w->assign( 'image.png' ); / $xml = $w->assign( 'image.png', true ); / $w->assign( $w->assign( 'image.png', true ) ); / /******************************/ $w->assign('image.jpg'); $w->assign('    -     .'); $w->create(); 

वह मूल रूप से यह है।
योजनाएं: टेबल पीढ़ी।
संदर्भ:
Github पर PHPDocx ।
PHPDocx परियोजना पृष्ठ ।
स्रोत डाउनलोड करें ।