-<?php namespace BookStack\Uploads;
+<?php
+
+namespace BookStack\Uploads;
use BookStack\Auth\Permissions\PermissionService;
-use BookStack\Entities\Page;
+use BookStack\Entities\Models\Page;
use BookStack\Exceptions\ImageUploadException;
use Exception;
use Illuminate\Database\Eloquent\Builder;
class ImageRepo
{
-
protected $image;
protected $imageService;
protected $restrictionService;
protected $page;
+ protected static $supportedExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
+
/**
* ImageRepo constructor.
*/
$this->page = $page;
}
+ /**
+ * Check if the given image extension is supported by BookStack.
+ */
+ public function imageExtensionSupported(string $extension): bool
+ {
+ return in_array(trim($extension, '. \t\n\r\0\x0B'), static::$supportedExtensions);
+ }
/**
* Get an image with the given id.
});
return [
- 'images' => $returnImages,
- 'has_more' => $hasMore
+ 'images' => $returnImages,
+ 'has_more' => $hasMore,
];
}
int $uploadedTo = null,
string $search = null,
callable $whereClause = null
- ): array
- {
+ ): array {
$imageQuery = $this->image->newQuery()->where('type', '=', strtolower($type));
if ($uploadedTo !== null) {
}
// Filter by page access
- $imageQuery = $this->restrictionService->filterRelatedEntity('page', $imageQuery, 'images', 'uploaded_to');
+ $imageQuery = $this->restrictionService->filterRelatedEntity(Page::class, $imageQuery, 'images', 'uploaded_to');
if ($whereClause !== null) {
$imageQuery = $imageQuery->where($whereClause);
int $pageSize = 24,
int $uploadedTo = null,
string $search = null
- ): array
- {
+ ): array {
$contextPage = $this->page->findOrFail($uploadedTo);
$parentFilter = null;
if ($filterType === 'page') {
$query->where('uploaded_to', '=', $contextPage->id);
} elseif ($filterType === 'book') {
- $validPageIds = $contextPage->book->pages()->get(['id'])->pluck('id')->toArray();
+ $validPageIds = $contextPage->book->pages()->visible()->get(['id'])->pluck('id')->toArray();
$query->whereIn('uploaded_to', $validPageIds);
}
};
/**
* Save a new image into storage and return the new image.
+ *
* @throws ImageUploadException
*/
public function saveNew(UploadedFile $uploadFile, string $type, int $uploadedTo = 0, int $resizeWidth = null, int $resizeHeight = null, bool $keepRatio = true): Image
{
$image = $this->imageService->saveNewFromUpload($uploadFile, $type, $uploadedTo, $resizeWidth, $resizeHeight, $keepRatio);
$this->loadThumbs($image);
+
+ return $image;
+ }
+
+ /**
+ * Save a new image from an existing image data string.
+ *
+ * @throws ImageUploadException
+ */
+ public function saveNewFromData(string $imageName, string $imageData, string $type, int $uploadedTo = 0)
+ {
+ $image = $this->imageService->saveNew($imageName, $imageData, $type, $uploadedTo);
+ $this->loadThumbs($image);
+
return $image;
}
/**
* Save a drawing the the database.
+ *
* @throws ImageUploadException
*/
public function saveDrawing(string $base64Uri, int $uploadedTo): Image
{
- $name = 'Drawing-' . user()->getShortName(40) . '-' . strval(time()) . '.png';
+ $name = 'Drawing-' . strval(user()->id) . '-' . strval(time()) . '.png';
+
return $this->imageService->saveNewFromBase64Uri($base64Uri, $name, 'drawio', $uploadedTo);
}
-
/**
* Update the details of an image via an array of properties.
+ *
* @throws ImageUploadException
* @throws Exception
*/
$image->fill($updateDetails);
$image->save();
$this->loadThumbs($image);
+
return $image;
}
/**
* Destroys an Image object along with its revisions, files and thumbnails.
+ *
* @throws Exception
*/
public function destroyImage(Image $image = null): bool
if ($image) {
$this->imageService->destroy($image);
}
+
return true;
}
/**
* Destroy all images of a certain type.
+ *
* @throws Exception
*/
public function destroyByType(string $imageType)
}
}
-
/**
* Load thumbnails onto an image object.
+ *
* @throws Exception
*/
- protected function loadThumbs(Image $image)
+ public function loadThumbs(Image $image)
{
$image->thumbs = [
'gallery' => $this->getThumbnail($image, 150, 150, false),
- 'display' => $this->getThumbnail($image, 1680, null, true)
+ 'display' => $this->getThumbnail($image, 1680, null, true),
];
}
* Get the thumbnail for an image.
* If $keepRatio is true only the width will be used.
* Checks the cache then storage to avoid creating / accessing the filesystem on every check.
+ *
* @throws Exception
*/
protected function getThumbnail(Image $image, ?int $width = 220, ?int $height = 220, bool $keepRatio = false): ?string
return null;
}
}
+
+ /**
+ * Get the user visible pages using the given image.
+ */
+ public function getPagesUsingImage(Image $image): array
+ {
+ $pages = Page::visible()
+ ->where('html', 'like', '%' . $image->url . '%')
+ ->get(['id', 'name', 'slug', 'book_id']);
+
+ foreach ($pages as $page) {
+ $page->url = $page->getUrl();
+ }
+
+ return $pages->all();
+ }
}