updated installation instructions

This commit is contained in:
Ryan Walberg 2012-11-27 16:29:04 +00:00
parent 713fdc9e8c
commit bb4a7a7281

View file

@ -1,5 +1,9 @@
Installation Instructions
NOTE: these instructions are specific to operating with MySQL.
If you're going to use a different database, substitute your database
server's setup procedure where necessary.
1. Unpack phpgiftreg website
2. Create MySQL database
3. Create MySQL tables
@ -30,6 +34,10 @@ writeable by the webserver. The phpgiftreg scripts will be writing files
to this directory. Don't worry, the setup.php script described below
will test if you got this right.
As of 2.0.0, there are subdirectories called cache/ and templates_c/
that must also be writeable by the webserver. setup.php will also test
if those have the correct permissions.
=============================================================================
2. Create MySQL database
@ -90,24 +98,27 @@ This creates a user called `username' that can connect from `host'.
=============================================================================
5. Configure db.php
5. Configure includes/config.php
Change to the phpgiftreg/ directory and edit the db.php file. There's a line
with a call to mysql_connect(). Change it to suit your setup.
You MUST edit includes/config.php to define your database connection.
It is required to set the `pdo_connection_string', `pdo_username'
and `pdo_password' settings. See
http://www.php.net/manual/en/pdo.construct.php for more information,
especially if you are going to use a database other than MySQL.
mysql_connect("host","username","password")
or die("Could not connect: " . mysql_error());
=============================================================================
6. Configure config.php
NOTE: phpgiftreg is only tested on MySQL, though other databases should
(in theory) work with little modification.
There are some options to change in config.php if you wish. Their functions
are described in that file.
NOTE: older versions of phpgiftreg defined database parameters in a
file called db.php. That file is no longer used, and connection information
belongs in includes/config.php.
=============================================================================
7. Create Apache alias
6. Create Apache alias
Edit your httpd.conf and add an Alias like so:
@ -118,14 +129,18 @@ be good to go.
=============================================================================
8. Set up the initial family and user using setup.php
7. Set up the initial family and user using setup.php
Point your browser to http://yourserver/phpgiftreg/setup.php or wherever you
installed it. You'll be prompted to enter some details for an initial
administrator user and the default family. If everything goes well, you'll
be ready to begin!
installed it. It will check your confirmation, and then you'll be prompted
to enter some details for an initial administrator user and the default
family. If everything goes well, you'll be ready to begin!
=============================================================================
If you have any problems with these instructions, or if they weren't clear
or just didn't plain work, please let me know at generalpf@yahoo.com.
or just didn't plain work, please let me know at generalpf@gmail.
Ryan Walberg
generalpf@gmail.com
@GeneralPF