. */ declare(strict_types=1); namespace Fisharebest\Webtrees; use Aura\Router\RouterContainer; use Fig\Http\Message\RequestMethodInterface; use Fisharebest\Localization\Locale\LocaleEnUs; use Fisharebest\Localization\Locale\LocaleInterface; use Fisharebest\Webtrees\Contracts\UserInterface; use Fisharebest\Webtrees\Http\Controllers\GedcomFileController; use Fisharebest\Webtrees\Module\ModuleThemeInterface; use Fisharebest\Webtrees\Module\WebtreesTheme; use Fisharebest\Webtrees\Services\MigrationService; use Fisharebest\Webtrees\Services\ModuleService; use Fisharebest\Webtrees\Services\TimeoutService; use Fisharebest\Webtrees\Services\UserService; use Illuminate\Cache\NullStore; use Illuminate\Cache\Repository; use Illuminate\Database\Capsule\Manager as DB; use Illuminate\Database\Query\Builder; use League\Flysystem\Filesystem; use League\Flysystem\FilesystemInterface; use League\Flysystem\Memory\MemoryAdapter; use Nyholm\Psr7\Factory\Psr17Factory; use Psr\Http\Message\ResponseFactoryInterface; use Psr\Http\Message\ServerRequestFactoryInterface; use Psr\Http\Message\ServerRequestInterface; use Psr\Http\Message\StreamFactoryInterface; use Psr\Http\Message\UploadedFileFactoryInterface; use Psr\Http\Message\UploadedFileInterface; use Psr\Http\Message\UriFactoryInterface; use function app; use function basename; use function define; use function defined; use function filesize; use function http_build_query; use function microtime; use const UPLOAD_ERR_OK; /** * Base class for unit tests */ class TestCase extends \PHPUnit\Framework\TestCase { /** @var object */ public static $mock_functions; /** @var bool */ protected static $uses_database = false; /** * Things to run once, before all the tests. */ public static function setUpBeforeClass() { parent::setUpBeforeClass(); // Use nyholm as our PSR7 factory app()->bind(ResponseFactoryInterface::class, Psr17Factory::class); app()->bind(ServerRequestFactoryInterface::class, Psr17Factory::class); app()->bind(StreamFactoryInterface::class, Psr17Factory::class); app()->bind(UploadedFileFactoryInterface::class, Psr17Factory::class); app()->bind(UriFactoryInterface::class, Psr17Factory::class); // Disable the cache. app()->instance('cache.array', new Repository(new NullStore())); app()->instance(UserService::class, new UserService()); app()->instance(FilesystemInterface::class, new Filesystem(new MemoryAdapter())); app()->bind(LocaleInterface::class, LocaleEnUs::class); app()->bind(ModuleThemeInterface::class, WebtreesTheme::class); app()->bind(UserInterface::class, GuestUser::class); // Need the routing table, to generate URLs. app()->instance(RouterContainer::class, new RouterContainer()); require __DIR__ . '/../routes/web.php'; defined('WT_DATA_DIR') || define('WT_DATA_DIR', Webtrees::ROOT_DIR . 'data/'); defined('WT_LOCALE') || define('WT_LOCALE', I18N::init('en-US', null, true)); if (static::$uses_database) { static::createTestDatabase(); // Boot modules (new ModuleService())->bootModules(new WebtreesTheme()); } } /** * Things to run once, AFTER all the tests. */ public static function tearDownAfterClass() { if (static::$uses_database) { $pdo = DB::connection()->getPdo(); unset($pdo); } parent::tearDownAfterClass(); } /** * Create an SQLite in-memory database for testing */ protected static function createTestDatabase(): void { $capsule = new DB(); $capsule->addConnection([ 'driver' => 'sqlite', 'database' => ':memory:', ]); $capsule->setAsGlobal(); Builder::macro('whereContains', function ($column, string $search, string $boolean = 'and'): Builder { $search = strtr($search, ['\\' => '\\\\', '%' => '\\%', '_' => '\\_', ' ' => '%']); return $this->where($column, 'LIKE', '%' . $search . '%', $boolean); }); // Migrations create logs, which requires an IP address, which requires a request self::createRequest(); // Create tables $migration_service = new MigrationService(); $migration_service->updateSchema('\Fisharebest\Webtrees\Schema', 'WT_SCHEMA_VERSION', Webtrees::SCHEMA_VERSION); // Create config data $migration_service->seedDatabase(); } /** * Create a request and bind it into the container. * * @param string $method * @param string[] $query * @param string[] $params * @param UploadedFileInterface[] $files * * @return ServerRequestInterface */ protected static function createRequest( string $method = RequestMethodInterface::METHOD_GET, array $query = [], array $params = [], array $files = [] ): ServerRequestInterface { /** @var ServerRequestFactoryInterface */ $server_request_factory = app(ServerRequestFactoryInterface::class); $uri = 'https://webtrees.test/index.php?' . http_build_query($query); /** @var ServerRequestInterface $request */ $request = $server_request_factory ->createServerRequest($method, $uri) ->withQueryParams($query) ->withParsedBody($params) ->withUploadedFiles($files) ->withAttribute('base_url', 'https://webtrees.test') ->withAttribute('client-ip', '127.0.0.1'); app()->instance(ServerRequestInterface::class, $request); View::share('request', $request); return $request; } /** * Things to run before every test. */ protected function setUp(): void { parent::setUp(); if (static::$uses_database) { DB::connection()->beginTransaction(); } } /** * Things to run after every test */ protected function tearDown() { if (static::$uses_database) { DB::connection()->rollBack(); } Site::$preferences = []; Tree::$trees = []; GedcomRecord::$gedcom_record_cache = null; GedcomRecord::$pending_record_cache = null; Auth::logout(); } /** * Import a GEDCOM file into the test database. * * @param string $gedcom_file * * @return Tree */ protected function importTree(string $gedcom_file): Tree { $tree = Tree::create(basename($gedcom_file), basename($gedcom_file)); $stream = app(StreamFactoryInterface::class)->createStreamFromFile(__DIR__ . '/data/' . $gedcom_file); $tree->importGedcomFile($stream, $gedcom_file); View::share('tree', $tree); $timeout_service = new TimeoutService(microtime(true)); $controller = new GedcomFileController($timeout_service); $request = self::createRequest()->withAttribute('tree', $tree); do { $controller->import($request); $imported = $tree->getPreference('imported'); } while (!$imported); return $tree; } /** * Create an uploaded file for a request. * * @param string $filename * @param string $mime_type * * @return UploadedFileInterface */ protected function createUploadedFile(string $filename, string $mime_type): UploadedFileInterface { /** @var StreamFactoryInterface */ $stream_factory = app(StreamFactoryInterface::class); /** @var UploadedFileFactoryInterface */ $uploaded_file_factory = app(UploadedFileFactoryInterface::class); $stream = $stream_factory->createStreamFromFile($filename); $size = filesize($filename); $status = UPLOAD_ERR_OK; $client_name = basename($filename); return $uploaded_file_factory->createUploadedFile($stream, $size, $status, $client_name, $mime_type); } }