Kohana User Guide

installation:deployment - Added instruction to change IN_PRODUCTION value to TRUE

jordanlev — Sun, 16 Jan 2011 18:15:27 -0600

1236974903		current
Line 24:		Line 24:
	* set your ''$config['threshold'] = 1;''. This sets your log threshold to a suitable level for production. Higher threshold levels will log less critical notices and information, but can slow down your application.		* set your ''$config['threshold'] = 1;''. This sets your log threshold to a suitable level for production. Higher threshold levels will log less critical notices and information, but can slow down your application.
	* set ''config['internal_cache']'' to the number of seconds you want to cache file paths and config entries. This eliminates the need to search for file and module paths, significantly speeding up your application -- especially when using multiple modules.		* set ''config['internal_cache']'' to the number of seconds you want to cache file paths and config entries. This eliminates the need to search for file and module paths, significantly speeding up your application -- especially when using multiple modules.
		+
		+	Modify your ''index.php'' (in the root directory of your site):
		+	* change the constant ''IN_PRODUCTION'' value from ''FALSE'' to ''TRUE'' (so that any controllers with ''const ALLOW_PRODUCTION = FALSE;'' defined will be inaccessible).

	You should always try to create custom versions of the following files:		You should always try to create custom versions of the following files:

libraries:orm:examples - Use arr::extract() to pull out post data now, which simplifies code ...

jordanlev — Sat, 02 Oct 2010 03:57:50 -0600

