Path generation

By default Curator writes uploads to the disk and directory set in the config. Path generators change that layout without changing the disk.

Available generators

Setting one

Globally, through the path_generator config key:

use Awcodes\Curator\PathGenerators\DatePathGenerator;

'path_generator' => DatePathGenerator::class,

Or per field:

use Awcodes\Curator\Components\Forms\CuratorPicker;
use Awcodes\Curator\PathGenerators\DatePathGenerator;

CuratorPicker::make('image')
    ->pathGenerator(DatePathGenerator::class);

Writing your own

Implement the PathGenerator contract:

use Awcodes\Curator\PathGenerators\Contracts\PathGenerator;

class CustomPathGenerator implements PathGenerator
{
    public function getPath(?string $baseDir = null): string
    {
        return ($baseDir ? $baseDir . '/' : '') . 'my/custom/path';
    }
}

$baseDir is the configured directory, so honour it unless you deliberately want to ignore it.