1 <?php declare(strict_types=1);
3 namespace Tests\Commands;
8 class RestoreCommandTest extends TestCase
11 public function test_restore_into_cwd_by_default_with_all_content_types()
13 $mysql = new mysqli('db', 'bookstack', 'bookstack', 'bookstack');
14 $mysql->query('CREATE TABLE xx_testing (labels varchar(255));');
16 $result = $mysql->query('SHOW TABLES LIKE \'zz_testing\';');
17 $this->assertEquals(0, mysqli_num_rows($result));
19 $zipFile = $this->buildZip(function (\ZipArchive $zip) {
20 $zip->addFromString('.env', "APP_KEY=abc123\nAPP_URL=https://restore.example.com");
21 $zip->addFromString('public/uploads/test.txt', 'hello-public-uploads');
22 $zip->addFromString('storage/uploads/test.txt', 'hello-storage-uploads');
23 $zip->addFromString('themes/test.txt', 'hello-themes');
24 $zip->addFromString('db.sql', "CREATE TABLE zz_testing (names varchar(255));\nINSERT INTO zz_testing values ('barry');");
27 exec('cp -r /var/www/bookstack /var/www/bookstack-restore');
28 chdir('/var/www/bookstack-restore');
30 $result = $this->runCommand('restore', [
31 'backup-zip' => $zipFile,
32 ], ['yes', '1']); // This restore uses the existing (Non-backup) APP_URL
35 $result->assertSuccessfulExit();
36 $result->assertStdoutContains('✔ .env Config File');
37 $result->assertStdoutContains('✔ Themes Folder');
38 $result->assertStdoutContains('✔ Public File Uploads');
39 $result->assertStdoutContains('✔ Private File Uploads');
40 $result->assertStdoutContains('✔ Database Dump');
41 $result->assertStdoutContains('Restore operation complete!');
42 $result->assertStdoutContains('App URL change made, updating database with URL change');
44 $result = $mysql->query('SELECT * FROM zz_testing where names = \'barry\';');
45 $this->assertEquals(1, mysqli_num_rows($result));
46 $result = $mysql->query('SHOW TABLES LIKE \'xx_testing\';');
47 $this->assertEquals(0, mysqli_num_rows($result));
49 $this->assertStringEqualsFile('/var/www/bookstack-restore/public/uploads/test.txt', 'hello-public-uploads');
50 $this->assertStringEqualsFile('/var/www/bookstack-restore/storage/uploads/test.txt', 'hello-storage-uploads');
51 $this->assertStringEqualsFile('/var/www/bookstack-restore/themes/test.txt', 'hello-themes');
53 $env = file_get_contents('/var/www/bookstack-restore/.env');
54 $this->assertStringContainsString('APP_KEY=abc123', $env);
55 $this->assertStringNotContainsString('APP_URL=https://restore.example.com', $env);
56 $this->assertStringContainsString('APP_URL="https://example.com"', $env);
58 $mysql->query("DROP TABLE zz_testing;");
59 exec('rm -rf /var/www/bookstack-restore');
62 public function test_restore_using_backup_env_url()
64 $zipFile = $this->buildZip(function (\ZipArchive $zip) {
65 $zip->addFromString('.env', "APP_KEY=abc123\nAPP_URL=https://restore.example.com");
68 exec('cp -r /var/www/bookstack /var/www/bookstack-restore-backup-env');
69 chdir('/var/www/bookstack-restore-backup-env');
71 $result = $this->runCommand('restore', [
72 'backup-zip' => $zipFile,
73 ], ['yes', '0']); // This restore uses the old (Backup) APP_URL
75 $result->assertSuccessfulExit();
76 $result->assertStdoutContains('✔ .env Config File');
77 $result->assertStdoutContains('Restore operation complete!');
79 $env = file_get_contents('/var/www/bookstack-restore-backup-env/.env');
80 $this->assertStringContainsString('APP_KEY=abc123', $env);
81 $this->assertStringContainsString('APP_URL="https://restore.example.com"', $env);
83 exec('rm -rf /var/www/bookstack-restore-backup-env');
86 public function test_command_fails_on_zip_with_no_expected_contents()
88 $zipFile = $this->buildZip(function (\ZipArchive $zip) {
89 $zip->addFromString('spaghetti', "Hello world!");
92 chdir('/var/www/bookstack');
94 $result = $this->runCommand('restore', [
95 'backup-zip' => $zipFile,
98 $result->assertErrorExit();
99 $result->assertStderrContains("Provided ZIP backup [{$zipFile}] does not have any expected restorable content.");
102 public function test_limited_restore_using_app_directory_option()
104 $zipFile = $this->buildZip(function (\ZipArchive $zip) {
105 $zip->addFromString('db.sql', "CREATE TABLE zz_testing (names varchar(255));");
106 $zip->addFromString('themes/hello.txt', "limited restore test!");
111 $result = $this->runCommand('restore', [
112 'backup-zip' => $zipFile,
113 '--app-directory' => '/var/www/bookstack'
116 $result->assertSuccessfulExit();
117 $result->assertStdoutContains('❌ .env Config File');
118 $result->assertStdoutContains('✔ Themes Folder');
119 $result->assertStdoutContains('❌ Public File Uploads');
120 $result->assertStdoutContains('❌ Private File Uploads');
121 $result->assertStdoutContains('✔ Database Dump');
122 $this->assertStringEqualsFile('/var/www/bookstack/themes/hello.txt', 'limited restore test!');
124 unlink('/var/www/bookstack/themes/hello.txt');
125 $mysql = new mysqli('db', 'bookstack', 'bookstack', 'bookstack');
126 $mysql->query("DROP TABLE zz_testing;");
129 public function test_restore_with_symlinked_content_folders()
131 $zipFile = $this->buildZip(function (\ZipArchive $zip) {
132 $zip->addFromString('.env', "APP_KEY=abc123\nAPP_URL=https://example.com");
133 $zip->addFromString('public/uploads/test.txt', 'hello-public-uploads');
134 $zip->addFromString('storage/uploads/test.txt', 'hello-storage-uploads');
135 $zip->addFromString('themes/test.txt', 'hello-themes');
138 exec('cp -r /var/www/bookstack /var/www/bookstack-symlink-restore');
139 chdir('/var/www/bookstack-symlink-restore');
142 $symlinkPaths = ['public/uploads', 'storage/uploads', '.env', 'themes'];
143 foreach ($symlinkPaths as $path) {
144 $targetFile = str_replace('/', '-', $path);
147 exec("mv /var/www/bookstack-symlink-restore/{$path} /symlinks/{$targetFile}", $output, $code);
148 exec("ln -s /symlinks/{$targetFile} /var/www/bookstack-symlink-restore/{$path}", $output, $code);
150 $this->fail("Error when setting up symlinks");
154 $result = $this->runCommand('restore', [
155 'backup-zip' => $zipFile,
158 $result->assertSuccessfulExit();
160 $this->assertStringEqualsFile('/var/www/bookstack-symlink-restore/public/uploads/test.txt', 'hello-public-uploads');
161 $this->assertStringEqualsFile('/var/www/bookstack-symlink-restore/storage/uploads/test.txt', 'hello-storage-uploads');
162 $this->assertStringEqualsFile('/var/www/bookstack-symlink-restore/themes/test.txt', 'hello-themes');
164 exec('rm -rf /var/www/bookstack-symlink-restore');
165 exec('rm -rf /symlinks');
168 protected function buildZip(callable $builder): string
170 $zipFile = tempnam(sys_get_temp_dir(), 'cli-test');
171 $testZip = new \ZipArchive('');
172 $testZip->open($zipFile);