This repository is a duck component. Visit Wealthy Laughing Duck Project for more information.
This duck component is a standalone web application built with symfony PHP framework (version 1.4) and Open Flash Chart. It requires a webserver (e.g. apache) with PHP5 and a SQL database.
First, run the install shell script:
$ ./install.sh
to fetch symfony sources from github. This script will load the dependency
as a git submodule and will set an appropriate branch. Afterwards, project
permissions are set (writable on cache
and log
directories) using
symfony command line.
Then, you shall create a database and fill it with data, you'll find helpful scripts in the project/data/sql directory. After this you shall set database permissions in config/databases.yml.
This project is configured for shared hostings. Check out more information about this configuration on symfony world blog.
There's no frontend
application. Backend app is the default one, it enables
users to manage their finances after successful login. There's also an API app
that allows external systems to communicate with the system.
To access the api, you need to pass appropriate password
(Basic HTTP Authentication).
The default password (stored in this repo) is: Hm0ByIEe5aGhNdov
. You may
override it, of course - modify .htpasswd file in this
case.
Probably, you'll have to override the AuthUserFile
in
.htaccess file, since Apache requires absolute path.
Before the tests can be run, few additional steps have to be performed:
- creating empty database
- loading static mysql dump into newly created database
- copying databases.travis.yml configuration file, since travis doesn't support
GRANT PRIVILEGES
statement - finally, running all tests (sample unit test and some functional)
Look at travis file for more details.