5af3041b9b
- Added some level of app out-of-memory handling so we can show a proper error message upon OOM events. - Added endpoint and image-manager button/action for regenerating thumbnails for an image so they can be re-created upon failure.
58 lines
1.5 KiB
PHP
58 lines
1.5 KiB
PHP
<?php
|
|
|
|
namespace BookStack\Util;
|
|
|
|
use BookStack\Exceptions\Handler;
|
|
use Illuminate\Contracts\Debug\ExceptionHandler;
|
|
|
|
/**
|
|
* Create a handler which runs the provided actions upon an
|
|
* out-of-memory event. This allows reserving of memory to allow
|
|
* the desired action to run as needed.
|
|
*
|
|
* Essentially provides a wrapper and memory reserving around the
|
|
* memory handling added to the default app error handler.
|
|
*/
|
|
class OutOfMemoryHandler
|
|
{
|
|
protected $onOutOfMemory;
|
|
protected string $memoryReserve = '';
|
|
|
|
public function __construct(callable $onOutOfMemory, int $memoryReserveMB = 4)
|
|
{
|
|
$this->onOutOfMemory = $onOutOfMemory;
|
|
|
|
$this->memoryReserve = str_repeat('x', $memoryReserveMB * 1_000_000);
|
|
$this->getHandler()->prepareForOutOfMemory(function () {
|
|
return $this->handle();
|
|
});
|
|
}
|
|
|
|
protected function handle(): mixed
|
|
{
|
|
$result = null;
|
|
$this->memoryReserve = '';
|
|
|
|
if ($this->onOutOfMemory) {
|
|
$result = call_user_func($this->onOutOfMemory);
|
|
$this->forget();
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Forget the handler so no action is taken place on out of memory.
|
|
*/
|
|
public function forget(): void
|
|
{
|
|
$this->memoryReserve = '';
|
|
$this->onOutOfMemory = null;
|
|
$this->getHandler()->forgetOutOfMemoryHandler();
|
|
}
|
|
|
|
protected function getHandler(): Handler
|
|
{
|
|
return app()->make(ExceptionHandler::class);
|
|
}
|
|
}
|