user_guide/installation/upgrade_130.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   3 <head>
   4
   5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   6 <title>CodeIgniter User Guide</title>
   7
   8 <style type='text/css' media='all'>@import url('../userguide.css');</style>
   9 <link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />
  10
  11 <script type="text/javascript" src="../nav/nav.js"></script>
  12 <script type="text/javascript" src="../nav/prototype.lite.js"></script>
  13 <script type="text/javascript" src="../nav/moo.fx.js"></script>
  14 <script type="text/javascript" src="../nav/user_guide_menu.js"></script>
  15
  16 <meta http-equiv='expires' content='-1' />
  17 <meta http-equiv= 'pragma' content='no-cache' />
  18 <meta name='robots' content='all' />
  19 <meta name='author' content='ExpressionEngine Dev Team' />
  20 <meta name='description' content='CodeIgniter User Guide' />
  21
  22 </head>
  23 <body>
  24
  25 <!-- START NAVIGATION -->
  26 <div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
  27 <div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Toggle Table of Contents" alt="Toggle Table of Contents" /></a></div>
  28 <div id="masthead">
  29 <table cellpadding="0" cellspacing="0" border="0" style="width:100%">
  30 <tr>
  31 <td><h1>CodeIgniter User Guide Version 2.0.2</h1></td>
  32 <td id="breadcrumb_right"><a href="../toc.html">Table of Contents Page</a></td>
  33 </tr>
  34 </table>
  35 </div>
  36 <!-- END NAVIGATION -->
  37
  38
  39 <!-- START BREADCRUMB -->
  40 <table cellpadding="0" cellspacing="0" border="0" style="width:100%">
  41 <tr>
  42 <td id="breadcrumb">
  43 <a href="http://codeigniter.com/">CodeIgniter Home</a> &nbsp;&#8250;&nbsp;
  44 <a href="../index.html">User Guide Home</a> &nbsp;&#8250;&nbsp;
  45 Upgrading from 1.2 to 1.3
  46 </td>
  47 <td id="searchbox"><form method="get" action="http://www.google.com/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.com/user_guide/" />Search User Guide&nbsp; <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />&nbsp;<input type="submit" class="submit" name="sa" value="Go" /></form></td>
  48 </tr>
  49 </table>
  50 <!-- END BREADCRUMB -->
  51
  52 <br clear="all" />
  53
  54
  55 <!-- START CONTENT -->
  56 <div id="content">
  57
  58 <h1>Upgrading from 1.2 to 1.3</h1>
  59
  60 <p class="important"><strong>Note:</strong> The instructions on this page assume you are running version 1.2.  If you
  61 have not upgraded to that version please do so first.</p>
  62
  63
  64 <p>Before performing an update you should take your site offline by replacing the index.php file
  65 with a static one.</p>
  66
  67
  68 <h2>Step 1: Update your CodeIgniter files</h2>
  69
  70 <p>Replace the following directories in your "system" folder with the new versions:</p>
  71
  72 <p class="important"><strong>Note:</strong> If you have any custom developed files in these folders please make copies of them first.</p>
  73
  74 <ul>
  75 <li>application/<strong>models</strong>/&nbsp;&nbsp;  (new for 1.3)</li>
  76 <li>codeigniter&nbsp;&nbsp;   (new for 1.3)</li>
  77 <li>drivers</li>
  78 <li>helpers</li>
  79 <li>init</li>
  80 <li>language</li>
  81 <li>libraries</li>
  82 <li>plugins</li>
  83 <li>scaffolding</li>
  84 </ul>
  85
  86
  87 <h2>Step 2: Update your error files</h2>
  88
  89 <p>Version 1.3 contains two new error templates located in <dfn>application/errors</dfn>, and for naming consistency the other error templates have
  90 been renamed.</p>
  91
  92 <p>If you <strong>have not</strong> customized any of the error templates simply
  93 replace this folder:</p>
  94
  95 <ul>
  96 <li>application/errors/</li>
  97 </ul>
  98
  99 <p>If you <strong>have</strong> customized your error templates, rename them as follows:</p>
 100
 101
 102 <ul>
 103 <li>404.php&nbsp;&nbsp; =&nbsp; error_404.php</li>
 104 <li>error.php&nbsp;&nbsp; =&nbsp; error_general.php</li>
 105 <li>error_db.php&nbsp;&nbsp; (new)</li>
 106 <li>error_php.php&nbsp;&nbsp; (new)</li>
 107 </ul>
 108
 109
 110 <h2>Step 3: Update your index.php file</h2>
 111
 112 <p>Please open your main <dfn>index.php</dfn> file (located at your root).  At the very bottom of the file, change this:</p>
 113
 114 <code>require_once BASEPATH.'libraries/Front_controller'.EXT;</code>
 115
 116 <p>To this:</p>
 117
 118 <code>require_once BASEPATH.'codeigniter/CodeIgniter'.EXT;</code>
 119
 120
 121 <h2>Step 4: Update your config.php file</h2>
 122
 123 <p>Open your <dfn>application/config/config.php</dfn> file and add these new items:</p>
 124
 125 <pre>
 126 /*
 127 |------------------------------------------------
 128 | URL suffix
 129 |------------------------------------------------
 130 |
 131 | This option allows you to add a suffix to all URLs.
 132 | For example, if a URL is this:
 133 |
 134 | example.com/index.php/products/view/shoes
 135 |
 136 | You can optionally add a suffix, like ".html",
 137 | making the page appear to be of a certain type:
 138 |
 139 | example.com/index.php/products/view/shoes.html
 140 |
 141 */
 142 $config['url_suffix'] = "";
 143
 144
 145 /*
 146 |------------------------------------------------
 147 | Enable Query Strings
 148 |------------------------------------------------
 149 |
 150 | By default CodeIgniter uses search-engine and
 151 | human-friendly segment based URLs:
 152 |
 153 | example.com/who/what/where/
 154 |
 155 | You can optionally enable standard query string
 156 | based URLs:
 157 |
 158 | example.com?who=me&what=something&where=here
 159 |
 160 | Options are: TRUE or FALSE (boolean)
 161 |
 162 | The two other items let you set the query string "words"
 163 | that will invoke your controllers and functions:
 164 | example.com/index.php?c=controller&m=function
 165 |
 166 */
 167 $config['enable_query_strings'] = FALSE;
 168 $config['controller_trigger'] = 'c';
 169 $config['function_trigger'] = 'm';
 170 </pre>
 171
 172
 173 <h2>Step 5: Update your database.php file</h2>
 174
 175 <p>Open your <dfn>application/config/database.php</dfn> file and add these new items:</p>
 176
 177 <pre>
 178 $db['default']['dbprefix'] = "";
 179 $db['default']['active_r'] = TRUE;
 180 </pre>
 181
 182
 183 <h2>Step 6: Update your user guide</h2>
 184
 185 <p>Please also replace your local copy of the user guide with the new version.</p>
 186
 187 </div>
 188 <!-- END CONTENT -->
 189
 190
 191 <div id="footer">
 192 <p>
 193 Previous Topic:&nbsp;&nbsp;<a href="index.html">Installation Instructions</a>
 194 &nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
 195 <a href="#top">Top of Page</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
 196 <a href="../index.html">User Guide Home</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
 197 Next Topic:&nbsp;&nbsp;<a href="troubleshooting.html">Troubleshooting</a>
 198 </p>
 199 <p><a href="http://codeigniter.com">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">EllisLab, Inc.</a></p>
 200 </div>
 201
 202 </body>
 203 </html>