1286009870		current
Line 121:		Line 121:
	if ($this->input->post())		if ($this->input->post())
	{		{
-	//Pull out fields we want from POST. We do this for 2 reasons:	+	//Pull out fields we want from POST. We do this for 2 reasons:
-	// 1) Manually set non-validated fields (address1 and address2) because validate() won't do it for us.	+	// 1) Manually set non-validated fields (address1 and address2) because validate() won't do it for us.
-	// 2) Safety precaution -- only set fields we're expecting (otherwise someone could inject a different "id" into the POST data, for example).	+	// 2) Safety precaution -- only set fields we're expecting (otherwise someone could inject a different "id" into the POST data, for example).
-	$data = arr::extract($this->input->post(), 'name', 'tel', 'address1', 'address2');	+	$data = arr::extract($this->input->post(), 'name', 'tel', 'address1', 'address2');

	// If the post data validates using the rules setup in the person model		// If the post data validates using the rules setup in the person model

libraries:pagination

webking — Fri, 06 Aug 2010 03:48:20 -0600

1246724530		current
Line 82:		Line 82:
	$this->pagination->initialize(array('uri_segment' => 'pages'));		$this->pagination->initialize(array('uri_segment' => 'pages'));
	</code>		</code>
-
-
	==== render() ====		==== render() ====

Line 90:		Line 88:
	<code php>		<code php>
	// Will overwrite the default 'classic' style with 'digg' style		// Will overwrite the default 'classic' style with 'digg' style
-	$this->pagination->render('digg'));	+	$this->pagination->render('digg');
	</code>		</code>

libraries:database:query - Moved Sample Query sections from main database page to this page

jordanlev — Sun, 20 Jun 2010 17:51:46 -0600

1277073464		current
Line 34:		Line 34:
	* [string] a value to escape.		* [string] a value to escape.

-	===== Some examples =====	+	===== Basic Example =====
	In the following example we'll show how to query a database and retrieve all usernames from the users table.		In the following example we'll show how to query a database and retrieve all usernames from the users table.

Line 69:		Line 69:
	</ul>		</ul>
	</code>		</code>
		+

	====== Query Binding ======		====== Query Binding ======
Line 90:		Line 91:
	$query = $db->set('number', new Database_Expression('number+1'));		$query = $db->set('number', new Database_Expression('number+1'));
	</code>		</code>
		+
		+
		+	====== Complete Examples ======
		+	This section contains some queries along with other supporting code you might need in your application.
		+
		+	===== Complete Example 1 =====
		+
		+	=== Initializing the database ===
		+	== applications/unspecified_path/unspecified_filename.php (?) ==
		+
		+	<code php>
		+	$db = Database::instance();
		+
		+	// or
		+
		+	$db = Database::instance('groupname'); // "default" is assumed if groupname is not given
		+	</code>
		+
		+
		+	=== Simple Query ===
		+	== applications/unspecified_path/unspecified_filename.php (?) ==
		+
		+	<code php>
		+	$result = $db->query('SELECT username,password,email FROM users');
		+
		+	foreach ($result as $row)
		+	{
		+	echo $row->username;
		+	echo $row->password;
		+	echo $row->email;
		+	}
		+	</code>
		+
		+
		+
		+	===== Complete Example 2 =====
		+
		+	This demonstrates using the query results in a template.
		+
		+	=== Query ===
		+	== applications/controllers/clients.php ==
		+
		+	<code php>
		+	class Clients_Controller extends Controller {
		+
		+	public function index()
		+	{
		+
		+	$db = Database::instance();
		+	$result = $db->query('SELECT name, code FROM clients');
		+
		+	View::factory('clients')
		+	->bind('result', $result)
		+	->render(TRUE);
		+	}
		+	}
		+	</code>
		+
		+	=== Template ===
		+	== applications/views/clients_content.php ==
		+
		+	<code php>
		+	<html>
		+	<head>
		+	<style>
		+	/*
		+	* Zebra rows: When CSS3 is done we could simply use:
		+	* tr :nth-child(odd) { background-color: #D0D0D0; }
		+	* but for now we use PHP and CSS
		+	*/
		+
		+	table.db tr { background-color: #F0F0F0; }
		+	table.db tr.odd { background-color: #D0D0D0; }
		+	table.db th { color: #f0f0f0; background-color: #303030; }
		+
		+	</style>
		+	</head>
		+	<body>
		+
		+	<h2>Client List</h2>
		+	<hr/>
		+
		+	<table class="db">
		+	<tr>
		+	<th>Client</th>
		+	<th>ID</th>
		+	</tr>
		+	<?php foreach( $result as $row ):?>
		+	<tr <?= text::alternate( '', ' class="odd"' ) ?>>
		+	<td><?= $row->name ?> </td>
		+	<td><?= $row->code ?> </td>
		+	</tr>
		+	<?php endforeach; ?>
		+	</table>
		+
		+	</body>
		+	</code>
		+


	[[libraries:database:builder\|Continue to the next section: Database Query Builder >>]]		[[libraries:database:builder\|Continue to the next section: Database Query Builder >>]]

libraries:database:configuration - Adding the "database drivers" list that used to be ...

jordanlev — Sun, 20 Jun 2010 17:45:22 -0600

1277073193		current
Line 43:		Line 43:
	You can have as many $config entries as you need. Each one needs a unique group identifier. You can use multiple config groups to [[connect]] to different databases in the same application.		You can have as many $config entries as you need. Each one needs a unique group identifier. You can use multiple config groups to [[connect]] to different databases in the same application.

		+
		+	====== Database Drivers ======
		+	The database library provides database access to your application using drivers.
		+
		+	Currently we have the following drivers available:
		+	- MsSQL
		+	- MySQL
		+	- MySQLi
		+	- PostgreSQL
		+	- PDOSqlite (available in SVN)


	[[libraries:database:connect\|Continue to the next section: Connecting to a database >>]]		[[libraries:database:connect\|Continue to the next section: Connecting to a database >>]]

libraries:database - Removed "Database Drivers" section because it is confusing here ...

jordanlev — Sun, 20 Jun 2010 17:44:08 -0600

1277073794		current
Line 14:		Line 14:
	* [[libraries:database:metadata\|Metadata]]		* [[libraries:database:metadata\|Metadata]]
	* [[libraries:database:cache\|Query Caching]]		* [[libraries:database:cache\|Query Caching]]
-
-	===== Database Compatibility =====
-	The database library provides database access to your application using drivers.
-
-	Currently we have the following drivers available:
-	- MsSQL
-	- MySQL
-	- MySQLi
-	- PostgreSQL
-	- PDOSqlite (available in SVN)
-

	[[libraries:database:configuration\|Continue to the next section: Database Configuration >>]]		[[libraries:database:configuration\|Continue to the next section: Database Configuration >>]]

general:configuration:config

lilleman — Sat, 19 Jun 2010 11:55:17 -0600

1266803488		current
Line 138:		Line 138:
	==== display_errors ====		==== display_errors ====
	Turning this off will disable all outputting of errors to the user. It will however be logged to the log directory.		Turning this off will disable all outputting of errors to the user. It will however be logged to the log directory.
-
	==== render_stats ====		==== render_stats ====
	Whether or not to render the statistics information in the final page output.		Whether or not to render the statistics information in the final page output.
Line 162:		Line 161:

	<box red>		<box red>
-	Keep in mind; having ''render_stats'' set to false will leave the raw replacement strings in your page, visible to all. It does not replace them with empty strings—it just disables the replacement. So take them out out if you're not using them!	+	Keep in mind; having ''render_stats'' set to false will leave the raw replacement strings in your page, visible to all. It does not replace them with empty strings—it just disables the replacement. So take them out if you're not using them!
	</box>		</box>

addons:auth - undoing changes by yanis that broke the registration example (perhaps it works on ...

cray — Thu, 10 Jun 2010 12:29:23 -0600

1276190963		current
Line 249:		Line 249:
	$user = ORM::factory('user');		$user = ORM::factory('user');
	$user->username = $username;		$user->username = $username;
-	$user->password = $password;	+	$user->password = Auth::instance()->hash_password($password);

	// if the user was successfully created...		// if the user was successfully created...