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

The 'eager' parameter must be an array of relation paths

Error message

The 'eager' parameter must be an array of relation paths

What it means

Error "The 'eager' parameter must be an array of relation paths" thrown in phalcon/cphalcon.

Source

Thrown at phalcon/Mvc/Model.zep:5974

            fields,
            referenceModel,
            referencedFields,
            options
        );
    }

    /**
     * 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,

View on GitHub (pinned to b7419de9cd)

When it happens

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