Installing and configuring Stubbles
Where to obtain Stubbles
Download the latest version from our download page.
Installing
Unpack the contents of stubbles-{VERSION}.tgz to any place you like on the desired web server. The directory named docroot is the location where the web server's document root should point to. It is not necessary to use this directory as document root, any directory within the default document root of the web server will fit. However we strongly recommend that all other directories are not placed into the document root of the web server.
Configuring
To get your copy of Stubbles to work correctly, you may either use Phing, or configure it manually.
Using Phing
Please refer to the section about the Stubbles build-system if you want to use the automatic configuration.
Manual configuration
In config/php, rename config-dist.php to config.php. If the directory structure is not changed it is not necessary to change any of the settings within this file.
Make sure, that the webserver has write access to the following directories:
- lib
- cache
- cache/xml
- cache/xml/elements
In config/xml all required files have to be renamed from name-dist.xml to name.xml. Which files need to be renamed depends on the packages that should be used. Please consult the documentation for the packages you want to use.
First steps
- Create a file index.php in docroot (or wherever you like to have your files).
- Include config/php/config.php. Please consider the correct path from your current directory to the directory where you placed stubbles.
- Load the stubbles sources: require stubConfig::getLibPath() . '/stubbles.php';.
- Happy coding. :)
