DefinedNameTest.php 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219
  1. <?php
  2. namespace PhpOffice\PhpSpreadsheetTests;
  3. use PhpOffice\PhpSpreadsheet\DefinedName;
  4. use PhpOffice\PhpSpreadsheet\NamedRange;
  5. use PhpOffice\PhpSpreadsheet\Spreadsheet;
  6. use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
  7. use PHPUnit\Framework\TestCase;
  8. class DefinedNameTest extends TestCase
  9. {
  10. /** @var Spreadsheet */
  11. private $spreadsheet;
  12. protected function setUp(): void
  13. {
  14. parent::setUp();
  15. $this->spreadsheet = new Spreadsheet();
  16. $this->spreadsheet->getActiveSheet()
  17. ->setTitle('Sheet #1');
  18. $worksheet2 = new Worksheet();
  19. $worksheet2->setTitle('Sheet #2');
  20. $this->spreadsheet->addSheet($worksheet2);
  21. $this->spreadsheet->setActiveSheetIndex(0);
  22. }
  23. public function testAddDefinedName(): void
  24. {
  25. $this->spreadsheet->addDefinedName(
  26. DefinedName::createInstance('Foo', $this->spreadsheet->getActiveSheet(), '=A1')
  27. );
  28. self::assertCount(1, $this->spreadsheet->getDefinedNames());
  29. }
  30. public function testAddDuplicateDefinedName(): void
  31. {
  32. $this->spreadsheet->addDefinedName(
  33. DefinedName::createInstance('Foo', $this->spreadsheet->getActiveSheet(), '=A1')
  34. );
  35. $this->spreadsheet->addDefinedName(
  36. DefinedName::createInstance('FOO', $this->spreadsheet->getActiveSheet(), '=B1')
  37. );
  38. self::assertCount(1, $this->spreadsheet->getDefinedNames());
  39. $definedName = $this->spreadsheet->getDefinedName('foo', $this->spreadsheet->getActiveSheet());
  40. self::assertNotNull($definedName);
  41. self::assertSame('=B1', $definedName->getValue());
  42. }
  43. public function testAddScopedDefinedNameWithSameName(): void
  44. {
  45. $this->spreadsheet->addDefinedName(
  46. DefinedName::createInstance('Foo', $this->spreadsheet->getActiveSheet(), '=A1')
  47. );
  48. $this->spreadsheet->addDefinedName(
  49. DefinedName::createInstance('FOO', $this->spreadsheet->getSheetByNameOrThrow('Sheet #2'), '=B1', true)
  50. );
  51. self::assertCount(2, $this->spreadsheet->getDefinedNames());
  52. $definedName1 = $this->spreadsheet->getDefinedName('foo', $this->spreadsheet->getActiveSheet());
  53. self::assertNotNull($definedName1);
  54. self::assertSame('=A1', $definedName1->getValue());
  55. $definedName2 = $this->spreadsheet->getDefinedName('foo', $this->spreadsheet->getSheetByNameOrThrow('Sheet #2'));
  56. self::assertNotNull($definedName2);
  57. self::assertSame('=B1', $definedName2->getValue());
  58. }
  59. public function testRemoveDefinedName(): void
  60. {
  61. $this->spreadsheet->addDefinedName(
  62. DefinedName::createInstance('Foo', $this->spreadsheet->getActiveSheet(), '=A1')
  63. );
  64. $this->spreadsheet->addDefinedName(
  65. DefinedName::createInstance('Bar', $this->spreadsheet->getActiveSheet(), '=B1')
  66. );
  67. $this->spreadsheet->removeDefinedName('Foo', $this->spreadsheet->getActiveSheet());
  68. self::assertCount(1, $this->spreadsheet->getDefinedNames());
  69. }
  70. public function testRemoveGlobalDefinedName(): void
  71. {
  72. $this->spreadsheet->addDefinedName(
  73. DefinedName::createInstance('Any', $this->spreadsheet->getActiveSheet(), '=A1')
  74. );
  75. self::assertCount(1, $this->spreadsheet->getDefinedNames());
  76. $this->spreadsheet->removeDefinedName('Any');
  77. self::assertCount(0, $this->spreadsheet->getDefinedNames());
  78. $this->spreadsheet->removeDefinedName('Other');
  79. }
  80. public function testRemoveGlobalDefinedNameWhenDuplicateNames(): void
  81. {
  82. $this->spreadsheet->addDefinedName(
  83. DefinedName::createInstance('Foo', $this->spreadsheet->getActiveSheet(), '=A1')
  84. );
  85. $this->spreadsheet->addDefinedName(
  86. DefinedName::createInstance('FOO', $this->spreadsheet->getSheetByNameOrThrow('Sheet #2'), '=B1', true)
  87. );
  88. $this->spreadsheet->removeDefinedName('Foo', $this->spreadsheet->getActiveSheet());
  89. self::assertCount(1, $this->spreadsheet->getDefinedNames());
  90. $definedName = $this->spreadsheet->getDefinedName('foo', $this->spreadsheet->getSheetByNameOrThrow('Sheet #2'));
  91. self::assertNotNull($definedName);
  92. self::assertSame('=B1', $definedName->getValue());
  93. }
  94. public function testRemoveScopedDefinedNameWhenDuplicateNames(): void
  95. {
  96. $this->spreadsheet->addDefinedName(
  97. DefinedName::createInstance('Foo', $this->spreadsheet->getActiveSheet(), '=A1')
  98. );
  99. $this->spreadsheet->addDefinedName(
  100. DefinedName::createInstance('FOO', $this->spreadsheet->getSheetByNameOrThrow('Sheet #2'), '=B1', true)
  101. );
  102. $this->spreadsheet->removeDefinedName('Foo', $this->spreadsheet->getSheetByNameOrThrow('Sheet #2'));
  103. self::assertCount(1, $this->spreadsheet->getDefinedNames());
  104. $definedName = $this->spreadsheet->getDefinedName('foo');
  105. self::assertNotNull($definedName);
  106. self::assertSame('=A1', $definedName->getValue());
  107. }
  108. public function testDefinedNameNoWorksheetNoScope(): void
  109. {
  110. $this->expectException(\PhpOffice\PhpSpreadsheet\Exception::class);
  111. new NamedRange('xyz');
  112. }
  113. public function testSetAndGetRange(): void
  114. {
  115. $this->spreadsheet->addDefinedName(
  116. DefinedName::createInstance('xyz', $this->spreadsheet->getActiveSheet(), 'A1')
  117. );
  118. /** @var NamedRange $namedRange */
  119. $namedRange = $this->spreadsheet->getDefinedName('XYZ');
  120. self::assertInstanceOf(NamedRange::class, $namedRange);
  121. self::assertEquals('A1', $namedRange->getRange());
  122. self::assertEquals('A1', $namedRange->getValue());
  123. $namedRange->setRange('A2');
  124. self::assertEquals('A2', $namedRange->getValue());
  125. }
  126. public function testChangeWorksheet(): void
  127. {
  128. $sheet1 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #1');
  129. $sheet2 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #2');
  130. $sheet1->getCell('A1')->setValue(1);
  131. $sheet2->getCell('A1')->setValue(2);
  132. $namedRange = new NamedRange('xyz', $sheet2, '$A$1');
  133. $namedRange->setWorksheet($sheet1);
  134. $this->spreadsheet->addNamedRange($namedRange);
  135. $sheet1->getCell('B2')->setValue('=XYZ');
  136. self::assertEquals(1, $sheet1->getCell('B2')->getCalculatedValue());
  137. $sheet2->getCell('B2')->setValue('=XYZ');
  138. self::assertEquals(1, $sheet2->getCell('B2')->getCalculatedValue());
  139. }
  140. public function testLocalOnly(): void
  141. {
  142. $sheet1 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #1');
  143. $sheet2 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #2');
  144. $sheet1->getCell('A1')->setValue(1);
  145. $sheet2->getCell('A1')->setValue(2);
  146. $namedRange = new NamedRange('abc', $sheet2, '$A$1');
  147. $namedRange->setWorksheet($sheet1)->setLocalOnly(true);
  148. $this->spreadsheet->addNamedRange($namedRange);
  149. $sheet1->getCell('C2')->setValue('=ABC');
  150. self::assertEquals(1, $sheet1->getCell('C2')->getCalculatedValue());
  151. $sheet2->getCell('C2')->setValue('=ABC');
  152. self::assertEquals('#NAME?', $sheet2->getCell('C2')->getCalculatedValue());
  153. }
  154. public function testScope(): void
  155. {
  156. $sheet1 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #1');
  157. $sheet2 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #2');
  158. $sheet1->getCell('A1')->setValue(1);
  159. $sheet2->getCell('A1')->setValue(2);
  160. $namedRange = new NamedRange('abc', $sheet2, '$A$1');
  161. $namedRange->setScope($sheet1);
  162. $this->spreadsheet->addNamedRange($namedRange);
  163. $sheet1->getCell('C2')->setValue('=ABC');
  164. self::assertEquals(2, $sheet1->getCell('C2')->getCalculatedValue());
  165. $sheet2->getCell('C2')->setValue('=ABC');
  166. self::assertEquals('#NAME?', $sheet2->getCell('C2')->getCalculatedValue());
  167. }
  168. public function testClone(): void
  169. {
  170. $sheet1 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #1');
  171. $sheet2 = $this->spreadsheet->getSheetByNameOrThrow('Sheet #2');
  172. $sheet1->getCell('A1')->setValue(1);
  173. $sheet2->getCell('A1')->setValue(2);
  174. $namedRange = new NamedRange('abc', $sheet2, '$A$1');
  175. $namedRangeClone = clone $namedRange;
  176. $ss1 = $namedRange->getWorksheet();
  177. $ss2 = $namedRangeClone->getWorksheet();
  178. self::assertNotNull($ss1);
  179. self::assertNotNull($ss2);
  180. self::assertNotSame($ss1, $ss2);
  181. self::assertEquals($ss1->getTitle(), $ss2->getTitle());
  182. }
  183. }