PHPWord

Anderer Quellcode

1.3.0

Herunterladen

Filialleiter: PHPWord

PHPWord ist eine in reinem PHP geschriebene Bibliothek, die eine Reihe von Klassen zum Schreiben und Lesen aus verschiedenen Dokumentdateiformaten bereitstellt. Die aktuelle Version von PHPWord unterstützt Microsoft Office Open XML (OOXML oder OpenXML), OASIS Open Document Format für Office-Anwendungen (OpenDocument oder ODF), Rich Text Format (RTF), HTML und PDF.

PHPWord ist ein Open-Source-Projekt, das unter den Bedingungen der LGPL Version 3 lizenziert ist. PHPWord soll durch die Integration kontinuierlicher Integration und Unit-Tests ein qualitativ hochwertiges Softwareprodukt sein. Weitere Informationen zu PHPWord finden Sie in der Entwicklerdokumentation.

Wenn Sie Fragen haben, wenden Sie sich bitte an StackOverFlow

Lesen Sie mehr über PHPWord:

Merkmale
Anforderungen
Installation
Erste Schritte
Mitwirken
Entwicklerdokumentation

Merkmale

Mit PHPWord können Sie mithilfe Ihrer PHP-Skripte dynamisch OOXML-, ODF- oder RTF-Dokumente erstellen. Im Folgenden finden Sie einige Dinge, die Sie mit der PHPWord-Bibliothek tun können:

Legen Sie Dokumenteigenschaften fest, z. B. Titel, Betreff und Ersteller.
Erstellen Sie Dokumentabschnitte mit unterschiedlichen Einstellungen, z. B. Hoch-/Querformat, Seitengröße und Seitennummerierung
Erstellen Sie für jeden Abschnitt eine Kopf- und Fußzeile
Legen Sie die Standardschriftart, -größe und den Absatzstil fest
Verwenden Sie UTF-8- und ostasiatische Schriftarten/Zeichen
Definieren Sie benutzerdefinierte Schriftarten (z. B. Fett, Kursiv, Farbe) und Absatzstile (z. B. zentriert, mehrspaltig, Abstand), entweder als benannter Stil oder inline im Text
Fügen Sie Absätze ein, entweder als einfachen Text oder als komplexen Text (Textlauf), der andere Elemente enthält
Fügen Sie Titel (Überschriften) und Inhaltsverzeichnis ein
Fügen Sie Textumbrüche und Seitenumbrüche ein
Fügen Sie Bilder ein und formatieren Sie sie, entweder lokal, remote oder als Seitenwasserzeichen
Fügen Sie binäre OLE-Objekte wie Excel oder Visio ein
Fügen Sie eine Tabelle ein und formatieren Sie sie mit benutzerdefinierten Eigenschaften für jede Zeile (z. B. Wiederholung als Kopfzeile) und Zellen (z. B. Hintergrundfarbe, Zeilenbereich, Spaltenbereich).
Fügen Sie Listenelemente als Aufzählung, Nummer oder mehrstufig ein
Fügen Sie Hyperlinks ein
Fügen Sie Fußnoten und Endnoten ein
Zeichenformen einfügen (Bogen, Kurve, Linie, Polylinie, Rechteck, Oval)
Einfügen von Diagrammen (Kreis, Donut, Balken, Linie, Fläche, Streuung, Radar)
Formularfelder einfügen (Texteingabe, Kontrollkästchen und Dropdown)
Dokument aus Vorlagen erstellen
Verwenden Sie XSL 1.0-Stylesheets, um Kopfzeilen, Hauptdokumentteil und Fußzeilen einer OOXML-Vorlage zu transformieren
... und viele weitere Features zum Thema Fortschritt

Anforderungen

PHPWord erfordert Folgendes:

PHP 7.1+
XML-Parser-Erweiterung
Laminas Escaper-Komponente
Zip-Erweiterung (optional, wird zum Schreiben von OOXML und ODF verwendet)
GD-Erweiterung (optional, wird zum Hinzufügen von Bildern verwendet)
XMLWriter-Erweiterung (optional, wird zum Schreiben von OOXML und ODF verwendet)
XSL-Erweiterung (optional, wird zum Anwenden des XSL-Stylesheets auf die Vorlage verwendet)
dompdf-Bibliothek (optional, wird zum Schreiben von PDF verwendet)

Installation

PHPWord wird über Composer installiert. Auch zum Hinzufügen einer Abhängigkeit zu PHPWord in Ihrem Projekt

Führen Sie Folgendes aus, um die neueste stabile Version zu verwenden

composer require phpoffice/phpword

oder wenn Sie die neueste unveröffentlichte Version möchten

composer require phpoffice/phpword:dev-master

Erste Schritte

Im Folgenden finden Sie ein grundlegendes Anwendungsbeispiel der PHPWord-Bibliothek.

