Change Log¶

Version 3.1.2¶

Release Date: Oct 28, 2016

• Security
  • Fixed a number of new vulnerabilities in Security Library method xss_clean().
• General Changes
  • Allowed PHP 4-style constructors (Mathching_name::Matching_name() methods) to be used as routes, if there’s a __construct() to override them.

Version 3.1.1¶

Release Date: Oct 22, 2016

• Security
  • Fixed a flaw in Security Library method entity_decode() (used by xss_clean()) that affects HTML 5 entities when using PHP 5.3.
• General Changes
  • Added E_PARSE to the list of error levels detected by the shutdown handler.
  • Updated Inflector Helper is_countable() with more words.
  • Updated common function set_status_header() with new status codes from IETF RFCs 2817 (426) and 6585 (428, 429, 431, 511).

Version 3.1.0¶

Release Date: July 26, 2016

• Security
  • Fixed an SQL injection in the ‘odbc’ database driver.
  • Updated set_realpath() Path Helper function to filter-out php:// wrapper inputs.
  • Officially dropped any kind of support for PHP 5.2.x and anything under 5.3.7.
• General Changes
  • Updated Image Manipulation Library to validate width and height configuration values.
  • Updated Encryption Library to always prefer random_bytes() when it is available.
  • Updated Session Library to log ‘debug’ messages when using fallbacks to session.save_path (php.ini) or ‘sess_use_database’, ‘sess_table_name’ settings.
  • Added a ‘LONGTEXT’ to ‘STRING’ alias to Database Forge for the ‘cubrid’, ‘pdo/cubrid’ drivers.
  • Added ‘TINYINT’, ‘MEDIUMINT’, ‘INT’ and ‘BIGINT’ aliases to ‘NUMBER’ to Database Forge for the ‘oci8’, ‘pdo/oci’ drivers.
  • password_hash() compatibility function changes:
    • Changed salt-generation logic to prefer random_bytes() when it is available.
    • Changed salt-generation logic to prefer direct access to /dev/urandom over openssl_random_pseudo_bytes().
    • Changed salt-generation logic to error if openssl_random_pseudo_bytes() sets its $crypto_strong flag to FALSE.

Version 3.0.6¶

Release Date: March 21, 2016

• General Changes
  • Added a destructor to Cache Library ‘memcached’ driver to ensure that Memcache(d) connections are properly closed.
  • Deprecated Form Validation Library method prep_for_form().

Version 3.0.5¶

Release Date: March 11, 2016

• Core
  • Changed Loader Library to allow $autoload['drivers'] assigning with custom property names.
  • Changed Loader Library to ignore variables prefixed with ‘_ci_’ when loading views.
• General Changes
  • Updated the Session Library to produce friendlier error messages on failures with drivers other than ‘files’.
• Query Builder
  • Added a $batch_size parameter to the insert_batch() method (defaults to 100).
  • Added a $batch_size parameter to the update_batch() method (defaults to 100).

Version 3.0.4¶

Release Date: January 13, 2016

• General Changes
  • Updated Security Library method get_random_bytes() to use PHP 7’s random_bytes() function when possible.
  • Updated Encryption Library method create_key() to use PHP 7’s random_bytes() function when possible.
• Database
  • Added support for OFFSET-FETCH with Oracle 12c for the ‘oci8’ and ‘pdo/oci’ drivers.
  • Added support for the new MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT constant from PHP 5.6.16 for the ‘mysqli’ driver.

Version 3.0.3¶

Release Date: October 31, 2015

• Security
  • Fixed an XSS attack vector in Security Library method xss_clean().
  • Changed Config Library method base_url() to fallback to $_SERVER['SERVER_ADDR'] when $config['base_url'] is empty in order to avoid Host header injections.
  • Changed CAPTCHA Helper to use the operating system’s PRNG when possible.
• Database
  • Optimized Database Utility method csv_from_result() for speed with larger result sets.
  • Added proper return values to Database Transactions method trans_start().

Version 3.0.2¶

Release Date: October 8, 2015

• Security
  • Fixed a number of XSS attack vectors in Security Library method xss_clean() (thanks to Frans Rosén from Detectify).
• General Changes
  • Updated the application/config/constants.php file to check if constants aren’t already defined before doing that.
  • Changed Loader Library method model() to only apply ucfirst() and not strtolower() to the requested class name.
  • Changed Config Library methods base_url(), site_url() to allow protocol-relative URLs by passing an empty string as the protocol.

Version 3.0.1¶

Release Date: August 7, 2015

• Core
  • Added DoS mitigation to hash_pbkdf2() compatibility function.
• Database
  • Added list_fields() support for SQLite (‘sqlite3’ and ‘pdo_sqlite’ drivers).
  • Added SSL connection support for the ‘mysqli’ and ‘pdo_mysql’ drivers.
• Libraries
  • File Uploading Library changes:
    • Changed method set_error() to accept a custom log level (defaults to ‘error’).
    • Errors “no_file_selected”, “file_partial”, “stopped_by_extension”, “no_file_types”, “invalid_filetype”, “bad_filename” are now logged at the ‘debug’ level.
    • Errors “file_exceeds_limit”, “file_exceeds_form_limit”, “invalid_filesize”, “invalid_dimensions” are now logged at the ‘info’ level.
  • Added ‘is_resource’ to the available expectations in Unit Testing Library.
• Helpers
  • Added Unicode support to URL Helper function url_title().
  • Added support for passing the “extra” parameter as an array to all Form Helper functions that use it.
• Core
  • Added support for defining a list of specific query parameters in $config['cache_query_string'] for the Output Library.
  • Added class existence and inheritance checks to CI_Loader::model() in order to ease debugging in case of name collisions.

Version 3.0.0¶

Release Date: March 30, 2015

• License
  • CodeIgniter has been relicensed with the MIT License, eliminating its old proprietary licensing.
• General Changes
  • PHP 5.1.6 is no longer supported. CodeIgniter now requires PHP 5.2.4 and recommends PHP 5.4+ or newer to be used.
  • Changed filenaming convention (class file names now must be Ucfirst and everything else in lowercase).
  • Changed the default database driver to ‘mysqli’ (the old ‘mysql’ driver is DEPRECATED).
  • $_SERVER['CI_ENV'] can now be set to control the ENVIRONMENT constant.
  • Added an optional backtrace to php-error template.
  • Added Android to the list of user agents.
  • Added Windows 7, Windows 8, Windows 8.1, Android, Blackberry, iOS and PlayStation 3 to the list of user platforms.
  • Added Fennec (Firefox for mobile) to the list of mobile user agents.
  • Ability to log certain error types, not all under a threshold.
  • Added support for pem, p10, p12, p7a, p7c, p7m, p7r, p7s, crt, crl, der, kdb, rsa, cer, sst, csr Certs to mimes.php.
  • Added support for pgp, gpg, zsh and cdr files to mimes.php.
  • Added support for 3gp, 3g2, mp4, wmv, f4v, vlc Video files to mimes.php.
  • Added support for m4a, aac, m4u, xspf, au, ac3, flac, ogg, wma Audio files to mimes.php.
  • Added support for kmz and kml (Google Earth) files to mimes.php.
  • Added support for ics Calendar files to mimes.php.
  • Added support for rar, jar and 7zip archives to mimes.php.
  • Updated support for xml (‘application/xml’) and xsl (‘application/xml’, ‘text/xsl’) files in mimes.php.
  • Updated support for doc files in mimes.php.
  • Updated support for docx files in mimes.php.
  • Updated support for php files in mimes.php.
  • Updated support for zip files in mimes.php.
  • Updated support for csv files in mimes.php.
  • Added Romanian, Greek, Vietnamese and Cyrilic characters in application/config/foreign_characters.php.
  • Changed logger to only chmod when file is first created.
  • Removed previously deprecated SHA1 Library.
  • Removed previously deprecated use of $autoload['core'] in application/config/autoload.php. Only entries in $autoload['libraries'] are auto-loaded now.
  • Removed previously deprecated EXT constant.
  • Updated all classes to be written in PHP 5 style, with visibility declarations and no var usage for properties.
  • Added an Exception handler.
  • Moved error templates to application/views/errors/ and made the path configurable via $config['error_views_path'].
  • Added support non-HTML error templates for CLI applications.
  • Moved the Log class to application/core/
  • Global config files are loaded first, then environment ones. Environment config keys overwrite base ones, allowing to only set the keys we want changed per environment.
  • Changed detection of $view_folder so that if it’s not found in the current path, it will now also be searched for under the application folder.
  • Path constants BASEPATH, APPPATH and VIEWPATH are now (internally) defined as absolute paths.
  • Updated email validation methods to use filter_var() instead of PCRE.
  • Changed environment defaults to report all errors in development and only fatal ones in testing, production but only display them in development.
  • Updated ip_address database field lengths from 16 to 45 for supporting IPv6 address on Trackback Library and Captcha Helper.
  • Removed cheatsheets and quick_reference PDFs from the documentation.
  • Added availability checks where usage of dangerous functions like eval() and exec() is required.
  • Added support for changing the file extension of log files using $config['log_file_extension'].
  • Added support for turning newline standardization on/off via $config['standardize_newlines'] and set it to FALSE by default.
  • Added configuration setting $config['composer_autoload'] to enable loading of a Composer auto-loader.
  • Removed the automatic conversion of ‘programmatic characters’ to HTML entities from the URI Library.
  • Changed log messages that say a class or file was loaded to “info” level instead of “debug”, so that they don’t pollute log files when $config['log_threshold'] is set to 2 (debug).
