From bb4a7a728103037b17ac6adb118f97363f2a2571 Mon Sep 17 00:00:00 2001 From: Ryan Walberg Date: Tue, 27 Nov 2012 16:29:04 +0000 Subject: [PATCH] updated installation instructions --- src/INSTALL | 45 ++++++++++++++++++++++++++++++--------------- 1 file changed, 30 insertions(+), 15 deletions(-) diff --git a/src/INSTALL b/src/INSTALL index c7d9a19..0b265fc 100644 --- a/src/INSTALL +++ b/src/INSTALL @@ -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