client = new Client(); $this->parser = new StreamingParser(); $promise = $this->client->ping(); try { \React\Async\await($promise); } catch (\Exception $e) { $this->markTestSkipped('Unable to connect to docker ' . $e->getMessage()); } } public function testPing() { $this->expectPromiseResolve($this->client->ping(), 'OK'); Loop::run(); } /** * @doesNotPerformAssertions */ public function testImageInspectCheckIfBusyboxExists() { $promise = $this->client->imageInspect('busybox:latest'); try { \React\Async\await($promise); } catch (\RuntimeException $e) { $this->markTestSkipped('Image "busybox" not downloaded yet'); } } /** * @depends testImageInspectCheckIfBusyboxExists */ public function testCreateStartAndRemoveContainer() { $config = array( 'Image' => 'busybox', 'Cmd' => array('echo', 'test') ); $promise = $this->client->containerCreate($config); $container = \React\Async\await($promise); $this->assertNotNull($container['Id']); $this->assertEmpty($container['Warnings']); $start = microtime(true); $promise = $this->client->containerStart($container['Id']); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); $promise = $this->client->containerLogs($container['Id'], false, true, true); $ret = \React\Async\await($promise); $this->assertEquals("test\n", $ret); $promise = $this->client->containerWait($container['Id']); $ret = \React\Async\await($promise); $this->assertEquals(0, $ret['StatusCode']); $promise = $this->client->containerAttach($container['Id'], true, false); $ret = \React\Async\await($promise); $this->assertEquals("test\n", $ret); $promise = $this->client->containerRemove($container['Id'], false, true); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); $end = microtime(true); // get all events between starting and removing for this container $promise = $this->client->events($start, $end, array('container' => array($container['Id']))); $ret = \React\Async\await($promise); assert(is_array($ret)); $actions = array(); // array_column($ret, 'Action'); // PHP 5.5+ foreach ($ret as $one) { $actions[] = $one['Action']; } // expects "start", "die", "attach", "destroy" events (container already exited before attaching) $this->assertEquals(array('start', 'die', 'attach', 'destroy'), $actions); } /** * @depends testImageInspectCheckIfBusyboxExists */ public function testCreateStartAndRemoveContainerWithStderrOutputEmitsCustomEventForLogsAndAttachStreams() { $config = array( 'Image' => 'busybox', 'Cmd' => array('sh', '-c', 'echo out; echo err >&2') ); $promise = $this->client->containerCreate($config); $container = \React\Async\await($promise); $promise = $this->client->containerStart($container['Id']); \React\Async\await($promise); $promise = $this->client->containerWait($container['Id']); \React\Async\await($promise); $stream = $this->client->containerLogsStream($container['Id'], false, true, true, 0, false, null, 'err'); $stream->on('err', $this->expectCallableOnceWith("err\n")); $stream->on('end', $this->expectCallableOnce()); $output = \React\Async\await($this->parser->bufferedStream($stream)); $this->assertEquals("out\n", $output); $stream = $this->client->containerAttachStream($container['Id'], true, false, true, true, 'err'); $stream->on('err', $this->expectCallableOnceWith("err\n")); $stream->on('end', $this->expectCallableOnce()); $output = \React\Async\await($this->parser->bufferedStream($stream)); $this->assertEquals("out\n", $output); $promise = $this->client->containerRemove($container['Id'], false, true); \React\Async\await($promise); } /** * @depends testImageInspectCheckIfBusyboxExists */ public function testStartRunning() { $config = array( 'Image' => 'busybox', 'Tty' => true, 'Cmd' => array('sleep', '10') ); $promise = $this->client->containerCreate($config); $container = \React\Async\await($promise); $this->assertNotNull($container['Id']); $this->assertEmpty($container['Warnings']); $promise = $this->client->containerStart($container['Id']); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); return $container['Id']; } /** * @depends testStartRunning * @param string $container * @return string */ public function testExecCreateWhileRunning($container) { $promise = $this->client->execCreate($container, array('echo', '-n', 'hello', 'world')); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); return $exec['Id']; } /** * @depends testExecCreateWhileRunning * @param string $exec */ public function testExecInspectBeforeRunning($exec) { $promise = $this->client->execInspect($exec); $info = \React\Async\await($promise); $this->assertTrue(is_array($info)); $this->assertFalse($info['Running']); $this->assertEquals(null, $info['ExitCode']); } /** * @depends testExecCreateWhileRunning * @param string $exec */ public function testExecStartWhileRunning($exec) { $promise = $this->client->execStart($exec); $output = \React\Async\await($promise); $this->assertEquals('hello world', $output); } /** * @depends testExecCreateWhileRunning * @param string $exec */ public function testExecInspectAfterRunning($exec) { $promise = $this->client->execInspect($exec); $info = \React\Async\await($promise); $this->assertTrue(is_array($info)); $this->assertFalse($info['Running']); $this->assertEquals(0, $info['ExitCode']); } /** * @depends testStartRunning * @param string $container */ public function testExecStringCommandWithOutputWhileRunning($container) { $promise = $this->client->execCreate($container, 'echo -n hello world'); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $promise = $this->client->execStart($exec['Id']); $output = \React\Async\await($promise); $this->assertEquals('hello world', $output); } /** * @depends testStartRunning * @param string $container */ public function testExecStreamOutputInMultipleChunksWhileRunning($container) { $promise = $this->client->execCreate($container, 'echo -n hello && sleep 0.2 && echo -n world'); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $stream = $this->client->execStartStream($exec['Id']); $stream->once('data', $this->expectCallableOnceWith('hello')); $stream->on('end', $this->expectCallableOnce()); $output = \React\Async\await($this->parser->bufferedStream($stream)); $this->assertEquals('helloworld', $output); } /** * @depends testStartRunning * @param string $container */ public function testExecUserSpecificCommandWithOutputWhileRunning($container) { $promise = $this->client->execCreate($container, 'whoami', false, false, true, true, 'nobody'); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $promise = $this->client->execStart($exec['Id']); $output = \React\Async\await($promise); $this->assertEquals('nobody', rtrim($output)); } /** * @depends testStartRunning * @param string $container */ public function testExecStringCommandWithStderrOutputWhileRunning($container) { $promise = $this->client->execCreate($container, 'echo -n hello world >&2'); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $promise = $this->client->execStart($exec['Id']); $output = \React\Async\await($promise); $this->assertEquals('hello world', $output); } /** * @depends testStartRunning * @param string $container */ public function testExecStreamCommandWithTtyAndStderrOutputWhileRunning($container) { $promise = $this->client->execCreate($container, 'echo -n hello world >&2', true); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $stream = $this->client->execStartStream($exec['Id'], true); $stream->once('data', $this->expectCallableOnce('hello world')); $stream->on('end', $this->expectCallableOnce()); $output = \React\Async\await($this->parser->bufferedStream($stream)); $this->assertEquals('hello world', $output); } /** * @depends testStartRunning * @param string $container */ public function testExecStreamStderrCustomEventWhileRunning($container) { $promise = $this->client->execCreate($container, 'echo -n hello world >&2'); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $stream = $this->client->execStartStream($exec['Id'], false, 'err'); $stream->on('err', $this->expectCallableOnceWith('hello world')); $stream->on('data', $this->expectCallableNever()); $stream->on('error', $this->expectCallableNever()); $stream->on('end', $this->expectCallableOnce()); $output = \React\Async\await($this->parser->bufferedStream($stream)); $this->assertEquals('', $output); } /** * @depends testStartRunning * @param string $container */ public function testExecStreamEmptyOutputWhileRunning($container) { $promise = $this->client->execCreate($container, array('true')); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $stream = $this->client->execStartStream($exec['Id'], true); $stream->on('end', $this->expectCallableOnce()); $output = \React\Async\await($this->parser->bufferedStream($stream)); $this->assertEquals('', $output); } /** * @depends testStartRunning * @param string $container */ public function testExecDetachedWhileRunning($container) { $promise = $this->client->execCreate($container, array('sleep', '10')); $exec = \React\Async\await($promise); $this->assertTrue(is_array($exec)); $this->assertTrue(is_string($exec['Id'])); $promise = $this->client->execStartDetached($exec['Id'], true); $output = \React\Async\await($promise); $this->assertEquals('', $output); } /** * @depends testStartRunning * @param string $container */ public function testRemoveRunning($container) { $promise = $this->client->containerRemove($container, true, true); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); } public function testContainerRemoveInvalid() { $promise = $this->client->containerRemove('invalid123'); $this->setExpectedException('RuntimeException'); \React\Async\await($promise); } public function testImageSearch() { $promise = $this->client->imageSearch('clue'); $ret = \React\Async\await($promise); $this->assertGreaterThan(9, count($ret)); } /** * @depends testImageInspectCheckIfBusyboxExists * @doesNotPerformAssertions */ public function testImageTag() { // create new tag "bb:now" on "busybox:latest" $promise = $this->client->imageTag('busybox', 'bb', 'now'); \React\Async\await($promise); // delete tag "bb:now" again $promise = $this->client->imageRemove('bb:now'); \React\Async\await($promise); } public function testImageCreateStreamMissingWillEmitJsonError() { $promise = $this->client->version(); $version = \React\Async\await($promise); // old API reports a progress with error message, newer API just returns 404 right away // https://docs.docker.com/engine/api/version-history/ $old = $version['ApiVersion'] < '1.22'; $stream = $this->client->imageCreateStream('clue/does-not-exist'); // one "progress" event, but no "data" events $old && $stream->on('progress', $this->expectCallableOnce()); $old || $stream->on('progress', $this->expectCallableNever()); $stream->on('data', $this->expectCallableNever()); // will emit "error" with RuntimeException and close $old && $stream->on('error', $this->expectCallableOnceParameter('RuntimeException')); $old || $stream->on('error', $this->expectCallableOnceParameter('React\Http\Message\ResponseException')); $stream->on('close', $this->expectCallableOnce()); Loop::run(); } public function testInfo() { $this->expectPromiseResolve($this->client->info()); Loop::run(); } public function testVersion() { $this->expectPromiseResolve($this->client->version()); Loop::run(); } public function testContainerList() { $this->expectPromiseResolve($this->client->containerList()); Loop::run(); } /** * @depends testImageInspectCheckIfBusyboxExists */ public function testCreateConnectDisconnectAndRemoveNetwork() { $containerConfig = array( 'Image' => 'busybox', 'Cmd' => array('echo', 'test') ); $networkName = uniqid('reactphp-docker', true); $promise = $this->client->containerCreate($containerConfig); $container = \React\Async\await($promise); $start = microtime(true); $promise = $this->client->networkCreate($networkName); $network = \React\Async\await($promise); $this->assertNotNull($network['Id']); $this->assertEquals('', $network['Warning']); $promise = $this->client->networkConnect($network['Id'], $container['Id'], array('Aliases' => array('foo'))); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); $promise = $this->client->networkDisconnect($network['Id'], $container['Id'], true); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); $promise = $this->client->networkRemove($network['Id']); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); $end = microtime(true); $promise = $this->client->containerRemove($container['Id']); $ret = \React\Async\await($promise); // get all events between starting and removing for this container $promise = $this->client->events($start, $end, array('network' => array($network['Id']))); $ret = \React\Async\await($promise); assert(is_array($ret)); $actions = array(); // array_column($ret, 'Action'); // PHP 5.5+ foreach ($ret as $one) { $actions[] = $one['Action']; } // expect 2 events as of Docker 28 (2025), 3 in earlier versions if (count($actions) === 2) { // expects only "create" and "destroy" events (no "connect" / "disconnect" because we don't start the container) $this->assertEquals(array('create', 'destroy'), $actions); } else { // expects "create", "disconnect", "destroy" events ("connect" will be skipped because we don't start the container) $this->assertEquals(array('create', 'disconnect', 'destroy'), $actions); } } /** * @depends testImageInspectCheckIfBusyboxExists */ public function testCreateAndCommitContainer() { $config = array( 'Image' => 'busybox', 'Cmd' => array('echo', 'test') ); $promise = $this->client->containerCreate($config); $container = \React\Async\await($promise); $this->assertNotNull($container['Id']); $this->assertEmpty($container['Warnings']); $promise = $this->client->containerCommit($container['Id']); $image = \React\Async\await($promise); $this->assertNotNull($image['Id']); $this->assertArrayNotHasKey('message', $image); $promise = $this->client->containerRemove($container['Id'], false, true); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); $config = array( 'Image' => $image['Id'], 'Cmd' => array('echo', 'test') ); $promise = $this->client->containerCreate($config); $container = \React\Async\await($promise); $this->assertNotNull($container['Id']); $this->assertEmpty($container['Warnings']); $promise = $this->client->containerRemove($container['Id'], false, true); $ret = \React\Async\await($promise); $this->assertEquals('', $ret); } }