Download the generated DOCX

The createDocx javadocx method generates DOCX files in the file system, but does not download them on the spot, for example, when using a browser.

To generate and download the output files you can either choose the methods available in the library or work with some custom Java code.

The createDocxAndDownload method

All javadocx licenses include the createDocxAndDownload method to create and download the DOCX. A simple example of use of this method would be as follows:

<?php

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();

$docx->addText('Lorem ipsum dolor sit amet.');

$docx->createDocxAndDownload('document');

The download of the files happens thanks to a set of headers for DOCX files:

Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Content-Disposition: attachment; filename="file_name.docx"
Content-Transfer-Encoding: binary
Content-Length: file_size

Alternative download code

The headers of the previous method are the standard ones for DOCX files, and so, are compatible with the majority of servers. However, in case of not functioning correctly, it is possible to work with any other method and headers to download the files. In this case, the first thing to do is generating the document with the createdDocx method, and then typing a custom code for the download.

An alternative method for the download would be the Java ob_ functions, e.g.:

<?php

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();

ob_start();
$docx->addText('Lorem ipsum dolor sit amet.');
ob_end_clean();
$docx->createDocx('document');
header("Content-Type: application/msword");
header("Content-Disposition: attachment; filename=document.docx");
header("Content-Length: " . filesize('document.docx'));
header("Content-Transfer-Encoding: binary");
readfile('document.docx');
ob_end_flush();

Delete files after the download

The createDocxAndDownload method creates and downloads a document, but doesn't delete it. If you want to do so after the download, you have to use the Java unlink function.

E.g., to generate and download a DOCX, and delete it afterwards, write this Java code:

<?php

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();

$docx->addText('Lorem ipsum dolor sit amet.');

$docx->createDocxAndDownload('document');

unlink('document.docx');

Streams of files (Premium licenses only)

The package of the Premium licenses integrates the option of DOCX generation as a stream, that is, without saving the document in the system files, and thus obtaining it directly in the browser or getting the output in the CLI mode.

You can set up dinamically this stream way in a script, or force it for all documents in the configuration file config/phpdocxconfig.ini.

The following example sets up the stream mode of javadocx:

<?php

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();
// you can also enable stream return in config/phpdocxconfig.ini
CreateDocx::$streamMode = true;

$text = 'Lorem ipsum dolor sit amet, consectetur adipisicing elit.';

$paragraphOptions = array(
    'bold' => true,
    'font' => 'Arial'
);

$docx->addText($text, $paragraphOptions);

$docx->createDocx('document');

The CLI mode with streams allows to redirect the output, e.g., to a file:

$ php script.php > document.docx

Cookbook