StreamHandlerTest.php 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289
  1. <?php declare(strict_types=1);
  2. /*
  3. * This file is part of the Monolog package.
  4. *
  5. * (c) Jordi Boggiano <j.boggiano@seld.be>
  6. *
  7. * For the full copyright and license information, please view the LICENSE
  8. * file that was distributed with this source code.
  9. */
  10. namespace Monolog\Handler;
  11. use Monolog\Handler\StreamHandler;
  12. use Monolog\Test\TestCase;
  13. use Monolog\Logger;
  14. class StreamHandlerTest extends TestCase
  15. {
  16. /**
  17. * @covers Monolog\Handler\StreamHandler::__construct
  18. * @covers Monolog\Handler\StreamHandler::write
  19. */
  20. public function testWrite()
  21. {
  22. $handle = fopen('php://memory', 'a+');
  23. $handler = new StreamHandler($handle);
  24. $handler->setFormatter($this->getIdentityFormatter());
  25. $handler->handle($this->getRecord(Logger::WARNING, 'test'));
  26. $handler->handle($this->getRecord(Logger::WARNING, 'test2'));
  27. $handler->handle($this->getRecord(Logger::WARNING, 'test3'));
  28. fseek($handle, 0);
  29. $this->assertEquals('testtest2test3', fread($handle, 100));
  30. }
  31. /**
  32. * @covers Monolog\Handler\StreamHandler::close
  33. */
  34. public function testCloseKeepsExternalHandlersOpen()
  35. {
  36. $handle = fopen('php://memory', 'a+');
  37. $handler = new StreamHandler($handle);
  38. $this->assertTrue(is_resource($handle));
  39. $handler->close();
  40. $this->assertTrue(is_resource($handle));
  41. }
  42. /**
  43. * @covers Monolog\Handler\StreamHandler::close
  44. */
  45. public function testClose()
  46. {
  47. $handler = new StreamHandler('php://memory');
  48. $handler->handle($this->getRecord(Logger::WARNING, 'test'));
  49. $stream = $handler->getStream();
  50. $this->assertTrue(is_resource($stream));
  51. $handler->close();
  52. $this->assertFalse(is_resource($stream));
  53. }
  54. /**
  55. * @covers Monolog\Handler\StreamHandler::close
  56. * @covers Monolog\Handler\Handler::__sleep
  57. */
  58. public function testSerialization()
  59. {
  60. $handler = new StreamHandler('php://memory');
  61. $handler->handle($this->getRecord(Logger::WARNING, 'testfoo'));
  62. $stream = $handler->getStream();
  63. $this->assertTrue(is_resource($stream));
  64. fseek($stream, 0);
  65. $this->assertStringContainsString('testfoo', stream_get_contents($stream));
  66. $serialized = serialize($handler);
  67. $this->assertFalse(is_resource($stream));
  68. $handler = unserialize($serialized);
  69. $handler->handle($this->getRecord(Logger::WARNING, 'testbar'));
  70. $stream = $handler->getStream();
  71. $this->assertTrue(is_resource($stream));
  72. fseek($stream, 0);
  73. $contents = stream_get_contents($stream);
  74. $this->assertStringNotContainsString('testfoo', $contents);
  75. $this->assertStringContainsString('testbar', $contents);
  76. }
  77. /**
  78. * @covers Monolog\Handler\StreamHandler::write
  79. */
  80. public function testWriteCreatesTheStreamResource()
  81. {
  82. $handler = new StreamHandler('php://memory');
  83. $handler->handle($this->getRecord());
  84. }
  85. /**
  86. * @covers Monolog\Handler\StreamHandler::__construct
  87. * @covers Monolog\Handler\StreamHandler::write
  88. */
  89. public function testWriteLocking()
  90. {
  91. $temp = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'monolog_locked_log';
  92. $handler = new StreamHandler($temp, Logger::DEBUG, true, null, true);
  93. $handler->handle($this->getRecord());
  94. }
  95. /**
  96. * @covers Monolog\Handler\StreamHandler::__construct
  97. * @covers Monolog\Handler\StreamHandler::write
  98. */
  99. public function testWriteMissingResource()
  100. {
  101. $this->expectException(\LogicException::class);
  102. $handler = new StreamHandler(null);
  103. $handler->handle($this->getRecord());
  104. }
  105. public function invalidArgumentProvider()
  106. {
  107. return [
  108. [1],
  109. [[]],
  110. [['bogus://url']],
  111. ];
  112. }
  113. /**
  114. * @dataProvider invalidArgumentProvider
  115. * @covers Monolog\Handler\StreamHandler::__construct
  116. */
  117. public function testWriteInvalidArgument($invalidArgument)
  118. {
  119. $this->expectException(\InvalidArgumentException::class);
  120. $handler = new StreamHandler($invalidArgument);
  121. }
  122. /**
  123. * @covers Monolog\Handler\StreamHandler::__construct
  124. * @covers Monolog\Handler\StreamHandler::write
  125. */
  126. public function testWriteInvalidResource()
  127. {
  128. $this->expectException(\UnexpectedValueException::class);
  129. $this->expectExceptionMessage('The stream or file "bogus://url" could not be opened in append mode: Failed to open stream: No such file or directory'."\n".'The exception occurred while attempting to log: test'."\n".'Context: {"foo":"bar"}'."\n".'Extra: [1,2,3]');
  130. $handler = new StreamHandler('bogus://url');
  131. $record = $this->getRecord();
  132. $record['context'] = ['foo' => 'bar'];
  133. $record['extra'] = [1, 2, 3];
  134. $handler->handle($record);
  135. }
  136. /**
  137. * @covers Monolog\Handler\StreamHandler::__construct
  138. * @covers Monolog\Handler\StreamHandler::write
  139. */
  140. public function testWriteNonExistingResource()
  141. {
  142. $this->expectException(\UnexpectedValueException::class);
  143. $handler = new StreamHandler('ftp://foo/bar/baz/'.rand(0, 10000));
  144. $handler->handle($this->getRecord());
  145. }
  146. /**
  147. * @covers Monolog\Handler\StreamHandler::__construct
  148. * @covers Monolog\Handler\StreamHandler::write
  149. */
  150. public function testWriteNonExistingPath()
  151. {
  152. $handler = new StreamHandler(sys_get_temp_dir().'/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000));
  153. $handler->handle($this->getRecord());
  154. }
  155. /**
  156. * @covers Monolog\Handler\StreamHandler::__construct
  157. * @covers Monolog\Handler\StreamHandler::write
  158. */
  159. public function testWriteNonExistingFileResource()
  160. {
  161. $handler = new StreamHandler('file://'.sys_get_temp_dir().'/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000));
  162. $handler->handle($this->getRecord());
  163. }
  164. /**
  165. * @covers Monolog\Handler\StreamHandler::__construct
  166. * @covers Monolog\Handler\StreamHandler::write
  167. * @dataProvider provideNonExistingAndNotCreatablePath
  168. */
  169. public function testWriteNonExistingAndNotCreatablePath($nonExistingAndNotCreatablePath)
  170. {
  171. if (defined('PHP_WINDOWS_VERSION_BUILD')) {
  172. $this->markTestSkipped('Permissions checks can not run on windows');
  173. }
  174. $handler = null;
  175. try {
  176. $handler = new StreamHandler($nonExistingAndNotCreatablePath);
  177. } catch (\Exception $fail) {
  178. $this->fail(
  179. 'A non-existing and not creatable path should throw an Exception earliest on first write.
  180. Not during instantiation.'
  181. );
  182. }
  183. $this->expectException(\UnexpectedValueException::class);
  184. $this->expectExceptionMessage('There is no existing directory at');
  185. $handler->handle($this->getRecord());
  186. }
  187. public function provideNonExistingAndNotCreatablePath()
  188. {
  189. return [
  190. '/foo/bar/…' => [
  191. '/foo/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000),
  192. ],
  193. 'file:///foo/bar/…' => [
  194. 'file:///foo/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000),
  195. ],
  196. ];
  197. }
  198. public function provideMemoryValues()
  199. {
  200. return [
  201. ['1M', (int) (1024*1024/10)],
  202. ['10M', (int) (1024*1024)],
  203. ['1024M', (int) (1024*1024*1024/10)],
  204. ['1G', (int) (1024*1024*1024/10)],
  205. ['2000M', (int) (2000*1024*1024/10)],
  206. ['2050M', (int) (2050*1024*1024/10)],
  207. ['2048M', (int) (2048*1024*1024/10)],
  208. ['3G', (int) (3*1024*1024*1024/10)],
  209. ['2560M', (int) (2560*1024*1024/10)],
  210. ];
  211. }
  212. /**
  213. * @dataProvider provideMemoryValues
  214. * @return void
  215. */
  216. public function testPreventOOMError($phpMemory, $expectedChunkSize)
  217. {
  218. $previousValue = ini_set('memory_limit', $phpMemory);
  219. if ($previousValue === false) {
  220. $this->markTestSkipped('We could not set a memory limit that would trigger the error.');
  221. }
  222. $stream = tmpfile();
  223. if ($stream === false) {
  224. $this->markTestSkipped('We could not create a temp file to be use as a stream.');
  225. }
  226. $exceptionRaised = false;
  227. $handler = new StreamHandler($stream);
  228. stream_get_contents($stream, 1024);
  229. ini_set('memory_limit', $previousValue);
  230. $this->assertEquals($expectedChunkSize, $handler->getStreamChunkSize());
  231. }
  232. /**
  233. * @return void
  234. */
  235. public function testSimpleOOMPrevention()
  236. {
  237. $previousValue = ini_set('memory_limit', '2048M');
  238. if ($previousValue === false) {
  239. $this->markTestSkipped('We could not set a memory limit that would trigger the error.');
  240. }
  241. $stream = tmpfile();
  242. new StreamHandler($stream);
  243. stream_get_contents($stream);
  244. ini_set('memory_limit', $previousValue);
  245. $this->assertTrue(true);
  246. }
  247. }