[github/wallabag/wallabag.git] / INSTALL.md

# Installing poche

## requirements

it's highly recommended to have php cURL and tidy_parse_string to fetch articles content. 

## you don't want to install twig (the template engine) by yourself

Download this file http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip

Extract this file on your server.

## you want to install twig by yourself 

Download the latest version here : http://www.inthepoche.com/?pages/T%C3%A9l%C3%A9charger-poche

Extract this file on your server.

```php
curl -s http://getcomposer.org/installer | php
php composer.phar install
```

### using sqlite

Copy / paste install/poche.sqlite in db folder.

### using mysql or postgresql

Execute the sql file in /install (mysql.sql or postgres.sql)

Then, go to step 3.

# Upgrading poche

Replace all the files except **db/poche.sqlite**. Also remember to edit the file /inc/poche/config.inc.php.

## Upgrading from poche <= 0.3

You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php

Then, go to step 3.

## Upgrading from poche >= 1.0 beta1

Nothing to do here. 

Then, go to step 3.

# Here is the step 3

You must have write access on assets, cache and db directories. These directories may not exist, you'll have to create them.

You can use poche ! Enjoy.

# Some problems you may encounter

## Blank page

Be sure to have write access on assets, cache and db directories.

## PHP Fatal error:  Call to a member function fetchAll() on a non-object in /var/www/poche/inc/poche/Database.class.php on line 42

If you want to install poche, delete the db/poche.sqlite file and copy / paste the install/poche.sqlite in /db. Be sure to have write access.
Commit	Line	Data
1d517de6 NL	1	# Installing poche
1d517de6 NL	2
ca1b0a1a NL	3	## requirements
	4
	5	it's highly recommended to have php cURL and tidy_parse_string to fetch articles content.
	6
f93aaa65	7	## you don't want to install twig (the template engine) by yourself
1d517de6	8
f93aaa65	9	Download this file http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip
1d517de6	10
f93aaa65	11	Extract this file on your server.
1d517de6	12
f93aaa65	13	## you want to install twig by yourself
1d517de6	14
f93aaa65	15	Download the latest version here : http://www.inthepoche.com/?pages/T%C3%A9l%C3%A9charger-poche
1d517de6	16
f93aaa65	17	Extract this file on your server.
145f5040	18
f93aaa65	19	```php
145f5040	20	curl -s http://getcomposer.org/installer \| php
145f5040 NL	21	php composer.phar install
	22	```
	23
f93aaa65 NL	24	### using sqlite
	25
	26	Copy / paste install/poche.sqlite in db folder.
	27
	28	### using mysql or postgresql
	29
	30	Execute the sql file in /install (mysql.sql or postgres.sql)
	31
	32	Then, go to step 3.
	33
	34	# Upgrading poche
	35
	36	Replace all the files except db/poche.sqlite. Also remember to edit the file /inc/poche/config.inc.php.
	37
	38	## Upgrading from poche <= 0.3
	39
	40	You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php
	41
	42	Then, go to step 3.
	43
	44	## Upgrading from poche >= 1.0 beta1
	45
	46	Nothing to do here.
	47
	48	Then, go to step 3.
	49
	50	# Here is the step 3
145f5040	51
f93aaa65	52	You must have write access on assets, cache and db directories. These directories may not exist, you'll have to create them.
1d517de6	53
f93aaa65	54	You can use poche ! Enjoy.
1d517de6	55
f93aaa65	56	# Some problems you may encounter
1d517de6	57
f93aaa65	58	## Blank page
1d517de6	59
f93aaa65	60	Be sure to have write access on assets, cache and db directories.
1d517de6	61
f93aaa65	62	## PHP Fatal error: Call to a member function fetchAll() on a non-object in /var/www/poche/inc/poche/Database.class.php on line 42
1d517de6	63
f93aaa65	64	If you want to install poche, delete the db/poche.sqlite file and copy / paste the install/poche.sqlite in /db. Be sure to have write access.