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

Eager loading is only supported with Resultset::HYDRATE_RECO

Error message

Eager loading is only supported with Resultset::HYDRATE_RECORDS

What it means

Error "Eager loading is only supported with Resultset::HYDRATE_RECORDS" thrown in phalcon/cphalcon.

Source

Thrown at phalcon/Mvc/Model.zep:5983

     */
    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)
        );
    }

    /**
     * shared prepare query logic for find and findFirst method
     */
    private static function getPreparedQuery(var params, var limit = null) -> <QueryInterface>

View on GitHub (pinned to b7419de9cd)

When it happens

Trigger: Thrown at phalcon/Mvc/Model.zep:5983 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/fd4daea334fdc4c3. Report an issue: GitHub.