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;
9 class ImageTest extends TestCase
14 public function test_image_upload()
16 $page = Page::first();
17 $admin = $this->getAdmin();
18 $this->actingAs($admin);
20 $imgDetails = $this->uploadGalleryImage($page);
21 $relPath = $imgDetails['path'];
23 $this->assertTrue(file_exists(public_path($relPath)), 'Uploaded image found at path: '. public_path($relPath));
25 $this->deleteImage($relPath);
27 $this->assertDatabaseHas('images', [
28 'url' => $this->baseUrl . $relPath,
30 'uploaded_to' => $page->id,
32 'created_by' => $admin->id,
33 'updated_by' => $admin->id,
34 'name' => $imgDetails['name'],
38 public function test_image_edit()
40 $editor = $this->getEditor();
41 $this->actingAs($editor);
43 $imgDetails = $this->uploadGalleryImage();
44 $image = Image::query()->first();
46 $newName = str_random();
47 $update = $this->put('/images/' . $image->id, ['name' => $newName]);
48 $update->assertSuccessful();
55 $this->deleteImage($imgDetails['path']);
57 $this->assertDatabaseHas('images', [
63 public function test_gallery_get_list_format()
67 $imgDetails = $this->uploadGalleryImage();
68 $image = Image::query()->first();
70 $emptyJson = ['images' => [], 'has_more' => false];
75 'name' => $imgDetails['name'],
81 $pageId = $imgDetails['page']->id;
82 $firstPageRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}");
83 $firstPageRequest->assertSuccessful()->assertJson($resultJson);
85 $secondPageRequest = $this->get("/images/gallery?page=2&uploaded_to={$pageId}");
86 $secondPageRequest->assertSuccessful()->assertExactJson($emptyJson);
88 $namePartial = substr($imgDetails['name'], 0, 3);
89 $searchHitRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}&search={$namePartial}");
90 $searchHitRequest->assertSuccessful()->assertJson($resultJson);
92 $namePartial = str_random(16);
93 $searchHitRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}&search={$namePartial}");
94 $searchHitRequest->assertSuccessful()->assertExactJson($emptyJson);
97 public function test_image_usage()
99 $page = Page::first();
100 $editor = $this->getEditor();
101 $this->actingAs($editor);
103 $imgDetails = $this->uploadGalleryImage($page);
105 $image = Image::query()->first();
106 $page->html = '<img src="'.$image->url.'">';
109 $usage = $this->get('/images/usage/' . $image->id);
110 $usage->assertSuccessful();
114 'name' => $page->name
118 $this->deleteImage($imgDetails['path']);
121 public function test_php_files_cannot_be_uploaded()
123 $page = Page::first();
124 $admin = $this->getAdmin();
125 $this->actingAs($admin);
127 $fileName = 'bad.php';
128 $relPath = $this->getTestImagePath('gallery', $fileName);
129 $this->deleteImage($relPath);
131 $file = $this->getTestImage($fileName);
132 $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);
133 $upload->assertStatus(302);
135 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');
137 $this->assertDatabaseMissing('images', [
143 public function test_php_like_files_cannot_be_uploaded()
145 $page = Page::first();
146 $admin = $this->getAdmin();
147 $this->actingAs($admin);
149 $fileName = 'bad.phtml';
150 $relPath = $this->getTestImagePath('gallery', $fileName);
151 $this->deleteImage($relPath);
153 $file = $this->getTestImage($fileName);
154 $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);
155 $upload->assertStatus(302);
157 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');
160 public function test_files_with_double_extensions_cannot_be_uploaded()
162 $page = Page::first();
163 $admin = $this->getAdmin();
164 $this->actingAs($admin);
166 $fileName = 'bad.phtml.png';
167 $relPath = $this->getTestImagePath('gallery', $fileName);
168 $this->deleteImage($relPath);
170 $file = $this->getTestImage($fileName);
171 $upload = $this->withHeader('Content-Type', 'image/png')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);
172 $upload->assertStatus(302);
174 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded double extension file was uploaded but should have been stopped');
177 public function test_secure_images_uploads_to_correct_place()
179 config()->set('filesystems.images', 'local_secure');
181 $galleryFile = $this->getTestImage('my-secure-test-upload.png');
182 $page = Page::first();
183 $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m') . '/my-secure-test-upload.png');
185 $upload = $this->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
186 $upload->assertStatus(200);
188 $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
190 if (file_exists($expectedPath)) {
191 unlink($expectedPath);
195 public function test_secure_images_included_in_exports()
197 config()->set('filesystems.images', 'local_secure');
199 $galleryFile = $this->getTestImage('my-secure-test-upload.png');
200 $page = Page::first();
201 $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m') . '/my-secure-test-upload.png');
203 $upload = $this->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
204 $imageUrl = json_decode($upload->getContent(), true)['url'];
205 $page->html .= "<img src=\"{$imageUrl}\">";
207 $upload->assertStatus(200);
209 $encodedImageContent = base64_encode(file_get_contents($expectedPath));
210 $export = $this->get($page->getUrl('/export/html'));
211 $this->assertTrue(str_contains($export->getContent(), $encodedImageContent), 'Uploaded image in export content');
213 if (file_exists($expectedPath)) {
214 unlink($expectedPath);
218 public function test_system_images_remain_public()
220 config()->set('filesystems.images', 'local_secure');
222 $galleryFile = $this->getTestImage('my-system-test-upload.png');
223 $expectedPath = public_path('uploads/images/system/' . Date('Y-m') . '/my-system-test-upload.png');
225 $upload = $this->call('POST', '/settings', [], [], ['app_logo' => $galleryFile], []);
226 $upload->assertRedirect('/settings');
228 $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
230 if (file_exists($expectedPath)) {
231 unlink($expectedPath);
235 public function test_image_delete()
237 $page = Page::first();
239 $imageName = 'first-image.png';
241 $this->uploadImage($imageName, $page->id);
242 $image = Image::first();
243 $relPath = $this->getTestImagePath('gallery', $imageName);
245 $delete = $this->delete( '/images/' . $image->id);
246 $delete->assertStatus(200);
248 $this->assertDatabaseMissing('images', [
249 'url' => $this->baseUrl . $relPath,
253 $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded image has not been deleted as expected');
256 public function testBase64Get()
258 $page = Page::first();
260 $imageName = 'first-image.png';
262 $this->uploadImage($imageName, $page->id);
263 $image = Image::first();
264 $image->type = 'drawio';
267 $imageGet = $this->getJson("/images/drawio/base64/{$image->id}");
268 $imageGet->assertJson([
269 'content' => 'iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
273 public function test_drawing_base64_upload()
275 $page = Page::first();
276 $editor = $this->getEditor();
277 $this->actingAs($editor);
279 $upload = $this->postJson('images/drawio', [
280 'uploaded_to' => $page->id,
281 'image' => 'image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
284 $upload->assertStatus(200);
285 $upload->assertJson([
287 'uploaded_to' => $page->id,
288 'created_by' => $editor->id,
289 'updated_by' => $editor->id,
292 $image = Image::where('type', '=', 'drawio')->first();
293 $this->assertTrue(file_exists(public_path($image->path)), 'Uploaded image not found at path: '. public_path($image->path));
295 $testImageData = file_get_contents($this->getTestImageFilePath());
296 $uploadedImageData = file_get_contents(public_path($image->path));
297 $this->assertTrue($testImageData === $uploadedImageData, "Uploaded image file data does not match our test image as expected");
300 protected function getTestProfileImage()
302 $imageName = 'profile.png';
303 $relPath = $this->getTestImagePath('user', $imageName);
304 $this->deleteImage($relPath);
306 return $this->getTestImage($imageName);
309 public function test_user_image_upload()
311 $editor = $this->getEditor();
312 $admin = $this->getAdmin();
313 $this->actingAs($admin);
315 $file = $this->getTestProfileImage();
316 $this->call('PUT', '/settings/users/' . $editor->id, [], [], ['profile_image' => $file], []);
318 $this->assertDatabaseHas('images', [
320 'uploaded_to' => $editor->id,
321 'created_by' => $admin->id,
325 public function test_user_images_deleted_on_user_deletion()
327 $editor = $this->getEditor();
328 $this->actingAs($editor);
330 $file = $this->getTestProfileImage();
331 $this->call('PUT', '/settings/users/' . $editor->id, [], [], ['profile_image' => $file], []);
333 $profileImages = Image::where('type', '=', 'user')->where('created_by', '=', $editor->id)->get();
334 $this->assertTrue($profileImages->count() === 1, "Found profile images does not match upload count");
336 $imagePath = public_path($profileImages->first()->path);
337 $this->assertTrue(file_exists($imagePath));
339 $userDelete = $this->asAdmin()->delete("/settings/users/{$editor->id}");
340 $userDelete->assertStatus(302);
342 $this->assertDatabaseMissing('images', [
344 'created_by' => $editor->id
346 $this->assertDatabaseMissing('images', [
348 'uploaded_to' => $editor->id
351 $this->assertFalse(file_exists($imagePath));
354 public function test_deleted_unused_images()
356 $page = Page::first();
357 $admin = $this->getAdmin();
358 $this->actingAs($admin);
360 $imageName = 'unused-image.png';
361 $relPath = $this->getTestImagePath('gallery', $imageName);
362 $this->deleteImage($relPath);
364 $upload = $this->uploadImage($imageName, $page->id);
365 $upload->assertStatus(200);
366 $image = Image::where('type', '=', 'gallery')->first();
368 $pageRepo = app(PageRepo::class);
369 $pageRepo->updatePage($page, $page->book_id, [
370 'name' => $page->name,
371 'html' => $page->html . "<img src=\"{$image->url}\">",
375 // Ensure no images are reported as deletable
376 $imageService = app(ImageService::class);
377 $toDelete = $imageService->deleteUnusedImages(true, true);
378 $this->assertCount(0, $toDelete);
380 // Save a revision of our page without the image;
381 $pageRepo->updatePage($page, $page->book_id, [
382 'name' => $page->name,
383 'html' => "<p>Hello</p>",
387 // Ensure revision images are picked up okay
388 $imageService = app(ImageService::class);
389 $toDelete = $imageService->deleteUnusedImages(true, true);
390 $this->assertCount(0, $toDelete);
391 $toDelete = $imageService->deleteUnusedImages(false, true);
392 $this->assertCount(1, $toDelete);
394 // Check image is found when revisions are destroyed
395 $page->revisions()->delete();
396 $toDelete = $imageService->deleteUnusedImages(true, true);
397 $this->assertCount(1, $toDelete);
399 // Check the image is deleted
400 $absPath = public_path($relPath);
401 $this->assertTrue(file_exists($absPath), "Existing uploaded file at path {$absPath} exists");
402 $toDelete = $imageService->deleteUnusedImages(true, false);
403 $this->assertCount(1, $toDelete);
404 $this->assertFalse(file_exists($absPath));
406 $this->deleteImage($relPath);