diff options
Diffstat (limited to 'user_guide/installation/upgrade_300.html')
| -rw-r--r-- | user_guide/installation/upgrade_300.html | 1330 |
1 files changed, 0 insertions, 1330 deletions
diff --git a/user_guide/installation/upgrade_300.html b/user_guide/installation/upgrade_300.html deleted file mode 100644 index 6dd95dc9f..000000000 --- a/user_guide/installation/upgrade_300.html +++ /dev/null @@ -1,1330 +0,0 @@ - - -<!DOCTYPE html> -<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> -<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> -<head> - <meta charset="utf-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - - <title>Upgrading from 2.2.x to 3.0.x — CodeIgniter 3.1.10 documentation</title> - - - - - <link rel="shortcut icon" href="../_static/ci-icon.ico"/> - - - - <link href='https://fonts.googleapis.com/css?family=Lato:400,700,400italic,700italic|Roboto+Slab:400,700|Inconsolata:400,700&subset=latin,cyrillic' rel='stylesheet' type='text/css'> - - - - - - - - - - <link rel="stylesheet" href="../_static/css/citheme.css" type="text/css" /> - - - - <link rel="index" title="Index" - href="../genindex.html"/> - <link rel="search" title="Search" href="../search.html"/> - <link rel="top" title="CodeIgniter 3.1.10 documentation" href="../index.html"/> - <link rel="up" title="Upgrading From a Previous Version" href="upgrading.html"/> - <link rel="next" title="Upgrading from 2.2.2 to 2.2.3" href="upgrade_223.html"/> - <link rel="prev" title="Upgrading from 3.0.0 to 3.0.1" href="upgrade_301.html"/> - - - <script src="https://cdnjs.cloudflare.com/ajax/libs/modernizr/2.6.2/modernizr.min.js"></script> - -</head> - -<body class="wy-body-for-nav" role="document"> - - <div id="nav"> - <div id="nav_inner"> - - - - <div id="pulldown-menu" class="ciNav"> - <ul> -<li class="toctree-l1"><a class="reference internal" href="../general/welcome.html">Welcome to CodeIgniter</a></li> -</ul> -<ul class="current"> -<li class="toctree-l1 current"><a class="reference internal" href="index.html">Installation Instructions</a><ul class="current"> -<li class="toctree-l2"><a class="reference internal" href="downloads.html">Downloading CodeIgniter</a></li> -<li class="toctree-l2"><a class="reference internal" href="index.html">Installation Instructions</a></li> -<li class="toctree-l2 current"><a class="reference internal" href="upgrading.html">Upgrading From a Previous Version</a></li> -<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../overview/index.html">CodeIgniter Overview</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../overview/getting_started.html">Getting Started</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/at_a_glance.html">CodeIgniter at a Glance</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/features.html">Supported Features</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/appflow.html">Application Flow Chart</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/mvc.html">Model-View-Controller</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/goals.html">Architectural Goals</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../tutorial/index.html">Tutorial</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/static_pages.html">Static pages</a></li> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/news_section.html">News section</a></li> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/create_news_items.html">Create news items</a></li> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/conclusion.html">Conclusion</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../contributing/index.html">Contributing to CodeIgniter</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../documentation/index.html">Writing CodeIgniter Documentation</a></li> -<li class="toctree-l2"><a class="reference internal" href="../DCO.html">Developer’s Certificate of Origin 1.1</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../general/index.html">General Topics</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../general/urls.html">CodeIgniter URLs</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/controllers.html">Controllers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/reserved_names.html">Reserved Names</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/views.html">Views</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/models.html">Models</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/helpers.html">Helpers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/libraries.html">Using CodeIgniter Libraries</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/creating_libraries.html">Creating Libraries</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/drivers.html">Using CodeIgniter Drivers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/creating_drivers.html">Creating Drivers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/core_classes.html">Creating Core System Classes</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/ancillary_classes.html">Creating Ancillary Classes</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/hooks.html">Hooks - Extending the Framework Core</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/autoloader.html">Auto-loading Resources</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/common_functions.html">Common Functions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/compatibility_functions.html">Compatibility Functions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/routing.html">URI Routing</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/errors.html">Error Handling</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/caching.html">Caching</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/profiling.html">Profiling Your Application</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/cli.html">Running via the CLI</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/managing_apps.html">Managing your Applications</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/environments.html">Handling Multiple Environments</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/alternative_php.html">Alternate PHP Syntax for View Files</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/security.html">Security</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/styleguide.html">PHP Style Guide</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../libraries/index.html">Libraries</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../libraries/benchmark.html">Benchmarking Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/caching.html">Caching Driver</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/calendar.html">Calendaring Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/cart.html">Shopping Cart Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/config.html">Config Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/email.html">Email Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/encrypt.html">Encrypt Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/encryption.html">Encryption Library</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/file_uploading.html">File Uploading Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/form_validation.html">Form Validation</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/ftp.html">FTP Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/image_lib.html">Image Manipulation Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/input.html">Input Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/javascript.html">Javascript Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/language.html">Language Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/loader.html">Loader Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/migration.html">Migrations Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/output.html">Output Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/pagination.html">Pagination Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/parser.html">Template Parser Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/security.html">Security Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/sessions.html">Session Library</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/table.html">HTML Table Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/trackback.html">Trackback Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/typography.html">Typography Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/unit_testing.html">Unit Testing Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/uri.html">URI Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/user_agent.html">User Agent Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/xmlrpc.html">XML-RPC and XML-RPC Server Classes</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/zip.html">Zip Encoding Class</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../database/index.html">Database Reference</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../database/examples.html">Quick Start: Usage Examples</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/configuration.html">Database Configuration</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/connecting.html">Connecting to a Database</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/queries.html">Running Queries</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/results.html">Generating Query Results</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/helpers.html">Query Helper Functions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/query_builder.html">Query Builder Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/transactions.html">Transactions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/metadata.html">Getting MetaData</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/call_function.html">Custom Function Calls</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/caching.html">Query Caching</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/forge.html">Database Manipulation with Database Forge</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/utilities.html">Database Utilities Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/db_driver_reference.html">Database Driver Reference</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../helpers/index.html">Helpers</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../helpers/array_helper.html">Array Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/captcha_helper.html">CAPTCHA Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/cookie_helper.html">Cookie Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/date_helper.html">Date Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/directory_helper.html">Directory Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/download_helper.html">Download Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/email_helper.html">Email Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/file_helper.html">File Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/form_helper.html">Form Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/html_helper.html">HTML Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/inflector_helper.html">Inflector Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/language_helper.html">Language Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/number_helper.html">Number Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/path_helper.html">Path Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/security_helper.html">Security Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/smiley_helper.html">Smiley Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/string_helper.html">String Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/text_helper.html">Text Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/typography_helper.html">Typography Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/url_helper.html">URL Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/xml_helper.html">XML Helper</a></li> -</ul> -</li> -</ul> - - </div> - - - </div> -</div> -<div id="nav2"> - <a href="#" id="openToc"> - <img src="data:image/jpeg;base64,/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3kAAQAEAAAARgAA/+4ADkFkb2JlAGTAAAAAAf/bAIQABAMDAwMDBAMDBAYEAwQGBwUEBAUHCAYGBwYGCAoICQkJCQgKCgwMDAwMCgwMDQ0MDBERERERFBQUFBQUFBQUFAEEBQUIBwgPCgoPFA4ODhQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgAKwCaAwERAAIRAQMRAf/EAHsAAQAABwEBAAAAAAAAAAAAAAABAwQFBgcIAgkBAQAAAAAAAAAAAAAAAAAAAAAQAAEDAwICBwYEAgsAAAAAAAIBAwQAEQUSBiEHkROTVNQWGDFBUVIUCHEiMtOUFWGBobHRQlMkZIRVEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwDSC+ygkOOaUoKigUCgUCgUCgUCgUCgUCgUCgkuGguIP9FBMFb0Hqg7We+3jlmIqqYFf4ub+/QYlnOR/LqIBKGFUbf8qWv971BytQXXE7Y3Lnm3HsFhp2TaZJAdchRXpIgSpdEJWxJEW3xoKV7F5OMy7JkQn2o7D6w33XGjEAkoiqrJEqIiOIiKuhePCgqp22dyYyS3CyWHnQ5joG61HkRnmnTbaFSMhExRVQRRVJU9iUHjE7ez+fJ0MFipmUNhBV8YUd2SoIV9KkjQla9ltegttBdPLW4/qocL+UTfrMiHW4+P9M71shuyrqaHTcxsl7jegpsji8nh5ZwMvDfgTm0RTjSmjYdFCS6KoOIipdFunCgmNYTMv457MMY6U7iI6oMieDDhRm1VbIhuoOkbqtuK0Hpzb+eZcYZexUxt6UyUqK2cd0SdjtgrhOgijcgERUlJOCIl6CpgbP3blRI8XgMjNARAyKNDfeRBdFDBVUAXgQrqH4pxoJTu2NysY97LP4ac1io5q1InHFeGO24LnVKJuKOkSQ/yKir+rh7aCLG1dzypZQI2FnvTgccYOM3FeN0XWERXAUEFVQgQkUktdLpegm+Td3/Xli/L+S/mYNJIOF9G/wBeLKrZHFb0akG6W1WtQWSg3Dyg5e7V3fipE3O4/wCrktyzYA+ufas2LbZIlmnAT2kvuoN1wft95augilglX/tzP3qCu9O3LL/wV/i5v79BvmTADq14UGu91467Z6U9y0HzH/ncj/U/sT/CgynZG7I2NezpZGUjIycJkYkZSG+uQ81pbBNKLxJfjwoMqZ3/ALYHl35AJ7/cuwHcu5k7r1Q5pHetBjquqVVJWGxj9Zrtcl/Ggy3dHMvauR3HFZj5nHNxSyW5JISYDMoIwx8tFIGHZhPNaykGapr6rUAiicEoMG21lMRj8buPAz8xhJrr7uOeiPTCyAwXUaGR1mgozbTusOsFLEiJ7fbQa/h7gcjy2H3V6xppwDNtUSxCJIqp7valBuWVzJ22xuCROXNNZiJkMtms0DbjUkAZjzoDrTMd9dDRI44ZC2YsrYdKWP2WDT2S3N9dNdlRYrGMYc06IURXSYb0igrpWS485xVNS6nF4rwslkoMwnbpgZLB7bmt5uMweAhDEl4B5uSLzzqTnnyVpW2jaJHRMSIjdDiiotvy3DOE5rYTEbkl5yFn28k7JyG4c7AU2HtLH1uKfaiMPI40CdYbpNtmLdwTSn5rewLNld+7TLdeal4WarWBkbVKBjgdElMJJwAAY5fl4kB3b1fp4XvagsGS3FjJfLzDNtS8aeXx7LzT7TyzByQE5PccRGRC0ZRUDRV6y62vbjagzLmJzS2vuPK43JY6aP1TW6Jz+RIWyFtyC06y3EkiiinAo7YCqfq1AqqnGgsOH3lhZO8d1pmcpB8j5XIm9OYlBJSQ/FSS4427DKO0RC8AlcEMhFdViRR1WDWR5t3WXVuL1d106kG9vdeye2g60+1FDyW0shIcXVpyroXt8I8dfd+NB1vioAdWnD3UF1+gD4UFc6CEKpagxXN43rwJLUHz7yX2c8zokt9uHlsPIhA4aRnnHJTLptIS6CNsY7iASpxUUMkReGpfbQW0vtN5pitvrsN28rwtBD0nc0+/Yft5XhaB6TuaXfsP28rwtA9J3NPv2H7eV4Wgek7mn37D9vK8LQPSdzT79h+3leFoHpO5pd+w/byvC0D0nc0u/Yft5XhaB6TuaXfsP28rwtA9J3NLv2H7eV4Wgek7ml37D9vK8LQPSdzS79h+3leFoHpO5p9+w/byvC0E9r7Reazy2HIYVPxkS/CUHVn26cosxyv2g7h89LYmZSXOenvLEQ1YaQ222RATcQCP8rSGqqA8S02W2pQ6FhMoAIlqCtsnwoCpdKClejI4i3Sgtb+GBxVuNBSFt1pV/RQefLjPyUDy4z8lA8uM/JQPLjPyUDy4z8lA8uM/JQPLjPyUDy4z8lA8uM/JQPLjPyUDy4z8lA8utJ/koJ7WCbBU/LQXOPAFq1koK8B0pag90CggtBBf6qB0UDooHRQOigdFA6KB0UDooHRQOigdFA6KB0UDooI0EaBQf//Z" title="Toggle Table of Contents" alt="Toggle Table of Contents" /> - </a> -</div> - - <div class="wy-grid-for-nav"> - - - <nav data-toggle="wy-nav-shift" class="wy-nav-side"> - <div class="wy-side-nav-search"> - - <a href="../index.html" class="fa fa-home"> CodeIgniter</a> - - -<div role="search"> - <form id="rtd-search-form" class="wy-form" action="../search.html" method="get"> - <input type="text" name="q" placeholder="Search docs" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> -</div> - </div> - - <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> - - - - <ul> -<li class="toctree-l1"><a class="reference internal" href="../general/welcome.html">Welcome to CodeIgniter</a></li> -</ul> -<ul class="current"> -<li class="toctree-l1 current"><a class="reference internal" href="index.html">Installation Instructions</a><ul class="current"> -<li class="toctree-l2"><a class="reference internal" href="downloads.html">Downloading CodeIgniter</a></li> -<li class="toctree-l2"><a class="reference internal" href="index.html">Installation Instructions</a></li> -<li class="toctree-l2 current"><a class="reference internal" href="upgrading.html">Upgrading From a Previous Version</a></li> -<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../overview/index.html">CodeIgniter Overview</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../overview/getting_started.html">Getting Started</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/at_a_glance.html">CodeIgniter at a Glance</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/features.html">Supported Features</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/appflow.html">Application Flow Chart</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/mvc.html">Model-View-Controller</a></li> -<li class="toctree-l2"><a class="reference internal" href="../overview/goals.html">Architectural Goals</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../tutorial/index.html">Tutorial</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/static_pages.html">Static pages</a></li> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/news_section.html">News section</a></li> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/create_news_items.html">Create news items</a></li> -<li class="toctree-l2"><a class="reference internal" href="../tutorial/conclusion.html">Conclusion</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../contributing/index.html">Contributing to CodeIgniter</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../documentation/index.html">Writing CodeIgniter Documentation</a></li> -<li class="toctree-l2"><a class="reference internal" href="../DCO.html">Developer’s Certificate of Origin 1.1</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../general/index.html">General Topics</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../general/urls.html">CodeIgniter URLs</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/controllers.html">Controllers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/reserved_names.html">Reserved Names</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/views.html">Views</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/models.html">Models</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/helpers.html">Helpers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/libraries.html">Using CodeIgniter Libraries</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/creating_libraries.html">Creating Libraries</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/drivers.html">Using CodeIgniter Drivers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/creating_drivers.html">Creating Drivers</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/core_classes.html">Creating Core System Classes</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/ancillary_classes.html">Creating Ancillary Classes</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/hooks.html">Hooks - Extending the Framework Core</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/autoloader.html">Auto-loading Resources</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/common_functions.html">Common Functions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/compatibility_functions.html">Compatibility Functions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/routing.html">URI Routing</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/errors.html">Error Handling</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/caching.html">Caching</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/profiling.html">Profiling Your Application</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/cli.html">Running via the CLI</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/managing_apps.html">Managing your Applications</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/environments.html">Handling Multiple Environments</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/alternative_php.html">Alternate PHP Syntax for View Files</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/security.html">Security</a></li> -<li class="toctree-l2"><a class="reference internal" href="../general/styleguide.html">PHP Style Guide</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../libraries/index.html">Libraries</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../libraries/benchmark.html">Benchmarking Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/caching.html">Caching Driver</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/calendar.html">Calendaring Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/cart.html">Shopping Cart Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/config.html">Config Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/email.html">Email Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/encrypt.html">Encrypt Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/encryption.html">Encryption Library</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/file_uploading.html">File Uploading Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/form_validation.html">Form Validation</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/ftp.html">FTP Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/image_lib.html">Image Manipulation Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/input.html">Input Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/javascript.html">Javascript Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/language.html">Language Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/loader.html">Loader Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/migration.html">Migrations Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/output.html">Output Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/pagination.html">Pagination Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/parser.html">Template Parser Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/security.html">Security Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/sessions.html">Session Library</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/table.html">HTML Table Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/trackback.html">Trackback Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/typography.html">Typography Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/unit_testing.html">Unit Testing Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/uri.html">URI Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/user_agent.html">User Agent Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/xmlrpc.html">XML-RPC and XML-RPC Server Classes</a></li> -<li class="toctree-l2"><a class="reference internal" href="../libraries/zip.html">Zip Encoding Class</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../database/index.html">Database Reference</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../database/examples.html">Quick Start: Usage Examples</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/configuration.html">Database Configuration</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/connecting.html">Connecting to a Database</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/queries.html">Running Queries</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/results.html">Generating Query Results</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/helpers.html">Query Helper Functions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/query_builder.html">Query Builder Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/transactions.html">Transactions</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/metadata.html">Getting MetaData</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/call_function.html">Custom Function Calls</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/caching.html">Query Caching</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/forge.html">Database Manipulation with Database Forge</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/utilities.html">Database Utilities Class</a></li> -<li class="toctree-l2"><a class="reference internal" href="../database/db_driver_reference.html">Database Driver Reference</a></li> -</ul> -</li> -</ul> -<ul> -<li class="toctree-l1"><a class="reference internal" href="../helpers/index.html">Helpers</a><ul> -<li class="toctree-l2"><a class="reference internal" href="../helpers/array_helper.html">Array Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/captcha_helper.html">CAPTCHA Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/cookie_helper.html">Cookie Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/date_helper.html">Date Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/directory_helper.html">Directory Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/download_helper.html">Download Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/email_helper.html">Email Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/file_helper.html">File Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/form_helper.html">Form Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/html_helper.html">HTML Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/inflector_helper.html">Inflector Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/language_helper.html">Language Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/number_helper.html">Number Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/path_helper.html">Path Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/security_helper.html">Security Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/smiley_helper.html">Smiley Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/string_helper.html">String Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/text_helper.html">Text Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/typography_helper.html">Typography Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/url_helper.html">URL Helper</a></li> -<li class="toctree-l2"><a class="reference internal" href="../helpers/xml_helper.html">XML Helper</a></li> -</ul> -</li> -</ul> - - - - </div> - - </nav> - - <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> - - - <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> - <i data-toggle="wy-nav-top" class="fa fa-bars"></i> - <a href="../index.html">CodeIgniter</a> - </nav> - - - - <div class="wy-nav-content"> - <div class="rst-content"> - <div role="navigation" aria-label="breadcrumbs navigation"> - <ul class="wy-breadcrumbs"> - <li><a href="../index.html">Docs</a> »</li> - - <li><a href="index.html">Installation Instructions</a> »</li> - - <li><a href="upgrading.html">Upgrading From a Previous Version</a> »</li> - - <li>Upgrading from 2.2.x to 3.0.x</li> - <li class="wy-breadcrumbs-aside"> - - </li> - <div style="float:right;margin-left:5px;" id="closeMe"> - <img title="Classic Layout" alt="classic layout" src="data:image/gif;base64,R0lGODlhFAAUAJEAAAAAADMzM////wAAACH5BAUUAAIALAAAAAAUABQAAAImlI+py+0PU5gRBRDM3DxbWoXis42X13USOLauUIqnlsaH/eY6UwAAOw==" /> - </div> - </ul> - <hr/> -</div> - <div role="main" class="document"> - - <div class="section" id="upgrading-from-2-2-x-to-3-0-x"> -<h1>Upgrading from 2.2.x to 3.0.x<a class="headerlink" href="#upgrading-from-2-2-x-to-3-0-x" title="Permalink to this headline">¶</a></h1> -<p>Before performing an update you should take your site offline by replacing the index.php file with a static one.</p> -<div class="section" id="step-1-update-your-codeigniter-files"> -<h2>Step 1: Update your CodeIgniter files<a class="headerlink" href="#step-1-update-your-codeigniter-files" title="Permalink to this headline">¶</a></h2> -<p><strong>Replace</strong> all files and directories in your <em>system/</em> directory and -replace your index.php file. If any modifications were made to your -index.php they will need to be made fresh in this new one.</p> -<div class="admonition important"> -<p class="first admonition-title">Important</p> -<p class="last">You have to delete the old <em>system/</em> directory first and -then put the new one in its place. A simple copy-paste may cause -issues.</p> -</div> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">If you have any custom developed files in these folders please -make copies of them first.</p> -</div> -</div> -<div class="section" id="step-2-update-your-classes-file-names"> -<h2>Step 2: Update your classes file names<a class="headerlink" href="#step-2-update-your-classes-file-names" title="Permalink to this headline">¶</a></h2> -<p>Starting with CodeIgniter 3.0, all class filenames (libraries, drivers, controllers -and models) must be named in a Ucfirst-like manner or in other words - they must -start with a capital letter.</p> -<p>For example, if you have the following library file:</p> -<blockquote> -<div>application/libraries/mylibrary.php</div></blockquote> -<p>… then you’ll have to rename it to:</p> -<blockquote> -<div>application/libraries/Mylibrary.php</div></blockquote> -<p>The same goes for driver libraries and extensions and/or overrides of CodeIgniter’s -own libraries and core classes.</p> -<blockquote> -<div>application/libraries/MY_email.php -application/core/MY_log.php</div></blockquote> -<p>The above files should respectively be renamed to the following:</p> -<blockquote> -<div>application/libraries/MY_Email.php -application/core/MY_Log.php</div></blockquote> -<p>Controllers:</p> -<blockquote> -<div>application/controllers/welcome.php -> application/controllers/Welcome.php</div></blockquote> -<p>Models:</p> -<blockquote> -<div>application/models/misc_model.php -> application/models/Misc_model.php</div></blockquote> -<p>Please note that this DOES NOT affect directories, configuration files, views, -helpers, hooks and anything else - it is only applied to classes.</p> -<p>You must now follow just one simple rule - class names in Ucfirst and everything else -in lowercase.</p> -</div> -<div class="section" id="step-3-replace-config-mimes-php"> -<h2>Step 3: Replace config/mimes.php<a class="headerlink" href="#step-3-replace-config-mimes-php" title="Permalink to this headline">¶</a></h2> -<p>This config file has been updated to contain more user mime-types, please copy -it to <em>application/config/mimes.php</em>.</p> -</div> -<div class="section" id="step-4-remove-autoload-core-from-your-config-autoload-php"> -<h2>Step 4: Remove $autoload[‘core’] from your config/autoload.php<a class="headerlink" href="#step-4-remove-autoload-core-from-your-config-autoload-php" title="Permalink to this headline">¶</a></h2> -<p>Use of the <code class="docutils literal"><span class="pre">$autoload['core']</span></code> config array has been deprecated as of CodeIgniter 1.4.1 and is now removed. -Move any entries that you might have listed there to <code class="docutils literal"><span class="pre">$autoload['libraries']</span></code> instead.</p> -</div> -<div class="section" id="step-5-move-your-log-class-overrides-or-extensions"> -<h2>Step 5: Move your Log class overrides or extensions<a class="headerlink" href="#step-5-move-your-log-class-overrides-or-extensions" title="Permalink to this headline">¶</a></h2> -<p>The Log Class is considered as a “core” class and is now located in the -<strong>system/core/</strong> directory. Therefore, in order for your Log class overrides -or extensions to work, you need to move them to <strong>application/core/</strong>:</p> -<blockquote> -<div>application/libraries/Log.php -> application/core/Log.php -application/libraries/MY_Log.php -> application/core/MY_Log.php</div></blockquote> -</div> -<div class="section" id="step-6-update-your-session-library-usage"> -<h2>Step 6: Update your Session library usage<a class="headerlink" href="#step-6-update-your-session-library-usage" title="Permalink to this headline">¶</a></h2> -<p>The <a class="reference internal" href="../libraries/sessions.html"><span class="doc">Session Library</span></a> has been completely -re-written in CodeIgniter 3 and now comes with a bunch of new features, -but that also means that there are changes that you should make …</p> -<p>Most notably, the library now uses separate storage drivers instead of -always relying on (encrypted) cookies. -In fact, cookies as storage have now been removed and you must always use -some kind of server-side storage engine, with the file-system being the -default option.</p> -<p>The Session Class now utilizes PHP’s own mechanisms for building custom -session handlers, which also means that your session data is now -accessible via the <code class="docutils literal"><span class="pre">$_SESSION</span></code> superglobal (though, we’ve kept the -possibility to use it as “userdata”, like you’ve done until now).</p> -<p>A few configuration options have been removed and a few have been added. -You should really read the whole <a class="reference internal" href="../libraries/sessions.html"><span class="doc">Session library manual</span></a> for the details, but here’s a short list of changes -that you should make:</p> -<blockquote> -<div><ul> -<li><p class="first">Set your <code class="docutils literal"><span class="pre">$config['sess_driver']</span></code> value</p> -<p>It will default to ‘files’, unless you’ve previously used -<code class="docutils literal"><span class="pre">$config['sess_use_database']</span></code>, in which case it will be set to -‘database’.</p> -</li> -<li><p class="first">Set a <code class="docutils literal"><span class="pre">$config['sess_save_path']</span></code> value</p> -<p>For the ‘database’ driver, a fallback to <code class="docutils literal"><span class="pre">$config['sess_table_name']</span></code> -is in place, but otherwise requires you to read the manual for the -specific driver of your choice.</p> -</li> -<li><p class="first">Update your <code class="docutils literal"><span class="pre">ci_sessions</span></code> table (‘database’ driver only)</p> -<p>The table structure has changed a bit, and more specifically:</p> -<blockquote> -<div><ul class="simple"> -<li><code class="docutils literal"><span class="pre">session_id</span></code> field is renamed to <code class="docutils literal"><span class="pre">id</span></code></li> -<li><code class="docutils literal"><span class="pre">user_agent</span></code> field is dropped</li> -<li><code class="docutils literal"><span class="pre">user_data</span></code> field is renamed to <code class="docutils literal"><span class="pre">data</span></code> and under MySQL is now of type BLOB</li> -<li><code class="docutils literal"><span class="pre">last_activity</span></code> field is renamed to <code class="docutils literal"><span class="pre">timestamp</span></code></li> -</ul> -</div></blockquote> -<p>This is accompanied by a slight change in the table indexes too, so -please read the manual about the <a class="reference external" href="../libraries/sessions.html#database-driver">Session Database Driver</a> for more information.</p> -<div class="admonition important"> -<p class="first admonition-title">Important</p> -<p class="last">Only MySQL and PostgreSQL are officially supported -now. Other databases may still work, but due to lack of advisory -locking features, they are unsafe for concurrent requests and -you should consider using another driver instead.</p> -</div> -</li> -<li><p class="first">Remove <code class="docutils literal"><span class="pre">$config['sess_match_useragent']</span></code></p> -<p>The user-agent string is input supplied by the user’s browser, or in -other words: client side input. As such, it is an ineffective feature -and hence why it has been removed.</p> -</li> -<li><p class="first">Remove <code class="docutils literal"><span class="pre">$config['sess_encrypt_cookie']</span></code></p> -<p>As already noted, the library no longer uses cookies as a storage -mechanism, which renders this option useless.</p> -</li> -<li><p class="first">Remove <code class="docutils literal"><span class="pre">$config['sess_expire_on_close']</span></code></p> -<p>This option is still usable, but only for backwards compatibility -purposes and it should be otherwise removed. The same effect is -achieved by setting <code class="docutils literal"><span class="pre">$config['sess_expiration']</span></code> to 0.</p> -</li> -<li><p class="first">Check “flashdata” for collisions with “userdata”</p> -<p>Flashdata is now just regular “userdata”, only marked for deletion on -the next request. In other words: you can’t have both “userdata” and -“flashdata” with the same name, because it’s the same thing.</p> -</li> -<li><p class="first">Check usage of session metadata</p> -<p>Previously, you could access the ‘session_id’, ‘ip_address’, -‘user_agent’ and ‘last_activity’ metadata items as userdata. -This is no longer possible, and you should read the notes about -<a class="reference external" href="../libraries/sessions.html#accessing-session-metadata">Session Metadata</a> -if your application relies on those values.</p> -</li> -<li><p class="first">Check <code class="docutils literal"><span class="pre">unset_userdata()</span></code> usage</p> -<p>Previously, this method used to accept an associative array of -<code class="docutils literal"><span class="pre">'key'</span> <span class="pre">=></span> <span class="pre">'dummy</span> <span class="pre">value'</span></code> pairs for unsetting multiple keys. That -however makes no sense and you now have to pass <em>only</em> the keys, as -the elements of an array.</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Old</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">session</span><span class="o">-></span><span class="na">unset_userdata</span><span class="p">(</span><span class="k">array</span><span class="p">(</span><span class="s1">'item'</span> <span class="o">=></span> <span class="s1">''</span><span class="p">,</span> <span class="s1">'item2'</span> <span class="o">=></span> <span class="s1">''</span><span class="p">));</span> - -<span class="c1">// New</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">session</span><span class="o">-></span><span class="na">unset_userdata</span><span class="p">(</span><span class="k">array</span><span class="p">(</span><span class="s1">'item'</span><span class="p">,</span> <span class="s1">'item2'</span><span class="p">));</span> -</pre></div> -</div> -</li> -</ul> -</div></blockquote> -<p>Finally, if you have written a Session extension, you must now move it to -the <em>application/libraries/Session/</em> directory, although chances are that -it will now also have to be re-factored.</p> -</div> -<div class="section" id="step-7-update-your-config-database-php"> -<h2>Step 7: Update your config/database.php<a class="headerlink" href="#step-7-update-your-config-database-php" title="Permalink to this headline">¶</a></h2> -<p>Due to 3.0.0’s renaming of Active Record to Query Builder, inside your -<strong>config/database.php</strong>, you will need to rename the <code class="docutils literal"><span class="pre">$active_record</span></code> -variable to <code class="docutils literal"><span class="pre">$query_builder</span></code>:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="nv">$active_group</span> <span class="o">=</span> <span class="s1">'default'</span><span class="p">;</span> -<span class="c1">// $active_record = TRUE;</span> -<span class="nv">$query_builder</span> <span class="o">=</span> <span class="k">TRUE</span><span class="p">;</span> -</pre></div> -</div> -</div> -<div class="section" id="step-8-replace-your-error-templates"> -<h2>Step 8: Replace your error templates<a class="headerlink" href="#step-8-replace-your-error-templates" title="Permalink to this headline">¶</a></h2> -<p>In CodeIgniter 3.0, the error templates are now considered as views and have been moved to the -<em>application/views/errors</em> directory.</p> -<p>Furthermore, we’ve added support for CLI error templates in plain-text format that unlike HTML, -is suitable for the command line. This of course requires another level of separation.</p> -<p>It is safe to move your old templates from <em>application/errors</em> to <em>application/views/errors/html</em>, -but you’ll have to copy the new <em>application/views/errors/cli</em> directory from the CodeIgniter archive.</p> -</div> -<div class="section" id="step-9-update-your-config-routes-php-file"> -<h2>Step 9: Update your config/routes.php file<a class="headerlink" href="#step-9-update-your-config-routes-php-file" title="Permalink to this headline">¶</a></h2> -<div class="section" id="routes-containing-any"> -<h3>Routes containing :any<a class="headerlink" href="#routes-containing-any" title="Permalink to this headline">¶</a></h3> -<p>Historically, CodeIgniter has always provided the <strong>:any</strong> wildcard in -routing, with the intention of providing a way to match any character -<strong>within</strong> an URI segment.</p> -<p>However, the <strong>:any</strong> wildcard is actually just an alias for a regular -expression and used to be executed in that manner as <strong>.+</strong>. This is -considered a bug, as it also matches the / (forward slash) character, which -is the URI segment delimiter and that was never the intention.</p> -<p>In CodeIgniter 3, the <strong>:any</strong> wildcard will now represent <strong>[^/]+</strong>, so -that it will not match a forward slash.</p> -<p>There are certainly many developers that have utilized this bug as an actual -feature. If you’re one of them and want to match a forward slash, please use -the <strong>.+</strong> regular expression:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="p">(</span><span class="o">.+</span><span class="p">)</span> <span class="c1">// matches ANYTHING</span> -<span class="p">(</span><span class="o">:</span><span class="nx">any</span><span class="p">)</span> <span class="c1">// matches any character, except for '/'</span> -</pre></div> -</div> -</div> -<div class="section" id="directories-and-default-controller-404-override"> -<h3>Directories and ‘default_controller’, ‘404_override’<a class="headerlink" href="#directories-and-default-controller-404-override" title="Permalink to this headline">¶</a></h3> -<p>As you should know, the <code class="docutils literal"><span class="pre">$route['default_controller']</span></code> and -<code class="docutils literal"><span class="pre">$route['404_override']</span></code> settings accept not only a controller name, but -also <em>controller/method</em> pairs. However, a bug in the routing logic has -made it possible for some users to use that as <em>directory/controller</em> -instead.</p> -<p>As already said, this behavior was incidental and was never intended, nor -documented. If you’ve relied on it, your application will break with -CodeIgniter 3.0.</p> -<p>Another notable change in version 3 is that ‘default_controller’ and -‘404_override’ are now applied <em>per directory</em>. To explain what this means, -let’s take the following example:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="nv">$route</span><span class="p">[</span><span class="s1">'default_controller'</span><span class="p">]</span> <span class="o">=</span> <span class="s1">'main'</span><span class="p">;</span> -</pre></div> -</div> -<p>Now, assuming that your website is located at <em>example.com</em>, you already -know that if a user visits <code class="docutils literal"><span class="pre">http://example.com/</span></code>, the above setting will -cause your ‘Main’ controller to be loaded.</p> -<p>However, what happens if you have an <em>application/controllers/admin/</em> -directory and the user visits <code class="docutils literal"><span class="pre">http://example.com/admin/</span></code>? -In CodeIgniter 3, the router will look for a ‘Main’ controller under the -admin/ directory as well. If not found, a Not Found (404) will be triggered.</p> -<p>The same rule applies to the ‘404_override’ setting.</p> -</div> -</div> -<div class="section" id="step-10-many-functions-now-return-null-instead-of-false-on-missing-items"> -<h2>Step 10: Many functions now return NULL instead of FALSE on missing items<a class="headerlink" href="#step-10-many-functions-now-return-null-instead-of-false-on-missing-items" title="Permalink to this headline">¶</a></h2> -<p>Many methods and functions now return NULL instead of FALSE when the required items don’t exist:</p> -<blockquote> -<div><ul class="simple"> -<li><a class="reference internal" href="../general/common_functions.html"><span class="doc">Common functions</span></a><ul> -<li>config_item()</li> -</ul> -</li> -<li><a class="reference internal" href="../libraries/config.html"><span class="doc">Config Class</span></a><ul> -<li>config->item()</li> -<li>config->slash_item()</li> -</ul> -</li> -<li><a class="reference internal" href="../libraries/input.html"><span class="doc">Input Class</span></a><ul> -<li>input->get()</li> -<li>input->post()</li> -<li>input->get_post()</li> -<li>input->cookie()</li> -<li>input->server()</li> -<li>input->input_stream()</li> -<li>input->get_request_header()</li> -</ul> -</li> -<li><a class="reference internal" href="../libraries/sessions.html"><span class="doc">Session Class</span></a><ul> -<li>session->userdata()</li> -<li>session->flashdata()</li> -</ul> -</li> -<li><a class="reference internal" href="../libraries/uri.html"><span class="doc">URI Class</span></a><ul> -<li>uri->segment()</li> -<li>uri->rsegment()</li> -</ul> -</li> -<li><a class="reference internal" href="../helpers/array_helper.html"><span class="doc">Array Helper</span></a><ul> -<li>element()</li> -<li>elements()</li> -</ul> -</li> -</ul> -</div></blockquote> -</div> -<div class="section" id="step-11-usage-of-xss-filtering"> -<h2>Step 11: Usage of XSS filtering<a class="headerlink" href="#step-11-usage-of-xss-filtering" title="Permalink to this headline">¶</a></h2> -<p>Many functions in CodeIgniter allow you to use its XSS filtering feature -on demand by passing a boolean parameter. The default value of that -parameter used to be boolean FALSE, but it is now changed to NULL and it -will be dynamically determined by your <code class="docutils literal"><span class="pre">$config['global_xss_filtering']</span></code> -value.</p> -<p>If you used to manually pass a boolean value for the <code class="docutils literal"><span class="pre">$xss_filter</span></code> -parameter or if you’ve always had <code class="docutils literal"><span class="pre">$config['global_xss_filtering']</span></code> set -to FALSE, then this change doesn’t concern you.</p> -<p>Otherwise however, please review your usage of the following functions:</p> -<blockquote> -<div><ul class="simple"> -<li><a class="reference internal" href="../libraries/input.html"><span class="doc">Input Library</span></a><ul> -<li>input->get()</li> -<li>input->post()</li> -<li>input->get_post()</li> -<li>input->cookie()</li> -<li>input->server()</li> -<li>input->input_stream()</li> -</ul> -</li> -<li><a class="reference internal" href="../helpers/cookie_helper.html"><span class="doc">Cookie Helper</span></a> <a class="reference internal" href="../helpers/cookie_helper.html#get_cookie" title="get_cookie"><code class="xref php php-func docutils literal"><span class="pre">get_cookie()</span></code></a></li> -</ul> -</div></blockquote> -<div class="admonition important"> -<p class="first admonition-title">Important</p> -<p class="last">Another related change is that the <code class="docutils literal"><span class="pre">$_GET</span></code>, <code class="docutils literal"><span class="pre">$_POST</span></code>, -<code class="docutils literal"><span class="pre">$_COOKIE</span></code> and <code class="docutils literal"><span class="pre">$_SERVER</span></code> superglobals are no longer -automatically overwritten when global XSS filtering is turned on.</p> -</div> -</div> -<div class="section" id="step-12-check-for-potential-xss-issues-with-uris"> -<h2>Step 12: Check for potential XSS issues with URIs<a class="headerlink" href="#step-12-check-for-potential-xss-issues-with-uris" title="Permalink to this headline">¶</a></h2> -<p>The <a class="reference internal" href="../libraries/uri.html"><span class="doc">URI Library</span></a> used to automatically convert -a certain set of “programmatic characters” to HTML entities when they -are encountered in a URI segment.</p> -<p>This was aimed at providing some automatic XSS protection, in addition -to the <code class="docutils literal"><span class="pre">$config['permitted_uri_chars']</span></code> setting, but has proven to be -problematic and is now removed in CodeIgniter 3.0.</p> -<p>If your application has relied on this feature, you should update it to -filter URI segments through <code class="docutils literal"><span class="pre">$this->security->xss_clean()</span></code> whenever you -output them.</p> -</div> -<div class="section" id="step-13-check-for-usage-of-the-xss-clean-form-validation-rule"> -<h2>Step 13: Check for usage of the ‘xss_clean’ Form validation rule<a class="headerlink" href="#step-13-check-for-usage-of-the-xss-clean-form-validation-rule" title="Permalink to this headline">¶</a></h2> -<p>A largely unknown rule about XSS cleaning is that it should <em>only be -applied to output</em>, as opposed to input data.</p> -<p>We’ve made that mistake ourselves with our automatic and global XSS cleaning -feature (see previous step about XSS above), so now in an effort to discourage that -practice, we’re also removing ‘xss_clean’ from the officially supported -list of <a class="reference internal" href="../libraries/form_validation.html"><span class="doc">form validation</span></a> rules.</p> -<p>Because the <a class="reference internal" href="../libraries/form_validation.html"><span class="doc">Form Validation library</span></a> -generally validates <em>input</em> data, the ‘xss_clean’ rule simply doesn’t -belong in it.</p> -<p>If you really, really need to apply that rule, you should now also load the -<a class="reference internal" href="../helpers/security_helper.html"><span class="doc">Security Helper</span></a>, which contains -<code class="docutils literal"><span class="pre">xss_clean()</span></code> as a regular function and therefore can be also used as -a validation rule.</p> -</div> -<div class="section" id="step-14-update-usage-of-input-class-s-get-post-method"> -<h2>Step 14: Update usage of Input Class’s get_post() method<a class="headerlink" href="#step-14-update-usage-of-input-class-s-get-post-method" title="Permalink to this headline">¶</a></h2> -<p>Previously, the <a class="reference internal" href="../libraries/input.html"><span class="doc">Input Class</span></a> method <code class="docutils literal"><span class="pre">get_post()</span></code> -was searching first in POST data, then in GET data. This method has been -modified so that it searches in GET then in POST, as its name suggests.</p> -<p>A method has been added, <code class="docutils literal"><span class="pre">post_get()</span></code>, which searches in POST then in GET, as -<code class="docutils literal"><span class="pre">get_post()</span></code> was doing before.</p> -</div> -<div class="section" id="step-15-update-usage-of-directory-helper-s-directory-map-function"> -<h2>Step 15: Update usage of Directory Helper’s directory_map() function<a class="headerlink" href="#step-15-update-usage-of-directory-helper-s-directory-map-function" title="Permalink to this headline">¶</a></h2> -<p>In the resulting array, directories now end with a trailing directory -separator (i.e. a slash, usually).</p> -</div> -<div class="section" id="step-16-update-usage-of-database-forge-s-drop-table-method"> -<h2>Step 16: Update usage of Database Forge’s drop_table() method<a class="headerlink" href="#step-16-update-usage-of-database-forge-s-drop-table-method" title="Permalink to this headline">¶</a></h2> -<p>Up until now, <code class="docutils literal"><span class="pre">drop_table()</span></code> added an IF EXISTS clause by default or it didn’t work -at all with some drivers. In CodeIgniter 3.0, the IF EXISTS condition is no longer added -by default and has an optional second parameter that allows that instead and is set to -FALSE by default.</p> -<p>If your application relies on IF EXISTS, you’ll have to change its usage.</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Now produces just DROP TABLE `table_name`</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">dbforge</span><span class="o">-></span><span class="na">drop_table</span><span class="p">(</span><span class="s1">'table_name'</span><span class="p">);</span> - -<span class="c1">// Produces DROP TABLE IF EXISTS `table_name`</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">dbforge</span><span class="o">-></span><span class="na">drop_table</span><span class="p">(</span><span class="s1">'table_name'</span><span class="p">,</span> <span class="k">TRUE</span><span class="p">);</span> -</pre></div> -</div> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The given example uses MySQL-specific syntax, but it should work across -all drivers with the exception of ODBC.</p> -</div> -</div> -<div class="section" id="step-17-change-usage-of-email-library-with-multiple-emails"> -<h2>Step 17: Change usage of Email library with multiple emails<a class="headerlink" href="#step-17-change-usage-of-email-library-with-multiple-emails" title="Permalink to this headline">¶</a></h2> -<p>The <a class="reference internal" href="../libraries/email.html"><span class="doc">Email Library</span></a> will automatically clear the -set parameters after successfully sending emails. To override this behaviour, -pass FALSE as the first parameter in the <code class="docutils literal"><span class="pre">send()</span></code> method:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="p">(</span><span class="nv">$this</span><span class="o">-></span><span class="na">email</span><span class="o">-></span><span class="na">send</span><span class="p">(</span><span class="k">FALSE</span><span class="p">))</span> -<span class="p">{</span> - <span class="c1">// Parameters won't be cleared</span> -<span class="p">}</span> -</pre></div> -</div> -</div> -<div class="section" id="step-18-update-your-form-validation-language-lines"> -<h2>Step 18: Update your Form_validation language lines<a class="headerlink" href="#step-18-update-your-form-validation-language-lines" title="Permalink to this headline">¶</a></h2> -<p>Two improvements have been made to the <a class="reference internal" href="../libraries/form_validation.html"><span class="doc">Form Validation Library</span></a>’s <a class="reference internal" href="../libraries/language.html"><span class="doc">language</span></a> -files and error messages format:</p> -<blockquote> -<div><ul> -<li><p class="first"><a class="reference internal" href="../libraries/language.html"><span class="doc">Language Library</span></a> line keys now must be -prefixed with <strong>form_validation_</strong> in order to avoid collisions:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Old</span> -<span class="nv">$lang</span><span class="p">[</span><span class="s1">'rule'</span><span class="p">]</span> <span class="o">=</span> <span class="o">...</span> - -<span class="c1">// New</span> -<span class="nv">$lang</span><span class="p">[</span><span class="s1">'form_validation_rule'</span><span class="p">]</span> <span class="o">=</span> <span class="o">...</span> -</pre></div> -</div> -</li> -<li><p class="first">The error messages format has been changed to use named parameters, to -allow more flexibility than what <cite>sprintf()</cite> offers:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Old</span> -<span class="s1">'The %s field does not match the %s field.'</span> - -<span class="c1">// New</span> -<span class="s1">'The {field} field does not match the {param} field.'</span> -</pre></div> -</div> -</li> -</ul> -</div></blockquote> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The old formatting still works, but the non-prefixed line keys -are DEPRECATED and scheduled for removal in CodeIgniter 3.1+. -Therefore you’re encouraged to update its usage sooner rather than -later.</p> -</div> -</div> -<div class="section" id="step-19-make-sure-your-base-url-config-value-is-not-empty"> -<h2>Step 19: Make sure your ‘base_url’ config value is not empty<a class="headerlink" href="#step-19-make-sure-your-base-url-config-value-is-not-empty" title="Permalink to this headline">¶</a></h2> -<p>When <code class="docutils literal"><span class="pre">$config['base_url']</span></code> is not set, CodeIgniter tries to automatically -detect what your website’s base URL is. This is done purely for convenience -when you are starting development of a new application.</p> -<p>Auto-detection is never reliable and also has security implications, which -is why you should <strong>always</strong> have it manually configured!</p> -<p>One of the changes in CodeIgniter 3.0.3 is how this auto-detection works, -and more specifically it now falls back to the server’s IP address instead -of the hostname requested by the client. Therefore, if you’ve ever relied -on auto-detection, it will change how your website works now.</p> -<p>In case you need to allow e.g. multiple domains, or both <a class="reference external" href="http://">http://</a> and -<a class="reference external" href="https://">https://</a> prefixes to be dynamically used depending on the request, -remember that <em>application/config/config.php</em> is still a PHP script, in -which you can create this logic with a few lines of code. For example:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="nv">$allowed_domains</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span><span class="s1">'domain1.tld'</span><span class="p">,</span> <span class="s1">'domain2.tld'</span><span class="p">);</span> -<span class="nv">$default_domain</span> <span class="o">=</span> <span class="s1">'domain1.tld'</span><span class="p">;</span> - -<span class="k">if</span> <span class="p">(</span><span class="nb">in_array</span><span class="p">(</span><span class="nv">$_SERVER</span><span class="p">[</span><span class="s1">'HTTP_HOST'</span><span class="p">],</span> <span class="nv">$allowed_domains</span><span class="p">,</span> <span class="k">TRUE</span><span class="p">))</span> -<span class="p">{</span> - <span class="nv">$domain</span> <span class="o">=</span> <span class="nv">$_SERVER</span><span class="p">[</span><span class="s1">'HTTP_HOST'</span><span class="p">];</span> -<span class="p">}</span> -<span class="k">else</span> -<span class="p">{</span> - <span class="nv">$domain</span> <span class="o">=</span> <span class="nv">$default_domain</span><span class="p">;</span> -<span class="p">}</span> - -<span class="k">if</span> <span class="p">(</span> <span class="o">!</span> <span class="k">empty</span><span class="p">(</span><span class="nv">$_SERVER</span><span class="p">[</span><span class="s1">'HTTPS'</span><span class="p">]))</span> -<span class="p">{</span> - <span class="nv">$config</span><span class="p">[</span><span class="s1">'base_url'</span><span class="p">]</span> <span class="o">=</span> <span class="s1">'https://'</span><span class="o">.</span><span class="nv">$domain</span><span class="p">;</span> -<span class="p">}</span> -<span class="k">else</span> -<span class="p">{</span> - <span class="nv">$config</span><span class="p">[</span><span class="s1">'base_url'</span><span class="p">]</span> <span class="o">=</span> <span class="s1">'http://'</span><span class="o">.</span><span class="nv">$domain</span><span class="p">;</span> -<span class="p">}</span> -</pre></div> -</div> -</div> -<div class="section" id="step-20-remove-usage-of-previously-deprecated-functionalities"> -<h2>Step 20: Remove usage of (previously) deprecated functionalities<a class="headerlink" href="#step-20-remove-usage-of-previously-deprecated-functionalities" title="Permalink to this headline">¶</a></h2> -<p>In addition to the <code class="docutils literal"><span class="pre">$autoload['core']</span></code> configuration setting, there’s a -number of other functionalities that have been removed in CodeIgniter 3.0.0:</p> -<div class="section" id="the-sha1-library"> -<h3>The SHA1 library<a class="headerlink" href="#the-sha1-library" title="Permalink to this headline">¶</a></h3> -<p>The previously deprecated SHA1 library has been removed, alter your code to use PHP’s native -<code class="docutils literal"><span class="pre">sha1()</span></code> function to generate a SHA1 hash.</p> -<p>Additionally, the <code class="docutils literal"><span class="pre">sha1()</span></code> method in the <a class="reference internal" href="../libraries/encrypt.html"><span class="doc">Encrypt Library</span></a> has been removed.</p> -</div> -<div class="section" id="the-ext-constant"> -<h3>The EXT constant<a class="headerlink" href="#the-ext-constant" title="Permalink to this headline">¶</a></h3> -<p>Usage of the <code class="docutils literal"><span class="pre">EXT</span></code> constant has been deprecated since dropping support for PHP 4. There’s no -longer a need to maintain different filename extensions and in this new CodeIgniter version, -the <code class="docutils literal"><span class="pre">EXT</span></code> constant has been removed. Use just ‘.php’ instead.</p> -</div> -<div class="section" id="smiley-helper"> -<h3>Smiley helper<a class="headerlink" href="#smiley-helper" title="Permalink to this headline">¶</a></h3> -<p>The <a class="reference internal" href="../helpers/smiley_helper.html"><span class="doc">Smiley Helper</span></a> is a legacy feature from EllisLab’s -ExpressionEngine product. However, it is too specific for a general purpose framework like -CodeIgniter and as such it is now deprecated.</p> -<p>Also, the previously deprecated <code class="docutils literal"><span class="pre">js_insert_smiley()</span></code> (since version 1.7.2) is now removed.</p> -</div> -<div class="section" id="the-encrypt-library"> -<h3>The Encrypt library<a class="headerlink" href="#the-encrypt-library" title="Permalink to this headline">¶</a></h3> -<p>Following numerous vulnerability reports, the <a class="reference internal" href="../libraries/encrypt.html"><span class="doc">Encrypt Library</span></a> has -been deprecated and a new, <a class="reference internal" href="../libraries/encryption.html"><span class="doc">Encryption Library</span></a> is added to take -its place.</p> -<p>The new library requires either the <a class="reference external" href="http://php.net/mcrypt">MCrypt extension</a> (and /dev/urandom -availability) or PHP 5.3.3 and the <a class="reference external" href="http://php.net/openssl">OpenSSL extension</a>. -While this might be rather inconvenient, it is a requirement that allows us to have properly -implemented cryptographic functions.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The <a class="reference internal" href="../libraries/encrypt.html"><span class="doc">Encrypt Library</span></a> is still available for the purpose -of keeping backwards compatibility.</p> -</div> -<div class="admonition important"> -<p class="first admonition-title">Important</p> -<p class="last">You are strongly encouraged to switch to the new <a class="reference internal" href="../libraries/encryption.html"><span class="doc">Encryption Library</span></a> as soon as possible!</p> -</div> -</div> -<div class="section" id="the-cart-library"> -<h3>The Cart library<a class="headerlink" href="#the-cart-library" title="Permalink to this headline">¶</a></h3> -<p>The <a class="reference internal" href="../libraries/cart.html"><span class="doc">Cart Library</span></a>, similarly to the <a class="reference internal" href="../helpers/smiley_helper.html"><span class="doc">Smiley Helper</span></a> is too specific for CodeIgniter. It is now deprecated -and scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The library is still available, but you’re strongly encouraged to remove its usage sooner -rather than later.</p> -</div> -</div> -<div class="section" id="database-drivers-mysql-sqlite-mssql-pdo-dblib"> -<h3>Database drivers ‘mysql’, ‘sqlite’, ‘mssql’, ‘pdo/dblib’<a class="headerlink" href="#database-drivers-mysql-sqlite-mssql-pdo-dblib" title="Permalink to this headline">¶</a></h3> -<p>The <strong>mysql</strong> driver utilizes the old ‘mysql’ PHP extension, known for its aging code base and -many low-level problems. The extension is deprecated as of PHP 5.5 and CodeIgniter deprecates -it in version 3.0, switching the default configured MySQL driver to <strong>mysqli</strong>.</p> -<p>Please use either the ‘mysqli’ or ‘pdo/mysql’ drivers for MySQL. The old ‘mysql’ driver will be -removed at some point in the future.</p> -<p>The <strong>sqlite</strong>, <strong>mssql</strong> and <strong>pdo/dblib</strong> (also known as pdo/mssql or pdo/sybase) drivers -all depend on PHP extensions that for different reasons no longer exist since PHP 5.3.</p> -<p>Therefore we are now deprecating these drivers as we will have to remove them in one of the next -CodeIgniter versions. You should use the more advanced, <strong>sqlite3</strong>, <strong>sqlsrv</strong> or <strong>pdo/sqlsrv</strong> -drivers respectively.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">These drivers are still available, but you’re strongly encouraged to switch to other ones -sooner rather than later.</p> -</div> -</div> -<div class="section" id="security-helper-do-hash"> -<h3>Security helper do_hash()<a class="headerlink" href="#security-helper-do-hash" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/security_helper.html"><span class="doc">Security Helper</span></a> function <code class="docutils literal"><span class="pre">do_hash()</span></code> is now just an alias for -PHP’s native <code class="docutils literal"><span class="pre">hash()</span></code> function. It is deprecated and scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This function is still available, but you’re strongly encouraged to remove its usage sooner -rather than later.</p> -</div> -</div> -<div class="section" id="the-config-global-xss-filtering-setting"> -<h3>The $config[‘global_xss_filtering’] setting<a class="headerlink" href="#the-config-global-xss-filtering-setting" title="Permalink to this headline">¶</a></h3> -<p>As already explained above, XSS filtering should not be done on input data, -but on output instead. Therefore, the <code class="docutils literal"><span class="pre">$config['global_xss_filtering']</span></code>, -which automatically filters <em>input</em> data, is considered a bad practice and -is now deprecated.</p> -<p>Instead, you should manually escape any user-provided data via the -<a class="reference internal" href="../helpers/security_helper.html#xss_clean" title="xss_clean"><code class="xref php php-func docutils literal"><span class="pre">xss_clean()</span></code></a> function when you need to output it, or use a -library like <a class="reference external" href="http://htmlpurifier.org/">HTML Purifier</a> that does that -for you.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The setting is still available, but you’re strongly encouraged to -remove its usage sooner rather than later.</p> -</div> -</div> -<div class="section" id="file-helper-read-file"> -<h3>File helper read_file()<a class="headerlink" href="#file-helper-read-file" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/file_helper.html"><span class="doc">File Helper</span></a> function <code class="docutils literal"><span class="pre">read_file()</span></code> is now just an alias for -PHP’s native <code class="docutils literal"><span class="pre">file_get_contents()</span></code> function. It is deprecated and scheduled for removal in -CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This function is still available, but you’re strongly encouraged to remove its usage sooner -rather than later.</p> -</div> -</div> -<div class="section" id="string-helper-repeater"> -<h3>String helper repeater()<a class="headerlink" href="#string-helper-repeater" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/string_helper.html"><span class="doc">String Helper</span></a> function <a class="reference internal" href="../helpers/string_helper.html#repeater" title="repeater"><code class="xref php php-func docutils literal"><span class="pre">repeater()</span></code></a> is now just an alias for -PHP’s native <code class="docutils literal"><span class="pre">str_repeat()</span></code> function. It is deprecated and scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This function is still available, but you’re strongly encouraged to remove its usage sooner -rather than later.</p> -</div> -</div> -<div class="section" id="string-helper-trim-slashes"> -<h3>String helper trim_slashes()<a class="headerlink" href="#string-helper-trim-slashes" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/string_helper.html"><span class="doc">String Helper</span></a> function <a class="reference internal" href="../helpers/string_helper.html#trim_slashes" title="trim_slashes"><code class="xref php php-func docutils literal"><span class="pre">trim_slashes()</span></code></a> is now just an alias -for PHP’s native <code class="docutils literal"><span class="pre">trim()</span></code> function (with a slash passed as its second argument). It is deprecated and -scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This function is still available, but you’re strongly encouraged to remove its usage sooner -rather than later.</p> -</div> -</div> -<div class="section" id="form-helper-form-prep"> -<h3>Form helper form_prep()<a class="headerlink" href="#form-helper-form-prep" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/form_helper.html"><span class="doc">Form Helper</span></a> function <a class="reference internal" href="../helpers/form_helper.html#form_prep" title="form_prep"><code class="xref php php-func docutils literal"><span class="pre">form_prep()</span></code></a> -is now just an alias for <a class="reference internal" href="../general/common_functions.html"><span class="doc">common function</span></a> -<code class="xref py py-func docutils literal"><span class="pre">html_escape()</span></code>. It is deprecated and will be removed in the future.</p> -<p>Please use <a class="reference internal" href="../general/common_functions.html#html_escape" title="html_escape"><code class="xref php php-func docutils literal"><span class="pre">html_escape()</span></code></a> instead.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This function is still available, but you’re strongly encouraged -to remove its usage sooner rather than later.</p> -</div> -</div> -<div class="section" id="email-helper-functions"> -<h3>Email helper functions<a class="headerlink" href="#email-helper-functions" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/email_helper.html"><span class="doc">Email Helper</span></a> only has two functions</p> -<blockquote> -<div><ul class="simple"> -<li><a class="reference internal" href="../helpers/email_helper.html#valid_email" title="valid_email"><code class="xref php php-func docutils literal"><span class="pre">valid_email()</span></code></a></li> -<li><a class="reference internal" href="../helpers/email_helper.html#send_email" title="send_email"><code class="xref php php-func docutils literal"><span class="pre">send_email()</span></code></a></li> -</ul> -</div></blockquote> -<p>Both of them are now aliases for PHP’s native <code class="docutils literal"><span class="pre">filter_var()</span></code> and <code class="docutils literal"><span class="pre">mail()</span></code> functions, respectively. -Therefore the <a class="reference internal" href="../helpers/email_helper.html"><span class="doc">Email Helper</span></a> altogether is being deprecated and -is scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">These functions are still available, but you’re strongly encouraged to remove their usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="date-helper-standard-date"> -<h3>Date helper standard_date()<a class="headerlink" href="#date-helper-standard-date" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/date_helper.html"><span class="doc">Date Helper</span></a> function <code class="docutils literal"><span class="pre">standard_date()</span></code> is being deprecated due -to the availability of native PHP <a class="reference external" href="http://php.net/manual/en/class.datetime.php#datetime.constants.types">constants</a>, -which when combined with <code class="docutils literal"><span class="pre">date()</span></code> provide the same functionality. Furthermore, they have the -exact same names as the ones supported by <code class="docutils literal"><span class="pre">standard_date()</span></code>. Here are examples of how to replace -its usage:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Old way</span> -<span class="nx">standard_date</span><span class="p">();</span> <span class="c1">// defaults to standard_date('DATE_RFC822', now());</span> - -<span class="c1">// Replacement</span> -<span class="nb">date</span><span class="p">(</span><span class="nx">DATE_RFC822</span><span class="p">,</span> <span class="nx">now</span><span class="p">());</span> - -<span class="c1">// Old way</span> -<span class="nx">standard_date</span><span class="p">(</span><span class="s1">'DATE_ATOM'</span><span class="p">,</span> <span class="nv">$time</span><span class="p">);</span> - -<span class="c1">// Replacement</span> -<span class="nb">date</span><span class="p">(</span><span class="nx">DATE_ATOM</span><span class="p">,</span> <span class="nv">$time</span><span class="p">);</span> -</pre></div> -</div> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This function is still available, but you’re strongly encouraged to remove its usage sooner -rather than later as it is scheduled for removal in CodeIgniter 3.1+.</p> -</div> -</div> -<div class="section" id="html-helpers-nbs-br"> -<h3>HTML helpers nbs(), br()<a class="headerlink" href="#html-helpers-nbs-br" title="Permalink to this headline">¶</a></h3> -<p><a class="reference internal" href="../helpers/html_helper.html"><span class="doc">HTML Helper</span></a> functions <code class="docutils literal"><span class="pre">nbs()</span></code> and <code class="docutils literal"><span class="pre">br()</span></code> are just aliases -for the native <code class="docutils literal"><span class="pre">str_repeat()</span></code> function used with <code class="docutils literal"><span class="pre">&nbsp;</span></code> and <code class="docutils literal"><span class="pre"><br</span> <span class="pre">></span></code> respectively.</p> -<p>Because there’s no point in just aliasing native PHP functions, they are now deprecated and -scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">These functions are still available, but you’re strongly encouraged to remove their usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="pagination-library-anchor-class-setting"> -<h3>Pagination library ‘anchor_class’ setting<a class="headerlink" href="#pagination-library-anchor-class-setting" title="Permalink to this headline">¶</a></h3> -<p>The <a class="reference internal" href="../libraries/pagination.html"><span class="doc">Pagination Library</span></a> now supports adding pretty much any HTML -attribute to your anchors via the ‘attributes’ configuration setting. This includes passing the -‘class’ attribute and using the separate ‘anchor_class’ setting no longer makes sense. -As a result of that, the ‘anchor_class’ setting is now deprecated and scheduled for removal in -CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This setting is still available, but you’re strongly encouraged to remove its usage sooner -rather than later.</p> -</div> -</div> -<div class="section" id="string-helper-random-string-types-unique-and-encrypt"> -<h3>String helper random_string() types ‘unique’ and ‘encrypt’<a class="headerlink" href="#string-helper-random-string-types-unique-and-encrypt" title="Permalink to this headline">¶</a></h3> -<p>When using the <a class="reference internal" href="../helpers/string_helper.html"><span class="doc">String Helper</span></a> function <a class="reference internal" href="../helpers/string_helper.html#random_string" title="random_string"><code class="xref php php-func docutils literal"><span class="pre">random_string()</span></code></a>, -you should no longer pass the <strong>unique</strong> and <strong>encrypt</strong> randomization types. They are only -aliases for <strong>md5</strong> and <strong>sha1</strong> respectively and are now deprecated and scheduled for removal -in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">These options are still available, but you’re strongly encouraged to remove their usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="url-helper-url-title-separators-dash-and-underscore"> -<h3>URL helper url_title() separators ‘dash’ and ‘underscore’<a class="headerlink" href="#url-helper-url-title-separators-dash-and-underscore" title="Permalink to this headline">¶</a></h3> -<p>When using the <a class="reference internal" href="../helpers/url_helper.html"><span class="doc">URL Helper</span></a> function <a class="reference internal" href="../helpers/url_helper.html#url_title" title="url_title"><code class="xref php php-func docutils literal"><span class="pre">url_title()</span></code></a>, you -should no longer pass <strong>dash</strong> or <strong>underscore</strong> as the word separator. This function will -now accept any character and you should just pass the chosen character directly, so you -should write ‘-‘ instead of ‘dash’ and ‘_’ instead of ‘underscore’.</p> -<p><strong>dash</strong> and <strong>underscore</strong> now act as aliases and are deprecated and scheduled for removal -in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">These options are still available, but you’re strongly encouraged to remove their usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="session-library-method-all-userdata"> -<h3>Session Library method all_userdata()<a class="headerlink" href="#session-library-method-all-userdata" title="Permalink to this headline">¶</a></h3> -<p>As seen in the <a class="reference internal" href="../changelog.html"><span class="doc">Change Log</span></a>, <a class="reference internal" href="../libraries/sessions.html"><span class="doc">Session Library</span></a> -method <code class="docutils literal"><span class="pre">userdata()</span></code> now allows you to fetch all userdata by simply omitting its parameter:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="nv">$this</span><span class="o">-></span><span class="na">session</span><span class="o">-></span><span class="na">userdata</span><span class="p">();</span> -</pre></div> -</div> -<p>This makes the <code class="docutils literal"><span class="pre">all_userdata()</span></code> method redudant and therefore it is now just an alias for -<code class="docutils literal"><span class="pre">userdata()</span></code> with the above shown usage and is being deprecated and scheduled for removal -in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This method is still available, but you’re strongly encouraged to remove its usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="database-forge-method-add-column-with-an-after-clause"> -<h3>Database Forge method add_column() with an AFTER clause<a class="headerlink" href="#database-forge-method-add-column-with-an-after-clause" title="Permalink to this headline">¶</a></h3> -<p>If you have used the <strong>third parameter</strong> for <a class="reference internal" href="../database/forge.html"><span class="doc">Database Forge</span></a> method -<code class="docutils literal"><span class="pre">add_column()</span></code> to add a field for an AFTER clause, then you should change its usage.</p> -<p>That third parameter has been deprecated and scheduled for removal in CodeIgniter 3.1+.</p> -<p>You should now put AFTER clause field names in the field definition array instead:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Old usage:</span> -<span class="nv">$field</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span> - <span class="s1">'new_field'</span> <span class="o">=></span> <span class="k">array</span><span class="p">(</span><span class="s1">'type'</span> <span class="o">=></span> <span class="s1">'TEXT'</span><span class="p">)</span> -<span class="p">);</span> - -<span class="nv">$this</span><span class="o">-></span><span class="na">dbforge</span><span class="o">-></span><span class="na">add_column</span><span class="p">(</span><span class="s1">'table_name'</span><span class="p">,</span> <span class="nv">$field</span><span class="p">,</span> <span class="s1">'another_field'</span><span class="p">);</span> - -<span class="c1">// New usage:</span> -<span class="nv">$field</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span> - <span class="s1">'new_field'</span> <span class="o">=></span> <span class="k">array</span><span class="p">(</span><span class="s1">'type'</span> <span class="o">=></span> <span class="s1">'TEXT'</span><span class="p">,</span> <span class="s1">'after'</span> <span class="o">=></span> <span class="s1">'another_field'</span><span class="p">)</span> -<span class="p">);</span> - -<span class="nv">$this</span><span class="o">-></span><span class="na">dbforge</span><span class="o">-></span><span class="na">add_column</span><span class="p">(</span><span class="s1">'table_name'</span><span class="p">,</span> <span class="nv">$field</span><span class="p">);</span> -</pre></div> -</div> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The parameter is still available, but you’re strongly encouraged to remove its usage -sooner rather than later.</p> -</div> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This is for MySQL and CUBRID databases only! Other drivers don’t support this -clause and will silently ignore it.</p> -</div> -</div> -<div class="section" id="uri-routing-methods-fetch-directory-fetch-class-fetch-method"> -<h3>URI Routing methods fetch_directory(), fetch_class(), fetch_method()<a class="headerlink" href="#uri-routing-methods-fetch-directory-fetch-class-fetch-method" title="Permalink to this headline">¶</a></h3> -<p>With properties <code class="docutils literal"><span class="pre">CI_Router::$directory</span></code>, <code class="docutils literal"><span class="pre">CI_Router::$class</span></code> and <code class="docutils literal"><span class="pre">CI_Router::$method</span></code> -being public and their respective <code class="docutils literal"><span class="pre">fetch_*()</span></code> no longer doing anything else to just return -the properties - it doesn’t make sense to keep them.</p> -<p>Those are all internal, undocumented methods, but we’ve opted to deprecate them for now -in order to maintain backwards-compatibility just in case. If some of you have utilized them, -then you can now just access the properties instead:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="nv">$this</span><span class="o">-></span><span class="na">router</span><span class="o">-></span><span class="na">directory</span><span class="p">;</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">router</span><span class="o">-></span><span class="na">class</span><span class="p">;</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">router</span><span class="o">-></span><span class="na">method</span><span class="p">;</span> -</pre></div> -</div> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">Those methods are still available, but you’re strongly encouraged to remove their usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="input-library-method-is-cli-request"> -<h3>Input library method is_cli_request()<a class="headerlink" href="#input-library-method-is-cli-request" title="Permalink to this headline">¶</a></h3> -<p>Calls to the <code class="docutils literal"><span class="pre">CI_Input::is_cli_request()</span></code> method are necessary at many places -in the CodeIgniter internals and this is often before the <a class="reference internal" href="../libraries/input.html"><span class="doc">Input Library</span></a> is loaded. Because of that, it is being replaced by a common -function named <a class="reference internal" href="../general/common_functions.html#is_cli" title="is_cli"><code class="xref php php-func docutils literal"><span class="pre">is_cli()</span></code></a> and this method is now just an alias.</p> -<p>The new function is both available at all times for you to use and shorter to type.</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="c1">// Old</span> -<span class="nv">$this</span><span class="o">-></span><span class="na">input</span><span class="o">-></span><span class="na">is_cli_request</span><span class="p">();</span> - -<span class="c1">// New</span> -<span class="nx">is_cli</span><span class="p">();</span> -</pre></div> -</div> -<p><code class="docutils literal"><span class="pre">CI_Input::is_cli_request()</span></code> is now now deprecated and scheduled for removal in -CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This method is still available, but you’re strongly encouraged to remove its usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="config-library-method-system-url"> -<h3>Config library method system_url()<a class="headerlink" href="#config-library-method-system-url" title="Permalink to this headline">¶</a></h3> -<p>Usage of <code class="docutils literal"><span class="pre">CI_Config::system_url()</span></code> encourages insecure coding practices. -Namely, your CodeIgniter <em>system/</em> directory shouldn’t be publicly accessible -from a security point of view.</p> -<p>Because of this, this method is now deprecated and scheduled for removal in -CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This method is still available, but you’re strongly encouraged to remove its usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="the-javascript-library"> -<h3>The Javascript library<a class="headerlink" href="#the-javascript-library" title="Permalink to this headline">¶</a></h3> -<p>The <a class="reference internal" href="../libraries/javascript.html"><span class="doc">Javascript Library</span></a> has always had an -‘experimental’ status and was never really useful, nor a proper solution.</p> -<p>It is now deprecated and scheduled for removal in CodeIgniter 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">This library is still available, but you’re strongly encouraged to remove its usage -sooner rather than later.</p> -</div> -</div> -<div class="section" id="form-validation-method-prep-for-form"> -<h3>Form Validation method prep_for_form()<a class="headerlink" href="#form-validation-method-prep-for-form" title="Permalink to this headline">¶</a></h3> -<p>The <a class="reference internal" href="../libraries/form_validation.html"><span class="doc">Form Validation Library</span></a> has a -<code class="docutils literal"><span class="pre">prep_for_form()</span></code> method, which is/can also be used as a rule in -<code class="docutils literal"><span class="pre">set_rules()</span></code> to automatically perform HTML encoding on input data.</p> -<p>Automatically encoding input (instead of output) data is a bad practice in -the first place, and CodeIgniter and PHP itself offer other alternatives -to this method anyway. -For example, <a class="reference internal" href="../helpers/form_helper.html"><span class="doc">Form Helper</span></a> functions will -automatically perform HTML escaping when necessary.</p> -<p>Therefore, the <em>prep_for_form</em> method/rule is pretty much useless and is now -deprecated and scheduled for removal in 3.1+.</p> -<div class="admonition note"> -<p class="first admonition-title">Note</p> -<p class="last">The method is still available, but you’re strongly encouraged to -remove its usage sooner rather than later.</p> -</div> -</div> -</div> -<div class="section" id="step-21-check-your-usage-of-text-helper-highlight-phrase"> -<h2>Step 21: Check your usage of Text helper highlight_phrase()<a class="headerlink" href="#step-21-check-your-usage-of-text-helper-highlight-phrase" title="Permalink to this headline">¶</a></h2> -<p>The default HTML tag used by <a class="reference internal" href="../helpers/text_helper.html"><span class="doc">Text Helper</span></a> function -<code class="xref py py-func docutils literal"><span class="pre">highlight_phrase()</span></code> has been changed from <code class="docutils literal"><span class="pre"><strong></span></code> to the new HTML5 -tag <code class="docutils literal"><span class="pre"><mark></span></code>.</p> -<p>Unless you’ve used your own highlighting tags, this might cause trouble -for your visitors who use older web browsers such as Internet Explorer 8. -We therefore suggest that you add the following code to your CSS files -in order to avoid backwards compatibility with old browsers:</p> -<div class="highlight-ci"><div class="highlight"><pre><span></span><span class="nx">mark</span> <span class="p">{</span> - <span class="nx">background</span><span class="o">:</span> <span class="c1">#ff0;</span> - <span class="nx">color</span><span class="o">:</span> <span class="c1">#000;</span> -<span class="p">};</span> -</pre></div> -</div> -</div> -</div> - - - </div> - <footer> - - <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> - - <a href="upgrade_223.html" class="btn btn-neutral float-right" title="Upgrading from 2.2.2 to 2.2.3">Next <span class="fa fa-arrow-circle-right"></span></a> - - - <a href="upgrade_301.html" class="btn btn-neutral" title="Upgrading from 3.0.0 to 3.0.1"><span class="fa fa-arrow-circle-left"></span> Previous</a> - - </div> - - - <hr/> - - <div role="contentinfo"> - <p> - © Copyright 2014 - 2019, British Columbia Institute of Technology. - Last updated on Jan 16, 2019. - </p> - </div> - - Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. - -</footer> - </div> - </div> - - </section> - - </div> - - - - - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT:'../', - VERSION:'3.1.10', - COLLAPSE_INDEX:false, - FILE_SUFFIX:'.html', - HAS_SOURCE: false - }; - </script> - <script type="text/javascript" src="../_static/jquery.js"></script> - <script type="text/javascript" src="../_static/underscore.js"></script> - <script type="text/javascript" src="../_static/doctools.js"></script> - - - - - - <script type="text/javascript" src="../_static/js/theme.js"></script> - - - - - <script type="text/javascript"> - jQuery(function () { - SphinxRtdTheme.StickyNav.enable(); - }); - </script> - - -</body> -</html>
\ No newline at end of file |