phalcon/cphalcon · error · Phalcon\Paginator\Exceptions\InvalidCursorColumn

Parameter 'cursorColumn' must be a non-empty string

Error message

Parameter 'cursorColumn' must be a non-empty string

What it means

Error "Parameter 'cursorColumn' must be a non-empty string" thrown in phalcon/cphalcon.

Source

Thrown at phalcon/Paginator/Adapter/QueryBuilderCursor.zep:114

        if unlikely !isset config["limit"] {
            throw new MissingRequiredParameter("limit");
        }

        if unlikely !fetch builder, config["builder"] {
            throw new MissingRequiredParameter("builder");
        }

        if unlikely !(builder instanceof Builder) {
            throw new InvalidBuilderInstance();
        }

        if unlikely !fetch cursorColumn, config["cursorColumn"] {
            throw new MissingRequiredParameter("cursorColumn");
        }

        if unlikely typeof cursorColumn != "string" || empty cursorColumn {
            throw new InvalidCursorColumn();
        }

        let this->cursorColumn = cursorColumn;

        if fetch cursor, config["cursor"] {
            let this->cursor = cursor;
        }

        parent::__construct(config);

        this->setQueryBuilder(builder);
    }

    /**
     * Get the current page number
     *
     * Returns the cursor value used for this page cast to int, or 0 for the
     * first page. Use getCursor() to retrieve the raw cursor value.

View on GitHub (pinned to b7419de9cd)

When it happens

Trigger: Thrown at phalcon/Paginator/Adapter/QueryBuilderCursor.zep:114 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/7d6e6225493c39d7. Report an issue: GitHub.