Banshee
the secure PHP framework

Installation

Webserver

To install Banshee, download the latest version and unpack the zipfile to a suitable location. You can also obtain it via Composer:

composer create-project hsleisink/banshee

In your webserver configuration, point the document root to the directory named 'public'. Enable PHP execution and URL rewriting. For the Hiawatha webserver, use the following UrlToolkit rule:

UrlToolkit {
    ToolkitID = banshee
    RequestURI isfile Return
    Match ^/(css|files|fonts|images|js)(/|$) Return
    Match ^/(favicon.ico|robots.txt)$ Return
    Match [^?]*(\?.*)? Rewrite /index.php$1
}

For the Apache webserver, a .htaccess file with the right settings for URL rewriting is already available in the 'public' directory. If you use a webserver other that Hiawatha or Apache, you need to create an URL rewriting rule that redirects all requests for non-existing files to /index.php.

PHP

Banshee requires at least PHP v7.0 and needs PHP's MySQL and XML/XSLT module. If you use the Banshee image library, you need PHP's GD module. Make sure the date.timezone setting in php.ini has been set correctly.

MySQL / MariaDB

To setup the MySQL / MariaDB database, change the database settings in 'settings/website.conf', open your website in a browser and follow the instructions on your screen. To continue installation in case of a client issue, add /setup to the URL. The installed database contains a user 'admin' of which the password will be set during setup.

Delete demo content or functionality

To delete all demo content, run the script 'database/remove_demo_content'.

To remove a module from the framework, use the 'remove_module' script. Run it without a parameter to see all available modules.

Banshee

Go to the Settings page in the CMS and replace the present e-mail addresses with your own. Before going live, set the DEBUG_MODE to 'no' in settings/website.conf.