octobercms/october · error · ApplicationException

Invalid data source handler name

Error message

Invalid data source handler name 

What it means

Error "Invalid data source handler name " thrown in octobercms/october.

Source

Thrown at modules/dashboard/classes/ReportDataSourceBase.php:154

    /**
     * getAvailableMetrics returns the available metrics for this data source.
     * Metrics are measures of data, e.g. "page views".
     * @return ReportMetric[]
     */
    public function getAvailableMetrics(): array
    {
        return $this->metrics;
    }

    /**
     * runHandler runs a data source event handler.
     * @param string $handlerName The name of the handler.
     * @return mixed The data to pass to the client-side handler caller.
     */
    public function runHandler(string $handlerName)
    {
        if (!preg_match('/^on/i', $handlerName)) {
            throw new ApplicationException('Invalid data source handler name ' . $handlerName);
        }

        if (!method_exists($this, $handlerName)) {
            throw new ApplicationException('Data source handler method doesn\'t exist ' . $handlerName);
        }

        return $this->$handlerName();
    }

    /**
     * registerDimension registers a new dimension.
     * @param ReportDimension $dimension Dimension to register
     * @return ReportDimension Returns the added dimension, for chaining
     */
    protected function registerDimension(ReportDimension $dimension): ReportDimension
    {
        if ($this->dimensions === null) {
            $this->dimensions = [];

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/dashboard/classes/ReportDataSourceBase.php:154 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of octobercms/october@b608633a7e (2026-08-21). Data as JSON: /api/errors/a960e3d6d42f1102. Report an issue: GitHub.