phalcon/cphalcon · error · Phalcon\Mvc\View\Exceptions\ViewNotFound

View '{viewPath}' was not found in any of the views director

Error message

View '{viewPath}' was not found in any of the views directory

What it means

During render, View maps the requested view path against each registered engine extension (.phtml, .volt, ...) under each views directory; if no engine file exists and the silence flag is false, ViewNotFound is thrown (phalcon/Mvc/View.zep:1254). Just before throwing, the view:notFoundView event fires on the events manager with the last checked path, giving you a hook to log or react.

Source

Thrown at phalcon/Mvc/View.zep:1254

                    return;
                }

                let viewEnginePaths[] = viewEnginePath;
            }
        }

        /**
         * Notify about not found views
         */
        if typeof eventsManager === "object" {
            let this->activeRenderPaths = viewEnginePaths;

            eventsManager->fire("view:notFoundView", this, viewEnginePath);
        }

        if !silence {
            throw new ViewNotFound(viewPath);
        }
    }

    /**
     * Gets views directories
     */
    protected function getViewsDirs() -> array
    {
        if typeof this->viewsDirs === "string" {
            return [this->viewsDirs];
        }

        return this->viewsDirs;
    }

    /**
     * Checks if a path is absolute or not
     */

View on GitHub (pinned to b7419de9cd)

Solutions

1. Check the file exists in a views dir with a registered extension: glob(rtrim($dir,'/') . '/' . $viewPath . '.*')
2. Fix letter-case to match the filesystem exactly (Linux is case-sensitive)
3. Register the engine covering your extension, e.g. registerEngines(['.volt' => ..., '.phtml' => ...]), or rename the template
4. For optional partials, pass silence=true (render(..., silence: true)) or listen to view:notFoundView

Example fix

// before
$view->setViewsDir('/var/www/app/views/');
echo $view->render('Invoices/print'); // actual file: invoices/print.phtml

// after
$view->setViewsDir('/var/www/app/views/');
echo $view->render('invoices/print');

$extensions = array_keys($view->getRegisteredEngines() ?: []);
foreach ((array) $view->getViewsDir() as $dir) {
    foreach ($extensions as $ext) {
        if (is_file(rtrim($dir, '/\\') . DIRECTORY_SEPARATOR . $viewPath . $ext)) {
            return true; // template resolvable
        }
    }
}
return false;

use Phalcon\Mvc\View\Exceptions\ViewNotFound;
try {
    $html = $view->render('emails/welcome', $params);
} catch (ViewNotFound $e) {
    $html = $view->render('emails/generic', $params); // fallback template
}

When it happens

Trigger: $view->render('invoices/print') when app/views/invoices/print.volt does not exist (only .phtml registered, or file missing); controller action renders 'userProfile' while the file is named 'userprofile' on a case-sensitive filesystem; pick('mails/confirm') with the template in a different module's views dir.

Common situations: Case-sensitivity mismatch: code developed on macOS/Windows deploys to Linux; template file extension not matching a registered engine key (e.g. .volt file but only .phtml engine registered); wrong viewsDir; deleted/renamed templates after refactor; missing templates for a newly added action.

Related errors

• Macro '{name}' was called without parameter: {variableName}
• Failed to write router cache temp file: {tmpPath}
• Failed to commit router cache: {path}
• Views directory must be a string or an array
• Views directory item must be a string

AI-assisted analysis of phalcon/cphalcon@b7419de9cd (2026-08-21). Data as JSON: /api/errors/7d595afda7d1ff8a. Report an issue: GitHub.