Sourdough » Installation

Diff: Installation

Legend:

Removed

Changed

Added

Ownership:	rw-rw-r-- iezzip users
Modified:	12 Mar 06, 15:06
Modified by:	Philip Iezzi (iezzip)
Rev.:	13 (Old)

Ownership:	rw-rw-r-- iezzip users
Modified:	05 May 06, 13:11
Modified by:	Philip Iezzi (iezzip)
Rev.:	14 (Current)

+ %TITLE%

<toc>

---

++ Prerequisites

In order to install Sourdough you will need:

* Any kind of operating system. Sourdough has been tested on both Linux and Windows.
* Apache webserver <noop>(</noop>((http://www.apache.org))<noop>)</noop>. Sourdough works on both Apache 1.3.xx or 2.0.x. On Windows, it might work on IIS as well, but currently we are not doing any testing on it.
* One of the following database systems:
* *MySQL* 4.0.x/4.1.x database or later version <noop>(</noop>((http://www.mysql.com))<noop>)</noop>.
* *PostgreSQL* <noop>(</noop>((http://www.postgresql.org))<noop>)</noop>
* *SQLite* <noop>(</noop>((http://www.sqlite.com))<noop>)</noop>
* *Microsoft SQL Server 2000* <noop>(</noop>((http://www.microsoft.com/sql/))<noop>)</noop>
* The following database systems might be supported in the near future: *FrontBase*, *Borland InterBase*, *Sybase*

* *PHP 5 or later version*. (Sourdough has been tested on PHP 5.0.4 & 5.1.1)

* *PHP 5.1 or later version*.

* Image Library (optional, required in package 'image'):
* ImageMagick
* PECL/imagick ImageMagick wrapper
* GD library
* NetPBM
* of course all of it working together ... and a HTML-browser

For your information: this site and all applications on this server that use the Sourdough framework are actually served by a PHP %PHP_VERSION% and ZendEngine %ZEND_VERSION% backend.

---

++ Get & UnPack Sourdough

You can install Sourdough from a ((Download)(released package)) (or snapshot distribution) or from ((SVN)(Download|Development)). Installing from a release or snapshot will always be simpler, but if you would like to keep up with and (hopefully!) help with Sourdough development, then you should checkout a copy of the source from SVN.

+++ Package

<q>
If you obtained a tar.gz or .zip of Sourdough, then you can simply uncompress the archive and move the resulting folder to the right location. (It is not required that Sourdough is located in your webroot.)

For example:

<code>
$> tar -zxf sourdough-x.x.x.tar.gz
$> mv sourdough-x.x.x /var/www/sourdough
</code>
</q>

+++ SVN

<q>
Installing from SVN ensures that you have the most up-to-date source code. (Of course SVN code is not stable and should not be used in production.)

Please check ((Download|Development)) for further instructions.
</q>

---

++ Setup Environment

There's not a lot to do once you have unpacked your Sourdough distribution. Sourdough should work under pretty any PHP configuration, no matter how misconfigured it is.

You might want to add the sourdough directory to your PHP include path. This is not required as the only file you will ever need to include is the main Sourdough.class.php. Sourdough takes care of the rest. Still, if you don't wish to specify a path on the inclusion of that file, simply edit your php.ini and add this directory to the include_path variable:

<code>
# Unix
include_path=".:/usr/local/lib/php:/var/www/sourdough"

; Windows
include_path=".:C:\PHP\PEAR\pear;C:\PHP\apps\sourdough"
</code>