Legacy PHP support

Installation

composer req --dev testcontainers/testcontainers

Usage/Examples

Starting a general Container

<?phpuseTestcontainers\Container\GenericContainer;$container =newGenericContainer('nginx:alpine');// set an environment variable$container->withEnvironment(['key1' =>'val1','key2' =>'val2']);// enable health check for an container$container->withHealthCheckCommand('curl --fail localhost');// mount current dir to /var/www/html$container->withMount(__DIR__,'/var/www/html');

useTestcontainers\Container\GenericContainer;useTestcontainers\Wait\WaitForExec;useTestcontainers\Wait\WaitForLog;useTestcontainers\Wait\WaitForHttp;useTestcontainers\Wait\WaitForHealthCheck;useTestcontainers\Wait\WaitForHostPort;$container =newGenericContainer('nginx:alpine');// Run mysqladmin ping until the command returns exit code 0$container->withWait(newWaitForExec(['mysqladmin','ping','-h','127.0.0.1']));$container->withWait(newWaitForExec(['mysqladmin','ping','-h','127.0.0.1']),function($exitCode,$contents) {// throw exception if process result is bad});// Wait until that message is in the logs$container->withWait(newWaitForLog('Ready to accept connections'));// Wait for an http request to succeed$container->withWait(newWaitForHttp($port,$method ='GET',$path ='/'));// Wait for all bound ports to be open$container->withWait(newWaitForHostPort());// Wait until the docker heartcheck is green$container->withWait(newWaitForHealthCheck());

MySQL

<?phpuseTestcontainers\Modules\MySQLContainer;$container = (newMySQLContainer('8.0'))    ->withMySQLDatabase('foo')    ->withMySQLUser('bar','baz')    ->start();$pdo =new \PDO(sprintf('mysql:host=%s;port=%d',$container->getHost(),$container->getFirstMappedPort()    ),'bar','baz',);// Do something with pdo

MariaDB

<?phpuseTestcontainers\Modules\MariaDBContainer;$container =$container = (newMariaDBContainer())    ->withMariaDBDatabase('foo')    ->withMariaDBUser('bar','baz')    ->start();$pdo =new \PDO(sprintf('mysql:host=%s;port=%d',$container->getHost(),$container->getFirstMappedPort()    ),'bar','baz',);// Do something with pdo

PostgreSQL

<?phpuseTestcontainers\Modules\PostgresContainer;$container = (newPostgresContainer())    ->withPostgresUser('bar')    ->withPostgresDatabase('foo')    ->start();$pdo =new \PDO(sprintf('pgsql:host=%s;port=%d;dbname=foo',self::$container->getHost(),self::$container->getFirstMappedPort()    ),'bar','test',);// Do something with pdo

Redis

useTestcontainers\Modules\RedisContainer;$container = (newRedisContainer())    ->start();$redis =new \Redis();$redis->connect($container->getHost(),$container->getFirstMappedPort());// Do something with redis

OpenSearch

useTestcontainers\Modules\OpenSearchContainer;$container = (newOpenSearchContainer())    ->withDisabledSecurityPlugin()    ->start();// Do something with opensearch

Use with symfony

# config/packages/test/services.yamlparameters:'doctrine.dbal.connection_factory.class':App\Tests\TestConnectionFactory

namespaceApp\Tests;useDoctrine\Bundle\DoctrineBundle\ConnectionFactory;useDoctrine\Common\EventManager;useDoctrine\DBAL\Configuration;useDoctrine\DBAL\Tools\DsnParser;useTestcontainers\Modules\PostgresContainer;class TestConnectionFactoryextends ConnectionFactory{static$testDsn;publicfunction__construct(array$typesConfig, ?DsnParser$dsnParser =null)    {if (!$this::$testDsn) {$psql = (newPostgresContainer())                ->withPostgresUser('user')                ->withPostgresPassword('password')                ->withPostgresDatabase('database')                ->start();$this::$testDsn =sprintf('postgresql://user:password@%s:%d/database?serverVersion=14&charset=utf8',$psql->getAddress(),$psql->getFirstMappedPort());        }parent::__construct($typesConfig,$dsnParser);    }publicfunctioncreateConnection(array$params, ?Configuration$config =null, ?EventManager$eventManager =null,array$mappingTypes = [])    {$params['url'] =$this::$testDsn;returnparent::createConnection($params,$config,$eventManager,$mappingTypes);    }}

License