Tips and Common Mistakes

This is a collection of tips and common mistakes or errors you may encounter.

Never edit the system folder!

You should (almost) never edit the system folder. Any change you want to make to files in system and modules can be made via the cascading filesystem and transparent extension and won’t break when you try to update your Kohana version.

Don’t try and use one route for everything

Kohana 3 routes are very powerful and flexible, don’t be afraid to use as many as you need to make your app function the way you want!

Files not found on some systems

As of Kohana 3.3, classes are autoloaded using the case-sensitive PSR-0 autoloader. This means that using the class Foo {} with a file in classes/foo.php will work on case-insensitive file systems (such as the default HFS+ FS used in Mac OS X) but will fail when used on a case-sensitive FS (typical on many production Linux servers).

Handling lots of routes

Sometimes your application is sufficiently complex that you have many routes and it becomes unmanageable to put them all in bootstrap.php. If this is the case, simply make a routes.php file in APPPATH and require that in your bootstrap: require_once APPPATH.'routes'.EXT;


If you get a Reflection_Exception when setting up your site, it is almost certainly because your [Kohana::init] ‘base_url’ setting is wrong. If your base url is correct something is probably wrong with your routes.

ReflectionException [ -1 ]: Class controller_<something> does not exist
// where <something> is part of the url you entered in your browser


Set your [Kohana::init] ‘base_url’ to the correct setting. The base url should be the path to your index.php file relative to the webserver document root.

ORM/Session __sleep() bug

There is a bug in php which can corrupt your session after a fatal error. A production server shouldn’t have uncaught fatal errors, so this bug should only happen during development, when you do something stupid and cause a fatal error. On the next page load you will get a database connection error, then all subsequent page loads will display the following error:

ErrorException [ Notice ]: Undefined index: id
MODPATH/orm/classes/kohana/orm.php [ 1308 ]


To fix this, clear your cookies for that domain to reset your session. This should never happen on a production server, so you won’t have to explain to your clients how to clear their cookies. You can see the discussion on this issue for more details.

Do you want to contribute to Koseven?

We need YOUR help!

This project is open source. What does this mean? YOU can help:
  • Found a bug? Report it on Github
  • Need a feature? Add it Here
  • Want to help? Join the Forum
Go to Github