addText( '"Great achievement is usually born of great sacrifice, ' . 'and is never the result of selfishness." ' . '(Napoleon Hill)', array('name' => 'Tahoma', 'size' => 10) ); // Adding Text element with font customized using named font style... $fontStyleName = 'oneUserDefinedStyle'; $phpWord->addFontStyle( $fontStyleName, array('name' => 'Tahoma', 'size' => 10, 'color' => '1B2232', 'bold' => true) ); $section->addText( '"The greatest accomplishment is not in never falling, ' . 'but in rising again after you fall." ' . '(Vince Lombardi)', $fontStyleName ); // Adding Text element with font customized using explicitly created font style object... $fontStyle = new PhpOfficePhpWordStyleFont(); $fontStyle->setBold(true); $fontStyle->setName('Tahoma'); $fontStyle->setSize(13); $myTextElement = $section->addText('"Believe you can and you're halfway there." (Theodor Roosevelt)'); $myTextElement->setFontStyle($fontStyle); // Saving the document as OOXML file... $objWriter = PhpOfficePhpWordIOFactory::createWriter($phpWord, 'Word2007'); $objWriter->save('helloWorld.docx'); // Saving the document as ODF file... $objWriter = PhpOfficePhpWordIOFactory::createWriter($phpWord, 'ODText'); $objWriter->save('helloWorld.odt'); // Saving the document as HTML file... $objWriter = PhpOfficePhpWordIOFactory::createWriter($phpWord, 'HTML'); $objWriter->save('helloWorld.html'); /* Note: we skip RTF, because it's not XML-based and requires a different example. */ /* Note: we skip PDF, because "HTML-to-PDF" approach is used to create PDF documents. */">

 
require_once ' bootstrap.php ' ;

// Creating the new document...
$ phpWord = new  PhpOffice  PhpWord  PhpWord ();

/* Note: any element you append to a document must reside inside of a Section. */

// Adding an empty Section to the document...
$ section = $ phpWord -> addSection ();
// Adding Text element to the Section having font styled by default...
$ section -> addText (
    ' "Learn from yesterday, live for today, hope for tomorrow. '
        . ' The important thing is not to stop questioning." '
        . ' (Albert Einstein) '
);

/*
 * Note: it's possible to customize font style of the Text element you add in three ways:
 * - inline;
 * - using named font style (new font style object will be implicitly created);
 * - using explicitly created font style object.
 */

// Adding Text element with font customized inline...
$ section -> addText (
    ' "Great achievement is usually born of great sacrifice, '
        . ' and is never the result of selfishness." '
        . ' (Napoleon Hill) ' ,
    array ( ' name ' => ' Tahoma ' , ' size ' => 10 )
);

// Adding Text element with font customized using named font style...
$ fontStyleName = ' oneUserDefinedStyle ' ;
$ phpWord -> addFontStyle (
    $ fontStyleName ,
    array ( ' name ' => ' Tahoma ' , ' size ' => 10 , ' color ' => ' 1B2232 ' , ' bold ' => true )
);
$ section -> addText (
    ' "The greatest accomplishment is not in never falling, '
        . ' but in rising again after you fall." '
        . ' (Vince Lombardi) ' ,
    $ fontStyleName
);

// Adding Text element with font customized using explicitly created font style object...
$ fontStyle = new  PhpOffice  PhpWord  Style  Font ();
$ fontStyle -> setBold ( true );
$ fontStyle -> setName ( ' Tahoma ' );
$ fontStyle -> setSize ( 13 );
$ myTextElement = $ section -> addText ( ' "Believe you can and you ' re halfway there." (Theodor Roosevelt) ' );
$ myTextElement -> setFontStyle ( $ fontStyle );

// Saving the document as OOXML file...
$ objWriter =  PhpOffice  PhpWord  IOFactory :: createWriter ( $ phpWord , ' Word2007 ' );
$ objWriter -> save ( ' helloWorld.docx ' );

// Saving the document as ODF file...
$ objWriter =  PhpOffice  PhpWord  IOFactory :: createWriter ( $ phpWord , ' ODText ' );
$ objWriter -> save ( ' helloWorld.odt ' );

// Saving the document as HTML file...
$ objWriter =  PhpOffice  PhpWord  IOFactory :: createWriter ( $ phpWord , ' HTML ' );
$ objWriter -> save ( ' helloWorld.html ' );

/* Note: we skip RTF, because it's not XML-based and requires a different example. */
/* Note: we skip PDF, because "HTML-to-PDF" approach is used to create PDF documents. */

Weitere Beispiele finden Sie im Beispielordner. Für einen einfachen Zugriff auf diese Beispiele starten Sie php -S localhost:8000 im Beispielverzeichnis und navigieren dann zu http://localhost:8000, um die Beispiele anzuzeigen. Weitere Einzelheiten finden Sie auch in der Entwicklerdokumentation.