Source for file upgrade.php

Documentation is available at upgrade.php

  1. <?php
  2. /**
  3. * Simple Bumblebee upgrader -- performs everything necessary/possible to upgrade a user to newer version
  4. *
  5. * @author    Stuart Prescott
  6. * @copyright  Copyright Stuart Prescott
  7. * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  8. * @version    $Id$
  9. * @package    Bumblebee
  10. * @subpackage Installer
  11. */
  12.  
  13.  
  14. define('BUMBLEBEE', true);
  15.  
  16. error_reporting(E_ALL);
  17.  
  18. $sqlSetupFilename = 'bumbelebeeupgrade.sql';
  19.  
  20. ob_start();
  21. require_once 'installer/upgradedatabase.php';
  22. require_once 'installer/forms.php';
  23. require_once 'installer/sqlload.php';
  24. require_once 'installer/fileoutput.php';
  25. require_once 'installer/loadconfig.php';
  26.  
  27. loadInstalledConfig();
  28. require_once 'inc/db.php';
  29. require_once 'inc/formslib/sql.php';
  30.  
  31. require_once 'inc/bb/configreader.php';
  32. $conf = ConfigReader::getInstance();
  33.  
  34. require_once 'installer/installstep.php';
  35.  
  36. $steps = new InstallStepCollection();
  37. $steps->addStep(new InstallStep('Release notes',      'do_releasenotes'));
  38. $steps->addStep(new InstallStep('Check database',     'do_checkdb'));
  39. $steps->addStep(new InstallStep('Upgrade database',   'do_dbupgrade'));
  40. $steps->addStep(new InstallStep('Clean-up',           'do_cleanup'));
  41.  
  42. $data = $_POST;
  43.  
  44. $steps->setCurrent(1);
  45. if (! isset($_POST['havedata']) || isset($_POST['do_releasenotes'])) {
  46.   printStepReleaseNotes($data, $steps);
  47.   exit;
  48. }
  49.  
  50. $steps->increment();
  51. if (empty($_POST['old_db_version']) || isset($_POST['do_checkdb'])) {
  52.   $data['old_db_version'] = getCurrentDBVersion();
  53.   $data['old_version']    = $data['old_db_version'];
  54.   $data['new_version']    = $BUMBLEBEEVERSION;
  55.   $data['new_db_version'] = $data['new_version']; #substr($data['new_version'], 0, strrpos($data['new_version'], '.'));
  56.     if (version_compare($data['old_db_version'], $data['new_db_version']) == -1) {
  57.     // then the db needs upgrading
  58.         $data['db_upgrade'] = true;
  59.   } else {
  60.     $data["db_upgrade"] = false;
  61.   }
  62.   printStepUpgradeCheck($data, $steps);
  63.   exit;
  64. }
  65.  
  66. $old_db_version = $data['old_db_version'];
  67.  
  68. $steps->increment();
  69. if (isset($_POST['do_dbupgrade'])) {
  70.   list($sql, $notes) = makeUpgradeSQL($old_db_version);
  71.   $data['db-notes'] = $notes;
  72.   printStepDBUpgrade($data, $steps);
  73.   exit;
  74. }
  75. if (isset($_POST['submitsql'])) {
  76.   list($sql, $notes) = makeUpgradeSQL($old_db_version);
  77.   ob_end_clean();
  78.   outputTextFile($sqlSetupFilename, $sql);
  79.   exit;
  80. }
  81. if (isset($_POST['submitsqlload'])) {
  82.   list($sql, $notes) = makeUpgradeSQL($old_db_version);
  83.   $results = loadSQL($sql, $conf->value('database', 'host'), $_POST['sqlAdminUsername'], $_POST['sqlAdminPassword']);
  84.   $data['db-notes']   = $notes;
  85.   $data['db-results'] = $results;
  86.   printStepDBUpgrade($data, $steps);
  87.   exit;
  88. }
  89.  
  90. $steps->increment();
  91. if (isset($_POST['do_cleanup'])) {
  92.   printStepCleanup($data, $steps);
  93.   exit;
  94. }
  95.  
  96.  
  97.  
  98. printErrorMessage("I can't work out what you want me to do");
  99. exit;
  100.  
  101.  
  102.  
  103.  
  104. /**
  105. * Tell the user to look at the release notes
  106. */
  107. function printStepReleaseNotes($data, $steps) {
  108.   startHTML_upgrade($data, $steps);
  109.   ?>
  110.   <fieldset>
  111.     <legend>Upgrade information</legend>
  112.     <p>Before proceeding you should have:</p>
  113.     <ol>
  114.     <li>Read the
  115.       <a href='http://bumblebeeman.sourceforge.net/documentation/upgrade'>upgrade instructions</a>
  116.       before proceeding. No really, I mean it.</li>
  117.     <li>Backed up your data including the database and the Bumblebee installation
  118.       (or at least the <code>theme</code> and <code>config</code> directories)</li>
  119.     <li>Unpacked the archive you downloaded on your webserver; you can copy your old
  120.       <code>theme</code> and <code>config</code> directories back into the new installation
  121.       (instead of using the new ones).
  122.       You might find that many config options have been added to the <code>bumblebee.ini</code>
  123.       file that you won't even know about unless you at least look at the new file;
  124.       all new options have sensible defaults.</li>
  125.     </ol>
  126.       <p>After you have done these things, I'll guide you through the upgrade process.
  127.       It shouldn't be too hard, but we'll see how we go.</p>
  128.  
  129.   </fieldset>
  130.     <div id='buttonbar'>
  131.       <?php print $steps->getPrevNextButtons(); ?>
  132.     </div>
  133.   <?php
  134.   endHTML();
  135. }
  136. /**
  137. * Find out from the user what username and passwords to use for connecting to the database etc
  138. */
  139. function printStepUpgradeCheck($data, $steps) {
  140.   startHTML_upgrade($data, $steps);
  141.   ?>
  142.     <fieldset>
  143.       <legend>Upgrade information</legend>
  144.       <p>Looking at your installation (you should have installed the new version of Bumblebee at this stage).</p>
  145.       <p>It appears you are trying to upgrade to Bumblebee version <?php echo $data['new_version']; ?>.</p>
  146.       <p>Your old version of Bumblebee appears to be using the database format used with version
  147.       <?php echo $data['old_db_version']; ?>.</p>
  148.       <?php
  149.         if ($data['db_upgrade']) {
  150.           echo "<p>Your database needs upgrading.</p>";
  151.         } else {
  152.           echo "<p>Your database doesn't need upgrading. Great!!</p>";
  153.         }
  154.       ?>
  155.     </fieldset>
  156.     <div id='buttonbar'>
  157.       <?php print $data['db_upgrade'] ? $steps->getPrevNextButtons() : $steps->getPrevSkipToButtons(1); ?>
  158.     </div>
  159.   <?php
  160.   endHTML();
  161. }
  162.  
  163. /**
  164. * Show the user what data they have given and give options for what to do next
  165. */
  166. function printStepDBUpgrade($data, $steps) {
  167.   startHTML_upgrade($data, $steps);
  168.   if (isset($data['db-notes']) && $data['db-notes'] && ! isset($data['db-results'])) {
  169.     ?>
  170.       <fieldset>
  171.         <legend>Database Upgrade Notes</legend>
  172.         <p>Please make sure you understand the following upgrade notes regarding your database before proceeding.</p>
  173.         <blockquote>
  174.           <?php print $data['db-notes']; ?>
  175.         </blockquote>
  176.       </fieldset>
  177.     <?php
  178.   }
  179.   printDatabaseSetupForm($data);
  180.   if (isset($data['db-results'])) {
  181.     ?>
  182.       <fieldset>
  183.         <legend>Database Upgrade Results</legend>
  184.         <p>The setup script tried running the database upgrade and this is what MySQL said:</p>
  185.         <blockquote>
  186.           <?php print $data['db-results']; ?>
  187.         </blockquote>
  188.         <p>If it all went well, then proceed to the next step. Otherwise, try to fix any
  189.         errors (wrong username and password, perhaps) in the forms and have another go using
  190.         the script or try to fix it up using phpMyAdmin.</p>
  191.       </fieldset>
  192.     <?php
  193.   }
  194.   ?>
  195.     <div id='buttonbar'>
  196.       <?php print $steps->getPrevNextButtons(); ?>
  197.     </div>
  198.   <?php
  199.   endHTML();
  200. }
  201.  
  202. function printStepCleanup($values, $steps) {
  203.   $conf = ConfigReader::getInstance();
  204.   $values['BASEURL'] = $conf->BaseURL;
  205.   startHTML_upgrade($values, $steps);
  206.   genericCleanupInstructions($values, $steps);
  207.   endHTML();
  208. }
  209.  
  210. function T_($m) {
  211.   return $m;
  212. }
  213.  
  214. ?>

Documentation generated on Tue, 06 Mar 2007 10:02:06 +0000 by phpDocumentor 1.3.0