2021-06-26 15:23:15 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace BookStack\Uploads;
|
2015-12-07 23:00:34 +00:00
|
|
|
|
2018-09-25 11:30:50 +00:00
|
|
|
use BookStack\Auth\Permissions\PermissionService;
|
2020-11-22 00:17:45 +00:00
|
|
|
use BookStack\Entities\Models\Page;
|
2019-12-22 12:44:49 +00:00
|
|
|
use BookStack\Exceptions\ImageUploadException;
|
|
|
|
use Exception;
|
2019-04-27 13:18:00 +00:00
|
|
|
use Illuminate\Database\Eloquent\Builder;
|
2015-12-07 23:00:34 +00:00
|
|
|
use Symfony\Component\HttpFoundation\File\UploadedFile;
|
|
|
|
|
|
|
|
class ImageRepo
|
|
|
|
{
|
|
|
|
protected $image;
|
2015-12-09 19:50:17 +00:00
|
|
|
protected $imageService;
|
2016-08-14 11:29:35 +00:00
|
|
|
protected $restrictionService;
|
2016-04-03 13:59:54 +00:00
|
|
|
protected $page;
|
2015-12-07 23:00:34 +00:00
|
|
|
|
2021-10-18 10:42:50 +00:00
|
|
|
protected static $supportedExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
|
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
/**
|
|
|
|
* ImageRepo constructor.
|
|
|
|
*/
|
2019-04-27 13:18:00 +00:00
|
|
|
public function __construct(
|
|
|
|
Image $image,
|
|
|
|
ImageService $imageService,
|
|
|
|
PermissionService $permissionService,
|
|
|
|
Page $page
|
2019-05-05 13:54:37 +00:00
|
|
|
) {
|
2015-12-07 23:00:34 +00:00
|
|
|
$this->image = $image;
|
2015-12-09 19:50:17 +00:00
|
|
|
$this->imageService = $imageService;
|
2016-08-14 11:29:35 +00:00
|
|
|
$this->restrictionService = $permissionService;
|
2016-04-03 13:59:54 +00:00
|
|
|
$this->page = $page;
|
2015-12-07 23:00:34 +00:00
|
|
|
}
|
|
|
|
|
2021-10-18 10:42:50 +00:00
|
|
|
/**
|
|
|
|
* Check if the given image extension is supported by BookStack.
|
|
|
|
*/
|
|
|
|
public function imageExtensionSupported(string $extension): bool
|
|
|
|
{
|
2021-10-26 01:39:16 +00:00
|
|
|
return in_array(trim($extension, ". \t\n\r\0\x0B"), static::$supportedExtensions);
|
2021-10-18 10:42:50 +00:00
|
|
|
}
|
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
/**
|
|
|
|
* Get an image with the given id.
|
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
public function getById($id): Image
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
|
|
|
return $this->image->findOrFail($id);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-04-03 13:59:54 +00:00
|
|
|
* Execute a paginated query, returning in a standard format.
|
|
|
|
* Also runs the query through the restriction system.
|
2015-12-07 23:00:34 +00:00
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
private function returnPaginated($query, $page = 1, $pageSize = 24): array
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
2019-04-27 13:18:00 +00:00
|
|
|
$images = $query->orderBy('created_at', 'desc')->skip($pageSize * ($page - 1))->take($pageSize + 1)->get();
|
2015-12-07 23:00:34 +00:00
|
|
|
$hasMore = count($images) > $pageSize;
|
|
|
|
|
2019-04-27 13:18:00 +00:00
|
|
|
$returnImages = $images->take($pageSize);
|
2015-12-07 23:00:34 +00:00
|
|
|
$returnImages->each(function ($image) {
|
|
|
|
$this->loadThumbs($image);
|
|
|
|
});
|
|
|
|
|
|
|
|
return [
|
2021-06-26 15:23:15 +00:00
|
|
|
'images' => $returnImages,
|
|
|
|
'has_more' => $hasMore,
|
2015-12-07 23:00:34 +00:00
|
|
|
];
|
|
|
|
}
|
|
|
|
|
2016-04-03 13:59:54 +00:00
|
|
|
/**
|
2019-04-27 13:18:00 +00:00
|
|
|
* Fetch a list of images in a paginated format, filtered by image type.
|
|
|
|
* Can be filtered by uploaded to and also by name.
|
2016-04-03 13:59:54 +00:00
|
|
|
*/
|
2019-04-27 13:18:00 +00:00
|
|
|
public function getPaginatedByType(
|
|
|
|
string $type,
|
|
|
|
int $page = 0,
|
|
|
|
int $pageSize = 24,
|
|
|
|
int $uploadedTo = null,
|
|
|
|
string $search = null,
|
|
|
|
callable $whereClause = null
|
2021-03-07 22:24:05 +00:00
|
|
|
): array {
|
2019-04-27 13:18:00 +00:00
|
|
|
$imageQuery = $this->image->newQuery()->where('type', '=', strtolower($type));
|
2019-04-21 14:52:29 +00:00
|
|
|
|
|
|
|
if ($uploadedTo !== null) {
|
2019-04-27 13:18:00 +00:00
|
|
|
$imageQuery = $imageQuery->where('uploaded_to', '=', $uploadedTo);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($search !== null) {
|
|
|
|
$imageQuery = $imageQuery->where('name', 'LIKE', '%' . $search . '%');
|
2019-04-21 14:52:29 +00:00
|
|
|
}
|
2016-04-03 13:59:54 +00:00
|
|
|
|
2019-05-04 14:48:15 +00:00
|
|
|
// Filter by page access
|
2021-03-14 19:52:07 +00:00
|
|
|
$imageQuery = $this->restrictionService->filterRelatedEntity(Page::class, $imageQuery, 'images', 'uploaded_to');
|
2019-04-21 14:52:29 +00:00
|
|
|
|
2019-04-27 13:18:00 +00:00
|
|
|
if ($whereClause !== null) {
|
|
|
|
$imageQuery = $imageQuery->where($whereClause);
|
2019-04-21 14:52:29 +00:00
|
|
|
}
|
|
|
|
|
2019-04-27 13:18:00 +00:00
|
|
|
return $this->returnPaginated($imageQuery, $page, $pageSize);
|
2016-04-03 13:59:54 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2019-04-27 13:18:00 +00:00
|
|
|
* Get paginated gallery images within a specific page or book.
|
2016-04-03 13:59:54 +00:00
|
|
|
*/
|
2019-04-27 13:18:00 +00:00
|
|
|
public function getEntityFiltered(
|
|
|
|
string $type,
|
|
|
|
string $filterType = null,
|
|
|
|
int $page = 0,
|
|
|
|
int $pageSize = 24,
|
|
|
|
int $uploadedTo = null,
|
|
|
|
string $search = null
|
2021-03-07 22:24:05 +00:00
|
|
|
): array {
|
2019-04-27 13:18:00 +00:00
|
|
|
$contextPage = $this->page->findOrFail($uploadedTo);
|
|
|
|
$parentFilter = null;
|
2016-04-03 13:59:54 +00:00
|
|
|
|
2019-04-27 13:18:00 +00:00
|
|
|
if ($filterType === 'book' || $filterType === 'page') {
|
2019-05-05 13:54:37 +00:00
|
|
|
$parentFilter = function (Builder $query) use ($filterType, $contextPage) {
|
2019-04-27 13:18:00 +00:00
|
|
|
if ($filterType === 'page') {
|
|
|
|
$query->where('uploaded_to', '=', $contextPage->id);
|
|
|
|
} elseif ($filterType === 'book') {
|
2020-12-18 13:56:00 +00:00
|
|
|
$validPageIds = $contextPage->book->pages()->visible()->get(['id'])->pluck('id')->toArray();
|
2019-04-27 13:18:00 +00:00
|
|
|
$query->whereIn('uploaded_to', $validPageIds);
|
|
|
|
}
|
|
|
|
};
|
2016-04-03 13:59:54 +00:00
|
|
|
}
|
|
|
|
|
2019-04-27 13:18:00 +00:00
|
|
|
return $this->getPaginatedByType($type, $page, $pageSize, null, $search, $parentFilter);
|
2016-04-03 13:59:54 +00:00
|
|
|
}
|
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
/**
|
|
|
|
* Save a new image into storage and return the new image.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws ImageUploadException
|
2015-12-07 23:00:34 +00:00
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
public function saveNew(UploadedFile $uploadFile, string $type, int $uploadedTo = 0, int $resizeWidth = null, int $resizeHeight = null, bool $keepRatio = true): Image
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
2019-05-04 14:48:15 +00:00
|
|
|
$image = $this->imageService->saveNewFromUpload($uploadFile, $type, $uploadedTo, $resizeWidth, $resizeHeight, $keepRatio);
|
2015-12-07 23:00:34 +00:00
|
|
|
$this->loadThumbs($image);
|
2021-06-26 15:23:15 +00:00
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
return $image;
|
|
|
|
}
|
|
|
|
|
2021-06-02 20:34:34 +00:00
|
|
|
/**
|
|
|
|
* Save a new image from an existing image data string.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2021-06-02 20:34:34 +00:00
|
|
|
* @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);
|
2021-06-26 15:23:15 +00:00
|
|
|
|
2021-06-02 20:34:34 +00:00
|
|
|
return $image;
|
|
|
|
}
|
|
|
|
|
2017-12-30 15:24:03 +00:00
|
|
|
/**
|
2019-12-22 12:44:49 +00:00
|
|
|
* Save a drawing the the database.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws ImageUploadException
|
2017-12-30 15:24:03 +00:00
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
public function saveDrawing(string $base64Uri, int $uploadedTo): Image
|
2017-12-30 15:24:03 +00:00
|
|
|
{
|
2020-04-03 23:48:32 +00:00
|
|
|
$name = 'Drawing-' . strval(user()->id) . '-' . strval(time()) . '.png';
|
2021-06-26 15:23:15 +00:00
|
|
|
|
2019-12-22 12:44:49 +00:00
|
|
|
return $this->imageService->saveNewFromBase64Uri($base64Uri, $name, 'drawio', $uploadedTo);
|
2017-12-30 15:24:03 +00:00
|
|
|
}
|
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
/**
|
|
|
|
* Update the details of an image via an array of properties.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws ImageUploadException
|
|
|
|
* @throws Exception
|
2015-12-07 23:00:34 +00:00
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
public function updateImageDetails(Image $image, $updateDetails): Image
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
|
|
|
$image->fill($updateDetails);
|
|
|
|
$image->save();
|
|
|
|
$this->loadThumbs($image);
|
2021-06-26 15:23:15 +00:00
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
return $image;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-05-13 16:41:35 +00:00
|
|
|
* Destroys an Image object along with its revisions, files and thumbnails.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws Exception
|
2015-12-07 23:00:34 +00:00
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
public function destroyImage(Image $image = null): bool
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
2019-05-04 14:48:15 +00:00
|
|
|
if ($image) {
|
|
|
|
$this->imageService->destroy($image);
|
|
|
|
}
|
2021-06-26 15:23:15 +00:00
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2019-05-04 14:48:15 +00:00
|
|
|
/**
|
|
|
|
* Destroy all images of a certain type.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws Exception
|
2019-05-04 14:48:15 +00:00
|
|
|
*/
|
|
|
|
public function destroyByType(string $imageType)
|
|
|
|
{
|
|
|
|
$images = $this->image->where('type', '=', $imageType)->get();
|
|
|
|
foreach ($images as $image) {
|
|
|
|
$this->destroyImage($image);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-07 23:00:34 +00:00
|
|
|
/**
|
|
|
|
* Load thumbnails onto an image object.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws Exception
|
2015-12-07 23:00:34 +00:00
|
|
|
*/
|
2020-07-24 23:20:58 +00:00
|
|
|
public function loadThumbs(Image $image)
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
|
|
|
$image->thumbs = [
|
2019-05-04 17:11:00 +00:00
|
|
|
'gallery' => $this->getThumbnail($image, 150, 150, false),
|
2021-06-26 15:23:15 +00:00
|
|
|
'display' => $this->getThumbnail($image, 1680, null, true),
|
2015-12-07 23:00:34 +00:00
|
|
|
];
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* 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.
|
2021-06-26 15:23:15 +00:00
|
|
|
*
|
2019-12-22 12:44:49 +00:00
|
|
|
* @throws Exception
|
2015-12-07 23:00:34 +00:00
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
protected function getThumbnail(Image $image, ?int $width = 220, ?int $height = 220, bool $keepRatio = false): ?string
|
2015-12-07 23:00:34 +00:00
|
|
|
{
|
2016-11-12 12:41:34 +00:00
|
|
|
try {
|
|
|
|
return $this->imageService->getThumbnail($image, $width, $height, $keepRatio);
|
2019-12-22 12:44:49 +00:00
|
|
|
} catch (Exception $exception) {
|
2018-01-13 11:11:23 +00:00
|
|
|
return null;
|
2016-11-12 12:41:34 +00:00
|
|
|
}
|
2015-12-07 23:00:34 +00:00
|
|
|
}
|
|
|
|
|
2017-12-30 15:24:03 +00:00
|
|
|
/**
|
|
|
|
* Get the raw image data from an Image.
|
|
|
|
*/
|
2019-12-22 12:44:49 +00:00
|
|
|
public function getImageData(Image $image): ?string
|
2017-12-30 15:24:03 +00:00
|
|
|
{
|
|
|
|
try {
|
|
|
|
return $this->imageService->getImageData($image);
|
2019-12-22 12:44:49 +00:00
|
|
|
} catch (Exception $exception) {
|
2017-12-30 15:24:03 +00:00
|
|
|
return null;
|
|
|
|
}
|
|
|
|
}
|
2020-07-24 23:20:58 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* 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();
|
|
|
|
}
|
2018-01-28 16:58:52 +00:00
|
|
|
}
|