ggggino/wordbundle

This is a Symfony2 Bundle helps you to read and write Word files, thanks to the PHPWord library

Symfony2 Word bundle

This bundle is a wrapper of the library PHPOffice/PHPWord., _(*1)

For the complete reference look at the PHPWord Docs. PHPWord Docs, _(*2)

License

, _(*3)

Installation

1 Add to composer.json to the require key, _(*4)

``` shell $composer require ggggino/wordbundle, <sub>(*5)</sub>

**2** Register the bundle in ``app/AppKernel.php``

``` php
    $bundles = array(
        // ...
        new GGGGino\WordBundle\GGGGinoWordBundle(),
    );

Get started

• Create an empty object:

``` php $phpWordObject = $this->get('phpword')->createPHPWordObject();, <sub>(*6)</sub>

- Create a Word and write to a file given the object:

```php
$writer = $this->get('phpword')->createWriter($phpWordObject, 'Word2007');
$writer->save('file.xls');

• Create a Word and create a StreamedResponse:

$writer = $this->get('phpword')->createWriter($phpWordObject, 'Word2007');
$response = $this->get('phpword')->createStreamedResponse($writer);

Not Only 'Word2007'

The list of the types are:, <sub>(*7)</sub>

1. 'Word2007'
2. 'ODText'
3. 'HTML'
4. 'PDF'
5. 'RTF'

Example

You could find a lot of examples in the official PHPWord repository https://github.com/PHPOffice/PHPWord/tree/develop/samples, <sub>(*8)</sub>

Create a new doc

``` php namespace YOURNAME\YOURBUNDLE\Controller;, <sub>(*9)</sub>

use Symfony\Bundle\FrameworkBundle\Controller\Controller; use Symfony\Component\HttpFoundation\ResponseHeaderBag;, <sub>(*10)</sub>

class DefaultController extends Controller {, <sub>(*11)</sub>

public function indexAction($name)
{
    // ask the service for a Word2007
    $phpWordObject = $this->get('phpword')->createPHPWordObject();

    // Create a new Page
    $section = $phpWordObject->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)'
    );

    // create the writer
    $writer = $this->get('phpword')->createWriter($phpWordObject, 'Word2007');
    // create the response
    $response = $this->get('phpword')->createStreamedResponse($writer);
    // adding headers
    $dispositionHeader = $response->headers->makeDisposition(
        ResponseHeaderBag::DISPOSITION_ATTACHMENT,
        'stream-file.doc'
    );
    $response->headers->set('Content-Type', 'application/msword');
    $response->headers->set('Pragma', 'public');
    $response->headers->set('Cache-Control', 'maxage=1');
    $response->headers->set('Content-Disposition', $dispositionHeader);

    return $response;        
}

}, <sub>(*12)</sub>

### Edit a doc

In the template file(docx) variable should be declared as ${var1}, so in the template you can change "var1" value in this way:
```php
$phpTemplateObject->setValue('var1', 'testValue');

Complete example, <sub>(*13)</sub>

``` php namespace YOURNAME\YOURBUNDLE\Controller;, <sub>(*14)</sub>

use Symfony\Bundle\FrameworkBundle\Controller\Controller; use Symfony\Component\HttpFoundation\ResponseHeaderBag;, <sub>(*15)</sub>

class DefaultController extends Controller {, <sub>(*16)</sub>

public function indexAction($name)
{
  $fileName = ".../../test.docx";

    // ask the service for a Word2007
    $phpTemplateObject = $this->get('phpword')->createTemplateObject($fileName);

    $phpTemplateObject->setValue('test', 'testValue');

    $phpWordObject = $this->get('phpword')->getPhpWordObjFromTemplate($phpTemplateObject);

    // create the writer
    $writer = $this->get('phpword')->createWriter($phpWordObject, 'Word2007');
    // create the response
    $response = $this->get('phpword')->createStreamedResponse($writer);
    // adding headers
    $dispositionHeader = $response->headers->makeDisposition(
        ResponseHeaderBag::DISPOSITION_ATTACHMENT,
        'stream-file.docx'
    );
    $response->headers->set('Content-Type', 'application/msword');
    $response->headers->set('Pragma', 'public');
    $response->headers->set('Cache-Control', 'maxage=1');
    $response->headers->set('Content-Disposition', $dispositionHeader);

    return $response;        
}

} ```, <sub>(*17)</sub>

Contribute

1. fork the project
2. clone the repo
3. submit a PullRequest