Go to file
Mateusz U 6bb7d5a5f6 Merge pull request #7 from halkyon/close_conn_fix
BUG SQLite database connection not closed properly
2014-10-28 09:53:23 +13:00
code BUG SQLite database connection not closed properly 2014-10-27 19:06:04 +13:00
.travis.yml Don't test against unsupported core versions 2014-07-11 09:25:12 +10:00
LICENSE Create LICENSE 2013-09-02 21:20:35 +12:00
README.md Travis support 2014-02-18 17:59:45 +13:00
_config.php BUG Properly deprecate old 'memory' config setting 2014-03-06 10:40:14 +13:00
composer.json Create 1.3 branch for 3.0/.1 compat 2014-07-10 12:33:22 +10:00

README.md

SQLite3 Module

Build Status

Maintainer Contact

Andreas Piening (Nickname: apiening) <andreas (at) silverstripe (dot) com>

Requirements

SilverStripe 3.0 or newer

Installation

Download, unzip and copy the sqlite3 folder to your project root so that it becomes a sibling of framework/.

Either use the installer to automatically install SQLite or add this to your _config.php (right after "require_once("conf/ConfigureFromEnv.php");" if you are using _ss_environment.php)

$databaseConfig['type'] = 'SQLiteDatabase';
$databaseConfig['path'] = "/path/to/my/database/file";

Make sure the webserver has sufficient privileges to write to that folder and that it is protected from external access.

Sample mysite/_config.php

<?php

global $project;
$project = 'mysite';

global $database;
$database = 'SS_mysite';

require_once("conf/ConfigureFromEnv.php");

global $databaseConfig;

$databaseConfig = array(
	"type" => 'SQLiteDatabase',
	"server" => 'none',
	"username" => 'none',
	"password" => 'none',
	"database" => $database,
	"path" => "/path/to/my/database/file",
);

SSViewer::set_theme('blackcandy');
SiteTree::enable_nested_urls();

Again: make sure that the webserver has permission to read and write to the above path (/path/to/my/database/, 'file' would be the name of the sqlite db file)

URL parameter

If you're trying to change a field constrain to NOT NULL on a field that contains NULLs dev/build fails because it might corrupt existing records. In order to perform the action anyway add the URL parameter 'avoidConflict' when running dev/build which temporarily adds a conflict clause to the field spec. E.g.: http://www.my-project.com/?avoidConflict=1

Open Issues

  • SQLite3 is supposed to work with all may not work with certain modules as they are using custom SQL statements passed to the DB class directly ;(
  • there is no real fulltext search yet and the build-in search engine is not ordering by relevance, check out fts3