Update docs and alias dev-master as 1.4

This commit is contained in:
Damian Mooyman 2014-07-11 08:47:18 +12:00
parent ec64174b33
commit a599b53809
2 changed files with 59 additions and 49 deletions

View File

@ -1,66 +1,73 @@
SQLite3 Module # SQLite3 Module
==============
[![Build Status](https://travis-ci.org/silverstripe-labs/silverstripe-sqlite3.png?branch=master)](https://travis-ci.org/silverstripe-labs/silverstripe-sqlite3) [![Build Status](https://travis-ci.org/silverstripe-labs/silverstripe-sqlite3.png?branch=master)](https://travis-ci.org/silverstripe-labs/silverstripe-sqlite3)
Maintainer Contact ## Maintainer Contact
------------------
Andreas Piening (Nickname: apiening) Andreas Piening (Nickname: apiening)
<andreas (at) silverstripe (dot) com> <andreas (at) silverstripe (dot) com>
## Requirements
Requirements * SilverStripe 3.2 or newer
------------
SilverStripe 3.0 or newer
## Installation
Installation * If using composer, run `composer require silverstripe/sqlite3 1.4.*-dev`.
------------ * Otherwise, download, unzip and copy the sqlite3 folder to your project root so that it becomes a
Download, unzip and copy the sqlite3 folder to your project root so that it becomes a sibling of `framework/`. 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) ## Configuration
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['type'] = 'SQLiteDatabase';
$databaseConfig['path'] = "/path/to/my/database/file"; $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. Make sure the webserver has sufficient privileges to write to that folder and that it is protected from
external access.
Sample mysite/_config.php ### Sample mysite/_config.php
-------------------------
<?php ```php
<?php
global $project;
$project = 'mysite';
global $project; global $database;
$project = 'mysite'; $database = 'SS_mysite';
global $database; require_once("conf/ConfigureFromEnv.php");
$database = 'SS_mysite';
require_once("conf/ConfigureFromEnv.php"); global $databaseConfig;
global $databaseConfig; $databaseConfig = array(
"type" => 'SQLiteDatabase',
"server" => 'none',
"username" => 'none',
"password" => 'none',
"database" => $database,
"path" => "/path/to/my/database/file",
);
$databaseConfig = array( SSViewer::set_theme('blackcandy');
"type" => 'SQLiteDatabase', SiteTree::enable_nested_urls();
"server" => 'none', ```
"username" => 'none',
"password" => 'none',
"database" => $database,
"path" => "/path/to/my/database/file",
);
SSViewer::set_theme('blackcandy'); Again: make sure that the webserver has permission to read and write to the above path (/path/to/my/database/,
SiteTree::enable_nested_urls(); 'file' would be the name of the sqlite db file)
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
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
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. running dev/build which temporarily adds a conflict clause to the field spec.
E.g.: http://www.my-project.com/?avoidConflict=1 E.g.: http://www.my-project.com/?avoidConflict=1
Open Issues ## 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 ;( - 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 - there is no real fulltext search yet and the build-in search engine is not ordering by relevance, check out fts3

View File

@ -4,18 +4,21 @@
"type": "silverstripe-module", "type": "silverstripe-module",
"keywords": ["silverstripe", "sqlite3", "database"], "keywords": ["silverstripe", "sqlite3", "database"],
"authors": [ "authors": [
{ {
"name": "Ingo Schommer", "name": "Ingo Schommer",
"email": "ingo@silverstripe.com" "email": "ingo@silverstripe.com"
}, },
{ {
"name": "Sean Harvey", "name": "Sean Harvey",
"email": "sean@silverstripe.com" "email": "sean@silverstripe.com"
} }
], ],
"require": {
"require":
{
"silverstripe/framework": "~3.2" "silverstripe/framework": "~3.2"
},
"extra": {
"branch-alias": {
"dev-master": "1.4.x-dev"
}
} }
} }