PHPMot

Autre code source

1.3.0

Télécharger

Maître de Branche : PHPMot

PHPWord est une bibliothèque écrite en PHP pur qui fournit un ensemble de classes dans lesquelles écrire et lire à partir de différents formats de fichiers de documents. La version actuelle de PHPWord prend en charge Microsoft Office Open XML (OOXML ou OpenXML), OASIS Open Document Format pour les applications Office (OpenDocument ou ODF), Rich Text Format (RTF), HTML et PDF.

PHPWord est un projet open source sous licence LGPL version 3. PHPWord vise à être un produit logiciel de haute qualité en intégrant une intégration continue et des tests unitaires. Vous pouvez en savoir plus sur PHPWord en lisant la documentation des développeurs.

Si vous avez des questions, veuillez les poser sur StackOverFlow

En savoir plus sur PHPWord :

Caractéristiques
Exigences
Installation
Commencer
Contribuer
Documentation des développeurs

Caractéristiques

Avec PHPWord, vous pouvez créer dynamiquement des documents OOXML, ODF ou RTF à l'aide de vos scripts PHP. Voici quelques-unes des choses que vous pouvez faire avec la bibliothèque PHPWord :

Définissez les propriétés du document, par exemple le titre, le sujet et le créateur.
Créez des sections de document avec différents paramètres, par exemple portrait/paysage, taille de page et numérotation des pages.
Créer un en-tête et un pied de page pour chaque section
Définir le type de police, la taille de police et le style de paragraphe par défaut
Utiliser les polices/caractères UTF-8 et Asie de l'Est
Définissez des styles de police personnalisés (par exemple gras, italique, couleur) et des styles de paragraphe (par exemple centrés, multicolonnes, espacement) soit en tant que style nommé, soit en ligne dans le texte.
Insérez des paragraphes, soit sous forme de texte simple, soit sous forme de texte complexe (un texte) contenant d'autres éléments.
Insérer des titres (en-têtes) et une table des matières
Insérer des sauts de texte et des sauts de page
Insérer et formater des images, locales, distantes ou sous forme de filigranes de page
Insérer des objets OLE binaires tels qu'Excel ou Visio
Insérer et formater un tableau avec des propriétés personnalisées pour chaque ligne (par exemple, répéter comme ligne d'en-tête) et cellule (par exemple, couleur d'arrière-plan, rowspan, colspan)
Insérer des éléments de liste sous forme de puces, numérotés ou à plusieurs niveaux
Insérer des hyperliens
Insérer des notes de bas de page et des notes de fin
Insérer des formes de dessin (arc, courbe, ligne, polyligne, rectangle, ovale)
Insérer des graphiques (camembert, beignet, barre, ligne, zone, nuage de points, radar)
Insérer des champs de formulaire (saisie de texte, case à cocher et liste déroulante)
Créer un document à partir de modèles
Utilisez les feuilles de style XSL 1.0 pour transformer les en-têtes, la partie principale du document et les pieds de page d'un modèle OOXML.
... et bien d'autres fonctionnalités en cours de progression

Exigences

PHPWord nécessite les éléments suivants :

PHP7.1+
Extension de l'analyseur XML
Composant Laminas Escaper
Extension Zip (facultatif, utilisé pour écrire OOXML et ODF)
Extension GD (facultatif, utilisé pour ajouter des images)
Extension XMLWriter (facultatif, utilisé pour écrire OOXML et ODF)
Extension XSL (facultatif, utilisé pour appliquer une feuille de style XSL au modèle)
bibliothèque dompdf (facultatif, utilisé pour écrire des PDF)

Installation

PHPWord est installé via Composer. Pour ajouter une dépendance à PHPWord dans votre projet, soit

Exécutez ce qui suit pour utiliser la dernière version stable

composer require phpoffice/phpword

ou si vous voulez la dernière version inédite

composer require phpoffice/phpword:dev-master

Commencer

Ce qui suit est un exemple d'utilisation de base de la bibliothèque PHPWord.

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. */

D'autres exemples sont fournis dans le dossier des exemples. Pour un accès facile à ces exemples, lancez php -S localhost:8000 dans le répertoire des exemples, puis accédez à http://localhost:8000 pour afficher les exemples. Vous pouvez également lire la documentation des développeurs pour plus de détails.