PHPWord

 
 

مكتبة PHP مفتوحة المصدر لمستندات Microsoft ® Word

قراءة وكتابة ومعالجة وتحويل ملفات MS Word DOC و DOCX و ODT و RTF و HTML إلى تنسيق PDF عبر PHP API.

ما هو PHPWord؟

PHPWord هي مكتبة مفتوحة المصدر تتكون من فئات لمساعدتك في تطوير تطبيقات PHP التي يمكنها التفاعل مع تنسيقات ملفات المستندات المختلفة. تم ترخيص PHPWord بموجب LGPL الإصدار 3 ويمكّنك من العمل مع إعدادات المستند وأنماطه وقوالبه وعناصر أخرى متنوعة.

Previous Next

الشروع في استخدام PHPWord

لإنشاء مستند Word باستخدام PHPWord ، تحتاج إلى تثبيت الموارد التالية في نظام التشغيل الخاص بك:

  • إصدار PHP 5.3.3+
  • ملحن
  • ملحق محلل XML (يتم تمكين هذا الامتداد افتراضيًا)
  • Zend Escaper Component Install it using يتطلب الملحن zendframework / zend-escaper
  • مكون Zend Escaper قم بتثبيته باستخدام يتطلب الملحن zendframework / zend-escaper

إنشاء مستند Word باستخدام PHPWord

يتيح PHPWord للمطورين إنشاء مستند Word جديد (DOCX) من البداية. يسمح لك بإضافة فقرات وعناوين ونصوص وصور وارتباطات تشعبية ومخططات جديدة والمزيد. يعد إنشاء مستند Word أمرًا بسيطًا ، فأنت بحاجة إلى إنشاء مستند جديد باستخدام طريقة PhpWord ().

إنشاء كلمة في PHP

  1. إنشاء مستند Word باستخدام PhpWord
  2. أضف قسمًا في المستند
  3. أضف نصًا في القسم
  4. احفظ المستند

إنشاء مستند Word - PHP

<?php
require_once 'vendor\phpoffice\phpword\bootstrap.php';
// Create the new document..
$phpWord = new \PhpOffice\PhpWord\PhpWord();
// Add an empty Section to the document
$section = $phpWord->addSection();
// Add Text element to the Section
$section->addText(
  'File Format Developer Guide - '
  . 'Learn about computer files that you come across in '
  . 'your daily work at: www.fileformat.com'
);
// Save document
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('HelloWorld.docx');
  

تكوين إعدادات المستند بسهولة

يمكنك إجراء إعدادات متنوعة للمستندات. نسبة التكبير الافتراضية للمستند هي 100٪ ولكن يمكنك تغييرها إلى قيمة أخرى. للمستندات على الوجهين ، على سبيل المثال المجلات ، يمكنك إعداد صفحات متقابلة عن طريق عكس هوامش الصفحة. يمكنك تعديل حالة خيار التدقيق التلقائي للأخطاء النحوية أو الإملائية.

تتوفر أيضًا ميزة تتبع مراجعات المستند. يمكن تكوين PHPWord للعمل مع اللغات اللاتينية ولغات شرق آسيا بالإضافة إلى اللغات المعقدة (ثنائية الاتجاه). يمكنك حماية مستند أو جزء منه بكلمة مرور.

هناك الكثير من الميزات الأخرى التي يسمح لك PHPWord بتكوينها للمستندات ، وتشمل بعض هذه الميزات ، معلومات المستند ، ووحدات القياس ، والواصلة ، وإعادة الحساب التلقائي لحقول المستند كلما تم فتح المستند.

قم بتعيين خصائص DOCX - PHP

<?php
require_once 'vendor\phpoffice\phpword\bootstrap.php';
// Create the new document..
$phpWord = new \PhpOffice\PhpWord\PhpWord();
// Set document properties
$properties = $phpWord->getDocInfo();
$properties->setCreator('Ali Ahmed');
$properties->setCompany('File Format');
$properties->setTitle('PHPWord');
$properties->setDescription('File Format Developer Guide');
$properties->setCategory('My category');
$properties->setLastModifiedBy('My name');
$properties->setCreated(mktime(0, 0, 0, 3, 12, 2019));
$properties->setModified(mktime(0, 0, 0, 3, 14, 2019));
$properties->setSubject('PHPWord');
// Save document
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('DocumentProperties.docx');
  

حاويات لتنظيم عناصر الوثيقة

يحتوي PHPWord على كائنات تسمى الحاويات ، والتي تحتوي على عناصر مختلفة (جداول ، نص ، إلخ) من المستند. هناك 3 حاويات أولية ؛ المقاطع والرؤوس والتذييلات. أيضًا ، هناك 3 عناصر يمكن أن تكون بمثابة حاويات ؛ الزخارف وخلايا الجدول والحواشي السفلية.

يجب وضع جميع العناصر المرئية من المستند داخل قسم. يمكنك تعيين أرقام الصفحات وأرقام الأسطر وتغيير التخطيط إلى أعمدة متعددة وإنشاء رؤوس / تذييلات.

إضافة حاوية رأس

<?php
require_once 'vendor\phpoffice\phpword\bootstrap.php';
// Create the new document..
$phpWord = new \PhpOffice\PhpWord\PhpWord();
// Add an empty Section to the document
$section = $phpWord->addSection();
// Add Header
$header = $section->addHeader();
$header->addImage('word-processing-image.png');
// Save document
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('Container.docx');

حماية مستند Word عبر PHPWord API

من الحكمة دائمًا حماية أو تأمين مستنداتك المهمة التي تتضمن معلومات حساسة. تتيح مكتبة PHPWord مفتوحة المصدر لمطوري البرامج حماية مستندات Word الخاصة بهم من خلال توفير كلمة مرور فريدة داخل تطبيقات PHP الخاصة بهم. ستعمل الحماية كإجراء وقائي ، مما يمنع الوصول غير المصرح به أو إجراء تغييرات على مستند Word.

 عربي