ServerTest.php 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511
  1. <?php
  2. /**
  3. * Test case for Server.
  4. * Note that this test is performed by mocking socket/stream calls.
  5. */
  6. declare(strict_types=1);
  7. namespace WebSocket;
  8. use ErrorException;
  9. use Phrity\Util\ErrorHandler;
  10. use PHPUnit\Framework\TestCase;
  11. class ServerTest extends TestCase
  12. {
  13. public function setUp(): void
  14. {
  15. error_reporting(-1);
  16. }
  17. public function testServerMasked(): void
  18. {
  19. MockSocket::initialize('server.construct', $this);
  20. $server = new Server();
  21. $this->assertTrue(MockSocket::isEmpty());
  22. MockSocket::initialize('server.accept', $this);
  23. $server->accept();
  24. $server->send('Connect');
  25. $this->assertEquals(8000, $server->getPort());
  26. $this->assertEquals('/my/mock/path', $server->getPath());
  27. $this->assertTrue($server->isConnected());
  28. $this->assertEquals(4096, $server->getFragmentSize());
  29. $this->assertNull($server->getCloseStatus());
  30. $this->assertEquals([
  31. 'GET /my/mock/path HTTP/1.1',
  32. 'host: localhost:8000',
  33. 'user-agent: websocket-client-php',
  34. 'connection: Upgrade',
  35. 'upgrade: websocket',
  36. 'sec-websocket-key: cktLWXhUdDQ2OXF0ZCFqOQ==',
  37. 'sec-websocket-version: 13',
  38. '',
  39. '',
  40. ], $server->getRequest());
  41. $this->assertEquals('websocket-client-php', $server->getHeader('USER-AGENT'));
  42. $this->assertNull($server->getHeader('no such header'));
  43. $this->assertTrue(MockSocket::isEmpty());
  44. MockSocket::initialize('send-receive', $this);
  45. $server->send('Sending a message');
  46. $message = $server->receive();
  47. $this->assertEquals('Receiving a message', $message);
  48. $this->assertTrue(MockSocket::isEmpty());
  49. $this->assertNull($server->getCloseStatus());
  50. $this->assertEquals('text', $server->getLastOpcode());
  51. MockSocket::initialize('server.close', $this);
  52. $server->close();
  53. $this->assertFalse($server->isConnected());
  54. $this->assertEquals(1000, $server->getCloseStatus());
  55. $this->assertTrue(MockSocket::isEmpty());
  56. $server->close(); // Already closed
  57. }
  58. public function testDestruct(): void
  59. {
  60. MockSocket::initialize('server.construct', $this);
  61. $server = new Server();
  62. MockSocket::initialize('server.accept-destruct', $this);
  63. $server->accept();
  64. $message = $server->receive();
  65. }
  66. public function testServerWithTimeout(): void
  67. {
  68. MockSocket::initialize('server.construct', $this);
  69. $server = new Server(['timeout' => 300]);
  70. $this->assertTrue(MockSocket::isEmpty());
  71. MockSocket::initialize('server.accept-timeout', $this);
  72. $server->accept();
  73. $server->send('Connect');
  74. $this->assertTrue(MockSocket::isEmpty());
  75. }
  76. public function testPayload128(): void
  77. {
  78. MockSocket::initialize('server.construct', $this);
  79. $server = new Server();
  80. $this->assertTrue(MockSocket::isEmpty());
  81. MockSocket::initialize('server.accept', $this);
  82. $server->accept();
  83. $server->send('Connect');
  84. $this->assertTrue($server->isConnected());
  85. $this->assertTrue(MockSocket::isEmpty());
  86. $payload = file_get_contents(__DIR__ . '/mock/payload.128.txt');
  87. MockSocket::initialize('send-receive-128', $this);
  88. $server->send($payload, 'text', false);
  89. $message = $server->receive();
  90. $this->assertEquals($payload, $message);
  91. $this->assertTrue(MockSocket::isEmpty());
  92. }
  93. public function testPayload65536(): void
  94. {
  95. MockSocket::initialize('server.construct', $this);
  96. $server = new Server();
  97. $this->assertTrue(MockSocket::isEmpty());
  98. MockSocket::initialize('server.accept', $this);
  99. $server->accept();
  100. $server->send('Connect');
  101. $this->assertTrue($server->isConnected());
  102. $this->assertTrue(MockSocket::isEmpty());
  103. $payload = file_get_contents(__DIR__ . '/mock/payload.65536.txt');
  104. $server->setFragmentSize(65540);
  105. MockSocket::initialize('send-receive-65536', $this);
  106. $server->send($payload, 'text', false);
  107. $message = $server->receive();
  108. $this->assertEquals($payload, $message);
  109. $this->assertTrue(MockSocket::isEmpty());
  110. }
  111. public function testMultiFragment(): void
  112. {
  113. MockSocket::initialize('server.construct', $this);
  114. $server = new Server();
  115. $this->assertTrue(MockSocket::isEmpty());
  116. MockSocket::initialize('server.accept', $this);
  117. $server->accept();
  118. $server->send('Connect');
  119. $this->assertTrue($server->isConnected());
  120. $this->assertTrue(MockSocket::isEmpty());
  121. MockSocket::initialize('send-receive-multi-fragment', $this);
  122. $server->setFragmentSize(8);
  123. $server->send('Multi fragment test');
  124. $message = $server->receive();
  125. $this->assertEquals('Multi fragment test', $message);
  126. $this->assertTrue(MockSocket::isEmpty());
  127. }
  128. public function testPingPong(): void
  129. {
  130. MockSocket::initialize('server.construct', $this);
  131. $server = new Server();
  132. $this->assertTrue(MockSocket::isEmpty());
  133. MockSocket::initialize('server.accept', $this);
  134. $server->accept();
  135. $server->send('Connect');
  136. $this->assertTrue($server->isConnected());
  137. $this->assertTrue(MockSocket::isEmpty());
  138. MockSocket::initialize('ping-pong', $this);
  139. $server->send('Server ping', 'ping');
  140. $server->send('', 'ping');
  141. $message = $server->receive();
  142. $this->assertEquals('Receiving a message', $message);
  143. $this->assertEquals('text', $server->getLastOpcode());
  144. $this->assertTrue(MockSocket::isEmpty());
  145. }
  146. public function testRemoteClose(): void
  147. {
  148. MockSocket::initialize('server.construct', $this);
  149. $server = new Server();
  150. $this->assertTrue(MockSocket::isEmpty());
  151. MockSocket::initialize('server.accept', $this);
  152. $server->accept();
  153. $server->send('Connect');
  154. $this->assertTrue($server->isConnected());
  155. $this->assertTrue(MockSocket::isEmpty());
  156. MockSocket::initialize('close-remote', $this);
  157. $message = $server->receive();
  158. $this->assertEquals('', $message);
  159. $this->assertTrue(MockSocket::isEmpty());
  160. $this->assertFalse($server->isConnected());
  161. $this->assertEquals(17260, $server->getCloseStatus());
  162. $this->assertNull($server->getLastOpcode());
  163. }
  164. public function testSetTimeout(): void
  165. {
  166. MockSocket::initialize('server.construct', $this);
  167. $server = new Server();
  168. $this->assertTrue(MockSocket::isEmpty());
  169. MockSocket::initialize('server.accept', $this);
  170. $server->accept();
  171. $server->send('Connect');
  172. $this->assertTrue($server->isConnected());
  173. $this->assertTrue(MockSocket::isEmpty());
  174. MockSocket::initialize('config-timeout', $this);
  175. $server->setTimeout(300);
  176. $this->assertTrue($server->isConnected());
  177. $this->assertTrue(MockSocket::isEmpty());
  178. }
  179. public function testFailedSocketServer(): void
  180. {
  181. MockSocket::initialize('server.construct-failed-socket-server', $this);
  182. $this->expectException('WebSocket\ConnectionException');
  183. $this->expectExceptionCode(0);
  184. $this->expectExceptionMessage('Could not open listening socket:');
  185. $server = new Server(['port' => 9999]);
  186. }
  187. public function testFailedSocketServerWithError(): void
  188. {
  189. MockSocket::initialize('server.construct-error-socket-server', $this);
  190. $this->expectException('WebSocket\ConnectionException');
  191. $this->expectExceptionCode(0);
  192. $this->expectExceptionMessage('Could not open listening socket:');
  193. $server = new Server(['port' => 9999]);
  194. }
  195. public function testFailedConnect(): void
  196. {
  197. MockSocket::initialize('server.construct', $this);
  198. $server = new Server();
  199. MockSocket::initialize('server.accept-failed-connect', $this);
  200. $server->accept();
  201. $this->expectException('WebSocket\ConnectionException');
  202. $this->expectExceptionCode(0);
  203. $this->expectExceptionMessage('Server failed to connect');
  204. $server->send('Connect');
  205. }
  206. public function testFailedConnectWithError(): void
  207. {
  208. MockSocket::initialize('server.construct', $this);
  209. $server = new Server();
  210. MockSocket::initialize('server.accept-error-connect', $this);
  211. $server->accept();
  212. $this->expectException('WebSocket\ConnectionException');
  213. $this->expectExceptionCode(0);
  214. $this->expectExceptionMessage('Server failed to connect');
  215. $server->send('Connect');
  216. }
  217. public function testFailedConnectTimeout(): void
  218. {
  219. MockSocket::initialize('server.construct', $this);
  220. $server = new Server(['timeout' => 300]);
  221. MockSocket::initialize('server.accept-failed-connect', $this);
  222. $server->accept();
  223. $this->expectException('WebSocket\ConnectionException');
  224. $this->expectExceptionCode(0);
  225. $this->expectExceptionMessage('Server failed to connect');
  226. $server->send('Connect');
  227. }
  228. public function testFailedHttp(): void
  229. {
  230. MockSocket::initialize('server.construct', $this);
  231. $server = new Server();
  232. MockSocket::initialize('server.accept-failed-http', $this);
  233. $server->accept();
  234. $this->expectException('WebSocket\ConnectionException');
  235. $this->expectExceptionCode(0);
  236. $this->expectExceptionMessage('No GET in request');
  237. $server->send('Connect');
  238. }
  239. public function testFailedWsKey(): void
  240. {
  241. MockSocket::initialize('server.construct', $this);
  242. $server = new Server();
  243. MockSocket::initialize('server.accept-failed-ws-key', $this);
  244. $server->accept();
  245. $this->expectException('WebSocket\ConnectionException');
  246. $this->expectExceptionCode(0);
  247. $this->expectExceptionMessage('Client had no Key in upgrade request');
  248. $server->send('Connect');
  249. }
  250. public function testSendBadOpcode(): void
  251. {
  252. MockSocket::initialize('server.construct', $this);
  253. $server = new Server();
  254. MockSocket::initialize('server.accept', $this);
  255. $server->accept();
  256. $server->send('Connect');
  257. $this->expectException('WebSocket\BadOpcodeException');
  258. $this->expectExceptionCode(0);
  259. $this->expectExceptionMessage('Bad opcode \'bad\'. Try \'text\' or \'binary\'.');
  260. $server->send('Bad Opcode', 'bad');
  261. }
  262. public function testRecieveBadOpcode(): void
  263. {
  264. MockSocket::initialize('server.construct', $this);
  265. $server = new Server();
  266. MockSocket::initialize('server.accept', $this);
  267. $server->accept();
  268. $server->send('Connect');
  269. MockSocket::initialize('receive-bad-opcode', $this);
  270. $this->expectException('WebSocket\ConnectionException');
  271. $this->expectExceptionCode(1026);
  272. $this->expectExceptionMessage('Bad opcode in websocket frame: 12');
  273. $message = $server->receive();
  274. }
  275. public function testBrokenWrite(): void
  276. {
  277. MockSocket::initialize('server.construct', $this);
  278. $server = new Server();
  279. MockSocket::initialize('server.accept', $this);
  280. $server->accept();
  281. $server->send('Connect');
  282. MockSocket::initialize('send-broken-write', $this);
  283. $this->expectException('WebSocket\ConnectionException');
  284. $this->expectExceptionCode(1025);
  285. $this->expectExceptionMessage('Could only write 18 out of 22 bytes.');
  286. $server->send('Failing to write');
  287. }
  288. public function testFailedWrite(): void
  289. {
  290. MockSocket::initialize('server.construct', $this);
  291. $server = new Server();
  292. MockSocket::initialize('server.accept', $this);
  293. $server->accept();
  294. $server->send('Connect');
  295. MockSocket::initialize('send-failed-write', $this);
  296. $this->expectException('WebSocket\TimeoutException');
  297. $this->expectExceptionCode(1024);
  298. $this->expectExceptionMessage('Failed to write 22 bytes.');
  299. $server->send('Failing to write');
  300. }
  301. public function testBrokenRead(): void
  302. {
  303. MockSocket::initialize('server.construct', $this);
  304. $server = new Server();
  305. MockSocket::initialize('server.accept', $this);
  306. $server->accept();
  307. $server->send('Connect');
  308. MockSocket::initialize('receive-broken-read', $this);
  309. $this->expectException('WebSocket\ConnectionException');
  310. $this->expectExceptionCode(1025);
  311. $this->expectExceptionMessage('Broken frame, read 0 of stated 2 bytes.');
  312. $server->receive();
  313. }
  314. public function testEmptyRead(): void
  315. {
  316. MockSocket::initialize('server.construct', $this);
  317. $server = new Server();
  318. MockSocket::initialize('server.accept', $this);
  319. $server->accept();
  320. $server->send('Connect');
  321. MockSocket::initialize('receive-empty-read', $this);
  322. $this->expectException('WebSocket\TimeoutException');
  323. $this->expectExceptionCode(1024);
  324. $this->expectExceptionMessage('Empty read; connection dead?');
  325. $server->receive();
  326. }
  327. public function testFrameFragmentation(): void
  328. {
  329. MockSocket::initialize('server.construct', $this);
  330. $server = new Server(['filter' => ['text', 'binary', 'pong', 'close']]);
  331. MockSocket::initialize('server.accept', $this);
  332. $server->accept();
  333. $server->send('Connect');
  334. MockSocket::initialize('receive-fragmentation', $this);
  335. $message = $server->receive();
  336. $this->assertEquals('Server ping', $message);
  337. $this->assertEquals('pong', $server->getLastOpcode());
  338. $message = $server->receive();
  339. $this->assertEquals('Multi fragment test', $message);
  340. $this->assertEquals('text', $server->getLastOpcode());
  341. $this->assertTrue(MockSocket::isEmpty());
  342. MockSocket::initialize('close-remote', $this);
  343. $message = $server->receive();
  344. $this->assertEquals('Closing', $message);
  345. $this->assertTrue(MockSocket::isEmpty());
  346. $this->assertFalse($server->isConnected());
  347. $this->assertEquals(17260, $server->getCloseStatus());
  348. $this->assertEquals('close', $server->getLastOpcode());
  349. }
  350. public function testMessageFragmentation(): void
  351. {
  352. MockSocket::initialize('server.construct', $this);
  353. $server = new Server(['filter' => ['text', 'binary', 'pong', 'close'], 'return_obj' => true]);
  354. MockSocket::initialize('server.accept', $this);
  355. $server->accept();
  356. $server->send('Connect');
  357. MockSocket::initialize('receive-fragmentation', $this);
  358. $message = $server->receive();
  359. $this->assertInstanceOf('WebSocket\Message\Message', $message);
  360. $this->assertInstanceOf('WebSocket\Message\Pong', $message);
  361. $this->assertEquals('Server ping', $message->getContent());
  362. $this->assertEquals('pong', $message->getOpcode());
  363. $message = $server->receive();
  364. $this->assertInstanceOf('WebSocket\Message\Message', $message);
  365. $this->assertInstanceOf('WebSocket\Message\Text', $message);
  366. $this->assertEquals('Multi fragment test', $message->getContent());
  367. $this->assertEquals('text', $message->getOpcode());
  368. $this->assertTrue(MockSocket::isEmpty());
  369. MockSocket::initialize('close-remote', $this);
  370. $message = $server->receive();
  371. $this->assertInstanceOf('WebSocket\Message\Message', $message);
  372. $this->assertInstanceOf('WebSocket\Message\Close', $message);
  373. $this->assertEquals('Closing', $message->getContent());
  374. $this->assertEquals('close', $message->getOpcode());
  375. }
  376. public function testConvenicanceMethods(): void
  377. {
  378. MockSocket::initialize('server.construct', $this);
  379. $server = new Server();
  380. $this->assertNull($server->getName());
  381. $this->assertNull($server->getRemoteName());
  382. $this->assertEquals('WebSocket\Server(closed)', "{$server}");
  383. MockSocket::initialize('server.accept', $this);
  384. $server->accept();
  385. $server->text('Connect');
  386. MockSocket::initialize('send-convenicance', $this);
  387. $server->binary(base64_encode('Binary content'));
  388. $server->ping();
  389. $server->pong();
  390. $this->assertEquals('127.0.0.1:12345', $server->getName());
  391. $this->assertEquals('127.0.0.1:8000', $server->getRemoteName());
  392. $this->assertEquals('WebSocket\Server(127.0.0.1:12345)', "{$server}");
  393. $this->assertTrue(MockSocket::isEmpty());
  394. }
  395. public function testUnconnectedServer(): void
  396. {
  397. MockSocket::initialize('server.construct', $this);
  398. $server = new Server();
  399. $this->assertFalse($server->isConnected());
  400. $server->setTimeout(30);
  401. $server->close();
  402. $this->assertFalse($server->isConnected());
  403. $this->assertNull($server->getName());
  404. $this->assertNull($server->getRemoteName());
  405. $this->assertNull($server->getCloseStatus());
  406. $this->assertTrue(MockSocket::isEmpty());
  407. }
  408. public function testFailedHandshake(): void
  409. {
  410. MockSocket::initialize('server.construct', $this);
  411. $server = new Server();
  412. $this->assertTrue(MockSocket::isEmpty());
  413. MockSocket::initialize('server.accept-failed-handshake', $this);
  414. $server->accept();
  415. $this->expectException('WebSocket\ConnectionException');
  416. $this->expectExceptionCode(0);
  417. $this->expectExceptionMessage('Could not read from stream');
  418. $server->send('Connect');
  419. $this->assertFalse($server->isConnected());
  420. $this->assertTrue(MockSocket::isEmpty());
  421. }
  422. public function testServerDisconnect(): void
  423. {
  424. MockSocket::initialize('server.construct', $this);
  425. $server = new Server();
  426. $this->assertTrue(MockSocket::isEmpty());
  427. MockSocket::initialize('server.accept', $this);
  428. $server->accept();
  429. $server->send('Connect');
  430. $this->assertTrue($server->isConnected());
  431. $this->assertTrue(MockSocket::isEmpty());
  432. MockSocket::initialize('server.disconnect', $this);
  433. $server->disconnect();
  434. $this->assertFalse($server->isConnected());
  435. $this->assertTrue(MockSocket::isEmpty());
  436. }
  437. public function testDeprecated(): void
  438. {
  439. MockSocket::initialize('server.construct', $this);
  440. $server = new Server();
  441. $this->assertTrue(MockSocket::isEmpty());
  442. (new ErrorHandler())->withAll(function () use ($server) {
  443. $this->assertNull($server->getPier());
  444. }, function ($exceptions, $result) {
  445. $this->assertEquals(
  446. 'getPier() is deprecated and will be removed in future version. Use getRemoteName() instead.',
  447. $exceptions[0]->getMessage()
  448. );
  449. }, E_USER_DEPRECATED);
  450. }
  451. }