1 <?php namespace Tests\Uploads;
3 use BookStack\Entities\Repos\PageRepo;
4 use BookStack\Uploads\Image;
5 use BookStack\Entities\Page;
6 use BookStack\Uploads\ImageService;
7 use Illuminate\Support\Str;
10 class ImageTest extends TestCase
15 public function test_image_upload()
17 $page = Page::first();
18 $admin = $this->getAdmin();
19 $this->actingAs($admin);
21 $imgDetails = $this->uploadGalleryImage($page);
22 $relPath = $imgDetails['path'];
24 $this->assertTrue(file_exists(public_path($relPath)), 'Uploaded image found at path: '. public_path($relPath));
26 $this->deleteImage($relPath);
28 $this->assertDatabaseHas('images', [
29 'url' => $this->baseUrl . $relPath,
31 'uploaded_to' => $page->id,
33 'created_by' => $admin->id,
34 'updated_by' => $admin->id,
35 'name' => $imgDetails['name'],
39 public function test_image_edit()
41 $editor = $this->getEditor();
42 $this->actingAs($editor);
44 $imgDetails = $this->uploadGalleryImage();
45 $image = Image::query()->first();
47 $newName = Str::random();
48 $update = $this->put('/images/' . $image->id, ['name' => $newName]);
49 $update->assertSuccessful();
56 $this->deleteImage($imgDetails['path']);
58 $this->assertDatabaseHas('images', [
64 public function test_gallery_get_list_format()
68 $imgDetails = $this->uploadGalleryImage();
69 $image = Image::query()->first();
71 $emptyJson = ['images' => [], 'has_more' => false];
76 'name' => $imgDetails['name'],
82 $pageId = $imgDetails['page']->id;
83 $firstPageRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}");
84 $firstPageRequest->assertSuccessful()->assertJson($resultJson);
86 $secondPageRequest = $this->get("/images/gallery?page=2&uploaded_to={$pageId}");
87 $secondPageRequest->assertSuccessful()->assertExactJson($emptyJson);
89 $namePartial = substr($imgDetails['name'], 0, 3);
90 $searchHitRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}&search={$namePartial}");
91 $searchHitRequest->assertSuccessful()->assertJson($resultJson);
93 $namePartial = Str::random(16);
94 $searchHitRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}&search={$namePartial}");
95 $searchHitRequest->assertSuccessful()->assertExactJson($emptyJson);
98 public function test_image_usage()
100 $page = Page::first();
101 $editor = $this->getEditor();
102 $this->actingAs($editor);
104 $imgDetails = $this->uploadGalleryImage($page);
106 $image = Image::query()->first();
107 $page->html = '<img src="'.$image->url.'">';
110 $usage = $this->get('/images/usage/' . $image->id);
111 $usage->assertSuccessful();
115 'name' => $page->name
119 $this->deleteImage($imgDetails['path']);
122 public function test_php_files_cannot_be_uploaded()
124 $page = Page::first();
125 $admin = $this->getAdmin();
126 $this->actingAs($admin);
128 $fileName = 'bad.php';
129 $relPath = $this->getTestImagePath('gallery', $fileName);
130 $this->deleteImage($relPath);
132 $file = $this->getTestImage($fileName);
133 $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);
134 $upload->assertStatus(302);
136 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');
138 $this->assertDatabaseMissing('images', [
144 public function test_php_like_files_cannot_be_uploaded()
146 $page = Page::first();
147 $admin = $this->getAdmin();
148 $this->actingAs($admin);
150 $fileName = 'bad.phtml';
151 $relPath = $this->getTestImagePath('gallery', $fileName);
152 $this->deleteImage($relPath);
154 $file = $this->getTestImage($fileName);
155 $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);
156 $upload->assertStatus(302);
158 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');
161 public function test_files_with_double_extensions_cannot_be_uploaded()
163 $page = Page::first();
164 $admin = $this->getAdmin();
165 $this->actingAs($admin);
167 $fileName = 'bad.phtml.png';
168 $relPath = $this->getTestImagePath('gallery', $fileName);
169 $this->deleteImage($relPath);
171 $file = $this->getTestImage($fileName);
172 $upload = $this->withHeader('Content-Type', 'image/png')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);
173 $upload->assertStatus(302);
175 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded double extension file was uploaded but should have been stopped');
178 public function test_secure_images_uploads_to_correct_place()
180 config()->set('filesystems.images', 'local_secure');
182 $galleryFile = $this->getTestImage('my-secure-test-upload.png');
183 $page = Page::first();
184 $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m') . '/my-secure-test-upload.png');
186 $upload = $this->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
187 $upload->assertStatus(200);
189 $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
191 if (file_exists($expectedPath)) {
192 unlink($expectedPath);
196 public function test_secure_images_included_in_exports()
198 config()->set('filesystems.images', 'local_secure');
200 $galleryFile = $this->getTestImage('my-secure-test-upload.png');
201 $page = Page::first();
202 $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m') . '/my-secure-test-upload.png');
204 $upload = $this->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
205 $imageUrl = json_decode($upload->getContent(), true)['url'];
206 $page->html .= "<img src=\"{$imageUrl}\">";
208 $upload->assertStatus(200);
210 $encodedImageContent = base64_encode(file_get_contents($expectedPath));
211 $export = $this->get($page->getUrl('/export/html'));
212 $this->assertTrue(strpos($export->getContent(), $encodedImageContent) !== false, 'Uploaded image in export content');
214 if (file_exists($expectedPath)) {
215 unlink($expectedPath);
219 public function test_system_images_remain_public()
221 config()->set('filesystems.images', 'local_secure');
223 $galleryFile = $this->getTestImage('my-system-test-upload.png');
224 $expectedPath = public_path('uploads/images/system/' . Date('Y-m') . '/my-system-test-upload.png');
226 $upload = $this->call('POST', '/settings', [], [], ['app_logo' => $galleryFile], []);
227 $upload->assertRedirect('/settings');
229 $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
231 if (file_exists($expectedPath)) {
232 unlink($expectedPath);
236 public function test_image_delete()
238 $page = Page::first();
240 $imageName = 'first-image.png';
242 $this->uploadImage($imageName, $page->id);
243 $image = Image::first();
244 $relPath = $this->getTestImagePath('gallery', $imageName);
246 $delete = $this->delete( '/images/' . $image->id);
247 $delete->assertStatus(200);
249 $this->assertDatabaseMissing('images', [
250 'url' => $this->baseUrl . $relPath,
254 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded image has not been deleted as expected');
257 public function testBase64Get()
259 $page = Page::first();
261 $imageName = 'first-image.png';
263 $this->uploadImage($imageName, $page->id);
264 $image = Image::first();
265 $image->type = 'drawio';
268 $imageGet = $this->getJson("/images/drawio/base64/{$image->id}");
269 $imageGet->assertJson([
270 'content' => 'iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
274 public function test_drawing_base64_upload()
276 $page = Page::first();
277 $editor = $this->getEditor();
278 $this->actingAs($editor);
280 $upload = $this->postJson('images/drawio', [
281 'uploaded_to' => $page->id,
282 'image' => 'image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
285 $upload->assertStatus(200);
286 $upload->assertJson([
288 'uploaded_to' => $page->id,
289 'created_by' => $editor->id,
290 'updated_by' => $editor->id,
293 $image = Image::where('type', '=', 'drawio')->first();
294 $this->assertTrue(file_exists(public_path($image->path)), 'Uploaded image not found at path: '. public_path($image->path));
296 $testImageData = file_get_contents($this->getTestImageFilePath());
297 $uploadedImageData = file_get_contents(public_path($image->path));
298 $this->assertTrue($testImageData === $uploadedImageData, "Uploaded image file data does not match our test image as expected");
301 protected function getTestProfileImage()
303 $imageName = 'profile.png';
304 $relPath = $this->getTestImagePath('user', $imageName);
305 $this->deleteImage($relPath);
307 return $this->getTestImage($imageName);
310 public function test_user_image_upload()
312 $editor = $this->getEditor();
313 $admin = $this->getAdmin();
314 $this->actingAs($admin);
316 $file = $this->getTestProfileImage();
317 $this->call('PUT', '/settings/users/' . $editor->id, [], [], ['profile_image' => $file], []);
319 $this->assertDatabaseHas('images', [
321 'uploaded_to' => $editor->id,
322 'created_by' => $admin->id,
326 public function test_user_images_deleted_on_user_deletion()
328 $editor = $this->getEditor();
329 $this->actingAs($editor);
331 $file = $this->getTestProfileImage();
332 $this->call('PUT', '/settings/users/' . $editor->id, [], [], ['profile_image' => $file], []);
334 $profileImages = Image::where('type', '=', 'user')->where('created_by', '=', $editor->id)->get();
335 $this->assertTrue($profileImages->count() === 1, "Found profile images does not match upload count");
337 $imagePath = public_path($profileImages->first()->path);
338 $this->assertTrue(file_exists($imagePath));
340 $userDelete = $this->asAdmin()->delete("/settings/users/{$editor->id}");
341 $userDelete->assertStatus(302);
343 $this->assertDatabaseMissing('images', [
345 'created_by' => $editor->id
347 $this->assertDatabaseMissing('images', [
349 'uploaded_to' => $editor->id
352 $this->assertFalse(file_exists($imagePath));
355 public function test_deleted_unused_images()
357 $page = Page::first();
358 $admin = $this->getAdmin();
359 $this->actingAs($admin);
361 $imageName = 'unused-image.png';
362 $relPath = $this->getTestImagePath('gallery', $imageName);
363 $this->deleteImage($relPath);
365 $upload = $this->uploadImage($imageName, $page->id);
366 $upload->assertStatus(200);
367 $image = Image::where('type', '=', 'gallery')->first();
369 $pageRepo = app(PageRepo::class);
370 $pageRepo->updatePage($page, $page->book_id, [
371 'name' => $page->name,
372 'html' => $page->html . "<img src=\"{$image->url}\">",
376 // Ensure no images are reported as deletable
377 $imageService = app(ImageService::class);
378 $toDelete = $imageService->deleteUnusedImages(true, true);
379 $this->assertCount(0, $toDelete);
381 // Save a revision of our page without the image;
382 $pageRepo->updatePage($page, $page->book_id, [
383 'name' => $page->name,
384 'html' => "<p>Hello</p>",
388 // Ensure revision images are picked up okay
389 $imageService = app(ImageService::class);
390 $toDelete = $imageService->deleteUnusedImages(true, true);
391 $this->assertCount(0, $toDelete);
392 $toDelete = $imageService->deleteUnusedImages(false, true);
393 $this->assertCount(1, $toDelete);
395 // Check image is found when revisions are destroyed
396 $page->revisions()->delete();
397 $toDelete = $imageService->deleteUnusedImages(true, true);
398 $this->assertCount(1, $toDelete);
400 // Check the image is deleted
401 $absPath = public_path($relPath);
402 $this->assertTrue(file_exists($absPath), "Existing uploaded file at path {$absPath} exists");
403 $toDelete = $imageService->deleteUnusedImages(true, false);
404 $this->assertCount(1, $toDelete);
405 $this->assertFalse(file_exists($absPath));
407 $this->deleteImage($relPath);