1 <?php namespace BookStack\Http\Controllers;
3 use BookStack\Entities\Repos\EntityRepo;
4 use BookStack\Exceptions\ImageUploadException;
5 use BookStack\Repos\PageRepo;
6 use BookStack\Uploads\Image;
7 use BookStack\Uploads\ImageRepo;
8 use Illuminate\Filesystem\Filesystem as File;
9 use Illuminate\Http\Request;
11 class ImageController extends Controller
18 * ImageController constructor.
21 * @param ImageRepo $imageRepo
23 public function __construct(Image $image, File $file, ImageRepo $imageRepo)
25 $this->image = $image;
27 $this->imageRepo = $imageRepo;
28 parent::__construct();
32 * Provide an image file from storage.
36 public function showImage(string $path)
38 $path = storage_path('uploads/images/' . $path);
39 if (!file_exists($path)) {
43 return response()->file($path);
47 * Get all images for a specific type, Paginated
48 * @param Request $request
51 * @return \Illuminate\Http\JsonResponse
53 public function getAllByType(Request $request, $type, $page = 0)
55 $uploadedToFilter = $request->get('uploaded_to', null);
57 // For user profile request, check access to user images
58 if ($type === 'user') {
59 $this->checkPermissionOrCurrentUser('users-manage', $uploadedToFilter ?? 0);
62 $imgData = $this->imageRepo->getPaginatedByType($type, $page, 24, $uploadedToFilter);
63 return response()->json($imgData);
67 * Search through images within a particular type.
70 * @param Request $request
73 public function searchByType(Request $request, $type, $page = 0)
75 $this->validate($request, [
76 'term' => 'required|string'
79 $searchTerm = $request->get('term');
80 $imgData = $this->imageRepo->searchPaginatedByType($type, $searchTerm, $page, 24);
81 return response()->json($imgData);
85 * Get gallery images with a specific filter such as book or page
88 * @param Request $request
89 * @return \Illuminate\Contracts\Routing\ResponseFactory|\Illuminate\Http\JsonResponse|\Symfony\Component\HttpFoundation\Response
91 public function getGalleryFiltered(Request $request, $filter, $page = 0)
93 $this->validate($request, [
94 'uploaded_to' => 'required|integer'
97 $validFilters = collect(['page', 'book']);
98 if (!$validFilters->contains($filter)) {
99 return response('Invalid filter', 500);
102 $pageId = $request->get('uploaded_to');
103 $imgData = $this->imageRepo->getGalleryFiltered(strtolower($filter), $pageId, $page, 24);
105 return response()->json($imgData);
108 public function uploadGalleryImage(Request $request)
113 public function uploadUserImage(Request $request)
118 public function uploadSystemImage(Request $request)
123 public function uploadCoverImage(Request $request)
129 * Upload a draw.io image into the system.
130 * @param Request $request
131 * @return \Illuminate\Contracts\Routing\ResponseFactory|\Illuminate\Http\JsonResponse|\Symfony\Component\HttpFoundation\Response
133 public function uploadDrawioImage(Request $request)
135 $this->validate($request, [
136 'image' => 'required|string',
137 'uploaded_to' => 'required|integer'
139 $uploadedTo = $request->get('uploaded_to', 0);
141 $this->checkPermission('image-create-all');
142 $imageBase64Data = $request->get('image');
145 $image = $this->imageRepo->saveDrawing($imageBase64Data, $uploadedTo);
146 } catch (ImageUploadException $e) {
147 return response($e->getMessage(), 500);
150 return response()->json($image);
154 * Handles image uploads for use on pages.
155 * @param string $type
156 * @param Request $request
157 * @return \Illuminate\Http\JsonResponse
160 public function uploadByType($type, Request $request)
162 $this->checkPermission('image-create-all');
163 $this->validate($request, [
164 'file' => 'image_extension|no_double_extension|mimes:jpeg,png,gif,bmp,webp,tiff'
167 if (!$this->imageRepo->isValidType($type)) {
168 return $this->jsonError(trans('errors.image_upload_type_error'));
171 $imageUpload = $request->file('file');
174 $uploadedTo = $request->get('uploaded_to', 0);
176 // For user profile request, check access to user images
177 if ($type === 'user') {
178 $this->checkPermissionOrCurrentUser('users-manage', $uploadedTo ?? 0);
181 $image = $this->imageRepo->saveNew($imageUpload, $type, $uploadedTo);
182 } catch (ImageUploadException $e) {
183 return response($e->getMessage(), 500);
186 return response()->json($image);
189 * Get the content of an image based64 encoded.
191 * @return \Illuminate\Http\JsonResponse|mixed
193 public function getBase64Image($id)
195 $image = $this->imageRepo->getById($id);
196 $imageData = $this->imageRepo->getImageData($image);
197 if ($imageData === null) {
198 return $this->jsonError("Image data could not be found");
200 return response()->json([
201 'content' => base64_encode($imageData)
206 * Generate a sized thumbnail for an image.
211 * @return \Illuminate\Http\JsonResponse
212 * @throws ImageUploadException
215 public function getThumbnail($id, $width, $height, $crop)
217 $this->checkPermission('image-create-all');
218 $image = $this->imageRepo->getById($id);
219 $thumbnailUrl = $this->imageRepo->getThumbnail($image, $width, $height, $crop == 'false');
220 return response()->json(['url' => $thumbnailUrl]);
224 * Update image details
226 * @param Request $request
227 * @return \Illuminate\Http\JsonResponse
228 * @throws ImageUploadException
231 public function update($id, Request $request)
233 $this->validate($request, [
234 'name' => 'required|min:2|string'
237 $image = $this->imageRepo->getById($id);
238 $this->checkOwnablePermission('image-update', $image);
240 $image = $this->imageRepo->updateImageDetails($image, $request->all());
241 return response()->json($image);
245 * Show the usage of an image on pages.
246 * @param \BookStack\Entities\Repos\EntityRepo $entityRepo
248 * @return \Illuminate\Http\JsonResponse
250 public function usage(EntityRepo $entityRepo, $id)
252 $image = $this->imageRepo->getById($id);
253 $pageSearch = $entityRepo->searchForImage($image->url);
254 return response()->json($pageSearch);
258 * Deletes an image and all thumbnail/image files
260 * @return \Illuminate\Http\JsonResponse
263 public function destroy($id)
265 $image = $this->imageRepo->getById($id);
266 $this->checkOwnablePermission('image-delete', $image);
268 $this->imageRepo->destroyImage($image);
269 return response()->json(trans('components.images_deleted'));