Download and installation instructions for the Dataface framework.
Dataface is a 100% PHP Framework that comes with all dependencies as
part of the installation. The framework itself lives inside a
single directory that should be placed inside the document root of your
web server so that it can be accessed from the web. You can
install a single copy of Dataface to be used by multiple applications
on your web server. Each application just "requires" the key
files from the Dataface framework.
Downloading
- Go to the Dataface Sourceforge project file releases page
- Download the latest file release.
Installing
- Unpack the gzipped tar archive that you downloaded somewhere in
your web server's document root (i.e., make sure that the 'dataface'
directory is in a web-accessible location).
- Make the dataface/Dataface/templates_c directory writable by the web server. An unsafe way to do this is to
chmod 777 Dataface/templates_c
But it would be better to just give write access to the web server user.
- Confirm that the installation worked by pointing the web browser
to http://yourdomain.com/path/to/dataface/dataface_info.php . If it
worked OK, you should receive a web page that says "Dataface is
installed correctly", along with some basic instructions for creating a
Dataface Application. (Note:
Sometimes this page will give you a false positive. i.e., it may
say the installation worked but then your dataface application receives
errors. Check the troubleshooting section below to deal with
these issues).
Troubleshooting
If your installation is not going as planned, don't panic. There is
a possiblity that your system has a slightly different configuration
and you have to make some small adjustments to make the installation
work.
The general procedure for troubleshooting the installation is as follows:
- Check the Error References section to see if others have previously encountered your error.
- Check the bug tracker on sourceforge to see if the error has previously been reported and if there is a workaround.
- Join and send to the mailing list. (dataface-users@lists.sourceforge.net)
- Send email to Steve Hannah
(the Dataface developer). He is happy to receive comments and
feedback, and is happy to help solve your installation problems if
possible.
