#238: Known issue about read/write permission on temp folder

CHANGELOG.md

@@ -18,7 +18,7 @@ None yet.
 
 ### Miscellaneous
 
-None yet.
+- Docs: Add known issue on `README` about requirement for temporary folder to be writable and update `samples/index.php` for this requirement check - @ivanlanin GH-238
 
 ## 0.11.1 - 2 June 2014
 

README.md

@@ -111,6 +111,10 @@ $objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'RTF');
 $objWriter->save('helloWorld.rtf');
 ```
 
+## Known issues
+
+- GH-238: PHPWord uses temporary folder with `sys_get_temp_dir()` extensively. The default setting on some systems (especially Windows) do not give appropriate read/write permission to this folder. Run `samples/index.php` either by CLI or by web browsers to check if you have this requirement fulfilled.
+
 ## Contributing
 
 We welcome everyone to contribute to PHPWord. Below are some of the things that you can do to contribute:

samples/index.php

@@ -3,6 +3,7 @@
 $requirements = array(
  'php' => array('PHP 5.3.0', version_compare(phpversion(), '5.3.0', '>=')),
  'xml' => array('PHP extension XML', extension_loaded('xml')),
+ 'temp' => array('Temp folder "<code>' . sys_get_temp_dir() . '</code>" is writable', is_writable(sys_get_temp_dir())),
  'zip' => array('PHP extension ZipArchive (optional)', extension_loaded('zip')),
  'gd' => array('PHP extension GD (optional)', extension_loaded('gd')),
  'xmlw' => array('PHP extension XMLWriter (optional)', extension_loaded('xmlwriter')),
@@ -34,6 +35,7 @@
  echo 'Requirement check:' . PHP_EOL;
  foreach ($requirements as $key => $value) {
  list($label, $result) = $value;
+ $label = strip_tags($label);
  $status = $result ? '32m passed' : '31m failed';
  echo "{$label} ... \033[{$status}\033[0m" . PHP_EOL;
  }