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

# Installing poche

## requirements
* PHP 5.2.0 or higher
* XML ([?](http://php.net/xml))
* PCRE ([?](http://php.net/pcre))
* Data filtering ([?](http://uk.php.net/manual/en/book.filter.php))
* Tidy ([?](http://php.net/tidy))
* cURL ([?](http://php.net/curl))
* Parallel URL fetching
* allow_url_fopen ([?](http://www.php.net/manual/en/filesystem.configuration.php#ini.allow-url-fopen))

To see if your server is ok to run poche, execute http://yourpoche/poche_compatibility_test.php. 

## 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	3	## requirements
b4f5c46a NL	4	* PHP 5.2.0 or higher
	5	* XML ([?](http://php.net/xml))
	6	* PCRE ([?](http://php.net/pcre))
	7	* Data filtering ([?](http://uk.php.net/manual/en/book.filter.php))
	8	* Tidy ([?](http://php.net/tidy))
	9	* cURL ([?](http://php.net/curl))
	10	* Parallel URL fetching
	11	* allow_url_fopen ([?](http://www.php.net/manual/en/filesystem.configuration.php#ini.allow-url-fopen))
	12
	13	To see if your server is ok to run poche, execute http://yourpoche/poche_compatibility_test.php.
ca1b0a1a	14
f93aaa65	15	## you don't want to install twig (the template engine) by yourself
1d517de6	16
f93aaa65	17	Download this file http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip
1d517de6	18
f93aaa65	19	Extract this file on your server.
1d517de6	20
f93aaa65	21	## you want to install twig by yourself
1d517de6	22
f93aaa65	23	Download the latest version here : http://www.inthepoche.com/?pages/T%C3%A9l%C3%A9charger-poche
1d517de6	24
f93aaa65	25	Extract this file on your server.
145f5040	26
f93aaa65	27	```php
145f5040	28	curl -s http://getcomposer.org/installer \| php
145f5040 NL	29	php composer.phar install
	30	```
	31
f93aaa65 NL	32	### using sqlite
	33
	34	Copy / paste install/poche.sqlite in db folder.
	35
	36	### using mysql or postgresql
	37
	38	Execute the sql file in /install (mysql.sql or postgres.sql)
	39
	40	Then, go to step 3.
	41
	42	# Upgrading poche
	43
	44	Replace all the files except db/poche.sqlite. Also remember to edit the file /inc/poche/config.inc.php.
	45
	46	## Upgrading from poche <= 0.3
	47
	48	You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php
	49
	50	Then, go to step 3.
	51
	52	## Upgrading from poche >= 1.0 beta1
	53
	54	Nothing to do here.
	55
	56	Then, go to step 3.
	57
	58	# Here is the step 3
145f5040	59
f93aaa65	60	You must have write access on assets, cache and db directories. These directories may not exist, you'll have to create them.
1d517de6	61
f93aaa65	62	You can use poche ! Enjoy.
1d517de6	63
f93aaa65	64	# Some problems you may encounter
1d517de6	65
f93aaa65	66	## Blank page
1d517de6	67
f93aaa65	68	Be sure to have write access on assets, cache and db directories.
1d517de6	69
f93aaa65	70	## 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	71
f93aaa65	72	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.