• Helpers
  • Date Helper changes include:
    • Added an optional third parameter to timespan() that constrains the number of time units displayed.
    • Added an optional parameter to timezone_menu() that allows more attributes to be added to the generated select tag.
    • Added function date_range() that generates a list of dates between a specified period.
    • Deprecated standard_date(), which now just uses the native date() with DateTime constants.
    • Changed now() to work with all timezone strings supported by PHP.
    • Changed days_in_month() to use the native cal_days_in_month() PHP function, if available.
  • URL Helper changes include:
    • Deprecated separator options dash and underscore for function url_title() (they are only aliases for ‘-‘ and ‘_’ respectively).
    • url_title() will now trim extra dashes from beginning and end.
    • anchor_popup() will now fill the href attribute with the URL and its JS code will return FALSE instead.
    • Added JS window name support to the anchor_popup() function.
    • Added support for menubar attribute to the anchor_popup().
    • Added support (auto-detection) for HTTP/1.1 response codes 303, 307 in redirect().
    • Changed redirect() to choose the refresh method only on IIS servers, instead of all servers on Windows (when auto is used).
    • Changed anchor(), anchor_popup(), and redirect() to support protocol-relative URLs (e.g. //ellislab.com/codeigniter).
  • HTML Helper changes include:
    • Added more doctypes.
    • Changed application and environment config files to be loaded in a cascade-like manner.
    • Changed doctype() to cache and only load once the doctypes array.
    • Deprecated functions nbs() and br(), which are just aliases for the native str_repeat() with   and <br /> respectively.
  • Inflector Helper changes include:
    • Changed humanize() to allow passing an input separator as its second parameter.
    • Changed humanize() and underscore() to utilize mbstring, if available.
    • Changed plural() and singular() to avoid double pluralization and support more words.
  • Download Helper changes include:
    • Added an optional third parameter to force_download() that enables/disables sending the actual file MIME type in the Content-Type header (disabled by default).
    • Added a work-around in force_download() for a bug Android <= 2.1, where the filename extension needs to be in uppercase.
    • Added support for reading from an existing file path by passing NULL as the second parameter to force_download() (useful for large files and/or safely transmitting binary data).
  • Form Helper changes include:
    • form_dropdown() will now also take an array for unity with other form helpers.
    • form_prep() is now DEPRECATED and only acts as an alias for common function html_escape().
    • set_value() will now also accept a third argument, allowing to turn off HTML escaping of the value.
  • Security Helper changes include:
    • do_hash() now uses PHP’s native hash() function (supporting more algorithms) and is deprecated.
    • strip_image_tags() is now an alias for the same method in the Security Library.
  • Smiley Helper changes include:
    • Deprecated the whole helper as too specific for CodeIgniter.
    • Removed previously deprecated function js_insert_smiley().
    • Changed application and environment config files to be loaded in a cascade-like manner.
    • The smileys array is now cached and loaded only once.
  • File Helper changes include:
    • set_realpath() can now also handle file paths as opposed to just directories.
    • Added an optional paramater to delete_files() to enable it to skip deleting files such as .htaccess and index.html.
    • Deprecated function read_file() - it’s just an alias for PHP’s native file_get_contents().
  • String Helper changes include:
    • Deprecated function repeater() - it’s just an alias for PHP’s native str_repeat().
    • Deprecated function trim_slashes() - it’s just an alias for PHP’s native trim() (with a slash as its second argument).
    • Deprecated randomization type options unique and encrypt for funcion random_string() (they are only aliases for md5 and sha1 respectively).
  • CAPTCHA Helper changes include:
    • Added word_length and pool options to allow customization of the generated word.
    • Added colors configuration to allow customization for the background, border, text and grid colors.
    • Added filename to the returned array elements.
    • Updated to use imagepng() in case that imagejpeg() isn’t available.
    • Added font_size option to allow customization of font size.
    • Added img_id option to set id attribute of captcha image.
  • Text Helper changes include:
    • Changed the default tag for use in highlight_phrase() to <mark> (formerly <strong>).
    • Changed character_limiter(), word_wrap() and ellipsize() to utilize mbstring or iconv, if available.
  • Directory Helper directory_map() will now append DIRECTORY_SEPARATOR to directory names in the returned array.
  • Array Helper element() and elements() now return NULL instead of FALSE when the required elements don’t exist.
  • Language Helper lang() now accepts an optional list of additional HTML attributes.
  • Deprecated the Email Helper as its valid_email(), send_email() functions are now only aliases for PHP native functions filter_var() and mail() respectively.
• Database
  • DEPRECATED the ‘mysql’, ‘sqlite’, ‘mssql’ and ‘pdo/dblib’ (also known as ‘pdo/mssql’ or ‘pdo/sybase’) drivers.
  • Added dsn configuration setting for drivers that support DSN strings (PDO, PostgreSQL, Oracle, ODBC, CUBRID).
  • Added schema configuration setting (defaults to public) for drivers that might need it (currently used by PostgreSQL and ODBC).
  • Added save_queries configuration setting to application/config/database.php (defaults to TRUE).
  • Removed autoinit configuration setting as it doesn’t make sense to instantiate the database class but not connect to the database.
  • Added subdrivers support (currently only used by PDO).
  • Added an optional database name parameter to db_select().
  • Removed protect_identifiers() and renamed internal method _protect_identifiers() to it instead - it was just an alias.
  • Renamed internal method _escape_identifiers() to escape_identifiers().
  • Updated escape_identifiers() to accept an array of fields as well as strings.
  • MySQL and MySQLi drivers now require at least MySQL version 5.1.
  • Added a $persistent parameter to db_connect() and changed db_pconnect() to be an alias for db_connect(TRUE).
  • db_set_charset() now only requires one parameter (collation was only needed due to legacy support for MySQL versions prior to 5.1).
  • db_select() will now always (if required by the driver) be called by db_connect() instead of only when initializing.
  • Replaced the _error_message() and _error_number() methods with error(), which returns an array containing the last database error code and message.
  • Improved version() implementation so that drivers that have a native function to get the version number don’t have to be defined in the core DB_driver class.
  • Added capability for packages to hold config/database.php config files.
  • Added MySQL client compression support.
  • Added encrypted connections support (for mysql, sqlsrv and PDO with sqlsrv).
  • Removed Loader Class from Database error tracing to better find the likely culprit.
  • Added support for SQLite3 database driver.
  • Added Interbase/Firebird database support via the ibase driver.
  • Added ODBC support for create_database(), drop_database() and drop_table() in Database Forge.
  • Added support to binding arrays as IN() sets in query().
  • Query Builder changes include:
    • Renamed the Active Record class to Query Builder to remove confusion with the Active Record design pattern.
    • Added the ability to insert objects with insert_batch().
    • Added new methods that return the SQL string of queries without executing them: get_compiled_select(), get_compiled_insert(), get_compiled_update(), get_compiled_delete().
    • Added an optional parameter that allows to disable escaping (useful for custom fields) for methods join(), order_by(), where_in(), or_where_in(), where_not_in(), or_where_not_in(), insert(), insert_batch().
    • Added support for join() with multiple conditions.
    • Added support for USING in join().
    • Added support for EXISTS in where().
    • Added seed values support for random ordering with order_by(seed, 'RANDOM').
    • Changed limit() to ignore NULL values instead of always casting to integer.
    • Changed offset() to ignore empty values instead of always casting to integer.
    • Methods insert_batch() and update_batch() now return an integer representing the number of rows affected by them.
    • Methods where(), or_where(), having() and or_having() now convert trailing = and <>, != SQL operators to IS NULL and IS NOT NULL respectively when the supplied comparison value is NULL.
    • Added method chaining support to reset_query(), start_cache(), stop_cache() and flush_cache().
    • Added an optional second parameter to count_all_results() to disable resetting of QB values.
  • Database Results changes include:
    • Added a constructor to the DB_result class and moved all driver-specific properties and logic out of the base DB_driver class to allow better abstraction.
    • Added method unbuffered_row() for fetching a row without prefetching the whole result (consume less memory).
    • Renamed former method _data_seek() to data_seek() and made it public.
  • Improved support for the MySQLi driver, including:
    • OOP style usage of the PHP extension is now used, instead of the procedural aliases.
    • Server version checking is now done via mysqli::$server_info instead of running an SQL query.
    • Added persistent connections support for PHP >= 5.3.
    • Added support for configuring socket pipe connections.
    • Added support for backup() in Database Utilities.
    • Changed methods trans_begin(), trans_commit() and trans_rollback() to use the PHP API instead of sending queries.
  • Improved support of the PDO driver, including:
    • Added support for create_database(), drop_database() and drop_table() in Database Forge.
    • Added support for list_fields() in Database Results.
    • Subdrivers are now isolated from each other instead of being in one large class.
  • Improved support of the PostgreSQL driver, including:
    • pg_version() is now used to get the database version number, when possible.
    • Added db_set_charset() support.
    • Added support for optimize_table() in Database Utilities (rebuilds table indexes).
    • Added boolean data type support in escape().
    • Added update_batch() support.
    • Removed limit() and order_by() support for UPDATE and DELETE queries as PostgreSQL does not support those features.
    • Added a work-around for dead persistent connections to be re-created after a database restart.
    • Changed db_connect() to include the (new) schema value into Postgre’s search_path session variable.
    • pg_escape_literal() is now used for escaping strings, if available.
  • Improved support of the CUBRID driver, including:
    • Added DSN string support.
    • Added persistent connections support.
    • Improved list_databases() in Database Utility (until now only the currently used database was returned).
  • Improved support of the MSSQL and SQLSRV drivers, including:
    • Added random ordering support.
    • Added support for optimize_table() in Database Utility.
    • Added escaping with QUOTE_IDENTIFIER setting detection.
    • Added port handling support for UNIX-based systems (MSSQL driver).
    • Added OFFSET support for SQL Server 2005 and above.
    • Added db_set_charset() support (MSSQL driver).
    • Added a scrollable property to enable configuration of the cursor to use (SQLSRV driver).
    • Added support and auto-detection for the SQLSRV_CURSOR_CLIENT_BUFFERED scrollable cursor flag (SQLSRV driver).
    • Changed default behavior to not use SQLSRV_CURSOR_STATIC due to performance issues (SQLSRV driver).
  • Improved support of the Oracle (OCI8) driver, including:
    • Added DSN string support (Easy Connect and TNS).
    • Added support for drop_table() in Database Forge.
    • Added support for list_databases() in Database Utilities.
    • Generally improved for speed and cleaned up all of its components.
    • num_rows() is now only called explicitly by the developer and no longer re-executes statements.
  • Improved support of the SQLite driver, including:
    • Added support for replace() in Query Builder.
    • Added support for drop_table() in Database Forge.
  • Database Forge changes include:
    • Added an optional second parameter to drop_table() that allows adding the IF EXISTS condition, which is no longer the default.
    • Added support for passing a custom database object to the loader.
    • Added support for passing custom table attributes (such as ENGINE for MySQL) to create_table().
    • Added support for usage of the FIRST clause in add_column() for MySQL and CUBRID.
    • Added partial support for field comments (MySQL, PostgreSQL, Oracle).
    • Deprecated add_column()‘s third method. AFTER clause should now be added to the field definition array instead.
    • Overall improved support for all of the drivers.
  • Database Utility changes include:
    • Added support for passing a custom database object to the loader.
    • Modified the class to no longer extend Database Forge, which has been a deprecated behavior for awhile.
    • Overall improved support for all of the drivers.
    • Added foreign_key_checks option to MySQL/MySQLi backup, allowing statement to disable/re-enable foreign key checks to be inserted into the backup output.
• Libraries
  • Added a new Encryption Library to replace the old, largely insecure Encrypt Library.
  • Encrypt Library changes include:
    • Deprecated the library in favor of the new Encryption Library.
    • Added support for hashing algorithms other than SHA1 and MD5.
    • Removed previously deprecated sha1() method.
  • Session Library changes include:
    • Completely re-written the library to use self-contained drivers via $config['sess_driver'].
    • Added ‘files’, ‘database’, ‘redis’ and ‘memcached’ drivers (using ‘files’ by default).
    • Added $config['sess_save_path'] setting to specify where the session data is stored, depending on the driver.
    • Dropped support for storing session data in cookies (which renders $config['sess_encrypt_cookie'] useless and is therefore also removed).
    • Dropped official support for storing session data in databases other than MySQL and PostgreSQL.
    • Changed table structure for the ‘database’ driver.
    • Added a new tempdata feature that allows setting userdata items with expiration time (mark_as_temp(), tempdata(), set_tempdata(), unset_tempdata()).
    • Changed method keep_flashdata() to also accept an array of keys.
    • Changed methods userdata(), flashdata() to return an array of all userdata/flashdata when no parameter is passed.
    • Deprecated method all_userdata() - it is now just an alias for userdata() with no parameters.
    • Added method has_userdata() that verifies the existence of a userdata item.
    • Added debug level log messages for key events in the session validation process.
    • Dropped support for the sess_match_useragent option.
  • File Uploading Library changes include:
    • Added method chaining support.
    • Added support for using array notation in file field names.
    • Added max_filename_increment and file_ext_tolower configuration settings.
    • Added min_width and min_height configuration settings for images.
    • Added mod_mime_fix configuration setting to disable suffixing multiple file extensions with an underscore.
    • Added the possibility pass allowed_types as an array.
    • Added an $index parameter to the method data().
    • Added a $reset parameter to method initialize().
    • Removed method clean_file_name() and its usage in favor of Security Library‘s sanitize_filename().
    • Removed method mimes_types().
    • Changed CI_Upload::_prep_filename() to simply replace all (but the last) dots in the filename with underscores, instead of suffixing them.
  • Calendar Library changes include:
    • Added method chaining support.
    • Added configuration to generate days of other months instead of blank cells.
    • Added auto-configuration for next_prev_url if it is empty and show_prev_next is set to TRUE.
    • Added support for templating via an array in addition to the encoded string.
    • Changed method get_total_days() to be an alias for Date Helper days_in_month().
  • Cart Library changes include:
    • Deprecated the library as too specific for CodeIgniter.
    • Added method remove() to remove a cart item, updating with quantity of 0 seemed like a hack but has remained to retain compatibility.
    • Added method get_item() to enable retrieving data for a single cart item.
    • Added unicode support for product names.
    • Added support for disabling product name strictness via the $product_name_safe property.
    • Changed insert() method to auto-increment quantity for an item when inserted twice instead of resetting it.
    • Changed update() method to support updating all properties attached to an item and not to require ‘qty’.
  • Image Manipulation Library changes include:
    • The initialize() method now only sets existing class properties.
    • Added support for 3-length hex color values for wm_font_color and wm_shadow_color properties, as well as validation for them.
    • Class properties wm_font_color, wm_shadow_color and wm_use_drop_shadow are now protected, to avoid breaking the text_watermark() method if they are set manually after initialization.
    • If property maintain_ratio is set to TRUE, image_reproportion() now doesn’t need both width and height to be specified.
    • Property maintain_ratio is now taken into account when resizing images using ImageMagick library.
    • Added support for maintaining transparency for PNG images when watermarking.
    • Added a file_permissions setting.
  • Form Validation Library changes include:
    • Added method error_array() to return all error messages as an array.
    • Added method set_data() to set an alternative data array to be validated instead of the default $_POST.
    • Added method reset_validation() which resets internal validation variables in case of multiple validation routines.
    • Added support for setting error delimiters in the config file via $config['error_prefix'] and $config['error_suffix'].
    • Internal method _execute() now considers input data to be invalid if a specified rule is not found.
    • Removed method is_numeric() as it exists as a native PHP function and _execute() will find and use that (the is_numeric rule itself is deprecated since 1.6.1).
    • Native PHP functions used as rules can now accept an additional parameter, other than the data itself.
    • Updated method set_rules() to accept an array of rules as well as a string.
    • Fields that have empty rules set no longer run through validation (and therefore are not considered erroneous).
    • Added rule differs to check if the value of a field differs from the value of another field.
    • Added rule valid_url.
    • Added rule in_list to check if the value of a field is within a given list.
    • Added support for named parameters in error messages.
    • Language line keys must now be prefixed with form_validation_.
    • Added rule alpha_numeric_spaces.
    • Added support for custom error messages per field rule.
    • Added support for callable rules when they are passed as an array.
    • Added support for non-ASCII domains in valid_email rule, depending on the Intl extension.
    • Changed the debug message about an error message not being set to include the rule name it is about.
  • Caching Library changes include:
    • Added Wincache driver.
    • Added Redis driver.
    • Added a key_prefix option for cache IDs.
    • Updated driver is_supported() methods to log at the “debug” level.
    • Added option to store raw values instead of CI-formatted ones (APC, Memcache).
    • Added atomic increment/decrement feature via increment(), decrement().
  • E-mail Library changes include:
    • Added a custom filename parameter to attach() as $this->email->attach($filename, $disposition, $newname).
    • Added possibility to send attachment as buffer string in attach() as $this->email->attach($buffer, $disposition, $newname, $mime).
    • Added possibility to attach remote files by passing a URL.
    • Added method attachment_cid() to enable embedding inline attachments into HTML.
    • Added dsn (delivery status notification) option.
    • Renamed method _set_header() to set_header() and made it public to enable adding custom headers.
    • Successfully sent emails will automatically clear the parameters.
    • Added a return_path parameter to the from() method.
    • Removed the second parameter (character limit) from internal method _prep_quoted_printable() as it is never used.
    • Internal method _prep_quoted_printable() will now utilize the native quoted_printable_encode(), imap_8bit() functions (if available) when CRLF is set to “rn”.
    • Default charset now relies on the global $config['charset'] setting.
    • Removed unused protected method _get_ip() (Input Library‘s ip_address() should be used anyway).
    • Internal method _prep_q_encoding() now utilizes PHP’s mbstring and iconv extensions (when available) and no longer has a second ($from) argument.
    • Added an optional parameter to print_debugger() to allow specifying which parts of the message should be printed (‘headers’, ‘subject’, ‘body’).
    • Added SMTP keepalive option to avoid opening the connection for each send() call. Accessible as $smtp_keepalive.
    • Public method set_header() now filters the input by removing all “\r” and “\n” characters.
    • Added support for non-ASCII domains in valid_email(), depending on the Intl extension.
  • Pagination Library changes include:
    • Deprecated usage of the “anchor_class” setting (use the new “attributes” setting instead).
    • Added method chaining support to initialize() method.
    • Added support for the anchor “rel” attribute.
    • Added support for setting custom attributes.
    • Added support for language translations of the first_link, next_link, prev_link and last_link values.
    • Added support for $config['num_links'] = 0 configuration.
    • Added $config['reuse_query_string'] to allow automatic repopulation of query string arguments, combined with normal URI segments.
    • Added $config['use_global_url_suffix'] to allow overriding the library ‘suffix’ value with that of the global $config['url_suffix'] setting.
    • Removed the default   from a number of the configuration variables.
  • Profiler Library changes include:
    • Database object names are now being displayed.
    • The sum of all queries running times in seconds is now being displayed.
    • Added support for displaying the HTTP DNT (“Do Not Track”) header.
    • Added support for displaying $_FILES.
  • Migration Library changes include:
    • Added support for timestamp-based migrations (enabled by default).
    • Added $config['migration_type'] to allow switching between sequential and timestamp migrations.
  • XML-RPC Library changes include:
    • Added the ability to use a proxy.
    • Added Basic HTTP authentication support.
  • User Agent Library changes include:
    • Added check to detect if robots are pretending to be mobile clients (helps with e.g. Google indexing mobile website versions).
    • Added method parse() to allow parsing a custom user-agent string, different from the current visitor’s.
  • HTML Table Library changes include:
    • Added method chaining support.
    • Added support for setting table class defaults in a config file.
  • Zip Library changes include:
    • Method read_file() can now also alter the original file path/name while adding files to an archive.
    • Added support for changing the compression level.
  • Trackback Library method receive() will now utilize iconv() if it is available but mb_convert_encoding() is not.
• Core
  • Routing changes include:
    • Added support for multiple levels of controller directories.
    • Added support for per-directory default_controller and 404_override classes.
    • Added possibility to route requests using HTTP verbs.
    • Added possibility to route requests using callbacks.
    • Added a new reserved route (translate_uri_dashes) to allow usage of dashes in the controller and method URI segments.
    • Deprecated methods fetch_directory(), fetch_class() and fetch_method() in favor of their respective public properties.
    • Removed method _set_overrides() and moved its logic to the class constructor.
  • URI Library changes include:
    • Added conditional PCRE UTF-8 support to the “invalid URI characters” check and removed the preg_quote() call from it to allow more flexibility.
    • Renamed method _filter_uri() to filter_uri().
    • Changed method filter_uri() to accept by reference and removed its return value.
    • Changed private methods to protected so that MY_URI can override them.
    • Renamed internal method _parse_cli_args() to _parse_argv().
    • Renamed internal method _detect_uri() to _parse_request_uri().
    • Changed _parse_request_uri() to accept absolute URIs for compatibility with HTTP/1.1 as per RFC2616 <http://www.ietf.org/rfc/rfc2616.txt>.
    • Added protected method _parse_query_string() to URI paths in the the QUERY_STRING value, like _parse_request_uri() does.
    • Changed URI string detection logic to always default to REQUEST_URI unless configured otherwise or under CLI.
    • Removed methods _remove_url_suffix(), _explode_segments() and moved their logic into _set_uri_string().
    • Removed method _fetch_uri_string() and moved its logic into the class constructor.
    • Removed method _reindex_segments().
  • Loader Library changes include:
    • Added method chaining support.
    • Added method get_vars() to the Loader to retrieve all variables loaded with $this->load->vars().
    • _ci_autoloader() is now a protected method.
    • Added autoloading of drivers with $autoload['drivers'].
    • $config['rewrite_short_tags'] now has no effect when using PHP 5.4 as <?= will always be available.
    • Changed method config() to return whatever CI_Config::load() returns instead of always being void.
    • Added support for library and model aliasing on autoload.
    • Changed method is_loaded() to ask for the (case sensitive) library name instead of its instance name.
    • Removed $_base_classes property and unified all class data in $_ci_classes instead.
    • Added method clear_vars() to allow clearing the cached variables for views.
  • Input Library changes include:
    • Deprecated the $config['global_xss_filtering'] setting.
    • Added method() to retrieve $_SERVER['REQUEST_METHOD'].
    • Added support for arrays and network addresses (e.g. 192.168.1.1/24) for use with the proxy_ips setting.
    • Added method input_stream() to aid in using php://input stream data such as one passed via PUT, DELETE and PATCH requests.
    • Changed method valid_ip() to use PHP’s native filter_var() function.
    • Changed internal method _sanitize_globals() to skip enforcing reversal of register_globals in PHP 5.4+, where this functionality no longer exists.
    • Changed methods get(), post(), get_post(), cookie(), server(), user_agent() to return NULL instead of FALSE when no value is found.
    • Changed default value of the $xss_clean parameter to NULL for all methods that utilize it, the default value is now determined by the $config['global_xss_filtering'] setting.
    • Added method post_get() and changed get_post() to search in GET data first. Both methods’ names now properly match their GET/POST data search priorities.
    • Changed method _fetch_from_array() to parse array notation in field name.
    • Changed method _fetch_from_array() to allow retrieving multiple fields at once.
    • Added an option for _clean_input_keys() to return FALSE instead of terminating the whole script.
    • Deprecated the is_cli_request() method, it is now an alias for the new is_cli() common function.
    • Added an $xss_clean parameter to method user_agent() and removed the $user_agent property.
    • Added property $raw_input_stream to access php://input data.
  • Common functions changes include:
    • Added function get_mimes() to return the application/config/mimes.php array.
    • Added support for HTTP code 303 (“See Other”) in set_status_header().
    • Removed redundant conditional to determine HTTP server protocol in set_status_header().
    • Renamed _exception_handler() to _error_handler() and replaced it with a real exception handler.
    • Changed _error_handler() to respect php.ini display_errors setting.
    • Added function is_https() to check if a secure connection is used.
    • Added function is_cli() to replace the CI_Input::is_cli_request() method.
    • Added function function_usable() to work around a bug in Suhosin <http://www.hardened-php.net/suhosin/>.
    • Removed the third ($php_error) argument from function log_message().
    • Changed internal function load_class() to accept a constructor parameter instead of (previously unused) class name prefix.
    • Removed default parameter value of is_php().
    • Added a second argument $double_encode to html_escape().
    • Changed function config_item() to return NULL instead of FALSE when no value is found.
    • Changed function set_status_header() to return immediately when run under CLI.
  • Output Library changes include:
    • Added a second argument to method set_content_type() that allows setting the document charset as well.
    • Added methods get_content_type() and get_header().
    • Added method delete_cache().
    • Added configuration option $config['cache_query_string'] to enable taking the query string into account when caching.
    • Changed caching behavior to compress the output before storing it, if $config['compress_output'] is enabled.
  • Config Library changes include:
    • Changed site_url() method to accept an array as well.
    • Removed internal method _assign_to_config() and moved its implementation to CodeIgniter.php instead.
    • item() now returns NULL instead of FALSE when the required config item doesn’t exist.
    • Added an optional second parameter to both base_url() and site_url() that allows enforcing of a protocol different than the one in the base_url configuration setting.
    • Added HTTP “Host” header character validation to prevent cache poisoning attacks when base_url auto-detection is used.
  • Security Library changes include:
    • Added $config['csrf_regeneration'], which makes CSRF token regeneration optional.
    • Added $config['csrf_exclude_uris'], allowing for exclusion of URIs from the CSRF protection (regular expressions are supported).
    • Added method strip_image_tags().
    • Added method get_random_bytes() and switched CSRF & XSS token generation to use it.
    • Modified method sanitize_filename() to read a public $filename_bad_chars property for getting the invalid characters list.
    • Return status code of 403 instead of a 500 if CSRF protection is enabled but a token is missing from a request.
  • Language Library changes include:
    • Changed method load() to filter the language name with ctype_alpha().
    • Changed method load() to also accept an array of language files.
    • Added an optional second parameter to method line() to disable error logging for line keys that were not found.
    • Language files are now loaded in a cascading style with the one in system/ always loaded and overridden afterwards, if another one is found.
  • Hooks Library changes include:
    • Added support for closure hooks (or anything that is_callable() returns TRUE for).
    • Renamed method _call_hook() to call_hook().
    • Class instances are now stored in order to maintain their state.
  • UTF-8 Library changes include:
    • UTF8_ENABLED now requires only one of Multibyte String or iconv to be available instead of both.
    • Changed method clean_string() to utilize mb_convert_encoding() if it is available.
    • Renamed method _is_ascii() to is_ascii() and made it public.
  • Log Library changes include:
    • Added a $config['log_file_permissions'] setting.
    • Changed the library constructor to try to create the log_path directory if it doesn’t exist.
    • Added support for microseconds (“u” date format character) in $config['log_date_format'].
  • Added compatibility layers for:
    • Multibyte String (limited support).
    • Hash (hash_equals(), hash_pbkdf2()).
    • Password Hashing.
    • Standard Functions ``array_column()`, array_replace(), array_replace_recursive(), hex2bin(), quoted_printable_encode().
  • Removed CI_CORE boolean constant from CodeIgniter.php (no longer Reactor and Core versions).
  • Added support for HTTP-Only cookies with new config option cookie_httponly (default FALSE).
  • $config['time_reference'] now supports all timezone strings supported by PHP.
  • Fatal PHP errors are now also passed to _error_handler(), so they can be logged.

Version 2.2.3¶

Release Date: July 14, 2015

• Security
  • Removed a fallback to mysql_escape_string() in the ‘mysql’ database driver (escape_str() method) when there’s no active database connection.

Version 2.2.2¶

Release Date: April 15, 2015

• General Changes
  • Added HTTP “Host” header character validation to prevent cache poisoning attacks when base_url auto-detection is used.
  • Added FSCommand and seekSegmentTime to the “evil attributes” list in CI_Security::xss_clean().

Version 2.2.1¶

Release Date: January 22, 2015

• General Changes
  • Improved security in xss_clean().
  • Updated timezones in Date Helper.

Version 2.2.0¶

Release Date: June 2, 2014

• General Changes
  • Security: Encrypt Library method xor_encode() has been removed. The Encrypt Class now requires the Mcrypt extension to be installed.
  • Security: The Session Library now uses HMAC authentication instead of a simple MD5 checksum.

Version 2.1.4¶

Release Date: July 8, 2013

• General Changes
  • Improved security in xss_clean().

Version 2.1.3¶

Release Date: October 8, 2012

• Core
  • Common function is_loaded() now returns a reference.

Version 2.1.2¶

Release Date: June 29, 2012

• General Changes
  • Improved security in xss_clean().

Version 2.1.1¶

Release Date: June 12, 2012

• General Changes
  • Fixed support for docx, xlsx files in mimes.php.
• Libraries
  • Further improved MIME type detection in the File Uploading Library.
  • Added support for IPv6 to the Input Library.
  • Added support for the IP format parameter to the Form Validation Library.
• Helpers
  • url_title() performance and output improved. You can now use any string as the word delimiter, but ‘dash’ and ‘underscore’ are still supported.

Version 2.1.0¶

Release Date: November 14, 2011

• General Changes
  • Callback validation rules can now accept parameters like any other validation rule.
  • Added html_escape() to Common functions to escape HTML output for preventing XSS.
• Helpers
  • Added increment_string() to String Helper to turn “foo” into “foo-1” or “foo-1” into “foo-2”.
  • Altered form helper - made action on form_open_multipart helper function call optional. Fixes (#65)
  • url_title() will now trim extra dashes from beginning and end.
  • Improved speed of String Helper‘s random_string() method
• Database
  • Added a CUBRID driver to the Database Driver. Thanks to the CUBRID team for supplying this patch.
  • Added a PDO driver to the Database Driver.
  • Typecast limit and offset in the Database Driver to integers to avoid possible injection.
  • Added additional option ‘none’ for the optional third argument for $this->db->like() in the Database Driver.
  • Added $this->db->insert_batch() support to the OCI8 (Oracle) driver.
  • Added failover if the main connections in the config should fail
• Libraries
  • Changed $this->cart->insert() in the Cart Library to return the Row ID if a single item was inserted successfully.
  • Added support to set an optional parameter in your callback rules of validation using the Form Validation Library.
  • Added a Migration library to assist with applying incremental updates to your database schema.
  • Driver children can be located in any package path.
  • Added max_filename_increment config setting for Upload library.
  • Added is_unique to the Form Validation library.
  • Added $config[‘use_page_numbers’] to the Pagination library, which enables real page numbers in the URI.
  • Added TLS and SSL Encryption for SMTP.
• Core
  • Changed private functions in CI_URI to protected so MY_URI can override them.
  • Removed CI_CORE boolean constant from CodeIgniter.php (no longer Reactor and Core versions).

Version 2.0.3¶

Release Date: August 20, 2011

• Security

  • An improvement was made to the MySQL and MySQLi drivers to prevent exposing a potential vector for SQL injection on sites using multi-byte character sets in the database client connection. An incompatibility in PHP versions < 5.2.3 and MySQL < 5.0.7 with mysql_set_charset() creates a situation where using multi-byte character sets on these environments may potentially expose a SQL injection attack vector. Latin-1, UTF-8, and other “low ASCII” character sets are unaffected on all environments.

    If you are running or considering running a multi-byte character set for your database connection, please pay close attention to the server environment you are deploying on to ensure you are not vulnerable.

• General Changes

  • Fixed a bug where there was a misspelling within a code comment in the index.php file.
  • Added Session Class userdata to the output profiler. Additionally, added a show/hide toggle on HTTP Headers, Session Data and Config Variables.
  • Removed internal usage of the EXT constant.
  • Visual updates to the welcome_message view file and default error templates. Thanks to danijelb for the pull request.
  • Added insert_batch() function to the PostgreSQL database driver. Thanks to epallerols for the patch.
  • Added “application/x-csv” to mimes.php.
  • Fixed a bug where Email library attachments with a ”.” in the name would using invalid MIME-types.

• Helpers

  • Added an optional third parameter to heading() which allows adding html attributes to the rendered heading tag.
  • form_open() now only adds a hidden (Cross-site Reference Forgery) protection field when the form’s action is internal and is set to the post method. (Reactor #165)
  • Re-worked plural() and singular() functions in the Inflector helper to support considerably more words.

• Libraries

  • Altered Session to use a longer match against the user_agent string. See upgrade notes if using database sessions.
  • Added $this->db->set_dbprefix() to the Database Driver.
  • Changed $this->cart->insert() in the Cart Library to return the Row ID if a single item was inserted successfully.
  • Added $this->load->get_var() to the Loader library to retrieve global vars set with $this->load->view() and $this->load->vars().
  • Changed $this->db->having() to insert quotes using escape() rather than escape_str().

Version 2.0.2¶

Release Date: April 7, 2011 Hg Tag: v2.0.2

• General changes
  • The Security library was moved to the core and is now loaded automatically. Please remove your loading calls.
  • The CI_SHA class is now deprecated. All supported versions of PHP provide a sha1() function.
  • constants.php will now be loaded from the environment folder if available.
  • Added language key error logging
  • Made Environment Support optional. Comment out or delete the constant to stop environment checks.
  • Added Environment Support for Hooks.
  • Added CI_ Prefix to the Cache driver.
  • Added CLI usage documentation.
• Helpers
  • Removed the previously deprecated dohash() from the Security helper; use do_hash() instead.
  • Changed the ‘plural’ function so that it doesn’t ruin the captalization of your string. It also take into consideration acronyms which are all caps.
• Database
  • $this->db->count_all_results() will now return an integer instead of a string.

Version 2.0.1¶

Release Date: March 15, 2011 Hg Tag: v2.0.1

• General changes
  • Added $config[‘cookie_secure’] to the config file to allow requiring a secure (HTTPS) in order to set cookies.
  • Added the constant CI_CORE to help differentiate between Core: TRUE and Reactor: FALSE.
  • Added an ENVIRONMENT constant in index.php, which affects PHP error reporting settings, and optionally, which configuration files are loaded (see below). Read more on the Handling Environments page.
  • Added support for environment-specific configuration files.
• Libraries
  • Added decimal, less_than and greater_than rules to the Form validation Class.
  • Input Class methods post() and get() will now return a full array if the first argument is not provided.
  • Secure cookies can now be made with the set_cookie() helper and Input Class method.
  • Added set_content_type() to Output Class to set the output Content-Type HTTP header based on a MIME Type or a config/mimes.php array key.
  • Output Class will now support method chaining.
• Helpers
  • Changed the logic for form_open() in Form helper. If no value is passed it will submit to the current URL.

Version 2.0.0¶

Release Date: January 28, 2011 Hg Tag: v2.0.0

• General changes
  • PHP 4 support is removed. CodeIgniter now requires PHP 5.1.6.
  • Scaffolding, having been deprecated for a number of versions, has been removed.
  • Plugins have been removed, in favor of Helpers. The CAPTCHA plugin has been converted to a Helper and documented. The JavaScript calendar plugin was removed due to the ready availability of great JavaScript calendars, particularly with jQuery.
  • Added new special Library type: Drivers.
  • Added full query-string support. See the config file for details.
  • Moved the application folder outside of the system folder.
  • Moved system/cache and system/logs directories to the application directory.
  • Added routing overrides to the main index.php file, enabling the normal routing to be overridden on a per “index” file basis.
  • Added the ability to set config values (or override config values) directly from data set in the main index.php file. This allows a single application to be used with multiple front controllers, each having its own config values.
  • Added $config[‘directory_trigger’] to the config file so that a controller sub-directory can be specified when running _GET strings instead of URI segments.
  • Added ability to set “Package” paths - specific paths where the Loader and Config classes should try to look first for a requested file. This allows distribution of sub-applications with their own libraries, models, config files, etc. in a single “package” directory. See the Loader class documentation for more details.
  • In-development code is now hosted at BitBucket .
  • Removed the deprecated Validation Class.
  • Added CI_ Prefix to all core classes.
  • Package paths can now be set in application/config/autoload.php.
  • Upload library file_name can now be set without an extension, the extension will be taken from the uploaded file instead of the given name.
  • In Database Forge the name can be omitted from $this->dbforge->modify_column()’s 2nd param if you aren’t changing the name.
  • $config[‘base_url’] is now empty by default and will guess what it should be.
  • Enabled full Command Line Interface compatibility with config[‘uri_protocol’] = ‘CLI’;.
• Libraries
  • Added a Cache driver with APC, memcached, and file-based support.
  • Added $prefix, $suffix and $first_url properties to Pagination library.
  • Added the ability to suppress first, previous, next, last, and page links by setting their values to FALSE in the Pagination library.
  • Added Security library, which now contains the xss_clean function, filename_security function and other security related functions.
  • Added CSRF (Cross-site Reference Forgery) protection to the Security library.
  • Added $parse_exec_vars property to Output library.
  • Added ability to enable / disable individual sections of the Profiler
  • Added a wildcard option $config[‘allowed_types’] = ‘*’ to the File Uploading Class.
  • Added an ‘object’ config variable to the XML-RPC Server library so that one can specify the object to look for requested methods, instead of assuming it is in the $CI superobject.
  • Added “is_object” into the list of unit tests capable of being run.
  • Table library will generate an empty cell with a blank string, or NULL value.
  • Added ability to set tag attributes for individual cells in the Table library
  • Added a parse_string() method to the Parser Class.
  • Added HTTP headers and Config information to the Profiler output.
  • Added Chrome and Flock to the list of detectable browsers by browser() in the User Agent Class.
  • The Unit Test Class now has an optional “notes” field available to it, and allows for discrete display of test result items using $this->unit->set_test_items().
  • Added a $xss_clean class variable to the XMLRPC library, enabling control over the use of the Security library’s xss_clean() method.
  • Added a download() method to the FTP library
  • Changed do_xss_clean() to return FALSE if the uploaded file fails XSS checks.
  • Added stripslashes() and trim()ing of double quotes from $_FILES type value to standardize input in Upload library.
  • Added a second parameter (boolean) to $this->zip->read_dir(‘/path/to/directory’, FALSE) to remove the preceding trail of empty folders when creating a Zip archive. This example would contain a zip with “directory” and all of its contents.
  • Added ability in the Image Library to handle PNG transparency for resize operations when using the GD lib.
  • Modified the Session class to prevent use if no encryption key is set in the config file.
  • Added a new config item to the Session class sess_expire_on_close to allow sessions to auto-expire when the browser window is closed.
  • Improved performance of the Encryption library on servers where Mcrypt is available.
  • Changed the default encryption mode in the Encryption library to CBC.
  • Added an encode_from_legacy() method to provide a way to transition encrypted data from CodeIgniter 1.x to CodeIgniter 2.x. Please see the upgrade instructions for details.
  • Altered Form_Validation library to allow for method chaining on set_rules(), set_message() and set_error_delimiters() functions.
  • Altered Email Library to allow for method chaining.
  • Added request_headers(), get_request_header() and is_ajax_request() to the input class.
  • Altered User agent library so that is_browser(), is_mobile() and is_robot() can optionally check for a specific browser or mobile device.
  • Altered Input library so that post() and get() will return all POST and GET items (respectively) if there are no parameters passed in.
• Database
  • database configuration.
  • Added autoinit value to database configuration.
  • Added stricton value to database configuration.
  • Added database_exists() to the Database Utilities Class.
  • Semantic change to db->version() function to allow a list of exceptions for databases with functions to return version string instead of specially formed SQL queries. Currently this list only includes Oracle and SQLite.
  • Fixed a bug where driver specific table identifier protection could lead to malformed queries in the field_data() functions.
  • Fixed a bug where an undefined class variable was referenced in database drivers.
  • Modified the database errors to show the filename and line number of the problematic query.
  • Removed the following deprecated functions: orwhere, orlike, groupby, orhaving, orderby, getwhere.
  • Removed deprecated _drop_database() and _create_database() functions from the db utility drivers.
  • Improved dbforge create_table() function for the Postgres driver.
• Helpers
  • Added convert_accented_characters() function to text helper.
  • Added accept-charset to the list of inserted attributes of form_open() in the Form Helper.
  • Deprecated the dohash() function in favour of do_hash() for naming consistency.
  • Non-backwards compatible change made to get_dir_file_info() in the File Helper. No longer recurses by default so as to encourage responsible use (this function can cause server performance issues when used without caution).
  • Modified the second parameter of directory_map() in the Directory Helper to accept an integer to specify recursion depth.
  • Modified delete_files() in the File Helper to return FALSE on failure.
  • Added an optional second parameter to byte_format() in the Number Helper to allow for decimal precision.
  • Added alpha, and sha1 string types to random_string() in the String Helper.
  • Modified prep_url() so as to not prepend http&#58;// if the supplied string already has a scheme.
  • Modified get_file_info in the file helper, changing filectime() to filemtime() for dates.
  • Modified smiley_js() to add optional third parameter to return only the javascript with no script tags.
  • The img() function of the HTML helper will now generate an empty string as an alt attribute if one is not provided.
  • If CSRF is enabled in the application config file, form_open() will automatically insert it as a hidden field.
  • Added sanitize_filename() into the Security helper.
  • Added ellipsize() to the Text Helper
  • Added elements() to the Array Helper
• Other Changes
  • Added an optional second parameter to show_404() to disable logging.
  • Updated loader to automatically apply the sub-class prefix as an option when loading classes. Class names can be prefixed with the standard “CI_” or the same prefix as the subclass prefix, or no prefix at all.
  • Increased randomness with is_really_writable() to avoid file collisions when hundreds or thousands of requests occur at once.
  • Switched some DIR_WRITE_MODE constant uses to FILE_WRITE_MODE where files and not directories are being operated on.
  • get_mime_by_extension() is now case insensitive.
  • Added “default” to the list Reserved Names.
  • Added ‘application/x-msdownload’ for .exe files and ‘application/x-gzip-compressed’ for .tgz files to config/mimes.php.
  • Updated the output library to no longer compress output or send content-length headers if the server runs with zlib.output_compression enabled.
  • Eliminated a call to is_really_writable() on each request unless it is really needed (Output caching)
  • Documented append_output() in the Output Class.
  • Documented a second argument in the decode() function for the Encrypt Class.
  • Documented db->close().
  • Updated the router to support a default route with any number of segments.
  • Moved _remove_invisible_characters() function from the Security Library to common functions.
  • Added audio/mpeg3 as a valid mime type for MP3.

Version 1.7.2¶

Release Date: September 11, 2009 Hg Tag: v1.7.2

• Libraries
  • Added a new Cart Class.
  • Added the ability to pass $config[‘file_name’] for the File Uploading Class and rename the uploaded file.
  • Changed order of listed user-agents so Safari would more accurately report itself. (#6844)
• Database
  • Switched from using gettype() in escape() to is_* methods, since future PHP versions might change its output.
  • Updated all database drivers to handle arrays in escape_str()
  • Added escape_like_str() method for escaping strings to be used in LIKE conditions
  • Updated Active Record to utilize the new LIKE escaping mechanism.
  • Added reconnect() method to DB drivers to try to keep alive / reestablish a connection after a long idle.
  • Modified MSSQL driver to use mssql_get_last_message() for error messages.
• Helpers
  • Added form_multiselect() to the Form helper.
  • Modified form_hidden() in the Form helper to accept multi-dimensional arrays.
  • Modified form_prep() in the Form helper to keep track of prepped fields to avoid multiple prep/mutation from subsequent calls which can occur when using Form Validation and form helper functions to output form fields.
  • Modified directory_map() in the Directory helper to allow the inclusion of hidden files, and to return FALSE on failure to read directory.
  • Modified the Smiley helper to work with multiple fields and insert the smiley at the last known cursor position.
• General
  • Compatible with PHP 5.3.0.
  • Modified show_error() to allow sending of HTTP server response codes.
  • Modified show_404() to send 404 status code, removing non-CGI compatible header() statement from error_404.php template.
  • Added set_status_header() to the Common functions to allow use when the Output class is unavailable.
  • Added is_php() to Common functions to facilitate PHP version comparisons.
  • Added 2 CodeIgniter “cheatsheets” (thanks to DesignFellow.com for this contribution).

Version 1.7.1¶

Release Date: February 10, 2009 Hg Tag: 1.7.1

• Libraries
  • Fixed an arbitrary script execution security flaw (#6068) in the Form Validation library (thanks to hkk)
  • Changed default current page indicator in the Pagination library to use <strong> instead of <b>
  • A “HTTP/1.1 400 Bad Request” header is now sent when disallowed characters are encountered.
  • Added <big>, <small>, <q>, and <tt> to the Typography parser’s inline elements.
  • Added more accurate error reporting for the Email library when using sendmail.
  • Removed a strict type check from the rotate() function of the Image Manipulation Class.
  • Added enhanced error checking in file saving in the Image library when using the GD lib.
  • Added an additional newline between multipart email headers and the MIME message text for better compatibility with a variety of MUAs.
  • Made modest improvements to efficiency and accuracy of explode_name() in the Image lib.
• Database
  • Added where_in to the list of expected arguments received by delete().
• Helpers
  • Added the ability to have optgroups in form_dropdown() within the form helper.
  • Added a doctype() function to the HTML helper.
  • Added ability to force lowercase for url_title() in the URL helper.
  • Changed the default “type” of form_button() to “button” from “submit” in the form helper.
  • Changed redirect() in the URL helper to allow redirections to URLs outside of the CI site.
  • Updated get_cookie() to try to fetch the cookie using the global cookie prefix if the requested cookie name doesn’t exist.
• Other Changes
  • Improved security in xss_clean() to help prevent attacks targeting Internet Explorer.
  • Added ‘application/msexcel’ to config/mimes.php for .xls files.
  • Added ‘proxy_ips’ config item to whitelist reverse proxy servers from which to trust the HTTP_X_FORWARDED_FOR header to to determine the visitor’s IP address.
  • Improved accuracy of Upload::is_allowed_filetype() for images (#6715)

Version 1.7¶

Release Date: October 23, 2008 Hg Tag: 1.7.0

• Libraries
  • Added a new Form Validation Class. It simplifies setting rules and field names, supports arrays as field names, allows groups of validation rules to be saved in a config file, and adds some helper functions for use in view files. Please note that the old Validation class is now deprecated. We will leave it in the library folder for some time so that existing applications that use it will not break, but you are encouraged to migrate to the new version.
  • Updated the Sessions class so that any custom data being saved gets stored to a database rather than the session cookie (assuming you are using a database to store session data), permitting much more data to be saved.
  • Added the ability to store libraries in subdirectories within either the main “libraries” or the local application “libraries” folder. Please see the Loader class for more info.
  • Added the ability to assign library objects to your own variable names when you use $this->load->library(). Please see the Loader class for more info.
  • Added controller class/method info to Profiler class and support for multiple database connections.
  • Improved the “auto typography” feature and moved it out of the helper into its own Typography Class.
  • Improved performance and accuracy of xss_clean(), including reduction of false positives on image/file tests.
  • Improved Parser class to allow multiple calls to the parse() function. The output of each is appended in the output.
  • Added max_filename option to set a file name length limit in the File Upload Class.
  • Added set_status_header() function to Output class.
  • Modified Pagination class to only output the “First” link when the link for page one would not be shown.
  • Added support for mb_strlen in the Form Validation class so that multi-byte languages will calculate string lengths properly.
• Database
  • Improved Active Record class to allow full path column and table names: hostname.database.table.column. Also improved the alias handling.
  • Improved how table and column names are escaped and prefixed. It now honors full path names when adding prefixes and escaping.
  • Added Active Record caching feature to “update” and “delete” functions.
  • Added removal of non-printing control characters in escape_str() of DB drivers that do not have native PHP escaping mechanisms (mssql, oci8, odbc), to avoid potential SQL errors, and possible sources of SQL injection.
  • Added port support to MySQL, MySQLi, and MS SQL database drivers.
  • Added driver name variable in each DB driver, based on bug report #4436.
• Helpers
  • Added several new “setting” functions to the Form helper that allow POST data to be retrieved and set into forms. These are intended to be used on their own, or with the new Form Validation Class.
  • Added current_url() and uri_segments() to URL helper.
  • Altered auto_link() in the URL helper so that email addresses with “+” included will be linked.
  • Added meta() function to HTML helper.
  • Improved accuracy of calculations in Number helper.
  • Removed added newlines (“\n”) from most form and html helper functions.
  • Tightened up validation in the Date helper function human_to_unix(), and eliminated the POSIX regex.
  • Updated Date helper to match the world’s current time zones and offsets.
  • Modified url_title() in the URL helper to remove characters and digits that are part of character entities, to allow dashes, underscores, and periods regardless of the $separator, and to allow uppercase characters.
  • Added support for arbitrary attributes in anchor_popup() of the URL helper.
• Other Changes
  • Added PHP Style Guide to docs.
  • Added sanitization in xss_clean() for a deprecated HTML tag that could be abused in user input in Internet Explorer.
  • Added a few openxml document mime types, and an additional mobile agent to mimes.php and user_agents.php respectively.
  • Added a file lock check during caching, before trying to write to the file.
  • Modified Cookie key cleaning to unset a few troublesome key names that can be present in certain environments, preventing CI from halting execution.
  • Changed the output of the profiler to use style attribute rather than clear, and added the id “codeigniter_profiler” to the container div.

Version 1.6.3¶

Release Date: June 26, 2008 Hg Tag: v1.6.3

Version 1.6.3 is a security and maintenance release and is recommended for all users.

• Database
  • Modified MySQL/MySQLi Forge class to give explicit names to keys
  • Added ability to set multiple column non-primary keys to the Forge class
  • Added ability to set additional database config values in DSN connections via the query string.
• Libraries
  • Set the mime type check in the Upload class to reference the global mimes variable.
  • Added support for query strings to the Pagination class, automatically detected or explicitly declared.
  • Added get_post() to the Input class.
  • Documented get() in the Input class.
  • Added the ability to automatically output language items as form labels in the Language class.
• Helpers
  • Added a Language helper.
  • Added a Number helper.
  • Form helper refactored to allow form_open() and form_fieldset() to accept arrays or strings as arguments.
• Other changes
  • Improved security in xss_clean().
  • Removed an unused Router reference in _display_cache().
  • Added ability to use xss_clean() to test images for XSS, useful for upload security.
  • Considerably expanded list of mobile user-agents in config/user_agents.php.
  • Charset information in the userguide has been moved above title for internationalization purposes (#4614).
  • Added “Using Associative Arrays In a Request Parameter” example to the XMLRPC userguide page.
  • Removed maxlength and size as automatically added attributes of form_input() in the form helper.
  • Documented the language file use of byte_format() in the number helper.

Version 1.6.2¶

Release Date: May 13, 2008 Hg Tag: 1.6.2

• Active Record
  • Added the ability to prevent escaping in having() clauses.
  • Added rename_table() into DBForge.
  • Fixed a bug that wasn’t allowing escaping to be turned off if the value of a query was NULL.
  • DB Forge is now assigned to any models that exist after loading (#3457).
• Database
  • Added Strict Mode to database transactions.
  • Escape behaviour in where() clauses has changed; values in those with the “FALSE” argument are no longer escaped (ie: quoted).
• Config
  • Added ‘application/vnd.ms-powerpoint’ to list of mime types.
  • Added ‘audio/mpg’ to list of mime types.
  • Added new user-modifiable file constants.php containing file mode and fopen constants.
  • Added the ability to set CRLF settings via config in the Email class.
• Libraries
  • Added increased security for filename handling in the Upload library.
  • Added increased security for sessions for client-side data tampering.
  • The MySQLi forge class is now in sync with MySQL forge.
  • Added the ability to set CRLF settings via config in the Email class.
  • Unit Testing results are now colour coded, and a change was made to the default template of results.
  • Added a valid_emails rule to the Validation class.
  • The Zip class now exits within download().
  • The Zip class has undergone a substantial re-write for speed and clarity (thanks stanleyxu for the hard work and code contribution in bug report #3425!)
• Helpers
  • Added a Compatibility Helper for using some common PHP 5 functions safely in applications that might run on PHP 4 servers (thanks Seppo for the hard work and code contribution!)
  • Added form_button() in the Form helper.
  • Changed the radio() and checkbox() functions to default to not checked by default.
  • Added the ability to include an optional HTTP Response Code in the redirect() function of the URL Helper.
  • Modified img() in the HTML Helper to remove an unneeded space (#4208).
  • Modified anchor() in the URL helper to no longer add a default title= attribute (#4209).
  • The Download helper now exits within force_download().
  • Added get_dir_file_info(), get_file_info(), and get_mime_by_extension() to the File Helper.
  • Added symbolic_permissions() and octal_permissions() to the File helper.
• Plugins
  • Modified captcha generation to first look for the function imagecreatetruecolor, and fallback to imagecreate if it isn’t available (#4226).
• Other Changes
  • Added ability for xss_clean() to accept arrays.
  • Removed closing PHP tags from all PHP files to avoid accidental output and potential ‘cannot modify headers’ errors.
  • Removed “scripts” from the auto-load search path. Scripts were deprecated in Version 1.4.1 (September 21, 2006). If you still need to use them for legacy reasons, they must now be manually loaded in each Controller.
  • Added a Reserved Names page to the userguide, and migrated reserved controller names into it.
  • Added a Common Functions page to the userguide for globally available functions.
  • Improved security and performance of xss_clean().

Version 1.6.1¶

Release Date: February 12, 2008 Hg Tag: 1.6.1

• Active Record
  • Added Active Record Caching.
  • Made Active Record fully database-prefix aware.
• Database drivers
  • Added support for setting client character set and collation for MySQLi.
• Core Changes
  • Modified xss_clean() to be more intelligent with its handling of URL encoded strings.
  • Added $_SERVER, $_FILES, $_ENV, and $_SESSION to sanitization of globals.
  • Added a Path Helper.
  • Simplified _reindex_segments() in the URI class.
  • Escaped the ‘-‘ in the default ‘permitted_uri_chars’ config item, to prevent errors if developers just try to add additional characters to the end of the default expression.
  • Modified method calling to controllers to show a 404 when a private or protected method is accessed via a URL.
  • Modified framework initiated 404s to log the controller and method for invalid requests.
• Helpers
  • Modified get_filenames() in the File Helper to return FALSE if the $source_dir is not readable.

Version 1.6.0¶

Release Date: January 30, 2008

• DBForge
  • Added DBForge to the database tools.
  • Moved create_database() and drop_database() into DBForge.
  • Added add_field(), add_key(), create_table(), drop_table(), add_column(), drop_column(), modify_column() into DBForge.
• Active Record
  • Added protect_identifiers() in Active Record.
  • All AR queries are backticked if appropriate to the database.
  • Added where_in(), or_where_in(), where_not_in(), or_where_not_in(), not_like() and or_not_like() to Active Record.
  • Added support for limit() into update() and delete() statements in Active Record.
  • Added empty_table() and truncate_table() to Active Record.
  • Added the ability to pass an array of tables to the delete() statement in Active Record.
  • Added count_all_results() function to Active Record.
  • Added select_max(), select_min(), select_avg() and select_sum() to Active Record.
  • Added the ability to use aliases with joins in Active Record.
  • Added a third parameter to Active Record’s like() clause to control where the wildcard goes.
  • Added a third parameter to set() in Active Record that withholds escaping data.
  • Changed the behaviour of variables submitted to the where() clause with no values to auto set “IS NULL”
• Other Database Related
  • MySQL driver now requires MySQL 4.1+
  • Added $this->DB->save_queries variable to DB driver, enabling queries to get saved or not. Previously they were always saved.
  • Added $this->db->dbprefix() to manually add database prefixes.
  • Added ‘random’ as an order_by() option , and removed “rand()” as a listed option as it was MySQL only.
  • Added a check for NULL fields in the MySQL database backup utility.
  • Added “constrain_by_prefix” parameter to db->list_table() function. If set to TRUE it will limit the result to only table names with the current prefix.
  • Deprecated from Active Record; getwhere() for get_where(); groupby() for group_by(); havingor() for having_or(); orderby() for order_by; orwhere() for or_where(); and orlike() for or_like().
  • Modified csv_from_result() to output CSV data more in the spirit of basic rules of RFC 4180.
  • Added ‘char_set’ and ‘dbcollat’ database configuration settings, to explicitly set the client communication properly.
  • Removed ‘active_r’ configuration setting and replaced with a global $active_record setting, which is more in harmony with the global nature of the behavior (#1834).
• Core changes
  • Added ability to load multiple views, whose content will be appended to the output in the order loaded.
  • Added the ability to auto-load Models.
  • Reorganized the URI and Routes classes for better clarity.
  • Added Compat.php to allow function overrides for older versions of PHP or PHP environments missing certain extensions / libraries
  • Added memory usage, GET, URI string data, and individual query execution time to Profiler output.
  • Deprecated Scaffolding.
  • Added is_really_writable() to Common.php to provide a cross-platform reliable method of testing file/folder writability.
• Libraries
  • Changed the load protocol of Models to allow for extension.
  • Strengthened the Encryption library to help protect against man in the middle attacks when MCRYPT_MODE_CBC mode is used.
  • Added Flashdata variables, session_id regeneration and configurable session update times to the Session class.
  • Removed ‘last_visit’ from the Session class.
  • Added a language entry for valid_ip validation error.
  • Modified prep_for_form() in the Validation class to accept arrays, adding support for POST array validation (via callbacks only)
  • Added an “integer” rule into the Validation library.
  • Added valid_base64() to the Validation library.
  • Documented clear() in the Image Processing library.
  • Changed the behaviour of custom callbacks so that they no longer trigger the “required” rule.
  • Modified Upload class $_FILES error messages to be more precise.
  • Moved the safe mode and auth checks for the Email library into the constructor.
  • Modified variable names in _ci_load() method of Loader class to avoid conflicts with view variables.
  • Added a few additional mime type variations for CSV.
  • Enabled the ‘system’ methods for the XML-RPC Server library, except for ‘system.multicall’ which is still disabled.
• Helpers & Plugins
  • Added link_tag() to the HTML helper.
  • Added img() to the HTML helper.
  • Added ability to “extend” Helpers.
  • Added an email helper into core helpers.
  • Added strip_quotes() function to string helper.
  • Added reduce_multiples() function to string helper.
  • Added quotes_to_entities() function to string helper.
  • Added form_fieldset(), form_fieldset_close(), form_label(), and form_reset() function to form helper.
  • Added support for external urls in form_open().
  • Removed support for db_backup in MySQLi due to incompatible functions.
  • Javascript Calendar plugin now uses the months and days from the calendar language file, instead of hard-coded values, internationalizing it.
• Documentation Changes
  • Added Writing Documentation section for the community to use in writing their own documentation.
  • Added titles to all user manual pages.
  • Added attributes into <html> of userguide for valid html.
  • Added Zip Encoding Class to the table of contents of the userguide.
  • Moved part of the userguide menu javascript to an external file.
  • Documented distinct() in Active Record.
  • Documented the timezones() function in the Date Helper.
  • Documented unset_userdata in the Session class.
  • Documented 2 config options to the Database configuration page.

Version 1.5.4¶

Release Date: July 12, 2007

• Added custom Language files to the autoload options.
• Added stripslashes() to the _clean_input_data() function in the Input class when magic quotes is on so that data will always be un-slashed within the framework.
• Added array to string into the profiler.
• Added some additional mime types in application/config/mimes.php.
• Added filename_security() method to Input library.
• Added some additional arguments to the Inflection helper singular() to compensate for words ending in “s”. Also added a force parameter to pluralize().
• Added $config[‘charset’] to the config file. Default value is ‘UTF-8’, used in some string handling functions.
• Fixed MSSQL insert_id().
• Fixed a logic error in the DB trans_status() function. It was incorrectly returning TRUE on failure and FALSE on success.
• Fixed a bug that was allowing multiple load attempts on extended classes.
• Fixed a bug in the bootstrap file that was incorrectly attempting to discern the full server path even when it was explicity set by the user.
• Fixed a bug in the escape_str() function in the MySQL driver.
• Fixed a typo in the Calendar library
• Fixed a typo in rpcs.php library
• Fixed a bug in the Zip library, providing PC Zip file compatibility with Mac OS X
• Fixed a bug in router that was ignoring the scaffolding route for optimization
• Fixed an IP validation bug.
• Fixed a bug in display of POST keys in the Profiler output
• Fixed a bug in display of queries with characters that would be interpreted as HTML in the Profiler output
• Fixed a bug in display of Email class print debugger with characters that would be interpreted as HTML in the debugging output
• Fixed a bug in the Content-Transfer-Encoding of HTML emails with the quoted-printable MIME type
• Fixed a bug where one could unset certain PHP superglobals by setting them via GET or POST data
• Fixed an undefined function error in the insert_id() function of the PostgreSQL driver
• Fixed various doc typos.
• Documented two functions from the String helper that were missing from the user guide: trim_slashes() and reduce_double_slashes().
• Docs now validate to XHTML 1 transitional
• Updated the XSS Filtering to take into account the IE expression() ability and improved certain deletions to prevent possible exploits
• Modified the Router so that when Query Strings are Enabled, the controller trigger and function trigger values are sanitized for filename include security.
• Modified the is_image() method in the Upload library to take into account Windows IE 6/7 eccentricities when dealing with MIMEs
• Modified XSS Cleaning routine to be more performance friendly and compatible with PHP 5.2’s new PCRE backtrack and recursion limits.
• Modified the URL Helper to type cast the $title as a string in case a numeric value is supplied
• Modified Form Helper form_dropdown() to type cast the keys and values of the options array as strings, allowing numeric values to be properly set as ‘selected’
• Deprecated the use if is_numeric() in various places since it allows periods. Due to compatibility problems with ctype_digit(), making it unreliable in some installations, the following regular expression was used instead: preg_match(“/[^0-9]/”, $n)
• Deprecated: APPVER has been deprecated and replaced with CI_VERSION for clarity.

Version 1.5.3¶

Release Date: April 15, 2007

• Added array to string into the profiler
• Code Igniter references updated to CodeIgniter
• pMachine references updated to EllisLab
• Fixed a bug in the repeater function of string helper.
• Fixed a bug in ODBC driver
• Fixed a bug in result_array() that was returning an empty array when no result is produced.
• Fixed a bug in the redirect function of the url helper.
• Fixed an undefined variable in Loader
• Fixed a version bug in the Postgres driver
• Fixed a bug in the textarea function of the form helper for use with strings
• Fixed doc typos.

Version 1.5.2¶

Release Date: February 13, 2007

• Added subversion information to the downloads page.
• Added support for captions in the Table Library
• Fixed a bug in the download_helper that was causing Internet Explorer to load rather than download
• Fixed a bug in the Active Record Join function that was not taking table prefixes into consideration.
• Removed unescaped variables in error messages of Input and Router classes
• Fixed a bug in the Loader that was causing errors on Libraries loaded twice. A debug message is now silently made in the log.
• Fixed a bug in the form helper that gave textarea a value attribute
• Fixed a bug in the Image Library that was ignoring resizing the same size image
• Fixed some doc typos.

Version 1.5.1¶

Release Date: November 23, 2006

• Added support for submitting arrays of libraries in the $this->load->library function.
• Added support for naming custom library files in lower or uppercase.
• Fixed a bug related to output buffering.
• Fixed a bug in the active record class that was not resetting query data after a completed query.
• Fixed a bug that was suppressing errors in controllers.
• Fixed a problem that can cause a loop to occur when the config file is missing.
• Fixed a bug that occurred when multiple models were loaded with the third parameter set to TRUE.
• Fixed an oversight that was not unsetting globals properly in the input sanitize function.
• Fixed some bugs in the Oracle DB driver.
• Fixed an incorrectly named variable in the MySQLi result driver.
• Fixed some doc typos.

Version 1.5.0.1¶

Release Date: October 31, 2006

• Fixed a problem in which duplicate attempts to load helpers and classes were not being stopped.
• Fixed a bug in the word_wrap() helper function.
• Fixed an invalid color Hex number in the Profiler class.
• Fixed a corrupted image in the user guide.

Version 1.5.0¶

Release Date: October 30, 2006

• Added DB utility class, permitting DB backups, CVS or XML files from DB results, and various other functions.
• Added Database Caching Class.
• Added transaction support to the database classes.
• Added Profiler Class which generates a report of Benchmark execution times, queries, and POST data at the bottom of your pages.
• Added User Agent Library which allows browsers, robots, and mobile devises to be identified.
• Added HTML Table Class , enabling tables to be generated from arrays or database results.
• Added Zip Encoding Library.
• Added FTP Library.
• Added the ability to extend libraries and extend core classes, in addition to being able to replace them.
• Added support for storing models within sub-folders.
• Added Download Helper.
• Added simple_query() function to the database classes
• Added standard_date() function to the Date Helper.
• Added $query->free_result() to database class.
• Added $query->list_fields() function to database class
• Added $this->db->platform() function
• Added new File Helper: get_filenames()
• Added new helper: Smiley Helper
• Added support for <ul> and <ol> lists in the HTML Helper
• Added the ability to rewrite short tags on-the-fly, converting them to standard PHP statements, for those servers that do not support short tags. This allows the cleaner syntax to be used regardless of whether it’s supported by the server.
• Added the ability to rename or relocate the “application” folder.
• Added more thorough initialization in the upload class so that all class variables are reset.
• Added “is_numeric” to validation, which uses the native PHP is_numeric function.
• Improved the URI handler to make it more reliable when the $config[‘uri_protocol’] item is set to AUTO.
• Moved most of the functions in the Controller class into the Loader class, allowing fewer reserved function names for controllers when running under PHP 5.
• Updated the DB Result class to return an empty array when $query->result() doesn’t produce a result.
• Updated the input->cookie() and input->post() functions in Input Class to permit arrays contained cookies that are arrays to be run through the XSS filter.
• Documented three functions from the Validation class that were missing from the user guide: set_select(), set_radio(), and set_checkbox().
• Fixed a bug in the Email class related to SMTP Helo data.
• Fixed a bug in the word wrapping helper and function in the email class.
• Fixed a bug in the validation class.
• Fixed a bug in the typography helper that was incorrectly wrapping block level elements in paragraph tags.
• Fixed a problem in the form_prep() function that was double encoding entities.
• Fixed a bug that affects some versions of PHP when output buffering is nested.
• Fixed a bug that caused CI to stop working when the PHP magic __get() or __set() functions were used within models or controllers.
• Fixed a pagination bug that was permitting negative values in the URL.
• Fixed an oversight in which the Loader class was not allowed to be extended.
• Changed _get_config() to get_config() since the function is not a private one.
• Deprecated “init” folder. Initialization happens automatically now. Please see documentation.
• Deprecated $this->db->field_names() USE $this->db->list_fields()
• Deprecated the $config[‘log_errors’] item from the config.php file. Instead, $config[‘log_threshold’] can be set to “0” to turn it off.

Version 1.4.1¶

Release Date: September 21, 2006

• Added a new feature that passes URI segments directly to your function calls as parameters. See the Controllers page for more info.
• Added support for a function named _output(), which when used in your controllers will received the final rendered output from the output class. More info in the Controllers page.
• Added several new functions in the URI Class to let you retrieve and manipulate URI segments that have been re-routed using the URI Routing feature. Previously, the URI class did not permit you to access any re-routed URI segments, but now it does.
• Added $this->output->set_header() function, which allows you to set server headers.
• Updated plugins, helpers, and language classes to allow your application folder to contain its own plugins, helpers, and language folders. Previously they were always treated as global for your entire installation. If your application folder contains any of these resources they will be used instead the global ones.
• Added Inflector helper.
• Added element() function in the array helper.
• Added RAND() to active record orderby() function.
• Added delete_cookie() and get_cookie() to Cookie helper, even though the input class has a cookie fetching function.
• Added Oracle database driver (still undergoing testing so it might have some bugs).
• Added the ability to combine pseudo-variables and php variables in the template parser class.
• Added output compression option to the config file.
• Removed the is_numeric test from the db->escape() function.
• Fixed a MySQLi bug that was causing error messages not to contain proper error data.
• Fixed a bug in the email class which was causing it to ignore explicitly set alternative headers.
• Fixed a bug that was causing a PHP error when the Exceptions class was called within the get_config() function since it was causing problems.
• Fixed an oversight in the cookie helper in which the config file cookie settings were not being honored.
• Fixed an oversight in the upload class. An item mentioned in the 1.4 changelog was missing.
• Added some code to allow email attachments to be reset when sending batches of email.
• Deprecated the application/scripts folder. It will continue to work for legacy users, but it is recommended that you create your own libraries or models instead. It was originally added before CI had user libraries or models, but it’s not needed anymore.
• Deprecated the $autoload[‘core’] item from the autoload.php file. Instead, please now use: $autoload[‘libraries’]
• Deprecated the following database functions: $this->db->smart_escape_str() and $this->db->fields().

Version 1.4.0¶

Release Date: September 17, 2006

• Added Hooks feature, enabling you to tap into and modify the inner workings of the framework without hacking the core files.
• Added the ability to organize controller files into sub-folders. Kudos to Marco for suggesting this (and the next two) feature.
• Added regular expressions support for routing rules.
• Added the ability to remap function calls within your controllers.
• Added the ability to replace core system classes with your own classes.
• Added support for % character in URL.
• Added the ability to supply full URLs using the anchor() helper function.
• Added mode parameter to file_write() helper.
• Added support for changing the port number in the Postgres driver.
• Moved the list of “allowed URI characters” out of the Router class and into the config file.
• Moved the MIME type array out of the Upload class and into its own file in the application/config/ folder.
• Updated the Upload class to allow the upload field name to be set when calling do_upload().
• Updated the Config Library to be able to load config files silently, and to be able to assign config files to their own index (to avoid collisions if you use multiple config files).
• Updated the URI Protocol code to allow more options so that URLs will work more reliably in different environments.
• Updated the form_open() helper to allow the GET method to be used.
• Updated the MySQLi execute() function with some code to help prevent lost connection errors.
• Updated the SQLite Driver to check for object support before attempting to return results as objects. If unsupported it returns an array.
• Updated the Models loader function to allow multiple loads of the same model.
• Updated the MS SQL driver so that single quotes are escaped.
• Updated the Postgres and ODBC drivers for better compatibility.
• Removed a strtolower() call that was changing URL segments to lower case.
• Removed some references that were interfering with PHP 4.4.1 compatibility.
• Removed backticks from Postgres class since these are not needed.
• Renamed display() to _display() in the Output class to make it clear that it’s a private function.
• Deprecated the hash() function due to a naming conflict with a native PHP function with the same name. Please use dohash() instead.
• Fixed an bug that was preventing the input class from unsetting GET variables.
• Fixed a router bug that was making it too greedy when matching end segments.
• Fixed a bug that was preventing multiple discrete database calls.
• Fixed a bug in which loading a language file was producing a “file contains no data” message.
• Fixed a session bug caused by the XSS Filtering feature inadvertently changing the case of certain words.
• Fixed some missing prefixes when using the database prefix feature.
• Fixed a typo in the Calendar class (cal_november).
• Fixed a bug in the form_checkbox() helper.
• Fixed a bug that was allowing the second segment of the URI to be identical to the class name.
• Fixed an evaluation bug in the database initialization function.
• Fixed a minor bug in one of the error messages in the language class.
• Fixed a bug in the date helper timespan function.
• Fixed an undefined variable in the DB Driver class.
• Fixed a bug in which dollar signs used as binding replacement values in the DB class would be treated as RegEx back-references.
• Fixed a bug in the set_hash() function which was preventing MD5 from being used.
• Fixed a couple bugs in the Unit Testing class.
• Fixed an incorrectly named variable in the Validation class.
• Fixed an incorrectly named variable in the URI class.
• Fixed a bug in the config class that was preventing the base URL from being called properly.
• Fixed a bug in the validation class that was not permitting callbacks if the form field was empty.
• Fixed a problem that was preventing scaffolding from working properly with MySQLi.
• Fixed some MS SQL bugs.
• Fixed some doc typos.

Version 1.3.3¶

Release Date: June 1, 2006

• Models do not connect automatically to the database as of this version. More info here.
• Updated the Sessions class to utilize the active record class when running session related queries. Previously the queries assumed MySQL syntax.
• Updated alternator() function to re-initialize when called with no arguments, allowing multiple calls.
• Fixed a bug in the active record “having” function.
• Fixed a problem in the validation class which was making checkboxes be ignored when required.
• Fixed a bug in the word_limiter() helper function. It was cutting off the fist word.
• Fixed a bug in the xss_clean function due to a PHP bug that affects some versions of html_entity_decode.
• Fixed a validation bug that was preventing rules from being set twice in one controller.
• Fixed a calendar bug that was not letting it use dynamically loaded languages.
• Fixed a bug in the active record class when using WHERE clauses with LIKE
• Fixed a bug in the hash() security helper.
• Fixed some typos.

Version 1.3.2¶

Release Date: April 17, 2006

• Changed the behavior of the validation class such that if a “required” rule is NOT explicitly stated for a field then all other tests get ignored.
• Fixed a bug in the Controller class that was causing it to look in the local “init” folder instead of the main system one.
• Fixed a bug in the init_pagination file. The $config item was not being set correctly.
• Fixed a bug in the auto typography helper that was causing inconsistent behavior.
• Fixed a couple bugs in the Model class.
• Fixed some documentation typos and errata.

Version 1.3.1¶

Release Date: April 11, 2006

• Added a Unit Testing Library.
• Added the ability to pass objects to the insert() and update() database functions. This feature enables you to (among other things) use your Model class variables to run queries with. See the Models page for details.
• Added the ability to pass objects to the view loading function: $this->load->view(‘my_view’, $object);
• Added getwhere function to Active Record class.
• Added count_all function to Active Record class.
• Added language file for scaffolding and fixed a scaffolding bug that occurs when there are no rows in the specified table.
• Added $this->db->last_query(), which allows you to view your last query that was run.
• Added a new mime type to the upload class for better compatibility.
• Changed how cache files are read to prevent PHP errors if the cache file contains an XML tag, which PHP wants to interpret as a short tag.
• Fixed a bug in a couple of the active record functions (where and orderby).
• Fixed a bug in the image library when realpath() returns false.
• Fixed a bug in the Models that was preventing libraries from being used within them.
• Fixed a bug in the “exact_length” function of the validation class.
• Fixed some typos in the user guide

Version 1.3¶

Release Date: April 3, 2006

• Added support for Models.
• Redesigned the database libraries to support additional RDBMs (Postgres, MySQLi, etc.).
• Redesigned the Active Record class to enable more varied types of queries with simpler syntax, and advanced features like JOINs.
• Added a feature to the database class that lets you run custom function calls.
• Added support for private functions in your controllers. Any controller function name that starts with an underscore will not be served by a URI request.
• Added the ability to pass your own initialization parameters to your custom core libraries when using $this->load->library()
• Added support for running standard query string URLs. These can be optionally enabled in your config file.
• Added the ability to specify a “suffix”, which will be appended to your URLs. For example, you could add .html to your URLs, making them appear static. This feature is enabled in your config file.
• Added a new error template for use with native PHP errors.
• Added “alternator” function in the string helpers.
• Removed slashing from the input class. After much debate we decided to kill this feature.
• Change the commenting style in the scripts to the PEAR standard so that IDEs and tools like phpDocumenter can harvest the comments.
• Added better class and function name-spacing to avoid collisions with user developed classes. All CodeIgniter classes are now prefixed with CI_ and all controller methods are prefixed with _ci to avoid controller collisions. A list of reserved function names can be found here.
• Redesigned how the “CI” super object is referenced, depending on whether PHP 4 or 5 is being run, since PHP 5 allows a more graceful way to manage objects that utilizes a bit less resources.
• Deprecated: $this->db->use_table() has been deprecated. Please read the Active Record page for information.
• Deprecated: $this->db->smart_escape_str() has been deprecated. Please use this instead: $this->db->escape()
• Fixed a bug in the exception handler which was preventing some PHP errors from showing up.
• Fixed a typo in the URI class. $this->total_segment() should be plural: $this->total_segments()
• Fixed some typos in the default calendar template
• Fixed some typos in the user guide

Version 1.2¶

Release Date: March 21, 2006

• Redesigned some internal aspects of the framework to resolve scoping problems that surfaced during the beta tests. The problem was most notable when instantiating classes in your constructors, particularly if those classes in turn did work in their constructors.
• Added a global function named get_instance() allowing the main CodeIgniter object to be accessible throughout your own classes.
• Added new File Helper: delete_files()
• Added new URL Helpers: base_url(), index_page()
• Added the ability to create your own core libraries and store them in your local application directory.
• Added an overwrite option to the Upload class, enabling files to be overwritten rather than having the file name appended.
• Added Javascript Calendar plugin.
• Added search feature to user guide. Note: This is done using Google, which at the time of this writing has not crawled all the pages of the docs.
• Updated the parser class so that it allows tag pars within other tag pairs.
• Fixed a bug in the DB “where” function.
• Fixed a bug that was preventing custom config files to be auto-loaded.
• Fixed a bug in the mysql class bind feature that prevented question marks in the replacement data.
• Fixed some bugs in the xss_clean function

Version Beta 1.1¶

Release Date: March 10, 2006

• Added a Calendaring class.
• Added support for running multiple applications that share a common CodeIgniter backend.
• Moved the “uri protocol” variable from the index.php file into the config.php file
• Fixed a problem that was preventing certain function calls from working within constructors.
• Fixed a problem that was preventing the $this->load->library function from working in constructors.
• Fixed a bug that occurred when the session class was loaded using the auto-load routine.
• Fixed a bug that can happen with PHP versions that do not support the E_STRICT constant
• Fixed a data type error in the form_radio function (form helper)
• Fixed a bug that was preventing the xss_clean function from being called from the validation class.
• Fixed the cookie related config names, which were incorrectly specified as $conf rather than $config
• Fixed a pagination problem in the scaffolding.
• Fixed a bug in the mysql class “where” function.
• Fixed a regex problem in some code that trimmed duplicate slashes.
• Fixed a bug in the br() function in the HTML helper
• Fixed a syntax mistake in the form_dropdown function in the Form Helper.
• Removed the “style” attributes form the form helpers.
• Updated the documentation. Added “next/previous” links to each page and fixed various typos.

Version Beta 1.0¶

Release Date: February 28, 2006

First publicly released version.