PHPWord

Outro código-fonte

1.3.0

Baixar

Mestre de Filial: PHPWord

PHPWord é uma biblioteca escrita em PHP puro que fornece um conjunto de classes para escrever e ler em diferentes formatos de arquivos de documentos. A versão atual do PHPWord oferece suporte ao Microsoft Office Open XML (OOXML ou OpenXML), OASIS Open Document Format para aplicativos do Office (OpenDocument ou ODF), Rich Text Format (RTF), HTML e PDF.

PHPWord é um projeto de código aberto licenciado sob os termos da LGPL versão 3. PHPWord pretende ser um produto de software de alta qualidade, incorporando integração contínua e testes unitários. Você pode aprender mais sobre o PHPWord lendo a Documentação dos Desenvolvedores.

Se você tiver alguma dúvida, pergunte no StackOverFlow

Características

Com PHPWord, você pode criar documentos OOXML, ODF ou RTF dinamicamente usando seus scripts PHP. Abaixo estão algumas das coisas que você pode fazer com a biblioteca PHPWord:

Defina as propriedades do documento, por exemplo, título, assunto e criador.
Crie seções de documentos com configurações diferentes, por exemplo, retrato/paisagem, tamanho de página e numeração de páginas
Crie cabeçalho e rodapé para cada seção
Definir tipo de fonte padrão, tamanho de fonte e estilo de parágrafo
Use fontes/caracteres UTF-8 e do Leste Asiático
Defina estilos de fonte personalizados (por exemplo, negrito, itálico, colorido) e estilos de parágrafo (por exemplo, centralizado, multicolunas, espaçamento) como estilo nomeado ou embutido no texto
Insira parágrafos, seja como um texto simples ou complexo (uma execução de texto) que contenha outros elementos
Insira títulos (cabeçalhos) e índice analítico
Insira quebras de texto e quebras de página
Insira e formate imagens, locais, remotas ou como marcas d'água de página
Insira objetos OLE binários, como Excel ou Visio
Inserir e formatar tabela com propriedades personalizadas para cada linha (por exemplo, repetir como linha de cabeçalho) e células (por exemplo, cor de fundo, rowspan, colspan)
Inserir itens da lista como marcadores, numerados ou multiníveis
Inserir hiperlinks
Inserir notas de rodapé e notas finais
Inserir formas de desenho (arco, curva, linha, polilinha, reto, oval)
Inserir gráficos (torta, rosca, barra, linha, área, dispersão, radar)
Inserir campos de formulário (entrada de texto, caixa de seleção e menu suspenso)
Criar documento a partir de modelos
Use folhas de estilo XSL 1.0 para transformar cabeçalhos, parte do documento principal e rodapés de um modelo OOXML
... e muitos mais recursos em progresso

Requisitos

PHPWord requer o seguinte:

PHP 7.1+
Extensão do analisador XML
Componente Lâminas Escaper
Extensão Zip (opcional, usada para escrever OOXML e ODF)
Extensão GD (opcional, usada para adicionar imagens)
Extensão XMLWriter (opcional, usada para escrever OOXML e ODF)
Extensão XSL (opcional, usada para aplicar folha de estilo XSL ao modelo)
biblioteca dompdf (opcional, usada para escrever PDF)

Instalação

PHPWord é instalado via Composer. Para adicionar uma dependência ao PHPWord em seu projeto,

Execute o seguinte para usar a versão estável mais recente

composer require phpoffice/phpword

ou se você quiser a versão mais recente não lançada

composer require phpoffice/phpword:dev-master

Começando

A seguir está um exemplo básico de uso da biblioteca 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. */

Mais exemplos são fornecidos na pasta de amostras. Para um acesso fácil a essas amostras, inicie php -S localhost:8000 no diretório de amostras e navegue até http://localhost:8000 para visualizar as amostras. Você também pode ler a documentação dos desenvolvedores para obter mais detalhes.