root
4 years ago
4 changed files with 1583 additions and 0 deletions
Unified View
Diff Options
-
+573 -0install.php
-
+3 -0install.php.org
-
+1003 -0update.php
-
+4 -0update.php.org
+ 573
- 0
install.php
View File
| @ -0,0 +1,573 @@ | |||||
| <?php | |||||
| // turn on warnings and notice during developement | |||||
| include('initialize/PhpErrorSettings.inc.php'); | |||||
| // Project: Web Reference Database (refbase) <http://www.refbase.net> | |||||
| // Copyright: Matthias Steffens <mailto:refbase@extracts.de> and the file's | |||||
| // original author(s). | |||||
| // | |||||
| // This code is distributed in the hope that it will be useful, | |||||
| // but WITHOUT ANY WARRANTY. Please see the GNU General Public | |||||
| // License for more details. | |||||
| // | |||||
| // File: ./install.php | |||||
| // Repository: $HeadURL: file:///svn/p/refbase/code/branches/bleeding-edge/install.php $ | |||||
| // Author(s): Matthias Steffens <mailto:refbase@extracts.de> | |||||
| // | |||||
| // Created: 07-Jan-04, 22:00 | |||||
| // Modified: $Date: 2015-02-16 20:53:19 +0000 (Mon, 16 Feb 2015) $ | |||||
| // $Author: karnesky $ | |||||
| // $Revision: 1405 $ | |||||
| // This file will install the literature database for you. Note that you must have | |||||
| // an existing PHP and MySQL installation. Please see the readme for further information. | |||||
| // CAUTION: YOU MUST REMOVE THIS SCRIPT FROM YOUR WEB DIRECTORY AFTER INSTALLATION!! | |||||
| // Incorporate some include files: | |||||
| include 'initialize/db.inc.php'; // 'db.inc.php' is included to hide username and password | |||||
| include 'includes/header.inc.php'; // include header | |||||
| include 'includes/footer.inc.php'; // include footer | |||||
| include 'includes/include.inc.php'; // include common functions | |||||
| include 'includes/install.inc.php'; // include install/update functions | |||||
| include 'initialize/ini.inc.php'; // include common variables | |||||
| // -------------------------------------------------------------------- | |||||
| // START A SESSION: | |||||
| // call the 'start_session()' function (from 'include.inc.php') which will also read out available session variables: | |||||
| start_session(false); | |||||
| // -------------------------------------------------------------------- | |||||
| // Initialize preferred display language: | |||||
| // (note that 'locales.inc.php' has to be included *after* the call to the 'start_session()' function) | |||||
| include 'includes/locales.inc.php'; // include the locales | |||||
| // -------------------------------------------------------------------- | |||||
| // This specifies the name of the database that handles the MySQL user access privileges. | |||||
| // Unless you've fiddled with it, you shouldn't change the default value ('mysql'): | |||||
| $adminDatabaseName = 'mysql'; | |||||
| // Extract any parameters passed to the script: | |||||
| if (isset($_POST['adminUserName'])) | |||||
| $adminUserName = $_POST['adminUserName']; | |||||
| else | |||||
| $adminUserName = ""; | |||||
| if (isset($_POST['adminPassword'])) | |||||
| $adminPassword = $_POST['adminPassword']; | |||||
| else | |||||
| $adminPassword = ""; | |||||
| if (isset($_POST['pathToMYSQL'])) | |||||
| $pathToMYSQL = $_POST['pathToMYSQL']; | |||||
| else | |||||
| $pathToMYSQL = ""; | |||||
| if (isset($_POST['databaseStructureFile'])) | |||||
| $databaseStructureFile = $_POST['databaseStructureFile']; | |||||
| else | |||||
| $databaseStructureFile = ""; | |||||
| if (isset($_POST['pathToBibutils'])) | |||||
| $pathToBibutils = $_POST['pathToBibutils']; | |||||
| else | |||||
| $pathToBibutils = ""; | |||||
| if (isset($_POST['defaultCharacterSet'])) | |||||
| $defaultCharacterSet = $_POST['defaultCharacterSet']; | |||||
| else | |||||
| $defaultCharacterSet = ""; | |||||
| // -------------------------------------------------------------------- | |||||
| // Check the correct parameters have been passed: | |||||
| if (empty($adminUserName) AND empty($adminPassword) AND empty($pathToMYSQL) AND empty($databaseStructureFile)) | |||||
| { | |||||
| // if 'install.php' was called without any valid parameters: | |||||
| //Display an installation form: | |||||
| if (isset($_SESSION['errors'])) | |||||
| { | |||||
| $errors = $_SESSION['errors']; | |||||
| // Note: though we clear the session variable, the current error message is still available to this script via '$errors': | |||||
| deleteSessionVariable("errors"); // function 'deleteSessionVariable()' is defined in 'include.inc.php' | |||||
| } | |||||
| else | |||||
| $errors = array(); // initialize the '$errors' variable in order to prevent 'Undefined variable...' messages | |||||
| if (isset($_SESSION['formVars'])) | |||||
| { | |||||
| $formVars = $_SESSION['formVars']; | |||||
| // Note: though we clear the session variable, the current form variables are still available to this script via '$formVars': | |||||
| deleteSessionVariable("formVars"); // function 'deleteSessionVariable()' is defined in 'include.inc.php' | |||||
| } | |||||
| else | |||||
| { | |||||
| // Reset the '$formVars' variable (since we're providing the default values): | |||||
| $formVars = array(); | |||||
| $pathSeparator = PATH_SEPARATOR; | |||||
| $pathItems = explode($pathSeparator, getenv("PATH")); | |||||
| // Provide default values for the form fields: | |||||
| $formVars["adminUserName"] = "root"; | |||||
| $formVars["adminPassword"] = ""; | |||||
| $formVars["databaseStructureFile"] = "./install.sql"; | |||||
| // Try to find the 'mysql' command line interpreter: | |||||
| $mysqlLocations = array_unique(array_merge($pathItems, array("/Program Files/MySQL/bin", "/wamp/mysql/bin", "/Program Files/xampp/mysql/bin", "/www/xampp/mysql/bin", "/xampp/mysql/bin", "/apachefriends/xampp/mysql/bin", "/usr/local/mysql/bin", "/usr/local/bin/mysql/bin", "/usr/bin/mysql/bin", "/usr/mysql/bin", "/opt/local/bin/", "/opt/local/lib/mysql4/bin/", "/opt/local/lib/mysql5/bin/"))); | |||||
| $mysqlNames = array("mysql", "mysql.exe"); | |||||
| $formVars["pathToMYSQL"] = locateFile($mysqlLocations, $mysqlNames, false); // function 'locateFile()' is defined in 'install.inc.php' | |||||
| // Try to find the Bibutils programs: | |||||
| $bibutilsLocations = array_unique(array_merge($pathItems, array("/usr/bin", "/usr/local/bin", "/opt/local/bin/", ".", "./refbase", "./bibutils"))); | |||||
| // We'll only check for one program to save time (and because, we currently don't allow the script to have a subset of the functionality provided by Bibutils) | |||||
| $bibutilsNames = array("xml2bib", "xml2bib.exe"); | |||||
| $formVars["pathToBibutils"] = locateFile($bibutilsLocations, $bibutilsNames, true); | |||||
| $formVars["defaultCharacterSet"] = "latin1"; | |||||
| } | |||||
| // If there's no stored message available: | |||||
| if (!isset($_SESSION['HeaderString'])) | |||||
| { | |||||
| if (empty($errors)) // provide the default message: | |||||
| $HeaderString = "To install the refbase package please fill out the form below and click the <em>Install</em> button:"; | |||||
| else // -> there were errors when validating the fields | |||||
| $HeaderString = "There were validation errors regarding the details you entered. Please check the comments above the respective fields:"; | |||||
| } | |||||
| else | |||||
| { | |||||
| $HeaderString = $_SESSION['HeaderString']; // extract 'HeaderString' session variable (only necessary if register globals is OFF!) | |||||
| // Note: though we clear the session variable, the current message is still available to this script via '$HeaderString': | |||||
| deleteSessionVariable("HeaderString"); // function 'deleteSessionVariable()' is defined in 'include.inc.php' | |||||
| } | |||||
| // Extract the view type requested by the user (either 'Mobile', 'Print', 'Web' or ''): | |||||
| // ('' will produce the default 'Web' output style) | |||||
| if (isset($_REQUEST['viewType'])) | |||||
| $viewType = $_REQUEST['viewType']; | |||||
| else | |||||
| $viewType = ""; | |||||
| // For the default character set, make sure that the correct popup menu entry is selected upon reload: | |||||
| if ($formVars["defaultCharacterSet"] == "utf8") | |||||
| { | |||||
| $latin1CharacterSetSelected = ""; | |||||
| $unicodeCharacterSetSelected = " selected"; | |||||
| } | |||||
| else // $formVars["defaultCharacterSet"] is 'latin1' or '' | |||||
| { | |||||
| $latin1CharacterSetSelected = " selected"; | |||||
| $unicodeCharacterSetSelected = ""; | |||||
| } | |||||
| // Show the login status: | |||||
| showLogin(); // (function 'showLogin()' is defined in 'include.inc.php') | |||||
| // DISPLAY header: | |||||
| // call the 'displayHTMLhead()' and 'showPageHeader()' functions (which are defined in 'header.inc.php'): | |||||
| displayHTMLhead(encodeHTML($officialDatabaseName) . " -- Installation", "index,follow", "Installation form for the " . encodeHTML($officialDatabaseName), "", false, "", $viewType, array()); | |||||
| showPageHeader($HeaderString); | |||||
| // Start <form> and <table> holding the form elements: | |||||
| ?> | |||||
| <form action="install.php" method="POST"> | |||||
| <input type="hidden" name="formType" value="install"> | |||||
| <input type="hidden" name="submit" value="Install"><?php // provide a default value for the 'submit' form tag. Otherwise, some browsers may not recognize the correct output format when a user hits <enter> within a form field (instead of clicking the "Install" button) ?> | |||||
| <table align="center" border="0" cellpadding="0" cellspacing="12" width="95%" summary="This table holds the installation form"> | |||||
| <tr> | |||||
| <td colspan="3"><h3>refbase Installation</h3></td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td width="190" valign="top"><b>Important note:</b></td> | |||||
| <td valign="top" colspan="2"> | |||||
| Before executing this script, it is highly recommended to <span class="warning">open the include file <em>initialize/db.inc.php</em></span> in a text editor and edit the values of the variables <em>$databaseName</em>, <em>$username</em> and <em>$password</em> to suit your setup! Then, proceed with this form: | |||||
| </td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>MySQL admin user:</b></td> | |||||
| <td valign="top"><?php echo fieldError("adminUserName", $errors); ?> | |||||
| <input type="text" name="adminUserName" value="<?php echo $formVars["adminUserName"]; ?>" size="30"> | |||||
| </td> | |||||
| <td valign="top">Give the name of an administrative user that has full access to the MySQL admin database. Often, this is the <em>root</em> user.</td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>MySQL admin password:</b></td> | |||||
| <td valign="top"><?php | |||||
| // the form won't remember the password, so we'll ask the user to re-type it... | |||||
| if (!empty($errors) AND !isset($errors["adminPassword"])) // ...if there were some validation errors but not with the password field | |||||
| echo "\n\t\t\t<b>Please type your password again:</b>\n\t\t\t<br>"; | |||||
| else | |||||
| echo fieldError("adminPassword", $errors); | |||||
| ?> | |||||
| <input type="password" name="adminPassword" size="30"> | |||||
| </td> | |||||
| <td valign="top">Please enter the password for the administrative user you've specified above.</td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Path to the MySQL application:</b></td> | |||||
| <td valign="top"><?php echo fieldError("pathToMYSQL", $errors); ?> | |||||
| <input type="text" name="pathToMYSQL" value="<?php echo $formVars["pathToMYSQL"]; ?>" size="30"> | |||||
| </td> | |||||
| <td valign="top">Specify the full path to the <em>mysql</em> command line interpreter. The install script attempts to locate the <em>mysql</em> program for you. If the field is empty, please enter the full path manually.</td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Path to the database structure file:</b></td> | |||||
| <td valign="top"><?php echo fieldError("databaseStructureFile", $errors); ?> | |||||
| <input type="text" name="databaseStructureFile" value="<?php echo $formVars["databaseStructureFile"]; ?>" size="30"> | |||||
| </td> | |||||
| <td valign="top">Enter the full path to the SQL dump file containing the database structure & data. Keep the default value, if you're installing refbase for the first time.</td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Path to the Bibutils directory [optional]:</b></td> | |||||
| <td valign="top"><?php echo fieldError("pathToBibutils", $errors); ?> | |||||
| <input type="text" name="pathToBibutils" value="<?php echo $formVars["pathToBibutils"]; ?>" size="30"> | |||||
| </td> | |||||
| <td valign="top"><a href="http://bibutils.refbase.net/" target="top" title="more info about the refbase integration with Bibutils"><em>Bibutils</em></a> provides additional import and export funtionality to refbase (e.g. support for Endnote & BibTeX). It is optional, but highly recommended. The install script attempts to locate <em>Bibutils</em> for you. If you can't access <em>Bibutils</em> from your path, please fill this value in manually (and, if you think other people might have <em>Bibutils</em> installed to the same path, <a href="http://support.refbase.net/" target="top" title="refbase forums & mailinglists">report</a> it to the refbase developers). The path must end with a slash!</td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Default character set:</b></td> | |||||
| <td valign="top"><?php echo fieldError("defaultCharacterSet", $errors); ?> | |||||
| <select name="defaultCharacterSet"> | |||||
| <option<?php echo $latin1CharacterSetSelected; ?>>latin1</option> | |||||
| <option<?php echo $unicodeCharacterSetSelected; ?>>utf8</option> | |||||
| </select> | |||||
| </td> | |||||
| <td valign="top">Specify the default character set for the MySQL database used by refbase. Note that <em>utf8</em> (Unicode) requires MySQL 4.1.x or greater, otherwise <em>latin1</em> (i.e., ISO-8859-1 West European) will be used by default.</td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"> </td> | |||||
| <td valign="top" align="right"> | |||||
| <input type="submit" name="submit" value="Install"> | |||||
| </td> | |||||
| <td valign="top"><span class="warning">CAUTION:</span> Note that, if there's already an existing refbase database with the name specified in <em>$databaseName</em>, clicking the <em>Install</em> button will overwrite ALL data in that database! If you'd like to install the refbase tables into another existing database, you must ensure that there are no table name conflicts (<a href="http://install.refbase.net/" target="top" title="howto install refbase over an existing database">more info</a>).</td> | |||||
| </tr> | |||||
| </table> | |||||
| </form><?php | |||||
| // -------------------------------------------------------------------- | |||||
| // DISPLAY THE HTML FOOTER: | |||||
| // call the 'showPageFooter()' and 'displayHTMLfoot()' functions (which are defined in 'footer.inc.php') | |||||
| showPageFooter($HeaderString); | |||||
| displayHTMLfoot(); | |||||
| // -------------------------------------------------------------------- | |||||
| } | |||||
| else // some parameters have been passed, so let's validate the fields: | |||||
| { | |||||
| // -------------------------------------------------------------------- | |||||
| // Clear any errors that might have been found previously: | |||||
| $errors = array(); | |||||
| // Write the (POST) form variables into an array: | |||||
| foreach($_POST as $varname => $value) | |||||
| $formVars[$varname] = $value; | |||||
| // Validate the 'adminUserName' field: | |||||
| if (empty($formVars["adminUserName"])) | |||||
| // The 'adminUserName' field cannot be a null string | |||||
| $errors["adminUserName"] = "This field cannot be blank:"; | |||||
| // Validate the 'adminPassword' field: | |||||
| if (empty($formVars["adminPassword"])) | |||||
| // The 'adminPassword' field cannot be a null string | |||||
| $errors["adminPassword"] = "This field cannot be blank:"; | |||||
| // Validate the 'pathToMYSQL' field: | |||||
| if (empty($formVars["pathToMYSQL"])) | |||||
| // The 'pathToMYSQL' field cannot be a null string | |||||
| $errors["pathToMYSQL"] = "This field cannot be blank:"; | |||||
| elseif (preg_match("/[;|]/", $formVars["pathToMYSQL"])) | |||||
| // For security reasons, the 'pathToMYSQL' field cannot contain the characters ';' or '|' (which would tie multiple shell commands together) | |||||
| $errors["pathToMYSQL"] = "Due to security reasons this field cannot contain the characters ';' or '|':"; | |||||
| elseif (is_dir($formVars["pathToMYSQL"])) | |||||
| // Check if the specified path resolves to a directory | |||||
| $errors["pathToMYSQL"] = "You cannot specify a directory! Please give the path to the mysql command:"; | |||||
| elseif (!is_readable($formVars["pathToMYSQL"])) | |||||
| // Check if the specified path resolves to the mysql application | |||||
| $errors["pathToMYSQL"] = "Your path specification is invalid (command not found):"; | |||||
| // Note: Currently, the checks for whether the function is executable or whether it is mysql have been commented out, | |||||
| // since they don't seem to work on windows! (see <http://sourceforge.net/forum/forum.php?thread_id=1021143&forum_id=218758>) | |||||
| // elseif (!is_executable($formVars["pathToMYSQL"])) | |||||
| // // Check if the given file is executable | |||||
| // $errors["pathToMYSQL"] = "This file does not appear to be an executable command:"; | |||||
| // elseif (!preg_match("#(^|.*/)mysql$#", $formVars["pathToMYSQL"])) | |||||
| // // Make sure that the given file is 'mysql' | |||||
| // $errors["pathToMYSQL"] = "This does not appear to be the 'mysql' command line interpreter:"; | |||||
| // Validate the 'databaseStructureFile' field: | |||||
| if (empty($formVars["databaseStructureFile"])) | |||||
| // The 'databaseStructureFile' field cannot be a null string | |||||
| $errors["databaseStructureFile"] = "This field cannot be blank:"; | |||||
| elseif (preg_match("/[;|]/", $formVars["databaseStructureFile"])) | |||||
| // For security reasons, the 'databaseStructureFile' field cannot contain the characters ';' or '|' (which would tie multiple shell commands together) | |||||
| $errors["databaseStructureFile"] = "Due to security reasons this field cannot contain the characters ';' or '|':"; | |||||
| elseif (is_dir($formVars["databaseStructureFile"])) | |||||
| // Check if the specified path resolves to a directory | |||||
| $errors["databaseStructureFile"] = "You cannot specify a directory! Please give the path to the database structure file:"; | |||||
| elseif (!is_readable($formVars["databaseStructureFile"])) | |||||
| // Check if the specified path resolves to the database structure file | |||||
| $errors["databaseStructureFile"] = "Your path specification is invalid (file not found):"; | |||||
| // Validate the 'pathToBibutils' field: | |||||
| if (!empty($formVars["pathToBibutils"])) // we'll only validate the 'pathToBibutils' field if it isn't empty (installation of Bibutils is optional) | |||||
| { | |||||
| if (preg_match("/[;|]/", $formVars["pathToBibutils"])) | |||||
| // For security reasons, the 'pathToBibutils' field cannot contain the characters ';' or '|' (which would tie multiple shell commands together) | |||||
| $errors["pathToBibutils"] = "Due to security reasons this field cannot contain the characters ';' or '|':"; | |||||
| elseif (!is_readable($formVars["pathToBibutils"])) | |||||
| // Check if the specified path resolves to an existing directory | |||||
| $errors["pathToBibutils"] = "Your path specification is invalid (directory not found):"; | |||||
| elseif (!is_dir($formVars["pathToBibutils"])) | |||||
| // Check if the specified path resolves to a directory (and not a file) | |||||
| $errors["pathToBibutils"] = "You must specify a directory! Please give the path to the directory containing the Bibutils utilities:"; | |||||
| } | |||||
| // Validate the 'defaultCharacterSet' field: | |||||
| // Note: Currently we're not generating an error & rooting back to the install form, if the user did choose 'utf8' but has some MySQL version < 4.1 installed. | |||||
| // In this case, we'll simply ignore the setting and 'latin1' will be used by default. | |||||
| // -------------------------------------------------------------------- | |||||
| // Now the script has finished the validation, check if there were any errors: | |||||
| if (count($errors) > 0) | |||||
| { | |||||
| // Write back session variables: | |||||
| saveSessionVariable("errors", $errors); // function 'saveSessionVariable()' is defined in 'include.inc.php' | |||||
| saveSessionVariable("formVars", $formVars); | |||||
| // There are errors. Relocate back to the installation form: | |||||
| header("Location: install.php"); | |||||
| exit; // >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> !EXIT! <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< | |||||
| } | |||||
| // -------------------------------------------------------------------- | |||||
| // If we made it here, then the data is considered valid! | |||||
| // (1) Open the database connection and use the mysql database: | |||||
| if (!($connection = @ mysql_connect($hostName,$adminUserName,$adminPassword))) | |||||
| if (mysql_errno() != 0) // this works around a stupid(?) behaviour of the Roxen webserver that returns 'errno: 0' on success! ?:-( | |||||
| showErrorMsg("The following error occurred while trying to connect to the host:", ""); | |||||
| if (!(mysql_select_db($adminDatabaseName, $connection))) | |||||
| if (mysql_errno() != 0) // this works around a stupid(?) behaviour of the Roxen webserver that returns 'errno: 0' on success! ?:-( | |||||
| showErrorMsg("The following error occurred while trying to connect to the database:", ""); | |||||
| // First, check if we're a dealing with MySQL version 4.1.x or greater: | |||||
| // (MySQL 4.1.x is required if the refbase MySQL database/tables shall be installed using Unicode/UTF-8 as default character set) | |||||
| $mysqlVersion = getMySQLversion(); // function 'getMySQLversion()' is defined in 'include.inc.php' | |||||
| // -------------------------------------------------------------------- | |||||
| // Prepare the install queries and proceed with the actual installation procedure: | |||||
| // Build the database queries required for installation: | |||||
| $queryGrantStatement = "GRANT SELECT,INSERT,UPDATE,DELETE ON " . $databaseName . ".* TO " . quote_smart($username) . "@" . quote_smart($hostName) . " IDENTIFIED BY " . quote_smart($password); | |||||
| $queryCreateDB = "CREATE DATABASE IF NOT EXISTS " . $databaseName; // by default, 'latin1' will be used as default character set | |||||
| if ($mysqlVersion >= 4.1) // if MySQL 4.1.x (or greater) is installed... | |||||
| { | |||||
| $queryCreateDB = $queryCreateDB . " DEFAULT CHARACTER SET " . $defaultCharacterSet; // ...add the default character set chosen by the user | |||||
| if ($defaultCharacterSet == "utf8") // ...in case of UTF-8, adjust the path to the default database structure file if necessary | |||||
| if ($databaseStructureFile == "./install.sql") | |||||
| $databaseStructureFile = "./install_utf8.sql"; | |||||
| } | |||||
| if (!empty($pathToBibutils)) // we'll only update the Bibutils path if '$pathToBibutils' isn't empty (installation of Bibutils is optional) | |||||
| $queryUpdateDependsTable = "UPDATE " . $databaseName . "." . $tableDepends . " SET depends_path = " . quote_smart($pathToBibutils) . " WHERE depends_external = \"bibutils\""; // update the Bibutils path spec | |||||
| else // we set the 'depends_enabled' field in table 'depends' to 'false' to indicate that Bibutils isn't installed | |||||
| $queryUpdateDependsTable = "UPDATE " . $databaseName . "." . $tableDepends . " SET depends_enabled = \"false\" WHERE depends_external = \"bibutils\""; // disable Bibutils functionality | |||||
| // (2) Run the INSTALL queries on the mysql database through the connection: | |||||
| if (!($result = @ mysql_query ($queryGrantStatement, $connection))) | |||||
| if (mysql_errno() != 0) // this works around a stupid(?) behaviour of the Roxen webserver that returns 'errno: 0' on success! ?:-( | |||||
| showErrorMsg("The following error occurred while trying to query the database:", ""); | |||||
| if (!($result = @ mysql_query ($queryCreateDB, $connection))) | |||||
| if (mysql_errno() != 0) // this works around a stupid(?) behaviour of the Roxen webserver that returns 'errno: 0' on success! ?:-( | |||||
| showErrorMsg("The following error occurred while trying to query the database:", ""); | |||||
| // IMPORT the literature database structure from file: | |||||
| exec($pathToMYSQL . " -h " . $hostName . " -u " . $adminUserName . " -p" . $adminPassword . " --database=" . $databaseName . " < " . $databaseStructureFile . " 2>&1", $resultArray); | |||||
| // User note from <http://de2.php.net/manual/en/ref.exec.php> regarding the use of PHP's 'exec()' command: | |||||
| // From 'eremy at ntb dot co dot nz' (28-Sep-2003 03:18): | |||||
| // If an error occurs in the code you're trying to exec(), it can be challenging to figure out what's going | |||||
| // wrong, since php echoes back the stdout stream rather than the stderr stream where all the useful error | |||||
| // reporting's done. The solution is to add the code "2>&1" to the end of your shell command, which redirects | |||||
| // stderr to stdout, which you can then easily print using something like print `shellcommand 2>&1`. | |||||
| // run the UPDATE query on the depends table of the (just imported) literature database: | |||||
| if (!($result = @ mysql_query ($queryUpdateDependsTable, $connection))) | |||||
| if (mysql_errno() != 0) // this works around a stupid(?) behaviour of the Roxen webserver that returns 'errno: 0' on success! ?:-( | |||||
| showErrorMsg("The following error occurred while trying to query the database:", ""); | |||||
| // (5) Close the database connection: | |||||
| if (!(mysql_close($connection))) | |||||
| if (mysql_errno() != 0) // this works around a stupid(?) behaviour of the Roxen webserver that returns 'errno: 0' on success! ?:-( | |||||
| showErrorMsg("The following error occurred while trying to disconnect from the database:", ""); | |||||
| $resultLines = ""; // initialize variable | |||||
| // Read out the execution result array: | |||||
| if (!empty($resultArray)) // if there were any execution errors | |||||
| { | |||||
| reset($resultArray); // reset the internal array pointer to the first element | |||||
| while (list ($key, $val) = each ($resultArray)) | |||||
| $resultLines .= "\n" . trim($val); // append each of the array elements to a string | |||||
| } | |||||
| // -------------------------------------------------------------------- | |||||
| // Provide a feedback page: | |||||
| // If there's no stored message available: | |||||
| if (!isset($_SESSION['HeaderString'])) // provide one of the default messages: | |||||
| { | |||||
| if (!empty($resultArray)) // if there were any execution errors | |||||
| $HeaderString = "The following error occurred while trying to import the SQL data into the database:"; | |||||
| else // assume that the installation was successful | |||||
| $HeaderString = "Installation of the Web Reference Database was successful!"; | |||||
| } | |||||
| else | |||||
| { | |||||
| $HeaderString = $_SESSION['HeaderString']; // extract 'HeaderString' session variable (only necessary if register globals is OFF!) | |||||
| // Note: though we clear the session variable, the current message is still available to this script via '$HeaderString': | |||||
| deleteSessionVariable("HeaderString"); // function 'deleteSessionVariable()' is defined in 'include.inc.php' | |||||
| } | |||||
| // Extract the view type requested by the user (either 'Mobile', 'Print', 'Web' or ''): | |||||
| // ('' will produce the default 'Web' output style) | |||||
| if (isset($_REQUEST['viewType'])) | |||||
| $viewType = $_REQUEST['viewType']; | |||||
| else | |||||
| $viewType = ""; | |||||
| // Show the login status: | |||||
| showLogin(); // (function 'showLogin()' is defined in 'include.inc.php') | |||||
| // DISPLAY header: | |||||
| // call the 'displayHTMLhead()' and 'showPageHeader()' functions (which are defined in 'header.inc.php'): | |||||
| displayHTMLhead(encodeHTML($officialDatabaseName) . " -- Installation Feedback", "index,follow", "Installation feedback for the " . encodeHTML($officialDatabaseName), "", false, "", $viewType, array()); | |||||
| showPageHeader($HeaderString); | |||||
| // Start a <table>: | |||||
| ?> | |||||
| <table align="center" border="0" cellpadding="0" cellspacing="10" width="95%" summary="This table holds the installation feedback info"><?php | |||||
| if (!empty($resultArray)) // if there were any execution errors: | |||||
| { | |||||
| ?> | |||||
| <tr> | |||||
| <td valign="top"><b>Error:</b></td> | |||||
| <td><?php echo encodeHTML($resultLines); ?></td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"> </td> | |||||
| <td> | |||||
| <b>Please make sure that you've specified the correct path to the MySQL database structure file!</b> | |||||
| </td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"> </td> | |||||
| <td> | |||||
| <a href="install.php">Go Back</a> | |||||
| </td> | |||||
| </tr><?php | |||||
| } | |||||
| else // no execution errors -> inform the user about successful database installation: | |||||
| { | |||||
| ?> | |||||
| <tr> | |||||
| <td colspan="2"><h3>Welcome to refbase!</h3></td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Important Note:</b></td> | |||||
| <td> | |||||
| The <em>install.php</em> script is only provided for installation purposes and is not needed anymore. Due to security considerations you should <span class="warning">remove this script</span> from your web directory NOW!! | |||||
| </td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Setup users:</b></td> | |||||
| <td> | |||||
| Here's how to setup the admin user account for your newly created literature database: | |||||
| <ul type="circle"> | |||||
| <li>Goto <a href="index.php" target="_blank" title="Open the main page in a new window"><?php echo encodeHTML($officialDatabaseName); ?></a></li> | |||||
| <li>Login with email address = <em>user@refbase.net</em> & password = <em>start</em></li> | |||||
| <li>Click on <em>Add User</em> and enter the name, institutional abbreviation, email address and password of the admin user</li> | |||||
| <li>Open the file <em>ini.inc.php</em> in a text editor and change the value of the <em>$adminLoginEmail</em> variable to the email address you've specified for the admin user</li> | |||||
| <li>Log out, then login again using the email address and password of your newly created admin account</li> | |||||
| </ul> | |||||
| If you want to add additional users use the <em>Add User</em> link and enter the user's name, institutional abbreviation, email address and password. | |||||
| </td> | |||||
| </tr> | |||||
| <tr> | |||||
| <td valign="top"><b>Configure refbase:</b></td> | |||||
| <td> | |||||
| In order to customize your literature database, please open again <em>ini.inc.php</em> in a text editor. This include file contains variables that are common to all scripts and whose values can/must be adopted to your needs. Please see the comments within the file for further information. | |||||
| </td> | |||||
| </tr><?php | |||||
| } | |||||
| ?> | |||||
| </table><?php | |||||
| // -------------------------------------------------------------------- | |||||
| // DISPLAY THE HTML FOOTER: | |||||
| // call the 'showPageFooter()' and 'displayHTMLfoot()' functions (which are defined in 'footer.inc.php') | |||||
| showPageFooter($HeaderString); | |||||
| displayHTMLfoot(); | |||||
| // -------------------------------------------------------------------- | |||||
| } | |||||
| ?> | |||||