namespace BookStack\Http\Controllers;
-use HttpRequestException;
+use BookStack\Exceptions\NotifyException;
+use BookStack\Facades\Activity;
+use BookStack\Interfaces\Loggable;
+use BookStack\Model;
+use BookStack\Util\WebSafeMimeSniffer;
use Illuminate\Foundation\Bus\DispatchesJobs;
-use Illuminate\Http\Exception\HttpResponseException;
-use Illuminate\Routing\Controller as BaseController;
use Illuminate\Foundation\Validation\ValidatesRequests;
-use Illuminate\Support\Facades\Auth;
-use Illuminate\Support\Facades\Session;
-use BookStack\User;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Response;
+use Illuminate\Routing\Controller as BaseController;
abstract class Controller extends BaseController
{
- use DispatchesJobs, ValidatesRequests;
+ use DispatchesJobs;
+ use ValidatesRequests;
/**
- * @var User static
+ * Check if the current user is signed in.
*/
- protected $currentUser;
- /**
- * @var bool
- */
- protected $signedIn;
-
- /**
- * Controller constructor.
- */
- public function __construct()
+ protected function isSignedIn(): bool
{
- // Get a user instance for the current user
- $user = auth()->user();
- if (!$user) $user = User::getDefault();
-
- // Share variables with views
- view()->share('signedIn', auth()->check());
- view()->share('currentUser', $user);
-
- // Share variables with controllers
- $this->currentUser = $user;
- $this->signedIn = auth()->check();
+ return auth()->check();
}
/**
* Stops the application and shows a permission error if
* the application is in demo mode.
*/
- protected function preventAccessForDemoUsers()
+ protected function preventAccessInDemoMode()
{
- if (env('APP_ENV', 'production') === 'demo') $this->showPermissionError();
+ if (config('app.env') === 'demo') {
+ $this->showPermissionError();
+ }
}
/**
* Adds the page title into the view.
- * @param $title
*/
- public function setPageTitle($title)
+ public function setPageTitle(string $title)
{
view()->share('pageTitle', $title);
}
/**
- * On a permission error redirect to home and display
+ * On a permission error redirect to home and display.
* the error as a notification.
+ *
+ * @return never
*/
protected function showPermissionError()
{
- Session::flash('error', trans('errors.permission'));
- throw new HttpResponseException(
- redirect('/')
- );
+ $message = request()->wantsJson() ? trans('errors.permissionJson') : trans('errors.permission');
+
+ throw new NotifyException($message, '/', 403);
}
/**
- * Checks for a permission.
- *
- * @param $permissionName
- * @return bool|\Illuminate\Http\RedirectResponse
+ * Checks that the current user has the given permission otherwise throw an exception.
+ */
+ protected function checkPermission(string $permission): void
+ {
+ if (!user() || !user()->can($permission)) {
+ $this->showPermissionError();
+ }
+ }
+
+ /**
+ * Check the current user's permissions against an ownable item otherwise throw an exception.
*/
- protected function checkPermission($permissionName)
+ protected function checkOwnablePermission(string $permission, Model $ownable): void
{
- if (!$this->currentUser || !$this->currentUser->can($permissionName)) {
+ if (!userCan($permission, $ownable)) {
$this->showPermissionError();
}
+ }
- return true;
+ /**
+ * Check if a user has a permission or bypass the permission
+ * check if the given callback resolves true.
+ */
+ protected function checkPermissionOr(string $permission, callable $callback): void
+ {
+ if ($callback() !== true) {
+ $this->checkPermission($permission);
+ }
}
/**
- * Check if a user has a permission or bypass if the callback is true.
- * @param $permissionName
- * @param $callback
- * @return bool
+ * Check if the current user has a permission or bypass if the provided user
+ * id matches the current user.
*/
- protected function checkPermissionOr($permissionName, $callback)
+ protected function checkPermissionOrCurrentUser(string $permission, int $userId): void
{
- $callbackResult = $callback();
- if ($callbackResult === false) $this->checkPermission($permissionName);
- return true;
+ $this->checkPermissionOr($permission, function () use ($userId) {
+ return $userId === user()->id;
+ });
}
+ /**
+ * Send back a json error message.
+ */
+ protected function jsonError(string $messageText = '', int $statusCode = 500): JsonResponse
+ {
+ return response()->json(['message' => $messageText, 'status' => 'error'], $statusCode);
+ }
+
+ /**
+ * Create a response that forces a download in the browser.
+ */
+ protected function downloadResponse(string $content, string $fileName): Response
+ {
+ return response()->make($content, 200, [
+ 'Content-Type' => 'application/octet-stream',
+ 'Content-Disposition' => 'attachment; filename="' . $fileName . '"',
+ 'X-Content-Type-Options' => 'nosniff',
+ ]);
+ }
+
+ /**
+ * Create a file download response that provides the file with a content-type
+ * correct for the file, in a way so the browser can show the content in browser.
+ */
+ protected function inlineDownloadResponse(string $content, string $fileName): Response
+ {
+ $mime = (new WebSafeMimeSniffer())->sniff($content);
+
+ return response()->make($content, 200, [
+ 'Content-Type' => $mime,
+ 'Content-Disposition' => 'inline; filename="' . $fileName . '"',
+ 'X-Content-Type-Options' => 'nosniff',
+ ]);
+ }
+
+ /**
+ * Show a positive, successful notification to the user on next view load.
+ */
+ protected function showSuccessNotification(string $message): void
+ {
+ session()->flash('success', $message);
+ }
+
+ /**
+ * Show a warning notification to the user on next view load.
+ */
+ protected function showWarningNotification(string $message): void
+ {
+ session()->flash('warning', $message);
+ }
+
+ /**
+ * Show an error notification to the user on next view load.
+ */
+ protected function showErrorNotification(string $message): void
+ {
+ session()->flash('error', $message);
+ }
+
+ /**
+ * Log an activity in the system.
+ *
+ * @param string|Loggable $detail
+ */
+ protected function logActivity(string $type, $detail = ''): void
+ {
+ Activity::add($type, $detail);
+ }
+
+ /**
+ * Get the validation rules for image files.
+ */
+ protected function getImageValidationRules(): array
+ {
+ return ['image_extension', 'mimes:jpeg,png,gif,webp', 'max:' . (config('app.upload_limit') * 1000)];
+ }
}
projects / bookstack / blobdiff