getgrav/grav · error · InvalidArgumentException

Argument \$options is missing 'folder'

Error message

Argument \$options is missing 'folder'

What it means

Error "Argument \$options is missing 'folder'" thrown in getgrav/grav.

Source

Thrown at system/src/Grav/Framework/Flex/Storage/SimpleStorage.php:48

    /** @var string */
    protected $dataFolder;
    /** @var string */
    protected $dataPattern;
    /** @var string|null */
    protected $prefix;
    /** @var array|null */
    protected $data;
    /** @var int */
    protected $modified = 0;

    /**
     * {@inheritdoc}
     * @see FlexStorageInterface::__construct()
     */
    public function __construct(array $options)
    {
        if (!isset($options['folder'])) {
            throw new InvalidArgumentException("Argument \$options is missing 'folder'");
        }

        $formatter = $options['formatter'] ?? $this->detectDataFormatter($options['folder']);
        $this->initDataFormatter($formatter);

        $filesystem = Filesystem::getInstance(true);

        $extension = $this->dataFormatter->getDefaultFileExtension();
        $pattern = Utils::basename($options['folder']);

        $this->dataPattern = Utils::basename($pattern, $extension) . $extension;
        $this->dataFolder = $filesystem->dirname($options['folder']);
        $this->keyField = $options['key'] ?? 'storage_key';
        $this->keyLen = (int)($options['key_len'] ?? 32);
        $this->prefix = $options['prefix'] ?? null;

        // Make sure that the data folder exists.
        if (!file_exists($this->dataFolder)) {

View on GitHub (pinned to 6040efed04)

When it happens

Trigger: Thrown at system/src/Grav/Framework/Flex/Storage/SimpleStorage.php:48 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of getgrav/grav@6040efed04 (2026-08-17). Data as JSON: /api/errors/60d20a528ca7ea67. Report an issue: GitHub.