StreamHandlerTest.php 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  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
  130. The exception occurred while attempting to log: test
  131. Context: {"foo":"bar"}
  132. Extra: [1,2,3]');
  133. $handler = new StreamHandler('bogus://url');
  134. $record = $this->getRecord();
  135. $record['context'] = ['foo' => 'bar'];
  136. $record['extra'] = [1, 2, 3];
  137. $handler->handle($record);
  138. }
  139. /**
  140. * @covers Monolog\Handler\StreamHandler::__construct
  141. * @covers Monolog\Handler\StreamHandler::write
  142. */
  143. public function testWriteNonExistingResource()
  144. {
  145. $this->expectException(\UnexpectedValueException::class);
  146. $handler = new StreamHandler('ftp://foo/bar/baz/'.rand(0, 10000));
  147. $handler->handle($this->getRecord());
  148. }
  149. /**
  150. * @covers Monolog\Handler\StreamHandler::__construct
  151. * @covers Monolog\Handler\StreamHandler::write
  152. */
  153. public function testWriteNonExistingPath()
  154. {
  155. $handler = new StreamHandler(sys_get_temp_dir().'/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000));
  156. $handler->handle($this->getRecord());
  157. }
  158. /**
  159. * @covers Monolog\Handler\StreamHandler::__construct
  160. * @covers Monolog\Handler\StreamHandler::write
  161. */
  162. public function testWriteNonExistingFileResource()
  163. {
  164. $handler = new StreamHandler('file://'.sys_get_temp_dir().'/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000));
  165. $handler->handle($this->getRecord());
  166. }
  167. /**
  168. * @covers Monolog\Handler\StreamHandler::__construct
  169. * @covers Monolog\Handler\StreamHandler::write
  170. * @dataProvider provideNonExistingAndNotCreatablePath
  171. */
  172. public function testWriteNonExistingAndNotCreatablePath($nonExistingAndNotCreatablePath)
  173. {
  174. if (defined('PHP_WINDOWS_VERSION_BUILD')) {
  175. $this->markTestSkipped('Permissions checks can not run on windows');
  176. }
  177. $handler = null;
  178. try {
  179. $handler = new StreamHandler($nonExistingAndNotCreatablePath);
  180. } catch (\Exception $fail) {
  181. $this->fail(
  182. 'A non-existing and not creatable path should throw an Exception earliest on first write.
  183. Not during instantiation.'
  184. );
  185. }
  186. $this->expectException(\UnexpectedValueException::class);
  187. $this->expectExceptionMessage('There is no existing directory at');
  188. $handler->handle($this->getRecord());
  189. }
  190. public function provideNonExistingAndNotCreatablePath()
  191. {
  192. return [
  193. '/foo/bar/…' => [
  194. '/foo/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000),
  195. ],
  196. 'file:///foo/bar/…' => [
  197. 'file:///foo/bar/'.rand(0, 10000).DIRECTORY_SEPARATOR.rand(0, 10000),
  198. ],
  199. ];
  200. }
  201. public function provideMemoryValues()
  202. {
  203. return [
  204. ['1M', (int) (1024*1024/10)],
  205. ['10M', (int) (1024*1024)],
  206. ['1024M', (int) (1024*1024*1024/10)],
  207. ['1G', (int) (1024*1024*1024/10)],
  208. ['2000M', (int) (2000*1024*1024/10)],
  209. ['2050M', (int) (2050*1024*1024/10)],
  210. ['2048M', (int) (2048*1024*1024/10)],
  211. ['3G', (int) (3*1024*1024*1024/10)],
  212. ['2560M', (int) (2560*1024*1024/10)],
  213. ];
  214. }
  215. /**
  216. * @dataProvider provideMemoryValues
  217. * @return void
  218. */
  219. public function testPreventOOMError($phpMemory, $expectedChunkSize)
  220. {
  221. $previousValue = ini_set('memory_limit', $phpMemory);
  222. if ($previousValue === false) {
  223. $this->markTestSkipped('We could not set a memory limit that would trigger the error.');
  224. }
  225. $stream = tmpfile();
  226. if ($stream === false) {
  227. $this->markTestSkipped('We could not create a temp file to be use as a stream.');
  228. }
  229. $exceptionRaised = false;
  230. $handler = new StreamHandler($stream);
  231. stream_get_contents($stream, 1024);
  232. ini_set('memory_limit', $previousValue);
  233. $this->assertEquals($expectedChunkSize, $handler->getStreamChunkSize());
  234. }
  235. /**
  236. * @return void
  237. */
  238. public function testSimpleOOMPrevention()
  239. {
  240. $previousValue = ini_set('memory_limit', '2048M');
  241. if ($previousValue === false) {
  242. $this->markTestSkipped('We could not set a memory limit that would trigger the error.');
  243. }
  244. $stream = tmpfile();
  245. new StreamHandler($stream);
  246. stream_get_contents($stream);
  247. ini_set('memory_limit', $previousValue);
  248. $this->assertTrue(true);
  249. }
  250. }