phalcon/cphalcon · error · Phalcon\Mvc\Micro\Exceptions\NotFoundHandlerNotCallable

Not-Found handler is not callable or is not defined

Error message

Not-Found handler is not callable or is not defined

What it means

Error "Not-Found handler is not callable or is not defined" thrown in phalcon/cphalcon.

Source

Thrown at phalcon/Mvc/Micro.zep:609

                    }
                }
            } else {
                 /**
                  * Calling beforeNotFound event
                  */
                if this->eventsManager !== null {
                    if this->eventsManager->fire("micro:beforeNotFound", this) === false {
                        return false;
                    }
                }

                /**
                 * Check if a notfoundhandler is defined and it's callable
                 */
                let notFoundHandler = this->notFoundHandler;

                if unlikely !is_callable(notFoundHandler) {
                    throw new NotFoundHandlerNotCallable();
                }

                /**
                 * Call the Not-Found handler
                 */
                let returnedValue = call_user_func(notFoundHandler);
            }

            /**
             * Calling afterHandleRoute event
             */
            if this->eventsManager !== null {
                this->eventsManager->fire("micro:afterHandleRoute", this, returnedValue);
            }

            let finishHandlers = this->finishHandlers;
            let this->stopped = false;

View on GitHub (pinned to b7419de9cd)

When it happens

Trigger: Thrown at phalcon/Mvc/Micro.zep:609 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/db29d2999921ade6. Report an issue: GitHub.