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 Parser (این پسوند به طور پیش فرض فعال است)
  • Zend Escaper Component Install it using آهنگساز به zendframework/zend-escaper نیاز دارد
  • مؤلفه Zend Escaper آن را با استفاده از composer به zendframework/zend-escaper نصب کنید

با استفاده از PHPWord سند Word ایجاد کنید

PHPWord به توسعه دهندگان این امکان را می دهد که سند Word جدید (DOCX) را از ابتدا ایجاد کنند. این به شما امکان می دهد پاراگراف ها، عناوین، متن، تصاویر، لینک ها، نمودارها و موارد دیگر را اضافه کنید. ایجاد یک سند word ساده است، شما باید با استفاده از روش PhpWord() یک سند جدید ایجاد کنید.

ایجاد Word در PHP

  1. با استفاده از PhpWord سند word ایجاد کنید
  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 جلوگیری می کند.

 فارسی