Workbook.php 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427
  1. <?php
  2. namespace PhpOffice\PhpSpreadsheet\Writer\Xlsx;
  3. use PhpOffice\PhpSpreadsheet\Cell\Coordinate;
  4. use PhpOffice\PhpSpreadsheet\NamedRange;
  5. use PhpOffice\PhpSpreadsheet\Shared\Date;
  6. use PhpOffice\PhpSpreadsheet\Shared\XMLWriter;
  7. use PhpOffice\PhpSpreadsheet\Spreadsheet;
  8. use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
  9. use PhpOffice\PhpSpreadsheet\Writer\Exception as WriterException;
  10. class Workbook extends WriterPart
  11. {
  12. /**
  13. * Write workbook to XML format.
  14. *
  15. * @param Spreadsheet $spreadsheet
  16. * @param bool $recalcRequired Indicate whether formulas should be recalculated before writing
  17. *
  18. * @throws WriterException
  19. *
  20. * @return string XML Output
  21. */
  22. public function writeWorkbook(Spreadsheet $spreadsheet, $recalcRequired = false)
  23. {
  24. // Create XML writer
  25. if ($this->getParentWriter()->getUseDiskCaching()) {
  26. $objWriter = new XMLWriter(XMLWriter::STORAGE_DISK, $this->getParentWriter()->getDiskCachingDirectory());
  27. } else {
  28. $objWriter = new XMLWriter(XMLWriter::STORAGE_MEMORY);
  29. }
  30. // XML header
  31. $objWriter->startDocument('1.0', 'UTF-8', 'yes');
  32. // workbook
  33. $objWriter->startElement('workbook');
  34. $objWriter->writeAttribute('xml:space', 'preserve');
  35. $objWriter->writeAttribute('xmlns', 'http://schemas.openxmlformats.org/spreadsheetml/2006/main');
  36. $objWriter->writeAttribute('xmlns:r', 'http://schemas.openxmlformats.org/officeDocument/2006/relationships');
  37. // fileVersion
  38. $this->writeFileVersion($objWriter);
  39. // workbookPr
  40. $this->writeWorkbookPr($objWriter);
  41. // workbookProtection
  42. $this->writeWorkbookProtection($objWriter, $spreadsheet);
  43. // bookViews
  44. if ($this->getParentWriter()->getOffice2003Compatibility() === false) {
  45. $this->writeBookViews($objWriter, $spreadsheet);
  46. }
  47. // sheets
  48. $this->writeSheets($objWriter, $spreadsheet);
  49. // definedNames
  50. $this->writeDefinedNames($objWriter, $spreadsheet);
  51. // calcPr
  52. $this->writeCalcPr($objWriter, $recalcRequired);
  53. $objWriter->endElement();
  54. // Return
  55. return $objWriter->getData();
  56. }
  57. /**
  58. * Write file version.
  59. *
  60. * @param XMLWriter $objWriter XML Writer
  61. */
  62. private function writeFileVersion(XMLWriter $objWriter)
  63. {
  64. $objWriter->startElement('fileVersion');
  65. $objWriter->writeAttribute('appName', 'xl');
  66. $objWriter->writeAttribute('lastEdited', '4');
  67. $objWriter->writeAttribute('lowestEdited', '4');
  68. $objWriter->writeAttribute('rupBuild', '4505');
  69. $objWriter->endElement();
  70. }
  71. /**
  72. * Write WorkbookPr.
  73. *
  74. * @param XMLWriter $objWriter XML Writer
  75. */
  76. private function writeWorkbookPr(XMLWriter $objWriter)
  77. {
  78. $objWriter->startElement('workbookPr');
  79. if (Date::getExcelCalendar() == Date::CALENDAR_MAC_1904) {
  80. $objWriter->writeAttribute('date1904', '1');
  81. }
  82. $objWriter->writeAttribute('codeName', 'ThisWorkbook');
  83. $objWriter->endElement();
  84. }
  85. /**
  86. * Write BookViews.
  87. *
  88. * @param XMLWriter $objWriter XML Writer
  89. * @param Spreadsheet $spreadsheet
  90. */
  91. private function writeBookViews(XMLWriter $objWriter, Spreadsheet $spreadsheet)
  92. {
  93. // bookViews
  94. $objWriter->startElement('bookViews');
  95. // workbookView
  96. $objWriter->startElement('workbookView');
  97. $objWriter->writeAttribute('activeTab', $spreadsheet->getActiveSheetIndex());
  98. $objWriter->writeAttribute('autoFilterDateGrouping', '1');
  99. $objWriter->writeAttribute('firstSheet', '0');
  100. $objWriter->writeAttribute('minimized', '0');
  101. $objWriter->writeAttribute('showHorizontalScroll', '1');
  102. $objWriter->writeAttribute('showSheetTabs', '1');
  103. $objWriter->writeAttribute('showVerticalScroll', '1');
  104. $objWriter->writeAttribute('tabRatio', '600');
  105. $objWriter->writeAttribute('visibility', 'visible');
  106. $objWriter->endElement();
  107. $objWriter->endElement();
  108. }
  109. /**
  110. * Write WorkbookProtection.
  111. *
  112. * @param XMLWriter $objWriter XML Writer
  113. * @param Spreadsheet $spreadsheet
  114. */
  115. private function writeWorkbookProtection(XMLWriter $objWriter, Spreadsheet $spreadsheet)
  116. {
  117. if ($spreadsheet->getSecurity()->isSecurityEnabled()) {
  118. $objWriter->startElement('workbookProtection');
  119. $objWriter->writeAttribute('lockRevision', ($spreadsheet->getSecurity()->getLockRevision() ? 'true' : 'false'));
  120. $objWriter->writeAttribute('lockStructure', ($spreadsheet->getSecurity()->getLockStructure() ? 'true' : 'false'));
  121. $objWriter->writeAttribute('lockWindows', ($spreadsheet->getSecurity()->getLockWindows() ? 'true' : 'false'));
  122. if ($spreadsheet->getSecurity()->getRevisionsPassword() != '') {
  123. $objWriter->writeAttribute('revisionsPassword', $spreadsheet->getSecurity()->getRevisionsPassword());
  124. }
  125. if ($spreadsheet->getSecurity()->getWorkbookPassword() != '') {
  126. $objWriter->writeAttribute('workbookPassword', $spreadsheet->getSecurity()->getWorkbookPassword());
  127. }
  128. $objWriter->endElement();
  129. }
  130. }
  131. /**
  132. * Write calcPr.
  133. *
  134. * @param XMLWriter $objWriter XML Writer
  135. * @param bool $recalcRequired Indicate whether formulas should be recalculated before writing
  136. */
  137. private function writeCalcPr(XMLWriter $objWriter, $recalcRequired = true)
  138. {
  139. $objWriter->startElement('calcPr');
  140. // Set the calcid to a higher value than Excel itself will use, otherwise Excel will always recalc
  141. // If MS Excel does do a recalc, then users opening a file in MS Excel will be prompted to save on exit
  142. // because the file has changed
  143. $objWriter->writeAttribute('calcId', '999999');
  144. $objWriter->writeAttribute('calcMode', 'auto');
  145. // fullCalcOnLoad isn't needed if we've recalculating for the save
  146. $objWriter->writeAttribute('calcCompleted', ($recalcRequired) ? 1 : 0);
  147. $objWriter->writeAttribute('fullCalcOnLoad', ($recalcRequired) ? 0 : 1);
  148. $objWriter->endElement();
  149. }
  150. /**
  151. * Write sheets.
  152. *
  153. * @param XMLWriter $objWriter XML Writer
  154. * @param Spreadsheet $spreadsheet
  155. *
  156. * @throws WriterException
  157. */
  158. private function writeSheets(XMLWriter $objWriter, Spreadsheet $spreadsheet)
  159. {
  160. // Write sheets
  161. $objWriter->startElement('sheets');
  162. $sheetCount = $spreadsheet->getSheetCount();
  163. for ($i = 0; $i < $sheetCount; ++$i) {
  164. // sheet
  165. $this->writeSheet(
  166. $objWriter,
  167. $spreadsheet->getSheet($i)->getTitle(),
  168. ($i + 1),
  169. ($i + 1 + 3),
  170. $spreadsheet->getSheet($i)->getSheetState()
  171. );
  172. }
  173. $objWriter->endElement();
  174. }
  175. /**
  176. * Write sheet.
  177. *
  178. * @param XMLWriter $objWriter XML Writer
  179. * @param string $pSheetname Sheet name
  180. * @param int $pSheetId Sheet id
  181. * @param int $pRelId Relationship ID
  182. * @param string $sheetState Sheet state (visible, hidden, veryHidden)
  183. *
  184. * @throws WriterException
  185. */
  186. private function writeSheet(XMLWriter $objWriter, $pSheetname, $pSheetId = 1, $pRelId = 1, $sheetState = 'visible')
  187. {
  188. if ($pSheetname != '') {
  189. // Write sheet
  190. $objWriter->startElement('sheet');
  191. $objWriter->writeAttribute('name', $pSheetname);
  192. $objWriter->writeAttribute('sheetId', $pSheetId);
  193. if ($sheetState != 'visible' && $sheetState != '') {
  194. $objWriter->writeAttribute('state', $sheetState);
  195. }
  196. $objWriter->writeAttribute('r:id', 'rId' . $pRelId);
  197. $objWriter->endElement();
  198. } else {
  199. throw new WriterException('Invalid parameters passed.');
  200. }
  201. }
  202. /**
  203. * Write Defined Names.
  204. *
  205. * @param XMLWriter $objWriter XML Writer
  206. * @param Spreadsheet $spreadsheet
  207. *
  208. * @throws WriterException
  209. */
  210. private function writeDefinedNames(XMLWriter $objWriter, Spreadsheet $spreadsheet)
  211. {
  212. // Write defined names
  213. $objWriter->startElement('definedNames');
  214. // Named ranges
  215. if (count($spreadsheet->getNamedRanges()) > 0) {
  216. // Named ranges
  217. $this->writeNamedRanges($objWriter, $spreadsheet);
  218. }
  219. // Other defined names
  220. $sheetCount = $spreadsheet->getSheetCount();
  221. for ($i = 0; $i < $sheetCount; ++$i) {
  222. // definedName for autoFilter
  223. $this->writeDefinedNameForAutofilter($objWriter, $spreadsheet->getSheet($i), $i);
  224. // definedName for Print_Titles
  225. $this->writeDefinedNameForPrintTitles($objWriter, $spreadsheet->getSheet($i), $i);
  226. // definedName for Print_Area
  227. $this->writeDefinedNameForPrintArea($objWriter, $spreadsheet->getSheet($i), $i);
  228. }
  229. $objWriter->endElement();
  230. }
  231. /**
  232. * Write named ranges.
  233. *
  234. * @param XMLWriter $objWriter XML Writer
  235. * @param Spreadsheet $spreadsheet
  236. *
  237. * @throws WriterException
  238. */
  239. private function writeNamedRanges(XMLWriter $objWriter, Spreadsheet $spreadsheet)
  240. {
  241. // Loop named ranges
  242. $namedRanges = $spreadsheet->getNamedRanges();
  243. foreach ($namedRanges as $namedRange) {
  244. $this->writeDefinedNameForNamedRange($objWriter, $namedRange);
  245. }
  246. }
  247. /**
  248. * Write Defined Name for named range.
  249. *
  250. * @param XMLWriter $objWriter XML Writer
  251. * @param NamedRange $pNamedRange
  252. */
  253. private function writeDefinedNameForNamedRange(XMLWriter $objWriter, NamedRange $pNamedRange)
  254. {
  255. // definedName for named range
  256. $objWriter->startElement('definedName');
  257. $objWriter->writeAttribute('name', $pNamedRange->getName());
  258. if ($pNamedRange->getLocalOnly()) {
  259. $objWriter->writeAttribute('localSheetId', $pNamedRange->getScope()->getParent()->getIndex($pNamedRange->getScope()));
  260. }
  261. // Create absolute coordinate and write as raw text
  262. $range = Coordinate::splitRange($pNamedRange->getRange());
  263. $iMax = count($range);
  264. for ($i = 0; $i < $iMax; ++$i) {
  265. $range[$i][0] = '\'' . str_replace("'", "''", $pNamedRange->getWorksheet()->getTitle()) . '\'!' . Coordinate::absoluteReference($range[$i][0]);
  266. if (isset($range[$i][1])) {
  267. $range[$i][1] = Coordinate::absoluteReference($range[$i][1]);
  268. }
  269. }
  270. $range = Coordinate::buildRange($range);
  271. $objWriter->writeRawData($range);
  272. $objWriter->endElement();
  273. }
  274. /**
  275. * Write Defined Name for autoFilter.
  276. *
  277. * @param XMLWriter $objWriter XML Writer
  278. * @param Worksheet $pSheet
  279. * @param int $pSheetId
  280. */
  281. private function writeDefinedNameForAutofilter(XMLWriter $objWriter, Worksheet $pSheet, $pSheetId = 0)
  282. {
  283. // definedName for autoFilter
  284. $autoFilterRange = $pSheet->getAutoFilter()->getRange();
  285. if (!empty($autoFilterRange)) {
  286. $objWriter->startElement('definedName');
  287. $objWriter->writeAttribute('name', '_xlnm._FilterDatabase');
  288. $objWriter->writeAttribute('localSheetId', $pSheetId);
  289. $objWriter->writeAttribute('hidden', '1');
  290. // Create absolute coordinate and write as raw text
  291. $range = Coordinate::splitRange($autoFilterRange);
  292. $range = $range[0];
  293. // Strip any worksheet ref so we can make the cell ref absolute
  294. if (strpos($range[0], '!') !== false) {
  295. list($ws, $range[0]) = explode('!', $range[0]);
  296. }
  297. $range[0] = Coordinate::absoluteCoordinate($range[0]);
  298. $range[1] = Coordinate::absoluteCoordinate($range[1]);
  299. $range = implode(':', $range);
  300. $objWriter->writeRawData('\'' . str_replace("'", "''", $pSheet->getTitle()) . '\'!' . $range);
  301. $objWriter->endElement();
  302. }
  303. }
  304. /**
  305. * Write Defined Name for PrintTitles.
  306. *
  307. * @param XMLWriter $objWriter XML Writer
  308. * @param Worksheet $pSheet
  309. * @param int $pSheetId
  310. */
  311. private function writeDefinedNameForPrintTitles(XMLWriter $objWriter, Worksheet $pSheet, $pSheetId = 0)
  312. {
  313. // definedName for PrintTitles
  314. if ($pSheet->getPageSetup()->isColumnsToRepeatAtLeftSet() || $pSheet->getPageSetup()->isRowsToRepeatAtTopSet()) {
  315. $objWriter->startElement('definedName');
  316. $objWriter->writeAttribute('name', '_xlnm.Print_Titles');
  317. $objWriter->writeAttribute('localSheetId', $pSheetId);
  318. // Setting string
  319. $settingString = '';
  320. // Columns to repeat
  321. if ($pSheet->getPageSetup()->isColumnsToRepeatAtLeftSet()) {
  322. $repeat = $pSheet->getPageSetup()->getColumnsToRepeatAtLeft();
  323. $settingString .= '\'' . str_replace("'", "''", $pSheet->getTitle()) . '\'!$' . $repeat[0] . ':$' . $repeat[1];
  324. }
  325. // Rows to repeat
  326. if ($pSheet->getPageSetup()->isRowsToRepeatAtTopSet()) {
  327. if ($pSheet->getPageSetup()->isColumnsToRepeatAtLeftSet()) {
  328. $settingString .= ',';
  329. }
  330. $repeat = $pSheet->getPageSetup()->getRowsToRepeatAtTop();
  331. $settingString .= '\'' . str_replace("'", "''", $pSheet->getTitle()) . '\'!$' . $repeat[0] . ':$' . $repeat[1];
  332. }
  333. $objWriter->writeRawData($settingString);
  334. $objWriter->endElement();
  335. }
  336. }
  337. /**
  338. * Write Defined Name for PrintTitles.
  339. *
  340. * @param XMLWriter $objWriter XML Writer
  341. * @param Worksheet $pSheet
  342. * @param int $pSheetId
  343. */
  344. private function writeDefinedNameForPrintArea(XMLWriter $objWriter, Worksheet $pSheet, $pSheetId = 0)
  345. {
  346. // definedName for PrintArea
  347. if ($pSheet->getPageSetup()->isPrintAreaSet()) {
  348. $objWriter->startElement('definedName');
  349. $objWriter->writeAttribute('name', '_xlnm.Print_Area');
  350. $objWriter->writeAttribute('localSheetId', $pSheetId);
  351. // Print area
  352. $printArea = Coordinate::splitRange($pSheet->getPageSetup()->getPrintArea());
  353. $chunks = [];
  354. foreach ($printArea as $printAreaRect) {
  355. $printAreaRect[0] = Coordinate::absoluteReference($printAreaRect[0]);
  356. $printAreaRect[1] = Coordinate::absoluteReference($printAreaRect[1]);
  357. $chunks[] = '\'' . str_replace("'", "''", $pSheet->getTitle()) . '\'!' . implode(':', $printAreaRect);
  358. }
  359. $objWriter->writeRawData(implode(',', $chunks));
  360. $objWriter->endElement();
  361. }
  362. }
  363. }