If you're working with an existing codebase it's often difficult to modernise the code as it would mean a complete rewrite and there's rarely the time. An alternative is to improve the codebase incrementally as best you can, gradually outsourcing code to external libraries to reduce the amount of old code there is to maintain.
This tutorial describes how to include the Kohana PHP framework into existing PHP applications, without having to use the routing and HMVC request handling features.
The code modified in this tutorial was copied from Kohana version 3.4.1. You may need to update it to work with future releases.
In normal usage of the Kohana framework, the index.php file acts as the request handler; it sets up the environment, loads the system configuration, and then handles the request (see Request Flow).
We'll walk you through the steps required to create a file we'll call include.php which will allow you to include Kohana from exiting PHP applications.
The following file will serve as our (insultingly simple) demo application for this tutorial.
demo.php <?php
$content = 'Hello World';
?>
<html>
<head>
<title>Demo page</title>
</head>
<body>
<?= $content ?>
</body>
</html>
Download and install the Kohana framework; from this point on, we'll be referring to the location of the Kohana libraries as the kohana directory.
Since index.php and include.php will duplicate a lot of code, we're going to move that code to a third file, common.php. The bulk of the code is unchanged; we've changed the install check to exit rather than return after rendering, and removed the request execution.
The new file creates the initial request object, rather than fully executing the request, so that, if you do define routes, the Request::$initial variable will be set up correctly.
kohana/public/common.php <?php
/**
* The default extension of resource files. If you change this, all resources
* must be renamed to use the new extension.
*
* @link https://kohana.top/guide/about.install#ext
*/
define('EXT', '.php');
/**
* Set the PHP error reporting level. If you set this in php.ini, you remove this.
* @link http://www.php.net/manual/errorfunc.configuration#ini.error-reporting
*
* When developing your application, it is highly recommended to enable notices
* and warnings. Enable them by using: E_ALL
*
* In a production environment, it is safe to ignore notices and warnings.
* Disable them by using: E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
*/
error_reporting(E_ALL);
/**
* End of standard configuration! Changing any of the code below should only be
* attempted by those with a working knowledge of Kohana internals.
*
* @link https://kohana.top/guide/using.configuration
*/
// Set the full path to the docroot
define('DOCROOT', __DIR__ . DIRECTORY_SEPARATOR);
// Define the absolute paths for required directories
define('APPPATH', realpath(DOCROOT . '../application') . DIRECTORY_SEPARATOR);
define('MODPATH', realpath(DOCROOT . '../modules') . DIRECTORY_SEPARATOR);
define('SYSPATH', realpath(DOCROOT . '../system') . DIRECTORY_SEPARATOR);
if (file_exists('install' . EXT)) {
// Load the installation check
return include 'install' . EXT;
exit; // Changes were made here
}
/**
* Define the start time of the application, used for profiling.
*/
if (!defined('KOHANA_START_TIME')) {
define('KOHANA_START_TIME', microtime(true));
}
/**
* Define the memory usage at the start of the application, used for profiling.
*/
if (!defined('KOHANA_START_MEMORY')) {
define('KOHANA_START_MEMORY', memory_get_usage());
}
// Bootstrap the application
require APPPATH . 'bootstrap' . EXT;
if (PHP_SAPI === 'cli') {
// Try and load minion
class_exists('Minion_Task') OR die('Please enable the Minion module for CLI support.');
set_exception_handler(['Minion_Exception', 'handler']);
Minion_Task::factory(Minion_CLI::options())->execute();
} else {
/**
* Execute the main request. A source of the URI can be passed, eg: $_SERVER['PATH_INFO'].
* If no source is specified, the URI will be automatically detected.
*/
Request::factory(true, [], false); // Changes were made here
}
index.phpHaving moved most of the code from Kohana's index.php to common.php, the new kohana/public/index.php contains only this:
kohana/public/index.php <?php
require_once 'common.php';
/**
* Execute the main request. A source of the URI can be passed, eg: $_SERVER['PATH_INFO'].
* If no source is specified, the URI will be automatically detected.
*/
Request::$initial->execute()
->send_headers(true)
->body();
Our include.php file is also pretty simple. The try-catch clause is needed because if the request matches no routes Kohana will throw an HTTP_Exception_404 exception.
kohana/include.php <?php
try {
require_once 'common.php';
} catch (HTTP_Exception_404 $e) {
// The request did not match any routes; ignore the 404 exception.
}
NB: Due to the way Kohana's routing works, if the request matches no routes it will fail to instantiate an object, and Request::$current and Request::$initial will not be available.
Now that we're set up, we can add Kohana into our application using a single include, and then we're good to go.
demo.php <?php
require_once 'kohana/public/include.php';
$content = 'Hello World';
$content = HTML::anchor('http://kohanaframework.org/', $content);
?>
<html>
<head>
<title>Demo page</title>
</head>
<body>
<?= $content ?>
<hr>
<?= URL::base() ?>
<hr>
<?= Debug::dump([1, 2, 3, 4, 5]) ?>
</body>
</html>