phalcon/cphalcon · error · Phalcon\Mvc\Model\Exceptions\UnsupportedEagerResultset

Eager loading requires a Phalcon\Mvc\Model\Resultset\Simple

Error message

Eager loading requires a Phalcon\Mvc\Model\Resultset\Simple resultset, '{className}' given

What it means

Error "Eager loading requires a Phalcon\Mvc\Model\Resultset\Simple resultset, '{className}' given" thrown in phalcon/cphalcon.

Source

Thrown at phalcon/Mvc/Model.zep:5978

        );
    }

    /**
     * shared prepare query logic for find and findFirst method
     */
    private static function loadEager(
        var resultset,
        var eager,
        array params
    ) -> void {
        var container, hydration, loader, manager;

        if unlikely typeof eager !== "array" {
            throw new InvalidEagerParameter();
        }

        if unlikely !(resultset instanceof Simple) {
            throw new UnsupportedEagerResultset(get_class(resultset));
        }

        if fetch hydration, params["hydration"] {
            if unlikely hydration !== Resultset::HYDRATE_RECORDS {
                throw new UnsupportedEagerHydration();
            }
        }

        let container = Di::getDefault();
        let manager   = <ManagerInterface> container->getShared("modelsManager");
        let loader    = new Loader(manager);

        loader->loadResultset(
            resultset,
            get_called_class(),
            PathTree::parse(eager)
        );
    }

View on GitHub (pinned to b7419de9cd)

When it happens

Trigger: Thrown at phalcon/Mvc/Model.zep:5978 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of phalcon/cphalcon@b7419de9cd (2026-08-21). Data as JSON: /api/errors/9f6a0b4e3f996fcb. Report an issue: GitHub.