INSTALL.md

   1 # Installing poche
   2
   3 ## requirements
   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.
  14
  15 ## you don't want to install twig (the template engine) by yourself
  16
  17 Download this file http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip
  18
  19 Extract this file on your server.
  20
  21 ## you want to install twig by yourself
  22
  23 Download the latest version here : http://www.inthepoche.com/?pages/T%C3%A9l%C3%A9charger-poche
  24
  25 Extract this file on your server.
  26
  27 ```php
  28 curl -s http://getcomposer.org/installer | php
  29 php composer.phar install
  30 ```
  31
  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
  59
  60 You must have write access on assets, cache and db directories. These directories may not exist, you'll have to create them.
  61
  62 You can use poche ! Enjoy.
  63
  64 # Some problems you may encounter
  65
  66 ## Blank page
  67
  68 Be sure to have write access on assets, cache and db directories.
  69
  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
  71
  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.