[ { "path": ".editorconfig", "content": "# top-most EditorConfig file\nroot = true\n\n# Unix-style newlines with a newline ending every file\n[*]\nend_of_line = lf\ninsert_final_newline = true\n\n# Matches multiple files with brace expansion notation\n# Set default charset\n[*]\ncharset = utf-8\n\n# Tab indentation (no size specified)\nindent_style = tab\n" }, { "path": ".gitattributes", "content": "# This file tells which files and directories should be ignored and\n# NOT downloaded when using composer to pull down a project with\n# the --prefer-dist option selected. Used to remove development\n# specific files so user has a clean download.\n\n# git files\n.gitattributes export-ignore\n# .gitignore\n\n# helper config files\n.travis.yml export-ignore\nphpdoc.dist.xml export-ignore\n\n# Misc other files\nreadme.rst\n\n# They don't want all of our tests...\ntests/codeigniter/ export-ignore\ntests/travis/ export-ignore\n\n# User Guide source files and compiled files\nuser_guide_src export-ignore\nuser_guide export-ignore\n" }, { "path": ".github/workflows/test-phpunit.yml", "content": "name: PHPUnit\n\non: [push, pull_request]\n\npermissions:\n contents: read\n\njobs:\n tests:\n runs-on: ubuntu-22.04\n if: \"!contains(github.event.head_commit.message, '[ci skip]')\"\n env:\n PHP_INI_VALUES: assert.exception=1, zend.assertions=1\n\n strategy:\n fail-fast: false\n matrix:\n php: [ '8.1', '8.0', '7.4', '7.3', '7.2', '7.1', '7.0', '5.6', '5.5', '5.4']\n DB: [ 'pdo/mysql', 'pdo/pgsql', 'pdo/sqlite', 'mysqli', 'pgsql', 'sqlite' ]\n compiler: [ default ]\n include:\n - php: '8.1'\n DB: 'pdo/mysql'\n compiler: jit\n - php: '8.1'\n DB: 'pdo/pgsql'\n compiler: jit\n - php: '8.1'\n DB: 'pdo/sqlite'\n compiler: jit\n - php: '8.1'\n DB: 'mysqli'\n compiler: jit\n - php: '8.1'\n DB: 'pgsql'\n compiler: jit\n - php: '8.1'\n DB: 'sqlite'\n compiler: jit\n - php: '8.0'\n DB: 'pdo/mysql'\n compiler: jit\n - php: '8.0'\n DB: 'pdo/pgsql'\n compiler: jit\n - php: '8.0'\n DB: 'pdo/sqlite'\n compiler: jit\n - php: '8.0'\n DB: 'mysqli'\n compiler: jit\n - php: '8.0'\n DB: 'pgsql'\n compiler: jit\n - php: '8.0'\n DB: 'sqlite'\n compiler: jit\n - php: '5.6'\n DB: 'mysql'\n compiler: default\n - php: '5.5'\n DB: 'mysql'\n compiler: default\n - php: '5.4'\n DB: 'mysql'\n compiler: default\n\n services:\n postgres:\n image: postgres:12\n env:\n POSTGRES_USER: postgres\n POSTGRES_PASSWORD: postgres\n POSTGRES_DB: ci_test\n ports:\n - 5432:5432\n options: --health-cmd=pg_isready --health-interval=10s --health-timeout=5s --health-retries=3\n\n mysql:\n image: mysql:5.7\n env:\n MYSQL_ALLOW_EMPTY_PASSWORD: true\n MYSQL_USER: travis\n MYSQL_PASSWORD: travis\n MYSQL_DATABASE: ci_test\n ports:\n - 3306:3306\n options: --health-cmd=\"mysqladmin ping\" --health-interval=10s --health-timeout=5s --health-retries=3\n\n steps:\n - name: Checkout\n uses: actions/checkout@v2\n - name: Override PHP ini values for JIT compiler\n if: matrix.compiler == 'jit'\n run: echo \"PHP_INI_VALUES::assert.exception=1, zend.assertions=1, opcache.enable=1, opcache.enable_cli=1, opcache.optimization_level=-1, opcache.jit=1255, opcache.jit_buffer_size=64M\" >> $GITHUB_ENV \n\n - name: Install PHP${{ matrix.php }} - DB ${{ matrix.DB }}\n uses: shivammathur/setup-php@v2\n with:\n php-version: ${{ matrix.php }}\n tools: composer, pecl\n extensions: imagick, sqlite3, pgsql, mysqli, pdo, pdo_mysql, pdo_pgsql, pdo_sqlite, mbstring\n ini-values: ${{ env.PHP_INI_VALUES }}\n coverage: xdebug\n\n - name: Get composer cache directory\n id: composer-cache\n run: echo \"::set-output name=dir::$(composer config cache-files-dir)\"\n - name: Cache composer dependencies\n uses: actions/cache@v2\n with:\n path: ${{ steps.composer-cache.outputs.dir }}\n key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}\n restore-keys: ${{ runner.os }}-composer- \n - name: Install composer dependencies\n run: composer install --no-progress --prefer-dist --optimize-autoloader\n\n - name: PHPUnit Test\n run: |\n php -d error_reporting=E_ALL -d zend.enable_gc=0 -d date.timezone=UTC -d mbstring.func_overload=7 -d mbstring.internal_encoding=UTF-8 vendor/bin/phpunit --coverage-text --configuration tests/travis/${{ matrix.DB }}.phpunit.xml\n env:\n XDEBUG_MODE: coverage\n" }, { "path": ".gitignore", "content": ".DS_Store\n\napplication/cache/*\n!application/cache/index.html\n\napplication/logs/*\n!application/logs/index.html\n\n!application/*/.htaccess\n\ncomposer.lock\ntests/mocks/database/ci_test.sqlite\n\nuser_guide_src/build/*\nuser_guide_src/cilexer/build/*\nuser_guide_src/cilexer/dist/*\nuser_guide_src/cilexer/pycilexer.egg-info/*\n/vendor/\n\n# IDE Files\n#-------------------------\n/nbproject/\n.idea/*\n\n## Sublime Text cache files\n*.tmlanguage.cache\n*.tmPreferences.cache\n*.stTheme.cache\n*.sublime-workspace\n*.sublime-project\n/tests/tests/\n/tests/results/\n" }, { "path": "DCO.txt", "content": "Developer's Certificate of Origin 1.1\n\nBy making a contribution to this project, I certify that:\n\n(1)\tThe contribution was created in whole or in part by me and I\n\thave the right to submit it under the open source license\n\tindicated in the file; or\n\n(2)\tThe contribution is based upon previous work that, to the best\n\tof my knowledge, is covered under an appropriate open source\n\tlicense and I have the right under that license to submit that\n\twork with modifications, whether created in whole or in part\n\tby me, under the same open source license (unless I am\n\tpermitted to submit under a different license), as indicated\n\tin the file; or\n\n(3)\tThe contribution was provided directly to me by some other\n\tperson who certified (1), (2) or (3) and I have not modified\n\tit.\n\n(4)\tI understand and agree that this project and the contribution\n\tare public and that a record of the contribution (including all\n\tpersonal information I submit with it, including my sign-off) is\n\tmaintained indefinitely and may be redistributed consistent with\n\tthis project or the open source license(s) involved.\n" }, { "path": "application/.htaccess", "content": "\n Require all denied\n\n\n Deny from all\n" }, { "path": "application/cache/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/config/autoload.php", "content": " 'ua');\n*/\n$autoload['libraries'] = array();\n\n/*\n| -------------------------------------------------------------------\n| Auto-load Drivers\n| -------------------------------------------------------------------\n| These classes are located in system/libraries/ or in your\n| application/libraries/ directory, but are also placed inside their\n| own subdirectory and they extend the CI_Driver_Library class. They\n| offer multiple interchangeable driver options.\n|\n| Prototype:\n|\n|\t$autoload['drivers'] = array('cache');\n|\n| You can also supply an alternative property name to be assigned in\n| the controller:\n|\n|\t$autoload['drivers'] = array('cache' => 'cch');\n|\n*/\n$autoload['drivers'] = array();\n\n/*\n| -------------------------------------------------------------------\n| Auto-load Helper Files\n| -------------------------------------------------------------------\n| Prototype:\n|\n|\t$autoload['helper'] = array('url', 'file');\n*/\n$autoload['helper'] = array();\n\n/*\n| -------------------------------------------------------------------\n| Auto-load Config files\n| -------------------------------------------------------------------\n| Prototype:\n|\n|\t$autoload['config'] = array('config1', 'config2');\n|\n| NOTE: This item is intended for use ONLY if you have created custom\n| config files. Otherwise, leave it blank.\n|\n*/\n$autoload['config'] = array();\n\n/*\n| -------------------------------------------------------------------\n| Auto-load Language files\n| -------------------------------------------------------------------\n| Prototype:\n|\n|\t$autoload['language'] = array('lang1', 'lang2');\n|\n| NOTE: Do not include the \"_lang\" part of your file. For example\n| \"codeigniter_lang.php\" would be referenced as array('codeigniter');\n|\n*/\n$autoload['language'] = array();\n\n/*\n| -------------------------------------------------------------------\n| Auto-load Models\n| -------------------------------------------------------------------\n| Prototype:\n|\n|\t$autoload['model'] = array('first_model', 'second_model');\n|\n| You can also supply an alternative model name to be assigned\n| in the controller:\n|\n|\t$autoload['model'] = array('first_model' => 'first');\n*/\n$autoload['model'] = array();\n" }, { "path": "application/config/config.php", "content": "]+$/i\n|\n| DO NOT CHANGE THIS UNLESS YOU FULLY UNDERSTAND THE REPERCUSSIONS!!\n|\n| Note: This option is ignored for CLI requests.\n|\n*/\n$config['permitted_uri_chars'] = 'a-z 0-9~%.:_\\-';\n\n/*\n|--------------------------------------------------------------------------\n| Enable Query Strings\n|--------------------------------------------------------------------------\n|\n| By default CodeIgniter uses search-engine friendly segment based URLs:\n| example.com/who/what/where/\n|\n| You can optionally enable standard query string based URLs:\n| example.com?who=me&what=something&where=here\n|\n| Options are: TRUE or FALSE (boolean)\n|\n| The other items let you set the query string 'words' that will\n| invoke your controllers and its functions:\n| example.com/index.php?c=controller&m=function\n|\n| Please note that some of the helpers won't work as expected when\n| this feature is enabled, since CodeIgniter is designed primarily to\n| use segment based URLs.\n|\n*/\n$config['enable_query_strings'] = FALSE;\n$config['controller_trigger'] = 'c';\n$config['function_trigger'] = 'm';\n$config['directory_trigger'] = 'd';\n\n/*\n|--------------------------------------------------------------------------\n| Error Logging Threshold\n|--------------------------------------------------------------------------\n|\n| You can enable error logging by setting a threshold over zero. The\n| threshold determines what gets logged. Threshold options are:\n|\n|\t0 = Disables logging, Error logging TURNED OFF\n|\t1 = Error Messages (including PHP errors)\n|\t2 = Debug Messages\n|\t3 = Informational Messages\n|\t4 = All Messages\n|\n| You can also pass an array with threshold levels to show individual error types\n|\n| \tarray(2) = Debug Messages, without Error Messages\n|\n| For a live site you'll usually only enable Errors (1) to be logged otherwise\n| your log files will fill up very fast.\n|\n*/\n$config['log_threshold'] = 0;\n\n/*\n|--------------------------------------------------------------------------\n| Error Logging Directory Path\n|--------------------------------------------------------------------------\n|\n| Leave this BLANK unless you would like to set something other than the default\n| application/logs/ directory. Use a full server path.\n|\n*/\n$config['log_path'] = '';\n\n/*\n|--------------------------------------------------------------------------\n| Error Logging FILENAME\n|--------------------------------------------------------------------------\n|\n| Leave this BLANK unless you would like to set something other than the default\n| 'log-'.date('Y-m-d').'.php'. No DIRECTORY_SEPARATOR(s), just the filename.\n|\n*/\n$config['log_filename'] = '';\n\n/*\n|--------------------------------------------------------------------------\n| Log File Permissions\n|--------------------------------------------------------------------------\n|\n| The file system permissions to be applied on newly created log files.\n|\n| IMPORTANT: This MUST be an integer (no quotes) and you MUST use octal\n| integer notation (i.e. 0700, 0644, etc.)\n*/\n$config['log_file_permissions'] = 0644;\n\n/*\n|--------------------------------------------------------------------------\n| Date Format for Logs\n|--------------------------------------------------------------------------\n|\n| Each item that is logged has an associated date. You can use PHP date\n| codes to set your own date formatting\n|\n*/\n$config['log_date_format'] = 'Y-m-d H:i:s';\n\n/*\n|--------------------------------------------------------------------------\n| Error Views Directory Path\n|--------------------------------------------------------------------------\n|\n| Leave this BLANK unless you would like to set something other than the default\n| application/views/errors/ directory. Use a full server path.\n|\n*/\n$config['error_views_path'] = '';\n\n/*\n|--------------------------------------------------------------------------\n| Cache Directory Path\n|--------------------------------------------------------------------------\n|\n| Leave this BLANK unless you would like to set something other than the default\n| application/cache/ directory. Use a full server path.\n|\n*/\n$config['cache_path'] = '';\n\n/*\n|--------------------------------------------------------------------------\n| Cache Include Query String\n|--------------------------------------------------------------------------\n|\n| Whether to take the URL query string into consideration when generating\n| output cache files. Valid options are:\n|\n|\tFALSE = Disabled\n|\tTRUE = Enabled, take all query parameters into account.\n|\t Please be aware that this may result in numerous cache\n|\t files generated for the same page over and over again.\n|\tarray('q') = Enabled, but only take into account the specified list\n|\t of query parameters.\n|\n*/\n$config['cache_query_string'] = FALSE;\n\n/*\n|--------------------------------------------------------------------------\n| Encryption Key\n|--------------------------------------------------------------------------\n|\n| If you use the Encryption class, you must set an encryption key.\n| See the user guide for more info.\n|\n| https://codeigniter.com/userguide3/libraries/encryption.html\n|\n*/\n$config['encryption_key'] = '';\n\n/*\n|--------------------------------------------------------------------------\n| Session Variables\n|--------------------------------------------------------------------------\n|\n| 'sess_driver'\n|\n|\tThe storage driver to use: files, database, redis, memcached\n|\n| 'sess_cookie_name'\n|\n|\tThe session cookie name, must contain only [0-9a-z_-] characters\n|\n| 'sess_samesite'\n|\n|\tSession cookie SameSite attribute: Lax (default), Strict or None\n|\n| 'sess_expiration'\n|\n|\tThe number of SECONDS you want the session to last.\n|\tSetting to 0 (zero) means expire when the browser is closed.\n|\n| 'sess_save_path'\n|\n|\tThe location to save sessions to, driver dependent.\n|\n|\tFor the 'files' driver, it's a path to a writable directory.\n|\tWARNING: Only absolute paths are supported!\n|\n|\tFor the 'database' driver, it's a table name.\n|\tPlease read up the manual for the format with other session drivers.\n|\n|\tIMPORTANT: You are REQUIRED to set a valid save path!\n|\n| 'sess_match_ip'\n|\n|\tWhether to match the user's IP address when reading the session data.\n|\n|\tWARNING: If you're using the database driver, don't forget to update\n|\t your session table's PRIMARY KEY when changing this setting.\n|\n| 'sess_time_to_update'\n|\n|\tHow many seconds between CI regenerating the session ID.\n|\n| 'sess_regenerate_destroy'\n|\n|\tWhether to destroy session data associated with the old session ID\n|\twhen auto-regenerating the session ID. When set to FALSE, the data\n|\twill be later deleted by the garbage collector.\n|\n| Other session cookie settings are shared with the rest of the application,\n| except for 'cookie_prefix' and 'cookie_httponly', which are ignored here.\n|\n*/\n$config['sess_driver'] = 'files';\n$config['sess_cookie_name'] = 'ci_session';\n$config['sess_samesite'] = 'Lax';\n$config['sess_expiration'] = 7200;\n$config['sess_save_path'] = NULL;\n$config['sess_match_ip'] = FALSE;\n$config['sess_time_to_update'] = 300;\n$config['sess_regenerate_destroy'] = FALSE;\n\n/*\n|--------------------------------------------------------------------------\n| Cookie Related Variables\n|--------------------------------------------------------------------------\n|\n| 'cookie_prefix' = Set a cookie name prefix if you need to avoid collisions\n| 'cookie_domain' = Set to .your-domain.com for site-wide cookies\n| 'cookie_path' = Typically will be a forward slash\n| 'cookie_secure' = Cookie will only be set if a secure HTTPS connection exists.\n| 'cookie_httponly' = Cookie will only be accessible via HTTP(S) (no javascript)\n| 'cookie_samesite' = Cookie's samesite attribute (Lax, Strict or None)\n|\n| Note: These settings (with the exception of 'cookie_prefix' and\n| 'cookie_httponly') will also affect sessions.\n|\n*/\n$config['cookie_prefix']\t= '';\n$config['cookie_domain']\t= '';\n$config['cookie_path']\t\t= '/';\n$config['cookie_secure']\t= FALSE;\n$config['cookie_httponly'] \t= FALSE;\n$config['cookie_samesite'] \t= 'Lax';\n\n/*\n|--------------------------------------------------------------------------\n| Cross Site Request Forgery\n|--------------------------------------------------------------------------\n| Enables a CSRF cookie token to be set. When set to TRUE, token will be\n| checked on a submitted form. If you are accepting user data, it is strongly\n| recommended CSRF protection be enabled.\n|\n| 'csrf_token_name' = The token name\n| 'csrf_cookie_name' = The cookie name\n| 'csrf_expire' = The number in seconds the token should expire.\n| 'csrf_regenerate' = Regenerate token on every submission\n| 'csrf_exclude_uris' = Array of URIs which ignore CSRF checks\n*/\n$config['csrf_protection'] = FALSE;\n$config['csrf_token_name'] = 'csrf_test_name';\n$config['csrf_cookie_name'] = 'csrf_cookie_name';\n$config['csrf_expire'] = 7200;\n$config['csrf_regenerate'] = TRUE;\n$config['csrf_exclude_uris'] = array();\n\n/*\n|--------------------------------------------------------------------------\n| Output Compression\n|--------------------------------------------------------------------------\n|\n| Enables Gzip output compression for faster page loads. When enabled,\n| the output class will test whether your server supports Gzip.\n| Even if it does, however, not all browsers support compression\n| so enable only if you are reasonably sure your visitors can handle it.\n|\n| Only used if zlib.output_compression is turned off in your php.ini.\n| Please do not use it together with httpd-level output compression.\n|\n| VERY IMPORTANT: If you are getting a blank page when compression is enabled it\n| means you are prematurely outputting something to your browser. It could\n| even be a line of whitespace at the end of one of your scripts. For\n| compression to work, nothing can be sent before the output buffer is called\n| by the output class. Do not 'echo' any values with compression enabled.\n|\n*/\n$config['compress_output'] = FALSE;\n\n/*\n|--------------------------------------------------------------------------\n| Master Time Reference\n|--------------------------------------------------------------------------\n|\n| Options are 'local' or any PHP supported timezone. This preference tells\n| the system whether to use your server's local time as the master 'now'\n| reference, or convert it to the configured one timezone. See the 'date\n| helper' page of the user guide for information regarding date handling.\n|\n*/\n$config['time_reference'] = 'local';\n\n/*\n|--------------------------------------------------------------------------\n| Reverse Proxy IPs\n|--------------------------------------------------------------------------\n|\n| If your server is behind a reverse proxy, you must whitelist the proxy\n| IP addresses from which CodeIgniter should trust headers such as\n| HTTP_X_FORWARDED_FOR and HTTP_CLIENT_IP in order to properly identify\n| the visitor's IP address.\n|\n| You can use both an array or a comma-separated list of proxy addresses,\n| as well as specifying whole subnets. Here are a few examples:\n|\n| Comma-separated:\t'10.0.1.200,192.168.5.0/24'\n| Array:\t\tarray('10.0.1.200', '192.168.5.0/24')\n*/\n$config['proxy_ips'] = '';\n" }, { "path": "application/config/constants.php", "content": "db->last_query() and profiling of DB queries.\n| \t\t\t\tWhen you run a query, with this setting set to TRUE (default),\n| \t\t\t\tCodeIgniter will store the SQL statement for debugging purposes.\n| \t\t\t\tHowever, this may cause high memory usage, especially if you run\n| \t\t\t\ta lot of SQL queries ... disable this to avoid that problem.\n|\n| The $active_group variable lets you choose which connection group to\n| make active. By default there is only one group (the 'default' group).\n*/\n$active_group = 'default';\n$db['default'] = array(\n\t'dsn'\t=> '',\n\t'hostname' => 'localhost',\n\t'username' => '',\n\t'password' => '',\n\t'database' => '',\n\t'dbdriver' => 'mysqli',\n\t'dbprefix' => '',\n\t'pconnect' => FALSE,\n\t'db_debug' => (ENVIRONMENT !== 'production'),\n\t'cache_on' => FALSE,\n\t'cachedir' => '',\n\t'char_set' => 'utf8',\n\t'dbcollat' => 'utf8_general_ci',\n\t'swap_pre' => '',\n\t'encrypt' => FALSE,\n\t'compress' => FALSE,\n\t'stricton' => FALSE,\n\t'failover' => array(),\n\t'save_queries' => TRUE\n);\n" }, { "path": "application/config/doctypes.php", "content": " '',\n\t'xhtml1-strict' => '',\n\t'xhtml1-trans' => '',\n\t'xhtml1-frame' => '',\n\t'xhtml-basic11' => '',\n\t'html5' => '',\n\t'html4-strict' => '',\n\t'html4-trans' => '',\n\t'html4-frame' => '',\n\t'mathml1' => '',\n\t'mathml2' => '',\n\t'svg10' => '',\n\t'svg11' => '',\n\t'svg11-basic' => '',\n\t'svg11-tiny' => '',\n\t'xhtml-math-svg-xh' => '',\n\t'xhtml-math-svg-sh' => '',\n\t'xhtml-rdfa-1' => '',\n\t'xhtml-rdfa-2' => ''\n);\n" }, { "path": "application/config/foreign_chars.php", "content": " 'ae',\n\t'/ö|œ/' => 'oe',\n\t'/ü/' => 'ue',\n\t'/Ä/' => 'Ae',\n\t'/Ü/' => 'Ue',\n\t'/Ö/' => 'Oe',\n\t'/À|Á|Â|Ã|Ä|Å|Ǻ|Ā|Ă|Ą|Ǎ|Α|Ά|Ả|Ạ|Ầ|Ẫ|Ẩ|Ậ|Ằ|Ắ|Ẵ|Ẳ|Ặ|А/' => 'A',\n\t'/à|á|â|ã|å|ǻ|ā|ă|ą|ǎ|ª|α|ά|ả|ạ|ầ|ấ|ẫ|ẩ|ậ|ằ|ắ|ẵ|ẳ|ặ|а/' => 'a',\n\t'/Б/' => 'B',\n\t'/б/' => 'b',\n\t'/Ç|Ć|Ĉ|Ċ|Č/' => 'C',\n\t'/ç|ć|ĉ|ċ|č/' => 'c',\n\t'/Д|Δ/' => 'D',\n\t'/д|δ/' => 'd',\n\t'/Ð|Ď|Đ/' => 'Dj',\n\t'/ð|ď|đ/' => 'dj',\n\t'/È|É|Ê|Ë|Ē|Ĕ|Ė|Ę|Ě|Ε|Έ|Ẽ|Ẻ|Ẹ|Ề|Ế|Ễ|Ể|Ệ|Е|Э/' => 'E',\n\t'/è|é|ê|ë|ē|ĕ|ė|ę|ě|έ|ε|ẽ|ẻ|ẹ|ề|ế|ễ|ể|ệ|е|э/' => 'e',\n\t'/Ф/' => 'F',\n\t'/ф/' => 'f',\n\t'/Ĝ|Ğ|Ġ|Ģ|Γ|Г|Ґ/' => 'G',\n\t'/ĝ|ğ|ġ|ģ|γ|г|ґ/' => 'g',\n\t'/Ĥ|Ħ/' => 'H',\n\t'/ĥ|ħ/' => 'h',\n\t'/Ì|Í|Î|Ï|Ĩ|Ī|Ĭ|Ǐ|Į|İ|Η|Ή|Ί|Ι|Ϊ|Ỉ|Ị|И|Ы/' => 'I',\n\t'/ì|í|î|ï|ĩ|ī|ĭ|ǐ|į|ı|η|ή|ί|ι|ϊ|ỉ|ị|и|ы|ї/' => 'i',\n\t'/Ĵ/' => 'J',\n\t'/ĵ/' => 'j',\n\t'/Θ/' => 'TH',\n\t'/θ/' => 'th',\n\t'/Ķ|Κ|К/' => 'K',\n\t'/ķ|κ|к/' => 'k',\n\t'/Ĺ|Ļ|Ľ|Ŀ|Ł|Λ|Л/' => 'L',\n\t'/ĺ|ļ|ľ|ŀ|ł|λ|л/' => 'l',\n\t'/М/' => 'M',\n\t'/м/' => 'm',\n\t'/Ñ|Ń|Ņ|Ň|Ν|Н/' => 'N',\n\t'/ñ|ń|ņ|ň|ʼn|ν|н/' => 'n',\n\t'/Ò|Ó|Ô|Õ|Ō|Ŏ|Ǒ|Ő|Ơ|Ø|Ǿ|Ο|Ό|Ω|Ώ|Ỏ|Ọ|Ồ|Ố|Ỗ|Ổ|Ộ|Ờ|Ớ|Ỡ|Ở|Ợ|О/' => 'O',\n\t'/ò|ó|ô|õ|ō|ŏ|ǒ|ő|ơ|ø|ǿ|º|ο|ό|ω|ώ|ỏ|ọ|ồ|ố|ỗ|ổ|ộ|ờ|ớ|ỡ|ở|ợ|о/' => 'o',\n\t'/П/' => 'P',\n\t'/п/' => 'p',\n\t'/Ŕ|Ŗ|Ř|Ρ|Р/' => 'R',\n\t'/ŕ|ŗ|ř|ρ|р/' => 'r',\n\t'/Ś|Ŝ|Ş|Ș|Š|Σ|С/' => 'S',\n\t'/ś|ŝ|ş|ș|š|ſ|σ|ς|с/' => 's',\n\t'/Ț|Ţ|Ť|Ŧ|Τ|Т/' => 'T',\n\t'/ț|ţ|ť|ŧ|τ|т/' => 't',\n\t'/Þ|þ/' => 'th',\n\t'/Ù|Ú|Û|Ũ|Ū|Ŭ|Ů|Ű|Ų|Ư|Ǔ|Ǖ|Ǘ|Ǚ|Ǜ|Ũ|Ủ|Ụ|Ừ|Ứ|Ữ|Ử|Ự|У/' => 'U',\n\t'/ù|ú|û|ũ|ū|ŭ|ů|ű|ų|ư|ǔ|ǖ|ǘ|ǚ|ǜ|υ|ύ|ϋ|ủ|ụ|ừ|ứ|ữ|ử|ự|у/' => 'u',\n\t'/Ƴ|Ɏ|Ỵ|Ẏ|Ӳ|Ӯ|Ў|Ý|Ÿ|Ŷ|Υ|Ύ|Ϋ|Ỳ|Ỹ|Ỷ|Ỵ|Й/' => 'Y',\n\t'/ẙ|ʏ|ƴ|ɏ|ỵ|ẏ|ӳ|ӯ|ў|ý|ÿ|ŷ|ỳ|ỹ|ỷ|ỵ|й/' => 'y',\n\t'/В/' => 'V',\n\t'/в/' => 'v',\n\t'/Ŵ/' => 'W',\n\t'/ŵ/' => 'w',\n\t'/Φ/' => 'F',\n\t'/φ/' => 'f',\n\t'/Χ/' => 'CH',\n\t'/χ/' => 'ch',\n\t'/Ź|Ż|Ž|Ζ|З/' => 'Z',\n\t'/ź|ż|ž|ζ|з/' => 'z',\n\t'/Æ|Ǽ/' => 'AE',\n\t'/ß/' => 'ss',\n\t'/IJ/' => 'IJ',\n\t'/ij/' => 'ij',\n\t'/Œ/' => 'OE',\n\t'/ƒ/' => 'f',\n\t'/Ξ/' => 'KS',\n\t'/ξ/' => 'ks',\n\t'/Π/' => 'P',\n\t'/π/' => 'p',\n\t'/Β/' => 'V',\n\t'/β/' => 'v',\n\t'/Μ/' => 'M',\n\t'/μ/' => 'm',\n\t'/Ψ/' => 'PS',\n\t'/ψ/' => 'ps',\n\t'/Ё/' => 'Yo',\n\t'/ё/' => 'yo',\n\t'/Є/' => 'Ye',\n\t'/є/' => 'ye',\n\t'/Ї/' => 'Yi',\n\t'/Ж/' => 'Zh',\n\t'/ж/' => 'zh',\n\t'/Х/' => 'Kh',\n\t'/х/' => 'kh',\n\t'/Ц/' => 'Ts',\n\t'/ц/' => 'ts',\n\t'/Ч/' => 'Ch',\n\t'/ч/' => 'ch',\n\t'/Ш/' => 'Sh',\n\t'/ш/' => 'sh',\n\t'/Щ/' => 'Shch',\n\t'/щ/' => 'shch',\n\t'/Ъ|ъ|Ь|ь/' => '',\n\t'/Ю/' => 'Yu',\n\t'/ю/' => 'yu',\n\t'/Я/' => 'Ya',\n\t'/я/' => 'ya'\n);\n" }, { "path": "application/config/hooks.php", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/config/memcached.php", "content": " array(\n\t\t'hostname' => '127.0.0.1',\n\t\t'port' => '11211',\n\t\t'weight' => '1',\n\t),\n);\n" }, { "path": "application/config/migration.php", "content": "migration->current() this is the version that schema will\n| be upgraded / downgraded to.\n|\n*/\n$config['migration_version'] = 0;\n\n/*\n|--------------------------------------------------------------------------\n| Migrations Path\n|--------------------------------------------------------------------------\n|\n| Path to your migrations folder.\n| Typically, it will be within your application path.\n| Also, writing permission is required within the migrations path.\n|\n*/\n$config['migration_path'] = APPPATH.'migrations/';\n" }, { "path": "application/config/mimes.php", "content": "\tarray('application/mac-binhex40', 'application/mac-binhex', 'application/x-binhex40', 'application/x-mac-binhex40'),\n\t'cpt'\t=>\t'application/mac-compactpro',\n\t'csv'\t=>\tarray('text/x-comma-separated-values', 'text/comma-separated-values', 'application/octet-stream', 'application/vnd.ms-excel', 'application/x-csv', 'text/x-csv', 'text/csv', 'application/csv', 'application/excel', 'application/vnd.msexcel', 'text/plain'),\n\t'bin'\t=>\tarray('application/macbinary', 'application/mac-binary', 'application/octet-stream', 'application/x-binary', 'application/x-macbinary'),\n\t'dms'\t=>\t'application/octet-stream',\n\t'lha'\t=>\t'application/octet-stream',\n\t'lzh'\t=>\t'application/octet-stream',\n\t'exe'\t=>\tarray('application/octet-stream', 'application/x-msdownload'),\n\t'class'\t=>\t'application/octet-stream',\n\t'psd'\t=>\tarray('application/x-photoshop', 'image/vnd.adobe.photoshop'),\n\t'so'\t=>\t'application/octet-stream',\n\t'sea'\t=>\t'application/octet-stream',\n\t'dll'\t=>\t'application/octet-stream',\n\t'oda'\t=>\t'application/oda',\n\t'pdf'\t=>\tarray('application/pdf', 'application/force-download', 'application/x-download', 'binary/octet-stream'),\n\t'ai'\t=>\tarray('application/pdf', 'application/postscript'),\n\t'eps'\t=>\t'application/postscript',\n\t'ps'\t=>\t'application/postscript',\n\t'smi'\t=>\t'application/smil',\n\t'smil'\t=>\t'application/smil',\n\t'mif'\t=>\t'application/vnd.mif',\n\t'xls'\t=>\tarray('application/vnd.ms-excel', 'application/msexcel', 'application/x-msexcel', 'application/x-ms-excel', 'application/x-excel', 'application/x-dos_ms_excel', 'application/xls', 'application/x-xls', 'application/excel', 'application/download', 'application/vnd.ms-office', 'application/msword'),\n\t'ppt'\t=>\tarray('application/powerpoint', 'application/vnd.ms-powerpoint', 'application/vnd.ms-office', 'application/msword'),\n\t'pptx'\t=> \tarray('application/vnd.openxmlformats-officedocument.presentationml.presentation', 'application/x-zip', 'application/zip'),\n\t'wbxml'\t=>\t'application/wbxml',\n\t'wmlc'\t=>\t'application/wmlc',\n\t'dcr'\t=>\t'application/x-director',\n\t'dir'\t=>\t'application/x-director',\n\t'dxr'\t=>\t'application/x-director',\n\t'dvi'\t=>\t'application/x-dvi',\n\t'gtar'\t=>\t'application/x-gtar',\n\t'gz'\t=>\t'application/x-gzip',\n\t'gzip' =>\t'application/x-gzip',\n\t'php'\t=>\tarray('application/x-httpd-php', 'application/php', 'application/x-php', 'text/php', 'text/x-php', 'application/x-httpd-php-source'),\n\t'php4'\t=>\t'application/x-httpd-php',\n\t'php3'\t=>\t'application/x-httpd-php',\n\t'phtml'\t=>\t'application/x-httpd-php',\n\t'phps'\t=>\t'application/x-httpd-php-source',\n\t'js'\t=>\tarray('application/x-javascript', 'text/plain'),\n\t'swf'\t=>\t'application/x-shockwave-flash',\n\t'sit'\t=>\t'application/x-stuffit',\n\t'tar'\t=>\t'application/x-tar',\n\t'tgz'\t=>\tarray('application/x-tar', 'application/x-gzip-compressed'),\n\t'z'\t=>\t'application/x-compress',\n\t'xhtml'\t=>\t'application/xhtml+xml',\n\t'xht'\t=>\t'application/xhtml+xml',\n\t'zip'\t=>\tarray('application/x-zip', 'application/zip', 'application/x-zip-compressed', 'application/s-compressed', 'multipart/x-zip'),\n\t'rar'\t=>\tarray('application/x-rar', 'application/rar', 'application/x-rar-compressed'),\n\t'mid'\t=>\t'audio/midi',\n\t'midi'\t=>\t'audio/midi',\n\t'mpga'\t=>\t'audio/mpeg',\n\t'mp2'\t=>\t'audio/mpeg',\n\t'mp3'\t=>\tarray('audio/mpeg', 'audio/mpg', 'audio/mpeg3', 'audio/mp3'),\n\t'aif'\t=>\tarray('audio/x-aiff', 'audio/aiff'),\n\t'aiff'\t=>\tarray('audio/x-aiff', 'audio/aiff'),\n\t'aifc'\t=>\t'audio/x-aiff',\n\t'ram'\t=>\t'audio/x-pn-realaudio',\n\t'rm'\t=>\t'audio/x-pn-realaudio',\n\t'rpm'\t=>\t'audio/x-pn-realaudio-plugin',\n\t'ra'\t=>\t'audio/x-realaudio',\n\t'rv'\t=>\t'video/vnd.rn-realvideo',\n\t'wav'\t=>\tarray('audio/x-wav', 'audio/wave', 'audio/wav'),\n\t'bmp'\t=>\tarray('image/bmp', 'image/x-bmp', 'image/x-bitmap', 'image/x-xbitmap', 'image/x-win-bitmap', 'image/x-windows-bmp', 'image/ms-bmp', 'image/x-ms-bmp', 'application/bmp', 'application/x-bmp', 'application/x-win-bitmap'),\n\t'gif'\t=>\t'image/gif',\n\t'jpeg'\t=>\tarray('image/jpeg', 'image/pjpeg'),\n\t'jpg'\t=>\tarray('image/jpeg', 'image/pjpeg'),\n\t'jpe'\t=>\tarray('image/jpeg', 'image/pjpeg'),\n\t'jp2'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'j2k'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'jpf'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'jpg2'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'jpx'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'jpm'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'mj2'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'mjp2'\t=>\tarray('image/jp2', 'video/mj2', 'image/jpx', 'image/jpm'),\n\t'png'\t=>\tarray('image/png', 'image/x-png'),\n\t'tiff'\t=>\t'image/tiff',\n\t'tif'\t=>\t'image/tiff',\n\t'heic' \t=>\t'image/heic',\n\t'heif' \t=>\t'image/heif',\n\t'css'\t=>\tarray('text/css', 'text/plain'),\n\t'html'\t=>\tarray('text/html', 'text/plain'),\n\t'htm'\t=>\tarray('text/html', 'text/plain'),\n\t'shtml'\t=>\tarray('text/html', 'text/plain'),\n\t'txt'\t=>\t'text/plain',\n\t'text'\t=>\t'text/plain',\n\t'log'\t=>\tarray('text/plain', 'text/x-log'),\n\t'rtx'\t=>\t'text/richtext',\n\t'rtf'\t=>\t'text/rtf',\n\t'xml'\t=>\tarray('application/xml', 'text/xml', 'text/plain'),\n\t'xsl'\t=>\tarray('application/xml', 'text/xsl', 'text/xml'),\n\t'mpeg'\t=>\t'video/mpeg',\n\t'mpg'\t=>\t'video/mpeg',\n\t'mpe'\t=>\t'video/mpeg',\n\t'qt'\t=>\t'video/quicktime',\n\t'mov'\t=>\t'video/quicktime',\n\t'avi'\t=>\tarray('video/x-msvideo', 'video/msvideo', 'video/avi', 'application/x-troff-msvideo'),\n\t'movie'\t=>\t'video/x-sgi-movie',\n\t'doc'\t=>\tarray('application/msword', 'application/vnd.ms-office'),\n\t'docx'\t=>\tarray('application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/zip', 'application/msword', 'application/x-zip'),\n\t'dot'\t=>\tarray('application/msword', 'application/vnd.ms-office'),\n\t'dotx'\t=>\tarray('application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/zip', 'application/msword'),\n\t'xlsx'\t=>\tarray('application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'application/zip', 'application/vnd.ms-excel', 'application/msword', 'application/x-zip'),\n\t'word'\t=>\tarray('application/msword', 'application/octet-stream'),\n\t'xl'\t=>\t'application/excel',\n\t'eml'\t=>\t'message/rfc822',\n\t'json' =>\tarray('application/json', 'text/json'),\n\t'pem' =>\tarray('application/x-x509-user-cert', 'application/x-pem-file', 'application/octet-stream'),\n\t'p10' =>\tarray('application/x-pkcs10', 'application/pkcs10'),\n\t'p12' =>\t'application/x-pkcs12',\n\t'p7a' =>\t'application/x-pkcs7-signature',\n\t'p7c' =>\tarray('application/pkcs7-mime', 'application/x-pkcs7-mime'),\n\t'p7m' =>\tarray('application/pkcs7-mime', 'application/x-pkcs7-mime'),\n\t'p7r' =>\t'application/x-pkcs7-certreqresp',\n\t'p7s' =>\t'application/pkcs7-signature',\n\t'crt' =>\tarray('application/x-x509-ca-cert', 'application/x-x509-user-cert', 'application/pkix-cert'),\n\t'crl' =>\tarray('application/pkix-crl', 'application/pkcs-crl'),\n\t'der' =>\t'application/x-x509-ca-cert',\n\t'kdb' =>\t'application/octet-stream',\n\t'pgp' =>\t'application/pgp',\n\t'gpg' =>\t'application/gpg-keys',\n\t'sst' =>\t'application/octet-stream',\n\t'csr' =>\t'application/octet-stream',\n\t'rsa' =>\t'application/x-pkcs7',\n\t'cer' =>\tarray('application/pkix-cert', 'application/x-x509-ca-cert'),\n\t'3g2' =>\t'video/3gpp2',\n\t'3gp' =>\tarray('video/3gp', 'video/3gpp'),\n\t'mp4' =>\t'video/mp4',\n\t'm4a' =>\t'audio/x-m4a',\n\t'f4v' =>\tarray('video/mp4', 'video/x-f4v'),\n\t'flv'\t=>\t'video/x-flv',\n\t'webm'\t=>\t'video/webm',\n\t'aac' =>\tarray('audio/x-aac', 'audio/aac'),\n\t'm4u' =>\t'application/vnd.mpegurl',\n\t'm3u' =>\t'text/plain',\n\t'xspf' =>\t'application/xspf+xml',\n\t'vlc' =>\t'application/videolan',\n\t'wmv' =>\tarray('video/x-ms-wmv', 'video/x-ms-asf'),\n\t'au' =>\t'audio/x-au',\n\t'ac3' =>\t'audio/ac3',\n\t'flac' =>\t'audio/x-flac',\n\t'ogg' =>\tarray('audio/ogg', 'video/ogg', 'application/ogg'),\n\t'kmz'\t=>\tarray('application/vnd.google-earth.kmz', 'application/zip', 'application/x-zip'),\n\t'kml'\t=>\tarray('application/vnd.google-earth.kml+xml', 'application/xml', 'text/xml'),\n\t'ics'\t=>\t'text/calendar',\n\t'ical'\t=>\t'text/calendar',\n\t'zsh'\t=>\t'text/x-scriptzsh',\n\t'7z'\t=>\tarray('application/x-7z-compressed', 'application/x-compressed', 'application/x-zip-compressed', 'application/zip', 'multipart/x-zip'),\n\t'7zip'\t=>\tarray('application/x-7z-compressed', 'application/x-compressed', 'application/x-zip-compressed', 'application/zip', 'multipart/x-zip'),\n\t'cdr'\t=>\tarray('application/cdr', 'application/coreldraw', 'application/x-cdr', 'application/x-coreldraw', 'image/cdr', 'image/x-cdr', 'zz-application/zz-winassoc-cdr'),\n\t'wma'\t=>\tarray('audio/x-ms-wma', 'video/x-ms-asf'),\n\t'jar'\t=>\tarray('application/java-archive', 'application/x-java-application', 'application/x-jar', 'application/x-compressed'),\n\t'svg'\t=>\tarray('image/svg+xml', 'image/svg', 'application/xml', 'text/xml'),\n\t'vcf'\t=>\t'text/x-vcard',\n\t'srt'\t=>\tarray('text/srt', 'text/plain'),\n\t'vtt'\t=>\tarray('text/vtt', 'text/plain'),\n\t'ico'\t=>\tarray('image/x-icon', 'image/x-ico', 'image/vnd.microsoft.icon'),\n\t'odc'\t=>\t'application/vnd.oasis.opendocument.chart',\n\t'otc'\t=>\t'application/vnd.oasis.opendocument.chart-template',\n\t'odf'\t=>\t'application/vnd.oasis.opendocument.formula',\n\t'otf'\t=>\t'application/vnd.oasis.opendocument.formula-template',\n\t'odg'\t=>\t'application/vnd.oasis.opendocument.graphics',\n\t'otg'\t=>\t'application/vnd.oasis.opendocument.graphics-template',\n\t'odi'\t=>\t'application/vnd.oasis.opendocument.image',\n\t'oti'\t=>\t'application/vnd.oasis.opendocument.image-template',\n\t'odp'\t=>\t'application/vnd.oasis.opendocument.presentation',\n\t'otp'\t=>\t'application/vnd.oasis.opendocument.presentation-template',\n\t'ods'\t=>\t'application/vnd.oasis.opendocument.spreadsheet',\n\t'ots'\t=>\t'application/vnd.oasis.opendocument.spreadsheet-template',\n\t'odt'\t=>\t'application/vnd.oasis.opendocument.text',\n\t'odm'\t=>\t'application/vnd.oasis.opendocument.text-master',\n\t'ott'\t=>\t'application/vnd.oasis.opendocument.text-template',\n\t'oth'\t=>\t'application/vnd.oasis.opendocument.text-web'\n);\n" }, { "path": "application/config/profiler.php", "content": " my_controller/index\n|\t\tmy-controller/my-method\t-> my_controller/my_method\n*/\n$route['default_controller'] = 'welcome';\n$route['404_override'] = '';\n$route['translate_uri_dashes'] = FALSE;\n" }, { "path": "application/config/user_agents.php", "content": " 'Windows 10',\n\t'windows nt 6.3'\t=> 'Windows 8.1',\n\t'windows nt 6.2'\t=> 'Windows 8',\n\t'windows nt 6.1'\t=> 'Windows 7',\n\t'windows nt 6.0'\t=> 'Windows Vista',\n\t'windows nt 5.2'\t=> 'Windows 2003',\n\t'windows nt 5.1'\t=> 'Windows XP',\n\t'windows nt 5.0'\t=> 'Windows 2000',\n\t'windows nt 4.0'\t=> 'Windows NT 4.0',\n\t'winnt4.0'\t\t\t=> 'Windows NT 4.0',\n\t'winnt 4.0'\t\t\t=> 'Windows NT',\n\t'winnt'\t\t\t\t=> 'Windows NT',\n\t'windows 98'\t\t=> 'Windows 98',\n\t'win98'\t\t\t\t=> 'Windows 98',\n\t'windows 95'\t\t=> 'Windows 95',\n\t'win95'\t\t\t\t=> 'Windows 95',\n\t'windows phone'\t\t\t=> 'Windows Phone',\n\t'windows'\t\t\t=> 'Unknown Windows OS',\n\t'android'\t\t\t=> 'Android',\n\t'blackberry'\t\t=> 'BlackBerry',\n\t'iphone'\t\t\t=> 'iOS',\n\t'ipad'\t\t\t\t=> 'iOS',\n\t'ipod'\t\t\t\t=> 'iOS',\n\t'os x'\t\t\t\t=> 'Mac OS X',\n\t'ppc mac'\t\t\t=> 'Power PC Mac',\n\t'freebsd'\t\t\t=> 'FreeBSD',\n\t'ppc'\t\t\t\t=> 'Macintosh',\n\t'linux'\t\t\t\t=> 'Linux',\n\t'debian'\t\t\t=> 'Debian',\n\t'sunos'\t\t\t\t=> 'Sun Solaris',\n\t'beos'\t\t\t\t=> 'BeOS',\n\t'apachebench'\t\t=> 'ApacheBench',\n\t'aix'\t\t\t\t=> 'AIX',\n\t'irix'\t\t\t\t=> 'Irix',\n\t'osf'\t\t\t\t=> 'DEC OSF',\n\t'hp-ux'\t\t\t\t=> 'HP-UX',\n\t'netbsd'\t\t\t=> 'NetBSD',\n\t'bsdi'\t\t\t\t=> 'BSDi',\n\t'openbsd'\t\t\t=> 'OpenBSD',\n\t'gnu'\t\t\t\t=> 'GNU/Linux',\n\t'unix'\t\t\t\t=> 'Unknown Unix OS',\n\t'symbian' \t\t\t=> 'Symbian OS'\n);\n\n\n// The order of this array should NOT be changed. Many browsers return\n// multiple browser types so we want to identify the sub-type first.\n$browsers = array(\n\t'OPR'\t\t\t=> 'Opera',\n\t'Flock'\t\t\t=> 'Flock',\n\t'Edge'\t\t\t=> 'Edge',\n\t'Chrome'\t\t=> 'Chrome',\n\t// Opera 10+ always reports Opera/9.80 and appends Version/ to the user agent string\n\t'Opera.*?Version'\t=> 'Opera',\n\t'Opera'\t\t\t=> 'Opera',\n\t'MSIE'\t\t\t=> 'Internet Explorer',\n\t'Internet Explorer'\t=> 'Internet Explorer',\n\t'Trident.* rv'\t=> 'Internet Explorer',\n\t'Shiira'\t\t=> 'Shiira',\n\t'Firefox'\t\t=> 'Firefox',\n\t'Chimera'\t\t=> 'Chimera',\n\t'Phoenix'\t\t=> 'Phoenix',\n\t'Firebird'\t\t=> 'Firebird',\n\t'Camino'\t\t=> 'Camino',\n\t'Netscape'\t\t=> 'Netscape',\n\t'OmniWeb'\t\t=> 'OmniWeb',\n\t'Safari'\t\t=> 'Safari',\n\t'Mozilla'\t\t=> 'Mozilla',\n\t'Konqueror'\t\t=> 'Konqueror',\n\t'icab'\t\t\t=> 'iCab',\n\t'Lynx'\t\t\t=> 'Lynx',\n\t'Links'\t\t\t=> 'Links',\n\t'hotjava'\t\t=> 'HotJava',\n\t'amaya'\t\t\t=> 'Amaya',\n\t'IBrowse'\t\t=> 'IBrowse',\n\t'Maxthon'\t\t=> 'Maxthon',\n\t'Ubuntu'\t\t=> 'Ubuntu Web Browser',\n\t'Vivaldi'\t\t=> 'Vivaldi'\n);\n\n$mobiles = array(\n\t// legacy array, old values commented out\n\t'mobileexplorer'\t=> 'Mobile Explorer',\n// 'openwave'\t\t\t=> 'Open Wave',\n//\t'opera mini'\t\t=> 'Opera Mini',\n//\t'operamini'\t\t\t=> 'Opera Mini',\n//\t'elaine'\t\t\t=> 'Palm',\n\t'palmsource'\t\t=> 'Palm',\n//\t'digital paths'\t\t=> 'Palm',\n//\t'avantgo'\t\t\t=> 'Avantgo',\n//\t'xiino'\t\t\t\t=> 'Xiino',\n\t'palmscape'\t\t\t=> 'Palmscape',\n//\t'nokia'\t\t\t\t=> 'Nokia',\n//\t'ericsson'\t\t\t=> 'Ericsson',\n//\t'blackberry'\t\t=> 'BlackBerry',\n//\t'motorola'\t\t\t=> 'Motorola'\n\n\t// Phones and Manufacturers\n\t'motorola'\t\t=> 'Motorola',\n\t'nokia'\t\t\t=> 'Nokia',\n\t'nexus'\t\t\t=> 'Nexus',\n\t'palm'\t\t\t=> 'Palm',\n\t'iphone'\t\t=> 'Apple iPhone',\n\t'ipad'\t\t\t=> 'iPad',\n\t'ipod'\t\t\t=> 'Apple iPod Touch',\n\t'sony'\t\t\t=> 'Sony Ericsson',\n\t'ericsson'\t\t=> 'Sony Ericsson',\n\t'blackberry'\t=> 'BlackBerry',\n\t'cocoon'\t\t=> 'O2 Cocoon',\n\t'blazer'\t\t=> 'Treo',\n\t'lg'\t\t\t=> 'LG',\n\t'amoi'\t\t\t=> 'Amoi',\n\t'xda'\t\t\t=> 'XDA',\n\t'mda'\t\t\t=> 'MDA',\n\t'vario'\t\t\t=> 'Vario',\n\t'htc'\t\t\t=> 'HTC',\n\t'samsung'\t\t=> 'Samsung',\n\t'sharp'\t\t\t=> 'Sharp',\n\t'sie-'\t\t\t=> 'Siemens',\n\t'alcatel'\t\t=> 'Alcatel',\n\t'benq'\t\t\t=> 'BenQ',\n\t'ipaq'\t\t\t=> 'HP iPaq',\n\t'mot-'\t\t\t=> 'Motorola',\n\t'playstation portable'\t=> 'PlayStation Portable',\n\t'playstation 3'\t\t=> 'PlayStation 3',\n\t'playstation vita' \t=> 'PlayStation Vita',\n\t'hiptop'\t\t=> 'Danger Hiptop',\n\t'nec-'\t\t\t=> 'NEC',\n\t'panasonic'\t\t=> 'Panasonic',\n\t'philips'\t\t=> 'Philips',\n\t'sagem'\t\t\t=> 'Sagem',\n\t'sanyo'\t\t\t=> 'Sanyo',\n\t'spv'\t\t\t=> 'SPV',\n\t'zte'\t\t\t=> 'ZTE',\n\t'sendo'\t\t\t=> 'Sendo',\n\t'nintendo dsi'\t=> 'Nintendo DSi',\n\t'nintendo ds'\t=> 'Nintendo DS',\n\t'nintendo 3ds'\t=> 'Nintendo 3DS',\n\t'wii'\t\t\t=> 'Nintendo Wii',\n\t'open web'\t\t=> 'Open Web',\n\t'openweb'\t\t=> 'OpenWeb',\n\t'meizu' => 'Meizu',\n\t'huawei' => 'Huawei',\n\t'xiaomi' => 'Xiaomi',\n\t'oppo' => 'Oppo',\n\t'vivo' => 'Vivo',\n\t'infinix' => 'Infinix',\n\n\t// Operating Systems\n\t'android'\t\t=> 'Android',\n\t'symbian'\t\t=> 'Symbian',\n\t'SymbianOS'\t\t=> 'SymbianOS',\n\t'elaine'\t\t=> 'Palm',\n\t'series60'\t\t=> 'Symbian S60',\n\t'windows ce'\t=> 'Windows CE',\n\n\t// Browsers\n\t'obigo'\t\t\t=> 'Obigo',\n\t'netfront'\t\t=> 'Netfront Browser',\n\t'openwave'\t\t=> 'Openwave Browser',\n\t'mobilexplorer'\t=> 'Mobile Explorer',\n\t'operamini'\t\t=> 'Opera Mini',\n\t'opera mini'\t=> 'Opera Mini',\n\t'opera mobi'\t=> 'Opera Mobile',\n\t'fennec'\t\t=> 'Firefox Mobile',\n\n\t// Other\n\t'digital paths'\t=> 'Digital Paths',\n\t'avantgo'\t\t=> 'AvantGo',\n\t'xiino'\t\t\t=> 'Xiino',\n\t'novarra'\t\t=> 'Novarra Transcoder',\n\t'vodafone'\t\t=> 'Vodafone',\n\t'docomo'\t\t=> 'NTT DoCoMo',\n\t'o2'\t\t\t=> 'O2',\n\n\t// Fallback\n\t'mobile'\t\t=> 'Generic Mobile',\n\t'wireless'\t\t=> 'Generic Mobile',\n\t'j2me'\t\t\t=> 'Generic Mobile',\n\t'midp'\t\t\t=> 'Generic Mobile',\n\t'cldc'\t\t\t=> 'Generic Mobile',\n\t'up.link'\t\t=> 'Generic Mobile',\n\t'up.browser'\t=> 'Generic Mobile',\n\t'smartphone'\t=> 'Generic Mobile',\n\t'cellphone'\t\t=> 'Generic Mobile'\n);\n\n// There are hundreds of bots but these are the most common.\n$robots = array(\n\t'googlebot'\t\t=> 'Googlebot',\n\t'msnbot'\t\t=> 'MSNBot',\n\t'baiduspider'\t\t=> 'Baiduspider',\n\t'bingbot'\t\t=> 'Bing',\n\t'slurp'\t\t\t=> 'Inktomi Slurp',\n\t'yahoo'\t\t\t=> 'Yahoo',\n\t'ask jeeves'\t\t=> 'Ask Jeeves',\n\t'fastcrawler'\t\t=> 'FastCrawler',\n\t'infoseek'\t\t=> 'InfoSeek Robot 1.0',\n\t'lycos'\t\t\t=> 'Lycos',\n\t'yandex'\t\t=> 'YandexBot',\n\t'mediapartners-google'\t=> 'MediaPartners Google',\n\t'CRAZYWEBCRAWLER'\t=> 'Crazy Webcrawler',\n\t'adsbot-google'\t\t=> 'AdsBot Google',\n\t'feedfetcher-google'\t=> 'Feedfetcher Google',\n\t'curious george'\t=> 'Curious George',\n\t'ia_archiver'\t\t=> 'Alexa Crawler',\n\t'MJ12bot'\t\t=> 'Majestic-12',\n\t'Uptimebot'\t\t=> 'Uptimebot',\n\t'UptimeRobot'\t\t=> 'UptimeRobot'\n);\n" }, { "path": "application/controllers/Welcome.php", "content": "\n\t * @see https://codeigniter.com/userguide3/general/urls.html\n\t */\n\tpublic function index()\n\t{\n\t\t$this->load->view('welcome_message');\n\t}\n}\n" }, { "path": "application/controllers/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/core/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/helpers/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/hooks/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/language/english/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/language/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/libraries/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/logs/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/models/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/third_party/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/views/errors/cli/error_404.php", "content": "\n\nAn uncaught Exception was encountered\n\nType: \nMessage: \nFilename: getFile(), \"\\n\"; ?>\nLine Number: getLine(); ?>\n\n\n\nBacktrace:\ngetTrace() as $error): ?>\n\n\tFile: \n\tLine: \n\tFunction: \n\n\n\n\n" }, { "path": "application/views/errors/cli/error_general.php", "content": "\n\nA PHP Error was encountered\n\nSeverity: \nMessage: \nFilename: \nLine Number: \n\n\n\nBacktrace:\n\n\n\tFile: \n\tLine: \n\tFunction: \n\n\n\n\n" }, { "path": "application/views/errors/cli/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/views/errors/html/error_404.php", "content": "\n\n\n\t\n\t404 Page Not Found\n\t\n\n\n\t
\n\t\t

\n\t\t
\n\t\t\t\n\t\t
\n\t
\n\n\n" }, { "path": "application/views/errors/html/error_db.php", "content": "\n\n\n\t\n\tDatabase Error\n\t\n\n\n\t
\n\t\t

\n\t\t
\n\t\t\t\n\t\t
\n\t
\n\n\n" }, { "path": "application/views/errors/html/error_exception.php", "content": "\n\n
\n\n\t

An uncaught Exception was encountered

\n\n\t

Type:

\n\t

Message:

\n\t

Filename: getFile(); ?>

\n\t

Line Number: getLine(); ?>

\n\n\t\n\n\t\t

Backtrace:

\n\t\tgetTrace() as $error): ?>\n\n\t\t\t\n\n\t\t\t\t

\n\t\t\t\tFile:
\n\t\t\t\tLine:
\n\t\t\t\tFunction: \n\t\t\t\t

\n\t\t\t\n\n\t\t\n\n\t\n\n
\n" }, { "path": "application/views/errors/html/error_general.php", "content": "\n\n\n\t\n\tError\n\t\n\n\n\t
\n\t\t

\n\t\t
\n\t\t\t\n\t\t
\n\t
\n\n\n" }, { "path": "application/views/errors/html/error_php.php", "content": "\n\n
\n\n\t

A PHP Error was encountered

\n\n\t

Severity:

\n\t

Message:

\n\t

Filename:

\n\t

Line Number:

\n\n\t\n\n\t\t

Backtrace:

\n\t\t\n\n\t\t\t\n\n\t\t\t\t

\n\t\t\t\tFile:
\n\t\t\t\tLine:
\n\t\t\t\tFunction: \n\t\t\t\t

\n\n\t\t\t\n\n\t\t\n\n\t\n\n
\n" }, { "path": "application/views/errors/html/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/views/errors/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/views/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "application/views/welcome_message.php", "content": "\n\n\n\t\n\tWelcome to CodeIgniter\n\n\t\n\n\n\t
\n\t\t

\n\t\t\t\"CodeIgniter\"\n\t\t

\n\n\t\t
\n\t\t\t

The page you are looking at is being generated dynamically by CodeIgniter.

\n\n\t\t\t

If you would like to edit this page you'll find it located at:

\n\t\t\tapplication/views/welcome_message.php\n\n\t\t\t

The corresponding controller for this page is found at:

\n\t\t\tapplication/controllers/Welcome.php\n\n\t\t\t

If you are exploring CodeIgniter for the very first time, you should start by reading the User Guide.

\n\t\t
\n\n\t\t

Page rendered in {elapsed_time} seconds. ' . CI_VERSION . '' : '' ?>

\n\t
\n\n\n" }, { "path": "build-release.sh", "content": "#!/usr/bin/env bash\n\ncd $(dirname $BASH_SOURCE)\n\nif [ $# -eq 0 ]; then\n\techo 'Usage: '$BASH_SOURCE' '\n\texit 1\nfi\n\nversion_number=$1\n\nif [ ${#version_number} -lt 5 ]\nthen\n\techo \"Provided version number is too short\"\n\texit 1\nelif [ ${version_number: -4} == \"-dev\" ]\nthen\n\techo \"'-dev' releases are not allowed\"\n\texit 1\nfi\n\nversion_id=${version_number:0:5}\nversion_id=${version_id//./}\nupgrade_rst='user_guide_src/source/installation/upgrade_'$version_id'.rst'\n\nif [ ${#version_id} -ne 3 ]\nthen\n\techo \"Invalid version number format\"\n\texit 1\nelif [ `grep -c -F --regexp=\"'$version_number'\" system/core/CodeIgniter.php` -ne 1 ]\nthen\n\techo \"Provided version number doesn't match in system/core/CodeIgniter.php\"\n\texit 1\nelif [ `grep -c -F --regexp=\"'$version_number'\" user_guide_src/source/conf.py` -ne 2 ]\nthen\n\techo \"Provided version number doesn't match in user_guide_src/source/conf.py\"\n\texit 1\nelif [ `grep -c -F --regexp=\"$version_number (Current version) \" user_guide_src/source/installation/downloads.rst` -ne 1 ]\nthen\n\techo \"user_guide_src/source/installation/downloads.rst doesn't appear to contain a link for this version\"\n\texit 1\nelif [ ! -f \"$upgrade_rst\" ]\nthen\n\techo \"${upgrade_rst} doesn't exist\"\n\texit 1\nfi\n\necho \"Running tests ...\"\n\nphp -d zend.enable_gc=0 -d date.timezone=UTC -d mbstring.func_overload=7 -d mbstring.internal_encoding=UTF-8 vendor/bin/phpunit --coverage-text --configuration tests/travis/sqlite.phpunit.xml\n\nif [ $? -ne 0 ]\nthen\n\techo \"Build FAILED!\"\n\texit 1\nfi\n\ncd user_guide_src/\n\necho \"\"\necho \"Building HTML docs; please check output for warnings ...\"\necho \"\"\n\nmake html\n\necho \"\"\n\nif [ $? -ne 0 ]\nthen\n\techo \"Build FAILED!\"\n\texit 1\nfi\n\ncd ..\n\nif [ -d user_guide/ ]\nthen\n\trm -r user_guide/\nfi\n\ncp -r user_guide_src/build/html/ user_guide/\ngit add user_guide/\n\necho \"Build complete.\"\n" }, { "path": "composer.json", "content": "{\n\t\"description\": \"The CodeIgniter framework\",\n\t\"name\": \"codeigniter/framework\",\n\t\"type\": \"project\",\n\t\"homepage\": \"https://codeigniter.com\",\n\t\"license\": \"MIT\",\n\t\"support\": {\n\t\t\"forum\": \"https://forum.codeigniter.com/\",\n\t\t\"wiki\": \"https://github.com/bcit-ci/CodeIgniter/wiki\",\n\t\t\"slack\": \"https://codeigniterchat.slack.com\",\n\t\t\"source\": \"https://github.com/bcit-ci/CodeIgniter\"\n\t},\n\t\"require\": {\n\t\t\"php\": \">=5.4.8\"\n\t},\n\t\"suggest\": {\n\t\t\"paragonie/random_compat\": \"Provides better randomness in PHP 5.x\"\n\t},\n\t\"scripts\": {\n\t\t\"test:coverage\": [\n\t\t\t\"@putenv XDEBUG_MODE=coverage\",\n\t\t\t\"phpunit --color=always --coverage-text --configuration tests/travis/sqlite.phpunit.xml\"\n\t\t],\n\t\t\"post-install-cmd\": [\n\t\t\t\"sed -i s/name{0}/name[0]/ vendor/mikey179/vfsstream/src/main/php/org/bovigo/vfs/vfsStream.php\"\n\t\t],\n\t\t\"post-update-cmd\": [\n\t\t\t\"sed -i s/name{0}/name[0]/ vendor/mikey179/vfsstream/src/main/php/org/bovigo/vfs/vfsStream.php\"\n\t\t]\n\t},\n\t\"require-dev\": {\n\t\t\"mikey179/vfsstream\": \"1.6.*\",\n\t\t\"phpunit/phpunit\": \"4.* || 5.* || 9.*\"\n\t}\n}\n" }, { "path": "contributing.md", "content": "# Contributing to CodeIgniter\n\nCodeIgniter is a community driven project and accepts contributions of code and documentation from the community. These contributions are made in the form of Issues or [Pull Requests](http://help.github.com/send-pull-requests/) on the [CodeIgniter repository](https://github.com/bcit-ci/CodeIgniter) on GitHub.\n\nIssues are a quick way to point out a bug. If you find a bug or documentation error in CodeIgniter then please check a few things first:\n\n1. There is not already an open Issue\n2. The issue has already been fixed (check the develop branch, or look for closed Issues)\n3. Is it something really obvious that you can fix yourself?\n\nReporting issues is helpful but an even better approach is to send a Pull Request, which is done by \"Forking\" the main repository and committing to your own copy. This will require you to use the version control system called Git.\n\n## Guidelines\n\nBefore we look into how, here are the guidelines. If your Pull Requests fail\nto pass these guidelines it will be declined and you will need to re-submit\nwhen you’ve made the changes. This might sound a bit tough, but it is required\nfor us to maintain quality of the code-base.\n\n### PHP Style\n\nAll code must meet the [Style Guide](https://codeigniter.com/userguide3/general/styleguide.html), which is\nessentially the [Allman indent style](https://en.wikipedia.org/wiki/Indent_style#Allman_style), underscores and readable operators. This makes certain that all code is the same format as the existing code and means it will be as readable as possible.\n\n### Documentation\n\nIf you change anything that requires a change to documentation then you will need to add it. New classes, methods, parameters, changing default values, etc are all things that will require a change to documentation. The change-log must also be updated for every change. Also PHPDoc blocks must be maintained.\n\n### Compatibility\n\nCodeIgniter recommends PHP 5.5 or newer to be used, but it should be\ncompatible with PHP 5.2.4 so all code supplied must stick to this\nrequirement. If PHP 5.3 (and above) functions or features are used then\nthere must be a fallback for PHP 5.2.4.\n\n### Branching\n\nCodeIgniter uses the [Git-Flow](https://nvie.com/posts/a-successful-git-branching-model/) branching model which requires all pull requests to be sent to the \"develop\" branch. This is\nwhere the next planned version will be developed. The \"master\" branch will always contain the latest stable version and is kept clean so a \"hotfix\" (e.g: an emergency security patch) can be applied to master to create a new version, without worrying about other features holding it up. For this reason all commits need to be made to \"develop\" and any sent to \"master\" will be closed automatically. If you have multiple changes to submit, please place all changes into their own branch on your fork.\n\nOne thing at a time: A pull request should only contain one change. That does not mean only one commit, but one change - however many commits it took. The reason for this is that if you change X and Y but send a pull request for both at the same time, we might really want X but disagree with Y, meaning we cannot merge the request. Using the Git-Flow branching model you can create new branches for both of these features and send two requests.\n\n### Signing\n\nYou must sign your work, certifying that you either wrote the work or otherwise have the right to pass it on to an open source project. git makes this trivial as you merely have to use `--signoff` on your commits to your CodeIgniter fork.\n\n`git commit --signoff`\n\nor simply\n\n`git commit -s`\n\nThis will sign your commits with the information setup in your git config, e.g.\n\n`Signed-off-by: John Q Public `\n\nIf you are using [Tower](https://www.git-tower.com/) there is a \"Sign-Off\" checkbox in the commit window. You could even alias git commit to use the `-s` flag so you don’t have to think about it.\n\nBy signing your work in this manner, you certify to a \"Developer's Certificate of Origin\". The current version of this certificate is in the `DCO.txt` file in the root of this repository.\n\n## How-to Guide\n\nThere are two ways to make changes, the easy way and the hard way. Either way you will need to [create a GitHub account](https://github.com/signup/free).\n\nEasy way GitHub allows in-line editing of files for making simple typo changes and quick-fixes. This is not the best way as you are unable to test the code works. If you do this you could be introducing syntax errors, etc, but for a Git-phobic user this is good for a quick-fix.\n\nHard way The best way to contribute is to \"clone\" your fork of CodeIgniter to your development area. That sounds like some jargon, but \"forking\" on GitHub means \"making a copy of that repo to your account\" and \"cloning\" means \"copying that code to your environment so you can work on it\".\n\n1. [Set up Git](https://help.github.com/en/articles/set-up-git) (Windows, Mac & Linux)\n2. Go to the [CodeIgniter repo](https://github.com/bcit-ci/CodeIgniter)\n3. [Fork it](https://help.github.com/en/articles/fork-a-repo)\n4. [Clone](https://help.github.com/en/articles/fetching-a-remote#clone) your forked CodeIgniter repo: git@github.com:/CodeIgniter.git.\n5. Checkout the \"develop\" branch. At this point you are ready to start making changes.\n6. Fix existing bugs on the Issue tracker after taking a look to see nobody else is working on them.\n7. [Commit](https://help.github.com/en/articles/adding-a-file-to-a-repository-using-the-command-line) the files\n8. [Push](https://help.github.com/en/articles/pushing-to-a-remote) your develop branch to your fork\n9. [Send a pull request](https://help.github.com/en/articles/creating-a-pull-request)\n\nThe Reactor Engineers will now be alerted about the change and at least one of the team will respond. If your change fails to meet the guidelines it will be bounced, or feedback will be provided to help you improve it.\n\nOnce the Reactor Engineer handling your pull request is happy with it they will merge it into develop and your patch will be part of the next release.\n\n### Keeping your fork up-to-date\n\nUnlike systems like Subversion, Git can have multiple remotes. A remote is the name for a URL of a Git repository. By default your fork will have a remote named \"origin\" which points to your fork, but you can add another remote named \"codeigniter\" which points to `git://github.com/bcit-ci/CodeIgniter.git`. This is a read-only remote but you can pull from this develop branch to update your own.\n\nIf you are using command-line you can do the following:\n\n1. `git remote add codeigniter git://github.com/bcit-ci/CodeIgniter.git`\n2. `git pull codeigniter develop`\n3. `git push origin develop`\n\nNow your fork is up to date. This should be done regularly, or before you send a pull request at least.\n" }, { "path": "index.php", "content": "\n\n\tCodeIgniter v3.0.0 API\n \n ./api/\n \n \n ./api/\n \n \n ./system\n \n\n \n warn\n \n ./api/log/{DATE}.log\n ./api/{DATE}.errors.log\n \n \n" }, { "path": "readme.rst", "content": "###################\nWhat is CodeIgniter\n###################\n\nCodeIgniter is an Application Development Framework - a toolkit - for people\nwho build web sites using PHP. Its goal is to enable you to develop projects\nmuch faster than you could if you were writing code from scratch, by providing\na rich set of libraries for commonly needed tasks, as well as a simple\ninterface and logical structure to access these libraries. CodeIgniter lets\nyou creatively focus on your project by minimizing the amount of code needed\nfor a given task.\n\n*************\nCodeIgniter 3\n*************\n\nThis repository is for the legacy version, CodeIgniter 3.\n`CodeIgniter 4 `_ is the latest\nversion of the framework.\n\nCodeIgniter 3 is the legacy version of the framework, intended for use with PHP\n5.6+. This version is in maintenance, receiving mostly just security updates.\n\n*******************\nRelease Information\n*******************\n\nThis repo contains in-development code for future releases. To download the\nlatest stable release please visit the `CodeIgniter Downloads\n`_ page.\n\n**************************\nChangelog and New Features\n**************************\n\nYou can find a list of all changes for each release in the `user\nguide change log `_.\n\n*******************\nServer Requirements\n*******************\n\nPHP version 5.6 or newer is recommended.\n\nIt should work on 5.4.8 as well, but we strongly advise you NOT to run\nsuch old versions of PHP, because of potential security and performance\nissues, as well as missing features.\n\n************\nInstallation\n************\n\nPlease see the `installation section `_\nof the CodeIgniter User Guide.\n\n*******\nLicense\n*******\n\nPlease see the `license\nagreement `_.\n\n*********\nResources\n*********\n\n- `User Guide `_\n- `Contributing Guide `_\n- `Language File Translations `_\n- `Community Forums `_\n- `Community Wiki `_\n- `Community Slack Channel `_\n\nReport security issues to our `Security Panel `_\nor via our `page on HackerOne `_, thank you.\n\n***************\nAcknowledgement\n***************\n\nThe CodeIgniter team would like to thank EllisLab, all the\ncontributors to the CodeIgniter project and you, the CodeIgniter user.\n" }, { "path": "system/.htaccess", "content": "\n\tRequire all denied\n\n\n\tDeny from all\n" }, { "path": "system/core/Benchmark.php", "content": "marker[$name] = microtime(TRUE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Elapsed time\n\t *\n\t * Calculates the time difference between two marked points.\n\t *\n\t * If the first parameter is empty this function instead returns the\n\t * {elapsed_time} pseudo-variable. This permits the full system\n\t * execution time to be shown in a template. The output class will\n\t * swap the real value for this variable.\n\t *\n\t * @param\tstring\t$point1\t\tA particular marked point\n\t * @param\tstring\t$point2\t\tA particular marked point\n\t * @param\tint\t$decimals\tNumber of decimal places\n\t *\n\t * @return\tstring\tCalculated elapsed time on success,\n\t *\t\t\tan '{elapsed_string}' if $point1 is empty\n\t *\t\t\tor an empty string if $point1 is not found.\n\t */\n\tpublic function elapsed_time($point1 = '', $point2 = '', $decimals = 4)\n\t{\n\t\tif ($point1 === '')\n\t\t{\n\t\t\treturn '{elapsed_time}';\n\t\t}\n\n\t\tif ( ! isset($this->marker[$point1]))\n\t\t{\n\t\t\treturn '';\n\t\t}\n\n\t\tif ( ! isset($this->marker[$point2]))\n\t\t{\n\t\t\t$this->marker[$point2] = microtime(TRUE);\n\t\t}\n\n\t\treturn number_format($this->marker[$point2] - $this->marker[$point1], $decimals);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Memory Usage\n\t *\n\t * Simply returns the {memory_usage} marker.\n\t *\n\t * This permits it to be put it anywhere in a template\n\t * without the memory being calculated until the end.\n\t * The output class will swap the real value for this variable.\n\t *\n\t * @return\tstring\t'{memory_usage}'\n\t */\n\tpublic function memory_usage()\n\t{\n\t\treturn '{memory_usage}';\n\t}\n\n}\n" }, { "path": "system/core/CodeIgniter.php", "content": " $assign_to_config['subclass_prefix']));\n\t}\n\n/*\n * ------------------------------------------------------\n * Should we use a Composer autoloader?\n * ------------------------------------------------------\n */\n\tif ($composer_autoload = config_item('composer_autoload'))\n\t{\n\t\tif ($composer_autoload === TRUE)\n\t\t{\n\t\t\tfile_exists(APPPATH.'vendor/autoload.php')\n\t\t\t\t? require_once(APPPATH.'vendor/autoload.php')\n\t\t\t\t: log_message('error', '$config[\\'composer_autoload\\'] is set to TRUE but '.APPPATH.'vendor/autoload.php was not found.');\n\t\t}\n\t\telseif (file_exists($composer_autoload))\n\t\t{\n\t\t\trequire_once($composer_autoload);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tlog_message('error', 'Could not find the specified $config[\\'composer_autoload\\'] path: '.$composer_autoload);\n\t\t}\n\t}\n\n/*\n * ------------------------------------------------------\n * Start the timer... tick tock tick tock...\n * ------------------------------------------------------\n */\n\t$BM =& load_class('Benchmark', 'core');\n\t$BM->mark('total_execution_time_start');\n\t$BM->mark('loading_time:_base_classes_start');\n\n/*\n * ------------------------------------------------------\n * Instantiate the config class\n * ------------------------------------------------------\n *\n * Note: It is important that Config is loaded first as\n * most other classes depend on it either directly or by\n * depending on another class that uses it.\n *\n */\n\t$CFG =& load_class('Config', 'core');\n\n\t// Do we have any manually set config items in the index.php file?\n\tif (isset($assign_to_config) && is_array($assign_to_config))\n\t{\n\t\tforeach ($assign_to_config as $key => $value)\n\t\t{\n\t\t\t$CFG->set_item($key, $value);\n\t\t}\n\t}\n\n/*\n * ------------------------------------------------------\n * Instantiate the hooks class\n * ------------------------------------------------------\n */\n\t$EXT =& load_class('Hooks', 'core', $CFG);\n\n/*\n * ------------------------------------------------------\n * Is there a \"pre_system\" hook?\n * ------------------------------------------------------\n */\n\t$EXT->call_hook('pre_system');\n\n/*\n * ------------------------------------------------------\n * Important charset-related stuff\n * ------------------------------------------------------\n *\n * Configure mbstring and/or iconv if they are enabled\n * and set MB_ENABLED and ICONV_ENABLED constants, so\n * that we don't repeatedly do extension_loaded() or\n * function_exists() calls.\n *\n * Note: UTF-8 class depends on this. It used to be done\n * in it's constructor, but it's _not_ class-specific.\n *\n */\n\t$charset = strtoupper(config_item('charset'));\n\tini_set('default_charset', $charset);\n\n\tif (extension_loaded('mbstring'))\n\t{\n\t\tdefine('MB_ENABLED', TRUE);\n\t\t// mbstring.internal_encoding is deprecated starting with PHP 5.6\n\t\t// and it's usage triggers E_DEPRECATED messages.\n\t\t@ini_set('mbstring.internal_encoding', $charset);\n\t\t// This is required for mb_convert_encoding() to strip invalid characters.\n\t\t// That's utilized by CI_Utf8, but it's also done for consistency with iconv.\n\t\tmb_substitute_character('none');\n\t}\n\telse\n\t{\n\t\tdefine('MB_ENABLED', FALSE);\n\t}\n\n\t// There's an ICONV_IMPL constant, but the PHP manual says that using\n\t// iconv's predefined constants is \"strongly discouraged\".\n\tif (extension_loaded('iconv'))\n\t{\n\t\tdefine('ICONV_ENABLED', TRUE);\n\t\t// iconv.internal_encoding is deprecated starting with PHP 5.6\n\t\t// and it's usage triggers E_DEPRECATED messages.\n\t\t@ini_set('iconv.internal_encoding', $charset);\n\t}\n\telse\n\t{\n\t\tdefine('ICONV_ENABLED', FALSE);\n\t}\n\n\tif (is_php('5.6'))\n\t{\n\t\tini_set('php.internal_encoding', $charset);\n\t}\n\n/*\n * ------------------------------------------------------\n * Load compatibility features\n * ------------------------------------------------------\n */\n\n\trequire_once(BASEPATH.'core/compat/mbstring.php');\n\trequire_once(BASEPATH.'core/compat/hash.php');\n\trequire_once(BASEPATH.'core/compat/password.php');\n\trequire_once(BASEPATH.'core/compat/standard.php');\n\n/*\n * ------------------------------------------------------\n * Instantiate the UTF-8 class\n * ------------------------------------------------------\n */\n\t$UNI =& load_class('Utf8', 'core', $charset);\n\n/*\n * ------------------------------------------------------\n * Instantiate the URI class\n * ------------------------------------------------------\n */\n\t$URI =& load_class('URI', 'core', $CFG);\n\n/*\n * ------------------------------------------------------\n * Instantiate the routing class and set the routing\n * ------------------------------------------------------\n */\n\t$RTR =& load_class('Router', 'core', isset($routing) ? $routing : NULL);\n\n/*\n * ------------------------------------------------------\n * Instantiate the output class\n * ------------------------------------------------------\n */\n\t$OUT =& load_class('Output', 'core');\n\n/*\n * ------------------------------------------------------\n *\tIs there a valid cache file? If so, we're done...\n * ------------------------------------------------------\n */\n\tif ($EXT->call_hook('cache_override') === FALSE && $OUT->_display_cache($CFG, $URI) === TRUE)\n\t{\n\t\texit;\n\t}\n\n/*\n * -----------------------------------------------------\n * Load the security class for xss and csrf support\n * -----------------------------------------------------\n */\n\t$SEC =& load_class('Security', 'core', $charset);\n\n/*\n * ------------------------------------------------------\n * Load the Input class and sanitize globals\n * ------------------------------------------------------\n */\n\t$IN =& load_class('Input', 'core', $SEC);\n\n/*\n * ------------------------------------------------------\n * Load the Language class\n * ------------------------------------------------------\n */\n\t$LANG =& load_class('Lang', 'core');\n\n/*\n * ------------------------------------------------------\n * Load the app controller and local controller\n * ------------------------------------------------------\n *\n */\n\t// Load the base controller class\n\trequire_once BASEPATH.'core/Controller.php';\n\n\t/**\n\t * Reference to the CI_Controller method.\n\t *\n\t * Returns current CI instance object\n\t *\n\t * @return CI_Controller\n\t */\n\tfunction &get_instance()\n\t{\n\t\treturn CI_Controller::get_instance();\n\t}\n\n\tif (file_exists(APPPATH.'core/'.$CFG->config['subclass_prefix'].'Controller.php'))\n\t{\n\t\trequire_once APPPATH.'core/'.$CFG->config['subclass_prefix'].'Controller.php';\n\t}\n\n\t// Set a mark point for benchmarking\n\t$BM->mark('loading_time:_base_classes_end');\n\n/*\n * ------------------------------------------------------\n * Sanity checks\n * ------------------------------------------------------\n *\n * The Router class has already validated the request,\n * leaving us with 3 options here:\n *\n *\t1) an empty class name, if we reached the default\n *\t controller, but it didn't exist;\n *\t2) a query string which doesn't go through a\n *\t file_exists() check\n *\t3) a regular request for a non-existing page\n *\n * We handle all of these as a 404 error.\n *\n * Furthermore, none of the methods in the app controller\n * or the loader class can be called via the URI, nor can\n * controller methods that begin with an underscore.\n */\n\n\t$e404 = FALSE;\n\t$class = ucfirst($RTR->class);\n\t$method = $RTR->method;\n\n\tif (empty($class) OR ! file_exists(APPPATH.'controllers/'.$RTR->directory.$class.'.php'))\n\t{\n\t\t$e404 = TRUE;\n\t}\n\telse\n\t{\n\t\trequire_once(APPPATH.'controllers/'.$RTR->directory.$class.'.php');\n\n\t\tif ( ! class_exists($class, FALSE) OR $method[0] === '_' OR method_exists('CI_Controller', $method))\n\t\t{\n\t\t\t$e404 = TRUE;\n\t\t}\n\t\telseif (method_exists($class, '_remap'))\n\t\t{\n\t\t\t$params = array($method, array_slice($URI->rsegments, 2));\n\t\t\t$method = '_remap';\n\t\t}\n\t\telseif ( ! method_exists($class, $method))\n\t\t{\n\t\t\t$e404 = TRUE;\n\t\t}\n\t\t/**\n\t\t * DO NOT CHANGE THIS, NOTHING ELSE WORKS!\n\t\t *\n\t\t * - method_exists() returns true for non-public methods, which passes the previous elseif\n\t\t * - is_callable() returns false for PHP 4-style constructors, even if there's a __construct()\n\t\t * - method_exists($class, '__construct') won't work because CI_Controller::__construct() is inherited\n\t\t * - People will only complain if this doesn't work, even though it is documented that it shouldn't.\n\t\t *\n\t\t * ReflectionMethod::isConstructor() is the ONLY reliable check,\n\t\t * knowing which method will be executed as a constructor.\n\t\t */\n\t\telse\n\t\t{\n\t\t\t$reflection = new ReflectionMethod($class, $method);\n\t\t\tif ( ! $reflection->isPublic() OR $reflection->isConstructor())\n\t\t\t{\n\t\t\t\t$e404 = TRUE;\n\t\t\t}\n\t\t}\n\t}\n\n\tif ($e404)\n\t{\n\t\tif ( ! empty($RTR->routes['404_override']))\n\t\t{\n\t\t\tif (sscanf($RTR->routes['404_override'], '%[^/]/%s', $error_class, $error_method) !== 2)\n\t\t\t{\n\t\t\t\t$error_method = 'index';\n\t\t\t}\n\n\t\t\t$error_class = ucfirst($error_class);\n\n\t\t\tif ( ! class_exists($error_class, FALSE))\n\t\t\t{\n\t\t\t\tif (file_exists(APPPATH.'controllers/'.$RTR->directory.$error_class.'.php'))\n\t\t\t\t{\n\t\t\t\t\trequire_once(APPPATH.'controllers/'.$RTR->directory.$error_class.'.php');\n\t\t\t\t\t$e404 = ! class_exists($error_class, FALSE);\n\t\t\t\t}\n\t\t\t\t// Were we in a directory? If so, check for a global override\n\t\t\t\telseif ( ! empty($RTR->directory) && file_exists(APPPATH.'controllers/'.$error_class.'.php'))\n\t\t\t\t{\n\t\t\t\t\trequire_once(APPPATH.'controllers/'.$error_class.'.php');\n\t\t\t\t\tif (($e404 = ! class_exists($error_class, FALSE)) === FALSE)\n\t\t\t\t\t{\n\t\t\t\t\t\t$RTR->directory = '';\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$e404 = FALSE;\n\t\t\t}\n\t\t}\n\n\t\t// Did we reset the $e404 flag? If so, set the rsegments, starting from index 1\n\t\tif ( ! $e404)\n\t\t{\n\t\t\t$class = $error_class;\n\t\t\t$method = $error_method;\n\n\t\t\t$URI->rsegments = array(\n\t\t\t\t1 => $class,\n\t\t\t\t2 => $method\n\t\t\t);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tshow_404($RTR->directory.$class.'/'.$method);\n\t\t}\n\t}\n\n\tif ($method !== '_remap')\n\t{\n\t\t$params = array_slice($URI->rsegments, 2);\n\t}\n\n/*\n * ------------------------------------------------------\n * Is there a \"pre_controller\" hook?\n * ------------------------------------------------------\n */\n\t$EXT->call_hook('pre_controller');\n\n/*\n * ------------------------------------------------------\n * Instantiate the requested controller\n * ------------------------------------------------------\n */\n\t// Mark a start point so we can benchmark the controller\n\t$BM->mark('controller_execution_time_( '.$class.' / '.$method.' )_start');\n\n\t$CI = new $class();\n\n/*\n * ------------------------------------------------------\n * Is there a \"post_controller_constructor\" hook?\n * ------------------------------------------------------\n */\n\t$EXT->call_hook('post_controller_constructor');\n\n/*\n * ------------------------------------------------------\n * Call the requested method\n * ------------------------------------------------------\n */\n\tcall_user_func_array(array(&$CI, $method), $params);\n\n\t// Mark a benchmark end point\n\t$BM->mark('controller_execution_time_( '.$class.' / '.$method.' )_end');\n\n/*\n * ------------------------------------------------------\n * Is there a \"post_controller\" hook?\n * ------------------------------------------------------\n */\n\t$EXT->call_hook('post_controller');\n\n/*\n * ------------------------------------------------------\n * Send the final rendered output to the browser\n * ------------------------------------------------------\n */\n\tif ($EXT->call_hook('display_override') === FALSE)\n\t{\n\t\t$OUT->_display();\n\t}\n\n/*\n * ------------------------------------------------------\n * Is there a \"post_system\" hook?\n * ------------------------------------------------------\n */\n\t$EXT->call_hook('post_system');\n" }, { "path": "system/core/Common.php", "content": "=');\n\t\t}\n\n\t\treturn $_is_php[$version];\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('is_really_writable'))\n{\n\t/**\n\t * Tests for file writability\n\t *\n\t * is_writable() returns TRUE on Windows servers when you really can't write to\n\t * the file, based on the read-only attribute.\n\t *\n\t * @link\thttps://bugs.php.net/bug.php?id=54709\n\t * @param\tstring\n\t * @return\tbool\n\t */\n\tfunction is_really_writable($file)\n\t{\n\t\t// If we're on a UNIX-like server, just is_writable()\n\t\tif (DIRECTORY_SEPARATOR === '/')\n\t\t{\n\t\t\treturn is_writable($file);\n\t\t}\n\n\t\t/* For Windows servers and safe_mode \"on\" installations we'll actually\n\t\t * write a file then read it. Bah...\n\t\t */\n\t\tif (is_dir($file))\n\t\t{\n\t\t\t$file = rtrim($file, '/').'/'.md5(mt_rand());\n\t\t\tif (($fp = @fopen($file, 'ab')) === FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tfclose($fp);\n\t\t\t@chmod($file, 0777);\n\t\t\t@unlink($file);\n\t\t\treturn TRUE;\n\t\t}\n\t\telseif ( ! is_file($file) OR ($fp = @fopen($file, 'ab')) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tfclose($fp);\n\t\treturn TRUE;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('load_class'))\n{\n\t/**\n\t * Class registry\n\t *\n\t * This function acts as a singleton. If the requested class does not\n\t * exist it is instantiated and set to a static variable. If it has\n\t * previously been instantiated the variable is returned.\n\t *\n\t * @param\tstring\tthe class name being requested\n\t * @param\tstring\tthe directory where the class should be found\n\t * @param\tmixed\tan optional argument to pass to the class constructor\n\t * @return\tobject\n\t */\n\tfunction &load_class($class, $directory = 'libraries', $param = NULL)\n\t{\n\t\tstatic $_classes = array();\n\n\t\t// Does the class exist? If so, we're done...\n\t\tif (isset($_classes[$class]))\n\t\t{\n\t\t\treturn $_classes[$class];\n\t\t}\n\n\t\t$name = FALSE;\n\n\t\t// Look for the class first in the local application/libraries folder\n\t\t// then in the native system/libraries folder\n\t\tforeach (array(APPPATH, BASEPATH) as $path)\n\t\t{\n\t\t\tif (file_exists($path.$directory.'/'.$class.'.php'))\n\t\t\t{\n\t\t\t\t$name = 'CI_'.$class;\n\n\t\t\t\tif (class_exists($name, FALSE) === FALSE)\n\t\t\t\t{\n\t\t\t\t\trequire_once($path.$directory.'/'.$class.'.php');\n\t\t\t\t}\n\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\t// Is the request a class extension? If so we load it too\n\t\tif (file_exists(APPPATH.$directory.'/'.config_item('subclass_prefix').$class.'.php'))\n\t\t{\n\t\t\t$name = config_item('subclass_prefix').$class;\n\n\t\t\tif (class_exists($name, FALSE) === FALSE)\n\t\t\t{\n\t\t\t\trequire_once(APPPATH.$directory.'/'.$name.'.php');\n\t\t\t}\n\t\t}\n\n\t\t// Did we find the class?\n\t\tif ($name === FALSE)\n\t\t{\n\t\t\t// Note: We use exit() rather than show_error() in order to avoid a\n\t\t\t// self-referencing loop with the Exceptions class\n\t\t\tset_status_header(503);\n\t\t\techo 'Unable to locate the specified class: '.$class.'.php';\n\t\t\texit(5); // EXIT_UNK_CLASS\n\t\t}\n\n\t\t// Keep track of what we just loaded\n\t\tis_loaded($class);\n\n\t\t$_classes[$class] = isset($param)\n\t\t\t? new $name($param)\n\t\t\t: new $name();\n\t\treturn $_classes[$class];\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('is_loaded'))\n{\n\t/**\n\t * Keeps track of which libraries have been loaded. This function is\n\t * called by the load_class() function above\n\t *\n\t * @param\tstring\n\t * @return\tarray\n\t */\n\tfunction &is_loaded($class = '')\n\t{\n\t\tstatic $_is_loaded = array();\n\n\t\tif ($class !== '')\n\t\t{\n\t\t\t$_is_loaded[strtolower($class)] = $class;\n\t\t}\n\n\t\treturn $_is_loaded;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('get_config'))\n{\n\t/**\n\t * Loads the main config.php file\n\t *\n\t * This function lets us grab the config file even if the Config class\n\t * hasn't been instantiated yet\n\t *\n\t * @param\tarray\n\t * @return\tarray\n\t */\n\tfunction &get_config(Array $replace = array())\n\t{\n\t\tstatic $config;\n\n\t\tif (empty($config))\n\t\t{\n\t\t\t$file_path = APPPATH.'config/config.php';\n\t\t\t$found = FALSE;\n\t\t\tif (file_exists($file_path))\n\t\t\t{\n\t\t\t\t$found = TRUE;\n\t\t\t\trequire($file_path);\n\t\t\t}\n\n\t\t\t// Is the config file in the environment folder?\n\t\t\tif (file_exists($file_path = APPPATH.'config/'.ENVIRONMENT.'/config.php'))\n\t\t\t{\n\t\t\t\trequire($file_path);\n\t\t\t}\n\t\t\telseif ( ! $found)\n\t\t\t{\n\t\t\t\tset_status_header(503);\n\t\t\t\techo 'The configuration file does not exist.';\n\t\t\t\texit(3); // EXIT_CONFIG\n\t\t\t}\n\n\t\t\t// Does the $config array exist in the file?\n\t\t\tif ( ! isset($config) OR ! is_array($config))\n\t\t\t{\n\t\t\t\tset_status_header(503);\n\t\t\t\techo 'Your config file does not appear to be formatted correctly.';\n\t\t\t\texit(3); // EXIT_CONFIG\n\t\t\t}\n\t\t}\n\n\t\t// Are any values being dynamically added or replaced?\n\t\tforeach ($replace as $key => $val)\n\t\t{\n\t\t\t$config[$key] = $val;\n\t\t}\n\n\t\treturn $config;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('config_item'))\n{\n\t/**\n\t * Returns the specified config item\n\t *\n\t * @param\tstring\n\t * @return\tmixed\n\t */\n\tfunction config_item($item)\n\t{\n\t\tstatic $_config;\n\n\t\tif (empty($_config))\n\t\t{\n\t\t\t// references cannot be directly assigned to static variables, so we use an array\n\t\t\t$_config[0] =& get_config();\n\t\t}\n\n\t\treturn isset($_config[0][$item]) ? $_config[0][$item] : NULL;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('get_mimes'))\n{\n\t/**\n\t * Returns the MIME types array from config/mimes.php\n\t *\n\t * @return\tarray\n\t */\n\tfunction &get_mimes()\n\t{\n\t\tstatic $_mimes;\n\n\t\tif (empty($_mimes))\n\t\t{\n\t\t\t$_mimes = file_exists(APPPATH.'config/mimes.php')\n\t\t\t\t? include(APPPATH.'config/mimes.php')\n\t\t\t\t: array();\n\n\t\t\tif (file_exists(APPPATH.'config/'.ENVIRONMENT.'/mimes.php'))\n\t\t\t{\n\t\t\t\t$_mimes = array_merge($_mimes, include(APPPATH.'config/'.ENVIRONMENT.'/mimes.php'));\n\t\t\t}\n\t\t}\n\n\t\treturn $_mimes;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('is_https'))\n{\n\t/**\n\t * Is HTTPS?\n\t *\n\t * Determines if the application is accessed via an encrypted\n\t * (HTTPS) connection.\n\t *\n\t * @return\tbool\n\t */\n\tfunction is_https()\n\t{\n\t\tif ( ! empty($_SERVER['HTTPS']) && strtolower($_SERVER['HTTPS']) !== 'off')\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\t\telseif (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && strtolower($_SERVER['HTTP_X_FORWARDED_PROTO']) === 'https')\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\t\telseif ( ! empty($_SERVER['HTTP_FRONT_END_HTTPS']) && strtolower($_SERVER['HTTP_FRONT_END_HTTPS']) !== 'off')\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('is_cli'))\n{\n\n\t/**\n\t * Is CLI?\n\t *\n\t * Test to see if a request was made from the command line.\n\t *\n\t * @return \tbool\n\t */\n\tfunction is_cli()\n\t{\n\t\treturn (PHP_SAPI === 'cli' OR defined('STDIN'));\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('show_error'))\n{\n\t/**\n\t * Error Handler\n\t *\n\t * This function lets us invoke the exception class and\n\t * display errors using the standard error template located\n\t * in application/views/errors/error_general.php\n\t * This function will send the error page directly to the\n\t * browser and exit.\n\t *\n\t * @param\tstring\n\t * @param\tint\n\t * @param\tstring\n\t * @return\tvoid\n\t */\n\tfunction show_error($message, $status_code = 500, $heading = 'An Error Was Encountered')\n\t{\n\t\t$status_code = abs($status_code);\n\t\tif ($status_code < 100)\n\t\t{\n\t\t\t$exit_status = $status_code + 9; // 9 is EXIT__AUTO_MIN\n\t\t\t$status_code = 500;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$exit_status = 1; // EXIT_ERROR\n\t\t}\n\n\t\t$_error =& load_class('Exceptions', 'core');\n\t\techo $_error->show_error($heading, $message, 'error_general', $status_code);\n\t\texit($exit_status);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('show_404'))\n{\n\t/**\n\t * 404 Page Handler\n\t *\n\t * This function is similar to the show_error() function above\n\t * However, instead of the standard error template it displays\n\t * 404 errors.\n\t *\n\t * @param\tstring\n\t * @param\tbool\n\t * @return\tvoid\n\t */\n\tfunction show_404($page = '', $log_error = TRUE)\n\t{\n\t\t$_error =& load_class('Exceptions', 'core');\n\t\t$_error->show_404($page, $log_error);\n\t\texit(4); // EXIT_UNKNOWN_FILE\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('log_message'))\n{\n\t/**\n\t * Error Logging Interface\n\t *\n\t * We use this as a simple mechanism to access the logging\n\t * class and send messages to be logged.\n\t *\n\t * @param\tstring\tthe error level: 'error', 'debug' or 'info'\n\t * @param\tstring\tthe error message\n\t * @return\tvoid\n\t */\n\tfunction log_message($level, $message)\n\t{\n\t\tstatic $_log;\n\n\t\tif ($_log === NULL)\n\t\t{\n\t\t\t// references cannot be directly assigned to static variables, so we use an array\n\t\t\t$_log[0] =& load_class('Log', 'core');\n\t\t}\n\n\t\t$_log[0]->write_log($level, $message);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('set_status_header'))\n{\n\t/**\n\t * Set HTTP Status Header\n\t *\n\t * @param\tint\tthe status code\n\t * @param\tstring\n\t * @return\tvoid\n\t */\n\tfunction set_status_header($code = 200, $text = '')\n\t{\n\t\tif (is_cli())\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\tif (empty($code) OR ! is_numeric($code))\n\t\t{\n\t\t\tshow_error('Status codes must be numeric', 500);\n\t\t}\n\n\t\tif (empty($text))\n\t\t{\n\t\t\tis_int($code) OR $code = (int) $code;\n\t\t\t$stati = array(\n\t\t\t\t100\t=> 'Continue',\n\t\t\t\t101\t=> 'Switching Protocols',\n\t\t\t\t103\t=> 'Early Hints',\n\n\t\t\t\t200\t=> 'OK',\n\t\t\t\t201\t=> 'Created',\n\t\t\t\t202\t=> 'Accepted',\n\t\t\t\t203\t=> 'Non-Authoritative Information',\n\t\t\t\t204\t=> 'No Content',\n\t\t\t\t205\t=> 'Reset Content',\n\t\t\t\t206\t=> 'Partial Content',\n\t\t\t\t207\t=> 'Multi-Status',\n\n\t\t\t\t300\t=> 'Multiple Choices',\n\t\t\t\t301\t=> 'Moved Permanently',\n\t\t\t\t302\t=> 'Found',\n\t\t\t\t303\t=> 'See Other',\n\t\t\t\t304\t=> 'Not Modified',\n\t\t\t\t305\t=> 'Use Proxy',\n\t\t\t\t307\t=> 'Temporary Redirect',\n\t\t\t\t308\t=> 'Permanent Redirect',\n\n\t\t\t\t400\t=> 'Bad Request',\n\t\t\t\t401\t=> 'Unauthorized',\n\t\t\t\t402\t=> 'Payment Required',\n\t\t\t\t403\t=> 'Forbidden',\n\t\t\t\t404\t=> 'Not Found',\n\t\t\t\t405\t=> 'Method Not Allowed',\n\t\t\t\t406\t=> 'Not Acceptable',\n\t\t\t\t407\t=> 'Proxy Authentication Required',\n\t\t\t\t408\t=> 'Request Timeout',\n\t\t\t\t409\t=> 'Conflict',\n\t\t\t\t410\t=> 'Gone',\n\t\t\t\t411\t=> 'Length Required',\n\t\t\t\t412\t=> 'Precondition Failed',\n\t\t\t\t413\t=> 'Request Entity Too Large',\n\t\t\t\t414\t=> 'Request-URI Too Long',\n\t\t\t\t415\t=> 'Unsupported Media Type',\n\t\t\t\t416\t=> 'Requested Range Not Satisfiable',\n\t\t\t\t417\t=> 'Expectation Failed',\n\t\t\t\t421\t=> 'Misdirected Request',\n\t\t\t\t422\t=> 'Unprocessable Entity',\n\t\t\t\t426\t=> 'Upgrade Required',\n\t\t\t\t428\t=> 'Precondition Required',\n\t\t\t\t429\t=> 'Too Many Requests',\n\t\t\t\t431\t=> 'Request Header Fields Too Large',\n\t\t\t\t451\t=> 'Unavailable For Legal Reasons',\n\n\t\t\t\t500\t=> 'Internal Server Error',\n\t\t\t\t501\t=> 'Not Implemented',\n\t\t\t\t502\t=> 'Bad Gateway',\n\t\t\t\t503\t=> 'Service Unavailable',\n\t\t\t\t504\t=> 'Gateway Timeout',\n\t\t\t\t505\t=> 'HTTP Version Not Supported',\n\t\t\t\t511\t=> 'Network Authentication Required',\n\t\t\t);\n\n\t\t\tif (isset($stati[$code]))\n\t\t\t{\n\t\t\t\t$text = $stati[$code];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tshow_error('No status text available. Please check your status code number or supply your own message text.', 500);\n\t\t\t}\n\t\t}\n\n\t\tif (strpos(PHP_SAPI, 'cgi') === 0)\n\t\t{\n\t\t\theader('Status: '.$code.' '.$text, TRUE);\n\t\t\treturn;\n\t\t}\n\n\t\t$server_protocol = (isset($_SERVER['SERVER_PROTOCOL']) && in_array($_SERVER['SERVER_PROTOCOL'], array('HTTP/1.0', 'HTTP/1.1', 'HTTP/2', 'HTTP/2.0'), TRUE))\n\t\t\t? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.1';\n\t\theader($server_protocol.' '.$code.' '.$text, TRUE, $code);\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('_error_handler'))\n{\n\t/**\n\t * Error Handler\n\t *\n\t * This is the custom error handler that is declared at the (relative)\n\t * top of CodeIgniter.php. The main reason we use this is to permit\n\t * PHP errors to be logged in our own log files since the user may\n\t * not have access to server logs. Since this function effectively\n\t * intercepts PHP errors, however, we also need to display errors\n\t * based on the current error_reporting level.\n\t * We do that with the use of a PHP error template.\n\t *\n\t * @param\tint\t$severity\n\t * @param\tstring\t$message\n\t * @param\tstring\t$filepath\n\t * @param\tint\t$line\n\t * @return\tvoid\n\t */\n\tfunction _error_handler($severity, $message, $filepath, $line)\n\t{\n\t\t$is_error = (((E_ERROR | E_PARSE | E_COMPILE_ERROR | E_CORE_ERROR | E_USER_ERROR) & $severity) === $severity);\n\n\t\t// When an error occurred, set the status header to '500 Internal Server Error'\n\t\t// to indicate to the client something went wrong.\n\t\t// This can't be done within the $_error->show_php_error method because\n\t\t// it is only called when the display_errors flag is set (which isn't usually\n\t\t// the case in a production environment) or when errors are ignored because\n\t\t// they are above the error_reporting threshold.\n\t\tif ($is_error)\n\t\t{\n\t\t\tset_status_header(500);\n\t\t}\n\n\t\t// Should we ignore the error? We'll get the current error_reporting\n\t\t// level and add its bits with the severity bits to find out.\n\t\tif (($severity & error_reporting()) !== $severity)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t$_error =& load_class('Exceptions', 'core');\n\t\t$_error->log_exception($severity, $message, $filepath, $line);\n\n\t\t// Should we display the error?\n\t\tif (str_ireplace(array('off', 'none', 'no', 'false', 'null'), '', ini_get('display_errors')))\n\t\t{\n\t\t\t$_error->show_php_error($severity, $message, $filepath, $line);\n\t\t}\n\n\t\t// If the error is fatal, the execution of the script should be stopped because\n\t\t// errors can't be recovered from. Halting the script conforms with PHP's\n\t\t// default error handling. See https://secure.php.net/manual/en/errorfunc.constants.php\n\t\tif ($is_error)\n\t\t{\n\t\t\texit(1); // EXIT_ERROR\n\t\t}\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('_exception_handler'))\n{\n\t/**\n\t * Exception Handler\n\t *\n\t * Sends uncaught exceptions to the logger and displays them\n\t * only if display_errors is On so that they don't show up in\n\t * production environments.\n\t *\n\t * @param\tException\t$exception\n\t * @return\tvoid\n\t */\n\tfunction _exception_handler($exception)\n\t{\n\t\t$_error =& load_class('Exceptions', 'core');\n\t\t$_error->log_exception('error', 'Exception: '.$exception->getMessage(), $exception->getFile(), $exception->getLine());\n\n\t\tis_cli() OR set_status_header(500);\n\t\t// Should we display the error?\n\t\tif (str_ireplace(array('off', 'none', 'no', 'false', 'null'), '', ini_get('display_errors')))\n\t\t{\n\t\t\t$_error->show_exception($exception);\n\t\t}\n\n\t\texit(1); // EXIT_ERROR\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('_shutdown_handler'))\n{\n\t/**\n\t * Shutdown Handler\n\t *\n\t * This is the shutdown handler that is declared at the top\n\t * of CodeIgniter.php. The main reason we use this is to simulate\n\t * a complete custom exception handler.\n\t *\n\t * E_STRICT is purposively neglected because such events may have\n\t * been caught. Duplication or none? None is preferred for now.\n\t *\n\t * @link\thttp://insomanic.me.uk/post/229851073/php-trick-catching-fatal-errors-e-error-with-a\n\t * @return\tvoid\n\t */\n\tfunction _shutdown_handler()\n\t{\n\t\t$last_error = error_get_last();\n\t\tif (isset($last_error) &&\n\t\t\t($last_error['type'] & (E_ERROR | E_PARSE | E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_COMPILE_WARNING)))\n\t\t{\n\t\t\t_error_handler($last_error['type'], $last_error['message'], $last_error['file'], $last_error['line']);\n\t\t}\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('remove_invisible_characters'))\n{\n\t/**\n\t * Remove Invisible Characters\n\t *\n\t * This prevents sandwiching null characters\n\t * between ascii characters, like Java\\0script.\n\t *\n\t * @param\tstring\n\t * @param\tbool\n\t * @return\tstring\n\t */\n\tfunction remove_invisible_characters($str, $url_encoded = TRUE)\n\t{\n\t\t$non_displayables = array();\n\n\t\t// every control character except newline (dec 10),\n\t\t// carriage return (dec 13) and horizontal tab (dec 09)\n\t\tif ($url_encoded)\n\t\t{\n\t\t\t$non_displayables[] = '/%0[0-8bcef]/i';\t// url encoded 00-08, 11, 12, 14, 15\n\t\t\t$non_displayables[] = '/%1[0-9a-f]/i';\t// url encoded 16-31\n\t\t\t$non_displayables[] = '/%7f/i';\t// url encoded 127\n\t\t}\n\n\t\t$non_displayables[] = '/[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]+/S';\t// 00-08, 11, 12, 14-31, 127\n\n\t\tdo\n\t\t{\n\t\t\t$str = preg_replace($non_displayables, '', $str, -1, $count);\n\t\t}\n\t\twhile ($count);\n\n\t\treturn $str;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('html_escape'))\n{\n\t/**\n\t * Returns HTML escaped variable.\n\t *\n\t * @param\tmixed\t$var\t\tThe input string or array of strings to be escaped.\n\t * @param\tbool\t$double_encode\t$double_encode set to FALSE prevents escaping twice.\n\t * @return\tmixed\t\t\tThe escaped string or array of strings as a result.\n\t */\n\tfunction html_escape($var, $double_encode = TRUE)\n\t{\n\t\tif (empty($var))\n\t\t{\n\t\t\treturn $var;\n\t\t}\n\n\t\tif (is_array($var))\n\t\t{\n\t\t\tforeach (array_keys($var) as $key)\n\t\t\t{\n\t\t\t\t$var[$key] = html_escape($var[$key], $double_encode);\n\t\t\t}\n\n\t\t\treturn $var;\n\t\t}\n\n\t\treturn htmlspecialchars($var, ENT_QUOTES, config_item('charset'), $double_encode);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('_stringify_attributes'))\n{\n\t/**\n\t * Stringify attributes for use in HTML tags.\n\t *\n\t * Helper function used to convert a string, array, or object\n\t * of attributes to a string.\n\t *\n\t * @param\tmixed\tstring, array, object\n\t * @param\tbool\n\t * @return\tstring\n\t */\n\tfunction _stringify_attributes($attributes, $js = FALSE)\n\t{\n\t\tif (empty($attributes))\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif (is_string($attributes))\n\t\t{\n\t\t\treturn ' '.$attributes;\n\t\t}\n\n\t\t$attributes = (array) $attributes;\n\n\t\t$atts = '';\n\t\tforeach ($attributes as $key => $val)\n\t\t{\n\t\t\t$atts .= ($js) ? $key.'='.$val.',' : ' '.$key.'=\"'.$val.'\"';\n\t\t}\n\n\t\treturn rtrim($atts, ',');\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('function_usable'))\n{\n\t/**\n\t * Function usable\n\t *\n\t * Executes a function_exists() check, and if the Suhosin PHP\n\t * extension is loaded - checks whether the function that is\n\t * checked might be disabled in there as well.\n\t *\n\t * This is useful as function_exists() will return FALSE for\n\t * functions disabled via the *disable_functions* php.ini\n\t * setting, but not for *suhosin.executor.func.blacklist* and\n\t * *suhosin.executor.disable_eval*. These settings will just\n\t * terminate script execution if a disabled function is executed.\n\t *\n\t * The above described behavior turned out to be a bug in Suhosin,\n\t * but even though a fix was committed for 0.9.34 on 2012-02-12,\n\t * that version is yet to be released. This function will therefore\n\t * be just temporary, but would probably be kept for a few years.\n\t *\n\t * @link\thttp://www.hardened-php.net/suhosin/\n\t * @param\tstring\t$function_name\tFunction to check for\n\t * @return\tbool\tTRUE if the function exists and is safe to call,\n\t *\t\t\tFALSE otherwise.\n\t */\n\tfunction function_usable($function_name)\n\t{\n\t\tstatic $_suhosin_func_blacklist;\n\n\t\tif (function_exists($function_name))\n\t\t{\n\t\t\tif ( ! isset($_suhosin_func_blacklist))\n\t\t\t{\n\t\t\t\t$_suhosin_func_blacklist = extension_loaded('suhosin')\n\t\t\t\t\t? explode(',', trim(ini_get('suhosin.executor.func.blacklist')))\n\t\t\t\t\t: array();\n\t\t\t}\n\n\t\t\treturn ! in_array($function_name, $_suhosin_func_blacklist, TRUE);\n\t\t}\n\n\t\treturn FALSE;\n\t}\n}\n" }, { "path": "system/core/Config.php", "content": "config =& get_config();\n\n\t\t// Set the base_url automatically if none was provided\n\t\tif (empty($this->config['base_url']))\n\t\t{\n\t\t\tif (isset($_SERVER['SERVER_ADDR']))\n\t\t\t{\n\t\t\t\tif (strpos($_SERVER['SERVER_ADDR'], ':') !== FALSE)\n\t\t\t\t{\n\t\t\t\t\t$server_addr = '['.$_SERVER['SERVER_ADDR'].']';\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$server_addr = $_SERVER['SERVER_ADDR'];\n\t\t\t\t}\n\n\t\t\t\t$base_url = (is_https() ? 'https' : 'http').'://'.$server_addr\n\t\t\t\t\t.substr($_SERVER['SCRIPT_NAME'], 0, strpos($_SERVER['SCRIPT_NAME'], basename($_SERVER['SCRIPT_FILENAME'])));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$base_url = 'http://localhost/';\n\t\t\t}\n\n\t\t\t$this->set_item('base_url', $base_url);\n\t\t}\n\n\t\tlog_message('info', 'Config Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Load Config File\n\t *\n\t * @param\tstring\t$file\t\t\tConfiguration file name\n\t * @param\tbool\t$use_sections\t\tWhether configuration values should be loaded into their own section\n\t * @param\tbool\t$fail_gracefully\tWhether to just return FALSE or display an error message\n\t * @return\tbool\tTRUE if the file was loaded correctly or FALSE on failure\n\t */\n\tpublic function load($file = '', $use_sections = FALSE, $fail_gracefully = FALSE)\n\t{\n\t\t$file = ($file === '') ? 'config' : str_replace('.php', '', $file);\n\t\t$loaded = FALSE;\n\n\t\tforeach ($this->_config_paths as $path)\n\t\t{\n\t\t\tforeach (array($file, ENVIRONMENT.DIRECTORY_SEPARATOR.$file) as $location)\n\t\t\t{\n\t\t\t\t$file_path = $path.'config/'.$location.'.php';\n\t\t\t\tif (in_array($file_path, $this->is_loaded, TRUE))\n\t\t\t\t{\n\t\t\t\t\treturn TRUE;\n\t\t\t\t}\n\n\t\t\t\tif ( ! file_exists($file_path))\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tinclude($file_path);\n\n\t\t\t\tif ( ! isset($config) OR ! is_array($config))\n\t\t\t\t{\n\t\t\t\t\tif ($fail_gracefully === TRUE)\n\t\t\t\t\t{\n\t\t\t\t\t\treturn FALSE;\n\t\t\t\t\t}\n\n\t\t\t\t\tshow_error('Your '.$file_path.' file does not appear to contain a valid configuration array.');\n\t\t\t\t}\n\n\t\t\t\tif ($use_sections === TRUE)\n\t\t\t\t{\n\t\t\t\t\t$this->config[$file] = isset($this->config[$file])\n\t\t\t\t\t\t? array_merge($this->config[$file], $config)\n\t\t\t\t\t\t: $config;\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$this->config = array_merge($this->config, $config);\n\t\t\t\t}\n\n\t\t\t\t$this->is_loaded[] = $file_path;\n\t\t\t\t$config = NULL;\n\t\t\t\t$loaded = TRUE;\n\t\t\t\tlog_message('info', 'Config file loaded: '.$file_path);\n\t\t\t}\n\t\t}\n\n\t\tif ($loaded === TRUE)\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\t\telseif ($fail_gracefully === TRUE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tshow_error('The configuration file '.$file.'.php does not exist.');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch a config file item\n\t *\n\t * @param\tstring\t$item\tConfig item name\n\t * @param\tstring\t$index\tIndex name\n\t * @return\tstring|null\tThe configuration item or NULL if the item doesn't exist\n\t */\n\tpublic function item($item, $index = '')\n\t{\n\t\tif ($index == '')\n\t\t{\n\t\t\treturn isset($this->config[$item]) ? $this->config[$item] : NULL;\n\t\t}\n\n\t\treturn isset($this->config[$index], $this->config[$index][$item]) ? $this->config[$index][$item] : NULL;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch a config file item with slash appended (if not empty)\n\t *\n\t * @param\tstring\t\t$item\tConfig item name\n\t * @return\tstring|null\tThe configuration item or NULL if the item doesn't exist\n\t */\n\tpublic function slash_item($item)\n\t{\n\t\tif ( ! isset($this->config[$item]))\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\t\telseif (trim($this->config[$item]) === '')\n\t\t{\n\t\t\treturn '';\n\t\t}\n\n\t\treturn rtrim($this->config[$item], '/').'/';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Site URL\n\t *\n\t * Returns base_url . index_page [. uri_string]\n\t *\n\t * @uses\tCI_Config::_uri_string()\n\t *\n\t * @param\tstring|string[]\t$uri\tURI string or an array of segments\n\t * @param\tstring\t$protocol\n\t * @return\tstring\n\t */\n\tpublic function site_url($uri = '', $protocol = NULL)\n\t{\n\t\t$base_url = $this->slash_item('base_url');\n\n\t\tif (isset($protocol))\n\t\t{\n\t\t\t// For protocol-relative links\n\t\t\tif ($protocol === '')\n\t\t\t{\n\t\t\t\t$base_url = substr($base_url, strpos($base_url, '//'));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$base_url = $protocol.substr($base_url, strpos($base_url, '://'));\n\t\t\t}\n\t\t}\n\n\t\tif (empty($uri))\n\t\t{\n\t\t\treturn $base_url.$this->item('index_page');\n\t\t}\n\n\t\t$uri = $this->_uri_string($uri);\n\n\t\tif ($this->item('enable_query_strings') === FALSE)\n\t\t{\n\t\t\t$suffix = isset($this->config['url_suffix']) ? $this->config['url_suffix'] : '';\n\n\t\t\tif ($suffix !== '')\n\t\t\t{\n\t\t\t\tif (($offset = strpos($uri, '?')) !== FALSE)\n\t\t\t\t{\n\t\t\t\t\t$uri = substr($uri, 0, $offset).$suffix.substr($uri, $offset);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$uri .= $suffix;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn $base_url.$this->slash_item('index_page').$uri;\n\t\t}\n\t\telseif (strpos($uri, '?') === FALSE)\n\t\t{\n\t\t\t$uri = '?'.$uri;\n\t\t}\n\n\t\treturn $base_url.$this->item('index_page').$uri;\n\t}\n\n\t// -------------------------------------------------------------\n\n\t/**\n\t * Base URL\n\t *\n\t * Returns base_url [. uri_string]\n\t *\n\t * @uses\tCI_Config::_uri_string()\n\t *\n\t * @param\tstring|string[]\t$uri\tURI string or an array of segments\n\t * @param\tstring\t$protocol\n\t * @return\tstring\n\t */\n\tpublic function base_url($uri = '', $protocol = NULL)\n\t{\n\t\t$base_url = $this->slash_item('base_url');\n\n\t\tif (isset($protocol))\n\t\t{\n\t\t\t// For protocol-relative links\n\t\t\tif ($protocol === '')\n\t\t\t{\n\t\t\t\t$base_url = substr($base_url, strpos($base_url, '//'));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$base_url = $protocol.substr($base_url, strpos($base_url, '://'));\n\t\t\t}\n\t\t}\n\n\t\treturn $base_url.$this->_uri_string($uri);\n\t}\n\n\t// -------------------------------------------------------------\n\n\t/**\n\t * Build URI string\n\t *\n\t * @used-by\tCI_Config::site_url()\n\t * @used-by\tCI_Config::base_url()\n\t *\n\t * @param\tstring|string[]\t$uri\tURI string or an array of segments\n\t * @return\tstring\n\t */\n\tprotected function _uri_string($uri)\n\t{\n\t\tif ($this->item('enable_query_strings') === FALSE)\n\t\t{\n\t\t\tis_array($uri) && $uri = implode('/', $uri);\n\t\t\treturn ltrim($uri, '/');\n\t\t}\n\t\telseif (is_array($uri))\n\t\t{\n\t\t\treturn http_build_query($uri);\n\t\t}\n\n\t\treturn $uri;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set a config file item\n\t *\n\t * @param\tstring\t$item\tConfig item key\n\t * @param\tstring\t$value\tConfig item value\n\t * @return\tvoid\n\t */\n\tpublic function set_item($item, $value)\n\t{\n\t\t$this->config[$item] = $value;\n\t}\n\n}\n" }, { "path": "system/core/Controller.php", "content": " $class)\n\t\t{\n\t\t\t$this->$var =& load_class($class);\n\t\t}\n\n\t\t$this->load =& load_class('Loader', 'core');\n\t\t$this->load->initialize();\n\t\tlog_message('info', 'Controller Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get the CI singleton\n\t *\n\t * @static\n\t * @return\tobject\n\t */\n\tpublic static function &get_instance()\n\t{\n\t\treturn self::$instance;\n\t}\n\n}\n" }, { "path": "system/core/Exceptions.php", "content": "\t'Error',\n\t\tE_WARNING\t\t=>\t'Warning',\n\t\tE_PARSE\t\t\t=>\t'Parsing Error',\n\t\tE_NOTICE\t\t=>\t'Notice',\n\t\tE_CORE_ERROR\t\t=>\t'Core Error',\n\t\tE_CORE_WARNING\t\t=>\t'Core Warning',\n\t\tE_COMPILE_ERROR\t\t=>\t'Compile Error',\n\t\tE_COMPILE_WARNING\t=>\t'Compile Warning',\n\t\tE_USER_ERROR\t\t=>\t'User Error',\n\t\tE_USER_WARNING\t\t=>\t'User Warning',\n\t\tE_USER_NOTICE\t\t=>\t'User Notice',\n\t\tE_STRICT\t\t=>\t'Runtime Notice'\n\t);\n\n\t/**\n\t * Class constructor\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function __construct()\n\t{\n\t\t$this->ob_level = ob_get_level();\n\t\t// Note: Do not log messages from this constructor.\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Exception Logger\n\t *\n\t * Logs PHP generated error messages\n\t *\n\t * @param\tint\t$severity\tLog level\n\t * @param\tstring\t$message\tError message\n\t * @param\tstring\t$filepath\tFile path\n\t * @param\tint\t$line\t\tLine number\n\t * @return\tvoid\n\t */\n\tpublic function log_exception($severity, $message, $filepath, $line)\n\t{\n\t\t$severity = isset($this->levels[$severity]) ? $this->levels[$severity] : $severity;\n\t\tlog_message('error', 'Severity: '.$severity.' --> '.$message.' '.$filepath.' '.$line);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * 404 Error Handler\n\t *\n\t * @uses\tCI_Exceptions::show_error()\n\t *\n\t * @param\tstring\t$page\t\tPage URI\n\t * @param \tbool\t$log_error\tWhether to log the error\n\t * @return\tvoid\n\t */\n\tpublic function show_404($page = '', $log_error = TRUE)\n\t{\n\t\tif (is_cli())\n\t\t{\n\t\t\t$heading = 'Not Found';\n\t\t\t$message = 'The controller/method pair you requested was not found.';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$heading = '404 Page Not Found';\n\t\t\t$message = 'The page you requested was not found.';\n\t\t}\n\n\t\t// By default we log this, but allow a dev to skip it\n\t\tif ($log_error)\n\t\t{\n\t\t\tlog_message('error', $heading.': '.$page);\n\t\t}\n\n\t\techo $this->show_error($heading, $message, 'error_404', 404);\n\t\texit(4); // EXIT_UNKNOWN_FILE\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * General Error Page\n\t *\n\t * Takes an error message as input (either as a string or an array)\n\t * and displays it using the specified template.\n\t *\n\t * @param\tstring\t\t$heading\tPage heading\n\t * @param\tstring|string[]\t$message\tError message\n\t * @param\tstring\t\t$template\tTemplate name\n\t * @param \tint\t\t$status_code\t(default: 500)\n\t *\n\t * @return\tstring\tError page output\n\t */\n\tpublic function show_error($heading, $message, $template = 'error_general', $status_code = 500)\n\t{\n\t\t$templates_path = config_item('error_views_path');\n\t\tif (empty($templates_path))\n\t\t{\n\t\t\t$templates_path = VIEWPATH.'errors'.DIRECTORY_SEPARATOR;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$templates_path = rtrim($templates_path, '/\\\\').DIRECTORY_SEPARATOR;\n\t\t}\n\n\t\tif (is_cli())\n\t\t{\n\t\t\t$message = \"\\t\".(is_array($message) ? implode(\"\\n\\t\", $message) : $message);\n\t\t\t$template = 'cli'.DIRECTORY_SEPARATOR.$template;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tset_status_header($status_code);\n\t\t\t$message = '

'.(is_array($message) ? implode('

', $message) : $message).'

';\n\t\t\t$template = 'html'.DIRECTORY_SEPARATOR.$template;\n\t\t}\n\n\t\tif (ob_get_level() > $this->ob_level + 1)\n\t\t{\n\t\t\tob_end_flush();\n\t\t}\n\t\tob_start();\n\t\tinclude($templates_path.$template.'.php');\n\t\t$buffer = ob_get_contents();\n\t\tob_end_clean();\n\t\treturn $buffer;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function show_exception($exception)\n\t{\n\t\t$templates_path = config_item('error_views_path');\n\t\tif (empty($templates_path))\n\t\t{\n\t\t\t$templates_path = VIEWPATH.'errors'.DIRECTORY_SEPARATOR;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$templates_path = rtrim($templates_path, '/\\\\').DIRECTORY_SEPARATOR;\n\t\t}\n\n\t\t$message = $exception->getMessage();\n\t\tif (empty($message))\n\t\t{\n\t\t\t$message = '(null)';\n\t\t}\n\n\t\tif (is_cli())\n\t\t{\n\t\t\t$templates_path .= 'cli'.DIRECTORY_SEPARATOR;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$templates_path .= 'html'.DIRECTORY_SEPARATOR;\n\t\t}\n\n\t\tif (ob_get_level() > $this->ob_level + 1)\n\t\t{\n\t\t\tob_end_flush();\n\t\t}\n\n\t\tob_start();\n\t\tinclude($templates_path.'error_exception.php');\n\t\t$buffer = ob_get_contents();\n\t\tob_end_clean();\n\t\techo $buffer;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Native PHP error handler\n\t *\n\t * @param\tint\t$severity\tError level\n\t * @param\tstring\t$message\tError message\n\t * @param\tstring\t$filepath\tFile path\n\t * @param\tint\t$line\t\tLine number\n\t * @return\tvoid\n\t */\n\tpublic function show_php_error($severity, $message, $filepath, $line)\n\t{\n\t\t$templates_path = config_item('error_views_path');\n\t\tif (empty($templates_path))\n\t\t{\n\t\t\t$templates_path = VIEWPATH.'errors'.DIRECTORY_SEPARATOR;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$templates_path = rtrim($templates_path, '/\\\\').DIRECTORY_SEPARATOR;\n\t\t}\n\n\t\t$severity = isset($this->levels[$severity]) ? $this->levels[$severity] : $severity;\n\n\t\t// For safety reasons we don't show the full file path in non-CLI requests\n\t\tif ( ! is_cli())\n\t\t{\n\t\t\t$filepath = str_replace('\\\\', '/', $filepath);\n\t\t\tif (FALSE !== strpos($filepath, '/'))\n\t\t\t{\n\t\t\t\t$x = explode('/', $filepath);\n\t\t\t\t$filepath = $x[count($x)-2].'/'.end($x);\n\t\t\t}\n\n\t\t\t$template = 'html'.DIRECTORY_SEPARATOR.'error_php';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$template = 'cli'.DIRECTORY_SEPARATOR.'error_php';\n\t\t}\n\n\t\tif (ob_get_level() > $this->ob_level + 1)\n\t\t{\n\t\t\tob_end_flush();\n\t\t}\n\t\tob_start();\n\t\tinclude($templates_path.$template.'.php');\n\t\t$buffer = ob_get_contents();\n\t\tob_end_clean();\n\t\techo $buffer;\n\t}\n\n}\n" }, { "path": "system/core/Hooks.php", "content": "item('enable_hooks') === FALSE)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Grab the \"hooks\" definition file.\n\t\tif (file_exists(APPPATH.'config/hooks.php'))\n\t\t{\n\t\t\tinclude(APPPATH.'config/hooks.php');\n\t\t}\n\n\t\tif (file_exists(APPPATH.'config/'.ENVIRONMENT.'/hooks.php'))\n\t\t{\n\t\t\tinclude(APPPATH.'config/'.ENVIRONMENT.'/hooks.php');\n\t\t}\n\n\t\t// If there are no hooks, we're done.\n\t\tif ( ! isset($hook) OR ! is_array($hook))\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t$this->hooks =& $hook;\n\t\t$this->enabled = TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Call Hook\n\t *\n\t * Calls a particular hook. Called by CodeIgniter.php.\n\t *\n\t * @uses\tCI_Hooks::_run_hook()\n\t *\n\t * @param\tstring\t$which\tHook name\n\t * @return\tbool\tTRUE on success or FALSE on failure\n\t */\n\tpublic function call_hook($which = '')\n\t{\n\t\tif ( ! $this->enabled OR ! isset($this->hooks[$which]))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (is_array($this->hooks[$which]) && ! isset($this->hooks[$which]['function']))\n\t\t{\n\t\t\tforeach ($this->hooks[$which] as $val)\n\t\t\t{\n\t\t\t\t$this->_run_hook($val);\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->_run_hook($this->hooks[$which]);\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Run Hook\n\t *\n\t * Runs a particular hook\n\t *\n\t * @param\tarray\t$data\tHook details\n\t * @return\tbool\tTRUE on success or FALSE on failure\n\t */\n\tprotected function _run_hook($data)\n\t{\n\t\t// Closures/lambda functions and array($object, 'method') callables\n\t\tif (is_callable($data))\n\t\t{\n\t\t\tis_array($data)\n\t\t\t\t? $data[0]->{$data[1]}()\n\t\t\t\t: $data();\n\n\t\t\treturn TRUE;\n\t\t}\n\t\telseif ( ! is_array($data))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// -----------------------------------\n\t\t// Safety - Prevents run-away loops\n\t\t// -----------------------------------\n\n\t\t// If the script being called happens to have the same\n\t\t// hook call within it a loop can happen\n\t\tif ($this->_in_progress === TRUE)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// -----------------------------------\n\t\t// Set file path\n\t\t// -----------------------------------\n\n\t\tif ( ! isset($data['filepath'], $data['filename']))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$filepath = APPPATH.$data['filepath'].'/'.$data['filename'];\n\n\t\tif ( ! file_exists($filepath))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// Determine and class and/or function names\n\t\t$class\t\t= empty($data['class']) ? FALSE : $data['class'];\n\t\t$function\t= empty($data['function']) ? FALSE : $data['function'];\n\t\t$params\t\t= isset($data['params']) ? $data['params'] : '';\n\n\t\tif (empty($function))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// Set the _in_progress flag\n\t\t$this->_in_progress = TRUE;\n\n\t\t// Call the requested class and/or function\n\t\tif ($class !== FALSE)\n\t\t{\n\t\t\t// The object is stored?\n\t\t\tif (isset($this->_objects[$class]))\n\t\t\t{\n\t\t\t\tif (method_exists($this->_objects[$class], $function))\n\t\t\t\t{\n\t\t\t\t\t$this->_objects[$class]->$function($params);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\treturn $this->_in_progress = FALSE;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tclass_exists($class, FALSE) OR require_once($filepath);\n\n\t\t\t\tif ( ! class_exists($class, FALSE) OR ! method_exists($class, $function))\n\t\t\t\t{\n\t\t\t\t\treturn $this->_in_progress = FALSE;\n\t\t\t\t}\n\n\t\t\t\t// Store the object and execute the method\n\t\t\t\t$this->_objects[$class] = new $class();\n\t\t\t\t$this->_objects[$class]->$function($params);\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\tfunction_exists($function) OR require_once($filepath);\n\n\t\t\tif ( ! function_exists($function))\n\t\t\t{\n\t\t\t\treturn $this->_in_progress = FALSE;\n\t\t\t}\n\n\t\t\t$function($params);\n\t\t}\n\n\t\t$this->_in_progress = FALSE;\n\t\treturn TRUE;\n\t}\n\n}\n" }, { "path": "system/core/Input.php", "content": "security = $security;\n\t\tlog_message('info', 'Input Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch from array\n\t *\n\t * Internal method used to retrieve values from global arrays.\n\t *\n\t * @param\tarray\t&$array\t\t$_GET, $_POST, $_COOKIE, $_SERVER, etc.\n\t * @param\tmixed\t$index\t\tIndex for item to be fetched from $array\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tprotected function _fetch_from_array(&$array, $index = NULL, $xss_clean = FALSE)\n\t{\n\t\t// If $index is NULL, it means that the whole $array is requested\n\t\tisset($index) OR $index = array_keys($array);\n\n\t\t// allow fetching multiple keys at once\n\t\tif (is_array($index))\n\t\t{\n\t\t\t$output = array();\n\t\t\tforeach ($index as $key)\n\t\t\t{\n\t\t\t\t$output[$key] = $this->_fetch_from_array($array, $key, $xss_clean);\n\t\t\t}\n\n\t\t\treturn $output;\n\t\t}\n\n\t\tif (isset($array[$index]))\n\t\t{\n\t\t\t$value = $array[$index];\n\t\t}\n\t\telseif (($count = preg_match_all('/(?:^[^\\[]+)|\\[[^]]*\\]/', $index, $matches)) > 1) // Does the index contain array notation\n\t\t{\n\t\t\t$value = $array;\n\t\t\tfor ($i = 0; $i < $count; $i++)\n\t\t\t{\n\t\t\t\t$key = trim($matches[0][$i], '[]');\n\t\t\t\tif ($key === '') // Empty notation will return the value as array\n\t\t\t\t{\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (isset($value[$key]))\n\t\t\t\t{\n\t\t\t\t\t$value = $value[$key];\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\treturn NULL;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\treturn ($xss_clean === TRUE)\n\t\t\t? $this->security->xss_clean($value)\n\t\t\t: $value;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from the GET array\n\t *\n\t * @param\tmixed\t$index\t\tIndex for item to be fetched from $_GET\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function get($index = NULL, $xss_clean = FALSE)\n\t{\n\t\treturn $this->_fetch_from_array($_GET, $index, $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from the POST array\n\t *\n\t * @param\tmixed\t$index\t\tIndex for item to be fetched from $_POST\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function post($index = NULL, $xss_clean = FALSE)\n\t{\n\t\treturn $this->_fetch_from_array($_POST, $index, $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from POST data with fallback to GET\n\t *\n\t * @param\tstring\t$index\t\tIndex for item to be fetched from $_POST or $_GET\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function post_get($index, $xss_clean = FALSE)\n\t{\n\t\t$output = $this->post($index, $xss_clean);\n\t\treturn isset($output) ? $output : $this->get($index, $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from GET data with fallback to POST\n\t *\n\t * @param\tstring\t$index\t\tIndex for item to be fetched from $_GET or $_POST\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function get_post($index, $xss_clean = FALSE)\n\t{\n\t\t$output = $this->get($index, $xss_clean);\n\t\treturn isset($output) ? $output : $this->post($index, $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from the COOKIE array\n\t *\n\t * @param\tmixed\t$index\t\tIndex for item to be fetched from $_COOKIE\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function cookie($index = NULL, $xss_clean = FALSE)\n\t{\n\t\treturn $this->_fetch_from_array($_COOKIE, $index, $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from the SERVER array\n\t *\n\t * @param\tmixed\t$index\t\tIndex for item to be fetched from $_SERVER\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function server($index, $xss_clean = FALSE)\n\t{\n\t\treturn $this->_fetch_from_array($_SERVER, $index, $xss_clean);\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\t/**\n\t * Fetch an item from the php://input stream\n\t *\n\t * Useful when you need to access PUT, DELETE or PATCH request data.\n\t *\n\t * @param\tstring\t$index\t\tIndex for item to be fetched\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tmixed\n\t */\n\tpublic function input_stream($index = NULL, $xss_clean = FALSE)\n\t{\n\t\t// Prior to PHP 5.6, the input stream can only be read once,\n\t\t// so we'll need to check if we have already done that first.\n\t\tif ( ! is_array($this->_input_stream))\n\t\t{\n\t\t\t// $this->raw_input_stream will trigger __get().\n\t\t\tparse_str($this->raw_input_stream, $this->_input_stream);\n\t\t\tis_array($this->_input_stream) OR $this->_input_stream = array();\n\t\t}\n\n\t\treturn $this->_fetch_from_array($this->_input_stream, $index, $xss_clean);\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\t/**\n\t * Set cookie\n\t *\n\t * Accepts an arbitrary number of parameters (up to 7) or an associative\n\t * array in the first parameter containing all the values.\n\t *\n\t * @param\tstring|mixed[]\t$name\t\tCookie name or an array containing parameters\n\t * @param\tstring\t\t$value\t\tCookie value\n\t * @param\tint\t\t$expire\t\tCookie expiration time in seconds\n\t * @param\tstring\t\t$domain\t\tCookie domain (e.g.: '.yourdomain.com')\n\t * @param\tstring\t\t$path\t\tCookie path (default: '/')\n\t * @param\tstring\t\t$prefix\t\tCookie name prefix\n\t * @param\tbool\t\t$secure\t\tWhether to only transfer cookies via SSL\n\t * @param\tbool\t\t$httponly\tWhether to only makes the cookie accessible via HTTP (no javascript)\n\t * @param\tstring\t\t$samesite\tSameSite attribute\n\t * @return\tvoid\n\t */\n\tpublic function set_cookie($name, $value = '', $expire = 0, $domain = '', $path = '/', $prefix = '', $secure = NULL, $httponly = NULL, $samesite = NULL)\n\t{\n\t\tif (is_array($name))\n\t\t{\n\t\t\t// always leave 'name' in last place, as the loop will break otherwise, due to $$item\n\t\t\tforeach (array('value', 'expire', 'domain', 'path', 'prefix', 'secure', 'httponly', 'samesite', 'name') as $item)\n\t\t\t{\n\t\t\t\tif (isset($name[$item]))\n\t\t\t\t{\n\t\t\t\t\t$$item = $name[$item];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ($prefix === '' && config_item('cookie_prefix') !== '')\n\t\t{\n\t\t\t$prefix = config_item('cookie_prefix');\n\t\t}\n\n\t\tif ($domain == '' && config_item('cookie_domain') != '')\n\t\t{\n\t\t\t$domain = config_item('cookie_domain');\n\t\t}\n\n\t\tif ($path === '/' && config_item('cookie_path') !== '/')\n\t\t{\n\t\t\t$path = config_item('cookie_path');\n\t\t}\n\n\t\t$secure = ($secure === NULL && config_item('cookie_secure') !== NULL)\n\t\t\t? (bool) config_item('cookie_secure')\n\t\t\t: (bool) $secure;\n\n\t\t$httponly = ($httponly === NULL && config_item('cookie_httponly') !== NULL)\n\t\t\t? (bool) config_item('cookie_httponly')\n\t\t\t: (bool) $httponly;\n\n\t\tif ( ! is_numeric($expire) OR $expire < 0)\n\t\t{\n\t\t\t$expire = 1;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$expire = ($expire > 0) ? time() + $expire : 0;\n\t\t}\n\n\t\tisset($samesite) OR $samesite = config_item('cookie_samesite');\n\t\tif (isset($samesite))\n\t\t{\n\t\t\t$samesite = ucfirst(strtolower($samesite));\n\t\t\tin_array($samesite, array('Lax', 'Strict', 'None'), TRUE) OR $samesite = 'Lax';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$samesite = 'Lax';\n\t\t}\n\n\t\tif ($samesite === 'None' && ! $secure)\n\t\t{\n\t\t\tlog_message('error', $name.' cookie sent with SameSite=None, but without Secure attribute.');\n\t\t}\n\n\t\tif ( ! is_php('7.3'))\n\t\t{\n\t\t\t$maxage = $expire - time();\n\t\t\tif ($maxage < 1)\n\t\t\t{\n\t\t\t\t$maxage = 0;\n\t\t\t}\n\n\t\t\t$cookie_header = 'Set-Cookie: '.$prefix.$name.'='.rawurlencode($value);\n\t\t\t$cookie_header .= ($expire === 0 ? '' : '; Expires='.gmdate('D, d-M-Y H:i:s T', $expire)).'; Max-Age='.$maxage;\n\t\t\t$cookie_header .= '; Path='.$path.($domain !== '' ? '; Domain='.$domain : '');\n\t\t\t$cookie_header .= ($secure ? '; Secure' : '').($httponly ? '; HttpOnly' : '').'; SameSite='.$samesite;\n\t\t\theader($cookie_header);\n\t\t\treturn;\n\t\t}\n\n\t\t$setcookie_options = array(\n\t\t\t'expires' => $expire,\n\t\t\t'path' => $path,\n\t\t\t'domain' => $domain,\n\t\t\t'secure' => $secure,\n\t\t\t'httponly' => $httponly,\n\t\t\t'samesite' => $samesite,\n\t\t);\n\t\tsetcookie($prefix.$name, $value, $setcookie_options);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch the IP Address\n\t *\n\t * Determines and validates the visitor's IP address.\n\t *\n\t * @return\tstring\tIP address\n\t */\n\tpublic function ip_address()\n\t{\n\t\tif ($this->ip_address !== FALSE)\n\t\t{\n\t\t\treturn $this->ip_address;\n\t\t}\n\n\t\t$proxy_ips = config_item('proxy_ips');\n\t\tif ( ! empty($proxy_ips) && ! is_array($proxy_ips))\n\t\t{\n\t\t\t$proxy_ips = explode(',', str_replace(' ', '', $proxy_ips));\n\t\t}\n\n\t\t$this->ip_address = $this->server('REMOTE_ADDR');\n\n\t\tif ($proxy_ips)\n\t\t{\n\t\t\tforeach (array('HTTP_X_FORWARDED_FOR', 'HTTP_CLIENT_IP', 'HTTP_X_CLIENT_IP', 'HTTP_X_CLUSTER_CLIENT_IP') as $header)\n\t\t\t{\n\t\t\t\tif (($spoof = $this->server($header)) !== NULL)\n\t\t\t\t{\n\t\t\t\t\t// Some proxies typically list the whole chain of IP\n\t\t\t\t\t// addresses through which the client has reached us.\n\t\t\t\t\t// e.g. client_ip, proxy_ip1, proxy_ip2, etc.\n\t\t\t\t\tsscanf($spoof, '%[^,]', $spoof);\n\n\t\t\t\t\tif ( ! $this->valid_ip($spoof))\n\t\t\t\t\t{\n\t\t\t\t\t\t$spoof = NULL;\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ($spoof)\n\t\t\t{\n\t\t\t\tfor ($i = 0, $c = count($proxy_ips); $i < $c; $i++)\n\t\t\t\t{\n\t\t\t\t\t// Check if we have an IP address or a subnet\n\t\t\t\t\tif (strpos($proxy_ips[$i], '/') === FALSE)\n\t\t\t\t\t{\n\t\t\t\t\t\t// An IP address (and not a subnet) is specified.\n\t\t\t\t\t\t// We can compare right away.\n\t\t\t\t\t\tif ($proxy_ips[$i] === $this->ip_address)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t$this->ip_address = $spoof;\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// We have a subnet ... now the heavy lifting begins\n\t\t\t\t\tisset($separator) OR $separator = $this->valid_ip($this->ip_address, 'ipv6') ? ':' : '.';\n\n\t\t\t\t\t// If the proxy entry doesn't match the IP protocol - skip it\n\t\t\t\t\tif (strpos($proxy_ips[$i], $separator) === FALSE)\n\t\t\t\t\t{\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Convert the REMOTE_ADDR IP address to binary, if needed\n\t\t\t\t\tif ( ! isset($ip, $sprintf))\n\t\t\t\t\t{\n\t\t\t\t\t\tif ($separator === ':')\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t// Make sure we're have the \"full\" IPv6 format\n\t\t\t\t\t\t\t$ip = explode(':',\n\t\t\t\t\t\t\t\tstr_replace('::',\n\t\t\t\t\t\t\t\t\tstr_repeat(':', 9 - substr_count($this->ip_address, ':')),\n\t\t\t\t\t\t\t\t\t$this->ip_address\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t);\n\n\t\t\t\t\t\t\tfor ($j = 0; $j < 8; $j++)\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t$ip[$j] = intval($ip[$j], 16);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t$sprintf = '%016b%016b%016b%016b%016b%016b%016b%016b';\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t$ip = explode('.', $this->ip_address);\n\t\t\t\t\t\t\t$sprintf = '%08b%08b%08b%08b';\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t$ip = vsprintf($sprintf, $ip);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Split the netmask length off the network address\n\t\t\t\t\tsscanf($proxy_ips[$i], '%[^/]/%d', $netaddr, $masklen);\n\n\t\t\t\t\t// Again, an IPv6 address is most likely in a compressed form\n\t\t\t\t\tif ($separator === ':')\n\t\t\t\t\t{\n\t\t\t\t\t\t$netaddr = explode(':', str_replace('::', str_repeat(':', 9 - substr_count($netaddr, ':')), $netaddr));\n\t\t\t\t\t\tfor ($j = 0; $j < 8; $j++)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t$netaddr[$j] = intval($netaddr[$j], 16);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\t$netaddr = explode('.', $netaddr);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Convert to binary and finally compare\n\t\t\t\t\tif (strncmp($ip, vsprintf($sprintf, $netaddr), $masklen) === 0)\n\t\t\t\t\t{\n\t\t\t\t\t\t$this->ip_address = $spoof;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ( ! $this->valid_ip($this->ip_address))\n\t\t{\n\t\t\treturn $this->ip_address = '0.0.0.0';\n\t\t}\n\n\t\treturn $this->ip_address;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Validate IP Address\n\t *\n\t * @param\tstring\t$ip\tIP address\n\t * @param\tstring\t$which\tIP protocol: 'ipv4' or 'ipv6'\n\t * @return\tbool\n\t */\n\tpublic function valid_ip($ip, $which = '')\n\t{\n\t\tswitch (strtolower($which))\n\t\t{\n\t\t\tcase 'ipv4':\n\t\t\t\t$which = FILTER_FLAG_IPV4;\n\t\t\t\tbreak;\n\t\t\tcase 'ipv6':\n\t\t\t\t$which = FILTER_FLAG_IPV6;\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t$which = 0;\n\t\t\t\tbreak;\n\t\t}\n\n\t\treturn (bool) filter_var($ip, FILTER_VALIDATE_IP, $which);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch User Agent string\n\t *\n\t * @return\tstring|null\tUser Agent string or NULL if it doesn't exist\n\t */\n\tpublic function user_agent($xss_clean = FALSE)\n\t{\n\t\treturn $this->_fetch_from_array($_SERVER, 'HTTP_USER_AGENT', $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Request Headers\n\t *\n\t * @param\tbool\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tarray\n\t */\n\tpublic function request_headers($xss_clean = FALSE)\n\t{\n\t\t// If header is already defined, return it immediately\n\t\tif ( ! empty($this->headers))\n\t\t{\n\t\t\treturn $this->_fetch_from_array($this->headers, NULL, $xss_clean);\n\t\t}\n\n\t\t// In Apache, you can simply call apache_request_headers()\n\t\tif (function_exists('apache_request_headers'))\n\t\t{\n\t\t\t$this->headers = apache_request_headers();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tisset($_SERVER['CONTENT_TYPE']) && $this->headers['Content-Type'] = $_SERVER['CONTENT_TYPE'];\n\n\t\t\tforeach ($_SERVER as $key => $val)\n\t\t\t{\n\t\t\t\tif (sscanf($key, 'HTTP_%s', $header) === 1)\n\t\t\t\t{\n\t\t\t\t\t// take SOME_HEADER and turn it into Some-Header\n\t\t\t\t\t$header = str_replace('_', ' ', strtolower($header));\n\t\t\t\t\t$header = str_replace(' ', '-', ucwords($header));\n\n\t\t\t\t\t$this->headers[$header] = $_SERVER[$key];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn $this->_fetch_from_array($this->headers, NULL, $xss_clean);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Request Header\n\t *\n\t * Returns the value of a single member of the headers class member\n\t *\n\t * @param\tstring\t\t$index\t\tHeader name\n\t * @param\tbool\t\t$xss_clean\tWhether to apply XSS filtering\n\t * @return\tstring|null\tThe requested header on success or NULL on failure\n\t */\n\tpublic function get_request_header($index, $xss_clean = FALSE)\n\t{\n\t\tstatic $headers;\n\n\t\tif ( ! isset($headers))\n\t\t{\n\t\t\tempty($this->headers) && $this->request_headers();\n\t\t\tforeach ($this->headers as $key => $value)\n\t\t\t{\n\t\t\t\t$headers[strtolower($key)] = $value;\n\t\t\t}\n\t\t}\n\n\t\t$index = strtolower($index);\n\n\t\tif ( ! isset($headers[$index]))\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\treturn ($xss_clean === TRUE)\n\t\t\t? $this->security->xss_clean($headers[$index])\n\t\t\t: $headers[$index];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Is AJAX request?\n\t *\n\t * Test to see if a request contains the HTTP_X_REQUESTED_WITH header.\n\t *\n\t * @return \tbool\n\t */\n\tpublic function is_ajax_request()\n\t{\n\t\treturn ( ! empty($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Request Method\n\t *\n\t * Return the request method\n\t *\n\t * @param\tbool\t$upper\tWhether to return in upper or lower case\n\t *\t\t\t\t(default: FALSE)\n\t * @return \tstring\n\t */\n\tpublic function method($upper = FALSE)\n\t{\n\t\treturn ($upper)\n\t\t\t? strtoupper($this->server('REQUEST_METHOD'))\n\t\t\t: strtolower($this->server('REQUEST_METHOD'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\t/**\n\t * Magic __get()\n\t *\n\t * Allows read access to protected properties\n\t *\n\t * @param\tstring\t$name\n\t * @return\tmixed\n\t */\n\tpublic function __get($name)\n\t{\n\t\tif ($name === 'raw_input_stream')\n\t\t{\n\t\t\tisset($this->_raw_input_stream) OR $this->_raw_input_stream = file_get_contents('php://input');\n\t\t\treturn $this->_raw_input_stream;\n\t\t}\n\t\telseif ($name === 'ip_address')\n\t\t{\n\t\t\treturn $this->ip_address;\n\t\t}\n\t}\n\n}\n" }, { "path": "system/core/Lang.php", "content": "load($value, $idiom, $return, $add_suffix, $alt_path);\n\t\t\t}\n\n\t\t\treturn;\n\t\t}\n\n\t\t$langfile = str_replace('.php', '', $langfile);\n\n\t\tif ($add_suffix === TRUE)\n\t\t{\n\t\t\t$langfile = preg_replace('/_lang$/', '', $langfile).'_lang';\n\t\t}\n\n\t\t$langfile .= '.php';\n\n\t\tif (empty($idiom) OR ! preg_match('/^[a-z_-]+$/i', $idiom))\n\t\t{\n\t\t\t$config =& get_config();\n\t\t\t$idiom = empty($config['language']) ? 'english' : $config['language'];\n\t\t}\n\n\t\tif ($return === FALSE && isset($this->is_loaded[$langfile]) && $this->is_loaded[$langfile] === $idiom)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Load the base file, so any others found can override it\n\t\t$basepath = BASEPATH.'language/'.$idiom.'/'.$langfile;\n\t\tif (($found = file_exists($basepath)) === TRUE)\n\t\t{\n\t\t\tinclude($basepath);\n\t\t}\n\n\t\t// Do we have an alternative path to look in?\n\t\tif ($alt_path !== '')\n\t\t{\n\t\t\t$alt_path .= 'language/'.$idiom.'/'.$langfile;\n\t\t\tif (file_exists($alt_path))\n\t\t\t{\n\t\t\t\tinclude($alt_path);\n\t\t\t\t$found = TRUE;\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\tforeach (get_instance()->load->get_package_paths(TRUE) as $package_path)\n\t\t\t{\n\t\t\t\t$package_path .= 'language/'.$idiom.'/'.$langfile;\n\t\t\t\tif ($basepath !== $package_path && file_exists($package_path))\n\t\t\t\t{\n\t\t\t\t\tinclude($package_path);\n\t\t\t\t\t$found = TRUE;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ($found !== TRUE)\n\t\t{\n\t\t\tshow_error('Unable to load the requested language file: language/'.$idiom.'/'.$langfile);\n\t\t}\n\n\t\tif ( ! isset($lang) OR ! is_array($lang))\n\t\t{\n\t\t\tlog_message('error', 'Language file contains no data: language/'.$idiom.'/'.$langfile);\n\n\t\t\tif ($return === TRUE)\n\t\t\t{\n\t\t\t\treturn array();\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif ($return === TRUE)\n\t\t{\n\t\t\treturn $lang;\n\t\t}\n\n\t\t$this->is_loaded[$langfile] = $idiom;\n\t\t$this->language = array_merge($this->language, $lang);\n\n\t\tlog_message('info', 'Language file loaded: language/'.$idiom.'/'.$langfile);\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Language line\n\t *\n\t * Fetches a single line of text from the language array\n\t *\n\t * @param\tstring\t$line\t\tLanguage line key\n\t * @param\tbool\t$log_errors\tWhether to log an error message if the line is not found\n\t * @return\tstring\tTranslation\n\t */\n\tpublic function line($line, $log_errors = TRUE)\n\t{\n\t\t$value = isset($this->language[$line]) ? $this->language[$line] : FALSE;\n\n\t\t// Because killer robots like unicorns!\n\t\tif ($value === FALSE && $log_errors === TRUE)\n\t\t{\n\t\t\tlog_message('error', 'Could not find the language line \"'.$line.'\"');\n\t\t}\n\n\t\treturn $value;\n\t}\n\n}\n" }, { "path": "system/core/Loader.php", "content": " TRUE);\n\n\t/**\n\t * List of paths to load libraries from\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_library_paths =\tarray(APPPATH, BASEPATH);\n\n\t/**\n\t * List of paths to load models from\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_model_paths =\tarray(APPPATH);\n\n\t/**\n\t * List of paths to load helpers from\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_helper_paths =\tarray(APPPATH, BASEPATH);\n\n\t/**\n\t * List of cached variables\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_cached_vars =\tarray();\n\n\t/**\n\t * Stack of variable arrays to provide nested _ci_load calls with all variables from parent calls\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_load_vars_stack =\tarray();\n\n\t/**\n\t * List of loaded classes\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_classes =\tarray();\n\n\t/**\n\t * List of loaded models\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_models =\tarray();\n\n\t/**\n\t * List of loaded helpers\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_helpers =\tarray();\n\n\t/**\n\t * List of class name mappings\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_ci_varmap =\tarray(\n\t\t'unit_test' => 'unit',\n\t\t'user_agent' => 'agent'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Class constructor\n\t *\n\t * Sets component load paths, gets the initial output buffering level.\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function __construct()\n\t{\n\t\t$this->_ci_ob_level = ob_get_level();\n\t\t$this->_ci_classes =& is_loaded();\n\n\t\tlog_message('info', 'Loader Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Initializer\n\t *\n\t * @todo\tFigure out a way to move this to the constructor\n\t *\t\twithout breaking *package_path*() methods.\n\t * @uses\tCI_Loader::_ci_autoloader()\n\t * @used-by\tCI_Controller::__construct()\n\t * @return\tvoid\n\t */\n\tpublic function initialize()\n\t{\n\t\t$this->_ci_autoloader();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Is Loaded\n\t *\n\t * A utility method to test if a class is in the self::$_ci_classes array.\n\t *\n\t * @used-by\tMainly used by Form Helper function _get_validation_object().\n\t *\n\t * @param \tstring\t\t$class\tClass name to check for\n\t * @return \tstring|bool\tClass object name if loaded or FALSE\n\t */\n\tpublic function is_loaded($class)\n\t{\n\t\treturn array_search(ucfirst($class), $this->_ci_classes, TRUE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Library Loader\n\t *\n\t * Loads and instantiates libraries.\n\t * Designed to be called from application controllers.\n\t *\n\t * @param\tmixed\t$library\tLibrary name\n\t * @param\tarray\t$params\t\tOptional parameters to pass to the library class constructor\n\t * @param\tstring\t$object_name\tAn optional object name to assign to\n\t * @return\tobject\n\t */\n\tpublic function library($library, $params = NULL, $object_name = NULL)\n\t{\n\t\tif (empty($library))\n\t\t{\n\t\t\treturn $this;\n\t\t}\n\t\telseif (is_array($library))\n\t\t{\n\t\t\tforeach ($library as $key => $value)\n\t\t\t{\n\t\t\t\tif (is_int($key))\n\t\t\t\t{\n\t\t\t\t\t$this->library($value, $params);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$this->library($key, $params, $value);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn $this;\n\t\t}\n\n\t\tif ($params !== NULL && ! is_array($params))\n\t\t{\n\t\t\t$params = NULL;\n\t\t}\n\n\t\t$this->_ci_load_library($library, $params, $object_name);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Model Loader\n\t *\n\t * Loads and instantiates models.\n\t *\n\t * @param\tmixed\t$model\t\tModel name\n\t * @param\tstring\t$name\t\tAn optional object name to assign to\n\t * @param\tbool\t$db_conn\tAn optional database connection configuration to initialize\n\t * @return\tobject\n\t */\n\tpublic function model($model, $name = '', $db_conn = FALSE)\n\t{\n\t\tif (empty($model))\n\t\t{\n\t\t\treturn $this;\n\t\t}\n\t\telseif (is_array($model))\n\t\t{\n\t\t\tforeach ($model as $key => $value)\n\t\t\t{\n\t\t\t\tis_int($key) ? $this->model($value, '', $db_conn) : $this->model($key, $value, $db_conn);\n\t\t\t}\n\n\t\t\treturn $this;\n\t\t}\n\n\t\t$path = '';\n\n\t\t// Is the model in a sub-folder? If so, parse out the filename and path.\n\t\tif (($last_slash = strrpos($model, '/')) !== FALSE)\n\t\t{\n\t\t\t// The path is in front of the last slash\n\t\t\t$path = substr($model, 0, ++$last_slash);\n\n\t\t\t// And the model name behind it\n\t\t\t$model = substr($model, $last_slash);\n\t\t}\n\n\t\tif (empty($name))\n\t\t{\n\t\t\t$name = $model;\n\t\t}\n\n\t\tif (in_array($name, $this->_ci_models, TRUE))\n\t\t{\n\t\t\treturn $this;\n\t\t}\n\n\t\t$CI =& get_instance();\n\t\tif (isset($CI->$name))\n\t\t{\n\t\t\tthrow new RuntimeException('The model name you are loading is the name of a resource that is already being used: '.$name);\n\t\t}\n\n\t\tif ($db_conn !== FALSE && ! class_exists('CI_DB', FALSE))\n\t\t{\n\t\t\tif ($db_conn === TRUE)\n\t\t\t{\n\t\t\t\t$db_conn = '';\n\t\t\t}\n\n\t\t\t$this->database($db_conn, FALSE, TRUE);\n\t\t}\n\n\t\t// Note: All of the code under this condition used to be just:\n\t\t//\n\t\t// load_class('Model', 'core');\n\t\t//\n\t\t// However, load_class() instantiates classes\n\t\t// to cache them for later use and that prevents\n\t\t// MY_Model from being an abstract class and is\n\t\t// sub-optimal otherwise anyway.\n\t\tif ( ! class_exists('CI_Model', FALSE))\n\t\t{\n\t\t\t$app_path = APPPATH.'core'.DIRECTORY_SEPARATOR;\n\t\t\tif (file_exists($app_path.'Model.php'))\n\t\t\t{\n\t\t\t\trequire_once($app_path.'Model.php');\n\t\t\t\tif ( ! class_exists('CI_Model', FALSE))\n\t\t\t\t{\n\t\t\t\t\tthrow new RuntimeException($app_path.\"Model.php exists, but doesn't declare class CI_Model\");\n\t\t\t\t}\n\n\t\t\t\tlog_message('info', 'CI_Model class loaded');\n\t\t\t}\n\t\t\telseif ( ! class_exists('CI_Model', FALSE))\n\t\t\t{\n\t\t\t\trequire_once(BASEPATH.'core'.DIRECTORY_SEPARATOR.'Model.php');\n\t\t\t}\n\n\t\t\t$class = config_item('subclass_prefix').'Model';\n\t\t\tif (file_exists($app_path.$class.'.php'))\n\t\t\t{\n\t\t\t\trequire_once($app_path.$class.'.php');\n\t\t\t\tif ( ! class_exists($class, FALSE))\n\t\t\t\t{\n\t\t\t\t\tthrow new RuntimeException($app_path.$class.\".php exists, but doesn't declare class \".$class);\n\t\t\t\t}\n\n\t\t\t\tlog_message('info', config_item('subclass_prefix').'Model class loaded');\n\t\t\t}\n\t\t}\n\n\t\t$model = ucfirst($model);\n\t\tif ( ! class_exists($model, FALSE))\n\t\t{\n\t\t\tforeach ($this->_ci_model_paths as $mod_path)\n\t\t\t{\n\t\t\t\tif ( ! file_exists($mod_path.'models/'.$path.$model.'.php'))\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\trequire_once($mod_path.'models/'.$path.$model.'.php');\n\t\t\t\tif ( ! class_exists($model, FALSE))\n\t\t\t\t{\n\t\t\t\t\tthrow new RuntimeException($mod_path.\"models/\".$path.$model.\".php exists, but doesn't declare class \".$model);\n\t\t\t\t}\n\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tif ( ! class_exists($model, FALSE))\n\t\t\t{\n\t\t\t\tthrow new RuntimeException('Unable to locate the model you have specified: '.$model);\n\t\t\t}\n\t\t}\n\n\t\tif ( ! is_subclass_of($model, 'CI_Model'))\n\t\t{\n\t\t\tthrow new RuntimeException(\"Class \".$model.\" doesn't extend CI_Model\");\n\t\t}\n\n\t\t$this->_ci_models[] = $name;\n\t\t$model = new $model();\n\t\t$CI->$name = $model;\n\t\tlog_message('info', 'Model \"'.get_class($model).'\" initialized');\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database Loader\n\t *\n\t * @param\tmixed\t$params\t\tDatabase configuration options\n\t * @param\tbool\t$return \tWhether to return the database object\n\t * @return\tobject|bool\tDatabase object if $return is set to TRUE,\n\t *\t\t\t\t\tFALSE on failure, CI_Loader instance in any other case\n\t */\n\tpublic function database($params = '', $return = FALSE)\n\t{\n\t\t// Grab the super object\n\t\t$CI =& get_instance();\n\n\t\t// Do we even need to load the database class?\n\t\tif ($return === FALSE && isset($CI->db) && is_object($CI->db) && ! empty($CI->db->conn_id))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\trequire_once(BASEPATH.'database/DB.php');\n\n\t\tif ($return === TRUE)\n\t\t{\n\t\t\treturn DB($params);\n\t\t}\n\n\t\t// Initialize the db variable. Needed to prevent\n\t\t// reference errors with some configurations\n\t\t$CI->db = '';\n\n\t\t// Load the DB class\n\t\t$CI->db =& DB($params);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Load the Database Utilities Class\n\t *\n\t * @param\tobject\t$db\tDatabase object\n\t * @param\tbool\t$return\tWhether to return the DB Utilities class object or not\n\t * @return\tobject\n\t */\n\tpublic function dbutil($db = NULL, $return = FALSE)\n\t{\n\t\t$CI =& get_instance();\n\n\t\tif ( ! is_object($db) OR ! ($db instanceof CI_DB))\n\t\t{\n\t\t\tclass_exists('CI_DB', FALSE) OR $this->database();\n\t\t\t$db =& $CI->db;\n\t\t}\n\n\t\trequire_once(BASEPATH.'database/DB_utility.php');\n\t\trequire_once(BASEPATH.'database/drivers/'.$db->dbdriver.'/'.$db->dbdriver.'_utility.php');\n\t\t$class = 'CI_DB_'.$db->dbdriver.'_utility';\n\n\t\tif ($return === TRUE)\n\t\t{\n\t\t\treturn new $class($db);\n\t\t}\n\n\t\t$CI->dbutil = new $class($db);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Load the Database Forge Class\n\t *\n\t * @param\tobject\t$db\tDatabase object\n\t * @param\tbool\t$return\tWhether to return the DB Forge class object or not\n\t * @return\tobject\n\t */\n\tpublic function dbforge($db = NULL, $return = FALSE)\n\t{\n\t\t$CI =& get_instance();\n\t\tif ( ! is_object($db) OR ! ($db instanceof CI_DB))\n\t\t{\n\t\t\tclass_exists('CI_DB', FALSE) OR $this->database();\n\t\t\t$db =& $CI->db;\n\t\t}\n\n\t\trequire_once(BASEPATH.'database/DB_forge.php');\n\t\trequire_once(BASEPATH.'database/drivers/'.$db->dbdriver.'/'.$db->dbdriver.'_forge.php');\n\n\t\tif ( ! empty($db->subdriver))\n\t\t{\n\t\t\t$driver_path = BASEPATH.'database/drivers/'.$db->dbdriver.'/subdrivers/'.$db->dbdriver.'_'.$db->subdriver.'_forge.php';\n\t\t\tif (file_exists($driver_path))\n\t\t\t{\n\t\t\t\trequire_once($driver_path);\n\t\t\t\t$class = 'CI_DB_'.$db->dbdriver.'_'.$db->subdriver.'_forge';\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$class = 'CI_DB_'.$db->dbdriver.'_forge';\n\t\t}\n\n\t\tif ($return === TRUE)\n\t\t{\n\t\t\treturn new $class($db);\n\t\t}\n\n\t\t$CI->dbforge = new $class($db);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * View Loader\n\t *\n\t * Loads \"view\" files.\n\t *\n\t * @param\tstring\t$view\tView name\n\t * @param\tarray\t$vars\tAn associative array of data\n\t *\t\t\t\tto be extracted for use in the view\n\t * @param\tbool\t$return\tWhether to return the view output\n\t *\t\t\t\tor leave it to the Output class\n\t * @return\tobject|string\n\t */\n\tpublic function view($view, $vars = array(), $return = FALSE)\n\t{\n\t\treturn $this->_ci_load(array('_ci_view' => $view, '_ci_vars' => $this->_ci_prepare_view_vars($vars), '_ci_return' => $return));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Generic File Loader\n\t *\n\t * @param\tstring\t$path\tFile path\n\t * @param\tbool\t$return\tWhether to return the file output\n\t * @return\tobject|string\n\t */\n\tpublic function file($path, $return = FALSE)\n\t{\n\t\treturn $this->_ci_load(array('_ci_path' => $path, '_ci_return' => $return));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Variables\n\t *\n\t * Once variables are set they become available within\n\t * the controller class and its \"view\" files.\n\t *\n\t * @param\tarray|object|string\t$vars\n\t *\t\t\t\t\tAn associative array or object containing values\n\t *\t\t\t\t\tto be set, or a value's name if string\n\t * @param \tstring\t$val\tValue to set, only used if $vars is a string\n\t * @return\tobject\n\t */\n\tpublic function vars($vars, $val = '')\n\t{\n\t\t$vars = is_string($vars)\n\t\t\t? array($vars => $val)\n\t\t\t: $this->_ci_prepare_view_vars($vars);\n\n\t\tforeach ($vars as $key => $val)\n\t\t{\n\t\t\t$this->_ci_cached_vars[$key] = $val;\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Clear Cached Variables\n\t *\n\t * Clears the cached variables.\n\t *\n\t * @return\tCI_Loader\n\t */\n\tpublic function clear_vars()\n\t{\n\t\t$this->_ci_cached_vars = array();\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Variable\n\t *\n\t * Check if a variable is set and retrieve it.\n\t *\n\t * @param\tstring\t$key\tVariable name\n\t * @return\tmixed\tThe variable or NULL if not found\n\t */\n\tpublic function get_var($key)\n\t{\n\t\treturn isset($this->_ci_cached_vars[$key]) ? $this->_ci_cached_vars[$key] : NULL;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Variables\n\t *\n\t * Retrieves all loaded variables.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function get_vars()\n\t{\n\t\treturn $this->_ci_cached_vars;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Helper Loader\n\t *\n\t * @param\tstring|string[]\t$helpers\tHelper name(s)\n\t * @return\tobject\n\t */\n\tpublic function helper($helpers = array())\n\t{\n\t\tis_array($helpers) OR $helpers = array($helpers);\n\t\tforeach ($helpers as &$helper)\n\t\t{\n\t\t\t$filename = basename($helper);\n\t\t\t$filepath = ($filename === $helper) ? '' : substr($helper, 0, strlen($helper) - strlen($filename));\n\t\t\t$filename = strtolower(preg_replace('#(_helper)?(\\.php)?$#i', '', $filename)).'_helper';\n\t\t\t$helper = $filepath.$filename;\n\n\t\t\tif (isset($this->_ci_helpers[$helper]))\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Is this a helper extension request?\n\t\t\t$ext_helper = config_item('subclass_prefix').$filename;\n\t\t\t$ext_loaded = FALSE;\n\t\t\tforeach ($this->_ci_helper_paths as $path)\n\t\t\t{\n\t\t\t\tif (file_exists($path.'helpers/'.$ext_helper.'.php'))\n\t\t\t\t{\n\t\t\t\t\tinclude_once($path.'helpers/'.$ext_helper.'.php');\n\t\t\t\t\t$ext_loaded = TRUE;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// If we have loaded extensions - check if the base one is here\n\t\t\tif ($ext_loaded === TRUE)\n\t\t\t{\n\t\t\t\t$base_helper = BASEPATH.'helpers/'.$helper.'.php';\n\t\t\t\tif ( ! file_exists($base_helper))\n\t\t\t\t{\n\t\t\t\t\tshow_error('Unable to load the requested file: helpers/'.$helper.'.php');\n\t\t\t\t}\n\n\t\t\t\tinclude_once($base_helper);\n\t\t\t\t$this->_ci_helpers[$helper] = TRUE;\n\t\t\t\tlog_message('info', 'Helper loaded: '.$helper);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// No extensions found ... try loading regular helpers and/or overrides\n\t\t\tforeach ($this->_ci_helper_paths as $path)\n\t\t\t{\n\t\t\t\tif (file_exists($path.'helpers/'.$helper.'.php'))\n\t\t\t\t{\n\t\t\t\t\tinclude_once($path.'helpers/'.$helper.'.php');\n\n\t\t\t\t\t$this->_ci_helpers[$helper] = TRUE;\n\t\t\t\t\tlog_message('info', 'Helper loaded: '.$helper);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// unable to load the helper\n\t\t\tif ( ! isset($this->_ci_helpers[$helper]))\n\t\t\t{\n\t\t\t\tshow_error('Unable to load the requested file: helpers/'.$helper.'.php');\n\t\t\t}\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Load Helpers\n\t *\n\t * An alias for the helper() method in case the developer has\n\t * written the plural form of it.\n\t *\n\t * @uses\tCI_Loader::helper()\n\t * @param\tstring|string[]\t$helpers\tHelper name(s)\n\t * @return\tobject\n\t */\n\tpublic function helpers($helpers = array())\n\t{\n\t\treturn $this->helper($helpers);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Language Loader\n\t *\n\t * Loads language files.\n\t *\n\t * @param\tstring|string[]\t$files\tList of language file names to load\n\t * @param\tstring\t\tLanguage name\n\t * @return\tobject\n\t */\n\tpublic function language($files, $lang = '')\n\t{\n\t\tget_instance()->lang->load($files, $lang);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Config Loader\n\t *\n\t * Loads a config file (an alias for CI_Config::load()).\n\t *\n\t * @uses\tCI_Config::load()\n\t * @param\tstring\t$file\t\t\tConfiguration file name\n\t * @param\tbool\t$use_sections\t\tWhether configuration values should be loaded into their own section\n\t * @param\tbool\t$fail_gracefully\tWhether to just return FALSE or display an error message\n\t * @return\tbool\tTRUE if the file was loaded correctly or FALSE on failure\n\t */\n\tpublic function config($file, $use_sections = FALSE, $fail_gracefully = FALSE)\n\t{\n\t\treturn get_instance()->config->load($file, $use_sections, $fail_gracefully);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Driver Loader\n\t *\n\t * Loads a driver library.\n\t *\n\t * @param\tstring|string[]\t$library\tDriver name(s)\n\t * @param\tarray\t\t$params\t\tOptional parameters to pass to the driver\n\t * @param\tstring\t\t$object_name\tAn optional object name to assign to\n\t *\n\t * @return\tobject|bool\tObject or FALSE on failure if $library is a string\n\t *\t\t\t\tand $object_name is set. CI_Loader instance otherwise.\n\t */\n\tpublic function driver($library, $params = NULL, $object_name = NULL)\n\t{\n\t\tif (is_array($library))\n\t\t{\n\t\t\tforeach ($library as $key => $value)\n\t\t\t{\n\t\t\t\tif (is_int($key))\n\t\t\t\t{\n\t\t\t\t\t$this->driver($value, $params);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$this->driver($key, $params, $value);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn $this;\n\t\t}\n\t\telseif (empty($library))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ( ! class_exists('CI_Driver_Library', FALSE))\n\t\t{\n\t\t\t// We aren't instantiating an object here, just making the base class available\n\t\t\trequire BASEPATH.'libraries/Driver.php';\n\t\t}\n\n\t\t// We can save the loader some time since Drivers will *always* be in a subfolder,\n\t\t// and typically identically named to the library\n\t\tif ( ! strpos($library, '/'))\n\t\t{\n\t\t\t$library = ucfirst($library).'/'.$library;\n\t\t}\n\n\t\treturn $this->library($library, $params, $object_name);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Add Package Path\n\t *\n\t * Prepends a parent path to the library, model, helper and config\n\t * path arrays.\n\t *\n\t * @see\tCI_Loader::$_ci_library_paths\n\t * @see\tCI_Loader::$_ci_model_paths\n\t * @see CI_Loader::$_ci_helper_paths\n\t * @see CI_Config::$_config_paths\n\t *\n\t * @param\tstring\t$path\t\tPath to add\n\t * @param \tbool\t$view_cascade\t(default: TRUE)\n\t * @return\tobject\n\t */\n\tpublic function add_package_path($path, $view_cascade = TRUE)\n\t{\n\t\t$path = rtrim($path, '/').'/';\n\n\t\tarray_unshift($this->_ci_library_paths, $path);\n\t\tarray_unshift($this->_ci_model_paths, $path);\n\t\tarray_unshift($this->_ci_helper_paths, $path);\n\n\t\t$this->_ci_view_paths = array($path.'views/' => $view_cascade) + $this->_ci_view_paths;\n\n\t\t// Add config file path\n\t\t$config =& $this->_ci_get_component('config');\n\t\t$config->_config_paths[] = $path;\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Package Paths\n\t *\n\t * Return a list of all package paths.\n\t *\n\t * @param\tbool\t$include_base\tWhether to include BASEPATH (default: FALSE)\n\t * @return\tarray\n\t */\n\tpublic function get_package_paths($include_base = FALSE)\n\t{\n\t\treturn ($include_base === TRUE) ? $this->_ci_library_paths : $this->_ci_model_paths;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Remove Package Path\n\t *\n\t * Remove a path from the library, model, helper and/or config\n\t * path arrays if it exists. If no path is provided, the most recently\n\t * added path will be removed removed.\n\t *\n\t * @param\tstring\t$path\tPath to remove\n\t * @return\tobject\n\t */\n\tpublic function remove_package_path($path = '')\n\t{\n\t\t$config =& $this->_ci_get_component('config');\n\n\t\tif ($path === '')\n\t\t{\n\t\t\tarray_shift($this->_ci_library_paths);\n\t\t\tarray_shift($this->_ci_model_paths);\n\t\t\tarray_shift($this->_ci_helper_paths);\n\t\t\tarray_shift($this->_ci_view_paths);\n\t\t\tarray_pop($config->_config_paths);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$path = rtrim($path, '/').'/';\n\t\t\tforeach (array('_ci_library_paths', '_ci_model_paths', '_ci_helper_paths') as $var)\n\t\t\t{\n\t\t\t\tif (($key = array_search($path, $this->{$var})) !== FALSE)\n\t\t\t\t{\n\t\t\t\t\tunset($this->{$var}[$key]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isset($this->_ci_view_paths[$path.'views/']))\n\t\t\t{\n\t\t\t\tunset($this->_ci_view_paths[$path.'views/']);\n\t\t\t}\n\n\t\t\tif (($key = array_search($path, $config->_config_paths)) !== FALSE)\n\t\t\t{\n\t\t\t\tunset($config->_config_paths[$key]);\n\t\t\t}\n\t\t}\n\n\t\t// make sure the application default paths are still in the array\n\t\t$this->_ci_library_paths = array_unique(array_merge($this->_ci_library_paths, array(APPPATH, BASEPATH)));\n\t\t$this->_ci_helper_paths = array_unique(array_merge($this->_ci_helper_paths, array(APPPATH, BASEPATH)));\n\t\t$this->_ci_model_paths = array_unique(array_merge($this->_ci_model_paths, array(APPPATH)));\n\t\t$this->_ci_view_paths = array_merge($this->_ci_view_paths, array(APPPATH.'views/' => TRUE));\n\t\t$config->_config_paths = array_unique(array_merge($config->_config_paths, array(APPPATH)));\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal CI Data Loader\n\t *\n\t * Used to load views and files.\n\t *\n\t * Variables are prefixed with _ci_ to avoid symbol collision with\n\t * variables made available to view files.\n\t *\n\t * @used-by\tCI_Loader::view()\n\t * @used-by\tCI_Loader::file()\n\t * @param\tarray\t$_ci_data\tData to load\n\t * @return\tobject\n\t */\n\tprotected function _ci_load($_ci_data)\n\t{\n\t\t// Set the default data variables\n\t\tforeach (array('_ci_view', '_ci_vars', '_ci_path', '_ci_return') as $_ci_val)\n\t\t{\n\t\t\t$$_ci_val = isset($_ci_data[$_ci_val]) ? $_ci_data[$_ci_val] : FALSE;\n\t\t}\n\n\t\t$file_exists = FALSE;\n\n\t\t// Set the path to the requested file\n\t\tif (is_string($_ci_path) && $_ci_path !== '')\n\t\t{\n\t\t\t$_ci_x = explode('/', $_ci_path);\n\t\t\t$_ci_file = end($_ci_x);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$_ci_ext = pathinfo($_ci_view, PATHINFO_EXTENSION);\n\t\t\t$_ci_file = ($_ci_ext === '') ? $_ci_view.'.php' : $_ci_view;\n\n\t\t\tforeach ($this->_ci_view_paths as $_ci_view_file => $cascade)\n\t\t\t{\n\t\t\t\tif (file_exists($_ci_view_file.$_ci_file))\n\t\t\t\t{\n\t\t\t\t\t$_ci_path = $_ci_view_file.$_ci_file;\n\t\t\t\t\t$file_exists = TRUE;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif ( ! $cascade)\n\t\t\t\t{\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ( ! $file_exists && ! file_exists($_ci_path))\n\t\t{\n\t\t\tshow_error('Unable to load the requested file: '.$_ci_file);\n\t\t}\n\n\t\t// This allows anything loaded using $this->load (views, files, etc.)\n\t\t// to become accessible from within the Controller and Model functions.\n\t\t$_ci_CI =& get_instance();\n\t\tforeach (get_object_vars($_ci_CI) as $_ci_key => $_ci_var)\n\t\t{\n\t\t\tif ( ! isset($this->$_ci_key))\n\t\t\t{\n\t\t\t\t$this->$_ci_key =& $_ci_CI->$_ci_key;\n\t\t\t}\n\t\t}\n\n\t\t/*\n\t\t * Extract and stack variables\n\t\t *\n\t\t * You can either set variables using the dedicated $this->load->vars()\n\t\t * function or via the second parameter of this function. We'll merge\n\t\t * the two types so that loaded views and files have access to these\n\t\t * variables.\n\t\t * Additionally we want all subsequent nested _ci_load() calls embedded\n\t\t * within the current file to 'inherit' all variables that are\n\t\t * accessible to the current file. For this purpose we push the current\n\t\t * variable configuration (_ci_vars) to the stack and remove it again\n\t\t * after the file or view is completely loaded. Nested _ci_load() calls\n\t\t * within the current file extend the stack with their variable\n\t\t * configuration.\n\t\t */\n\n\t\tis_array($_ci_vars) OR $_ci_vars = array();\n\n\t\t// Include the global cached vars into the current _ci_vars if needed\n\t\tempty($this->_ci_cached_vars) OR $_ci_vars = array_merge($this->_ci_cached_vars, $_ci_vars);\n\n\t\t// Merge the last variable configuration from a parent _ci_load()\n\t\t// call into the current _ci_vars\n\t\tif ( ! empty($this->_ci_load_vars_stack))\n\t\t{\n\t\t\t$previous_variable_configuration = end($this->_ci_load_vars_stack);\n\t\t\t$_ci_vars = array_merge($previous_variable_configuration, $_ci_vars);\n\t\t}\n\n\t\tarray_push($this->_ci_load_vars_stack, $_ci_vars);\n\t\textract($_ci_vars);\n\n\t\t/**\n\t\t * Buffer the output\n\t\t *\n\t\t * We buffer the output for two reasons:\n\t\t * 1. Speed. You get a significant speed boost.\n\t\t * 2. So that the final rendered template can be post-processed by\n\t\t *\tthe output class. Why do we need post processing? For one thing,\n\t\t *\tin order to show the elapsed page load time. Unless we can\n\t\t *\tintercept the content right before it's sent to the browser and\n\t\t *\tthen stop the timer it won't be accurate.\n\t\t */\n\t\tob_start();\n\n\t\tinclude($_ci_path); // include() vs include_once() allows for multiple views with the same name\n\t\tlog_message('info', 'File loaded: '.$_ci_path);\n\n\t\t// Remove current _ci_vars from stack\n\t\tarray_pop($this->_ci_load_vars_stack);\n\n\t\t// Return the file data if requested\n\t\tif ($_ci_return === TRUE)\n\t\t{\n\t\t\t$buffer = ob_get_contents();\n\t\t\t@ob_end_clean();\n\t\t\treturn $buffer;\n\t\t}\n\n\t\t/*\n\t\t * Flush the buffer... or buff the flusher?\n\t\t *\n\t\t * In order to permit views to be nested within\n\t\t * other views, we need to flush the content back out whenever\n\t\t * we are beyond the first level of output buffering so that\n\t\t * it can be seen and included properly by the first included\n\t\t * template and any subsequent ones. Oy!\n\t\t */\n\t\tif (ob_get_level() > $this->_ci_ob_level + 1)\n\t\t{\n\t\t\tob_end_flush();\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$_ci_CI->output->append_output(ob_get_contents());\n\t\t\t@ob_end_clean();\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal CI Library Loader\n\t *\n\t * @used-by\tCI_Loader::library()\n\t * @uses\tCI_Loader::_ci_init_library()\n\t *\n\t * @param\tstring\t$class\t\tClass name to load\n\t * @param\tmixed\t$params\t\tOptional parameters to pass to the class constructor\n\t * @param\tstring\t$object_name\tOptional object name to assign to\n\t * @return\tvoid\n\t */\n\tprotected function _ci_load_library($class, $params = NULL, $object_name = NULL)\n\t{\n\t\t// Get the class name, and while we're at it trim any slashes.\n\t\t// The directory path can be included as part of the class name,\n\t\t// but we don't want a leading slash\n\t\t$class = str_replace('.php', '', trim($class, '/'));\n\n\t\t// Was the path included with the class name?\n\t\t// We look for a slash to determine this\n\t\tif (($last_slash = strrpos($class, '/')) !== FALSE)\n\t\t{\n\t\t\t// Extract the path\n\t\t\t$subdir = substr($class, 0, ++$last_slash);\n\n\t\t\t// Get the filename from the path\n\t\t\t$class = substr($class, $last_slash);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$subdir = '';\n\t\t}\n\n\t\t$class = ucfirst($class);\n\n\t\t// Is this a stock library? There are a few special conditions if so ...\n\t\tif (file_exists(BASEPATH.'libraries/'.$subdir.$class.'.php'))\n\t\t{\n\t\t\treturn $this->_ci_load_stock_library($class, $subdir, $params, $object_name);\n\t\t}\n\n\t\t// Safety: Was the class already loaded by a previous call?\n\t\tif (class_exists($class, FALSE))\n\t\t{\n\t\t\t$property = $object_name;\n\t\t\tif (empty($property))\n\t\t\t{\n\t\t\t\t$property = strtolower($class);\n\t\t\t\tisset($this->_ci_varmap[$property]) && $property = $this->_ci_varmap[$property];\n\t\t\t}\n\n\t\t\t$CI =& get_instance();\n\t\t\tif (isset($CI->$property))\n\t\t\t{\n\t\t\t\tlog_message('debug', $class.' class already loaded. Second attempt ignored.');\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\treturn $this->_ci_init_library($class, '', $params, $object_name);\n\t\t}\n\n\t\t// Let's search for the requested library file and load it.\n\t\tforeach ($this->_ci_library_paths as $path)\n\t\t{\n\t\t\t// BASEPATH has already been checked for\n\t\t\tif ($path === BASEPATH)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t$filepath = $path.'libraries/'.$subdir.$class.'.php';\n\t\t\t// Does the file exist? No? Bummer...\n\t\t\tif ( ! file_exists($filepath))\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tinclude_once($filepath);\n\t\t\treturn $this->_ci_init_library($class, '', $params, $object_name);\n\t\t}\n\n\t\t// One last attempt. Maybe the library is in a subdirectory, but it wasn't specified?\n\t\tif ($subdir === '')\n\t\t{\n\t\t\treturn $this->_ci_load_library($class.'/'.$class, $params, $object_name);\n\t\t}\n\n\t\t// If we got this far we were unable to find the requested class.\n\t\tlog_message('error', 'Unable to load the requested class: '.$class);\n\t\tshow_error('Unable to load the requested class: '.$class);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal CI Stock Library Loader\n\t *\n\t * @used-by\tCI_Loader::_ci_load_library()\n\t * @uses\tCI_Loader::_ci_init_library()\n\t *\n\t * @param\tstring\t$library_name\tLibrary name to load\n\t * @param\tstring\t$file_path\tPath to the library filename, relative to libraries/\n\t * @param\tmixed\t$params\t\tOptional parameters to pass to the class constructor\n\t * @param\tstring\t$object_name\tOptional object name to assign to\n\t * @return\tvoid\n\t */\n\tprotected function _ci_load_stock_library($library_name, $file_path, $params, $object_name)\n\t{\n\t\t$prefix = 'CI_';\n\n\t\tif (class_exists($prefix.$library_name, FALSE))\n\t\t{\n\t\t\tif (class_exists(config_item('subclass_prefix').$library_name, FALSE))\n\t\t\t{\n\t\t\t\t$prefix = config_item('subclass_prefix');\n\t\t\t}\n\n\t\t\t$property = $object_name;\n\t\t\tif (empty($property))\n\t\t\t{\n\t\t\t\t$property = strtolower($library_name);\n\t\t\t\tisset($this->_ci_varmap[$property]) && $property = $this->_ci_varmap[$property];\n\t\t\t}\n\n\t\t\t$CI =& get_instance();\n\t\t\tif ( ! isset($CI->$property))\n\t\t\t{\n\t\t\t\treturn $this->_ci_init_library($library_name, $prefix, $params, $object_name);\n\t\t\t}\n\n\t\t\tlog_message('debug', $library_name.' class already loaded. Second attempt ignored.');\n\t\t\treturn;\n\t\t}\n\n\t\t$paths = $this->_ci_library_paths;\n\t\tarray_pop($paths); // BASEPATH\n\t\tarray_pop($paths); // APPPATH (needs to be the first path checked)\n\t\tarray_unshift($paths, APPPATH);\n\n\t\tforeach ($paths as $path)\n\t\t{\n\t\t\tif (file_exists($path = $path.'libraries/'.$file_path.$library_name.'.php'))\n\t\t\t{\n\t\t\t\t// Override\n\t\t\t\tinclude_once($path);\n\t\t\t\tif (class_exists($prefix.$library_name, FALSE))\n\t\t\t\t{\n\t\t\t\t\treturn $this->_ci_init_library($library_name, $prefix, $params, $object_name);\n\t\t\t\t}\n\n\t\t\t\tlog_message('debug', $path.' exists, but does not declare '.$prefix.$library_name);\n\t\t\t}\n\t\t}\n\n\t\tinclude_once(BASEPATH.'libraries/'.$file_path.$library_name.'.php');\n\n\t\t// Check for extensions\n\t\t$subclass = config_item('subclass_prefix').$library_name;\n\t\tforeach ($paths as $path)\n\t\t{\n\t\t\tif (file_exists($path = $path.'libraries/'.$file_path.$subclass.'.php'))\n\t\t\t{\n\t\t\t\tinclude_once($path);\n\t\t\t\tif (class_exists($subclass, FALSE))\n\t\t\t\t{\n\t\t\t\t\t$prefix = config_item('subclass_prefix');\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tlog_message('debug', $path.' exists, but does not declare '.$subclass);\n\t\t\t}\n\t\t}\n\n\t\treturn $this->_ci_init_library($library_name, $prefix, $params, $object_name);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal CI Library Instantiator\n\t *\n\t * @used-by\tCI_Loader::_ci_load_stock_library()\n\t * @used-by\tCI_Loader::_ci_load_library()\n\t *\n\t * @param\tstring\t\t$class\t\tClass name\n\t * @param\tstring\t\t$prefix\t\tClass name prefix\n\t * @param\tarray|null|bool\t$config\t\tOptional configuration to pass to the class constructor:\n\t *\t\t\t\t\t\tFALSE to skip;\n\t *\t\t\t\t\t\tNULL to search in config paths;\n\t *\t\t\t\t\t\tarray containing configuration data\n\t * @param\tstring\t\t$object_name\tOptional object name to assign to\n\t * @return\tvoid\n\t */\n\tprotected function _ci_init_library($class, $prefix, $config = FALSE, $object_name = NULL)\n\t{\n\t\t// Is there an associated config file for this class? Note: these should always be lowercase\n\t\tif ($config === NULL)\n\t\t{\n\t\t\t// Fetch the config paths containing any package paths\n\t\t\t$config_component = $this->_ci_get_component('config');\n\n\t\t\tif (is_array($config_component->_config_paths))\n\t\t\t{\n\t\t\t\t$found = FALSE;\n\t\t\t\tforeach ($config_component->_config_paths as $path)\n\t\t\t\t{\n\t\t\t\t\t// We test for both uppercase and lowercase, for servers that\n\t\t\t\t\t// are case-sensitive with regard to file names. Load global first,\n\t\t\t\t\t// override with environment next\n\t\t\t\t\tif (file_exists($path.'config/'.strtolower($class).'.php'))\n\t\t\t\t\t{\n\t\t\t\t\t\tinclude($path.'config/'.strtolower($class).'.php');\n\t\t\t\t\t\t$found = TRUE;\n\t\t\t\t\t}\n\t\t\t\t\telseif (file_exists($path.'config/'.ucfirst(strtolower($class)).'.php'))\n\t\t\t\t\t{\n\t\t\t\t\t\tinclude($path.'config/'.ucfirst(strtolower($class)).'.php');\n\t\t\t\t\t\t$found = TRUE;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (file_exists($path.'config/'.ENVIRONMENT.'/'.strtolower($class).'.php'))\n\t\t\t\t\t{\n\t\t\t\t\t\tinclude($path.'config/'.ENVIRONMENT.'/'.strtolower($class).'.php');\n\t\t\t\t\t\t$found = TRUE;\n\t\t\t\t\t}\n\t\t\t\t\telseif (file_exists($path.'config/'.ENVIRONMENT.'/'.ucfirst(strtolower($class)).'.php'))\n\t\t\t\t\t{\n\t\t\t\t\t\tinclude($path.'config/'.ENVIRONMENT.'/'.ucfirst(strtolower($class)).'.php');\n\t\t\t\t\t\t$found = TRUE;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Break on the first found configuration, thus package\n\t\t\t\t\t// files are not overridden by default paths\n\t\t\t\t\tif ($found === TRUE)\n\t\t\t\t\t{\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$class_name = $prefix.$class;\n\n\t\t// Is the class name valid?\n\t\tif ( ! class_exists($class_name, FALSE))\n\t\t{\n\t\t\tlog_message('error', 'Non-existent class: '.$class_name);\n\t\t\tshow_error('Non-existent class: '.$class_name);\n\t\t}\n\n\t\t// Set the variable name we will assign the class to\n\t\t// Was a custom class name supplied? If so we'll use it\n\t\tif (empty($object_name))\n\t\t{\n\t\t\t$object_name = strtolower($class);\n\t\t\tif (isset($this->_ci_varmap[$object_name]))\n\t\t\t{\n\t\t\t\t$object_name = $this->_ci_varmap[$object_name];\n\t\t\t}\n\t\t}\n\n\t\t// Don't overwrite existing properties\n\t\t$CI =& get_instance();\n\t\tif (isset($CI->$object_name))\n\t\t{\n\t\t\tif ($CI->$object_name instanceof $class_name)\n\t\t\t{\n\t\t\t\tlog_message('debug', $class_name.\" has already been instantiated as '\".$object_name.\"'. Second attempt aborted.\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tshow_error(\"Resource '\".$object_name.\"' already exists and is not a \".$class_name.\" instance.\");\n\t\t}\n\n\t\t// Save the class name and object name\n\t\t$this->_ci_classes[$object_name] = $class;\n\n\t\t// Instantiate the class\n\t\t$CI->$object_name = isset($config)\n\t\t\t? new $class_name($config)\n\t\t\t: new $class_name();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * CI Autoloader\n\t *\n\t * Loads component listed in the config/autoload.php file.\n\t *\n\t * @used-by\tCI_Loader::initialize()\n\t * @return\tvoid\n\t */\n\tprotected function _ci_autoloader()\n\t{\n\t\tif (file_exists(APPPATH.'config/autoload.php'))\n\t\t{\n\t\t\tinclude(APPPATH.'config/autoload.php');\n\t\t}\n\n\t\tif (file_exists(APPPATH.'config/'.ENVIRONMENT.'/autoload.php'))\n\t\t{\n\t\t\tinclude(APPPATH.'config/'.ENVIRONMENT.'/autoload.php');\n\t\t}\n\n\t\tif ( ! isset($autoload))\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Autoload packages\n\t\tif (isset($autoload['packages']))\n\t\t{\n\t\t\tforeach ($autoload['packages'] as $package_path)\n\t\t\t{\n\t\t\t\t$this->add_package_path($package_path);\n\t\t\t}\n\t\t}\n\n\t\t// Load any custom config file\n\t\tif (count($autoload['config']) > 0)\n\t\t{\n\t\t\tforeach ($autoload['config'] as $val)\n\t\t\t{\n\t\t\t\t$this->config($val);\n\t\t\t}\n\t\t}\n\n\t\t// Autoload helpers and languages\n\t\tforeach (array('helper', 'language') as $type)\n\t\t{\n\t\t\tif (isset($autoload[$type]) && count($autoload[$type]) > 0)\n\t\t\t{\n\t\t\t\t$this->$type($autoload[$type]);\n\t\t\t}\n\t\t}\n\n\t\t// Autoload drivers\n\t\tif (isset($autoload['drivers']))\n\t\t{\n\t\t\t$this->driver($autoload['drivers']);\n\t\t}\n\n\t\t// Load libraries\n\t\tif (isset($autoload['libraries']) && count($autoload['libraries']) > 0)\n\t\t{\n\t\t\t// Load the database driver.\n\t\t\tif (in_array('database', $autoload['libraries']))\n\t\t\t{\n\t\t\t\t$this->database();\n\t\t\t\t$autoload['libraries'] = array_diff($autoload['libraries'], array('database'));\n\t\t\t}\n\n\t\t\t// Load all other libraries\n\t\t\t$this->library($autoload['libraries']);\n\t\t}\n\n\t\t// Autoload models\n\t\tif (isset($autoload['model']))\n\t\t{\n\t\t\t$this->model($autoload['model']);\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Prepare variables for _ci_vars, to be later extract()-ed inside views\n\t *\n\t * Converts objects to associative arrays and filters-out internal\n\t * variable names (i.e. keys prefixed with '_ci_').\n\t *\n\t * @param\tmixed\t$vars\n\t * @return\tarray\n\t */\n\tprotected function _ci_prepare_view_vars($vars)\n\t{\n\t\tif ( ! is_array($vars))\n\t\t{\n\t\t\t$vars = is_object($vars)\n\t\t\t\t? get_object_vars($vars)\n\t\t\t\t: array();\n\t\t}\n\n\t\tforeach (array_keys($vars) as $key)\n\t\t{\n\t\t\tif (strncmp($key, '_ci_', 4) === 0)\n\t\t\t{\n\t\t\t\tunset($vars[$key]);\n\t\t\t}\n\t\t}\n\n\t\treturn $vars;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * CI Component getter\n\t *\n\t * Get a reference to a specific library or model.\n\t *\n\t * @param \tstring\t$component\tComponent name\n\t * @return\tbool\n\t */\n\tprotected function &_ci_get_component($component)\n\t{\n\t\t$CI =& get_instance();\n\t\treturn $CI->$component;\n\t}\n}\n" }, { "path": "system/core/Log.php", "content": " 1, 'DEBUG' => 2, 'INFO' => 3, 'ALL' => 4);\n\n\t/**\n\t * mbstring.func_overload flag\n\t *\n\t * @var\tbool\n\t */\n\tprotected static $func_overload;\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Class constructor\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function __construct()\n\t{\n\t\t$config =& get_config();\n\n\t\tisset(self::$func_overload) OR self::$func_overload = ( ! is_php('8.0') && extension_loaded('mbstring') && @ini_get('mbstring.func_overload'));\n\n\t\t$this->_log_path = ($config['log_path'] !== '')\n\t\t\t? rtrim($config['log_path'], '/\\\\').DIRECTORY_SEPARATOR : APPPATH.'logs'.DIRECTORY_SEPARATOR;\n\n\t\t$this->_log_filename = (isset($config['log_filename']) && $config['log_filename'] !== '')\n\t\t\t? $config['log_filename'] : 'log-'.date('Y-m-d').'.php';\n\n\t\tfile_exists($this->_log_path) OR mkdir($this->_log_path, 0755, TRUE);\n\n\t\tif ( ! is_dir($this->_log_path) OR ! is_really_writable($this->_log_path))\n\t\t{\n\t\t\t$this->_enabled = FALSE;\n\t\t}\n\n\t\tif (is_numeric($config['log_threshold']))\n\t\t{\n\t\t\t$this->_threshold = (int) $config['log_threshold'];\n\t\t}\n\t\telseif (is_array($config['log_threshold']))\n\t\t{\n\t\t\t$this->_threshold = 0;\n\t\t\t$this->_threshold_array = array_flip($config['log_threshold']);\n\t\t}\n\n\t\tif ( ! empty($config['log_date_format']))\n\t\t{\n\t\t\t$this->_date_fmt = $config['log_date_format'];\n\t\t}\n\n\t\tif ( ! empty($config['log_file_permissions']) && is_int($config['log_file_permissions']))\n\t\t{\n\t\t\t$this->_file_permissions = $config['log_file_permissions'];\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Write Log File\n\t *\n\t * Generally this function will be called using the global log_message() function\n\t *\n\t * @param\tstring\t$level \tThe error level: 'error', 'debug' or 'info'\n\t * @param\tstring\t$msg \tThe error message\n\t * @return\tbool\n\t */\n\tpublic function write_log($level, $msg)\n\t{\n\t\tif ($this->_enabled === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$level = strtoupper($level);\n\n\t\tif (( ! isset($this->_levels[$level]) OR ($this->_levels[$level] > $this->_threshold))\n\t\t\t&& ! isset($this->_threshold_array[$this->_levels[$level]]))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$filepath = $this->_log_path.$this->_log_filename;\n\t\t$message = '';\n\n\t\tif ( ! file_exists($filepath))\n\t\t{\n\t\t\t$newfile = TRUE;\n\t\t\t// Only add protection to php files\n\t\t\tif (substr($this->_log_filename, -3, 3) === 'php')\n\t\t\t{\n\t\t\t\t$message .= \"\\n\\n\";\n\t\t\t}\n\t\t}\n\n\t\tif ( ! $fp = @fopen($filepath, 'ab'))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tflock($fp, LOCK_EX);\n\n\t\t// Instantiating DateTime with microseconds appended to initial date is needed for proper support of this format\n\t\tif (strpos($this->_date_fmt, 'u') !== FALSE)\n\t\t{\n\t\t\t$microtime_full = microtime(TRUE);\n\t\t\t$microtime_short = sprintf(\"%06d\", ($microtime_full - floor($microtime_full)) * 1000000);\n\t\t\t$date = new DateTime(date('Y-m-d H:i:s.'.$microtime_short, $microtime_full));\n\t\t\t$date = $date->format($this->_date_fmt);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$date = date($this->_date_fmt);\n\t\t}\n\n\t\t$message .= $this->_format_line($level, $date, $msg);\n\n\t\tfor ($written = 0, $length = self::strlen($message); $written < $length; $written += $result)\n\t\t{\n\t\t\tif (($result = fwrite($fp, self::substr($message, $written))) === FALSE)\n\t\t\t{\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tflock($fp, LOCK_UN);\n\t\tfclose($fp);\n\n\t\tif (isset($newfile) && $newfile === TRUE)\n\t\t{\n\t\t\tchmod($filepath, $this->_file_permissions);\n\t\t}\n\n\t\treturn is_int($result);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Format the log line.\n\t *\n\t * This is for extensibility of log formatting\n\t * If you want to change the log format, extend the CI_Log class and override this method\n\t *\n\t * @param\tstring\t$level \tThe error level\n\t * @param\tstring\t$date \tFormatted date string\n\t * @param\tstring\t$message \tThe log message\n\t * @return\tstring\tFormatted log line with a new line character at the end\n\t */\n\tprotected function _format_line($level, $date, $message)\n\t{\n\t\treturn $level.' - '.$date.' --> '.$message.PHP_EOL;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Byte-safe strlen()\n\t *\n\t * @param\tstring\t$str\n\t * @return\tint\n\t */\n\tprotected static function strlen($str)\n\t{\n\t\treturn (self::$func_overload)\n\t\t\t? mb_strlen($str, '8bit')\n\t\t\t: strlen($str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Byte-safe substr()\n\t *\n\t * @param\tstring\t$str\n\t * @param\tint\t$start\n\t * @param\tint\t$length\n\t * @return\tstring\n\t */\n\tprotected static function substr($str, $start, $length = NULL)\n\t{\n\t\tif (self::$func_overload)\n\t\t{\n\t\t\treturn mb_substr($str, $start, $length, '8bit');\n\t\t}\n\n\t\treturn isset($length)\n\t\t\t? substr($str, $start, $length)\n\t\t\t: substr($str, $start);\n\t}\n}\n" }, { "path": "system/core/Model.php", "content": "$key;\n\t}\n\n}\n" }, { "path": "system/core/Output.php", "content": "_zlib_oc = (bool) ini_get('zlib.output_compression');\n\t\t$this->_compress_output = (\n\t\t\t$this->_zlib_oc === FALSE\n\t\t\t&& config_item('compress_output') === TRUE\n\t\t\t&& extension_loaded('zlib')\n\t\t);\n\n\t\tisset(self::$func_overload) OR self::$func_overload = ( ! is_php('8.0') && extension_loaded('mbstring') && @ini_get('mbstring.func_overload'));\n\n\t\t// Get mime types for later\n\t\t$this->mimes =& get_mimes();\n\n\t\tlog_message('info', 'Output Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Output\n\t *\n\t * Returns the current output string.\n\t *\n\t * @return\tstring\n\t */\n\tpublic function get_output()\n\t{\n\t\treturn $this->final_output;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Output\n\t *\n\t * Sets the output string.\n\t *\n\t * @param\tstring\t$output\tOutput data\n\t * @return\tCI_Output\n\t */\n\tpublic function set_output($output)\n\t{\n\t\t$this->final_output = $output;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Append Output\n\t *\n\t * Appends data onto the output string.\n\t *\n\t * @param\tstring\t$output\tData to append\n\t * @return\tCI_Output\n\t */\n\tpublic function append_output($output)\n\t{\n\t\t$this->final_output .= $output;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Header\n\t *\n\t * Lets you set a server header which will be sent with the final output.\n\t *\n\t * Note: If a file is cached, headers will not be sent.\n\t * @todo\tWe need to figure out how to permit headers to be cached.\n\t *\n\t * @param\tstring\t$header\t\tHeader\n\t * @param\tbool\t$replace\tWhether to replace the old header value, if already set\n\t * @return\tCI_Output\n\t */\n\tpublic function set_header($header, $replace = TRUE)\n\t{\n\t\t// If zlib.output_compression is enabled it will compress the output,\n\t\t// but it will not modify the content-length header to compensate for\n\t\t// the reduction, causing the browser to hang waiting for more data.\n\t\t// We'll just skip content-length in those cases.\n\t\tif ($this->_zlib_oc && strncasecmp($header, 'content-length', 14) === 0)\n\t\t{\n\t\t\treturn $this;\n\t\t}\n\n\t\t$this->headers[] = array($header, $replace);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Content-Type Header\n\t *\n\t * @param\tstring\t$mime_type\tExtension of the file we're outputting\n\t * @param\tstring\t$charset\tCharacter set (default: NULL)\n\t * @return\tCI_Output\n\t */\n\tpublic function set_content_type($mime_type, $charset = NULL)\n\t{\n\t\tif (strpos($mime_type, '/') === FALSE)\n\t\t{\n\t\t\t$extension = ltrim($mime_type, '.');\n\n\t\t\t// Is this extension supported?\n\t\t\tif (isset($this->mimes[$extension]))\n\t\t\t{\n\t\t\t\t$mime_type =& $this->mimes[$extension];\n\n\t\t\t\tif (is_array($mime_type))\n\t\t\t\t{\n\t\t\t\t\t$mime_type = current($mime_type);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$this->mime_type = $mime_type;\n\n\t\tif (empty($charset))\n\t\t{\n\t\t\t$charset = config_item('charset');\n\t\t}\n\n\t\t$header = 'Content-Type: '.$mime_type\n\t\t\t.(empty($charset) ? '' : '; charset='.$charset);\n\n\t\t$this->headers[] = array($header, TRUE);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Current Content-Type Header\n\t *\n\t * @return\tstring\t'text/html', if not already set\n\t */\n\tpublic function get_content_type()\n\t{\n\t\tfor ($i = 0, $c = count($this->headers); $i < $c; $i++)\n\t\t{\n\t\t\tif (sscanf($this->headers[$i][0], 'Content-Type: %[^;]', $content_type) === 1)\n\t\t\t{\n\t\t\t\treturn $content_type;\n\t\t\t}\n\t\t}\n\n\t\treturn 'text/html';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get Header\n\t *\n\t * @param\tstring\t$header\n\t * @return\tstring\n\t */\n\tpublic function get_header($header)\n\t{\n\t\t// We only need [x][0] from our multi-dimensional array\n\t\t$header_lines = array_map(function ($headers)\n\t\t{\n\t\t\treturn array_shift($headers);\n\t\t}, $this->headers);\n\n\t\t$headers = array_merge(\n\t\t\t$header_lines,\n\t\t\theaders_list()\n\t\t);\n\n\t\tif (empty($headers) OR empty($header))\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\t// Count backwards, in order to get the last matching header\n\t\tfor ($c = count($headers) - 1; $c > -1; $c--)\n\t\t{\n\t\t\tif (strncasecmp($header, $headers[$c], $l = self::strlen($header)) === 0)\n\t\t\t{\n\t\t\t\treturn trim(self::substr($headers[$c], $l+1));\n\t\t\t}\n\t\t}\n\n\t\treturn NULL;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set HTTP Status Header\n\t *\n\t * As of version 1.7.2, this is an alias for common function\n\t * set_status_header().\n\t *\n\t * @param\tint\t$code\tStatus code (default: 200)\n\t * @param\tstring\t$text\tOptional message\n\t * @return\tCI_Output\n\t */\n\tpublic function set_status_header($code = 200, $text = '')\n\t{\n\t\tset_status_header($code, $text);\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Enable/disable Profiler\n\t *\n\t * @param\tbool\t$val\tTRUE to enable or FALSE to disable\n\t * @return\tCI_Output\n\t */\n\tpublic function enable_profiler($val = TRUE)\n\t{\n\t\t$this->enable_profiler = is_bool($val) ? $val : TRUE;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Profiler Sections\n\t *\n\t * Allows override of default/config settings for\n\t * Profiler section display.\n\t *\n\t * @param\tarray\t$sections\tProfiler sections\n\t * @return\tCI_Output\n\t */\n\tpublic function set_profiler_sections($sections)\n\t{\n\t\tif (isset($sections['query_toggle_count']))\n\t\t{\n\t\t\t$this->_profiler_sections['query_toggle_count'] = (int) $sections['query_toggle_count'];\n\t\t\tunset($sections['query_toggle_count']);\n\t\t}\n\n\t\tforeach ($sections as $section => $enable)\n\t\t{\n\t\t\t$this->_profiler_sections[$section] = ($enable !== FALSE);\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Cache\n\t *\n\t * @param\tint\t$time\tCache expiration time in minutes\n\t * @return\tCI_Output\n\t */\n\tpublic function cache($time)\n\t{\n\t\t$this->cache_expiration = is_numeric($time) ? $time : 0;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Display Output\n\t *\n\t * Processes and sends finalized output data to the browser along\n\t * with any server headers and profile data. It also stops benchmark\n\t * timers so the page rendering speed and memory usage can be shown.\n\t *\n\t * Note: All \"view\" data is automatically put into $this->final_output\n\t *\t by controller class.\n\t *\n\t * @uses\tCI_Output::$final_output\n\t * @param\tstring\t$output\tOutput data override\n\t * @return\tvoid\n\t */\n\tpublic function _display($output = NULL)\n\t{\n\t\t// Note: We use load_class() because we can't use $CI =& get_instance()\n\t\t// since this function is sometimes called by the caching mechanism,\n\t\t// which happens before the CI super object is available.\n\t\t$BM =& load_class('Benchmark', 'core');\n\t\t$CFG =& load_class('Config', 'core');\n\n\t\t// Grab the super object if we can.\n\t\tif (class_exists('CI_Controller', FALSE))\n\t\t{\n\t\t\t$CI =& get_instance();\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Set the output data\n\t\tif ($output === NULL)\n\t\t{\n\t\t\t$output =& $this->final_output;\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Do we need to write a cache file? Only if the controller does not have its\n\t\t// own _output() method and we are not dealing with a cache file, which we\n\t\t// can determine by the existence of the $CI object above\n\t\tif ($this->cache_expiration > 0 && isset($CI) && ! method_exists($CI, '_output'))\n\t\t{\n\t\t\t$this->_write_cache($output);\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Parse out the elapsed time and memory usage,\n\t\t// then swap the pseudo-variables with the data\n\n\t\t$elapsed = $BM->elapsed_time('total_execution_time_start', 'total_execution_time_end');\n\n\t\tif ($this->parse_exec_vars === TRUE)\n\t\t{\n\t\t\t$memory\t= round(memory_get_usage() / 1024 / 1024, 2).'MB';\n\t\t\t$output = str_replace(array('{elapsed_time}', '{memory_usage}'), array($elapsed, $memory), $output);\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Is compression requested?\n\t\tif (isset($CI) // This means that we're not serving a cache file, if we were, it would already be compressed\n\t\t\t&& $this->_compress_output === TRUE\n\t\t\t&& isset($_SERVER['HTTP_ACCEPT_ENCODING']) && strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip') !== FALSE)\n\t\t{\n\t\t\tob_start('ob_gzhandler');\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Are there any server headers to send?\n\t\tif (count($this->headers) > 0)\n\t\t{\n\t\t\tforeach ($this->headers as $header)\n\t\t\t{\n\t\t\t\t@header($header[0], $header[1]);\n\t\t\t}\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Does the $CI object exist?\n\t\t// If not we know we are dealing with a cache file so we'll\n\t\t// simply echo out the data and exit.\n\t\tif ( ! isset($CI))\n\t\t{\n\t\t\tif ($this->_compress_output === TRUE)\n\t\t\t{\n\t\t\t\tif (isset($_SERVER['HTTP_ACCEPT_ENCODING']) && strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip') !== FALSE)\n\t\t\t\t{\n\t\t\t\t\theader('Content-Encoding: gzip');\n\t\t\t\t\theader('Content-Length: '.self::strlen($output));\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// User agent doesn't support gzip compression,\n\t\t\t\t\t// so we'll have to decompress our cache\n\t\t\t\t\t$output = gzinflate(self::substr($output, 10, -8));\n\t\t\t\t}\n\t\t\t}\n\n\t\t\techo $output;\n\t\t\tlog_message('info', 'Final output sent to browser');\n\t\t\tlog_message('info', 'Total execution time: '.$elapsed);\n\t\t\treturn;\n\t\t}\n\n\t\t// --------------------------------------------------------------------\n\n\t\t// Do we need to generate profile data?\n\t\t// If so, load the Profile class and run it.\n\t\tif ($this->enable_profiler === TRUE)\n\t\t{\n\t\t\t$CI->load->library('profiler');\n\t\t\tif ( ! empty($this->_profiler_sections))\n\t\t\t{\n\t\t\t\t$CI->profiler->set_sections($this->_profiler_sections);\n\t\t\t}\n\n\t\t\t// If the output data contains closing and tags\n\t\t\t// we will remove them and add them back after we insert the profile data\n\t\t\t$output = preg_replace('|.*?|is', '', $output, -1, $count).$CI->profiler->run();\n\t\t\tif ($count > 0)\n\t\t\t{\n\t\t\t\t$output .= '';\n\t\t\t}\n\t\t}\n\n\t\t// Does the controller contain a function named _output()?\n\t\t// If so send the output there. Otherwise, echo it.\n\t\tif (method_exists($CI, '_output'))\n\t\t{\n\t\t\t$CI->_output($output);\n\t\t}\n\t\telse\n\t\t{\n\t\t\techo $output; // Send it to the browser!\n\t\t}\n\n\t\tlog_message('info', 'Final output sent to browser');\n\t\tlog_message('info', 'Total execution time: '.$elapsed);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Write Cache\n\t *\n\t * @param\tstring\t$output\tOutput data to cache\n\t * @return\tvoid\n\t */\n\tpublic function _write_cache($output)\n\t{\n\t\t$CI =& get_instance();\n\t\t$path = $CI->config->item('cache_path');\n\t\t$cache_path = ($path === '') ? APPPATH.'cache'.DIRECTORY_SEPARATOR : rtrim($path, '/\\\\').DIRECTORY_SEPARATOR;\n\n\t\tif ( ! is_dir($cache_path) OR ! is_really_writable($cache_path))\n\t\t{\n\t\t\tlog_message('error', 'Unable to write cache file: '.$cache_path);\n\t\t\treturn;\n\t\t}\n\n\t\t$uri = $CI->config->item('base_url')\n\t\t\t.$CI->config->slash_item('index_page')\n\t\t\t.$CI->uri->uri_string();\n\n\t\tif (($cache_query_string = $CI->config->item('cache_query_string')) && ! empty($_SERVER['QUERY_STRING']))\n\t\t{\n\t\t\tif (is_array($cache_query_string))\n\t\t\t{\n\t\t\t\t$uri .= '?'.http_build_query(array_intersect_key($_GET, array_flip($cache_query_string)));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$uri .= '?'.$_SERVER['QUERY_STRING'];\n\t\t\t}\n\t\t}\n\n\t\t$cache_path .= md5($uri);\n\n\t\tif ( ! $fp = @fopen($cache_path, 'w+b'))\n\t\t{\n\t\t\tlog_message('error', 'Unable to write cache file: '.$cache_path);\n\t\t\treturn;\n\t\t}\n\n\t\tif ( ! flock($fp, LOCK_EX))\n\t\t{\n\t\t\tlog_message('error', 'Unable to secure a file lock for file at: '.$cache_path);\n\t\t\tfclose($fp);\n\t\t\treturn;\n\t\t}\n\n\t\t// If output compression is enabled, compress the cache\n\t\t// itself, so that we don't have to do that each time\n\t\t// we're serving it\n\t\tif ($this->_compress_output === TRUE)\n\t\t{\n\t\t\t$output = gzencode($output);\n\n\t\t\tif ($this->get_header('content-type') === NULL)\n\t\t\t{\n\t\t\t\t$this->set_content_type($this->mime_type);\n\t\t\t}\n\t\t}\n\n\t\t$expire = time() + ($this->cache_expiration * 60);\n\n\t\t// Put together our serialized info.\n\t\t$cache_info = serialize(array(\n\t\t\t'expire'\t=> $expire,\n\t\t\t'headers'\t=> $this->headers\n\t\t));\n\n\t\t$output = $cache_info.'ENDCI--->'.$output;\n\n\t\tfor ($written = 0, $length = self::strlen($output); $written < $length; $written += $result)\n\t\t{\n\t\t\tif (($result = fwrite($fp, self::substr($output, $written))) === FALSE)\n\t\t\t{\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tflock($fp, LOCK_UN);\n\t\tfclose($fp);\n\n\t\tif ( ! is_int($result))\n\t\t{\n\t\t\t@unlink($cache_path);\n\t\t\tlog_message('error', 'Unable to write the complete cache content at: '.$cache_path);\n\t\t\treturn;\n\t\t}\n\n\t\tchmod($cache_path, 0640);\n\t\tlog_message('debug', 'Cache file written: '.$cache_path);\n\n\t\t// Send HTTP cache-control headers to browser to match file cache settings.\n\t\t$this->set_cache_header($_SERVER['REQUEST_TIME'], $expire);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update/serve cached output\n\t *\n\t * @uses\tCI_Config\n\t * @uses\tCI_URI\n\t *\n\t * @param\tobject\t&$CFG\tCI_Config class instance\n\t * @param\tobject\t&$URI\tCI_URI class instance\n\t * @return\tbool\tTRUE on success or FALSE on failure\n\t */\n\tpublic function _display_cache(&$CFG, &$URI)\n\t{\n\t\t$cache_path = ($CFG->item('cache_path') === '') ? APPPATH.'cache/' : $CFG->item('cache_path');\n\n\t\t// Build the file path. The file name is an MD5 hash of the full URI\n\t\t$uri = $CFG->item('base_url').$CFG->slash_item('index_page').$URI->uri_string;\n\n\t\tif (($cache_query_string = $CFG->item('cache_query_string')) && ! empty($_SERVER['QUERY_STRING']))\n\t\t{\n\t\t\tif (is_array($cache_query_string))\n\t\t\t{\n\t\t\t\t$uri .= '?'.http_build_query(array_intersect_key($_GET, array_flip($cache_query_string)));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$uri .= '?'.$_SERVER['QUERY_STRING'];\n\t\t\t}\n\t\t}\n\n\t\t$filepath = $cache_path.md5($uri);\n\n\t\tif ( ! file_exists($filepath) OR ! $fp = @fopen($filepath, 'rb'))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tflock($fp, LOCK_SH);\n\n\t\t$cache = (filesize($filepath) > 0) ? fread($fp, filesize($filepath)) : '';\n\n\t\tflock($fp, LOCK_UN);\n\t\tfclose($fp);\n\n\t\t// Look for embedded serialized file info.\n\t\tif ( ! preg_match('/^(.*)ENDCI--->/', $cache, $match))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$cache_info = unserialize($match[1]);\n\t\t$expire = $cache_info['expire'];\n\n\t\t$last_modified = filemtime($filepath);\n\n\t\t// Has the file expired?\n\t\tif ($_SERVER['REQUEST_TIME'] >= $expire && is_really_writable($cache_path))\n\t\t{\n\t\t\t// If so we'll delete it.\n\t\t\t@unlink($filepath);\n\t\t\tlog_message('debug', 'Cache file has expired. File deleted.');\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// Send the HTTP cache control headers\n\t\t$this->set_cache_header($last_modified, $expire);\n\n\t\t// Add headers from cache file.\n\t\tforeach ($cache_info['headers'] as $header)\n\t\t{\n\t\t\t$this->set_header($header[0], $header[1]);\n\t\t}\n\n\t\t// Display the cache\n\t\t$this->_display(self::substr($cache, self::strlen($match[0])));\n\t\tlog_message('debug', 'Cache file is current. Sending it to browser.');\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete cache\n\t *\n\t * @param\tstring\t$uri\tURI string\n\t * @return\tbool\n\t */\n\tpublic function delete_cache($uri = '')\n\t{\n\t\t$CI =& get_instance();\n\t\t$cache_path = $CI->config->item('cache_path');\n\t\tif ($cache_path === '')\n\t\t{\n\t\t\t$cache_path = APPPATH.'cache/';\n\t\t}\n\n\t\tif ( ! is_dir($cache_path))\n\t\t{\n\t\t\tlog_message('error', 'Unable to find cache path: '.$cache_path);\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (empty($uri))\n\t\t{\n\t\t\t$uri = $CI->uri->uri_string();\n\n\t\t\tif (($cache_query_string = $CI->config->item('cache_query_string')) && ! empty($_SERVER['QUERY_STRING']))\n\t\t\t{\n\t\t\t\tif (is_array($cache_query_string))\n\t\t\t\t{\n\t\t\t\t\t$uri .= '?'.http_build_query(array_intersect_key($_GET, array_flip($cache_query_string)));\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$uri .= '?'.$_SERVER['QUERY_STRING'];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$cache_path .= md5($CI->config->item('base_url').$CI->config->slash_item('index_page').ltrim($uri, '/'));\n\n\t\tif ( ! @unlink($cache_path))\n\t\t{\n\t\t\tlog_message('error', 'Unable to delete cache file for '.$uri);\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Cache Header\n\t *\n\t * Set the HTTP headers to match the server-side file cache settings\n\t * in order to reduce bandwidth.\n\t *\n\t * @param\tint\t$last_modified\tTimestamp of when the page was last modified\n\t * @param\tint\t$expiration\tTimestamp of when should the requested page expire from cache\n\t * @return\tvoid\n\t */\n\tpublic function set_cache_header($last_modified, $expiration)\n\t{\n\t\t$max_age = $expiration - $_SERVER['REQUEST_TIME'];\n\n\t\tif (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) && $last_modified <= strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']))\n\t\t{\n\t\t\t$this->set_status_header(304);\n\t\t\texit;\n\t\t}\n\n\t\theader('Pragma: public');\n\t\theader('Cache-Control: max-age='.$max_age.', public');\n\t\theader('Expires: '.gmdate('D, d M Y H:i:s', $expiration).' GMT');\n\t\theader('Last-modified: '.gmdate('D, d M Y H:i:s', $last_modified).' GMT');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Byte-safe strlen()\n\t *\n\t * @param\tstring\t$str\n\t * @return\tint\n\t */\n\tprotected static function strlen($str)\n\t{\n\t\treturn (self::$func_overload)\n\t\t\t? mb_strlen($str, '8bit')\n\t\t\t: strlen($str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Byte-safe substr()\n\t *\n\t * @param\tstring\t$str\n\t * @param\tint\t$start\n\t * @param\tint\t$length\n\t * @return\tstring\n\t */\n\tprotected static function substr($str, $start, $length = NULL)\n\t{\n\t\tif (self::$func_overload)\n\t\t{\n\t\t\treturn mb_substr($str, $start, $length, '8bit');\n\t\t}\n\n\t\treturn isset($length)\n\t\t\t? substr($str, $start, $length)\n\t\t\t: substr($str, $start);\n\t}\n}\n" }, { "path": "system/core/Router.php", "content": "config =& load_class('Config', 'core');\n\t\t$this->uri =& load_class('URI', 'core');\n\n\t\t$this->enable_query_strings = ( ! is_cli() && $this->config->item('enable_query_strings') === TRUE);\n\n\t\t// If a directory override is configured, it has to be set before any dynamic routing logic\n\t\tis_array($routing) && isset($routing['directory']) && $this->set_directory($routing['directory']);\n\t\t$this->_set_routing();\n\n\t\t// Set any routing overrides that may exist in the main index file\n\t\tif (is_array($routing))\n\t\t{\n\t\t\tempty($routing['controller']) OR $this->set_class($routing['controller']);\n\t\t\tempty($routing['function']) OR $this->set_method($routing['function']);\n\t\t}\n\n\t\tlog_message('info', 'Router Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set route mapping\n\t *\n\t * Determines what should be served based on the URI request,\n\t * as well as any \"routes\" that have been set in the routing config file.\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _set_routing()\n\t{\n\t\t// Load the routes.php file. It would be great if we could\n\t\t// skip this for enable_query_strings = TRUE, but then\n\t\t// default_controller would be empty ...\n\t\tif (file_exists(APPPATH.'config/routes.php'))\n\t\t{\n\t\t\tinclude(APPPATH.'config/routes.php');\n\t\t}\n\n\t\tif (file_exists(APPPATH.'config/'.ENVIRONMENT.'/routes.php'))\n\t\t{\n\t\t\tinclude(APPPATH.'config/'.ENVIRONMENT.'/routes.php');\n\t\t}\n\n\t\t// Validate & get reserved routes\n\t\tif (isset($route) && is_array($route))\n\t\t{\n\t\t\tisset($route['default_controller']) && $this->default_controller = $route['default_controller'];\n\t\t\tisset($route['translate_uri_dashes']) && $this->translate_uri_dashes = $route['translate_uri_dashes'];\n\t\t\tunset($route['default_controller'], $route['translate_uri_dashes']);\n\t\t\t$this->routes = $route;\n\t\t}\n\n\t\t// Are query strings enabled in the config file? Normally CI doesn't utilize query strings\n\t\t// since URI segments are more search-engine friendly, but they can optionally be used.\n\t\t// If this feature is enabled, we will gather the directory/class/method a little differently\n\t\tif ($this->enable_query_strings)\n\t\t{\n\t\t\t// If the directory is set at this time, it means an override exists, so skip the checks\n\t\t\tif ( ! isset($this->directory))\n\t\t\t{\n\t\t\t\t$_d = $this->config->item('directory_trigger');\n\t\t\t\t$_d = isset($_GET[$_d]) ? trim($_GET[$_d], \" \\t\\n\\r\\0\\x0B/\") : '';\n\n\t\t\t\tif ($_d !== '')\n\t\t\t\t{\n\t\t\t\t\t$this->uri->filter_uri($_d);\n\t\t\t\t\t$this->set_directory($_d);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t$_c = trim($this->config->item('controller_trigger'));\n\t\t\tif ( ! empty($_GET[$_c]))\n\t\t\t{\n\t\t\t\t$this->uri->filter_uri($_GET[$_c]);\n\t\t\t\t$this->set_class($_GET[$_c]);\n\n\t\t\t\t$_f = trim($this->config->item('function_trigger'));\n\t\t\t\tif ( ! empty($_GET[$_f]))\n\t\t\t\t{\n\t\t\t\t\t$this->uri->filter_uri($_GET[$_f]);\n\t\t\t\t\t$this->set_method($_GET[$_f]);\n\t\t\t\t}\n\n\t\t\t\t$this->uri->rsegments = array(\n\t\t\t\t\t1 => $this->class,\n\t\t\t\t\t2 => $this->method\n\t\t\t\t);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$this->_set_default_controller();\n\t\t\t}\n\n\t\t\t// Routing rules don't apply to query strings and we don't need to detect\n\t\t\t// directories, so we're done here\n\t\t\treturn;\n\t\t}\n\n\t\t// Is there anything to parse?\n\t\tif ($this->uri->uri_string !== '')\n\t\t{\n\t\t\t$this->_parse_routes();\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->_set_default_controller();\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set request route\n\t *\n\t * Takes an array of URI segments as input and sets the class/method\n\t * to be called.\n\t *\n\t * @used-by\tCI_Router::_parse_routes()\n\t * @param\tarray\t$segments\tURI segments\n\t * @return\tvoid\n\t */\n\tprotected function _set_request($segments = array())\n\t{\n\t\t$segments = $this->_validate_request($segments);\n\t\t// If we don't have any segments left - try the default controller;\n\t\t// WARNING: Directories get shifted out of the segments array!\n\t\tif (empty($segments))\n\t\t{\n\t\t\t$this->_set_default_controller();\n\t\t\treturn;\n\t\t}\n\n\t\tif ($this->translate_uri_dashes === TRUE)\n\t\t{\n\t\t\t$segments[0] = str_replace('-', '_', $segments[0]);\n\t\t\tif (isset($segments[1]))\n\t\t\t{\n\t\t\t\t$segments[1] = str_replace('-', '_', $segments[1]);\n\t\t\t}\n\t\t}\n\n\t\t$this->set_class($segments[0]);\n\t\tif (isset($segments[1]))\n\t\t{\n\t\t\t$this->set_method($segments[1]);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$segments[1] = 'index';\n\t\t}\n\n\t\tarray_unshift($segments, NULL);\n\t\tunset($segments[0]);\n\t\t$this->uri->rsegments = $segments;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set default controller\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _set_default_controller()\n\t{\n\t\tif (empty($this->default_controller))\n\t\t{\n\t\t\tshow_error('Unable to determine what should be displayed. A default route has not been specified in the routing file.');\n\t\t}\n\n\t\t// Is the method being specified?\n\t\tif (sscanf($this->default_controller, '%[^/]/%s', $class, $method) !== 2)\n\t\t{\n\t\t\t$method = 'index';\n\t\t}\n\n\t\tif ( ! file_exists(APPPATH.'controllers/'.$this->directory.ucfirst($class).'.php'))\n\t\t{\n\t\t\t// This will trigger 404 later\n\t\t\treturn;\n\t\t}\n\n\t\t$this->set_class($class);\n\t\t$this->set_method($method);\n\n\t\t// Assign routed segments, index starting from 1\n\t\t$this->uri->rsegments = array(\n\t\t\t1 => $class,\n\t\t\t2 => $method\n\t\t);\n\n\t\tlog_message('debug', 'No URI present. Default controller set.');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Validate request\n\t *\n\t * Attempts validate the URI request and determine the controller path.\n\t *\n\t * @used-by\tCI_Router::_set_request()\n\t * @param\tarray\t$segments\tURI segments\n\t * @return\tmixed\tURI segments\n\t */\n\tprotected function _validate_request($segments)\n\t{\n\t\t$c = count($segments);\n\t\t$directory_override = $this->directory !== '';\n\n\t\t// Loop through our segments and return as soon as a controller\n\t\t// is found or when such a directory doesn't exist\n\t\twhile ($c-- > 0)\n\t\t{\n\t\t\t$test = $this->directory\n\t\t\t\t.ucfirst($this->translate_uri_dashes === TRUE ? str_replace('-', '_', $segments[0]) : $segments[0]);\n\n\t\t\tif ( ! file_exists(APPPATH.'controllers/'.$test.'.php')\n\t\t\t\t&& $directory_override === FALSE\n\t\t\t\t&& is_dir(APPPATH.'controllers/'.$this->directory.$segments[0])\n\t\t\t)\n\t\t\t{\n\t\t\t\t$this->set_directory(array_shift($segments), TRUE);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\treturn $segments;\n\t\t}\n\n\t\t// This means that all segments were actually directories\n\t\treturn $segments;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Parse Routes\n\t *\n\t * Matches any routes that may exist in the config/routes.php file\n\t * against the URI to determine if the class/method need to be remapped.\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _parse_routes()\n\t{\n\t\t// Turn the segment array into a URI string\n\t\t$uri = implode('/', $this->uri->segments);\n\n\t\t// Get HTTP verb\n\t\t$http_verb = isset($_SERVER['REQUEST_METHOD']) ? strtolower($_SERVER['REQUEST_METHOD']) : 'cli';\n\n\t\t// Loop through the route array looking for wildcards\n\t\tforeach ($this->routes as $key => $val)\n\t\t{\n\t\t\t// Check if route format is using HTTP verbs\n\t\t\tif (is_array($val))\n\t\t\t{\n\t\t\t\t$val = array_change_key_case($val, CASE_LOWER);\n\t\t\t\tif (isset($val[$http_verb]))\n\t\t\t\t{\n\t\t\t\t\t$val = $val[$http_verb];\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Convert wildcards to RegEx\n\t\t\t$key = str_replace(array(':any', ':num'), array('[^/]+', '[0-9]+'), $key);\n\n\t\t\t// Does the RegEx match?\n\t\t\tif (preg_match('#^'.$key.'$#', $uri, $matches))\n\t\t\t{\n\t\t\t\t// Are we using callbacks to process back-references?\n\t\t\t\tif ( ! is_string($val) && is_callable($val))\n\t\t\t\t{\n\t\t\t\t\t// Remove the original string from the matches array.\n\t\t\t\t\tarray_shift($matches);\n\n\t\t\t\t\t// Execute the callback using the values in matches as its parameters.\n\t\t\t\t\t$val = call_user_func_array($val, $matches);\n\t\t\t\t}\n\t\t\t\t// Are we using the default routing method for back-references?\n\t\t\t\telseif (strpos($val, '$') !== FALSE && strpos($key, '(') !== FALSE)\n\t\t\t\t{\n\t\t\t\t\t$val = preg_replace('#^'.$key.'$#', $val, $uri);\n\t\t\t\t}\n\n\t\t\t\t$this->_set_request(explode('/', $val));\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// If we got this far it means we didn't encounter a\n\t\t// matching route so we'll set the site default route\n\t\t$this->_set_request(array_values($this->uri->segments));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set class name\n\t *\n\t * @param\tstring\t$class\tClass name\n\t * @return\tvoid\n\t */\n\tpublic function set_class($class)\n\t{\n\t\t$this->class = str_replace(array('/', '.'), '', $class);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set method name\n\t *\n\t * @param\tstring\t$method\tMethod name\n\t * @return\tvoid\n\t */\n\tpublic function set_method($method)\n\t{\n\t\t$this->method = $method;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set directory name\n\t *\n\t * @param\tstring\t$dir\tDirectory name\n\t * @param\tbool\t$append\tWhether we're appending rather than setting the full value\n\t * @return\tvoid\n\t */\n\tpublic function set_directory($dir, $append = FALSE)\n\t{\n\t\tif ($append !== TRUE OR empty($this->directory))\n\t\t{\n\t\t\t$this->directory = str_replace('.', '', trim($dir, '/')).'/';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->directory .= str_replace('.', '', trim($dir, '/')).'/';\n\t\t}\n\t}\n}\n" }, { "path": "system/core/Security.php", "content": "', '<', '>',\n\t\t\"'\", '\"', '&', '$', '#',\n\t\t'{', '}', '[', ']', '=',\n\t\t';', '?', '%20', '%22',\n\t\t'%3c',\t\t// <\n\t\t'%253c',\t// <\n\t\t'%3e',\t\t// >\n\t\t'%0e',\t\t// >\n\t\t'%28',\t\t// (\n\t\t'%29',\t\t// )\n\t\t'%2528',\t// (\n\t\t'%26',\t\t// &\n\t\t'%24',\t\t// $\n\t\t'%3f',\t\t// ?\n\t\t'%3b',\t\t// ;\n\t\t'%3d'\t\t// =\n\t);\n\n\t/**\n\t * Character set\n\t *\n\t * Will be overridden by the constructor.\n\t *\n\t * @var\tstring\n\t */\n\tpublic $charset = 'UTF-8';\n\n\t/**\n\t * XSS Hash\n\t *\n\t * Random Hash for protecting URLs.\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_xss_hash;\n\n\t/**\n\t * CSRF Hash\n\t *\n\t * Random hash for Cross Site Request Forgery protection cookie\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_csrf_hash;\n\n\t/**\n\t * CSRF Expire time\n\t *\n\t * Expiration time for Cross Site Request Forgery protection cookie.\n\t * Defaults to two hours (in seconds).\n\t *\n\t * @var\tint\n\t */\n\tprotected $_csrf_expire =\t7200;\n\n\t/**\n\t * CSRF Token name\n\t *\n\t * Token name for Cross Site Request Forgery protection cookie.\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_csrf_token_name =\t'ci_csrf_token';\n\n\t/**\n\t * CSRF Cookie name\n\t *\n\t * Cookie name for Cross Site Request Forgery protection cookie.\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_csrf_cookie_name =\t'ci_csrf_token';\n\n\t/**\n\t * List of never allowed strings\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_never_allowed_str =\tarray(\n\t\t'document.cookie' => '[removed]',\n\t\t'(document).cookie' => '[removed]',\n\t\t'document.write' => '[removed]',\n\t\t'(document).write' => '[removed]',\n\t\t'.parentNode' => '[removed]',\n\t\t'.innerHTML' => '[removed]',\n\t\t'-moz-binding' => '[removed]',\n\t\t'' => '-->',\n\t\t' '<![CDATA[',\n\t\t''\t => '<comment>',\n\t\t'<%' => '<%'\n\t);\n\n\t/**\n\t * List of never allowed regex replacements\n\t *\n\t * @var\tarray\n\t */\n\tprotected $_never_allowed_regex = array(\n\t\t'javascript\\s*:',\n\t\t'(\\(?document\\)?|\\(?window\\)?(\\.document)?)\\.(location|on\\w*)',\n\t\t'expression\\s*(\\(|&\\#40;)', // CSS and IE\n\t\t'vbscript\\s*:', // IE, surprise!\n\t\t'wscript\\s*:', // IE\n\t\t'jscript\\s*:', // IE\n\t\t'vbs\\s*:', // IE\n\t\t'Redirect\\s+30\\d',\n\t\t\"([\\\"'])?data\\s*:[^\\\\1]*?base64[^\\\\1]*?,[^\\\\1]*?\\\\1?\"\n\t);\n\n\t/**\n\t * Class constructor\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function __construct($charset)\n\t{\n\t\t$this->charset = $charset;\n\n\t\t// Is CSRF protection enabled?\n\t\tif (config_item('csrf_protection') && ! is_cli())\n\t\t{\n\t\t\t// CSRF config\n\t\t\tforeach (array('csrf_expire', 'csrf_token_name', 'csrf_cookie_name') as $key)\n\t\t\t{\n\t\t\t\tif (NULL !== ($val = config_item($key)))\n\t\t\t\t{\n\t\t\t\t\t$this->{'_'.$key} = $val;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Append application specific cookie prefix\n\t\t\tif ($cookie_prefix = config_item('cookie_prefix'))\n\t\t\t{\n\t\t\t\t$this->_csrf_cookie_name = $cookie_prefix.$this->_csrf_cookie_name;\n\t\t\t}\n\n\t\t\t// Set the CSRF hash\n\t\t\t$this->_csrf_set_hash();\n\t\t\t$this->csrf_verify();\n\t\t}\n\n\t\tlog_message('info', 'Security Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * CSRF Verify\n\t *\n\t * @return\tCI_Security\n\t */\n\tpublic function csrf_verify()\n\t{\n\t\t// If it's not a POST request we will set the CSRF cookie\n\t\tif (strtoupper($_SERVER['REQUEST_METHOD']) !== 'POST')\n\t\t{\n\t\t\treturn $this->csrf_set_cookie();\n\t\t}\n\n\t\t// Check if URI has been whitelisted from CSRF checks\n\t\tif ($exclude_uris = config_item('csrf_exclude_uris'))\n\t\t{\n\t\t\t$uri = load_class('URI', 'core');\n\t\t\tforeach ($exclude_uris as $excluded)\n\t\t\t{\n\t\t\t\tif (preg_match('#^'.$excluded.'$#i'.(UTF8_ENABLED ? 'u' : ''), $uri->uri_string()))\n\t\t\t\t{\n\t\t\t\t\treturn $this;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Check CSRF token validity, but don't error on mismatch just yet - we'll want to regenerate\n\t\t$valid = isset($_POST[$this->_csrf_token_name], $_COOKIE[$this->_csrf_cookie_name])\n\t\t\t&& is_string($_POST[$this->_csrf_token_name]) && is_string($_COOKIE[$this->_csrf_cookie_name])\n\t\t\t&& hash_equals($_POST[$this->_csrf_token_name], $_COOKIE[$this->_csrf_cookie_name]);\n\n\t\t// We kill this since we're done and we don't want to pollute the _POST array\n\t\tunset($_POST[$this->_csrf_token_name]);\n\n\t\t// Regenerate on every submission?\n\t\tif (config_item('csrf_regenerate'))\n\t\t{\n\t\t\t// Nothing should last forever\n\t\t\tunset($_COOKIE[$this->_csrf_cookie_name]);\n\t\t\t$this->_csrf_hash = NULL;\n\t\t}\n\n\t\t$this->_csrf_set_hash();\n\t\t$this->csrf_set_cookie();\n\n\t\tif ($valid !== TRUE)\n\t\t{\n\t\t\t$this->csrf_show_error();\n\t\t}\n\n\t\tlog_message('info', 'CSRF token verified');\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * CSRF Set Cookie\n\t *\n\t * @codeCoverageIgnore\n\t * @return\tCI_Security\n\t */\n\tpublic function csrf_set_cookie()\n\t{\n\t\t$expire = time() + $this->_csrf_expire;\n\t\t$secure_cookie = (bool) config_item('cookie_secure');\n\n\t\tif ($secure_cookie && ! is_https())\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (is_php('7.3'))\n\t\t{\n\t\t\tsetcookie(\n\t\t\t\t$this->_csrf_cookie_name,\n\t\t\t\t$this->_csrf_hash,\n\t\t\t\tarray(\n\t\t\t\t\t'expires' => $expire,\n\t\t\t\t\t'path' => config_item('cookie_path'),\n\t\t\t\t\t'domain' => config_item('cookie_domain'),\n\t\t\t\t\t'secure' => $secure_cookie,\n\t\t\t\t\t'httponly' => config_item('cookie_httponly'),\n\t\t\t\t\t'samesite' => 'Strict'\n\t\t\t\t)\n\t\t\t);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$domain = trim(config_item('cookie_domain'));\n\t\t\theader('Set-Cookie: '.$this->_csrf_cookie_name.'='.$this->_csrf_hash\n\t\t\t\t\t.'; Expires='.gmdate('D, d-M-Y H:i:s T', $expire)\n\t\t\t\t\t.'; Max-Age='.$this->_csrf_expire\n\t\t\t\t\t.'; Path='.implode('/', array_map('rawurlencode', explode('/', config_item('cookie_path'))))\n\t\t\t\t\t.($domain === '' ? '' : '; Domain='.$domain)\n\t\t\t\t\t.($secure_cookie ? '; Secure' : '')\n\t\t\t\t\t.(config_item('cookie_httponly') ? '; HttpOnly' : '')\n\t\t\t\t\t.'; SameSite=Strict'\n\t\t\t);\n\t\t}\n\n\t\tlog_message('info', 'CSRF cookie sent');\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show CSRF Error\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function csrf_show_error()\n\t{\n\t\tshow_error('The action you have requested is not allowed.', 403);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get CSRF Hash\n\t *\n\t * @see\t\tCI_Security::$_csrf_hash\n\t * @return \tstring\tCSRF hash\n\t */\n\tpublic function get_csrf_hash()\n\t{\n\t\treturn $this->_csrf_hash;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get CSRF Token Name\n\t *\n\t * @see\t\tCI_Security::$_csrf_token_name\n\t * @return\tstring\tCSRF token name\n\t */\n\tpublic function get_csrf_token_name()\n\t{\n\t\treturn $this->_csrf_token_name;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * XSS Clean\n\t *\n\t * Sanitizes data so that Cross Site Scripting Hacks can be\n\t * prevented. This method does a fair amount of work but\n\t * it is extremely thorough, designed to prevent even the\n\t * most obscure XSS attempts. Nothing is ever 100% foolproof,\n\t * of course, but I haven't been able to get anything passed\n\t * the filter.\n\t *\n\t * Note: Should only be used to deal with data upon submission.\n\t *\t It's not something that should be used for general\n\t *\t runtime processing.\n\t *\n\t * @link\thttp://channel.bitflux.ch/wiki/XSS_Prevention\n\t * \t\tBased in part on some code and ideas from Bitflux.\n\t *\n\t * @link\thttp://ha.ckers.org/xss.html\n\t * \t\tTo help develop this script I used this great list of\n\t *\t\tvulnerabilities along with a few other hacks I've\n\t *\t\tharvested from examining vulnerabilities in other programs.\n\t *\n\t * @param\tstring|string[]\t$str\t\tInput data\n\t * @param \tbool\t\t$is_image\tWhether the input is an image\n\t * @return\tstring\n\t */\n\tpublic function xss_clean($str, $is_image = FALSE)\n\t{\n\t\t// Is the string an array?\n\t\tif (is_array($str))\n\t\t{\n\t\t\tforeach ($str as $key => &$value)\n\t\t\t{\n\t\t\t\t$str[$key] = $this->xss_clean($value);\n\t\t\t}\n\n\t\t\treturn $str;\n\t\t}\n\n\t\t// Remove Invisible Characters\n\t\t$str = remove_invisible_characters($str);\n\n\t\t/*\n\t\t * URL Decode\n\t\t *\n\t\t * Just in case stuff like this is submitted:\n\t\t *\n\t\t * Google\n\t\t *\n\t\t * Note: Use rawurldecode() so it does not remove plus signs\n\t\t */\n\t\tif (stripos($str, '%') !== false)\n\t\t{\n\t\t\tdo\n\t\t\t{\n\t\t\t\t$oldstr = $str;\n\t\t\t\t$str = rawurldecode($str);\n\t\t\t\t$str = preg_replace_callback('#%(?:\\s*[0-9a-f]){2,}#i', array($this, '_urldecodespaces'), $str);\n\t\t\t}\n\t\t\twhile ($oldstr !== $str);\n\t\t\tunset($oldstr);\n\t\t}\n\n\t\t/*\n\t\t * Convert character entities to ASCII\n\t\t *\n\t\t * This permits our tests below to work reliably.\n\t\t * We only convert entities that are within tags since\n\t\t * these are the ones that will pose security problems.\n\t\t */\n\t\t$str = preg_replace_callback(\"/[^a-z0-9>]+[a-z0-9]+=([\\'\\\"]).*?\\\\1/si\", array($this, '_convert_attribute'), $str);\n\t\t$str = preg_replace_callback('/<\\w+.*/si', array($this, '_decode_entity'), $str);\n\n\t\t// Remove Invisible Characters Again!\n\t\t$str = remove_invisible_characters($str);\n\n\t\t/*\n\t\t * Convert all tabs to spaces\n\t\t *\n\t\t * This prevents strings like this: ja\tvascript\n\t\t * NOTE: we deal with spaces between characters later.\n\t\t * NOTE: preg_replace was found to be amazingly slow here on\n\t\t * large blocks of data, so we use str_replace.\n\t\t */\n\t\t$str = str_replace(\"\\t\", ' ', $str);\n\n\t\t// Capture converted string for later comparison\n\t\t$converted_string = $str;\n\n\t\t// Remove Strings that are never allowed\n\t\t$str = $this->_do_never_allowed($str);\n\n\t\t/*\n\t\t * Makes PHP tags safe\n\t\t *\n\t\t * Note: XML tags are inadvertently replaced too:\n\t\t *\n\t\t * '), array('<?', '?>'), $str);\n\t\t}\n\n\t\t/*\n\t\t * Compact any exploded words\n\t\t *\n\t\t * This corrects words like: j a v a s c r i p t\n\t\t * These words are compacted back to their correct state.\n\t\t */\n\t\t$words = array(\n\t\t\t'javascript', 'expression', 'vbscript', 'jscript', 'wscript',\n\t\t\t'vbs', 'script', 'base64', 'applet', 'alert', 'document',\n\t\t\t'write', 'cookie', 'window', 'confirm', 'prompt', 'eval'\n\t\t);\n\n\t\tforeach ($words as $word)\n\t\t{\n\t\t\t$word = implode('\\s*', str_split($word)).'\\s*';\n\n\t\t\t// We only want to do this when it is followed by a non-word character\n\t\t\t// That way valid stuff like \"dealer to\" does not become \"dealerto\"\n\t\t\t$str = preg_replace_callback('#('.substr($word, 0, -3).')(\\W)#is', array($this, '_compact_exploded_words'), $str);\n\t\t}\n\n\t\t/*\n\t\t * Remove disallowed Javascript in links or img tags\n\t\t * We used to do some version comparisons and use of stripos(),\n\t\t * but it is dog slow compared to these simplified non-capturing\n\t\t * preg_match(), especially if the pattern exists in the string\n\t\t *\n\t\t * Note: It was reported that not only space characters, but all in\n\t\t * the following pattern can be parsed as separators between a tag name\n\t\t * and its attributes: [\\d\\s\"\\'`;,\\/\\=\\(\\x00\\x0B\\x09\\x0C]\n\t\t * ... however, remove_invisible_characters() above already strips the\n\t\t * hex-encoded ones, so we'll skip them below.\n\t\t */\n\t\tdo\n\t\t{\n\t\t\t$original = $str;\n\n\t\t\tif (preg_match('/]+([^>]*?)(?:>|$)#si', array($this, '_js_link_removal'), $str);\n\t\t\t}\n\n\t\t\tif (preg_match('/]*?)(?:\\s?/?>|$)#si', array($this, '_js_img_removal'), $str);\n\t\t\t}\n\n\t\t\tif (preg_match('/script|xss/i', $str))\n\t\t\t{\n\t\t\t\t$str = preg_replace('##si', '[removed]', $str);\n\t\t\t}\n\t\t}\n\t\twhile ($original !== $str);\n\t\tunset($original);\n\n\t\t/*\n\t\t * Sanitize naughty HTML elements\n\t\t *\n\t\t * If a tag containing any of the words in the list\n\t\t * below is found, the tag gets converted to entities.\n\t\t *\n\t\t * So this: \n\t\t * Becomes: <blink>\n\t\t */\n\t\t$pattern = '#'\n\t\t\t.'<((?/*\\s*)((?[a-z0-9]+)(?=[^a-z0-9]|$)|.+)' // tag start and name, followed by a non-tag character\n\t\t\t.'[^\\s\\042\\047a-z0-9>/=]*' // a valid attribute character immediately after the tag would count as a separator\n\t\t\t// optional attributes\n\t\t\t.'(?(?:[\\s\\042\\047/=]*' // non-attribute characters, excluding > (tag close) for obvious reasons\n\t\t\t.'[^\\s\\042\\047>/=]+' // attribute characters\n\t\t\t// optional attribute-value\n\t\t\t\t.'(?:\\s*=' // attribute-value separator\n\t\t\t\t\t.'(?:[^\\s\\042\\047=><`]+|\\s*\\042[^\\042]*\\042|\\s*\\047[^\\047]*\\047|\\s*(?U:[^\\s\\042\\047=><`]*))' // single, double or non-quoted value\n\t\t\t\t.')?' // end optional attribute-value group\n\t\t\t.')*)' // end optional attributes group\n\t\t\t.'[^>]*)(?\\>)?#isS';\n\n\t\t// Note: It would be nice to optimize this for speed, BUT\n\t\t// only matching the naughty elements here results in\n\t\t// false positives and in turn - vulnerabilities!\n\t\tdo\n\t\t{\n\t\t\t$old_str = $str;\n\t\t\t$str = preg_replace_callback($pattern, array($this, '_sanitize_naughty_html'), $str);\n\t\t}\n\t\twhile ($old_str !== $str);\n\t\tunset($old_str);\n\n\t\t/*\n\t\t * Sanitize naughty scripting elements\n\t\t *\n\t\t * Similar to above, only instead of looking for\n\t\t * tags it looks for PHP and JavaScript commands\n\t\t * that are disallowed. Rather than removing the\n\t\t * code, it simply converts the parenthesis to entities\n\t\t * rendering the code un-executable.\n\t\t *\n\t\t * For example:\teval('some code')\n\t\t * Becomes:\teval('some code')\n\t\t */\n\t\t$str = preg_replace(\n\t\t\t'#(alert|prompt|confirm|cmd|passthru|eval|exec|expression|system|fopen|fsockopen|file|file_get_contents|readfile|unlink)(\\s*)\\((.*?)\\)#si',\n\t\t\t'\\\\1\\\\2(\\\\3)',\n\t\t\t$str\n\t\t);\n\n\t\t// Same thing, but for \"tag functions\" (e.g. eval`some code`)\n\t\t// See https://github.com/bcit-ci/CodeIgniter/issues/5420\n\t\t$str = preg_replace(\n\t\t\t'#(alert|prompt|confirm|cmd|passthru|eval|exec|expression|system|fopen|fsockopen|file|file_get_contents|readfile|unlink)(\\s*)`(.*?)`#si',\n\t\t\t'\\\\1\\\\2`\\\\3`',\n\t\t\t$str\n\t\t);\n\n\t\t// Final clean up\n\t\t// This adds a bit of extra precaution in case\n\t\t// something got through the above filters\n\t\t$str = $this->_do_never_allowed($str);\n\n\t\t/*\n\t\t * Images are Handled in a Special Way\n\t\t * - Essentially, we want to know that after all of the character\n\t\t * conversion is done whether any unwanted, likely XSS, code was found.\n\t\t * If not, we return TRUE, as the image is clean.\n\t\t * However, if the string post-conversion does not matched the\n\t\t * string post-removal of XSS, then it fails, as there was unwanted XSS\n\t\t * code found and removed/changed during processing.\n\t\t */\n\t\tif ($is_image === TRUE)\n\t\t{\n\t\t\treturn ($str === $converted_string);\n\t\t}\n\n\t\treturn $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * XSS Hash\n\t *\n\t * Generates the XSS hash if needed and returns it.\n\t *\n\t * @see\t\tCI_Security::$_xss_hash\n\t * @return\tstring\tXSS hash\n\t */\n\tpublic function xss_hash()\n\t{\n\t\tif ($this->_xss_hash === NULL)\n\t\t{\n\t\t\t$rand = $this->get_random_bytes(16);\n\t\t\t$this->_xss_hash = ($rand === FALSE)\n\t\t\t\t? md5(uniqid(mt_rand(), TRUE))\n\t\t\t\t: bin2hex($rand);\n\t\t}\n\n\t\treturn $this->_xss_hash;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get random bytes\n\t *\n\t * @param\tint\t$length\tOutput length\n\t * @return\tstring\n\t */\n\tpublic function get_random_bytes($length)\n\t{\n\t\tif (empty($length) OR ! ctype_digit((string) $length))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (function_exists('random_bytes'))\n\t\t{\n\t\t\ttry\n\t\t\t{\n\t\t\t\t// The cast is required to avoid TypeError\n\t\t\t\treturn random_bytes((int) $length);\n\t\t\t}\n\t\t\tcatch (Exception $e)\n\t\t\t{\n\t\t\t\t// If random_bytes() can't do the job, we can't either ...\n\t\t\t\t// There's no point in using fallbacks.\n\t\t\t\tlog_message('error', $e->getMessage());\n\t\t\t\treturn FALSE;\n\t\t\t}\n\t\t}\n\n\t\t// Unfortunately, none of the following PRNGs is guaranteed to exist ...\n\t\tif (defined('MCRYPT_DEV_URANDOM') && ($output = mcrypt_create_iv($length, MCRYPT_DEV_URANDOM)) !== FALSE)\n\t\t{\n\t\t\treturn $output;\n\t\t}\n\n\t\tif (is_readable('/dev/urandom') && ($fp = fopen('/dev/urandom', 'rb')) !== FALSE)\n\t\t{\n\t\t\t// Try not to waste entropy ...\n\t\t\tstream_set_chunk_size($fp, $length);\n\t\t\t$output = fread($fp, $length);\n\t\t\tfclose($fp);\n\t\t\tif ($output !== FALSE)\n\t\t\t{\n\t\t\t\treturn $output;\n\t\t\t}\n\t\t}\n\n\t\tif (function_exists('openssl_random_pseudo_bytes'))\n\t\t{\n\t\t\treturn openssl_random_pseudo_bytes($length);\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * HTML Entities Decode\n\t *\n\t * A replacement for html_entity_decode()\n\t *\n\t * The reason we are not using html_entity_decode() by itself is because\n\t * while it is not technically correct to leave out the semicolon\n\t * at the end of an entity most browsers will still interpret the entity\n\t * correctly. html_entity_decode() does not convert entities without\n\t * semicolons, so we are left with our own little solution here. Bummer.\n\t *\n\t * @link\thttps://secure.php.net/html-entity-decode\n\t *\n\t * @param\tstring\t$str\t\tInput\n\t * @param\tstring\t$charset\tCharacter set\n\t * @return\tstring\n\t */\n\tpublic function entity_decode($str, $charset = NULL)\n\t{\n\t\tif (strpos($str, '&') === FALSE)\n\t\t{\n\t\t\treturn $str;\n\t\t}\n\n\t\tstatic $_entities;\n\n\t\tisset($charset) OR $charset = $this->charset;\n\t\tisset($_entities) OR $_entities = array_map('strtolower', get_html_translation_table(HTML_ENTITIES, ENT_COMPAT | ENT_HTML5, $charset));\n\n\t\tdo\n\t\t{\n\t\t\t$str_compare = $str;\n\n\t\t\t// Decode standard entities, avoiding false positives\n\t\t\tif (preg_match_all('/&[a-z]{2,}(?![a-z;])/i', $str, $matches))\n\t\t\t{\n\t\t\t\t$replace = array();\n\t\t\t\t$matches = array_unique(array_map('strtolower', $matches[0]));\n\t\t\t\tforeach ($matches as &$match)\n\t\t\t\t{\n\t\t\t\t\tif (($char = array_search($match.';', $_entities, TRUE)) !== FALSE)\n\t\t\t\t\t{\n\t\t\t\t\t\t$replace[$match] = $char;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t$str = str_replace(array_keys($replace), array_values($replace), $str);\n\t\t\t}\n\n\t\t\t// Decode numeric & UTF16 two byte entities\n\t\t\t$str = html_entity_decode(\n\t\t\t\tpreg_replace('/(&#(?:x0*[0-9a-f]{2,5}(?![0-9a-f;])|(?:0*\\d{2,4}(?![0-9;]))))/iS', '$1;', $str),\n\t\t\t\tENT_COMPAT | ENT_HTML5,\n\t\t\t\t$charset\n\t\t\t);\n\t\t}\n\t\twhile ($str_compare !== $str);\n\t\treturn $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Sanitize Filename\n\t *\n\t * @param\tstring\t$str\t\tInput file name\n\t * @param \tbool\t$relative_path\tWhether to preserve paths\n\t * @return\tstring\n\t */\n\tpublic function sanitize_filename($str, $relative_path = FALSE)\n\t{\n\t\t$bad = $this->filename_bad_chars;\n\n\t\tif ( ! $relative_path)\n\t\t{\n\t\t\t$bad[] = './';\n\t\t\t$bad[] = '/';\n\t\t}\n\n\t\t$str = remove_invisible_characters($str, FALSE);\n\n\t\tdo\n\t\t{\n\t\t\t$old = $str;\n\t\t\t$str = str_replace($bad, '', $str);\n\t\t}\n\t\twhile ($old !== $str);\n\n\t\treturn stripslashes($str);\n\t}\n\n\t// ----------------------------------------------------------------\n\n\t/**\n\t * Strip Image Tags\n\t *\n\t * @param\tstring\t$str\n\t * @return\tstring\n\t */\n\tpublic function strip_image_tags($str)\n\t{\n\t\treturn preg_replace(\n\t\t\tarray(\n\t\t\t\t'##i',\n\t\t\t\t'#`]+)).*?\\>#i'\n\t\t\t),\n\t\t\t'\\\\2',\n\t\t\t$str\n\t\t);\n\t}\n\n\t// ----------------------------------------------------------------\n\n\t/**\n\t * URL-decode taking spaces into account\n\t *\n\t * @see\t\thttps://github.com/bcit-ci/CodeIgniter/issues/4877\n\t * @param\tarray\t$matches\n\t * @return\tstring\n\t */\n\tprotected function _urldecodespaces($matches)\n\t{\n\t\t$input = $matches[0];\n\t\t$nospaces = preg_replace('#\\s+#', '', $input);\n\t\treturn ($nospaces === $input)\n\t\t\t? $input\n\t\t\t: rawurldecode($nospaces);\n\t}\n\n\t// ----------------------------------------------------------------\n\n\t/**\n\t * Compact Exploded Words\n\t *\n\t * Callback method for xss_clean() to remove whitespace from\n\t * things like 'j a v a s c r i p t'.\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param\tarray\t$matches\n\t * @return\tstring\n\t */\n\tprotected function _compact_exploded_words($matches)\n\t{\n\t\treturn preg_replace('/\\s+/s', '', $matches[1]).$matches[2];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Sanitize Naughty HTML\n\t *\n\t * Callback method for xss_clean() to remove naughty HTML elements.\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param\tarray\t$matches\n\t * @return\tstring\n\t */\n\tprotected function _sanitize_naughty_html($matches)\n\t{\n\t\tstatic $naughty_tags = array(\n\t\t\t'alert', 'area', 'prompt', 'confirm', 'applet', 'audio', 'basefont', 'base', 'behavior', 'bgsound',\n\t\t\t'blink', 'body', 'embed', 'expression', 'form', 'frameset', 'frame', 'head', 'html', 'ilayer',\n\t\t\t'iframe', 'input', 'button', 'select', 'isindex', 'layer', 'link', 'meta', 'keygen', 'object',\n\t\t\t'plaintext', 'style', 'script', 'textarea', 'title', 'math', 'video', 'svg', 'xml', 'xss'\n\t\t);\n\n\t\tstatic $evil_attributes = array(\n\t\t\t'on\\w+', 'style', 'xmlns', 'formaction', 'form', 'xlink:href', 'FSCommand', 'seekSegmentTime'\n\t\t);\n\n\t\t// First, escape unclosed tags\n\t\tif (empty($matches['closeTag']))\n\t\t{\n\t\t\treturn '<'.$matches[1];\n\t\t}\n\t\t// Is the element that we caught naughty? If so, escape it\n\t\telseif (in_array(strtolower($matches['tagName']), $naughty_tags, TRUE))\n\t\t{\n\t\t\treturn '<'.$matches[1].'>';\n\t\t}\n\t\t// For other tags, see if their attributes are \"evil\" and strip those\n\t\telseif (isset($matches['attributes']))\n\t\t{\n\t\t\t// We'll store the already filtered attributes here\n\t\t\t$attributes = array();\n\n\t\t\t// Attribute-catching pattern\n\t\t\t$attributes_pattern = '#'\n\t\t\t\t.'(?[^\\s\\042\\047>/=]+)' // attribute characters\n\t\t\t\t// optional attribute-value\n\t\t\t\t.'(?:\\s*=(?[^\\s\\042\\047=><`]+|\\s*\\042[^\\042]*\\042|\\s*\\047[^\\047]*\\047|\\s*(?U:[^\\s\\042\\047=><`]*)))' // attribute-value separator\n\t\t\t\t.'#i';\n\n\t\t\t// Blacklist pattern for evil attribute names\n\t\t\t$is_evil_pattern = '#^('.implode('|', $evil_attributes).')$#i';\n\n\t\t\t// Each iteration filters a single attribute\n\t\t\tdo\n\t\t\t{\n\t\t\t\t// Strip any non-alpha characters that may precede an attribute.\n\t\t\t\t// Browsers often parse these incorrectly and that has been a\n\t\t\t\t// of numerous XSS issues we've had.\n\t\t\t\t$matches['attributes'] = preg_replace('#^[^a-z]+#i', '', $matches['attributes']);\n\n\t\t\t\tif ( ! preg_match($attributes_pattern, $matches['attributes'], $attribute, PREG_OFFSET_CAPTURE))\n\t\t\t\t{\n\t\t\t\t\t// No (valid) attribute found? Discard everything else inside the tag\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (\n\t\t\t\t\t// Is it indeed an \"evil\" attribute?\n\t\t\t\t\tpreg_match($is_evil_pattern, $attribute['name'][0])\n\t\t\t\t\t// Or does it have an equals sign, but no value and not quoted? Strip that too!\n\t\t\t\t\tOR (trim($attribute['value'][0]) === '')\n\t\t\t\t)\n\t\t\t\t{\n\t\t\t\t\t$attributes[] = 'xss=removed';\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$attributes[] = $attribute[0][0];\n\t\t\t\t}\n\n\t\t\t\t$matches['attributes'] = substr($matches['attributes'], $attribute[0][1] + strlen($attribute[0][0]));\n\t\t\t}\n\t\t\twhile ($matches['attributes'] !== '');\n\n\t\t\t$attributes = empty($attributes)\n\t\t\t\t? ''\n\t\t\t\t: ' '.implode(' ', $attributes);\n\t\t\treturn '<'.$matches['slash'].$matches['tagName'].$attributes.'>';\n\t\t}\n\n\t\treturn $matches[0];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * JS Link Removal\n\t *\n\t * Callback method for xss_clean() to sanitize links.\n\t *\n\t * This limits the PCRE backtracks, making it more performance friendly\n\t * and prevents PREG_BACKTRACK_LIMIT_ERROR from being triggered in\n\t * PHP 5.2+ on link-heavy strings.\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param\tarray\t$match\n\t * @return\tstring\n\t */\n\tprotected function _js_link_removal($match)\n\t{\n\t\treturn str_replace(\n\t\t\t$match[1],\n\t\t\tpreg_replace(\n\t\t\t\t'#href=.*?(?:(?:alert|prompt|confirm)(?:\\(|&\\#40;|`|&\\#96;)|javascript:|livescript:|mocha:|charset=|window\\.|\\(?document\\)?\\.|\\.cookie|_filter_attributes($match[1])\n\t\t\t),\n\t\t\t$match[0]\n\t\t);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * JS Image Removal\n\t *\n\t * Callback method for xss_clean() to sanitize image tags.\n\t *\n\t * This limits the PCRE backtracks, making it more performance friendly\n\t * and prevents PREG_BACKTRACK_LIMIT_ERROR from being triggered in\n\t * PHP 5.2+ on image tag heavy strings.\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param\tarray\t$match\n\t * @return\tstring\n\t */\n\tprotected function _js_img_removal($match)\n\t{\n\t\treturn str_replace(\n\t\t\t$match[1],\n\t\t\tpreg_replace(\n\t\t\t\t'#src=.*?(?:(?:alert|prompt|confirm|eval)(?:\\(|&\\#40;|`|&\\#96;)|javascript:|livescript:|mocha:|charset=|window\\.|\\(?document\\)?\\.|\\.cookie|_filter_attributes($match[1])\n\t\t\t),\n\t\t\t$match[0]\n\t\t);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Attribute Conversion\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param\tarray\t$match\n\t * @return\tstring\n\t */\n\tprotected function _convert_attribute($match)\n\t{\n\t\treturn str_replace(array('>', '<', '\\\\'), array('>', '<', '\\\\\\\\'), $match[0]);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Filter Attributes\n\t *\n\t * Filters tag attributes for consistency and safety.\n\t *\n\t * @used-by\tCI_Security::_js_img_removal()\n\t * @used-by\tCI_Security::_js_link_removal()\n\t * @param\tstring\t$str\n\t * @return\tstring\n\t */\n\tprotected function _filter_attributes($str)\n\t{\n\t\t$out = '';\n\t\tif (preg_match_all('#\\s*[a-z\\-]+\\s*=\\s*(\\042|\\047)([^\\\\1]*?)\\\\1#is', $str, $matches))\n\t\t{\n\t\t\tforeach ($matches[0] as $match)\n\t\t\t{\n\t\t\t\t$out .= preg_replace('#/\\*.*?\\*/#s', '', $match);\n\t\t\t}\n\t\t}\n\n\t\treturn $out;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * HTML Entity Decode Callback\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param\tarray\t$match\n\t * @return\tstring\n\t */\n\tprotected function _decode_entity($match)\n\t{\n\t\t// Protect GET variables in URLs\n\t\t// 901119URL5918AMP18930PROTECT8198\n\t\t$match = preg_replace('|\\&([a-z\\_0-9\\-]+)\\=([a-z\\_0-9\\-/]+)|i', $this->xss_hash().'\\\\1=\\\\2', $match[0]);\n\n\t\t// Decode, then un-protect URL GET vars\n\t\treturn str_replace(\n\t\t\t$this->xss_hash(),\n\t\t\t'&',\n\t\t\t$this->entity_decode($match, $this->charset)\n\t\t);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Do Never Allowed\n\t *\n\t * @used-by\tCI_Security::xss_clean()\n\t * @param \tstring\n\t * @return \tstring\n\t */\n\tprotected function _do_never_allowed($str)\n\t{\n\t\t$str = str_replace(array_keys($this->_never_allowed_str), $this->_never_allowed_str, $str);\n\n\t\tforeach ($this->_never_allowed_regex as $regex)\n\t\t{\n\t\t\t$str = preg_replace('#'.$regex.'#is', '[removed]', $str);\n\t\t}\n\n\t\treturn $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set CSRF Hash and Cookie\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _csrf_set_hash()\n\t{\n\t\tif ($this->_csrf_hash === NULL)\n\t\t{\n\t\t\t// If the cookie exists we will use its value.\n\t\t\t// We don't necessarily want to regenerate it with\n\t\t\t// each page load since a page could contain embedded\n\t\t\t// sub-pages causing this feature to fail\n\t\t\tif (isset($_COOKIE[$this->_csrf_cookie_name]) && is_string($_COOKIE[$this->_csrf_cookie_name])\n\t\t\t\t&& preg_match('#^[0-9a-f]{32}$#iS', $_COOKIE[$this->_csrf_cookie_name]) === 1)\n\t\t\t{\n\t\t\t\treturn $this->_csrf_hash = $_COOKIE[$this->_csrf_cookie_name];\n\t\t\t}\n\n\t\t\t$rand = $this->get_random_bytes(16);\n\t\t\t$this->_csrf_hash = ($rand === FALSE)\n\t\t\t\t? md5(uniqid(mt_rand(), TRUE))\n\t\t\t\t: bin2hex($rand);\n\t\t}\n\n\t\treturn $this->_csrf_hash;\n\t}\n}\n" }, { "path": "system/core/URI.php", "content": "config = $config;\n\n\t\t// If it's a CLI request, ignore the configuration\n\t\tif (is_cli())\n\t\t{\n\t\t\t$this->_set_uri_string($this->_parse_argv(), TRUE);\n\t\t}\n\t\t// If query strings are enabled, we don't need to parse any segments.\n\t\telseif ($this->config->item('enable_query_strings') !== TRUE)\n\t\t{\n\t\t\t$this->_permitted_uri_chars = $this->config->item('permitted_uri_chars');\n\t\t\t$protocol = $this->config->item('uri_protocol');\n\t\t\tempty($protocol) && $protocol = 'REQUEST_URI';\n\n\t\t\tswitch ($protocol)\n\t\t\t{\n\t\t\t\tcase 'AUTO': // For BC purposes only\n\t\t\t\tcase 'REQUEST_URI':\n\t\t\t\t\t$uri = $this->_parse_request_uri();\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'QUERY_STRING':\n\t\t\t\t\t$uri = $this->_parse_query_string();\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'PATH_INFO':\n\t\t\t\tdefault:\n\t\t\t\t\t$uri = isset($_SERVER[$protocol])\n\t\t\t\t\t\t? $_SERVER[$protocol]\n\t\t\t\t\t\t: $this->_parse_request_uri();\n\t\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\t$this->_set_uri_string($uri, FALSE);\n\t\t}\n\n\t\tlog_message('info', 'URI Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set URI String\n\t *\n\t * @param \tstring\t$str\tInput URI string\n\t * @param\tbool\t$is_cli\tWhether the input comes from CLI\n\t * @return\tvoid\n\t */\n\tprotected function _set_uri_string($str, $is_cli = FALSE)\n\t{\n\t\t// CLI requests have a bit simpler logic\n\t\tif ($is_cli)\n\t\t{\n\t\t\tif (($this->uri_string = trim($str, '/')) === '')\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t$this->segments[0] = NULL;\n\t\t\tforeach (explode('/', $this->uri_string) as $segment)\n\t\t\t{\n\t\t\t\tif (($segment = trim($segment)) !== '')\n\t\t\t\t{\n\t\t\t\t\t$this->segments[] = $segment;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tunset($this->segments[0]);\n\t\t\treturn;\n\t\t}\n\n\t\t// Filter out control characters and trim slashes\n\t\t$this->uri_string = trim(remove_invisible_characters($str, FALSE), '/');\n\n\t\tif ($this->uri_string === '')\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove the URL suffix, if present\n\t\tif (($suffix = (string) $this->config->item('url_suffix')) !== '')\n\t\t{\n\t\t\t$slen = strlen($suffix);\n\n\t\t\tif (substr($this->uri_string, -$slen) === $suffix)\n\t\t\t{\n\t\t\t\t$this->uri_string = substr($this->uri_string, 0, -$slen);\n\t\t\t}\n\t\t}\n\n\t\t$this->segments[0] = NULL;\n\t\tforeach (explode('/', trim($this->uri_string, '/')) as $segment)\n\t\t{\n\t\t\t$segment = trim($segment);\n\t\t\t// Filter segments for security\n\t\t\t$this->filter_uri($segment);\n\n\t\t\tif ($segment !== '')\n\t\t\t{\n\t\t\t\t$this->segments[] = $segment;\n\t\t\t}\n\t\t}\n\n\t\tunset($this->segments[0]);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Parse REQUEST_URI\n\t *\n\t * Will parse REQUEST_URI and automatically detect the URI from it,\n\t * while fixing the query string if necessary.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _parse_request_uri()\n\t{\n\t\tif ( ! isset($_SERVER['REQUEST_URI'], $_SERVER['SCRIPT_NAME']))\n\t\t{\n\t\t\treturn '';\n\t\t}\n\n\t\t// parse_url() returns false if no host is present, but the path or query string\n\t\t// contains a colon followed by a number\n\t\t$uri = parse_url('http://dummy'.$_SERVER['REQUEST_URI']);\n\t\t$query = isset($uri['query']) ? $uri['query'] : '';\n\t\t$uri = isset($uri['path']) ? $uri['path'] : '';\n\n\t\tif (isset($_SERVER['SCRIPT_NAME'][0]))\n\t\t{\n\t\t\tif (strpos($uri, $_SERVER['SCRIPT_NAME']) === 0)\n\t\t\t{\n\t\t\t\t$uri = (string) substr($uri, strlen($_SERVER['SCRIPT_NAME']));\n\t\t\t}\n\t\t\telseif (strpos($uri, dirname($_SERVER['SCRIPT_NAME'])) === 0)\n\t\t\t{\n\t\t\t\t$uri = (string) substr($uri, strlen(dirname($_SERVER['SCRIPT_NAME'])));\n\t\t\t}\n\t\t}\n\n\t\t// This section ensures that even on servers that require the URI to be in the query string (Nginx) a correct\n\t\t// URI is found, and also fixes the QUERY_STRING server var and $_GET array.\n\t\tif (trim($uri, '/') === '' && strncmp($query, '/', 1) === 0)\n\t\t{\n\t\t\t$query = explode('?', $query, 2);\n\t\t\t$uri = $query[0];\n\t\t\t$_SERVER['QUERY_STRING'] = isset($query[1]) ? $query[1] : '';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$_SERVER['QUERY_STRING'] = $query;\n\t\t}\n\n\t\tparse_str($_SERVER['QUERY_STRING'], $_GET);\n\n\t\tif ($uri === '/' OR $uri === '')\n\t\t{\n\t\t\treturn '/';\n\t\t}\n\n\t\t// Do some final cleaning of the URI and return it\n\t\treturn $this->_remove_relative_directory($uri);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Parse QUERY_STRING\n\t *\n\t * Will parse QUERY_STRING and automatically detect the URI from it.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _parse_query_string()\n\t{\n\t\t$uri = isset($_SERVER['QUERY_STRING']) ? $_SERVER['QUERY_STRING'] : @getenv('QUERY_STRING');\n\n\t\tif (trim($uri, '/') === '')\n\t\t{\n\t\t\treturn '';\n\t\t}\n\t\telseif (strncmp($uri, '/', 1) === 0)\n\t\t{\n\t\t\t$uri = explode('?', $uri, 2);\n\t\t\t$_SERVER['QUERY_STRING'] = isset($uri[1]) ? $uri[1] : '';\n\t\t\t$uri = $uri[0];\n\t\t}\n\n\t\tparse_str($_SERVER['QUERY_STRING'], $_GET);\n\n\t\treturn $this->_remove_relative_directory($uri);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Parse CLI arguments\n\t *\n\t * Take each command line argument and assume it is a URI segment.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _parse_argv()\n\t{\n\t\t$args = array_slice($_SERVER['argv'], 1);\n\t\treturn $args ? implode('/', $args) : '';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Remove relative directory (../) and multi slashes (///)\n\t *\n\t * Do some final cleaning of the URI and return it, currently only used in self::_parse_request_uri()\n\t *\n\t * @param\tstring\t$uri\n\t * @return\tstring\n\t */\n\tprotected function _remove_relative_directory($uri)\n\t{\n\t\t$uris = array();\n\t\t$tok = strtok($uri, '/');\n\t\twhile ($tok !== FALSE)\n\t\t{\n\t\t\tif (( ! empty($tok) OR $tok === '0') && $tok !== '..')\n\t\t\t{\n\t\t\t\t$uris[] = $tok;\n\t\t\t}\n\t\t\t$tok = strtok('/');\n\t\t}\n\n\t\treturn implode('/', $uris);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Filter URI\n\t *\n\t * Filters segments for malicious characters.\n\t *\n\t * @param\tstring\t$str\n\t * @return\tvoid\n\t */\n\tpublic function filter_uri(&$str)\n\t{\n\t\tif ( ! empty($str) && ! empty($this->_permitted_uri_chars) && ! preg_match('/^['.$this->_permitted_uri_chars.']+$/i'.(UTF8_ENABLED ? 'u' : ''), $str))\n\t\t{\n\t\t\tshow_error('The URI you submitted has disallowed characters.', 400);\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch URI Segment\n\t *\n\t * @see\t\tCI_URI::$segments\n\t * @param\tint\t\t$n\t\tIndex\n\t * @param\tmixed\t\t$no_result\tWhat to return if the segment index is not found\n\t * @return\tmixed\n\t */\n\tpublic function segment($n, $no_result = NULL)\n\t{\n\t\treturn isset($this->segments[$n]) ? $this->segments[$n] : $no_result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch URI \"routed\" Segment\n\t *\n\t * Returns the re-routed URI segment (assuming routing rules are used)\n\t * based on the index provided. If there is no routing, will return\n\t * the same result as CI_URI::segment().\n\t *\n\t * @see\t\tCI_URI::$rsegments\n\t * @see\t\tCI_URI::segment()\n\t * @param\tint\t\t$n\t\tIndex\n\t * @param\tmixed\t\t$no_result\tWhat to return if the segment index is not found\n\t * @return\tmixed\n\t */\n\tpublic function rsegment($n, $no_result = NULL)\n\t{\n\t\treturn isset($this->rsegments[$n]) ? $this->rsegments[$n] : $no_result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * URI to assoc\n\t *\n\t * Generates an associative array of URI data starting at the supplied\n\t * segment index. For example, if this is your URI:\n\t *\n\t *\texample.com/user/search/name/joe/location/UK/gender/male\n\t *\n\t * You can use this method to generate an array with this prototype:\n\t *\n\t *\tarray (\n\t *\t\tname => joe\n\t *\t\tlocation => UK\n\t *\t\tgender => male\n\t *\t )\n\t *\n\t * @param\tint\t$n\t\tIndex (default: 3)\n\t * @param\tarray\t$default\tDefault values\n\t * @return\tarray\n\t */\n\tpublic function uri_to_assoc($n = 3, $default = array())\n\t{\n\t\treturn $this->_uri_to_assoc($n, $default, 'segment');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Routed URI to assoc\n\t *\n\t * Identical to CI_URI::uri_to_assoc(), only it uses the re-routed\n\t * segment array.\n\t *\n\t * @see\t\tCI_URI::uri_to_assoc()\n\t * @param \tint\t$n\t\tIndex (default: 3)\n\t * @param \tarray\t$default\tDefault values\n\t * @return \tarray\n\t */\n\tpublic function ruri_to_assoc($n = 3, $default = array())\n\t{\n\t\treturn $this->_uri_to_assoc($n, $default, 'rsegment');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal URI-to-assoc\n\t *\n\t * Generates a key/value pair from the URI string or re-routed URI string.\n\t *\n\t * @used-by\tCI_URI::uri_to_assoc()\n\t * @used-by\tCI_URI::ruri_to_assoc()\n\t * @param\tint\t$n\t\tIndex (default: 3)\n\t * @param\tarray\t$default\tDefault values\n\t * @param\tstring\t$which\t\tArray name ('segment' or 'rsegment')\n\t * @return\tarray\n\t */\n\tprotected function _uri_to_assoc($n = 3, $default = array(), $which = 'segment')\n\t{\n\t\tif ( ! is_numeric($n))\n\t\t{\n\t\t\treturn $default;\n\t\t}\n\n\t\tif (isset($this->keyval[$which], $this->keyval[$which][$n]))\n\t\t{\n\t\t\treturn $this->keyval[$which][$n];\n\t\t}\n\n\t\t$total_segments = \"total_{$which}s\";\n\t\t$segment_array = \"{$which}_array\";\n\n\t\tif ($this->$total_segments() < $n)\n\t\t{\n\t\t\treturn (count($default) === 0)\n\t\t\t\t? array()\n\t\t\t\t: array_fill_keys($default, NULL);\n\t\t}\n\n\t\t$segments = array_slice($this->$segment_array(), ($n - 1));\n\t\t$i = 0;\n\t\t$lastval = '';\n\t\t$retval = array();\n\t\tforeach ($segments as $seg)\n\t\t{\n\t\t\tif ($i % 2)\n\t\t\t{\n\t\t\t\t$retval[$lastval] = $seg;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$retval[$seg] = NULL;\n\t\t\t\t$lastval = $seg;\n\t\t\t}\n\n\t\t\t$i++;\n\t\t}\n\n\t\tif (count($default) > 0)\n\t\t{\n\t\t\tforeach ($default as $val)\n\t\t\t{\n\t\t\t\tif ( ! array_key_exists($val, $retval))\n\t\t\t\t{\n\t\t\t\t\t$retval[$val] = NULL;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Cache the array for reuse\n\t\tisset($this->keyval[$which]) OR $this->keyval[$which] = array();\n\t\t$this->keyval[$which][$n] = $retval;\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Assoc to URI\n\t *\n\t * Generates a URI string from an associative array.\n\t *\n\t * @param\tarray\t$array\tInput array of key/value pairs\n\t * @return\tstring\tURI string\n\t */\n\tpublic function assoc_to_uri($array)\n\t{\n\t\t$temp = array();\n\t\tforeach ((array) $array as $key => $val)\n\t\t{\n\t\t\t$temp[] = $key;\n\t\t\t$temp[] = $val;\n\t\t}\n\n\t\treturn implode('/', $temp);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Slash segment\n\t *\n\t * Fetches an URI segment with a slash.\n\t *\n\t * @param\tint\t$n\tIndex\n\t * @param\tstring\t$where\tWhere to add the slash ('trailing' or 'leading')\n\t * @return\tstring\n\t */\n\tpublic function slash_segment($n, $where = 'trailing')\n\t{\n\t\treturn $this->_slash_segment($n, $where, 'segment');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Slash routed segment\n\t *\n\t * Fetches an URI routed segment with a slash.\n\t *\n\t * @param\tint\t$n\tIndex\n\t * @param\tstring\t$where\tWhere to add the slash ('trailing' or 'leading')\n\t * @return\tstring\n\t */\n\tpublic function slash_rsegment($n, $where = 'trailing')\n\t{\n\t\treturn $this->_slash_segment($n, $where, 'rsegment');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal Slash segment\n\t *\n\t * Fetches an URI Segment and adds a slash to it.\n\t *\n\t * @used-by\tCI_URI::slash_segment()\n\t * @used-by\tCI_URI::slash_rsegment()\n\t *\n\t * @param\tint\t$n\tIndex\n\t * @param\tstring\t$where\tWhere to add the slash ('trailing' or 'leading')\n\t * @param\tstring\t$which\tArray name ('segment' or 'rsegment')\n\t * @return\tstring\n\t */\n\tprotected function _slash_segment($n, $where = 'trailing', $which = 'segment')\n\t{\n\t\t$leading = $trailing = '/';\n\n\t\tif ($where === 'trailing')\n\t\t{\n\t\t\t$leading\t= '';\n\t\t}\n\t\telseif ($where === 'leading')\n\t\t{\n\t\t\t$trailing\t= '';\n\t\t}\n\n\t\treturn $leading.$this->$which($n).$trailing;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Segment Array\n\t *\n\t * @return\tarray\tCI_URI::$segments\n\t */\n\tpublic function segment_array()\n\t{\n\t\treturn $this->segments;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Routed Segment Array\n\t *\n\t * @return\tarray\tCI_URI::$rsegments\n\t */\n\tpublic function rsegment_array()\n\t{\n\t\treturn $this->rsegments;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Total number of segments\n\t *\n\t * @return\tint\n\t */\n\tpublic function total_segments()\n\t{\n\t\treturn count($this->segments);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Total number of routed segments\n\t *\n\t * @return\tint\n\t */\n\tpublic function total_rsegments()\n\t{\n\t\treturn count($this->rsegments);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch URI string\n\t *\n\t * @return\tstring\tCI_URI::$uri_string\n\t */\n\tpublic function uri_string()\n\t{\n\t\treturn $this->uri_string;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Re-routed URI string\n\t *\n\t * @return\tstring\n\t */\n\tpublic function ruri_string()\n\t{\n\t\treturn ltrim(load_class('Router', 'core')->directory, '/').implode('/', $this->rsegments);\n\t}\n\n}\n" }, { "path": "system/core/Utf8.php", "content": "is_ascii($str) === FALSE)\n\t\t{\n\t\t\tif (MB_ENABLED)\n\t\t\t{\n\t\t\t\t$str = mb_convert_encoding($str, 'UTF-8', 'UTF-8');\n\t\t\t}\n\t\t\telseif (ICONV_ENABLED)\n\t\t\t{\n\t\t\t\t$str = @iconv('UTF-8', 'UTF-8//IGNORE', $str);\n\t\t\t}\n\t\t}\n\n\t\treturn $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Remove ASCII control characters\n\t *\n\t * Removes all ASCII control characters except horizontal tabs,\n\t * line feeds, and carriage returns, as all others can cause\n\t * problems in XML.\n\t *\n\t * @param\tstring\t$str\tString to clean\n\t * @return\tstring\n\t */\n\tpublic function safe_ascii_for_xml($str)\n\t{\n\t\treturn remove_invisible_characters($str, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Convert to UTF-8\n\t *\n\t * Attempts to convert a string to UTF-8.\n\t *\n\t * @param\tstring\t$str\t\tInput string\n\t * @param\tstring\t$encoding\tInput encoding\n\t * @return\tstring\t$str encoded in UTF-8 or FALSE on failure\n\t */\n\tpublic function convert_to_utf8($str, $encoding)\n\t{\n\t\tif (MB_ENABLED)\n\t\t{\n\t\t\treturn mb_convert_encoding($str, 'UTF-8', $encoding);\n\t\t}\n\t\telseif (ICONV_ENABLED)\n\t\t{\n\t\t\treturn @iconv($encoding, 'UTF-8', $str);\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Is ASCII?\n\t *\n\t * Tests if a string is standard 7-bit ASCII or not.\n\t *\n\t * @param\tstring\t$str\tString to check\n\t * @return\tbool\n\t */\n\tpublic function is_ascii($str)\n\t{\n\t\treturn (preg_match('/[^\\x00-\\x7F]/S', $str) === 0);\n\t}\n\n}\n" }, { "path": "system/core/compat/hash.php", "content": " 32,\n\t\t\t'haval128,3' => 128,\n\t\t\t'haval160,3' => 128,\n\t\t\t'haval192,3' => 128,\n\t\t\t'haval224,3' => 128,\n\t\t\t'haval256,3' => 128,\n\t\t\t'haval128,4' => 128,\n\t\t\t'haval160,4' => 128,\n\t\t\t'haval192,4' => 128,\n\t\t\t'haval224,4' => 128,\n\t\t\t'haval256,4' => 128,\n\t\t\t'haval128,5' => 128,\n\t\t\t'haval160,5' => 128,\n\t\t\t'haval192,5' => 128,\n\t\t\t'haval224,5' => 128,\n\t\t\t'haval256,5' => 128,\n\t\t\t'md2' => 16,\n\t\t\t'md4' => 64,\n\t\t\t'md5' => 64,\n\t\t\t'ripemd128' => 64,\n\t\t\t'ripemd160' => 64,\n\t\t\t'ripemd256' => 64,\n\t\t\t'ripemd320' => 64,\n\t\t\t'sha1' => 64,\n\t\t\t'sha224' => 64,\n\t\t\t'sha256' => 64,\n\t\t\t'sha384' => 128,\n\t\t\t'sha512' => 128,\n\t\t\t'snefru' => 32,\n\t\t\t'snefru256' => 32,\n\t\t\t'tiger128,3' => 64,\n\t\t\t'tiger160,3' => 64,\n\t\t\t'tiger192,3' => 64,\n\t\t\t'tiger128,4' => 64,\n\t\t\t'tiger160,4' => 64,\n\t\t\t'tiger192,4' => 64,\n\t\t\t'whirlpool' => 64\n\t\t);\n\n\t\tif (isset($block_sizes[$algo], $password[$block_sizes[$algo]]))\n\t\t{\n\t\t\t$password = hash($algo, $password, TRUE);\n\t\t}\n\n\t\t$hash = '';\n\t\t// Note: Blocks are NOT 0-indexed\n\t\tfor ($bc = (int) ceil($length / $hash_length), $bi = 1; $bi <= $bc; $bi++)\n\t\t{\n\t\t\t$key = $derived_key = hash_hmac($algo, $salt.pack('N', $bi), $password, TRUE);\n\t\t\tfor ($i = 1; $i < $iterations; $i++)\n\t\t\t{\n\t\t\t\t$derived_key ^= $key = hash_hmac($algo, $key, $password, TRUE);\n\t\t\t}\n\n\t\t\t$hash .= $derived_key;\n\t\t}\n\n\t\t// This is not RFC-compatible, but we're aiming for natural PHP compatibility\n\t\tif ( ! $raw_output)\n\t\t{\n\t\t\t$hash = bin2hex($hash);\n\t\t}\n\n\t\treturn defined('MB_OVERLOAD_STRING')\n\t\t\t? mb_substr($hash, 0, $length, '8bit')\n\t\t\t: substr($hash, 0, $length);\n\t}\n}\n" }, { "path": "system/core/compat/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/core/compat/mbstring.php", "content": " 0, 'algoName' => 'unknown', 'options' => array())\n\t\t\t: array('algo' => 1, 'algoName' => 'bcrypt', 'options' => array('cost' => $hash));\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('password_hash'))\n{\n\t/**\n\t * password_hash()\n\t *\n\t * @link\thttps://secure.php.net/password_hash\n\t * @param\tstring\t$password\n\t * @param\tint\t$algo\n\t * @param\tarray\t$options\n\t * @return\tmixed\n\t */\n\tfunction password_hash($password, $algo, array $options = array())\n\t{\n\t\tstatic $func_overload;\n\t\tisset($func_overload) OR $func_overload = (extension_loaded('mbstring') && ini_get('mbstring.func_overload'));\n\n\t\tif ($algo !== 1)\n\t\t{\n\t\t\ttrigger_error('password_hash(): Unknown hashing algorithm: '.(int) $algo, E_USER_WARNING);\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif (isset($options['cost']) && ($options['cost'] < 4 OR $options['cost'] > 31))\n\t\t{\n\t\t\ttrigger_error('password_hash(): Invalid bcrypt cost parameter specified: '.(int) $options['cost'], E_USER_WARNING);\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif (isset($options['salt']) && ($saltlen = ($func_overload ? mb_strlen($options['salt'], '8bit') : strlen($options['salt']))) < 22)\n\t\t{\n\t\t\ttrigger_error('password_hash(): Provided salt is too short: '.$saltlen.' expecting 22', E_USER_WARNING);\n\t\t\treturn NULL;\n\t\t}\n\t\telseif ( ! isset($options['salt']))\n\t\t{\n\t\t\tif (function_exists('random_bytes'))\n\t\t\t{\n\t\t\t\ttry\n\t\t\t\t{\n\t\t\t\t\t$options['salt'] = random_bytes(16);\n\t\t\t\t}\n\t\t\t\tcatch (Exception $e)\n\t\t\t\t{\n\t\t\t\t\tlog_message('error', 'compat/password: Error while trying to use random_bytes(): '.$e->getMessage());\n\t\t\t\t\treturn FALSE;\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif (defined('MCRYPT_DEV_URANDOM'))\n\t\t\t{\n\t\t\t\t$options['salt'] = mcrypt_create_iv(16, MCRYPT_DEV_URANDOM);\n\t\t\t}\n\t\t\telseif (DIRECTORY_SEPARATOR === '/' && (is_readable($dev = '/dev/arandom') OR is_readable($dev = '/dev/urandom')))\n\t\t\t{\n\t\t\t\tif (($fp = fopen($dev, 'rb')) === FALSE)\n\t\t\t\t{\n\t\t\t\t\tlog_message('error', 'compat/password: Unable to open '.$dev.' for reading.');\n\t\t\t\t\treturn FALSE;\n\t\t\t\t}\n\n\t\t\t\t// Try not to waste entropy ...\n\t\t\t\tstream_set_chunk_size($fp, 16);\n\n\t\t\t\t$options['salt'] = '';\n\t\t\t\tfor ($read = 0; $read < 16; $read = ($func_overload) ? mb_strlen($options['salt'], '8bit') : strlen($options['salt']))\n\t\t\t\t{\n\t\t\t\t\tif (($read = fread($fp, 16 - $read)) === FALSE)\n\t\t\t\t\t{\n\t\t\t\t\t\tlog_message('error', 'compat/password: Error while reading from '.$dev.'.');\n\t\t\t\t\t\treturn FALSE;\n\t\t\t\t\t}\n\t\t\t\t\t$options['salt'] .= $read;\n\t\t\t\t}\n\n\t\t\t\tfclose($fp);\n\t\t\t}\n\t\t\telseif (function_exists('openssl_random_pseudo_bytes'))\n\t\t\t{\n\t\t\t\t$is_secure = NULL;\n\t\t\t\t$options['salt'] = openssl_random_pseudo_bytes(16, $is_secure);\n\t\t\t\tif ($is_secure !== TRUE)\n\t\t\t\t{\n\t\t\t\t\tlog_message('error', 'compat/password: openssl_random_pseudo_bytes() set the $cryto_strong flag to FALSE');\n\t\t\t\t\treturn FALSE;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tlog_message('error', 'compat/password: No CSPRNG available.');\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\t$options['salt'] = str_replace('+', '.', rtrim(base64_encode($options['salt']), '='));\n\t\t}\n\t\telseif ( ! preg_match('#^[a-zA-Z0-9./]+$#D', $options['salt']))\n\t\t{\n\t\t\t$options['salt'] = str_replace('+', '.', rtrim(base64_encode($options['salt']), '='));\n\t\t}\n\n\t\tisset($options['cost']) OR $options['cost'] = 10;\n\n\t\treturn (strlen($password = crypt($password, sprintf('$2y$%02d$%s', $options['cost'], $options['salt']))) === 60)\n\t\t\t? $password\n\t\t\t: FALSE;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('password_needs_rehash'))\n{\n\t/**\n\t * password_needs_rehash()\n\t *\n\t * @link\thttps://secure.php.net/password_needs_rehash\n\t * @param\tstring\t$hash\n\t * @param\tint\t$algo\n\t * @param\tarray\t$options\n\t * @return\tbool\n\t */\n\tfunction password_needs_rehash($hash, $algo, array $options = array())\n\t{\n\t\t$info = password_get_info($hash);\n\n\t\tif ($algo !== $info['algo'])\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\t\telseif ($algo === 1)\n\t\t{\n\t\t\t$options['cost'] = isset($options['cost']) ? (int) $options['cost'] : 10;\n\t\t\treturn ($info['options']['cost'] !== $options['cost']);\n\t\t}\n\n\t\t// Odd at first glance, but according to a comment in PHP's own unit tests,\n\t\t// because it is an unknown algorithm - it's valid and therefore doesn't\n\t\t// need rehashing.\n\t\treturn FALSE;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('password_verify'))\n{\n\t/**\n\t * password_verify()\n\t *\n\t * @link\thttps://secure.php.net/password_verify\n\t * @param\tstring\t$password\n\t * @param\tstring\t$hash\n\t * @return\tbool\n\t */\n\tfunction password_verify($password, $hash)\n\t{\n\t\tif (strlen($hash) !== 60 OR strlen($password = crypt($password, $hash)) !== 60)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$compare = 0;\n\t\tfor ($i = 0; $i < 60; $i++)\n\t\t{\n\t\t\t$compare |= (ord($password[$i]) ^ ord($hash[$i]));\n\t\t}\n\n\t\treturn ($compare === 0);\n\t}\n}\n" }, { "path": "system/core/compat/standard.php", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/DB.php", "content": "load->get_package_paths() as $path)\n\t\t\t{\n\t\t\t\tif ($path !== APPPATH)\n\t\t\t\t{\n\t\t\t\t\tif (file_exists($file_path = $path.'config/'.ENVIRONMENT.'/database.php'))\n\t\t\t\t\t{\n\t\t\t\t\t\tinclude($file_path);\n\t\t\t\t\t}\n\t\t\t\t\telseif (file_exists($file_path = $path.'config/database.php'))\n\t\t\t\t\t{\n\t\t\t\t\t\tinclude($file_path);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (empty($db))\n\t\t{\n\t\t\tshow_error('No database connection settings were found in the database config file.');\n\t\t}\n\n\t\tif ($params !== '')\n\t\t{\n\t\t\t$active_group = $params;\n\t\t}\n\n\t\tif ( ! isset($active_group))\n\t\t{\n\t\t\tshow_error('You have not specified a database connection group via $active_group in your config/database.php file.');\n\t\t}\n\t\telseif ( ! isset($db[$active_group]))\n\t\t{\n\t\t\tshow_error('You have specified an invalid database connection group ('.$active_group.') in your config/database.php file.');\n\t\t}\n\n\t\t$params = $db[$active_group];\n\t}\n\telseif (is_string($params))\n\t{\n\t\t/**\n\t\t * Parse the URL from the DSN string\n\t\t * Database settings can be passed as discreet\n\t\t * parameters or as a data source name in the first\n\t\t * parameter. DSNs must have this prototype:\n\t\t * $dsn = 'driver://username:password@hostname/database';\n\t\t */\n\t\tif (($dsn = @parse_url($params)) === FALSE)\n\t\t{\n\t\t\tshow_error('Invalid DB Connection String');\n\t\t}\n\n\t\t$params = array(\n\t\t\t'dbdriver'\t=> $dsn['scheme'],\n\t\t\t'hostname'\t=> isset($dsn['host']) ? rawurldecode($dsn['host']) : '',\n\t\t\t'port'\t\t=> isset($dsn['port']) ? rawurldecode($dsn['port']) : '',\n\t\t\t'username'\t=> isset($dsn['user']) ? rawurldecode($dsn['user']) : '',\n\t\t\t'password'\t=> isset($dsn['pass']) ? rawurldecode($dsn['pass']) : '',\n\t\t\t'database'\t=> isset($dsn['path']) ? rawurldecode(substr($dsn['path'], 1)) : ''\n\t\t);\n\n\t\t// Were additional config items set?\n\t\tif (isset($dsn['query']))\n\t\t{\n\t\t\tparse_str($dsn['query'], $extra);\n\n\t\t\tforeach ($extra as $key => $val)\n\t\t\t{\n\t\t\t\tif (is_string($val) && in_array(strtoupper($val), array('TRUE', 'FALSE', 'NULL')))\n\t\t\t\t{\n\t\t\t\t\t$val = var_export($val, TRUE);\n\t\t\t\t}\n\n\t\t\t\t$params[$key] = $val;\n\t\t\t}\n\t\t}\n\t}\n\n\t// No DB specified yet? Beat them senseless...\n\tif (empty($params['dbdriver']))\n\t{\n\t\tshow_error('You have not selected a database type to connect to.');\n\t}\n\n\trequire_once(BASEPATH.'database/DB_driver.php');\n\trequire_once(BASEPATH.'database/DB_query_builder.php');\n\tif ( ! class_exists('CI_DB', FALSE))\n\t{\n\t\t/**\n\t\t * CI_DB\n\t\t *\n\t\t * Acts as an alias for both CI_DB_driver and CI_DB_query_builder.\n\t\t *\n\t\t * @see\tCI_DB_query_builder\n\t\t * @see\tCI_DB_driver\n\t\t */\n\t\tclass CI_DB extends CI_DB_query_builder {}\n\t}\n\n\t// Load the DB driver\n\t$driver_file = BASEPATH.'database/drivers/'.$params['dbdriver'].'/'.$params['dbdriver'].'_driver.php';\n\tfile_exists($driver_file) OR show_error('Invalid DB driver');\n\trequire_once($driver_file);\n\n\t// Load the result classes as well\n\trequire_once(BASEPATH.'database/DB_result.php');\n\trequire_once(BASEPATH.'database/drivers/'.$params['dbdriver'].'/'.$params['dbdriver'].'_result.php');\n\n\t// Instantiate the DB adapter\n\t$driver = 'CI_DB_'.$params['dbdriver'].'_driver';\n\t$DB = new $driver($params);\n\n\t// Check for a subdriver\n\tif ( ! empty($DB->subdriver))\n\t{\n\t\t$driver_file = BASEPATH.'database/drivers/'.$DB->dbdriver.'/subdrivers/'.$DB->dbdriver.'_'.$DB->subdriver.'_driver.php';\n\n\t\tif (file_exists($driver_file))\n\t\t{\n\t\t\trequire_once($driver_file);\n\t\t\t$driver = 'CI_DB_'.$DB->dbdriver.'_'.$DB->subdriver.'_driver';\n\t\t\t$DB = new $driver($params);\n\t\t}\n\t}\n\n\t$DB->initialize();\n\treturn $DB;\n}\n" }, { "path": "system/database/DB_cache.php", "content": "CI and load the file helper since we use it a lot\n\t\t$this->CI =& get_instance();\n\t\t$this->db =& $db;\n\t\t$this->CI->load->helper('file');\n\n\t\t$this->check_path();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Cache Directory Path\n\t *\n\t * @param\tstring\t$path\tPath to the cache directory\n\t * @return\tbool\n\t */\n\tpublic function check_path($path = '')\n\t{\n\t\tif ($path === '')\n\t\t{\n\t\t\tif ($this->db->cachedir === '')\n\t\t\t{\n\t\t\t\treturn $this->db->cache_off();\n\t\t\t}\n\n\t\t\t$path = $this->db->cachedir;\n\t\t}\n\n\t\t// Add a trailing slash to the path if needed\n\t\t$path = realpath($path)\n\t\t\t? rtrim(realpath($path), DIRECTORY_SEPARATOR).DIRECTORY_SEPARATOR\n\t\t\t: rtrim($path, '/').'/';\n\n\t\tif ( ! is_dir($path))\n\t\t{\n\t\t\tlog_message('debug', 'DB cache path error: '.$path);\n\n\t\t\t// If the path is wrong we'll turn off caching\n\t\t\treturn $this->db->cache_off();\n\t\t}\n\n\t\tif ( ! is_really_writable($path))\n\t\t{\n\t\t\tlog_message('debug', 'DB cache dir not writable: '.$path);\n\n\t\t\t// If the path is not really writable we'll turn off caching\n\t\t\treturn $this->db->cache_off();\n\t\t}\n\n\t\t$this->db->cachedir = $path;\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Retrieve a cached query\n\t *\n\t * The URI being requested will become the name of the cache sub-folder.\n\t * An MD5 hash of the SQL statement will become the cache file name.\n\t *\n\t * @param\tstring\t$sql\n\t * @return\tstring\n\t */\n\tpublic function read($sql)\n\t{\n\t\t$segment_one = ($this->CI->uri->segment(1) == FALSE) ? 'default' : $this->CI->uri->segment(1);\n\t\t$segment_two = ($this->CI->uri->segment(2) == FALSE) ? 'index' : $this->CI->uri->segment(2);\n\t\t$filepath = $this->db->cachedir.$segment_one.'+'.$segment_two.'/'.md5($sql);\n\n\t\tif ( ! is_file($filepath) OR FALSE === ($cachedata = file_get_contents($filepath)))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn unserialize($cachedata);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Write a query to a cache file\n\t *\n\t * @param\tstring\t$sql\n\t * @param\tobject\t$object\n\t * @return\tbool\n\t */\n\tpublic function write($sql, $object)\n\t{\n\t\t$segment_one = ($this->CI->uri->segment(1) == FALSE) ? 'default' : $this->CI->uri->segment(1);\n\t\t$segment_two = ($this->CI->uri->segment(2) == FALSE) ? 'index' : $this->CI->uri->segment(2);\n\t\t$dir_path = $this->db->cachedir.$segment_one.'+'.$segment_two.'/';\n\t\t$filename = md5($sql);\n\n\t\tif ( ! is_dir($dir_path) && ! @mkdir($dir_path, 0750))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (write_file($dir_path.$filename, serialize($object)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tchmod($dir_path.$filename, 0640);\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete cache files within a particular directory\n\t *\n\t * @param\tstring\t$segment_one\n\t * @param\tstring\t$segment_two\n\t * @return\tvoid\n\t */\n\tpublic function delete($segment_one = '', $segment_two = '')\n\t{\n\t\tif ($segment_one === '')\n\t\t{\n\t\t\t$segment_one = ($this->CI->uri->segment(1) == FALSE) ? 'default' : $this->CI->uri->segment(1);\n\t\t}\n\n\t\tif ($segment_two === '')\n\t\t{\n\t\t\t$segment_two = ($this->CI->uri->segment(2) == FALSE) ? 'index' : $this->CI->uri->segment(2);\n\t\t}\n\n\t\t$dir_path = $this->db->cachedir.$segment_one.'+'.$segment_two.'/';\n\t\tdelete_files($dir_path, TRUE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete all existing cache files\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function delete_all()\n\t{\n\t\tdelete_files($this->db->cachedir, TRUE, TRUE);\n\t}\n\n}\n" }, { "path": "system/database/DB_driver.php", "content": " $val)\n\t\t\t{\n\t\t\t\t$this->$key = $val;\n\t\t\t}\n\t\t}\n\n\t\tlog_message('info', 'Database Driver Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Initialize Database Settings\n\t *\n\t * @return\tvoid\n\t * @throws\tRuntimeException\tIn case of failure\n\t */\n\tpublic function initialize()\n\t{\n\t\t/* If an established connection is available, then there's\n\t\t * no need to connect and select the database.\n\t\t *\n\t\t * Depending on the database driver, conn_id can be either\n\t\t * boolean TRUE, a resource or an object.\n\t\t */\n\t\tif ($this->conn_id)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// ----------------------------------------------------------------\n\n\t\t// Connect to the database and set the connection ID\n\t\t$this->conn_id = $this->db_connect($this->pconnect);\n\n\t\t// No connection resource? Check if there is a failover else throw an error\n\t\tif ( ! $this->conn_id)\n\t\t{\n\t\t\t// Check if there is a failover set\n\t\t\tif ( ! empty($this->failover) && is_array($this->failover))\n\t\t\t{\n\t\t\t\t// Go over all the failovers\n\t\t\t\tforeach ($this->failover as $failover)\n\t\t\t\t{\n\t\t\t\t\t// Replace the current settings with those of the failover\n\t\t\t\t\tforeach ($failover as $key => $val)\n\t\t\t\t\t{\n\t\t\t\t\t\t$this->$key = $val;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Try to connect\n\t\t\t\t\t$this->conn_id = $this->db_connect($this->pconnect);\n\n\t\t\t\t\t// If a connection is made break the foreach loop\n\t\t\t\t\tif ($this->conn_id)\n\t\t\t\t\t{\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// We still don't have a connection?\n\t\t\tif ( ! $this->conn_id)\n\t\t\t{\n\t\t\t\tthrow new RuntimeException('Unable to connect to the database.');\n\t\t\t}\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * DB connect\n\t *\n\t * This is just a dummy method that all drivers will override.\n\t *\n\t * @return\tmixed\n\t */\n\tpublic function db_connect()\n\t{\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Persistent database connection\n\t *\n\t * @return\tmixed\n\t */\n\tpublic function db_pconnect()\n\t{\n\t\treturn $this->db_connect(TRUE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reconnect\n\t *\n\t * Keep / reestablish the db connection if no queries have been\n\t * sent for a length of time exceeding the server's idle timeout.\n\t *\n\t * This is just a dummy method to allow drivers without such\n\t * functionality to not declare it, while others will override it.\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function reconnect()\n\t{\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select database\n\t *\n\t * This is just a dummy method to allow drivers without such\n\t * functionality to not declare it, while others will override it.\n\t *\n\t * @return\tbool\n\t */\n\tpublic function db_select()\n\t{\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Last error\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => NULL, 'message' => NULL);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * The name of the platform in use (mysql, mssql, etc...)\n\t *\n\t * @return\tstring\n\t */\n\tpublic function platform()\n\t{\n\t\treturn $this->dbdriver;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * Returns a string containing the version of the database being used.\n\t * Most drivers will override this method.\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\tif (FALSE === ($sql = $this->_version()))\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_function') : FALSE;\n\t\t}\n\n\t\t$query = $this->query($sql)->row();\n\t\treturn $this->data_cache['version'] = $query->ver;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Version number query string\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _version()\n\t{\n\t\treturn 'SELECT VERSION() AS ver';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * Accepts an SQL string as input and returns a result object upon\n\t * successful execution of a \"read\" type query. Returns boolean TRUE\n\t * upon successful execution of a \"write\" type query. Returns boolean\n\t * FALSE upon failure, and if the $db_debug variable is set to TRUE\n\t * will raise an error.\n\t *\n\t * @param\tstring\t$sql\n\t * @param\tarray\t$binds = FALSE\t\tAn array of binding data\n\t * @param\tbool\t$return_object = NULL\n\t * @return\tmixed\n\t */\n\tpublic function query($sql, $binds = FALSE, $return_object = NULL)\n\t{\n\t\tif ($sql === '')\n\t\t{\n\t\t\tlog_message('error', 'Invalid query: '.$sql);\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_invalid_query') : FALSE;\n\t\t}\n\t\telseif ( ! is_bool($return_object))\n\t\t{\n\t\t\t$return_object = ! $this->is_write_type($sql);\n\t\t}\n\n\t\t// Verify table prefix and replace if necessary\n\t\tif ($this->dbprefix !== '' && $this->swap_pre !== '' && $this->dbprefix !== $this->swap_pre)\n\t\t{\n\t\t\t$sql = preg_replace('/(\\W)'.$this->swap_pre.'(\\S+?)/', '\\\\1'.$this->dbprefix.'\\\\2', $sql);\n\t\t}\n\n\t\t// Compile binds if needed\n\t\tif ($binds !== FALSE)\n\t\t{\n\t\t\t$sql = $this->compile_binds($sql, $binds);\n\t\t}\n\n\t\t// Is query caching enabled? If the query is a \"read type\"\n\t\t// we will load the caching class and return the previously\n\t\t// cached query if it exists\n\t\tif ($this->cache_on === TRUE && $return_object === TRUE && $this->_cache_init())\n\t\t{\n\t\t\tif (FALSE !== ($cache = $this->CACHE->read($sql)))\n\t\t\t{\n\t\t\t\treturn $cache;\n\t\t\t}\n\t\t}\n\n\t\t// Save the query for debugging\n\t\tif ($this->save_queries === TRUE)\n\t\t{\n\t\t\t$this->queries[] = $sql;\n\t\t}\n\n\t\t// Start the Query Timer\n\t\t$time_start = microtime(TRUE);\n\n\t\t// Run the Query\n\t\tif (FALSE === ($this->result_id = $this->simple_query($sql)))\n\t\t{\n\t\t\tif ($this->save_queries === TRUE)\n\t\t\t{\n\t\t\t\t$this->query_times[] = 0;\n\t\t\t}\n\n\t\t\t// This will trigger a rollback if transactions are being used\n\t\t\tif ($this->_trans_depth !== 0)\n\t\t\t{\n\t\t\t\t$this->_trans_status = FALSE;\n\t\t\t}\n\n\t\t\t// Grab the error now, as we might run some additional queries before displaying the error\n\t\t\t$error = $this->error();\n\n\t\t\t// Log errors\n\t\t\tlog_message('error', 'Query error: '.$error['message'].' - Invalid query: '.$sql);\n\n\t\t\tif ($this->db_debug)\n\t\t\t{\n\t\t\t\t// We call this function in order to roll-back queries\n\t\t\t\t// if transactions are enabled. If we don't call this here\n\t\t\t\t// the error message will trigger an exit, causing the\n\t\t\t\t// transactions to remain in limbo.\n\t\t\t\twhile ($this->_trans_depth !== 0)\n\t\t\t\t{\n\t\t\t\t\t$trans_depth = $this->_trans_depth;\n\t\t\t\t\t$this->trans_complete();\n\t\t\t\t\tif ($trans_depth === $this->_trans_depth)\n\t\t\t\t\t{\n\t\t\t\t\t\tlog_message('error', 'Database: Failure during an automated transaction commit/rollback!');\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Display errors\n\t\t\t\treturn $this->display_error(array('Error Number: '.$error['code'], $error['message'], $sql));\n\t\t\t}\n\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// Stop and aggregate the query time results\n\t\t$time_end = microtime(TRUE);\n\t\t$this->benchmark += $time_end - $time_start;\n\n\t\tif ($this->save_queries === TRUE)\n\t\t{\n\t\t\t$this->query_times[] = $time_end - $time_start;\n\t\t}\n\n\t\t// Increment the query counter\n\t\t$this->query_count++;\n\n\t\t// Will we have a result object instantiated? If not - we'll simply return TRUE\n\t\tif ($return_object !== TRUE)\n\t\t{\n\t\t\t// If caching is enabled we'll auto-cleanup any existing files related to this particular URI\n\t\t\tif ($this->cache_on === TRUE && $this->cache_autodel === TRUE && $this->_cache_init())\n\t\t\t{\n\t\t\t\t$this->CACHE->delete();\n\t\t\t}\n\n\t\t\treturn TRUE;\n\t\t}\n\n\t\t// Instantiate the driver-specific result class\n\t\t$driver\t= 'CI_DB_'.$this->dbdriver.'_result';\n\t\t$RES = new $driver($this);\n\n\t\t// Is query caching enabled? If so, we'll serialize the\n\t\t// result object and save it to a cache file.\n\t\tif ($this->cache_on === TRUE && $this->_cache_init())\n\t\t{\n\t\t\t// We'll create a new instance of the result object\n\t\t\t// only without the platform specific driver since\n\t\t\t// we can't use it with cached data (the query result\n\t\t\t// resource ID won't be any good once we've cached the\n\t\t\t// result object, so we'll have to compile the data\n\t\t\t// and save it)\n\t\t\t$CR = new CI_DB_result($this);\n\t\t\t$CR->result_object\t= $RES->result_object();\n\t\t\t$CR->result_array\t= $RES->result_array();\n\t\t\t$CR->num_rows\t\t= $RES->num_rows();\n\n\t\t\t// Reset these since cached objects can not utilize resource IDs.\n\t\t\t$CR->conn_id\t\t= NULL;\n\t\t\t$CR->result_id\t\t= NULL;\n\n\t\t\t$this->CACHE->write($sql, $CR);\n\t\t}\n\n\t\treturn $RES;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Simple Query\n\t * This is a simplified version of the query() function. Internally\n\t * we only use it when running transaction commands since they do\n\t * not require all the features of the main query() function.\n\t *\n\t * @param\tstring\tthe sql query\n\t * @return\tmixed\n\t */\n\tpublic function simple_query($sql)\n\t{\n\t\tempty($this->conn_id) && $this->initialize();\n\t\treturn $this->_execute($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Disable Transactions\n\t * This permits transactions to be disabled at run-time.\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function trans_off()\n\t{\n\t\t$this->trans_enabled = FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Enable/disable Transaction Strict Mode\n\t *\n\t * When strict mode is enabled, if you are running multiple groups of\n\t * transactions, if one group fails all subsequent groups will be\n\t * rolled back.\n\t *\n\t * If strict mode is disabled, each group is treated autonomously,\n\t * meaning a failure of one group will not affect any others\n\t *\n\t * @param\tbool\t$mode = TRUE\n\t * @return\tvoid\n\t */\n\tpublic function trans_strict($mode = TRUE)\n\t{\n\t\t$this->trans_strict = is_bool($mode) ? $mode : TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Start Transaction\n\t *\n\t * @param\tbool\t$test_mode = FALSE\n\t * @return\tbool\n\t */\n\tpublic function trans_start($test_mode = FALSE)\n\t{\n\t\tif ( ! $this->trans_enabled)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn $this->trans_begin($test_mode);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Complete Transaction\n\t *\n\t * @return\tbool\n\t */\n\tpublic function trans_complete()\n\t{\n\t\tif ( ! $this->trans_enabled)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// The query() function will set this flag to FALSE in the event that a query failed\n\t\tif ($this->_trans_status === FALSE OR $this->_trans_failure === TRUE)\n\t\t{\n\t\t\t$this->trans_rollback();\n\n\t\t\t// If we are NOT running in strict mode, we will reset\n\t\t\t// the _trans_status flag so that subsequent groups of\n\t\t\t// transactions will be permitted.\n\t\t\tif ($this->trans_strict === FALSE)\n\t\t\t{\n\t\t\t\t$this->_trans_status = TRUE;\n\t\t\t}\n\n\t\t\tlog_message('debug', 'DB Transaction Failure');\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn $this->trans_commit();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Lets you retrieve the transaction flag to determine if it has failed\n\t *\n\t * @return\tbool\n\t */\n\tpublic function trans_status()\n\t{\n\t\treturn $this->_trans_status;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns TRUE if a transaction is currently active\n\t *\n\t * @return\tbool\n\t */\n\tpublic function trans_active()\n\t{\n\t\treturn (bool) $this->_trans_depth;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @param\tbool\t$test_mode\n\t * @return\tbool\n\t */\n\tpublic function trans_begin($test_mode = FALSE)\n\t{\n\t\tif ( ! $this->trans_enabled)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t// When transactions are nested we only begin/commit/rollback the outermost ones\n\t\telseif ($this->_trans_depth > 0)\n\t\t{\n\t\t\t$this->_trans_depth++;\n\t\t\treturn TRUE;\n\t\t}\n\n\t\t// Reset the transaction failure flag.\n\t\t// If the $test_mode flag is set to TRUE transactions will be rolled back\n\t\t// even if the queries produce a successful result.\n\t\t$this->_trans_failure = ($test_mode === TRUE);\n\n\t\tif ($this->_trans_begin())\n\t\t{\n\t\t\t$this->_trans_status = TRUE;\n\t\t\t$this->_trans_depth++;\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tpublic function trans_commit()\n\t{\n\t\tif ( ! $this->trans_enabled OR $this->_trans_depth === 0)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t// When transactions are nested we only begin/commit/rollback the outermost ones\n\t\telseif ($this->_trans_depth > 1 OR $this->_trans_commit())\n\t\t{\n\t\t\t$this->_trans_depth--;\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tpublic function trans_rollback()\n\t{\n\t\tif ( ! $this->trans_enabled OR $this->_trans_depth === 0)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t// When transactions are nested we only begin/commit/rollback the outermost ones\n\t\telseif ($this->_trans_depth > 1 OR $this->_trans_rollback())\n\t\t{\n\t\t\t$this->_trans_depth--;\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Compile Bindings\n\t *\n\t * @param\tstring\tthe sql statement\n\t * @param\tarray\tan array of bind data\n\t * @return\tstring\n\t */\n\tpublic function compile_binds($sql, $binds)\n\t{\n\t\tif (empty($this->bind_marker) OR strpos($sql, $this->bind_marker) === FALSE)\n\t\t{\n\t\t\treturn $sql;\n\t\t}\n\t\telseif ( ! is_array($binds))\n\t\t{\n\t\t\t$binds = array($binds);\n\t\t\t$bind_count = 1;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Make sure we're using numeric keys\n\t\t\t$binds = array_values($binds);\n\t\t\t$bind_count = count($binds);\n\t\t}\n\n\t\t// We'll need the marker length later\n\t\t$ml = strlen($this->bind_marker);\n\n\t\t// Make sure not to replace a chunk inside a string that happens to match the bind marker\n\t\tif ($c = preg_match_all(\"/'[^']*'|\\\"[^\\\"]*\\\"/i\", $sql, $matches))\n\t\t{\n\t\t\t$c = preg_match_all('/'.preg_quote($this->bind_marker, '/').'/i',\n\t\t\t\tstr_replace($matches[0],\n\t\t\t\t\tstr_replace($this->bind_marker, str_repeat(' ', $ml), $matches[0]),\n\t\t\t\t\t$sql, $c),\n\t\t\t\t$matches, PREG_OFFSET_CAPTURE);\n\n\t\t\t// Bind values' count must match the count of markers in the query\n\t\t\tif ($bind_count !== $c)\n\t\t\t{\n\t\t\t\treturn $sql;\n\t\t\t}\n\t\t}\n\t\telseif (($c = preg_match_all('/'.preg_quote($this->bind_marker, '/').'/i', $sql, $matches, PREG_OFFSET_CAPTURE)) !== $bind_count)\n\t\t{\n\t\t\treturn $sql;\n\t\t}\n\n\t\tdo\n\t\t{\n\t\t\t$c--;\n\t\t\t$escaped_value = $this->escape($binds[$c]);\n\t\t\tif (is_array($escaped_value))\n\t\t\t{\n\t\t\t\t$escaped_value = '('.implode(',', $escaped_value).')';\n\t\t\t}\n\t\t\t$sql = substr_replace($sql, $escaped_value, $matches[0][$c][1], $ml);\n\t\t}\n\t\twhile ($c !== 0);\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determines if a query is a \"write\" type.\n\t *\n\t * @param\tstring\tAn SQL query string\n\t * @return\tbool\n\t */\n\tpublic function is_write_type($sql)\n\t{\n\t\treturn (bool) preg_match('/^\\s*\"?(SET|INSERT|UPDATE|DELETE|REPLACE|CREATE|DROP|TRUNCATE|LOAD|COPY|ALTER|RENAME|GRANT|REVOKE|LOCK|UNLOCK|REINDEX|MERGE)\\s/i', $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Calculate the aggregate query elapsed time\n\t *\n\t * @param\tint\tThe number of decimal places\n\t * @return\tstring\n\t */\n\tpublic function elapsed_time($decimals = 6)\n\t{\n\t\treturn number_format($this->benchmark, $decimals);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the total number of queries\n\t *\n\t * @return\tint\n\t */\n\tpublic function total_queries()\n\t{\n\t\treturn $this->query_count;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the last query that was executed\n\t *\n\t * @return\tstring\n\t */\n\tpublic function last_query()\n\t{\n\t\treturn end($this->queries);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * \"Smart\" Escape String\n\t *\n\t * Escapes data based on type\n\t * Sets boolean and null types\n\t *\n\t * @param\tstring\n\t * @return\tmixed\n\t */\n\tpublic function escape($str)\n\t{\n\t\tif (is_array($str))\n\t\t{\n\t\t\t$str = array_map(array(&$this, 'escape'), $str);\n\t\t\treturn $str;\n\t\t}\n\t\telseif (is_string($str) OR (is_object($str) && method_exists($str, '__toString')))\n\t\t{\n\t\t\treturn \"'\".$this->escape_str($str).\"'\";\n\t\t}\n\t\telseif (is_bool($str))\n\t\t{\n\t\t\treturn ($str === FALSE) ? 0 : 1;\n\t\t}\n\t\telseif ($str === NULL)\n\t\t{\n\t\t\treturn 'NULL';\n\t\t}\n\n\t\treturn $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Escape String\n\t *\n\t * @param\tstring|string[]\t$str\tInput string\n\t * @param\tbool\t$like\tWhether or not the string will be used in a LIKE condition\n\t * @return\tstring\n\t */\n\tpublic function escape_str($str, $like = FALSE)\n\t{\n\t\tif (is_array($str))\n\t\t{\n\t\t\tforeach ($str as $key => $val)\n\t\t\t{\n\t\t\t\t$str[$key] = $this->escape_str($val, $like);\n\t\t\t}\n\n\t\t\treturn $str;\n\t\t}\n\n\t\t$str = $this->_escape_str($str);\n\n\t\t// escape LIKE condition wildcards\n\t\tif ($like === TRUE)\n\t\t{\n\t\t\treturn str_replace(\n\t\t\t\tarray($this->_like_escape_chr, '%', '_'),\n\t\t\t\tarray($this->_like_escape_chr.$this->_like_escape_chr, $this->_like_escape_chr.'%', $this->_like_escape_chr.'_'),\n\t\t\t\t$str\n\t\t\t);\n\t\t}\n\n\t\treturn $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Escape LIKE String\n\t *\n\t * Calls the individual driver for platform\n\t * specific escaping for LIKE conditions\n\t *\n\t * @param\tstring|string[]\n\t * @return\tmixed\n\t */\n\tpublic function escape_like_str($str)\n\t{\n\t\treturn $this->escape_str($str, TRUE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\treturn str_replace(\"'\", \"''\", remove_invisible_characters($str, FALSE));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Primary\n\t *\n\t * Retrieves the primary key. It assumes that the row in the first\n\t * position is the primary key\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @return\tstring\n\t */\n\tpublic function primary($table)\n\t{\n\t\t$fields = $this->list_fields($table);\n\t\treturn is_array($fields) ? current($fields) : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * \"Count All\" query\n\t *\n\t * Generates a platform-specific query string that counts all records in\n\t * the specified database\n\t *\n\t * @param\tstring\n\t * @return\tint\n\t */\n\tpublic function count_all($table = '')\n\t{\n\t\tif ($table === '')\n\t\t{\n\t\t\treturn 0;\n\t\t}\n\n\t\t$query = $this->query($this->_count_string.$this->escape_identifiers('numrows').' FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE));\n\t\tif ($query->num_rows() === 0)\n\t\t{\n\t\t\treturn 0;\n\t\t}\n\n\t\t$query = $query->row();\n\t\t$this->_reset_select();\n\t\treturn (int) $query->numrows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an array of table names\n\t *\n\t * @param\tstring\t$constrain_by_prefix = FALSE\n\t * @return\tarray\n\t */\n\tpublic function list_tables($constrain_by_prefix = FALSE)\n\t{\n\t\t// Is there a cached result?\n\t\tif (isset($this->data_cache['table_names']))\n\t\t{\n\t\t\treturn $this->data_cache['table_names'];\n\t\t}\n\n\t\tif (FALSE === ($sql = $this->_list_tables($constrain_by_prefix)))\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_function') : FALSE;\n\t\t}\n\n\t\t$this->data_cache['table_names'] = array();\n\t\t$query = $this->query($sql);\n\n\t\tforeach ($query->result_array() as $row)\n\t\t{\n\t\t\t// Do we know from which column to get the table name?\n\t\t\tif ( ! isset($key))\n\t\t\t{\n\t\t\t\tif (isset($row['table_name']))\n\t\t\t\t{\n\t\t\t\t\t$key = 'table_name';\n\t\t\t\t}\n\t\t\t\telseif (isset($row['TABLE_NAME']))\n\t\t\t\t{\n\t\t\t\t\t$key = 'TABLE_NAME';\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t/* We have no other choice but to just get the first element's key.\n\t\t\t\t\t * Due to array_shift() accepting its argument by reference, if\n\t\t\t\t\t * E_STRICT is on, this would trigger a warning. So we'll have to\n\t\t\t\t\t * assign it first.\n\t\t\t\t\t */\n\t\t\t\t\t$key = array_keys($row);\n\t\t\t\t\t$key = array_shift($key);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t$this->data_cache['table_names'][] = $row[$key];\n\t\t}\n\n\t\treturn $this->data_cache['table_names'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determine if a particular table exists\n\t *\n\t * @param\tstring\t$table_name\n\t * @return\tbool\n\t */\n\tpublic function table_exists($table_name)\n\t{\n\t\treturn in_array($this->protect_identifiers($table_name, TRUE, FALSE, FALSE), $this->list_tables());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @return\tarray\n\t */\n\tpublic function list_fields($table)\n\t{\n\t\tif (FALSE === ($sql = $this->_list_columns($table)))\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_function') : FALSE;\n\t\t}\n\n\t\t$query = $this->query($sql);\n\t\t$fields = array();\n\n\t\tforeach ($query->result_array() as $row)\n\t\t{\n\t\t\t// Do we know from where to get the column's name?\n\t\t\tif ( ! isset($key))\n\t\t\t{\n\t\t\t\tif (isset($row['column_name']))\n\t\t\t\t{\n\t\t\t\t\t$key = 'column_name';\n\t\t\t\t}\n\t\t\t\telseif (isset($row['COLUMN_NAME']))\n\t\t\t\t{\n\t\t\t\t\t$key = 'COLUMN_NAME';\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// We have no other choice but to just get the first element's key.\n\t\t\t\t\t$key = key($row);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t$fields[] = $row[$key];\n\t\t}\n\n\t\treturn $fields;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determine if a particular field exists\n\t *\n\t * @param\tstring\n\t * @param\tstring\n\t * @return\tbool\n\t */\n\tpublic function field_exists($field_name, $table_name)\n\t{\n\t\treturn in_array($field_name, $this->list_fields($table_name));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\tthe table name\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$query = $this->query($this->_field_data($this->protect_identifiers($table, TRUE, NULL, FALSE)));\n\t\treturn ($query) ? $query->field_data() : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Escape the SQL Identifiers\n\t *\n\t * This function escapes column and table names\n\t *\n\t * @param\tmixed\t$item\tIdentifier to escape\n\t * @param\tbool\t$split\tWhether to split identifiers when a dot is encountered\n\t * @return\tmixed\n\t */\n\tpublic function escape_identifiers($item, $split = TRUE)\n\t{\n\t\tif ($this->_escape_char === '' OR empty($item) OR in_array($item, $this->_reserved_identifiers))\n\t\t{\n\t\t\treturn $item;\n\t\t}\n\t\telseif (is_array($item))\n\t\t{\n\t\t\tforeach ($item as $key => $value)\n\t\t\t{\n\t\t\t\t$item[$key] = $this->escape_identifiers($value);\n\t\t\t}\n\n\t\t\treturn $item;\n\t\t}\n\t\t// Avoid breaking functions and literal values inside queries\n\t\telseif (ctype_digit($item) OR $item[0] === \"'\" OR ($this->_escape_char !== '\"' && $item[0] === '\"') OR strpos($item, '(') !== FALSE)\n\t\t{\n\t\t\treturn $item;\n\t\t}\n\n\t\tstatic $preg_ec;\n\n\t\tif (empty($preg_ec))\n\t\t{\n\t\t\tif (is_array($this->_escape_char))\n\t\t\t{\n\t\t\t\t$preg_ec = array(\n\t\t\t\t\tpreg_quote($this->_escape_char[0]),\n\t\t\t\t\tpreg_quote($this->_escape_char[1]),\n\t\t\t\t\t$this->_escape_char[0],\n\t\t\t\t\t$this->_escape_char[1]\n\t\t\t\t);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$preg_ec[0] = $preg_ec[1] = preg_quote($this->_escape_char);\n\t\t\t\t$preg_ec[2] = $preg_ec[3] = $this->_escape_char;\n\t\t\t}\n\t\t}\n\n\t\tforeach ($this->_reserved_identifiers as $id)\n\t\t{\n\t\t\tif (strpos($item, '.'.$id) !== FALSE)\n\t\t\t{\n\t\t\t\treturn preg_replace('#'.$preg_ec[0].'?([^'.$preg_ec[1].'\\.]+)'.$preg_ec[1].'?\\.#i', $preg_ec[2].'$1'.$preg_ec[3].'.', $item);\n\t\t\t}\n\t\t}\n\n\t\t$dot = ($split !== FALSE) ? '\\.' : '';\n\n\t\treturn preg_replace('#'.$preg_ec[0].'?([^'.$preg_ec[1].$dot.']+)'.$preg_ec[1].'?(\\.)?#i', $preg_ec[2].'$1'.$preg_ec[3].'$2', $item);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Generate an insert string\n\t *\n\t * @param\tstring\tthe table upon which the query will be performed\n\t * @param\tarray\tan associative array data of key/values\n\t * @return\tstring\n\t */\n\tpublic function insert_string($table, $data)\n\t{\n\t\t$fields = $values = array();\n\n\t\tforeach ($data as $key => $val)\n\t\t{\n\t\t\t$fields[] = $this->escape_identifiers($key);\n\t\t\t$values[] = $this->escape($val);\n\t\t}\n\n\t\treturn $this->_insert($this->protect_identifiers($table, TRUE, NULL, FALSE), $fields, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data\n\t *\n\t * @param\tstring\tthe table name\n\t * @param\tarray\tthe insert keys\n\t * @param\tarray\tthe insert values\n\t * @return\tstring\n\t */\n\tprotected function _insert($table, $keys, $values)\n\t{\n\t\treturn 'INSERT INTO '.$table.' ('.implode(', ', $keys).') VALUES ('.implode(', ', $values).')';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Generate an update string\n\t *\n\t * @param\tstring\tthe table upon which the query will be performed\n\t * @param\tarray\tan associative array data of key/values\n\t * @param\tmixed\tthe \"where\" statement\n\t * @return\tstring\n\t */\n\tpublic function update_string($table, $data, $where)\n\t{\n\t\tif (empty($where))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$this->where($where);\n\n\t\t$fields = array();\n\t\tforeach ($data as $key => $val)\n\t\t{\n\t\t\t$fields[$this->protect_identifiers($key)] = $this->escape($val);\n\t\t}\n\n\t\t$sql = $this->_update($this->protect_identifiers($table, TRUE, NULL, FALSE), $fields);\n\t\t$this->_reset_write();\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\tthe table name\n\t * @param\tarray\tthe update data\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\tforeach ($values as $key => $val)\n\t\t{\n\t\t\t$valstr[] = $key.' = '.$val;\n\t\t}\n\n\t\treturn 'UPDATE '.$table.' SET '.implode(', ', $valstr)\n\t\t\t.$this->_compile_wh('qb_where')\n\t\t\t.$this->_compile_order_by()\n\t\t\t.($this->qb_limit !== FALSE ? ' LIMIT '.$this->qb_limit : '');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Tests whether the string has an SQL operator\n\t *\n\t * @param\tstring\n\t * @return\tbool\n\t */\n\tprotected function _has_operator($str)\n\t{\n\t\treturn (bool) preg_match('/(<|>|!|=|\\sIS NULL|\\sIS NOT NULL|\\sEXISTS|\\sBETWEEN|\\sLIKE|\\sIN\\s*\\(|\\s)/i', trim($str));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the SQL string operator\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _get_operator($str)\n\t{\n\t\tstatic $_operators;\n\n\t\tif (empty($_operators))\n\t\t{\n\t\t\t$_les = ($this->_like_escape_str !== '')\n\t\t\t\t? '\\s+'.preg_quote(trim(sprintf($this->_like_escape_str, $this->_like_escape_chr)), '/')\n\t\t\t\t: '';\n\t\t\t$_operators = array(\n\t\t\t\t'\\s*(?:<|>|!)?=\\s*', // =, <=, >=, !=\n\t\t\t\t'\\s*<>?\\s*', // <, <>\n\t\t\t\t'\\s*>\\s*', // >\n\t\t\t\t'\\s+IS NULL', // IS NULL\n\t\t\t\t'\\s+IS NOT NULL', // IS NOT NULL\n\t\t\t\t'\\s+EXISTS\\s*\\(.*\\)', // EXISTS(sql)\n\t\t\t\t'\\s+NOT EXISTS\\s*\\(.*\\)', // NOT EXISTS(sql)\n\t\t\t\t'\\s+BETWEEN\\s+', // BETWEEN value AND value\n\t\t\t\t'\\s+NOT BETWEEN\\s+', // NOT BETWEEN value AND value\n\t\t\t\t'\\s+IN\\s*\\(.*\\)', // IN(list)\n\t\t\t\t'\\s+NOT IN\\s*\\(.*\\)', // NOT IN (list)\n\t\t\t\t'\\s+LIKE\\s+\\S.*('.$_les.')?', // LIKE 'expr'[ ESCAPE '%s']\n\t\t\t\t'\\s+NOT LIKE\\s+\\S.*('.$_les.')?' // NOT LIKE 'expr'[ ESCAPE '%s']\n\t\t\t);\n\n\t\t}\n\n\t\treturn preg_match('/'.implode('|', $_operators).'/i', $str, $match)\n\t\t\t? $match[0] : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Enables a native PHP function to be run, using a platform agnostic wrapper.\n\t *\n\t * @param\tstring\t$function\tFunction name\n\t * @return\tmixed\n\t */\n\tpublic function call_function($function)\n\t{\n\t\t$driver = ($this->dbdriver === 'postgre') ? 'pg_' : $this->dbdriver.'_';\n\n\t\tif (FALSE === strpos($driver, $function))\n\t\t{\n\t\t\t$function = $driver.$function;\n\t\t}\n\n\t\tif ( ! function_exists($function))\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_function') : FALSE;\n\t\t}\n\n\t\treturn (func_num_args() > 1)\n\t\t\t? call_user_func_array($function, array_slice(func_get_args(), 1))\n\t\t\t: call_user_func($function);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set Cache Directory Path\n\t *\n\t * @param\tstring\tthe path to the cache directory\n\t * @return\tvoid\n\t */\n\tpublic function cache_set_path($path = '')\n\t{\n\t\t$this->cachedir = $path;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Enable Query Caching\n\t *\n\t * @return\tbool\tcache_on value\n\t */\n\tpublic function cache_on()\n\t{\n\t\treturn $this->cache_on = TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Disable Query Caching\n\t *\n\t * @return\tbool\tcache_on value\n\t */\n\tpublic function cache_off()\n\t{\n\t\treturn $this->cache_on = FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete the cache files associated with a particular URI\n\t *\n\t * @param\tstring\t$segment_one = ''\n\t * @param\tstring\t$segment_two = ''\n\t * @return\tbool\n\t */\n\tpublic function cache_delete($segment_one = '', $segment_two = '')\n\t{\n\t\treturn $this->_cache_init()\n\t\t\t? $this->CACHE->delete($segment_one, $segment_two)\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete All cache files\n\t *\n\t * @return\tbool\n\t */\n\tpublic function cache_delete_all()\n\t{\n\t\treturn $this->_cache_init()\n\t\t\t? $this->CACHE->delete_all()\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Initialize the Cache Class\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _cache_init()\n\t{\n\t\tif ( ! class_exists('CI_DB_Cache', FALSE))\n\t\t{\n\t\t\trequire_once(BASEPATH.'database/DB_cache.php');\n\t\t}\n\t\telseif (is_object($this->CACHE))\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\n\t\t$this->CACHE = new CI_DB_Cache($this); // pass db object to support multiple db connections and returned db objects\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function close()\n\t{\n\t\tif ($this->conn_id)\n\t\t{\n\t\t\t$this->_close();\n\t\t\t$this->conn_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * This method would be overridden by most of the drivers.\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\t$this->conn_id = FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Display an error message\n\t *\n\t * @param\tstring\tthe error message\n\t * @param\tstring\tany \"swap\" values\n\t * @param\tbool\twhether to localize the message\n\t * @return\tstring\tsends the application/views/errors/error_db.php template\n\t */\n\tpublic function display_error($error = '', $swap = '', $native = FALSE)\n\t{\n\t\t$LANG =& load_class('Lang', 'core');\n\t\t$LANG->load('db');\n\n\t\t$heading = $LANG->line('db_error_heading');\n\n\t\tif ($native === TRUE)\n\t\t{\n\t\t\t$message = (array) $error;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$message = is_array($error) ? $error : array(str_replace('%s', $swap, $LANG->line($error)));\n\t\t}\n\n\t\t// Find the most likely culprit of the error by going through\n\t\t// the backtrace until the source file is no longer in the\n\t\t// database folder.\n\t\t$trace = debug_backtrace();\n\t\tforeach ($trace as $call)\n\t\t{\n\t\t\tif (isset($call['file'], $call['class']))\n\t\t\t{\n\t\t\t\t// We'll need this on Windows, as APPPATH and BASEPATH will always use forward slashes\n\t\t\t\tif (DIRECTORY_SEPARATOR !== '/')\n\t\t\t\t{\n\t\t\t\t\t$call['file'] = str_replace('\\\\', '/', $call['file']);\n\t\t\t\t}\n\n\t\t\t\tif (strpos($call['file'], BASEPATH.'database') === FALSE && strpos($call['class'], 'Loader') === FALSE)\n\t\t\t\t{\n\t\t\t\t\t// Found it - use a relative path for safety\n\t\t\t\t\t$message[] = 'Filename: '.str_replace(array(APPPATH, BASEPATH), '', $call['file']);\n\t\t\t\t\t$message[] = 'Line Number: '.$call['line'];\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$error =& load_class('Exceptions', 'core');\n\t\techo $error->show_error($heading, $message, 'error_db');\n\t\texit(8); // EXIT_DATABASE\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Protect Identifiers\n\t *\n\t * This function is used extensively by the Query Builder class, and by\n\t * a couple functions in this class.\n\t * It takes a column or table name (optionally with an alias) and inserts\n\t * the table prefix onto it. Some logic is necessary in order to deal with\n\t * column names that include the path. Consider a query like this:\n\t *\n\t * SELECT hostname.database.table.column AS c FROM hostname.database.table\n\t *\n\t * Or a query with aliasing:\n\t *\n\t * SELECT m.member_id, m.member_name FROM members AS m\n\t *\n\t * Since the column name can include up to four segments (host, DB, table, column)\n\t * or also have an alias prefix, we need to do a bit of work to figure this out and\n\t * insert the table prefix (if it exists) in the proper position, and escape only\n\t * the correct identifiers.\n\t *\n\t * @param\tstring\n\t * @param\tbool\n\t * @param\tmixed\n\t * @param\tbool\n\t * @return\tstring\n\t */\n\tpublic function protect_identifiers($item, $prefix_single = FALSE, $protect_identifiers = NULL, $field_exists = TRUE)\n\t{\n\t\tif ( ! is_bool($protect_identifiers))\n\t\t{\n\t\t\t$protect_identifiers = $this->_protect_identifiers;\n\t\t}\n\n\t\tif (is_array($item))\n\t\t{\n\t\t\t$escaped_array = array();\n\t\t\tforeach ($item as $k => $v)\n\t\t\t{\n\t\t\t\t$escaped_array[$this->protect_identifiers($k)] = $this->protect_identifiers($v, $prefix_single, $protect_identifiers, $field_exists);\n\t\t\t}\n\n\t\t\treturn $escaped_array;\n\t\t}\n\n\t\t// This is basically a bug fix for queries that use MAX, MIN, etc.\n\t\t// If a parenthesis is found we know that we do not need to\n\t\t// escape the data or add a prefix. There's probably a more graceful\n\t\t// way to deal with this, but I'm not thinking of it -- Rick\n\t\t//\n\t\t// Added exception for single quotes as well, we don't want to alter\n\t\t// literal strings. -- Narf\n\t\tif (strcspn($item, \"()'\") !== strlen($item))\n\t\t{\n\t\t\treturn $item;\n\t\t}\n\n\t\t// Convert tabs or multiple spaces into single spaces\n\t\t$item = preg_replace('/\\s+/', ' ', trim($item));\n\n\t\t// If the item has an alias declaration we remove it and set it aside.\n\t\t// Note: strripos() is used in order to support spaces in table names\n\t\tif ($offset = strripos($item, ' AS '))\n\t\t{\n\t\t\t$alias = ($protect_identifiers)\n\t\t\t\t? substr($item, $offset, 4).$this->escape_identifiers(substr($item, $offset + 4), FALSE)\n\t\t\t\t: substr($item, $offset);\n\t\t\t$item = substr($item, 0, $offset);\n\t\t}\n\t\telseif ($offset = strrpos($item, ' '))\n\t\t{\n\t\t\t$alias = ($protect_identifiers)\n\t\t\t\t? ' '.$this->escape_identifiers(substr($item, $offset + 1), FALSE)\n\t\t\t\t: substr($item, $offset);\n\t\t\t$item = substr($item, 0, $offset);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$alias = '';\n\t\t}\n\n\t\t// Break the string apart if it contains periods, then insert the table prefix\n\t\t// in the correct location, assuming the period doesn't indicate that we're dealing\n\t\t// with an alias. While we're at it, we will escape the components\n\t\tif (strpos($item, '.') !== FALSE)\n\t\t{\n\t\t\t$parts = explode('.', $item);\n\n\t\t\t// Does the first segment of the exploded item match\n\t\t\t// one of the aliases previously identified? If so,\n\t\t\t// we have nothing more to do other than escape the item\n\t\t\t//\n\t\t\t// NOTE: The ! empty() condition prevents this method\n\t\t\t// from breaking when QB isn't enabled.\n\t\t\tif ( ! empty($this->qb_aliased_tables) && in_array($parts[0], $this->qb_aliased_tables))\n\t\t\t{\n\t\t\t\tif ($protect_identifiers === TRUE)\n\t\t\t\t{\n\t\t\t\t\tforeach ($parts as $key => $val)\n\t\t\t\t\t{\n\t\t\t\t\t\tif ( ! in_array($val, $this->_reserved_identifiers))\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t$parts[$key] = $this->escape_identifiers($val);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t$item = implode('.', $parts);\n\t\t\t\t}\n\n\t\t\t\treturn $item.$alias;\n\t\t\t}\n\n\t\t\t// Is there a table prefix defined in the config file? If not, no need to do anything\n\t\t\tif ($this->dbprefix !== '')\n\t\t\t{\n\t\t\t\t// We now add the table prefix based on some logic.\n\t\t\t\t// Do we have 4 segments (hostname.database.table.column)?\n\t\t\t\t// If so, we add the table prefix to the column name in the 3rd segment.\n\t\t\t\tif (isset($parts[3]))\n\t\t\t\t{\n\t\t\t\t\t$i = 2;\n\t\t\t\t}\n\t\t\t\t// Do we have 3 segments (database.table.column)?\n\t\t\t\t// If so, we add the table prefix to the column name in 2nd position\n\t\t\t\telseif (isset($parts[2]))\n\t\t\t\t{\n\t\t\t\t\t$i = 1;\n\t\t\t\t}\n\t\t\t\t// Do we have 2 segments (table.column)?\n\t\t\t\t// If so, we add the table prefix to the column name in 1st segment\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$i = 0;\n\t\t\t\t}\n\n\t\t\t\t// This flag is set when the supplied $item does not contain a field name.\n\t\t\t\t// This can happen when this function is being called from a JOIN.\n\t\t\t\tif ($field_exists === FALSE)\n\t\t\t\t{\n\t\t\t\t\t$i++;\n\t\t\t\t}\n\n\t\t\t\t// dbprefix may've already been applied, with or without the identifier escaped\n\t\t\t\t$ec = '(?'.preg_quote(is_array($this->_escape_char) ? $this->_escape_char[0] : $this->_escape_char).')?';\n\t\t\t\tisset($ec[0]) && $ec .= '?'; // Just in case someone has disabled escaping by forcing an empty escape character\n\n\t\t\t\t// Verify table prefix and replace if necessary\n\t\t\t\tif ($this->swap_pre !== '' && preg_match('#^'.$ec.preg_quote($this->swap_pre).'#', $parts[$i]))\n\t\t\t\t{\n\t\t\t\t\t$parts[$i] = preg_replace('#^'.$ec.preg_quote($this->swap_pre).'(\\S+?)#', '\\\\1'.$this->dbprefix.'\\\\2', $parts[$i]);\n\t\t\t\t}\n\t\t\t\t// We only add the table prefix if it does not already exist\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tpreg_match('#^'.$ec.preg_quote($this->dbprefix).'#', $parts[$i]) OR $parts[$i] = $this->dbprefix.$parts[$i];\n\t\t\t\t}\n\n\t\t\t\t// Put the parts back together\n\t\t\t\t$item = implode('.', $parts);\n\t\t\t}\n\n\t\t\tif ($protect_identifiers === TRUE)\n\t\t\t{\n\t\t\t\t$item = $this->escape_identifiers($item);\n\t\t\t}\n\n\t\t\treturn $item.$alias;\n\t\t}\n\n\t\t// Is there a table prefix? If not, no need to insert it\n\t\tif ($this->dbprefix !== '')\n\t\t{\n\t\t\t// Verify table prefix and replace if necessary\n\t\t\tif ($this->swap_pre !== '' && strpos($item, $this->swap_pre) === 0)\n\t\t\t{\n\t\t\t\t$item = preg_replace('/^'.$this->swap_pre.'(\\S+?)/', $this->dbprefix.'\\\\1', $item);\n\t\t\t}\n\t\t\t// Do we prefix an item with no segments?\n\t\t\telseif ($prefix_single === TRUE && strpos($item, $this->dbprefix) !== 0)\n\t\t\t{\n\t\t\t\t$item = $this->dbprefix.$item;\n\t\t\t}\n\t\t}\n\n\t\tif ($protect_identifiers === TRUE && ! in_array($item, $this->_reserved_identifiers))\n\t\t{\n\t\t\t$item = $this->escape_identifiers($item);\n\t\t}\n\n\t\treturn $item.$alias;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Dummy method that allows Query Builder class to be disabled\n\t * and keep count_all() working.\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _reset_select()\n\t{\n\t}\n\n}\n" }, { "path": "system/database/DB_forge.php", "content": "db =& $db;\n\t\tlog_message('info', 'Database Forge Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create database\n\t *\n\t * @param\tstring\t$db_name\n\t * @return\tbool\n\t */\n\tpublic function create_database($db_name)\n\t{\n\t\tif ($this->_create_database === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\t\telseif ( ! $this->db->query(sprintf($this->_create_database, $this->db->escape_identifiers($db_name), $this->db->char_set, $this->db->dbcollat)))\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t\t}\n\n\t\tif ( ! empty($this->db->data_cache['db_names']))\n\t\t{\n\t\t\t$this->db->data_cache['db_names'][] = $db_name;\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop database\n\t *\n\t * @param\tstring\t$db_name\n\t * @return\tbool\n\t */\n\tpublic function drop_database($db_name)\n\t{\n\t\tif ($this->_drop_database === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\t\telseif ( ! $this->db->query(sprintf($this->_drop_database, $this->db->escape_identifiers($db_name))))\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t\t}\n\n\t\tif ( ! empty($this->db->data_cache['db_names']))\n\t\t{\n\t\t\t$key = array_search(strtolower($db_name), array_map('strtolower', $this->db->data_cache['db_names']), TRUE);\n\t\t\tif ($key !== FALSE)\n\t\t\t{\n\t\t\t\tunset($this->db->data_cache['db_names'][$key]);\n\t\t\t}\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Add Key\n\t *\n\t * @param\tstring\t$key\n\t * @param\tbool\t$primary\n\t * @return\tCI_DB_forge\n\t */\n\tpublic function add_key($key, $primary = FALSE)\n\t{\n\t\t// DO NOT change this! This condition is only applicable\n\t\t// for PRIMARY keys because you can only have one such,\n\t\t// and therefore all fields you add to it will be included\n\t\t// in the same, composite PRIMARY KEY.\n\t\t//\n\t\t// It's not the same for regular indexes.\n\t\tif ($primary === TRUE && is_array($key))\n\t\t{\n\t\t\tforeach ($key as $one)\n\t\t\t{\n\t\t\t\t$this->add_key($one, $primary);\n\t\t\t}\n\n\t\t\treturn $this;\n\t\t}\n\n\t\tif ($primary === TRUE)\n\t\t{\n\t\t\t$this->primary_keys[] = $key;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->keys[] = $key;\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Add Field\n\t *\n\t * @param\tarray\t$field\n\t * @return\tCI_DB_forge\n\t */\n\tpublic function add_field($field)\n\t{\n\t\tif (is_string($field))\n\t\t{\n\t\t\tif ($field === 'id')\n\t\t\t{\n\t\t\t\t$this->add_field(array(\n\t\t\t\t\t'id' => array(\n\t\t\t\t\t\t'type' => 'INT',\n\t\t\t\t\t\t'constraint' => 9,\n\t\t\t\t\t\t'auto_increment' => TRUE\n\t\t\t\t\t)\n\t\t\t\t));\n\t\t\t\t$this->add_key('id', TRUE);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tif (strpos($field, ' ') === FALSE)\n\t\t\t\t{\n\t\t\t\t\tshow_error('Field information is required for that operation.');\n\t\t\t\t}\n\n\t\t\t\t$this->fields[] = $field;\n\t\t\t}\n\t\t}\n\n\t\tif (is_array($field))\n\t\t{\n\t\t\t$this->fields = array_merge($this->fields, $field);\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create Table\n\t *\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tbool\t$if_not_exists\tWhether to add IF NOT EXISTS condition\n\t * @param\tarray\t$attributes\tAssociative array of table attributes\n\t * @return\tbool\n\t */\n\tpublic function create_table($table, $if_not_exists = FALSE, array $attributes = array())\n\t{\n\t\tif ($table === '')\n\t\t{\n\t\t\tshow_error('A table name is required for that operation.');\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$table = $this->db->dbprefix.$table;\n\t\t}\n\n\t\tif (count($this->fields) === 0)\n\t\t{\n\t\t\tshow_error('Field information is required.');\n\t\t}\n\n\t\t$sql = $this->_create_table($table, $if_not_exists, $attributes);\n\n\t\tif (is_bool($sql))\n\t\t{\n\t\t\t$this->_reset();\n\t\t\tif ($sql === FALSE)\n\t\t\t{\n\t\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t\t}\n\t\t}\n\n\t\tif (($result = $this->db->query($sql)) !== FALSE)\n\t\t{\n\t\t\tif (isset($this->db->data_cache['table_names']))\n\t\t\t{\n\t\t\t\t$this->db->data_cache['table_names'][] = $table;\n\t\t\t}\n\n\t\t\t// Most databases don't support creating indexes from within the CREATE TABLE statement\n\t\t\tif ( ! empty($this->keys))\n\t\t\t{\n\t\t\t\tfor ($i = 0, $sqls = $this->_process_indexes($table), $c = count($sqls); $i < $c; $i++)\n\t\t\t\t{\n\t\t\t\t\t$this->db->query($sqls[$i]);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$this->_reset();\n\t\treturn $result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create Table\n\t *\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tbool\t$if_not_exists\tWhether to add 'IF NOT EXISTS' condition\n\t * @param\tarray\t$attributes\tAssociative array of table attributes\n\t * @return\tmixed\n\t */\n\tprotected function _create_table($table, $if_not_exists, $attributes)\n\t{\n\t\tif ($if_not_exists === TRUE && $this->_create_table_if === FALSE)\n\t\t{\n\t\t\tif ($this->db->table_exists($table))\n\t\t\t{\n\t\t\t\treturn TRUE;\n\t\t\t}\n\n\t\t\t$if_not_exists = FALSE;\n\t\t}\n\n\t\t$sql = ($if_not_exists)\n\t\t\t? sprintf($this->_create_table_if, $this->db->escape_identifiers($table))\n\t\t\t: 'CREATE TABLE';\n\n\t\t$columns = $this->_process_fields(TRUE);\n\t\tfor ($i = 0, $c = count($columns); $i < $c; $i++)\n\t\t{\n\t\t\t$columns[$i] = ($columns[$i]['_literal'] !== FALSE)\n\t\t\t\t\t? \"\\n\\t\".$columns[$i]['_literal']\n\t\t\t\t\t: \"\\n\\t\".$this->_process_column($columns[$i]);\n\t\t}\n\n\t\t$columns = implode(',', $columns)\n\t\t\t\t.$this->_process_primary_keys($table);\n\n\t\t// Are indexes created from within the CREATE TABLE statement? (e.g. in MySQL)\n\t\tif ($this->_create_table_keys === TRUE)\n\t\t{\n\t\t\t$columns .= $this->_process_indexes($table);\n\t\t}\n\n\t\t// _create_table will usually have the following format: \"%s %s (%s\\n)\"\n\t\t$sql = sprintf($this->_create_table.'%s',\n\t\t\t$sql,\n\t\t\t$this->db->escape_identifiers($table),\n\t\t\t$columns,\n\t\t\t$this->_create_table_attr($attributes)\n\t\t);\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * CREATE TABLE attributes\n\t *\n\t * @param\tarray\t$attributes\tAssociative array of table attributes\n\t * @return\tstring\n\t */\n\tprotected function _create_table_attr($attributes)\n\t{\n\t\t$sql = '';\n\n\t\tforeach (array_keys($attributes) as $key)\n\t\t{\n\t\t\tif (is_string($key))\n\t\t\t{\n\t\t\t\t$sql .= ' '.strtoupper($key).' '.$attributes[$key];\n\t\t\t}\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop Table\n\t *\n\t * @param\tstring\t$table_name\tTable name\n\t * @param\tbool\t$if_exists\tWhether to add an IF EXISTS condition\n\t * @return\tbool\n\t */\n\tpublic function drop_table($table_name, $if_exists = FALSE)\n\t{\n\t\tif ($table_name === '')\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_table_name_required') : FALSE;\n\t\t}\n\n\t\tif (($query = $this->_drop_table($this->db->dbprefix.$table_name, $if_exists)) === TRUE)\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\n\t\t$query = $this->db->query($query);\n\n\t\t// Update table list cache\n\t\tif ($query && ! empty($this->db->data_cache['table_names']))\n\t\t{\n\t\t\t$key = array_search(strtolower($this->db->dbprefix.$table_name), array_map('strtolower', $this->db->data_cache['table_names']), TRUE);\n\t\t\tif ($key !== FALSE)\n\t\t\t{\n\t\t\t\tunset($this->db->data_cache['table_names'][$key]);\n\t\t\t}\n\t\t}\n\n\t\treturn $query;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop Table\n\t *\n\t * Generates a platform-specific DROP TABLE string\n\t *\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tbool\t$if_exists\tWhether to add an IF EXISTS condition\n\t * @return\tmixed\t(Returns a platform-specific DROP table string, or TRUE to indicate there's nothing to do)\n\t */\n\tprotected function _drop_table($table, $if_exists)\n\t{\n\t\t$sql = 'DROP TABLE';\n\n\t\tif ($if_exists)\n\t\t{\n\t\t\tif ($this->_drop_table_if === FALSE)\n\t\t\t{\n\t\t\t\tif ( ! $this->db->table_exists($table))\n\t\t\t\t{\n\t\t\t\t\treturn TRUE;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$sql = sprintf($this->_drop_table_if, $this->db->escape_identifiers($table));\n\t\t\t}\n\t\t}\n\n\t\treturn $sql.' '.$this->db->escape_identifiers($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rename Table\n\t *\n\t * @param\tstring\t$table_name\tOld table name\n\t * @param\tstring\t$new_table_name\tNew table name\n\t * @return\tbool\n\t */\n\tpublic function rename_table($table_name, $new_table_name)\n\t{\n\t\tif ($table_name === '' OR $new_table_name === '')\n\t\t{\n\t\t\tshow_error('A table name is required for that operation.');\n\t\t\treturn FALSE;\n\t\t}\n\t\telseif ($this->_rename_table === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\t$result = $this->db->query(sprintf($this->_rename_table,\n\t\t\t\t\t\t$this->db->escape_identifiers($this->db->dbprefix.$table_name),\n\t\t\t\t\t\t$this->db->escape_identifiers($this->db->dbprefix.$new_table_name))\n\t\t\t\t\t);\n\n\t\tif ($result && ! empty($this->db->data_cache['table_names']))\n\t\t{\n\t\t\t$key = array_search(strtolower($this->db->dbprefix.$table_name), array_map('strtolower', $this->db->data_cache['table_names']), TRUE);\n\t\t\tif ($key !== FALSE)\n\t\t\t{\n\t\t\t\t$this->db->data_cache['table_names'][$key] = $this->db->dbprefix.$new_table_name;\n\t\t\t}\n\t\t}\n\n\t\treturn $result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Column Add\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$field\tColumn definition\n\t * @return\tbool\n\t */\n\tpublic function add_column($table, $field)\n\t{\n\t\t// Work-around for literal column definitions\n\t\tis_array($field) OR $field = array($field);\n\n\t\tforeach (array_keys($field) as $k)\n\t\t{\n\t\t\t$this->add_field(array($k => $field[$k]));\n\t\t}\n\n\t\t$sqls = $this->_alter_table('ADD', $this->db->dbprefix.$table, $this->_process_fields());\n\t\t$this->_reset();\n\t\tif ($sqls === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\tfor ($i = 0, $c = count($sqls); $i < $c; $i++)\n\t\t{\n\t\t\tif ($this->db->query($sqls[$i]) === FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Column Drop\n\t *\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tstring\t$column_name\tColumn name\n\t * @return\tbool\n\t */\n\tpublic function drop_column($table, $column_name)\n\t{\n\t\t$sql = $this->_alter_table('DROP', $this->db->dbprefix.$table, $column_name);\n\t\tif ($sql === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\treturn $this->db->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Column Modify\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tstring\t$field\tColumn definition\n\t * @return\tbool\n\t */\n\tpublic function modify_column($table, $field)\n\t{\n\t\t// Work-around for literal column definitions\n\t\tis_array($field) OR $field = array($field);\n\n\t\tforeach (array_keys($field) as $k)\n\t\t{\n\t\t\t$this->add_field(array($k => $field[$k]));\n\t\t}\n\n\t\tif (count($this->fields) === 0)\n\t\t{\n\t\t\tshow_error('Field information is required.');\n\t\t}\n\n\t\t$sqls = $this->_alter_table('CHANGE', $this->db->dbprefix.$table, $this->_process_fields());\n\t\t$this->_reset();\n\t\tif ($sqls === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\tfor ($i = 0, $c = count($sqls); $i < $c; $i++)\n\t\t{\n\t\t\tif ($this->db->query($sqls[$i]) === FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table).' ';\n\n\t\t// DROP has everything it needs now.\n\t\tif ($alter_type === 'DROP')\n\t\t{\n\t\t\treturn $sql.'DROP COLUMN '.$this->db->escape_identifiers($field);\n\t\t}\n\n\t\t$sql .= ($alter_type === 'ADD')\n\t\t\t? 'ADD '\n\t\t\t: $alter_type.' COLUMN ';\n\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\t$sqls[] = $sql\n\t\t\t\t.($field[$i]['_literal'] !== FALSE ? $field[$i]['_literal'] : $this->_process_column($field[$i]));\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process fields\n\t *\n\t * @param\tbool\t$create_table\n\t * @return\tarray\n\t */\n\tprotected function _process_fields($create_table = FALSE)\n\t{\n\t\t$fields = array();\n\n\t\tforeach ($this->fields as $key => $attributes)\n\t\t{\n\t\t\tif (is_int($key) && ! is_array($attributes))\n\t\t\t{\n\t\t\t\t$fields[] = array('_literal' => $attributes);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t$attributes = array_change_key_case($attributes, CASE_UPPER);\n\n\t\t\tif ($create_table === TRUE && empty($attributes['TYPE']))\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tisset($attributes['TYPE']) && $this->_attr_type($attributes);\n\n\t\t\t$field = array(\n\t\t\t\t'name'\t\t\t=> $key,\n\t\t\t\t'new_name'\t\t=> isset($attributes['NAME']) ? $attributes['NAME'] : NULL,\n\t\t\t\t'type'\t\t\t=> isset($attributes['TYPE']) ? $attributes['TYPE'] : NULL,\n\t\t\t\t'length'\t\t=> '',\n\t\t\t\t'unsigned'\t\t=> '',\n\t\t\t\t'null'\t\t\t=> NULL,\n\t\t\t\t'unique'\t\t=> '',\n\t\t\t\t'default'\t\t=> '',\n\t\t\t\t'auto_increment'\t=> '',\n\t\t\t\t'_literal'\t\t=> FALSE\n\t\t\t);\n\n\t\t\tisset($attributes['TYPE']) && $this->_attr_unsigned($attributes, $field);\n\n\t\t\tif ($create_table === FALSE)\n\t\t\t{\n\t\t\t\tif (isset($attributes['AFTER']))\n\t\t\t\t{\n\t\t\t\t\t$field['after'] = $attributes['AFTER'];\n\t\t\t\t}\n\t\t\t\telseif (isset($attributes['FIRST']))\n\t\t\t\t{\n\t\t\t\t\t$field['first'] = (bool) $attributes['FIRST'];\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t$this->_attr_default($attributes, $field);\n\n\t\t\tif (isset($attributes['NULL']))\n\t\t\t{\n\t\t\t\tif ($attributes['NULL'] === TRUE)\n\t\t\t\t{\n\t\t\t\t\t$field['null'] = empty($this->_null) ? '' : ' '.$this->_null;\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$field['null'] = ' NOT NULL';\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ($create_table === TRUE)\n\t\t\t{\n\t\t\t\t$field['null'] = ' NOT NULL';\n\t\t\t}\n\n\t\t\t$this->_attr_auto_increment($attributes, $field);\n\t\t\t$this->_attr_unique($attributes, $field);\n\n\t\t\tif (isset($attributes['COMMENT']))\n\t\t\t{\n\t\t\t\t$field['comment'] = $this->db->escape($attributes['COMMENT']);\n\t\t\t}\n\n\t\t\tif (isset($attributes['TYPE']) && ! empty($attributes['CONSTRAINT']))\n\t\t\t{\n\t\t\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t\t\t{\n\t\t\t\t\tcase 'ENUM':\n\t\t\t\t\tcase 'SET':\n\t\t\t\t\t\t$attributes['CONSTRAINT'] = $this->db->escape($attributes['CONSTRAINT']);\n\t\t\t\t\tdefault:\n\t\t\t\t\t\t$field['length'] = is_array($attributes['CONSTRAINT'])\n\t\t\t\t\t\t\t? '('.implode(',', $attributes['CONSTRAINT']).')'\n\t\t\t\t\t\t\t: '('.$attributes['CONSTRAINT'].')';\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t$fields[] = $field;\n\t\t}\n\n\t\treturn $fields;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['default']\n\t\t\t.$field['null']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['unique'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\t// Usually overridden by drivers\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute UNSIGNED\n\t *\n\t * Depending on the _unsigned property value:\n\t *\n\t *\t- TRUE will always set $field['unsigned'] to 'UNSIGNED'\n\t *\t- FALSE will always set $field['unsigned'] to ''\n\t *\t- array(TYPE) will set $field['unsigned'] to 'UNSIGNED',\n\t *\t\tif $attributes['TYPE'] is found in the array\n\t *\t- array(TYPE => UTYPE) will change $field['type'],\n\t *\t\tfrom TYPE to UTYPE in case of a match\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_unsigned(&$attributes, &$field)\n\t{\n\t\tif (empty($attributes['UNSIGNED']) OR $attributes['UNSIGNED'] !== TRUE)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Reset the attribute in order to avoid issues if we do type conversion\n\t\t$attributes['UNSIGNED'] = FALSE;\n\n\t\tif (is_array($this->_unsigned))\n\t\t{\n\t\t\tforeach (array_keys($this->_unsigned) as $key)\n\t\t\t{\n\t\t\t\tif (is_int($key) && strcasecmp($attributes['TYPE'], $this->_unsigned[$key]) === 0)\n\t\t\t\t{\n\t\t\t\t\t$field['unsigned'] = ' UNSIGNED';\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\telseif (is_string($key) && strcasecmp($attributes['TYPE'], $key) === 0)\n\t\t\t\t{\n\t\t\t\t\t$field['type'] = $key;\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn;\n\t\t}\n\n\t\t$field['unsigned'] = ($this->_unsigned === TRUE) ? ' UNSIGNED' : '';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute DEFAULT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_default(&$attributes, &$field)\n\t{\n\t\tif ($this->_default === FALSE)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\tif ( ! array_key_exists('DEFAULT', $attributes))\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\tif ($attributes['DEFAULT'] === NULL)\n\t\t{\n\t\t\t$field['default'] = empty($this->_null) ? '' : $this->_default.$this->_null;\n\n\t\t\t// Override the NULL attribute if that's our default\n\t\t\t$attributes['NULL'] = TRUE;\n\t\t\t$field['null'] = empty($this->_null) ? '' : ' '.$this->_null;\n\t\t\treturn;\n\t\t}\n\n\t\t// White-list CURRENT_TIMESTAMP & similar (e.g. Oracle has stuff like SYSTIMESTAMP) defaults for date/time fields\n\t\tif (\n\t\t\tisset($attributes['TYPE'])\n\t\t\t&& (stripos($attributes['TYPE'], 'time') !== FALSE OR stripos($attributes['TYPE'], 'date') !== FALSE)\n\t\t\t&& (stripos($attributes['DEFAULT'], 'time') !== FALSE OR stripos($attributes['DEFAULT'], 'date') !== FALSE)\n\t\t)\n\t\t{\n\t\t\t$field['default'] = $this->_default.$attributes['DEFAULT'];\n\t\t\treturn;\n\t\t}\n\n\t\t$field['default'] = $this->_default.$this->db->escape($attributes['DEFAULT']);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute UNIQUE\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_unique(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['UNIQUE']) && $attributes['UNIQUE'] === TRUE)\n\t\t{\n\t\t\t$field['unique'] = ' UNIQUE';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['auto_increment'] = ' AUTO_INCREMENT';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process primary keys\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @return\tstring\n\t */\n\tprotected function _process_primary_keys($table)\n\t{\n\t\t$sql = '';\n\n\t\tfor ($i = 0, $c = count($this->primary_keys); $i < $c; $i++)\n\t\t{\n\t\t\tif ( ! isset($this->fields[$this->primary_keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->primary_keys[$i]);\n\t\t\t}\n\t\t}\n\n\t\tif (count($this->primary_keys) > 0)\n\t\t{\n\t\t\t$sql .= \",\\n\\tCONSTRAINT \".$this->db->escape_identifiers('pk_'.$table)\n\t\t\t\t.' PRIMARY KEY('.implode(', ', $this->db->escape_identifiers($this->primary_keys)).')';\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process indexes\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @return\tstring[] list of SQL statements\n\t */\n\tprotected function _process_indexes($table)\n\t{\n\t\t$sqls = array();\n\n\t\tfor ($i = 0, $c = count($this->keys); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_array($this->keys[$i]))\n\t\t\t{\n\t\t\t\tfor ($i2 = 0, $c2 = count($this->keys[$i]); $i2 < $c2; $i2++)\n\t\t\t\t{\n\t\t\t\t\tif ( ! isset($this->fields[$this->keys[$i][$i2]]))\n\t\t\t\t\t{\n\t\t\t\t\t\tunset($this->keys[$i][$i2]);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! isset($this->fields[$this->keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->keys[$i]);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tis_array($this->keys[$i]) OR $this->keys[$i] = array($this->keys[$i]);\n\n\t\t\t$sqls[] = 'CREATE INDEX '.$this->db->escape_identifiers($table.'_'.implode('_', $this->keys[$i]))\n\t\t\t\t.' ON '.$this->db->escape_identifiers($table)\n\t\t\t\t.' ('.implode(', ', $this->db->escape_identifiers($this->keys[$i])).');';\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reset\n\t *\n\t * Resets table creation vars\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _reset()\n\t{\n\t\t$this->fields = $this->keys = $this->primary_keys = array();\n\t}\n\n}\n" }, { "path": "system/database/DB_query_builder.php", "content": "_protect_identifiers;\n\n\t\tforeach ($select as $val)\n\t\t{\n\t\t\t$val = trim($val);\n\n\t\t\tif ($val !== '')\n\t\t\t{\n\t\t\t\t$this->qb_select[] = $val;\n\t\t\t\t$this->qb_no_escape[] = $escape;\n\n\t\t\t\tif ($this->qb_caching === TRUE)\n\t\t\t\t{\n\t\t\t\t\t$this->qb_cache_select[] = $val;\n\t\t\t\t\t$this->qb_cache_exists[] = 'select';\n\t\t\t\t\t$this->qb_cache_no_escape[] = $escape;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select Max\n\t *\n\t * Generates a SELECT MAX(field) portion of a query\n\t *\n\t * @param\tstring\tthe field\n\t * @param\tstring\tan alias\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function select_max($select = '', $alias = '')\n\t{\n\t\treturn $this->_max_min_avg_sum($select, $alias, 'MAX');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select Min\n\t *\n\t * Generates a SELECT MIN(field) portion of a query\n\t *\n\t * @param\tstring\tthe field\n\t * @param\tstring\tan alias\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function select_min($select = '', $alias = '')\n\t{\n\t\treturn $this->_max_min_avg_sum($select, $alias, 'MIN');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select Average\n\t *\n\t * Generates a SELECT AVG(field) portion of a query\n\t *\n\t * @param\tstring\tthe field\n\t * @param\tstring\tan alias\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function select_avg($select = '', $alias = '')\n\t{\n\t\treturn $this->_max_min_avg_sum($select, $alias, 'AVG');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select Sum\n\t *\n\t * Generates a SELECT SUM(field) portion of a query\n\t *\n\t * @param\tstring\tthe field\n\t * @param\tstring\tan alias\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function select_sum($select = '', $alias = '')\n\t{\n\t\treturn $this->_max_min_avg_sum($select, $alias, 'SUM');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * SELECT [MAX|MIN|AVG|SUM]()\n\t *\n\t * @used-by\tselect_max()\n\t * @used-by\tselect_min()\n\t * @used-by\tselect_avg()\n\t * @used-by\tselect_sum()\n\t *\n\t * @param\tstring\t$select\tField name\n\t * @param\tstring\t$alias\n\t * @param\tstring\t$type\n\t * @return\tCI_DB_query_builder\n\t */\n\tprotected function _max_min_avg_sum($select = '', $alias = '', $type = 'MAX')\n\t{\n\t\tif ( ! is_string($select) OR $select === '')\n\t\t{\n\t\t\t$this->display_error('db_invalid_query');\n\t\t}\n\n\t\t$type = strtoupper($type);\n\n\t\tif ( ! in_array($type, array('MAX', 'MIN', 'AVG', 'SUM')))\n\t\t{\n\t\t\tshow_error('Invalid function type: '.$type);\n\t\t}\n\n\t\tif ($alias === '')\n\t\t{\n\t\t\t$alias = $this->_create_alias_from_table(trim($select));\n\t\t}\n\n\t\t$sql = $type.'('.$this->protect_identifiers(trim($select)).') AS '.$this->escape_identifiers(trim($alias));\n\n\t\t$this->qb_select[] = $sql;\n\t\t$this->qb_no_escape[] = NULL;\n\n\t\tif ($this->qb_caching === TRUE)\n\t\t{\n\t\t\t$this->qb_cache_select[] = $sql;\n\t\t\t$this->qb_cache_exists[] = 'select';\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determines the alias name based on the table\n\t *\n\t * @param\tstring\t$item\n\t * @return\tstring\n\t */\n\tprotected function _create_alias_from_table($item)\n\t{\n\t\tif (strpos($item, '.') !== FALSE)\n\t\t{\n\t\t\t$item = explode('.', $item);\n\t\t\treturn end($item);\n\t\t}\n\n\t\treturn $item;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * DISTINCT\n\t *\n\t * Sets a flag which tells the query string compiler to add DISTINCT\n\t *\n\t * @param\tbool\t$val\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function distinct($val = TRUE)\n\t{\n\t\t$this->qb_distinct = is_bool($val) ? $val : TRUE;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * From\n\t *\n\t * Generates the FROM portion of the query\n\t *\n\t * @param\tmixed\t$from\tcan be a string or array\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function from($from)\n\t{\n\t\tforeach ((array) $from as $val)\n\t\t{\n\t\t\tif (strpos($val, ',') !== FALSE)\n\t\t\t{\n\t\t\t\tforeach (explode(',', $val) as $v)\n\t\t\t\t{\n\t\t\t\t\t$v = trim($v);\n\t\t\t\t\t$this->_track_aliases($v);\n\n\t\t\t\t\t$this->qb_from[] = $v = $this->protect_identifiers($v, TRUE, NULL, FALSE);\n\n\t\t\t\t\tif ($this->qb_caching === TRUE)\n\t\t\t\t\t{\n\t\t\t\t\t\t$this->qb_cache_from[] = $v;\n\t\t\t\t\t\t$this->qb_cache_exists[] = 'from';\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$val = trim($val);\n\n\t\t\t\t// Extract any aliases that might exist. We use this information\n\t\t\t\t// in the protect_identifiers to know whether to add a table prefix\n\t\t\t\t$this->_track_aliases($val);\n\n\t\t\t\t$this->qb_from[] = $val = $this->protect_identifiers($val, TRUE, NULL, FALSE);\n\n\t\t\t\tif ($this->qb_caching === TRUE)\n\t\t\t\t{\n\t\t\t\t\t$this->qb_cache_from[] = $val;\n\t\t\t\t\t$this->qb_cache_exists[] = 'from';\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * JOIN\n\t *\n\t * Generates the JOIN portion of the query\n\t *\n\t * @param\tstring\n\t * @param\tstring\tthe join condition\n\t * @param\tstring\tthe type of join\n\t * @param\tstring\twhether not to try to escape identifiers\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function join($table, $cond, $type = '', $escape = NULL)\n\t{\n\t\t$type = trim(strtoupper($type).' JOIN');\n\t\tpreg_match('#^(NATURAL\\s+)?((LEFT|RIGHT|FULL)\\s+)?((INNER|OUTER)\\s+)?JOIN$#', $type) OR $type = 'JOIN';\n\n\t\t// Extract any aliases that might exist. We use this information\n\t\t// in the protect_identifiers to know whether to add a table prefix\n\t\t$this->_track_aliases($table);\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\tif (strpos($type, 'NATURAL') === 0)\n\t\t{\n\t\t\t$cond = '';\n\t\t}\n\t\telseif ( ! $this->_has_operator($cond))\n\t\t{\n\t\t\t$cond = ' USING ('.($escape ? $this->escape_identifiers($cond) : $cond).')';\n\t\t}\n\t\telseif ($escape === FALSE)\n\t\t{\n\t\t\t$cond = ' ON '.$cond;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Split multiple conditions\n\t\t\tif (preg_match_all('/\\sAND\\s|\\sOR\\s/i', $cond, $joints, PREG_OFFSET_CAPTURE))\n\t\t\t{\n\t\t\t\t$conditions = array();\n\t\t\t\t$joints = $joints[0];\n\t\t\t\tarray_unshift($joints, array('', 0));\n\n\t\t\t\tfor ($i = count($joints) - 1, $pos = strlen($cond); $i >= 0; $i--)\n\t\t\t\t{\n\t\t\t\t\t$joints[$i][1] += strlen($joints[$i][0]); // offset\n\t\t\t\t\t$conditions[$i] = substr($cond, $joints[$i][1], $pos - $joints[$i][1]);\n\t\t\t\t\t$pos = $joints[$i][1] - strlen($joints[$i][0]);\n\t\t\t\t\t$joints[$i] = $joints[$i][0];\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$conditions = array($cond);\n\t\t\t\t$joints = array('');\n\t\t\t}\n\n\t\t\t$cond = ' ON ';\n\t\t\tfor ($i = 0, $c = count($conditions); $i < $c; $i++)\n\t\t\t{\n\t\t\t\t$operator = $this->_get_operator($conditions[$i]);\n\t\t\t\t$cond .= $joints[$i];\n\t\t\t\t$cond .= preg_match(\"/(\\(*)?([\\[\\]\\w\\.'-]+)\".preg_quote($operator).\"(.*)/i\", $conditions[$i], $match)\n\t\t\t\t\t? $match[1].$this->protect_identifiers($match[2]).$operator.$this->protect_identifiers($match[3])\n\t\t\t\t\t: $conditions[$i];\n\t\t\t}\n\t\t}\n\n\t\t// Do we want to escape the table name?\n\t\tif ($escape === TRUE)\n\t\t{\n\t\t\t$table = $this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t\t}\n\n\t\t// Assemble the JOIN statement\n\t\t$this->qb_join[] = $join = $type.' '.$table.$cond;\n\n\t\tif ($this->qb_caching === TRUE)\n\t\t{\n\t\t\t$this->qb_cache_join[] = $join;\n\t\t\t$this->qb_cache_exists[] = 'join';\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * WHERE\n\t *\n\t * Generates the WHERE portion of the query.\n\t * Separates multiple calls with 'AND'.\n\t *\n\t * @param\tmixed\n\t * @param\tmixed\n\t * @param\tbool\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function where($key, $value = NULL, $escape = NULL)\n\t{\n\t\treturn $this->_wh('qb_where', $key, $value, 'AND ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR WHERE\n\t *\n\t * Generates the WHERE portion of the query.\n\t * Separates multiple calls with 'OR'.\n\t *\n\t * @param\tmixed\n\t * @param\tmixed\n\t * @param\tbool\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_where($key, $value = NULL, $escape = NULL)\n\t{\n\t\treturn $this->_wh('qb_where', $key, $value, 'OR ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * WHERE, HAVING\n\t *\n\t * @used-by\twhere()\n\t * @used-by\tor_where()\n\t * @used-by\thaving()\n\t * @used-by\tor_having()\n\t *\n\t * @param\tstring\t$qb_key\t'qb_where' or 'qb_having'\n\t * @param\tmixed\t$key\n\t * @param\tmixed\t$value\n\t * @param\tstring\t$type\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tprotected function _wh($qb_key, $key, $value = NULL, $type = 'AND ', $escape = NULL)\n\t{\n\t\t$qb_cache_key = ($qb_key === 'qb_having') ? 'qb_cache_having' : 'qb_cache_where';\n\n\t\tif ( ! is_array($key))\n\t\t{\n\t\t\t$key = array($key => $value);\n\t\t}\n\n\t\t// If the escape value was not set will base it on the global setting\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\tforeach ($key as $k => $v)\n\t\t{\n\t\t\t$prefix = (count($this->$qb_key) === 0 && count($this->$qb_cache_key) === 0)\n\t\t\t\t? $this->_group_get_type('')\n\t\t\t\t: $this->_group_get_type($type);\n\n\t\t\tif ($v !== NULL)\n\t\t\t{\n\t\t\t\tif ($escape === TRUE)\n\t\t\t\t{\n\t\t\t\t\t$v = $this->escape($v);\n\t\t\t\t}\n\n\t\t\t\tif ( ! $this->_has_operator($k))\n\t\t\t\t{\n\t\t\t\t\t$k .= ' = ';\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! $this->_has_operator($k))\n\t\t\t{\n\t\t\t\t// value appears not to have been set, assign the test to IS NULL\n\t\t\t\t$k .= ' IS NULL';\n\t\t\t}\n\t\t\telseif (preg_match('/\\s*(!?=|<>|\\sIS(?:\\s+NOT)?\\s)\\s*$/i', $k, $match, PREG_OFFSET_CAPTURE))\n\t\t\t{\n\t\t\t\t$k = substr($k, 0, $match[0][1]).($match[1][0] === '=' ? ' IS NULL' : ' IS NOT NULL');\n\t\t\t}\n\n\t\t\t$$qb_key = array('condition' => $prefix.$k, 'value' => $v, 'escape' => $escape);\n\t\t\t$this->{$qb_key}[] = $$qb_key;\n\t\t\tif ($this->qb_caching === TRUE)\n\t\t\t{\n\t\t\t\t$this->{$qb_cache_key}[] = $$qb_key;\n\t\t\t\t$this->qb_cache_exists[] = substr($qb_key, 3);\n\t\t\t}\n\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * WHERE IN\n\t *\n\t * Generates a WHERE field IN('item', 'item') SQL query,\n\t * joined with 'AND' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function where_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_where', $key, $values, FALSE, 'AND ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR WHERE IN\n\t *\n\t * Generates a WHERE field IN('item', 'item') SQL query,\n\t * joined with 'OR' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_where_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_where', $key, $values, FALSE, 'OR ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * WHERE NOT IN\n\t *\n\t * Generates a WHERE field NOT IN('item', 'item') SQL query,\n\t * joined with 'AND' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function where_not_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_where', $key, $values, TRUE, 'AND ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR WHERE NOT IN\n\t *\n\t * Generates a WHERE field NOT IN('item', 'item') SQL query,\n\t * joined with 'OR' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_where_not_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_where', $key, $values, TRUE, 'OR ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * HAVING IN\n\t *\n\t * Generates a HAVING field IN('item', 'item') SQL query,\n\t * joined with 'AND' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function having_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_having', $key, $values, FALSE, 'AND ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR HAVING IN\n\t *\n\t * Generates a HAVING field IN('item', 'item') SQL query,\n\t * joined with 'OR' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_having_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_having', $key, $values, FALSE, 'OR ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * HAVING NOT IN\n\t *\n\t * Generates a HAVING field NOT IN('item', 'item') SQL query,\n\t * joined with 'AND' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function having_not_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_having', $key, $values, TRUE, 'AND ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR HAVING NOT IN\n\t *\n\t * Generates a HAVING field NOT IN('item', 'item') SQL query,\n\t * joined with 'OR' if appropriate.\n\t *\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_having_not_in($key, array $values, $escape = NULL)\n\t{\n\t\treturn $this->_wh_in('qb_having', $key, $values, TRUE, 'OR ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal WHERE/HAVING IN\n\t *\n\t * @used-by\twhere_in()\n\t * @used-by\tor_where_in()\n\t * @used-by\twhere_not_in()\n\t * @used-by\tor_where_not_in()\n\t * @used-by\thaving_in()\n\t * @used-by\tor_having_in()\n\t * @used-by\thaving_not_in()\n\t * @used-by\tor_having_not_in()\n\t *\n\t * @param\tstring\t$qb_key\t'qb_where' or 'qb_having'\n\t * @param\tstring\t$key\tThe field to search\n\t * @param\tarray\t$values\tThe values searched on\n\t * @param\tbool\t$not\tIf the statement would be IN or NOT IN\n\t * @param\tstring\t$type\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tprotected function _wh_in($qb_key, $key, array $values, $not = FALSE, $type = 'AND ', $escape = NULL)\n\t{\n\t\t$qb_cache_key = ($qb_key === 'qb_having') ? 'qb_cache_having' : 'qb_cache_where';\n\n\t\tif (empty($key) OR ! is_string($key))\n\t\t{\n\t\t\tthrow new InvalidArgumentException(sprintf('%s() expects $key to be a non-empty string', debug_backtrace(0, 2)[1]['function']));\n\t\t}\n\n\t\tif (empty($values))\n\t\t{\n\t\t\tthrow new InvalidArgumentException(sprintf('%s() expects $values to be a non-empty array', debug_backtrace(0, 2)[1]['function']));\n\t\t}\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\t$not = ($not) ? ' NOT' : '';\n\n\t\tif ($escape === TRUE)\n\t\t{\n\t\t\t$wh_in = array();\n\t\t\tforeach ($values as $value)\n\t\t\t{\n\t\t\t\t$wh_in[] = $this->escape($value);\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$wh_in = array_values($values);\n\t\t}\n\n\t\t$prefix = (count($this->$qb_key) === 0 && count($this->$qb_cache_key) === 0)\n\t\t\t? $this->_group_get_type('')\n\t\t\t: $this->_group_get_type($type);\n\n\t\t$wh_in = array(\n\t\t\t'condition' => $prefix.$key.$not.' IN('.implode(', ', $wh_in).')',\n\t\t\t'value' => NULL,\n\t\t\t'escape' => $escape\n\t\t);\n\n\t\t$this->{$qb_key}[] = $wh_in;\n\t\tif ($this->qb_caching === TRUE)\n\t\t{\n\t\t\t$this->{$qb_cache_key}[] = $wh_in;\n\t\t\t$this->qb_cache_exists[] = substr($qb_key, 3);\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIKE\n\t *\n\t * Generates a %LIKE% portion of the query.\n\t * Separates multiple calls with 'AND'.\n\t *\n\t * @param\tmixed\t$field\n\t * @param\tstring\t$match\n\t * @param\tstring\t$side\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function like($field, $match = '', $side = 'both', $escape = NULL)\n\t{\n\t\treturn $this->_like($field, $match, 'AND ', $side, '', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * NOT LIKE\n\t *\n\t * Generates a NOT LIKE portion of the query.\n\t * Separates multiple calls with 'AND'.\n\t *\n\t * @param\tmixed\t$field\n\t * @param\tstring\t$match\n\t * @param\tstring\t$side\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function not_like($field, $match = '', $side = 'both', $escape = NULL)\n\t{\n\t\treturn $this->_like($field, $match, 'AND ', $side, 'NOT', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR LIKE\n\t *\n\t * Generates a %LIKE% portion of the query.\n\t * Separates multiple calls with 'OR'.\n\t *\n\t * @param\tmixed\t$field\n\t * @param\tstring\t$match\n\t * @param\tstring\t$side\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_like($field, $match = '', $side = 'both', $escape = NULL)\n\t{\n\t\treturn $this->_like($field, $match, 'OR ', $side, '', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR NOT LIKE\n\t *\n\t * Generates a NOT LIKE portion of the query.\n\t * Separates multiple calls with 'OR'.\n\t *\n\t * @param\tmixed\t$field\n\t * @param\tstring\t$match\n\t * @param\tstring\t$side\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_not_like($field, $match = '', $side = 'both', $escape = NULL)\n\t{\n\t\treturn $this->_like($field, $match, 'OR ', $side, 'NOT', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Internal LIKE\n\t *\n\t * @used-by\tlike()\n\t * @used-by\tor_like()\n\t * @used-by\tnot_like()\n\t * @used-by\tor_not_like()\n\t *\n\t * @param\tmixed\t$field\n\t * @param\tstring\t$match\n\t * @param\tstring\t$type\n\t * @param\tstring\t$side\n\t * @param\tstring\t$not\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tprotected function _like($field, $match = '', $type = 'AND ', $side = 'both', $not = '', $escape = NULL)\n\t{\n\t\tif ( ! is_array($field))\n\t\t{\n\t\t\t$field = array($field => $match);\n\t\t}\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\t\t// lowercase $side in case somebody writes e.g. 'BEFORE' instead of 'before' (doh)\n\t\t$side = strtolower($side);\n\n\t\tforeach ($field as $k => $v)\n\t\t{\n\t\t\t$prefix = (count($this->qb_where) === 0 && count($this->qb_cache_where) === 0)\n\t\t\t\t? $this->_group_get_type('') : $this->_group_get_type($type);\n\n\t\t\tif ($escape === TRUE)\n\t\t\t{\n\t\t\t\t$v = $this->escape_like_str($v);\n\t\t\t}\n\n\t\t\tswitch ($side)\n\t\t\t{\n\t\t\t\tcase 'none':\n\t\t\t\t\t$v = \"'{$v}'\";\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'before':\n\t\t\t\t\t$v = \"'%{$v}'\";\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'after':\n\t\t\t\t\t$v = \"'{$v}%'\";\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'both':\n\t\t\t\tdefault:\n\t\t\t\t\t$v = \"'%{$v}%'\";\n\t\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\t// some platforms require an escape sequence definition for LIKE wildcards\n\t\t\tif ($escape === TRUE && $this->_like_escape_str !== '')\n\t\t\t{\n\t\t\t\t$v .= sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t\t}\n\n\t\t\t$qb_where = array('condition' => \"{$prefix} {$k} {$not} LIKE {$v}\", 'value' => NULL, 'escape' => $escape);\n\t\t\t$this->qb_where[] = $qb_where;\n\t\t\tif ($this->qb_caching === TRUE)\n\t\t\t{\n\t\t\t\t$this->qb_cache_where[] = $qb_where;\n\t\t\t\t$this->qb_cache_exists[] = 'where';\n\t\t\t}\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Starts a query group.\n\t *\n\t * @param\tstring\t$not\t(Internal use only)\n\t * @param\tstring\t$type\t(Internal use only)\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function group_start($not = '', $type = 'AND ')\n\t{\n\t\t$type = $this->_group_get_type($type);\n\n\t\t$this->qb_where_group_started = TRUE;\n\t\t$prefix = (count($this->qb_where) === 0 && count($this->qb_cache_where) === 0) ? '' : $type;\n\t\t$where = array(\n\t\t\t'condition' => $prefix.$not.str_repeat(' ', ++$this->qb_where_group_count).' (',\n\t\t\t'value' => NULL,\n\t\t\t'escape' => FALSE\n\t\t);\n\n\t\t$this->qb_where[] = $where;\n\t\tif ($this->qb_caching)\n\t\t{\n\t\t\t$this->qb_cache_where[] = $where;\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Starts a query group, but ORs the group\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_group_start()\n\t{\n\t\treturn $this->group_start('', 'OR ');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Starts a query group, but NOTs the group\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function not_group_start()\n\t{\n\t\treturn $this->group_start('NOT ', 'AND ');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Starts a query group, but OR NOTs the group\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_not_group_start()\n\t{\n\t\treturn $this->group_start('NOT ', 'OR ');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Ends a query group\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function group_end()\n\t{\n\t\t$this->qb_where_group_started = FALSE;\n\t\t$where = array(\n\t\t\t'condition' => str_repeat(' ', $this->qb_where_group_count--).')',\n\t\t\t'value' => NULL,\n\t\t\t'escape' => FALSE\n\t\t);\n\n\t\t$this->qb_where[] = $where;\n\t\tif ($this->qb_caching)\n\t\t{\n\t\t\t$this->qb_cache_where[] = $where;\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Group_get_type\n\t *\n\t * @used-by\tgroup_start()\n\t * @used-by\t_like()\n\t * @used-by\t_wh()\n\t * @used-by\t_where_in()\n\t *\n\t * @param\tstring\t$type\n\t * @return\tstring\n\t */\n\tprotected function _group_get_type($type)\n\t{\n\t\tif ($this->qb_where_group_started)\n\t\t{\n\t\t\t$type = '';\n\t\t\t$this->qb_where_group_started = FALSE;\n\t\t}\n\n\t\treturn $type;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * GROUP BY\n\t *\n\t * @param\tmixed\t$by\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function group_by($by, $escape = NULL)\n\t{\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\tif (is_string($by))\n\t\t{\n\t\t\t$by = ($escape === TRUE)\n\t\t\t\t? explode(',', $by)\n\t\t\t\t: array($by);\n\t\t}\n\n\t\tforeach ($by as $val)\n\t\t{\n\t\t\t$val = trim($val);\n\n\t\t\tif ($val !== '')\n\t\t\t{\n\t\t\t\t$val = array('field' => $val, 'escape' => $escape);\n\n\t\t\t\t$this->qb_groupby[] = $val;\n\t\t\t\tif ($this->qb_caching === TRUE)\n\t\t\t\t{\n\t\t\t\t\t$this->qb_cache_groupby[] = $val;\n\t\t\t\t\t$this->qb_cache_exists[] = 'groupby';\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * HAVING\n\t *\n\t * Separates multiple calls with 'AND'.\n\t *\n\t * @param\tstring\t$key\n\t * @param\tstring\t$value\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function having($key, $value = NULL, $escape = NULL)\n\t{\n\t\treturn $this->_wh('qb_having', $key, $value, 'AND ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OR HAVING\n\t *\n\t * Separates multiple calls with 'OR'.\n\t *\n\t * @param\tstring\t$key\n\t * @param\tstring\t$value\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function or_having($key, $value = NULL, $escape = NULL)\n\t{\n\t\treturn $this->_wh('qb_having', $key, $value, 'OR ', $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ORDER BY\n\t *\n\t * @param\tstring\t$orderby\n\t * @param\tstring\t$direction\tASC, DESC or RANDOM\n\t * @param\tbool\t$escape\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function order_by($orderby, $direction = '', $escape = NULL)\n\t{\n\t\t$direction = strtoupper(trim($direction));\n\n\t\tif ($direction === 'RANDOM')\n\t\t{\n\t\t\t$direction = '';\n\n\t\t\t// Do we have a seed value?\n\t\t\t$orderby = ctype_digit((string) $orderby)\n\t\t\t\t? sprintf($this->_random_keyword[1], $orderby)\n\t\t\t\t: $this->_random_keyword[0];\n\t\t}\n\t\telseif (empty($orderby))\n\t\t{\n\t\t\treturn $this;\n\t\t}\n\t\telseif ($direction !== '')\n\t\t{\n\t\t\t$direction = in_array($direction, array('ASC', 'DESC'), TRUE) ? ' '.$direction : '';\n\t\t}\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\tif ($escape === FALSE)\n\t\t{\n\t\t\t$qb_orderby[] = array('field' => $orderby, 'direction' => $direction, 'escape' => FALSE);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$qb_orderby = array();\n\t\t\tforeach (explode(',', $orderby) as $field)\n\t\t\t{\n\t\t\t\t$qb_orderby[] = ($direction === '' && preg_match('/\\s+(ASC|DESC)$/i', rtrim($field), $match, PREG_OFFSET_CAPTURE))\n\t\t\t\t\t? array('field' => ltrim(substr($field, 0, $match[0][1])), 'direction' => ' '.$match[1][0], 'escape' => TRUE)\n\t\t\t\t\t: array('field' => trim($field), 'direction' => $direction, 'escape' => TRUE);\n\t\t\t}\n\t\t}\n\n\t\t$this->qb_orderby = array_merge($this->qb_orderby, $qb_orderby);\n\t\tif ($this->qb_caching === TRUE)\n\t\t{\n\t\t\t$this->qb_cache_orderby = array_merge($this->qb_cache_orderby, $qb_orderby);\n\t\t\t$this->qb_cache_exists[] = 'orderby';\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * @param\tint\t$value\tLIMIT value\n\t * @param\tint\t$offset\tOFFSET value\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function limit($value, $offset = 0)\n\t{\n\t\tis_null($value) OR $this->qb_limit = (int) $value;\n\t\tempty($offset) OR $this->qb_offset = (int) $offset;\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Sets the OFFSET value\n\t *\n\t * @param\tint\t$offset\tOFFSET value\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function offset($offset)\n\t{\n\t\tempty($offset) OR $this->qb_offset = (int) $offset;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT string\n\t *\n\t * Generates a platform-specific LIMIT clause.\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\treturn $sql.' LIMIT '.($this->qb_offset ? $this->qb_offset.', ' : '').(int) $this->qb_limit;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * The \"set\" function.\n\t *\n\t * Allows key/value pairs to be set for inserting or updating\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tbool\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function set($key, $value = '', $escape = NULL)\n\t{\n\t\t$key = $this->_object_to_array($key);\n\n\t\tif ( ! is_array($key))\n\t\t{\n\t\t\t$key = array($key => $value);\n\t\t}\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\tforeach ($key as $k => $v)\n\t\t{\n\t\t\t$this->qb_set[$this->protect_identifiers($k, FALSE, $escape)] = ($escape)\n\t\t\t\t? $this->escape($v) : $v;\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get SELECT query string\n\t *\n\t * Compiles a SELECT query string and returns the sql.\n\t *\n\t * @param\tstring\tthe table name to select from (optional)\n\t * @param\tbool\tTRUE: resets QB values; FALSE: leave QB values alone\n\t * @return\tstring\n\t */\n\tpublic function get_compiled_select($table = '', $reset = TRUE)\n\t{\n\t\tif ($table !== '')\n\t\t{\n\t\t\t$this->_track_aliases($table);\n\t\t\t$this->from($table);\n\t\t}\n\n\t\t$select = $this->_compile_select();\n\n\t\tif ($reset === TRUE)\n\t\t{\n\t\t\t$this->_reset_select();\n\t\t}\n\n\t\treturn $select;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get\n\t *\n\t * Compiles the select statement based on the other functions called\n\t * and runs the query\n\t *\n\t * @param\tstring\tthe table\n\t * @param\tstring\tthe limit clause\n\t * @param\tstring\tthe offset clause\n\t * @return\tCI_DB_result\n\t */\n\tpublic function get($table = '', $limit = NULL, $offset = NULL)\n\t{\n\t\tif ($table !== '')\n\t\t{\n\t\t\t$this->_track_aliases($table);\n\t\t\t$this->from($table);\n\t\t}\n\n\t\tif ( ! empty($limit))\n\t\t{\n\t\t\t$this->limit($limit, $offset);\n\t\t}\n\n\t\t$result = $this->query($this->_compile_select());\n\t\t$this->_reset_select();\n\t\treturn $result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * \"Count All Results\" query\n\t *\n\t * Generates a platform-specific query string that counts all records\n\t * returned by an Query Builder query.\n\t *\n\t * @param\tstring\n\t * @param\tbool\tthe reset clause\n\t * @return\tint\n\t */\n\tpublic function count_all_results($table = '', $reset = TRUE)\n\t{\n\t\tif ($table !== '')\n\t\t{\n\t\t\t$this->_track_aliases($table);\n\t\t\t$this->from($table);\n\t\t}\n\n\t\t// ORDER BY usage is often problematic here (most notably\n\t\t// on Microsoft SQL Server) and ultimately unnecessary\n\t\t// for selecting COUNT(*) ...\n\t\t$qb_orderby = $this->qb_orderby;\n\t\t$qb_cache_orderby = $this->qb_cache_orderby;\n\t\t$this->qb_orderby = $this->qb_cache_orderby = array();\n\n\t\t$result = ($this->qb_distinct === TRUE OR ! empty($this->qb_groupby) OR ! empty($this->qb_cache_groupby) OR ! empty($this->qb_having) OR $this->qb_limit OR $this->qb_offset)\n\t\t\t? $this->query($this->_count_string.$this->protect_identifiers('numrows').\"\\nFROM (\\n\".$this->_compile_select().\"\\n) CI_count_all_results\")\n\t\t\t: $this->query($this->_compile_select($this->_count_string.$this->protect_identifiers('numrows')));\n\n\t\tif ($reset === TRUE)\n\t\t{\n\t\t\t$this->_reset_select();\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->qb_orderby = $qb_orderby;\n\t\t\t$this->qb_cache_orderby = $qb_cache_orderby;\n\t\t}\n\n\t\tif ($result->num_rows() === 0)\n\t\t{\n\t\t\treturn 0;\n\t\t}\n\n\t\t$row = $result->row();\n\t\treturn (int) $row->numrows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * get_where()\n\t *\n\t * Allows the where clause, limit and offset to be added directly\n\t *\n\t * @param\tstring\t$table\n\t * @param\tstring\t$where\n\t * @param\tint\t$limit\n\t * @param\tint\t$offset\n\t * @return\tCI_DB_result\n\t */\n\tpublic function get_where($table = '', $where = NULL, $limit = NULL, $offset = NULL)\n\t{\n\t\tif ($table !== '')\n\t\t{\n\t\t\t$this->from($table);\n\t\t}\n\n\t\tif ($where !== NULL)\n\t\t{\n\t\t\t$this->where($where);\n\t\t}\n\n\t\tif ( ! empty($limit))\n\t\t{\n\t\t\t$this->limit($limit, $offset);\n\t\t}\n\n\t\t$result = $this->query($this->_compile_select());\n\t\t$this->_reset_select();\n\t\treturn $result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert_Batch\n\t *\n\t * Compiles batch insert strings and runs the queries\n\t *\n\t * @param\tstring\t$table\tTable to insert into\n\t * @param\tarray\t$set \tAn associative array of insert values\n\t * @param\tbool\t$escape\tWhether to escape values and identifiers\n\t * @return\tint\tNumber of rows inserted or FALSE on failure\n\t */\n\tpublic function insert_batch($table, $set = NULL, $escape = NULL, $batch_size = 100)\n\t{\n\t\tif ($set === NULL)\n\t\t{\n\t\t\tif (empty($this->qb_set))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_use_set') : FALSE;\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\tif (empty($set))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('insert_batch() called with no data') : FALSE;\n\t\t\t}\n\n\t\t\t$this->set_insert_batch($set, '', $escape);\n\t\t}\n\n\t\tif (strlen($table) === 0)\n\t\t{\n\t\t\tif ( ! isset($this->qb_from[0]))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t\t}\n\n\t\t\t$table = $this->qb_from[0];\n\t\t}\n\n\t\t// Batch this baby\n\t\t$affected_rows = 0;\n\t\tfor ($i = 0, $total = count($this->qb_set); $i < $total; $i += $batch_size)\n\t\t{\n\t\t\tif ($this->query($this->_insert_batch($this->protect_identifiers($table, TRUE, $escape, FALSE), $this->qb_keys, array_slice($this->qb_set, $i, $batch_size))))\n\t\t\t{\n\t\t\t\t$affected_rows += $this->affected_rows();\n\t\t\t}\n\t\t}\n\n\t\t$this->_reset_write();\n\t\treturn $affected_rows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\treturn 'INSERT INTO '.$table.' ('.implode(', ', $keys).') VALUES '.implode(', ', $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * The \"set_insert_batch\" function. Allows key/value pairs to be set for batch inserts\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tbool\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function set_insert_batch($key, $value = '', $escape = NULL)\n\t{\n\t\t$key = $this->_object_to_array_batch($key);\n\n\t\tif ( ! is_array($key))\n\t\t{\n\t\t\t$key = array($key => $value);\n\t\t}\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\t$keys = array_keys($this->_object_to_array(reset($key)));\n\t\tsort($keys);\n\n\t\tforeach ($key as $row)\n\t\t{\n\t\t\t$row = $this->_object_to_array($row);\n\t\t\tif (count(array_diff($keys, array_keys($row))) > 0 OR count(array_diff(array_keys($row), $keys)) > 0)\n\t\t\t{\n\t\t\t\t// batch function above returns an error on an empty array\n\t\t\t\t$this->qb_set[] = array();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tksort($row); // puts $row in the same order as our keys\n\n\t\t\tif ($escape !== FALSE)\n\t\t\t{\n\t\t\t\t$clean = array();\n\t\t\t\tforeach ($row as $value)\n\t\t\t\t{\n\t\t\t\t\t$clean[] = $this->escape($value);\n\t\t\t\t}\n\n\t\t\t\t$row = $clean;\n\t\t\t}\n\n\t\t\t$this->qb_set[] = '('.implode(',', $row).')';\n\t\t}\n\n\t\tforeach ($keys as $k)\n\t\t{\n\t\t\t$this->qb_keys[] = $this->protect_identifiers($k, FALSE, $escape);\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get INSERT query string\n\t *\n\t * Compiles an insert query and returns the sql\n\t *\n\t * @param\tstring\tthe table to insert into\n\t * @param\tbool\tTRUE: reset QB values; FALSE: leave QB values alone\n\t * @return\tstring\n\t */\n\tpublic function get_compiled_insert($table = '', $reset = TRUE)\n\t{\n\t\tif ($this->_validate_insert($table) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$sql = $this->_insert(\n\t\t\t$this->protect_identifiers(\n\t\t\t\t$this->qb_from[0], TRUE, NULL, FALSE\n\t\t\t),\n\t\t\tarray_keys($this->qb_set),\n\t\t\tarray_values($this->qb_set)\n\t\t);\n\n\t\tif ($reset === TRUE)\n\t\t{\n\t\t\t$this->_reset_write();\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert\n\t *\n\t * Compiles an insert string and runs the query\n\t *\n\t * @param\tstring\tthe table to insert data into\n\t * @param\tarray\tan associative array of insert values\n\t * @param\tbool\t$escape\tWhether to escape values and identifiers\n\t * @return\tbool\tTRUE on success, FALSE on failure\n\t */\n\tpublic function insert($table = '', $set = NULL, $escape = NULL)\n\t{\n\t\tif ($set !== NULL)\n\t\t{\n\t\t\t$this->set($set, '', $escape);\n\t\t}\n\n\t\tif ($this->_validate_insert($table) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$sql = $this->_insert(\n\t\t\t$this->protect_identifiers(\n\t\t\t\t$this->qb_from[0], TRUE, $escape, FALSE\n\t\t\t),\n\t\t\tarray_keys($this->qb_set),\n\t\t\tarray_values($this->qb_set)\n\t\t);\n\n\t\t$this->_reset_write();\n\t\treturn $this->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Validate Insert\n\t *\n\t * This method is used by both insert() and get_compiled_insert() to\n\t * validate that the there data is actually being set and that table\n\t * has been chosen to be inserted into.\n\t *\n\t * @param\tstring\tthe table to insert data into\n\t * @return\tstring\n\t */\n\tprotected function _validate_insert($table = '')\n\t{\n\t\tif (count($this->qb_set) === 0)\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_use_set') : FALSE;\n\t\t}\n\n\t\tif ($table !== '')\n\t\t{\n\t\t\t$this->qb_from[0] = $table;\n\t\t}\n\t\telseif ( ! isset($this->qb_from[0]))\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Replace\n\t *\n\t * Compiles an replace into string and runs the query\n\t *\n\t * @param\tstring\tthe table to replace data into\n\t * @param\tarray\tan associative array of insert values\n\t * @return\tbool\tTRUE on success, FALSE on failure\n\t */\n\tpublic function replace($table = '', $set = NULL)\n\t{\n\t\tif ($set !== NULL)\n\t\t{\n\t\t\t$this->set($set);\n\t\t}\n\n\t\tif (count($this->qb_set) === 0)\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_use_set') : FALSE;\n\t\t}\n\n\t\tif ($table === '')\n\t\t{\n\t\t\tif ( ! isset($this->qb_from[0]))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t\t}\n\n\t\t\t$table = $this->qb_from[0];\n\t\t}\n\n\t\t$sql = $this->_replace($this->protect_identifiers($table, TRUE, NULL, FALSE), array_keys($this->qb_set), array_values($this->qb_set));\n\n\t\t$this->_reset_write();\n\t\treturn $this->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Replace statement\n\t *\n\t * Generates a platform-specific replace string from the supplied data\n\t *\n\t * @param\tstring\tthe table name\n\t * @param\tarray\tthe insert keys\n\t * @param\tarray\tthe insert values\n\t * @return\tstring\n\t */\n\tprotected function _replace($table, $keys, $values)\n\t{\n\t\treturn 'REPLACE INTO '.$table.' ('.implode(', ', $keys).') VALUES ('.implode(', ', $values).')';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * FROM tables\n\t *\n\t * Groups tables in FROM clauses if needed, so there is no confusion\n\t * about operator precedence.\n\t *\n\t * Note: This is only used (and overridden) by MySQL and CUBRID.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _from_tables()\n\t{\n\t\treturn implode(', ', $this->qb_from);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get UPDATE query string\n\t *\n\t * Compiles an update query and returns the sql\n\t *\n\t * @param\tstring\tthe table to update\n\t * @param\tbool\tTRUE: reset QB values; FALSE: leave QB values alone\n\t * @return\tstring\n\t */\n\tpublic function get_compiled_update($table = '', $reset = TRUE)\n\t{\n\t\t// Combine any cached components with the current statements\n\t\t$this->_merge_cache();\n\n\t\tif ($this->_validate_update($table) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$sql = $this->_update($this->qb_from[0], $this->qb_set);\n\n\t\tif ($reset === TRUE)\n\t\t{\n\t\t\t$this->_reset_write();\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * UPDATE\n\t *\n\t * Compiles an update string and runs the query.\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$set\tAn associative array of update values\n\t * @param\tmixed\t$where\n\t * @param\tint\t$limit\n\t * @return\tbool\tTRUE on success, FALSE on failure\n\t */\n\tpublic function update($table = '', $set = NULL, $where = NULL, $limit = NULL)\n\t{\n\t\t// Combine any cached components with the current statements\n\t\t$this->_merge_cache();\n\n\t\tif ($set !== NULL)\n\t\t{\n\t\t\t$this->set($set);\n\t\t}\n\n\t\tif ($this->_validate_update($table) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ($where !== NULL)\n\t\t{\n\t\t\t$this->where($where);\n\t\t}\n\n\t\tif ( ! empty($limit))\n\t\t{\n\t\t\t$this->limit($limit);\n\t\t}\n\n\t\t$sql = $this->_update($this->qb_from[0], $this->qb_set);\n\t\t$this->_reset_write();\n\t\treturn $this->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Validate Update\n\t *\n\t * This method is used by both update() and get_compiled_update() to\n\t * validate that data is actually being set and that a table has been\n\t * chosen to be update.\n\t *\n\t * @param\tstring\tthe table to update data on\n\t * @return\tbool\n\t */\n\tprotected function _validate_update($table)\n\t{\n\t\tif (count($this->qb_set) === 0)\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_use_set') : FALSE;\n\t\t}\n\n\t\tif ($table !== '')\n\t\t{\n\t\t\t$this->qb_from = array($this->protect_identifiers($table, TRUE, NULL, FALSE));\n\t\t}\n\t\telseif ( ! isset($this->qb_from[0]))\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update_Batch\n\t *\n\t * Compiles an update string and runs the query\n\t *\n\t * @param\tstring\tthe table to retrieve the results from\n\t * @param\tarray\tan associative array of update values\n\t * @param\tstring\tthe where key\n\t * @return\tint\tnumber of rows affected or FALSE on failure\n\t */\n\tpublic function update_batch($table, $set = NULL, $index = NULL, $batch_size = 100)\n\t{\n\t\t// Combine any cached components with the current statements\n\t\t$this->_merge_cache();\n\n\t\tif ($index === NULL)\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_use_index') : FALSE;\n\t\t}\n\n\t\tif ($set === NULL)\n\t\t{\n\t\t\tif (empty($this->qb_set_ub))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_use_set') : FALSE;\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\tif (empty($set))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('update_batch() called with no data') : FALSE;\n\t\t\t}\n\n\t\t\t$this->set_update_batch($set, $index);\n\t\t}\n\n\t\tif (strlen($table) === 0)\n\t\t{\n\t\t\tif ( ! isset($this->qb_from[0]))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t\t}\n\n\t\t\t$table = $this->qb_from[0];\n\t\t}\n\n\t\t// Batch this baby\n\t\t$affected_rows = 0;\n\t\tfor ($i = 0, $total = count($this->qb_set_ub); $i < $total; $i += $batch_size)\n\t\t{\n\t\t\tif ($this->query($this->_update_batch($this->protect_identifiers($table, TRUE, NULL, FALSE), array_slice($this->qb_set_ub, $i, $batch_size), $index)))\n\t\t\t{\n\t\t\t\t$affected_rows += $this->affected_rows();\n\t\t\t}\n\n\t\t\t$this->qb_where = array();\n\t\t}\n\n\t\t$this->_reset_write();\n\t\treturn $affected_rows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update_Batch statement\n\t *\n\t * Generates a platform-specific batch update string from the supplied data\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$values\tUpdate data\n\t * @param\tstring\t$index\tWHERE key\n\t * @return\tstring\n\t */\n\tprotected function _update_batch($table, $values, $index)\n\t{\n\t\t$ids = array();\n\t\tforeach ($values as $key => $val)\n\t\t{\n\t\t\t$ids[] = $val[$index]['value'];\n\n\t\t\tforeach (array_keys($val) as $field)\n\t\t\t{\n\t\t\t\tif ($field !== $index)\n\t\t\t\t{\n\t\t\t\t\t$final[$val[$field]['field']][] = 'WHEN '.$val[$index]['field'].' = '.$val[$index]['value'].' THEN '.$val[$field]['value'];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$cases = '';\n\t\tforeach ($final as $k => $v)\n\t\t{\n\t\t\t$cases .= $k.\" = CASE \\n\"\n\t\t\t\t.implode(\"\\n\", $v).\"\\n\"\n\t\t\t\t.'ELSE '.$k.' END, ';\n\t\t}\n\n\t\t$this->where($val[$index]['field'].' IN('.implode(',', $ids).')', NULL, FALSE);\n\n\t\treturn 'UPDATE '.$table.' SET '.substr($cases, 0, -2).$this->_compile_wh('qb_where');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * The \"set_update_batch\" function. Allows key/value pairs to be set for batch updating\n\t *\n\t * @param\tarray\n\t * @param\tstring\n\t * @param\tbool\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function set_update_batch($key, $index = '', $escape = NULL)\n\t{\n\t\t$key = $this->_object_to_array_batch($key);\n\n\t\tif ( ! is_array($key))\n\t\t{\n\t\t\t// @todo error\n\t\t}\n\n\t\tis_bool($escape) OR $escape = $this->_protect_identifiers;\n\n\t\tforeach ($key as $k => $v)\n\t\t{\n\t\t\t$index_set = FALSE;\n\t\t\t$clean = array();\n\t\t\tforeach ($v as $k2 => $v2)\n\t\t\t{\n\t\t\t\tif ($k2 === $index)\n\t\t\t\t{\n\t\t\t\t\t$index_set = TRUE;\n\t\t\t\t}\n\n\t\t\t\t$clean[$k2] = array(\n\t\t\t\t\t'field' => $this->protect_identifiers($k2, FALSE, $escape),\n\t\t\t\t\t'value' => ($escape === FALSE ? $v2 : $this->escape($v2))\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif ($index_set === FALSE)\n\t\t\t{\n\t\t\t\treturn $this->display_error('db_batch_missing_index');\n\t\t\t}\n\n\t\t\t$this->qb_set_ub[] = $clean;\n\t\t}\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Empty Table\n\t *\n\t * Compiles a delete string and runs \"DELETE FROM table\"\n\t *\n\t * @param\tstring\tthe table to empty\n\t * @return\tbool\tTRUE on success, FALSE on failure\n\t */\n\tpublic function empty_table($table = '')\n\t{\n\t\tif ($table === '')\n\t\t{\n\t\t\tif ( ! isset($this->qb_from[0]))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t\t}\n\n\t\t\t$table = $this->qb_from[0];\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$table = $this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t\t}\n\n\t\t$sql = $this->_delete($table);\n\t\t$this->_reset_write();\n\t\treturn $this->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate\n\t *\n\t * Compiles a truncate string and runs the query\n\t * If the database does not support the truncate() command\n\t * This function maps to \"DELETE FROM table\"\n\t *\n\t * @param\tstring\tthe table to truncate\n\t * @return\tbool\tTRUE on success, FALSE on failure\n\t */\n\tpublic function truncate($table = '')\n\t{\n\t\tif ($table === '')\n\t\t{\n\t\t\tif ( ! isset($this->qb_from[0]))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t\t}\n\n\t\t\t$table = $this->qb_from[0];\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$table = $this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t\t}\n\n\t\t$sql = $this->_truncate($table);\n\t\t$this->_reset_write();\n\t\treturn $this->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the truncate() command,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\tthe table name\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get DELETE query string\n\t *\n\t * Compiles a delete query string and returns the sql\n\t *\n\t * @param\tstring\tthe table to delete from\n\t * @param\tbool\tTRUE: reset QB values; FALSE: leave QB values alone\n\t * @return\tstring\n\t */\n\tpublic function get_compiled_delete($table = '', $reset = TRUE)\n\t{\n\t\t$this->return_delete_sql = TRUE;\n\t\t$sql = $this->delete($table, '', NULL, $reset);\n\t\t$this->return_delete_sql = FALSE;\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete\n\t *\n\t * Compiles a delete string and runs the query\n\t *\n\t * @param\tmixed\tthe table(s) to delete from. String or array\n\t * @param\tmixed\tthe where clause\n\t * @param\tmixed\tthe limit clause\n\t * @param\tbool\n\t * @return\tmixed\n\t */\n\tpublic function delete($table = '', $where = '', $limit = NULL, $reset_data = TRUE)\n\t{\n\t\t// Combine any cached components with the current statements\n\t\t$this->_merge_cache();\n\n\t\tif ($table === '')\n\t\t{\n\t\t\tif ( ! isset($this->qb_from[0]))\n\t\t\t{\n\t\t\t\treturn ($this->db_debug) ? $this->display_error('db_must_set_table') : FALSE;\n\t\t\t}\n\n\t\t\t$table = $this->qb_from[0];\n\t\t}\n\t\telseif (is_array($table))\n\t\t{\n\t\t\tempty($where) && $reset_data = FALSE;\n\n\t\t\tforeach ($table as $single_table)\n\t\t\t{\n\t\t\t\t$this->delete($single_table, $where, $limit, $reset_data);\n\t\t\t}\n\n\t\t\treturn;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$table = $this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t\t}\n\n\t\tif ($where !== '')\n\t\t{\n\t\t\t$this->where($where);\n\t\t}\n\n\t\tif ( ! empty($limit))\n\t\t{\n\t\t\t$this->limit($limit);\n\t\t}\n\n\t\tif (count($this->qb_where) === 0)\n\t\t{\n\t\t\treturn ($this->db_debug) ? $this->display_error('db_del_must_use_where') : FALSE;\n\t\t}\n\n\t\t$sql = $this->_delete($table);\n\t\tif ($reset_data)\n\t\t{\n\t\t\t$this->_reset_write();\n\t\t}\n\n\t\treturn ($this->return_delete_sql === TRUE) ? $sql : $this->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\tthe table name\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\treturn 'DELETE FROM '.$table.$this->_compile_wh('qb_where')\n\t\t\t.($this->qb_limit !== FALSE ? ' LIMIT '.$this->qb_limit : '');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * DB Prefix\n\t *\n\t * Prepends a database prefix if one exists in configuration\n\t *\n\t * @param\tstring\tthe table\n\t * @return\tstring\n\t */\n\tpublic function dbprefix($table = '')\n\t{\n\t\tif ($table === '')\n\t\t{\n\t\t\t$this->display_error('db_table_name_required');\n\t\t}\n\n\t\treturn $this->dbprefix.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Set DB Prefix\n\t *\n\t * Set's the DB Prefix to something new without needing to reconnect\n\t *\n\t * @param\tstring\tthe prefix\n\t * @return\tstring\n\t */\n\tpublic function set_dbprefix($prefix = '')\n\t{\n\t\treturn $this->dbprefix = $prefix;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Track Aliases\n\t *\n\t * Used to track SQL statements written with aliased tables.\n\t *\n\t * @param\tstring\tThe table to inspect\n\t * @return\tstring\n\t */\n\tprotected function _track_aliases($table)\n\t{\n\t\tif (is_array($table))\n\t\t{\n\t\t\tforeach ($table as $t)\n\t\t\t{\n\t\t\t\t$this->_track_aliases($t);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Does the string contain a comma? If so, we need to separate\n\t\t// the string into discreet statements\n\t\tif (strpos($table, ',') !== FALSE)\n\t\t{\n\t\t\treturn $this->_track_aliases(explode(',', $table));\n\t\t}\n\n\t\t// if a table alias is used we can recognize it by a space\n\t\tif (strpos($table, ' ') !== FALSE)\n\t\t{\n\t\t\t// if the alias is written with the AS keyword, remove it\n\t\t\t$table = preg_replace('/\\s+AS\\s+/i', ' ', $table);\n\n\t\t\t// Grab the alias\n\t\t\t$table = trim(strrchr($table, ' '));\n\n\t\t\t// Store the alias, if it doesn't already exist\n\t\t\tif ( ! in_array($table, $this->qb_aliased_tables, TRUE))\n\t\t\t{\n\t\t\t\t$this->qb_aliased_tables[] = $table;\n\t\t\t\tif ($this->qb_caching === TRUE && ! in_array($table, $this->qb_cache_aliased_tables, TRUE))\n\t\t\t\t{\n\t\t\t\t\t$this->qb_cache_aliased_tables[] = $table;\n\t\t\t\t\t$this->qb_cache_exists[] = 'aliased_tables';\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Compile the SELECT statement\n\t *\n\t * Generates a query string based on which functions were used.\n\t * Should not be called directly.\n\t *\n\t * @param\tbool\t$select_override\n\t * @return\tstring\n\t */\n\tprotected function _compile_select($select_override = FALSE)\n\t{\n\t\t// Combine any cached components with the current statements\n\t\t$this->_merge_cache();\n\n\t\t// Write the \"select\" portion of the query\n\t\tif ($select_override !== FALSE)\n\t\t{\n\t\t\t$sql = $select_override;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$sql = ( ! $this->qb_distinct) ? 'SELECT ' : 'SELECT DISTINCT ';\n\n\t\t\tif (count($this->qb_select) === 0)\n\t\t\t{\n\t\t\t\t$sql .= '*';\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Cycle through the \"select\" portion of the query and prep each column name.\n\t\t\t\t// The reason we protect identifiers here rather than in the select() function\n\t\t\t\t// is because until the user calls the from() function we don't know if there are aliases\n\t\t\t\tforeach ($this->qb_select as $key => $val)\n\t\t\t\t{\n\t\t\t\t\t$no_escape = isset($this->qb_no_escape[$key]) ? $this->qb_no_escape[$key] : NULL;\n\t\t\t\t\t$this->qb_select[$key] = $this->protect_identifiers($val, FALSE, $no_escape);\n\t\t\t\t}\n\n\t\t\t\t$sql .= implode(', ', $this->qb_select);\n\t\t\t}\n\t\t}\n\n\t\t// Write the \"FROM\" portion of the query\n\t\tif (count($this->qb_from) > 0)\n\t\t{\n\t\t\t$sql .= \"\\nFROM \".$this->_from_tables();\n\t\t}\n\n\t\t// Write the \"JOIN\" portion of the query\n\t\tif (count($this->qb_join) > 0)\n\t\t{\n\t\t\t$sql .= \"\\n\".implode(\"\\n\", $this->qb_join);\n\t\t}\n\n\t\t$sql .= $this->_compile_wh('qb_where')\n\t\t\t.$this->_compile_group_by()\n\t\t\t.$this->_compile_wh('qb_having')\n\t\t\t.$this->_compile_order_by(); // ORDER BY\n\n\t\t// LIMIT\n\t\tif ($this->qb_limit !== FALSE OR $this->qb_offset)\n\t\t{\n\t\t\treturn $this->_limit($sql.\"\\n\");\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Compile WHERE, HAVING statements\n\t *\n\t * Escapes identifiers in WHERE and HAVING statements at execution time.\n\t *\n\t * Required so that aliases are tracked properly, regardless of whether\n\t * where(), or_where(), having(), or_having are called prior to from(),\n\t * join() and dbprefix is added only if needed.\n\t *\n\t * @param\tstring\t$qb_key\t'qb_where' or 'qb_having'\n\t * @return\tstring\tSQL statement\n\t */\n\tprotected function _compile_wh($qb_key)\n\t{\n\t\tif (count($this->$qb_key) > 0)\n\t\t{\n\t\t\tfor ($i = 0, $c = count($this->$qb_key); $i < $c; $i++)\n\t\t\t{\n\t\t\t\t// Is this condition already compiled?\n\t\t\t\tif (is_string($this->{$qb_key}[$i]))\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\telseif ($this->{$qb_key}[$i]['escape'] === FALSE)\n\t\t\t\t{\n\t\t\t\t\t$this->{$qb_key}[$i] = $this->{$qb_key}[$i]['condition'].(isset($this->{$qb_key}[$i]['value']) ? ' '.$this->{$qb_key}[$i]['value'] : '');\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Split multiple conditions\n\t\t\t\t$conditions = preg_split(\n\t\t\t\t\t'/((?:^|\\s+)AND\\s+|(?:^|\\s+)OR\\s+)/i',\n\t\t\t\t\t$this->{$qb_key}[$i]['condition'],\n\t\t\t\t\t-1,\n\t\t\t\t\tPREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY\n\t\t\t\t);\n\n\t\t\t\tfor ($ci = 0, $cc = count($conditions); $ci < $cc; $ci++)\n\t\t\t\t{\n\t\t\t\t\tif (($op = $this->_get_operator($conditions[$ci])) === FALSE\n\t\t\t\t\t\tOR ! preg_match('/^(\\(?)(.*)('.preg_quote($op, '/').')\\s*(.*(? '(test <= foo)',\t/* the whole thing */\n\t\t\t\t\t//\t1 => '(',\t\t/* optional */\n\t\t\t\t\t//\t2 => 'test',\t\t/* the field name */\n\t\t\t\t\t//\t3 => ' <= ',\t\t/* $op */\n\t\t\t\t\t//\t4 => 'foo',\t\t/* optional, if $op is e.g. 'IS NULL' */\n\t\t\t\t\t//\t5 => ')'\t\t/* optional */\n\t\t\t\t\t// );\n\n\t\t\t\t\tif ( ! empty($matches[4]))\n\t\t\t\t\t{\n\t\t\t\t\t\t$this->_is_literal($matches[4]) OR $matches[4] = $this->protect_identifiers(trim($matches[4]));\n\t\t\t\t\t\t$matches[4] = ' '.$matches[4];\n\t\t\t\t\t}\n\n\t\t\t\t\t$conditions[$ci] = $matches[1].$this->protect_identifiers(trim($matches[2]))\n\t\t\t\t\t\t.' '.trim($matches[3]).$matches[4].$matches[5];\n\t\t\t\t}\n\n\t\t\t\t$this->{$qb_key}[$i] = implode('', $conditions).(isset($this->{$qb_key}[$i]['value']) ? ' '.$this->{$qb_key}[$i]['value'] : '');\n\t\t\t}\n\n\t\t\treturn ($qb_key === 'qb_having' ? \"\\nHAVING \" : \"\\nWHERE \")\n\t\t\t\t.implode(\"\\n\", $this->$qb_key);\n\t\t}\n\n\t\treturn '';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Compile GROUP BY\n\t *\n\t * Escapes identifiers in GROUP BY statements at execution time.\n\t *\n\t * Required so that aliases are tracked properly, regardless of whether\n\t * group_by() is called prior to from(), join() and dbprefix is added\n\t * only if needed.\n\t *\n\t * @return\tstring\tSQL statement\n\t */\n\tprotected function _compile_group_by()\n\t{\n\t\tif (count($this->qb_groupby) > 0)\n\t\t{\n\t\t\tfor ($i = 0, $c = count($this->qb_groupby); $i < $c; $i++)\n\t\t\t{\n\t\t\t\t// Is it already compiled?\n\t\t\t\tif (is_string($this->qb_groupby[$i]))\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t$this->qb_groupby[$i] = ($this->qb_groupby[$i]['escape'] === FALSE OR $this->_is_literal($this->qb_groupby[$i]['field']))\n\t\t\t\t\t? $this->qb_groupby[$i]['field']\n\t\t\t\t\t: $this->protect_identifiers($this->qb_groupby[$i]['field']);\n\t\t\t}\n\n\t\t\treturn \"\\nGROUP BY \".implode(', ', $this->qb_groupby);\n\t\t}\n\n\t\treturn '';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Compile ORDER BY\n\t *\n\t * Escapes identifiers in ORDER BY statements at execution time.\n\t *\n\t * Required so that aliases are tracked properly, regardless of whether\n\t * order_by() is called prior to from(), join() and dbprefix is added\n\t * only if needed.\n\t *\n\t * @return\tstring\tSQL statement\n\t */\n\tprotected function _compile_order_by()\n\t{\n\t\tif (empty($this->qb_orderby))\n\t\t{\n\t\t\treturn '';\n\t\t}\n\n\t\tfor ($i = 0, $c = count($this->qb_orderby); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_string($this->qb_orderby[$i]))\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif ($this->qb_orderby[$i]['escape'] !== FALSE && ! $this->_is_literal($this->qb_orderby[$i]['field']))\n\t\t\t{\n\t\t\t\t$this->qb_orderby[$i]['field'] = $this->protect_identifiers($this->qb_orderby[$i]['field']);\n\t\t\t}\n\n\t\t\t$this->qb_orderby[$i] = $this->qb_orderby[$i]['field'].$this->qb_orderby[$i]['direction'];\n\t\t}\n\n\t\treturn \"\\nORDER BY \".implode(', ', $this->qb_orderby);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Object to Array\n\t *\n\t * Takes an object as input and converts the class variables to array key/vals\n\t *\n\t * @param\tobject\n\t * @return\tarray\n\t */\n\tprotected function _object_to_array($object)\n\t{\n\t\tif ( ! is_object($object))\n\t\t{\n\t\t\treturn $object;\n\t\t}\n\n\t\t$array = array();\n\t\tforeach (get_object_vars($object) as $key => $val)\n\t\t{\n\t\t\t// There are some built in keys we need to ignore for this conversion\n\t\t\tif ( ! is_object($val) && ! is_array($val) && $key !== '_parent_name')\n\t\t\t{\n\t\t\t\t$array[$key] = $val;\n\t\t\t}\n\t\t}\n\n\t\treturn $array;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Object to Array\n\t *\n\t * Takes an object as input and converts the class variables to array key/vals\n\t *\n\t * @param\tobject\n\t * @return\tarray\n\t */\n\tprotected function _object_to_array_batch($object)\n\t{\n\t\tif ( ! is_object($object))\n\t\t{\n\t\t\treturn $object;\n\t\t}\n\n\t\t$array = array();\n\t\t$out = get_object_vars($object);\n\t\t$fields = array_keys($out);\n\n\t\tforeach ($fields as $val)\n\t\t{\n\t\t\t// There are some built in keys we need to ignore for this conversion\n\t\t\tif ($val !== '_parent_name')\n\t\t\t{\n\t\t\t\t$i = 0;\n\t\t\t\tforeach ($out[$val] as $data)\n\t\t\t\t{\n\t\t\t\t\t$array[$i++][$val] = $data;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn $array;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Start Cache\n\t *\n\t * Starts QB caching\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function start_cache()\n\t{\n\t\t$this->qb_caching = TRUE;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Stop Cache\n\t *\n\t * Stops QB caching\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function stop_cache()\n\t{\n\t\t$this->qb_caching = FALSE;\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Flush Cache\n\t *\n\t * Empties the QB cache\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function flush_cache()\n\t{\n\t\t$this->_reset_run(array(\n\t\t\t'qb_cache_select'\t\t=> array(),\n\t\t\t'qb_cache_from'\t\t\t=> array(),\n\t\t\t'qb_cache_join'\t\t\t=> array(),\n\t\t\t'qb_cache_where'\t\t=> array(),\n\t\t\t'qb_cache_groupby'\t\t=> array(),\n\t\t\t'qb_cache_having'\t\t=> array(),\n\t\t\t'qb_cache_orderby'\t\t=> array(),\n\t\t\t'qb_cache_set'\t\t\t=> array(),\n\t\t\t'qb_cache_exists'\t\t=> array(),\n\t\t\t'qb_cache_no_escape'\t=> array(),\n\t\t\t'qb_cache_aliased_tables'\t=> array()\n\t\t));\n\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Merge Cache\n\t *\n\t * When called, this function merges any cached QB arrays with\n\t * locally called ones.\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _merge_cache()\n\t{\n\t\tif (count($this->qb_cache_exists) === 0)\n\t\t{\n\t\t\treturn;\n\t\t}\n\t\telseif (in_array('select', $this->qb_cache_exists, TRUE))\n\t\t{\n\t\t\t$qb_no_escape = $this->qb_cache_no_escape;\n\t\t}\n\n\t\tforeach (array_unique($this->qb_cache_exists) as $val) // select, from, etc.\n\t\t{\n\t\t\t$qb_variable\t= 'qb_'.$val;\n\t\t\t$qb_cache_var\t= 'qb_cache_'.$val;\n\t\t\t$qb_new \t= $this->$qb_cache_var;\n\n\t\t\tfor ($i = 0, $c = count($this->$qb_variable); $i < $c; $i++)\n\t\t\t{\n\t\t\t\tif ( ! in_array($this->{$qb_variable}[$i], $qb_new, TRUE))\n\t\t\t\t{\n\t\t\t\t\t$qb_new[] = $this->{$qb_variable}[$i];\n\t\t\t\t\tif ($val === 'select')\n\t\t\t\t\t{\n\t\t\t\t\t\t$qb_no_escape[] = $this->qb_no_escape[$i];\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t$this->$qb_variable = $qb_new;\n\t\t\tif ($val === 'select')\n\t\t\t{\n\t\t\t\t$this->qb_no_escape = $qb_no_escape;\n\t\t\t}\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Is literal\n\t *\n\t * Determines if a string represents a literal value or a field name\n\t *\n\t * @param\tstring\t$str\n\t * @return\tbool\n\t */\n\tprotected function _is_literal($str)\n\t{\n\t\t$str = trim($str);\n\n\t\tif (empty($str) OR ctype_digit($str) OR (string) (float) $str === $str OR in_array(strtoupper($str), array('TRUE', 'FALSE'), TRUE))\n\t\t{\n\t\t\treturn TRUE;\n\t\t}\n\n\t\tstatic $_str;\n\n\t\tif (empty($_str))\n\t\t{\n\t\t\t$_str = ($this->_escape_char !== '\"')\n\t\t\t\t? array('\"', \"'\") : array(\"'\");\n\t\t}\n\n\t\treturn in_array($str[0], $_str, TRUE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reset Query Builder values.\n\t *\n\t * Publicly-visible method to reset the QB values.\n\t *\n\t * @return\tCI_DB_query_builder\n\t */\n\tpublic function reset_query()\n\t{\n\t\t$this->_reset_select();\n\t\t$this->_reset_write();\n\t\treturn $this;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Resets the query builder values. Called by the get() function\n\t *\n\t * @param\tarray\tAn array of fields to reset\n\t * @return\tvoid\n\t */\n\tprotected function _reset_run($qb_reset_items)\n\t{\n\t\tforeach ($qb_reset_items as $item => $default_value)\n\t\t{\n\t\t\t$this->$item = $default_value;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Resets the query builder values. Called by the get() function\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _reset_select()\n\t{\n\t\t$this->_reset_run(array(\n\t\t\t'qb_select'\t\t=> array(),\n\t\t\t'qb_from'\t\t=> array(),\n\t\t\t'qb_join'\t\t=> array(),\n\t\t\t'qb_where'\t\t=> array(),\n\t\t\t'qb_groupby'\t\t=> array(),\n\t\t\t'qb_having'\t\t=> array(),\n\t\t\t'qb_orderby'\t\t=> array(),\n\t\t\t'qb_aliased_tables'\t=> array(),\n\t\t\t'qb_no_escape'\t\t=> array(),\n\t\t\t'qb_distinct'\t\t=> FALSE,\n\t\t\t'qb_limit'\t\t=> FALSE,\n\t\t\t'qb_offset'\t\t=> FALSE\n\t\t));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Resets the query builder \"write\" values.\n\t *\n\t * Called by the insert() update() insert_batch() update_batch() and delete() functions\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _reset_write()\n\t{\n\t\t$this->_reset_run(array(\n\t\t\t'qb_set'\t=> array(),\n\t\t\t'qb_set_ub'\t=> array(),\n\t\t\t'qb_from'\t=> array(),\n\t\t\t'qb_join'\t=> array(),\n\t\t\t'qb_where'\t=> array(),\n\t\t\t'qb_orderby'\t=> array(),\n\t\t\t'qb_keys'\t=> array(),\n\t\t\t'qb_limit'\t=> FALSE\n\t\t));\n\t}\n\n}\n" }, { "path": "system/database/DB_result.php", "content": "conn_id = $driver_object->conn_id;\n\t\t$this->result_id = $driver_object->result_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of rows in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_rows()\n\t{\n\t\tif (is_int($this->num_rows))\n\t\t{\n\t\t\treturn $this->num_rows;\n\t\t}\n\t\telseif (count($this->result_array) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = count($this->result_array);\n\t\t}\n\t\telseif (count($this->result_object) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = count($this->result_object);\n\t\t}\n\n\t\treturn $this->num_rows = count($this->result_array());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Query result. Acts as a wrapper function for the following functions.\n\t *\n\t * @param\tstring\t$type\t'object', 'array' or a custom class name\n\t * @return\tarray\n\t */\n\tpublic function result($type = 'object')\n\t{\n\t\tif ($type === 'array')\n\t\t{\n\t\t\treturn $this->result_array();\n\t\t}\n\t\telseif ($type === 'object')\n\t\t{\n\t\t\treturn $this->result_object();\n\t\t}\n\n\t\treturn $this->custom_result_object($type);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Custom query result.\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tarray\n\t */\n\tpublic function custom_result_object($class_name)\n\t{\n\t\tif (isset($this->custom_result_object[$class_name]))\n\t\t{\n\t\t\treturn $this->custom_result_object[$class_name];\n\t\t}\n\t\telseif ( ! $this->result_id OR $this->num_rows === 0)\n\t\t{\n\t\t\treturn array();\n\t\t}\n\n\t\t// Don't fetch the result set again if we already have it\n\t\t$_data = NULL;\n\t\tif (($c = count($this->result_array)) > 0)\n\t\t{\n\t\t\t$_data = 'result_array';\n\t\t}\n\t\telseif (($c = count($this->result_object)) > 0)\n\t\t{\n\t\t\t$_data = 'result_object';\n\t\t}\n\n\t\tif ($_data !== NULL)\n\t\t{\n\t\t\tfor ($i = 0; $i < $c; $i++)\n\t\t\t{\n\t\t\t\t$this->custom_result_object[$class_name][$i] = new $class_name();\n\n\t\t\t\tforeach ($this->{$_data}[$i] as $key => $value)\n\t\t\t\t{\n\t\t\t\t\t$this->custom_result_object[$class_name][$i]->$key = $value;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn $this->custom_result_object[$class_name];\n\t\t}\n\n\t\tis_null($this->row_data) OR $this->data_seek(0);\n\t\t$this->custom_result_object[$class_name] = array();\n\n\t\twhile ($row = $this->_fetch_object($class_name))\n\t\t{\n\t\t\t$this->custom_result_object[$class_name][] = $row;\n\t\t}\n\n\t\treturn $this->custom_result_object[$class_name];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Query result. \"object\" version.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function result_object()\n\t{\n\t\tif (count($this->result_object) > 0)\n\t\t{\n\t\t\treturn $this->result_object;\n\t\t}\n\n\t\t// In the event that query caching is on, the result_id variable\n\t\t// will not be a valid resource so we'll simply return an empty\n\t\t// array.\n\t\tif ( ! $this->result_id OR $this->num_rows === 0)\n\t\t{\n\t\t\treturn array();\n\t\t}\n\n\t\tif (($c = count($this->result_array)) > 0)\n\t\t{\n\t\t\tfor ($i = 0; $i < $c; $i++)\n\t\t\t{\n\t\t\t\t$this->result_object[$i] = (object) $this->result_array[$i];\n\t\t\t}\n\n\t\t\treturn $this->result_object;\n\t\t}\n\n\t\tis_null($this->row_data) OR $this->data_seek(0);\n\t\twhile ($row = $this->_fetch_object())\n\t\t{\n\t\t\t$this->result_object[] = $row;\n\t\t}\n\n\t\treturn $this->result_object;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Query result. \"array\" version.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function result_array()\n\t{\n\t\tif (count($this->result_array) > 0)\n\t\t{\n\t\t\treturn $this->result_array;\n\t\t}\n\n\t\t// In the event that query caching is on, the result_id variable\n\t\t// will not be a valid resource so we'll simply return an empty\n\t\t// array.\n\t\tif ( ! $this->result_id OR $this->num_rows === 0)\n\t\t{\n\t\t\treturn array();\n\t\t}\n\n\t\tif (($c = count($this->result_object)) > 0)\n\t\t{\n\t\t\tfor ($i = 0; $i < $c; $i++)\n\t\t\t{\n\t\t\t\t$this->result_array[$i] = (array) $this->result_object[$i];\n\t\t\t}\n\n\t\t\treturn $this->result_array;\n\t\t}\n\n\t\tis_null($this->row_data) OR $this->data_seek(0);\n\t\twhile ($row = $this->_fetch_assoc())\n\t\t{\n\t\t\t$this->result_array[] = $row;\n\t\t}\n\n\t\treturn $this->result_array;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Row\n\t *\n\t * A wrapper method.\n\t *\n\t * @param\tmixed\t$n\n\t * @param\tstring\t$type\t'object' or 'array'\n\t * @return\tmixed\n\t */\n\tpublic function row($n = 0, $type = 'object')\n\t{\n\t\tif ( ! is_numeric($n))\n\t\t{\n\t\t\t// We cache the row data for subsequent uses\n\t\t\tis_array($this->row_data) OR $this->row_data = $this->row_array(0);\n\n\t\t\t// array_key_exists() instead of isset() to allow for NULL values\n\t\t\tif (empty($this->row_data) OR ! array_key_exists($n, $this->row_data))\n\t\t\t{\n\t\t\t\treturn NULL;\n\t\t\t}\n\n\t\t\treturn $this->row_data[$n];\n\t\t}\n\n\t\tif ($type === 'object') return $this->row_object($n);\n\t\telseif ($type === 'array') return $this->row_array($n);\n\n\t\treturn $this->custom_row_object($n, $type);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Assigns an item into a particular column slot\n\t *\n\t * @param\tmixed\t$key\n\t * @param\tmixed\t$value\n\t * @return\tvoid\n\t */\n\tpublic function set_row($key, $value = NULL)\n\t{\n\t\t// We cache the row data for subsequent uses\n\t\tif ( ! is_array($this->row_data))\n\t\t{\n\t\t\t$this->row_data = $this->row_array(0);\n\t\t}\n\n\t\tif (is_array($key))\n\t\t{\n\t\t\tforeach ($key as $k => $v)\n\t\t\t{\n\t\t\t\t$this->row_data[$k] = $v;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif ($key !== '' && $value !== NULL)\n\t\t{\n\t\t\t$this->row_data[$key] = $value;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns a single result row - custom object version\n\t *\n\t * @param\tint\t$n\n\t * @param\tstring\t$type\n\t * @return\tobject\n\t */\n\tpublic function custom_row_object($n, $type)\n\t{\n\t\tisset($this->custom_result_object[$type]) OR $this->custom_result_object[$type] = $this->custom_result_object($type);\n\n\t\tif (count($this->custom_result_object[$type]) === 0)\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif ($n !== $this->current_row && isset($this->custom_result_object[$type][$n]))\n\t\t{\n\t\t\t$this->current_row = $n;\n\t\t}\n\n\t\treturn $this->custom_result_object[$type][$this->current_row];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns a single result row - object version\n\t *\n\t * @param\tint\t$n\n\t * @return\tobject\n\t */\n\tpublic function row_object($n = 0)\n\t{\n\t\t$result = $this->result_object();\n\t\tif (count($result) === 0)\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif ($n !== $this->current_row && isset($result[$n]))\n\t\t{\n\t\t\t$this->current_row = $n;\n\t\t}\n\n\t\treturn $result[$this->current_row];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns a single result row - array version\n\t *\n\t * @param\tint\t$n\n\t * @return\tarray\n\t */\n\tpublic function row_array($n = 0)\n\t{\n\t\t$result = $this->result_array();\n\t\tif (count($result) === 0)\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif ($n !== $this->current_row && isset($result[$n]))\n\t\t{\n\t\t\t$this->current_row = $n;\n\t\t}\n\n\t\treturn $result[$this->current_row];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the \"first\" row\n\t *\n\t * @param\tstring\t$type\n\t * @return\tmixed\n\t */\n\tpublic function first_row($type = 'object')\n\t{\n\t\t$result = $this->result($type);\n\t\treturn (count($result) === 0) ? NULL : $result[0];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the \"last\" row\n\t *\n\t * @param\tstring\t$type\n\t * @return\tmixed\n\t */\n\tpublic function last_row($type = 'object')\n\t{\n\t\t$result = $this->result($type);\n\t\treturn (count($result) === 0) ? NULL : $result[count($result) - 1];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the \"next\" row\n\t *\n\t * @param\tstring\t$type\n\t * @return\tmixed\n\t */\n\tpublic function next_row($type = 'object')\n\t{\n\t\t$result = $this->result($type);\n\t\tif (count($result) === 0)\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\treturn isset($result[$this->current_row + 1])\n\t\t\t? $result[++$this->current_row]\n\t\t\t: NULL;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns the \"previous\" row\n\t *\n\t * @param\tstring\t$type\n\t * @return\tmixed\n\t */\n\tpublic function previous_row($type = 'object')\n\t{\n\t\t$result = $this->result($type);\n\t\tif (count($result) === 0)\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\tif (isset($result[$this->current_row - 1]))\n\t\t{\n\t\t\t--$this->current_row;\n\t\t}\n\t\treturn $result[$this->current_row];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an unbuffered row and move pointer to next row\n\t *\n\t * @param\tstring\t$type\t'array', 'object' or a custom class name\n\t * @return\tmixed\n\t */\n\tpublic function unbuffered_row($type = 'object')\n\t{\n\t\tif ($type === 'array')\n\t\t{\n\t\t\treturn $this->_fetch_assoc();\n\t\t}\n\t\telseif ($type === 'object')\n\t\t{\n\t\t\treturn $this->_fetch_object();\n\t\t}\n\n\t\treturn $this->_fetch_object($type);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * The following methods are normally overloaded by the identically named\n\t * methods in the platform-specific driver -- except when query caching\n\t * is used. When caching is enabled we do not load the other driver.\n\t * These functions are primarily here to prevent undefined function errors\n\t * when a cached result object is in use. They are not otherwise fully\n\t * operational due to the unavailability of the database resource IDs with\n\t * cached results.\n\t */\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn 0;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names.\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\treturn array();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data.\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\treturn array();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\t$this->result_id = FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @param\tint\t$n\n\t * @return\tbool\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array.\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn array();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object.\n\t *\n\t * Overridden by driver result classes.\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn new $class_name();\n\t}\n\n}\n" }, { "path": "system/database/DB_utility.php", "content": "db =& $db;\n\t\tlog_message('info', 'Database Utility Class Initialized');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List databases\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_databases()\n\t{\n\t\t// Is there a cached result?\n\t\tif (isset($this->db->data_cache['db_names']))\n\t\t{\n\t\t\treturn $this->db->data_cache['db_names'];\n\t\t}\n\t\telseif ($this->_list_databases === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\t$this->db->data_cache['db_names'] = array();\n\n\t\t$query = $this->db->query($this->_list_databases);\n\t\tif ($query === FALSE)\n\t\t{\n\t\t\treturn $this->db->data_cache['db_names'];\n\t\t}\n\n\t\tfor ($i = 0, $query = $query->result_array(), $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$this->db->data_cache['db_names'][] = current($query[$i]);\n\t\t}\n\n\t\treturn $this->db->data_cache['db_names'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determine if a particular database exists\n\t *\n\t * @param\tstring\t$database_name\n\t * @return\tbool\n\t */\n\tpublic function database_exists($database_name)\n\t{\n\t\treturn in_array($database_name, $this->list_databases());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Optimize Table\n\t *\n\t * @param\tstring\t$table_name\n\t * @return\tmixed\n\t */\n\tpublic function optimize_table($table_name)\n\t{\n\t\tif ($this->_optimize_table === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\t$query = $this->db->query(sprintf($this->_optimize_table, $this->db->escape_identifiers($table_name)));\n\t\tif ($query !== FALSE)\n\t\t{\n\t\t\t$query = $query->result_array();\n\t\t\treturn current($query);\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Optimize Database\n\t *\n\t * @return\tmixed\n\t */\n\tpublic function optimize_database()\n\t{\n\t\tif ($this->_optimize_table === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\t$result = array();\n\t\tforeach ($this->db->list_tables() as $table_name)\n\t\t{\n\t\t\t$res = $this->db->query(sprintf($this->_optimize_table, $this->db->escape_identifiers($table_name)));\n\t\t\tif (is_bool($res))\n\t\t\t{\n\t\t\t\treturn $res;\n\t\t\t}\n\n\t\t\t// Build the result array...\n\t\t\t$res = $res->result_array();\n\t\t\t$res = current($res);\n\t\t\t$key = str_replace($this->db->database.'.', '', current($res));\n\t\t\t$keys = array_keys($res);\n\t\t\tunset($res[$keys[0]]);\n\n\t\t\t$result[$key] = $res;\n\t\t}\n\n\t\treturn $result;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Repair Table\n\t *\n\t * @param\tstring\t$table_name\n\t * @return\tmixed\n\t */\n\tpublic function repair_table($table_name)\n\t{\n\t\tif ($this->_repair_table === FALSE)\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unsupported_feature') : FALSE;\n\t\t}\n\n\t\t$query = $this->db->query(sprintf($this->_repair_table, $this->db->escape_identifiers($table_name)));\n\t\tif (is_bool($query))\n\t\t{\n\t\t\treturn $query;\n\t\t}\n\n\t\t$query = $query->result_array();\n\t\treturn current($query);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Generate CSV from a query result object\n\t *\n\t * @param\tobject\t$query\t\tQuery result object\n\t * @param\tstring\t$delim\t\tDelimiter (default: ,)\n\t * @param\tstring\t$newline\tNewline character (default: \\n)\n\t * @param\tstring\t$enclosure\tEnclosure (default: \")\n\t * @return\tstring\n\t */\n\tpublic function csv_from_result(CI_DB_result $query, $delim = ',', $newline = \"\\n\", $enclosure = '\"')\n\t{\n\t\t$out = '';\n\t\t// First generate the headings from the table column names\n\t\tforeach ($query->list_fields() as $name)\n\t\t{\n\t\t\t$out .= $enclosure.str_replace($enclosure, $enclosure.$enclosure, $name).$enclosure.$delim;\n\t\t}\n\n\t\t$out = substr($out, 0, -strlen($delim)).$newline;\n\n\t\t// Next blast through the result array and build out the rows\n\t\twhile ($row = $query->unbuffered_row('array'))\n\t\t{\n\t\t\t$line = array();\n\t\t\tforeach ($row as $item)\n\t\t\t{\n\t\t\t\t$line[] = $enclosure.str_replace($enclosure, $enclosure.$enclosure, (string) $item).$enclosure;\n\t\t\t}\n\t\t\t$out .= implode($delim, $line).$newline;\n\t\t}\n\n\t\treturn $out;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Generate XML data from a query result object\n\t *\n\t * @param\tobject\t$query\tQuery result object\n\t * @param\tarray\t$params\tAny preferences\n\t * @return\tstring\n\t */\n\tpublic function xml_from_result(CI_DB_result $query, $params = array())\n\t{\n\t\t// Set our default values\n\t\tforeach (array('root' => 'root', 'element' => 'element', 'newline' => \"\\n\", 'tab' => \"\\t\") as $key => $val)\n\t\t{\n\t\t\tif ( ! isset($params[$key]))\n\t\t\t{\n\t\t\t\t$params[$key] = $val;\n\t\t\t}\n\t\t}\n\n\t\t// Create variables for convenience\n\t\textract($params);\n\n\t\t// Load the xml helper\n\t\tget_instance()->load->helper('xml');\n\n\t\t// Generate the result\n\t\t$xml = '<'.$root.'>'.$newline;\n\t\twhile ($row = $query->unbuffered_row())\n\t\t{\n\t\t\t$xml .= $tab.'<'.$element.'>'.$newline;\n\t\t\tforeach ($row as $key => $val)\n\t\t\t{\n\t\t\t\t$xml .= $tab.$tab.'<'.$key.'>'.xml_convert($val).''.$newline;\n\t\t\t}\n\t\t\t$xml .= $tab.''.$newline;\n\t\t}\n\n\t\treturn $xml.''.$newline;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database Backup\n\t *\n\t * @param\tarray\t$params\n\t * @return\tstring\n\t */\n\tpublic function backup($params = array())\n\t{\n\t\t// If the parameters have not been submitted as an\n\t\t// array then we know that it is simply the table\n\t\t// name, which is a valid short cut.\n\t\tif (is_string($params))\n\t\t{\n\t\t\t$params = array('tables' => $params);\n\t\t}\n\n\t\t// Set up our default preferences\n\t\t$prefs = array(\n\t\t\t'tables'\t\t=> array(),\n\t\t\t'ignore'\t\t=> array(),\n\t\t\t'filename'\t\t=> '',\n\t\t\t'format'\t\t=> 'gzip', // gzip, zip, txt\n\t\t\t'add_drop'\t\t=> TRUE,\n\t\t\t'add_insert'\t\t=> TRUE,\n\t\t\t'newline'\t\t=> \"\\n\",\n\t\t\t'foreign_key_checks'\t=> TRUE\n\t\t);\n\n\t\t// Did the user submit any preferences? If so set them....\n\t\tif (count($params) > 0)\n\t\t{\n\t\t\tforeach ($prefs as $key => $val)\n\t\t\t{\n\t\t\t\tif (isset($params[$key]))\n\t\t\t\t{\n\t\t\t\t\t$prefs[$key] = $params[$key];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Are we backing up a complete database or individual tables?\n\t\t// If no table names were submitted we'll fetch the entire table list\n\t\tif (count($prefs['tables']) === 0)\n\t\t{\n\t\t\t$prefs['tables'] = $this->db->list_tables();\n\t\t}\n\n\t\t// Validate the format\n\t\tif ( ! in_array($prefs['format'], array('gzip', 'zip', 'txt'), TRUE))\n\t\t{\n\t\t\t$prefs['format'] = 'txt';\n\t\t}\n\n\t\t// Is the encoder supported? If not, we'll either issue an\n\t\t// error or use plain text depending on the debug settings\n\t\tif (($prefs['format'] === 'gzip' && ! function_exists('gzencode'))\n\t\t\tOR ($prefs['format'] === 'zip' && ! function_exists('gzcompress')))\n\t\t{\n\t\t\tif ($this->db->db_debug)\n\t\t\t{\n\t\t\t\treturn $this->db->display_error('db_unsupported_compression');\n\t\t\t}\n\n\t\t\t$prefs['format'] = 'txt';\n\t\t}\n\n\t\t// Was a Zip file requested?\n\t\tif ($prefs['format'] === 'zip')\n\t\t{\n\t\t\t// Set the filename if not provided (only needed with Zip files)\n\t\t\tif ($prefs['filename'] === '')\n\t\t\t{\n\t\t\t\t$prefs['filename'] = (count($prefs['tables']) === 1 ? $prefs['tables'] : $this->db->database)\n\t\t\t\t\t\t\t.date('Y-m-d_H-i', time()).'.sql';\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// If they included the .zip file extension we'll remove it\n\t\t\t\tif (preg_match('|.+?\\.zip$|', $prefs['filename']))\n\t\t\t\t{\n\t\t\t\t\t$prefs['filename'] = str_replace('.zip', '', $prefs['filename']);\n\t\t\t\t}\n\n\t\t\t\t// Tack on the \".sql\" file extension if needed\n\t\t\t\tif ( ! preg_match('|.+?\\.sql$|', $prefs['filename']))\n\t\t\t\t{\n\t\t\t\t\t$prefs['filename'] .= '.sql';\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Load the Zip class and output it\n\t\t\t$CI =& get_instance();\n\t\t\t$CI->load->library('zip');\n\t\t\t$CI->zip->add_data($prefs['filename'], $this->_backup($prefs));\n\t\t\treturn $CI->zip->get_zip();\n\t\t}\n\t\telseif ($prefs['format'] === 'txt') // Was a text file requested?\n\t\t{\n\t\t\treturn $this->_backup($prefs);\n\t\t}\n\t\telseif ($prefs['format'] === 'gzip') // Was a Gzip file requested?\n\t\t{\n\t\t\treturn gzencode($this->_backup($prefs));\n\t\t}\n\n\t\treturn;\n\t}\n\n}\n" }, { "path": "system/database/drivers/cubrid/cubrid_driver.php", "content": "dsn, $matches))\n\t\t{\n\t\t\tif (stripos($matches[2], 'autocommit=off') !== FALSE)\n\t\t\t{\n\t\t\t\t$this->auto_commit = FALSE;\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// If no port is defined by the user, use the default value\n\t\t\tempty($this->port) OR $this->port = 33000;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Non-persistent database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tresource\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tif (preg_match('/^CUBRID:[^:]+(:[0-9][1-9]{0,4})?:[^:]+:([^:]*):([^:]*):(\\?.+)?$/', $this->dsn, $matches))\n\t\t{\n\t\t\t$func = ($persistent !== TRUE) ? 'cubrid_connect_with_url' : 'cubrid_pconnect_with_url';\n\t\t\treturn ($matches[2] === '' && $matches[3] === '' && $this->username !== '' && $this->password !== '')\n\t\t\t\t? $func($this->dsn, $this->username, $this->password)\n\t\t\t\t: $func($this->dsn);\n\t\t}\n\n\t\t$func = ($persistent !== TRUE) ? 'cubrid_connect' : 'cubrid_pconnect';\n\t\treturn ($this->username !== '')\n\t\t\t? $func($this->hostname, $this->port, $this->database, $this->username, $this->password)\n\t\t\t: $func($this->hostname, $this->port, $this->database);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reconnect\n\t *\n\t * Keep / reestablish the db connection if no queries have been\n\t * sent for a length of time exceeding the server's idle timeout\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function reconnect()\n\t{\n\t\tif (cubrid_ping($this->conn_id) === FALSE)\n\t\t{\n\t\t\t$this->conn_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\treturn ( ! $this->conn_id OR ($version = cubrid_get_server_info($this->conn_id)) === FALSE)\n\t\t\t? FALSE\n\t\t\t: $this->data_cache['version'] = $version;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tresource\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn cubrid_query($sql, $this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\tif (($autocommit = cubrid_get_autocommit($this->conn_id)) === NULL)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\telseif ($autocommit === TRUE)\n\t\t{\n\t\t\treturn cubrid_set_autocommit($this->conn_id, CUBRID_AUTOCOMMIT_FALSE);\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\tif ( ! cubrid_commit($this->conn_id))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ($this->auto_commit && ! cubrid_get_autocommit($this->conn_id))\n\t\t{\n\t\t\treturn cubrid_set_autocommit($this->conn_id, CUBRID_AUTOCOMMIT_TRUE);\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\tif ( ! cubrid_rollback($this->conn_id))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ($this->auto_commit && ! cubrid_get_autocommit($this->conn_id))\n\t\t{\n\t\t\tcubrid_set_autocommit($this->conn_id, CUBRID_AUTOCOMMIT_TRUE);\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\treturn cubrid_real_escape_string($str, $this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn cubrid_affected_rows();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tint\n\t */\n\tpublic function insert_id()\n\t{\n\t\treturn cubrid_insert_id($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SHOW TABLES';\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%'\";\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE))) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->Field;\n\n\t\t\tsscanf($query[$i]->Type, '%[a-z](%d)',\n\t\t\t\t$retval[$i]->type,\n\t\t\t\t$retval[$i]->max_length\n\t\t\t);\n\n\t\t\t$retval[$i]->default\t\t= $query[$i]->Default;\n\t\t\t$retval[$i]->primary_key\t= (int) ($query[$i]->Key === 'PRI');\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => cubrid_errno($this->conn_id), 'message' => cubrid_error($this->conn_id));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * FROM tables\n\t *\n\t * Groups tables in FROM clauses if needed, so there is no confusion\n\t * about operator precedence.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _from_tables()\n\t{\n\t\tif ( ! empty($this->qb_join) && count($this->qb_from) > 1)\n\t\t{\n\t\t\treturn '('.implode(', ', $this->qb_from).')';\n\t\t}\n\n\t\treturn implode(', ', $this->qb_from);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\tcubrid_close($this->conn_id);\n\t}\n\n}\n" }, { "path": "system/database/drivers/cubrid/cubrid_forge.php", "content": " 'INTEGER',\n\t\t'SMALLINT'\t=> 'INTEGER',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'INTEGER'\t=> 'BIGINT',\n\t\t'BIGINT'\t=> 'NUMERIC',\n\t\t'FLOAT'\t\t=> 'DOUBLE',\n\t\t'REAL'\t\t=> 'DOUBLE'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('DROP', 'ADD'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' CHANGE '.$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$alter_type = empty($field[$i]['new_name']) ? ' MODIFY ' : ' CHANGE ';\n\t\t\t\t$sqls[] = $sql.$alter_type.$this->_process_column($field[$i]);\n\t\t\t}\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\t$extra_clause = isset($field['after'])\n\t\t\t? ' AFTER '.$this->db->escape_identifiers($field['after']) : '';\n\n\t\tif (empty($extra_clause) && isset($field['first']) && $field['first'] === TRUE)\n\t\t{\n\t\t\t$extra_clause = ' FIRST';\n\t\t}\n\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.(empty($field['new_name']) ? '' : ' '.$this->db->escape_identifiers($field['new_name']))\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['null']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['unique']\n\t\t\t.$extra_clause;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'LONGTEXT':\n\t\t\t\t$attributes['TYPE'] = 'STRING';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process indexes\n\t *\n\t * @param\tstring\t$table\t(ignored)\n\t * @return\tstring\n\t */\n\tprotected function _process_indexes($table)\n\t{\n\t\t$sql = '';\n\n\t\tfor ($i = 0, $c = count($this->keys); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_array($this->keys[$i]))\n\t\t\t{\n\t\t\t\tfor ($i2 = 0, $c2 = count($this->keys[$i]); $i2 < $c2; $i2++)\n\t\t\t\t{\n\t\t\t\t\tif ( ! isset($this->fields[$this->keys[$i][$i2]]))\n\t\t\t\t\t{\n\t\t\t\t\t\tunset($this->keys[$i][$i2]);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! isset($this->fields[$this->keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->keys[$i]);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tis_array($this->keys[$i]) OR $this->keys[$i] = array($this->keys[$i]);\n\n\t\t\t$sql .= \",\\n\\tKEY \".$this->db->escape_identifiers(implode('_', $this->keys[$i]))\n\t\t\t\t.' ('.implode(', ', $this->db->escape_identifiers($this->keys[$i])).')';\n\t\t}\n\n\t\t$this->keys = array();\n\n\t\treturn $sql;\n\t}\n\n}\n" }, { "path": "system/database/drivers/cubrid/cubrid_result.php", "content": "num_rows)\n\t\t\t? $this->num_rows\n\t\t\t: $this->num_rows = cubrid_num_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn cubrid_num_fields($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\treturn cubrid_column_names($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= cubrid_field_name($this->result_id, $i);\n\t\t\t$retval[$i]->type\t\t= cubrid_field_type($this->result_id, $i);\n\t\t\t$retval[$i]->max_length\t\t= cubrid_field_len($this->result_id, $i);\n\t\t\t$retval[$i]->primary_key\t= (int) (strpos(cubrid_field_flags($this->result_id, $i), 'primary_key') !== FALSE);\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_resource($this->result_id) OR\n\t\t\t(get_resource_type($this->result_id) === 'Unknown' && preg_match('/Resource id #/', strval($this->result_id))))\n\t\t{\n\t\t\tcubrid_close_request($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * @param\tint\t$n\n\t * @return\tbool\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\treturn cubrid_data_seek($this->result_id, $n);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn cubrid_fetch_assoc($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn cubrid_fetch_object($this->result_id, $class_name);\n\t}\n\n}\n" }, { "path": "system/database/drivers/cubrid/cubrid_utility.php", "content": "db->data_cache['db_names']))\n\t\t{\n\t\t\treturn $this->db->data_cache['db_names'];\n\t\t}\n\n\t\treturn $this->db->data_cache['db_names'] = cubrid_list_dbs($this->db->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * CUBRID Export\n\t *\n\t * @param\tarray\tPreferences\n\t * @return\tmixed\n\t */\n\tprotected function _backup($params = array())\n\t{\n\t\t// No SQL based support in CUBRID as of version 8.4.0. Database or\n\t\t// table backup can be performed using CUBRID Manager\n\t\t// database administration tool.\n\t\treturn $this->db->display_error('db_unsupported_feature');\n\t}\n}\n" }, { "path": "system/database/drivers/cubrid/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/ibase/ibase_driver.php", "content": "hostname.':'.$this->database, $this->username, $this->password, $this->char_set)\n\t\t\t: ibase_connect($this->hostname.':'.$this->database, $this->username, $this->password, $this->char_set);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\tif (($service = ibase_service_attach($this->hostname, $this->username, $this->password)))\n\t\t{\n\t\t\t$this->data_cache['version'] = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);\n\n\t\t\t// Don't keep the service open\n\t\t\tibase_service_detach($service);\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tresource\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn ibase_query(isset($this->_ibase_trans) ? $this->_ibase_trans : $this->conn_id, $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\tif (($trans_handle = ibase_trans($this->conn_id)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$this->_ibase_trans = $trans_handle;\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\tif (ibase_commit($this->_ibase_trans))\n\t\t{\n\t\t\t$this->_ibase_trans = NULL;\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\tif (ibase_rollback($this->_ibase_trans))\n\t\t{\n\t\t\t$this->_ibase_trans = NULL;\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn ibase_affected_rows($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @param\tstring\t$generator_name\n\t * @param\tint\t$inc_by\n\t * @return\tint\n\t */\n\tpublic function insert_id($generator_name, $inc_by = 0)\n\t{\n\t\t//If a generator hasn't been used before it will return 0\n\t\treturn ibase_gen_id('\"'.$generator_name.'\"', $inc_by);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT TRIM(\"RDB$RELATION_NAME\") AS TABLE_NAME FROM \"RDB$RELATIONS\" WHERE \"RDB$RELATION_NAME\" NOT LIKE \\'RDB$%\\' AND \"RDB$RELATION_NAME\" NOT LIKE \\'MON$%\\'';\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' AND TRIM(\"RDB$RELATION_NAME\") AS TABLE_NAME LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT TRIM(\"RDB$FIELD_NAME\") AS COLUMN_NAME FROM \"RDB$RELATION_FIELDS\" WHERE \"RDB$RELATION_NAME\" = '.$this->escape($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT \"rfields\".\"RDB$FIELD_NAME\" AS \"name\",\n\t\t\t\tCASE \"fields\".\"RDB$FIELD_TYPE\"\n\t\t\t\t\tWHEN 7 THEN \\'SMALLINT\\'\n\t\t\t\t\tWHEN 8 THEN \\'INTEGER\\'\n\t\t\t\t\tWHEN 9 THEN \\'QUAD\\'\n\t\t\t\t\tWHEN 10 THEN \\'FLOAT\\'\n\t\t\t\t\tWHEN 11 THEN \\'DFLOAT\\'\n\t\t\t\t\tWHEN 12 THEN \\'DATE\\'\n\t\t\t\t\tWHEN 13 THEN \\'TIME\\'\n\t\t\t\t\tWHEN 14 THEN \\'CHAR\\'\n\t\t\t\t\tWHEN 16 THEN \\'INT64\\'\n\t\t\t\t\tWHEN 27 THEN \\'DOUBLE\\'\n\t\t\t\t\tWHEN 35 THEN \\'TIMESTAMP\\'\n\t\t\t\t\tWHEN 37 THEN \\'VARCHAR\\'\n\t\t\t\t\tWHEN 40 THEN \\'CSTRING\\'\n\t\t\t\t\tWHEN 261 THEN \\'BLOB\\'\n\t\t\t\t\tELSE NULL\n\t\t\t\tEND AS \"type\",\n\t\t\t\t\"fields\".\"RDB$FIELD_LENGTH\" AS \"max_length\",\n\t\t\t\t\"rfields\".\"RDB$DEFAULT_VALUE\" AS \"default\"\n\t\t\tFROM \"RDB$RELATION_FIELDS\" \"rfields\"\n\t\t\t\tJOIN \"RDB$FIELDS\" \"fields\" ON \"rfields\".\"RDB$FIELD_SOURCE\" = \"fields\".\"RDB$FIELD_NAME\"\n\t\t\tWHERE \"rfields\".\"RDB$RELATION_NAME\" = '.$this->escape($table).'\n\t\t\tORDER BY \"rfields\".\"RDB$FIELD_POSITION\"';\n\n\t\treturn (($query = $this->query($sql)) !== FALSE)\n\t\t\t? $query->result_object()\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => ibase_errcode(), 'message' => ibase_errmsg());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'DELETE FROM '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t// Limit clause depends on if Interbase or Firebird\n\t\tif (stripos($this->version(), 'firebird') !== FALSE)\n\t\t{\n\t\t\t$select = 'FIRST '.$this->qb_limit\n\t\t\t\t.($this->qb_offset ? ' SKIP '.$this->qb_offset : '');\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$select = 'ROWS '\n\t\t\t\t.($this->qb_offset ? $this->qb_offset.' TO '.($this->qb_limit + $this->qb_offset) : $this->qb_limit);\n\t\t}\n\n\t\treturn preg_replace('`SELECT`i', 'SELECT '.$select, $sql, 1);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring|bool\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\tibase_close($this->conn_id);\n\t}\n\n}\n" }, { "path": "system/database/drivers/ibase/ibase_forge.php", "content": " 'INTEGER',\n\t\t'INTEGER'\t=> 'INT64',\n\t\t'FLOAT'\t\t=> 'DOUBLE PRECISION'\n\t);\n\n\t/**\n\t * NULL value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_null\t\t= 'NULL';\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create database\n\t *\n\t * @param\tstring\t$db_name\n\t * @return\tbool\n\t */\n\tpublic function create_database($db_name)\n\t{\n\t\t// Firebird databases are flat files, so a path is required\n\n\t\t// Hostname is needed for remote access\n\t\tempty($this->db->hostname) OR $db_name = $this->hostname.':'.$db_name;\n\n\t\treturn parent::create_database('\"'.$db_name.'\"');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop database\n\t *\n\t * @param\tstring\t$db_name\t(ignored)\n\t * @return\tbool\n\t */\n\tpublic function drop_database($db_name)\n\t{\n\t\tif ( ! ibase_drop_db($this->conn_id))\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t\t}\n\t\telseif ( ! empty($this->db->data_cache['db_names']))\n\t\t{\n\t\t\t$key = array_search(strtolower($this->db->database), array_map('strtolower', $this->db->data_cache['db_names']), TRUE);\n\t\t\tif ($key !== FALSE)\n\t\t\t{\n\t\t\t\tunset($this->db->data_cache['db_names'][$key]);\n\t\t\t}\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('DROP', 'ADD'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tif (isset($field[$i]['type']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identififers($field[$i]['name'])\n\t\t\t\t\t.' TYPE '.$field[$i]['type'].$field[$i]['length'];\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['default']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' SET DEFAULT '.$field[$i]['default'];\n\t\t\t}\n\n\t\t\tif (isset($field[$i]['null']))\n\t\t\t{\n\t\t\t\t$sqls[] = 'UPDATE \"RDB$RELATION_FIELDS\" SET \"RDB$NULL_FLAG\" = '\n\t\t\t\t\t.($field[$i]['null'] === TRUE ? 'NULL' : '1')\n\t\t\t\t\t.' WHERE \"RDB$FIELD_NAME\" = '.$this->db->escape($field[$i]['name'])\n\t\t\t\t\t.' AND \"RDB$RELATION_NAME\" = '.$this->db->escape($table);\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['new_name']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TO '.$this->db->escape_identifiers($field[$i]['new_name']);\n\t\t\t}\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['null']\n\t\t\t.$field['unique']\n\t\t\t.$field['default'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\treturn;\n\t\t\tcase 'BIGINT':\n\t\t\t\t$attributes['TYPE'] = 'INT64';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\t// Not supported\n\t}\n\n}\n" }, { "path": "system/database/drivers/ibase/ibase_result.php", "content": "result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tfor ($i = 0, $num_fields = $this->num_fields(); $i < $num_fields; $i++)\n\t\t{\n\t\t\t$info = ibase_field_info($this->result_id, $i);\n\t\t\t$field_names[] = $info['name'];\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$info = ibase_field_info($this->result_id, $i);\n\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $info['name'];\n\t\t\t$retval[$i]->type\t\t= $info['type'];\n\t\t\t$retval[$i]->max_length\t\t= $info['length'];\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tibase_free_result($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn ibase_fetch_assoc($this->result_id, IBASE_FETCH_BLOBS);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\t$row = ibase_fetch_object($this->result_id, IBASE_FETCH_BLOBS);\n\n\t\tif ($class_name === 'stdClass' OR ! $row)\n\t\t{\n\t\t\treturn $row;\n\t\t}\n\n\t\t$class_name = new $class_name();\n\t\tforeach ($row as $key => $value)\n\t\t{\n\t\t\t$class_name->$key = $value;\n\t\t}\n\n\t\treturn $class_name;\n\t}\n\n}\n" }, { "path": "system/database/drivers/ibase/ibase_utility.php", "content": "db->hostname, $this->db->username, $this->db->password))\n\t\t{\n\t\t\t$res = ibase_backup($service, $this->db->database, $filename.'.fbk');\n\n\t\t\t// Close the service connection\n\t\t\tibase_service_detach($service);\n\t\t\treturn $res;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n}\n" }, { "path": "system/database/drivers/ibase/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/mssql/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/mssql/mssql_driver.php", "content": "port))\n\t\t{\n\t\t\t$this->hostname .= (DIRECTORY_SEPARATOR === '\\\\' ? ',' : ':').$this->port;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Non-persistent database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tresource\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tini_set('mssql.charset', $this->char_set);\n\t\t$this->conn_id = ($persistent)\n\t\t\t\t? mssql_pconnect($this->hostname, $this->username, $this->password)\n\t\t\t\t: mssql_connect($this->hostname, $this->username, $this->password);\n\n\t\tif ( ! $this->conn_id)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t// ----------------------------------------------------------------\n\n\t\t// Select the DB... assuming a database name is specified in the config file\n\t\tif ($this->database !== '' && ! $this->db_select())\n\t\t{\n\t\t\tlog_message('error', 'Unable to select database: '.$this->database);\n\n\t\t\treturn ($this->db_debug === TRUE)\n\t\t\t\t? $this->display_error('db_unable_to_select', $this->database)\n\t\t\t\t: FALSE;\n\t\t}\n\n\t\t// Determine how identifiers are escaped\n\t\t$query = $this->query('SELECT CASE WHEN (@@OPTIONS | 256) = @@OPTIONS THEN 1 ELSE 0 END AS qi');\n\t\t$query = $query->row_array();\n\t\t$this->_quoted_identifier = empty($query) ? FALSE : (bool) $query['qi'];\n\t\t$this->_escape_char = ($this->_quoted_identifier) ? '\"' : array('[', ']');\n\n\t\treturn $this->conn_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select the database\n\t *\n\t * @param\tstring\t$database\n\t * @return\tbool\n\t */\n\tpublic function db_select($database = '')\n\t{\n\t\tif ($database === '')\n\t\t{\n\t\t\t$database = $this->database;\n\t\t}\n\n\t\t// Note: Escaping is required in the event that the DB name\n\t\t// contains reserved characters.\n\t\tif (mssql_select_db('['.$database.']', $this->conn_id))\n\t\t{\n\t\t\t$this->database = $database;\n\t\t\t$this->data_cache = array();\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tmixed\tresource if rows are returned, bool otherwise\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn mssql_query($sql, $this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\treturn $this->simple_query('BEGIN TRAN');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\treturn $this->simple_query('COMMIT TRAN');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\treturn $this->simple_query('ROLLBACK TRAN');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn mssql_rows_affected($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * Returns the last id created in the Identity column.\n\t *\n\t * @return\tstring\n\t */\n\tpublic function insert_id()\n\t{\n\t\t$query = version_compare($this->version(), '8', '>=')\n\t\t\t? 'SELECT SCOPE_IDENTITY() AS last_id'\n\t\t\t: 'SELECT @@IDENTITY AS last_id';\n\n\t\t$query = $this->query($query);\n\t\t$query = $query->row();\n\t\treturn $query->last_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Version number query string\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _version()\n\t{\n\t\treturn \"SELECT SERVERPROPERTY('ProductVersion') AS ver\";\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT '.$this->escape_identifiers('name')\n\t\t\t.' FROM '.$this->escape_identifiers('sysobjects')\n\t\t\t.' WHERE '.$this->escape_identifiers('type').\" = 'U'\";\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' AND '.$this->escape_identifiers('name').\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql.' ORDER BY '.$this->escape_identifiers('name');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT COLUMN_NAME\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT COLUMN_NAME, DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, NUMERIC_PRECISION, COLUMN_DEFAULT\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->COLUMN_NAME;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->DATA_TYPE;\n\t\t\t$retval[$i]->max_length\t\t= ($query[$i]->CHARACTER_MAXIMUM_LENGTH > 0) ? $query[$i]->CHARACTER_MAXIMUM_LENGTH : $query[$i]->NUMERIC_PRECISION;\n\t\t\t$retval[$i]->default\t\t= $query[$i]->COLUMN_DEFAULT;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\t// We need this because the error info is discarded by the\n\t\t// server the first time you request it, and query() already\n\t\t// calls error() once for logging purposes when a query fails.\n\t\tstatic $error = array('code' => 0, 'message' => NULL);\n\n\t\t$message = mssql_get_last_message();\n\t\tif ( ! empty($message))\n\t\t{\n\t\t\t$error['code'] = $this->query('SELECT @@ERROR AS code')->row()->code;\n\t\t\t$error['message'] = $message;\n\t\t}\n\n\t\treturn $error;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE TABLE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\tif ($this->qb_limit)\n\t\t{\n\t\t\treturn 'WITH ci_delete AS (SELECT TOP '.$this->qb_limit.' * FROM '.$table.$this->_compile_wh('qb_where').') DELETE FROM ci_delete';\n\t\t}\n\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t$limit = $this->qb_offset + $this->qb_limit;\n\n\t\t// As of SQL Server 2005 (9.0.*) ROW_NUMBER() is supported,\n\t\t// however an ORDER BY clause is required for it to work\n\t\tif (version_compare($this->version(), '9', '>=') && $this->qb_offset && ! empty($this->qb_orderby))\n\t\t{\n\t\t\t$orderby = $this->_compile_order_by();\n\n\t\t\t// We have to strip the ORDER BY clause\n\t\t\t$sql = trim(substr($sql, 0, strrpos($sql, $orderby)));\n\n\t\t\t// Get the fields to select from our subquery, so that we can avoid CI_rownum appearing in the actual results\n\t\t\tif (count($this->qb_select) === 0 OR strpos(implode(',', $this->qb_select), '*') !== FALSE)\n\t\t\t{\n\t\t\t\t$select = '*'; // Inevitable\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Use only field names and their aliases, everything else is out of our scope.\n\t\t\t\t$select = array();\n\t\t\t\t$field_regexp = ($this->_quoted_identifier)\n\t\t\t\t\t? '(\"[^\\\"]+\")' : '(\\[[^\\]]+\\])';\n\t\t\t\tfor ($i = 0, $c = count($this->qb_select); $i < $c; $i++)\n\t\t\t\t{\n\t\t\t\t\t$select[] = preg_match('/(?:\\s|\\.)'.$field_regexp.'$/i', $this->qb_select[$i], $m)\n\t\t\t\t\t\t? $m[1] : $this->qb_select[$i];\n\t\t\t\t}\n\t\t\t\t$select = implode(', ', $select);\n\t\t\t}\n\n\t\t\treturn 'SELECT '.$select.\" FROM (\\n\\n\"\n\t\t\t\t.preg_replace('/^(SELECT( DISTINCT)?)/i', '\\\\1 ROW_NUMBER() OVER('.trim($orderby).') AS '.$this->escape_identifiers('CI_rownum').', ', $sql)\n\t\t\t\t.\"\\n\\n) \".$this->escape_identifiers('CI_subquery')\n\t\t\t\t.\"\\nWHERE \".$this->escape_identifiers('CI_rownum').' BETWEEN '.($this->qb_offset + 1).' AND '.$limit;\n\t\t}\n\n\t\treturn preg_replace('/(^\\SELECT (DISTINCT)?)/i','\\\\1 TOP '.$limit.' ', $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring|bool\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\t// Multiple-value inserts are only supported as of SQL Server 2008\n\t\tif (version_compare($this->version(), '10', '>='))\n\t\t{\n\t\t\treturn parent::_insert_batch($table, $keys, $values);\n\t\t}\n\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\tmssql_close($this->conn_id);\n\t}\n\n}\n" }, { "path": "system/database/drivers/mssql/mssql_forge.php", "content": " 'SMALLINT',\n\t\t'SMALLINT'\t=> 'INT',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'REAL'\t\t=> 'FLOAT'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('ADD', 'DROP'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table).' ALTER COLUMN ';\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\t$sqls[] = $sql.$this->_process_column($field[$i]);\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tif (isset($attributes['CONSTRAINT']) && strpos($attributes['TYPE'], 'INT') !== FALSE)\n\t\t{\n\t\t\tunset($attributes['CONSTRAINT']);\n\t\t}\n\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INTEGER':\n\t\t\t\t$attributes['TYPE'] = 'INT';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['auto_increment'] = ' IDENTITY(1,1)';\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/mssql/mssql_result.php", "content": "num_rows)\n\t\t\t? $this->num_rows\n\t\t\t: $this->num_rows = mssql_num_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn mssql_num_fields($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tmssql_field_seek($this->result_id, 0);\n\t\twhile ($field = mssql_fetch_field($this->result_id))\n\t\t{\n\t\t\t$field_names[] = $field->name;\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$field = mssql_fetch_field($this->result_id, $i);\n\n\t\t\t$retval[$i]\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t= $field->name;\n\t\t\t$retval[$i]->type\t= $field->type;\n\t\t\t$retval[$i]->max_length\t= $field->max_length;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_resource($this->result_id))\n\t\t{\n\t\t\tmssql_free_result($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * @param\tint\t$n\n\t * @return\tbool\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\treturn mssql_data_seek($this->result_id, $n);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn mssql_fetch_assoc($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\t$row = mssql_fetch_object($this->result_id);\n\n\t\tif ($class_name === 'stdClass' OR ! $row)\n\t\t{\n\t\t\treturn $row;\n\t\t}\n\n\t\t$class_name = new $class_name();\n\t\tforeach ($row as $key => $value)\n\t\t{\n\t\t\t$class_name->$key = $value;\n\t\t}\n\n\t\treturn $class_name;\n\t}\n\n}\n" }, { "path": "system/database/drivers/mssql/mssql_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysql/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/mysql/mysql_driver.php", "content": "port))\n\t\t{\n\t\t\t$this->hostname .= ':'.$this->port;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Non-persistent database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tresource\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\t$client_flags = ($this->compress === FALSE) ? 0 : MYSQL_CLIENT_COMPRESS;\n\n\t\tif ($this->encrypt === TRUE)\n\t\t{\n\t\t\t$client_flags = $client_flags | MYSQL_CLIENT_SSL;\n\t\t}\n\n\t\t// Error suppression is necessary mostly due to PHP 5.5+ issuing E_DEPRECATED messages\n\t\t$this->conn_id = ($persistent === TRUE)\n\t\t\t? mysql_pconnect($this->hostname, $this->username, $this->password, $client_flags)\n\t\t\t: mysql_connect($this->hostname, $this->username, $this->password, TRUE, $client_flags);\n\n\t\t// ----------------------------------------------------------------\n\n\t\t// Select the DB... assuming a database name is specified in the config file\n\t\tif ($this->database !== '' && ! $this->db_select())\n\t\t{\n\t\t\tlog_message('error', 'Unable to select database: '.$this->database);\n\n\t\t\treturn ($this->db_debug === TRUE)\n\t\t\t\t? $this->display_error('db_unable_to_select', $this->database)\n\t\t\t\t: FALSE;\n\t\t}\n\n\t\tif (is_resource($this->conn_id))\n\t\t{\n\t\t\tif ( ! mysql_set_charset($this->char_set, $this->conn_id))\n\t\t\t{\n\t\t\t\tlog_message('error', \"Database: Unable to set the configured connection charset ('{$this->char_set}').\");\n\t\t\t\t$this->close();\n\t\t\t\treturn ($this->db->debug) ? $this->display_error('db_unable_to_set_charset', $this->char_set) : FALSE;\n\t\t\t}\n\n\t\t\tif (isset($this->stricton))\n\t\t\t{\n\t\t\t\tif ($this->stricton)\n\t\t\t\t{\n\t\t\t\t\t$this->simple_query('SET SESSION sql_mode = CONCAT(@@sql_mode, \",\", \"STRICT_ALL_TABLES\")');\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$this->simple_query(\n\t\t\t\t\t\t'SET SESSION sql_mode =\n\t\t\t\t\t\tREPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(\n\t\t\t\t\t\t@@sql_mode,\n\t\t\t\t\t\t\"STRICT_ALL_TABLES,\", \"\"),\n\t\t\t\t\t\t\",STRICT_ALL_TABLES\", \"\"),\n\t\t\t\t\t\t\"STRICT_ALL_TABLES\", \"\"),\n\t\t\t\t\t\t\"STRICT_TRANS_TABLES,\", \"\"),\n\t\t\t\t\t\t\",STRICT_TRANS_TABLES\", \"\"),\n\t\t\t\t\t\t\"STRICT_TRANS_TABLES\", \"\")'\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn $this->conn_id;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reconnect\n\t *\n\t * Keep / reestablish the db connection if no queries have been\n\t * sent for a length of time exceeding the server's idle timeout\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function reconnect()\n\t{\n\t\tif (mysql_ping($this->conn_id) === FALSE)\n\t\t{\n\t\t\t$this->conn_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select the database\n\t *\n\t * @param\tstring\t$database\n\t * @return\tbool\n\t */\n\tpublic function db_select($database = '')\n\t{\n\t\tif ($database === '')\n\t\t{\n\t\t\t$database = $this->database;\n\t\t}\n\n\t\tif (mysql_select_db($database, $this->conn_id))\n\t\t{\n\t\t\t$this->database = $database;\n\t\t\t$this->data_cache = array();\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\tif ( ! $this->conn_id OR ($version = mysql_get_server_info($this->conn_id)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn $this->data_cache['version'] = $version;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tmixed\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn mysql_query($this->_prep_query($sql), $this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Prep the query\n\t *\n\t * If needed, each database adapter can prep the query string\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tstring\n\t */\n\tprotected function _prep_query($sql)\n\t{\n\t\t// mysql_affected_rows() returns 0 for \"DELETE FROM TABLE\" queries. This hack\n\t\t// modifies the query so that it a proper number of affected rows is returned.\n\t\tif ($this->delete_hack === TRUE && preg_match('/^\\s*DELETE\\s+FROM\\s+(\\S+)\\s*$/i', $sql))\n\t\t{\n\t\t\treturn trim($sql).' WHERE 1=1';\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\t$this->simple_query('SET AUTOCOMMIT=0');\n\t\treturn $this->simple_query('START TRANSACTION'); // can also be BEGIN or BEGIN WORK\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\tif ($this->simple_query('COMMIT'))\n\t\t{\n\t\t\t$this->simple_query('SET AUTOCOMMIT=1');\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\tif ($this->simple_query('ROLLBACK'))\n\t\t{\n\t\t\t$this->simple_query('SET AUTOCOMMIT=1');\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\treturn mysql_real_escape_string($str, $this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn mysql_affected_rows($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tint\n\t */\n\tpublic function insert_id()\n\t{\n\t\treturn mysql_insert_id($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SHOW TABLES FROM '.$this->_escape_char.$this->database.$this->_escape_char;\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%'\";\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE))) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->Field;\n\n\t\t\tsscanf($query[$i]->Type, '%[a-z](%d)',\n\t\t\t\t$retval[$i]->type,\n\t\t\t\t$retval[$i]->max_length\n\t\t\t);\n\n\t\t\t$retval[$i]->default\t\t= $query[$i]->Default;\n\t\t\t$retval[$i]->primary_key\t= (int) ($query[$i]->Key === 'PRI');\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => mysql_errno($this->conn_id), 'message' => mysql_error($this->conn_id));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * FROM tables\n\t *\n\t * Groups tables in FROM clauses if needed, so there is no confusion\n\t * about operator precedence.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _from_tables()\n\t{\n\t\tif ( ! empty($this->qb_join) && count($this->qb_from) > 1)\n\t\t{\n\t\t\treturn '('.implode(', ', $this->qb_from).')';\n\t\t}\n\n\t\treturn implode(', ', $this->qb_from);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\t// Error suppression to avoid annoying E_WARNINGs in cases\n\t\t// where the connection has already been closed for some reason.\n\t\t@mysql_close($this->conn_id);\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysql/mysql_forge.php", "content": "db->char_set) && ! strpos($sql, 'CHARACTER SET') && ! strpos($sql, 'CHARSET'))\n\t\t{\n\t\t\t$sql .= ' DEFAULT CHARACTER SET = '.$this->db->char_set;\n\t\t}\n\n\t\tif ( ! empty($this->db->dbcollat) && ! strpos($sql, 'COLLATE'))\n\t\t{\n\t\t\t$sql .= ' COLLATE = '.$this->db->dbcollat;\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'DROP')\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$field[$i] = ($alter_type === 'ADD')\n\t\t\t\t\t\t? \"\\n\\tADD \".$field[$i]['_literal']\n\t\t\t\t\t\t: \"\\n\\tMODIFY \".$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tif ($alter_type === 'ADD')\n\t\t\t\t{\n\t\t\t\t\t$field[$i]['_literal'] = \"\\n\\tADD \";\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$field[$i]['_literal'] = empty($field[$i]['new_name']) ? \"\\n\\tMODIFY \" : \"\\n\\tCHANGE \";\n\t\t\t\t}\n\n\t\t\t\t$field[$i] = $field[$i]['_literal'].$this->_process_column($field[$i]);\n\t\t\t}\n\t\t}\n\n\t\treturn array($sql.implode(',', $field));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\t$extra_clause = isset($field['after'])\n\t\t\t? ' AFTER '.$this->db->escape_identifiers($field['after']) : '';\n\n\t\tif (empty($extra_clause) && isset($field['first']) && $field['first'] === TRUE)\n\t\t{\n\t\t\t$extra_clause = ' FIRST';\n\t\t}\n\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.(empty($field['new_name']) ? '' : ' '.$this->db->escape_identifiers($field['new_name']))\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['null']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['unique']\n\t\t\t.(empty($field['comment']) ? '' : ' COMMENT '.$field['comment'])\n\t\t\t.$extra_clause;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process indexes\n\t *\n\t * @param\tstring\t$table\t(ignored)\n\t * @return\tstring\n\t */\n\tprotected function _process_indexes($table)\n\t{\n\t\t$sql = '';\n\n\t\tfor ($i = 0, $c = count($this->keys); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_array($this->keys[$i]))\n\t\t\t{\n\t\t\t\tfor ($i2 = 0, $c2 = count($this->keys[$i]); $i2 < $c2; $i2++)\n\t\t\t\t{\n\t\t\t\t\tif ( ! isset($this->fields[$this->keys[$i][$i2]]))\n\t\t\t\t\t{\n\t\t\t\t\t\tunset($this->keys[$i][$i2]);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! isset($this->fields[$this->keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->keys[$i]);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tis_array($this->keys[$i]) OR $this->keys[$i] = array($this->keys[$i]);\n\n\t\t\t$sql .= \",\\n\\tKEY \".$this->db->escape_identifiers(implode('_', $this->keys[$i]))\n\t\t\t\t.' ('.implode(', ', $this->db->escape_identifiers($this->keys[$i])).')';\n\t\t}\n\n\t\t$this->keys = array();\n\n\t\treturn $sql;\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysql/mysql_result.php", "content": "num_rows = mysql_num_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of rows in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_rows()\n\t{\n\t\treturn $this->num_rows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn mysql_num_fields($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tmysql_field_seek($this->result_id, 0);\n\t\twhile ($field = mysql_fetch_field($this->result_id))\n\t\t{\n\t\t\t$field_names[] = $field->name;\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= mysql_field_name($this->result_id, $i);\n\t\t\t$retval[$i]->type\t\t= mysql_field_type($this->result_id, $i);\n\t\t\t$retval[$i]->max_length\t\t= mysql_field_len($this->result_id, $i);\n\t\t\t$retval[$i]->primary_key\t= (int) (strpos(mysql_field_flags($this->result_id, $i), 'primary_key') !== FALSE);\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_resource($this->result_id))\n\t\t{\n\t\t\tmysql_free_result($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * @param\tint\t$n\n\t * @return\tbool\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\treturn $this->num_rows\n\t\t\t? mysql_data_seek($this->result_id, $n)\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn mysql_fetch_assoc($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn mysql_fetch_object($this->result_id, $class_name);\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysql/mysql_utility.php", "content": "db->query('SHOW CREATE TABLE '.$this->db->escape_identifiers($this->db->database.'.'.$table));\n\n\t\t\t// No result means the table name was invalid\n\t\t\tif ($query === FALSE)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Write out the table schema\n\t\t\t$output .= '#'.$newline.'# TABLE STRUCTURE FOR: '.$table.$newline.'#'.$newline.$newline;\n\n\t\t\tif ($add_drop === TRUE)\n\t\t\t{\n\t\t\t\t$output .= 'DROP TABLE IF EXISTS '.$this->db->protect_identifiers($table).';'.$newline.$newline;\n\t\t\t}\n\n\t\t\t$i = 0;\n\t\t\t$result = $query->result_array();\n\t\t\tforeach ($result[0] as $val)\n\t\t\t{\n\t\t\t\tif ($i++ % 2)\n\t\t\t\t{\n\t\t\t\t\t$output .= $val.';'.$newline.$newline;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// If inserts are not needed we're done...\n\t\t\tif ($add_insert === FALSE)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Grab all the data from the current table\n\t\t\t$query = $this->db->query('SELECT * FROM '.$this->db->protect_identifiers($table));\n\n\t\t\tif ($query->num_rows() === 0)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Fetch the field names and determine if the field is an\n\t\t\t// integer type. We use this info to decide whether to\n\t\t\t// surround the data with quotes or not\n\n\t\t\t$i = 0;\n\t\t\t$field_str = '';\n\t\t\t$is_int = array();\n\t\t\twhile ($field = mysql_fetch_field($query->result_id))\n\t\t\t{\n\t\t\t\t// Most versions of MySQL store timestamp as a string\n\t\t\t\t$is_int[$i] = in_array(strtolower(mysql_field_type($query->result_id, $i)),\n\t\t\t\t\t\t\tarray('tinyint', 'smallint', 'mediumint', 'int', 'bigint'), //, 'timestamp'),\n\t\t\t\t\t\t\tTRUE);\n\n\t\t\t\t// Create a string of field names\n\t\t\t\t$field_str .= $this->db->escape_identifiers($field->name).', ';\n\t\t\t\t$i++;\n\t\t\t}\n\n\t\t\t// Trim off the end comma\n\t\t\t$field_str = preg_replace('/, $/' , '', $field_str);\n\n\t\t\t// Build the insert string\n\t\t\tforeach ($query->result_array() as $row)\n\t\t\t{\n\t\t\t\t$val_str = '';\n\n\t\t\t\t$i = 0;\n\t\t\t\tforeach ($row as $v)\n\t\t\t\t{\n\t\t\t\t\t// Is the value NULL?\n\t\t\t\t\tif ($v === NULL)\n\t\t\t\t\t{\n\t\t\t\t\t\t$val_str .= 'NULL';\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\t// Escape the data if it's not an integer\n\t\t\t\t\t\t$val_str .= ($is_int[$i] === FALSE) ? $this->db->escape($v) : $v;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Append a comma\n\t\t\t\t\t$val_str .= ', ';\n\t\t\t\t\t$i++;\n\t\t\t\t}\n\n\t\t\t\t// Remove the comma at the end of the string\n\t\t\t\t$val_str = preg_replace('/, $/' , '', $val_str);\n\n\t\t\t\t// Build the INSERT string\n\t\t\t\t$output .= 'INSERT INTO '.$this->db->protect_identifiers($table).' ('.$field_str.') VALUES ('.$val_str.');'.$newline;\n\t\t\t}\n\n\t\t\t$output .= $newline.$newline;\n\t\t}\n\n\t\t// Do we need to include a statement to re-enable foreign key checks?\n\t\tif ($foreign_key_checks === FALSE)\n\t\t{\n\t\t\t$output .= 'SET foreign_key_checks = 1;'.$newline;\n\t\t}\n\n\t\treturn $output;\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysqli/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/mysqli/mysqli_driver.php", "content": "report_mode = MYSQLI_REPORT_OFF;\n\t\t}\n\n\t\t// Do we have a socket path?\n\t\tif ($this->hostname[0] === '/')\n\t\t{\n\t\t\t$hostname = NULL;\n\t\t\t$port = NULL;\n\t\t\t$socket = $this->hostname;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$hostname = ($persistent === TRUE)\n\t\t\t\t? 'p:'.$this->hostname : $this->hostname;\n\t\t\t$port = empty($this->port) ? NULL : $this->port;\n\t\t\t$socket = NULL;\n\t\t}\n\n\t\t$client_flags = ($this->compress === TRUE) ? MYSQLI_CLIENT_COMPRESS : 0;\n\t\t$this->_mysqli = mysqli_init();\n\n\t\t$this->_mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 10);\n\n\t\tif (isset($this->stricton))\n\t\t{\n\t\t\tif ($this->stricton)\n\t\t\t{\n\t\t\t\t$this->_mysqli->options(MYSQLI_INIT_COMMAND, 'SET SESSION sql_mode = CONCAT(@@sql_mode, \",\", \"STRICT_ALL_TABLES\")');\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$this->_mysqli->options(MYSQLI_INIT_COMMAND,\n\t\t\t\t\t'SET SESSION sql_mode =\n\t\t\t\t\tREPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(\n\t\t\t\t\t@@sql_mode,\n\t\t\t\t\t\"STRICT_ALL_TABLES,\", \"\"),\n\t\t\t\t\t\",STRICT_ALL_TABLES\", \"\"),\n\t\t\t\t\t\"STRICT_ALL_TABLES\", \"\"),\n\t\t\t\t\t\"STRICT_TRANS_TABLES,\", \"\"),\n\t\t\t\t\t\",STRICT_TRANS_TABLES\", \"\"),\n\t\t\t\t\t\"STRICT_TRANS_TABLES\", \"\")'\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (is_array($this->encrypt))\n\t\t{\n\t\t\t$ssl = array();\n\t\t\tempty($this->encrypt['ssl_key']) OR $ssl['key'] = $this->encrypt['ssl_key'];\n\t\t\tempty($this->encrypt['ssl_cert']) OR $ssl['cert'] = $this->encrypt['ssl_cert'];\n\t\t\tempty($this->encrypt['ssl_ca']) OR $ssl['ca'] = $this->encrypt['ssl_ca'];\n\t\t\tempty($this->encrypt['ssl_capath']) OR $ssl['capath'] = $this->encrypt['ssl_capath'];\n\t\t\tempty($this->encrypt['ssl_cipher']) OR $ssl['cipher'] = $this->encrypt['ssl_cipher'];\n\n\t\t\tif (isset($this->encrypt['ssl_verify']))\n\t\t\t{\n\t\t\t\t$client_flags |= MYSQLI_CLIENT_SSL;\n\n\t\t\t\tif ($this->encrypt['ssl_verify'])\n\t\t\t\t{\n\t\t\t\t\tdefined('MYSQLI_OPT_SSL_VERIFY_SERVER_CERT') && $this->_mysqli->options(MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, TRUE);\n\t\t\t\t}\n\t\t\t\t// Apparently (when it exists), setting MYSQLI_OPT_SSL_VERIFY_SERVER_CERT\n\t\t\t\t// to FALSE didn't do anything, so PHP 5.6.16 introduced yet another\n\t\t\t\t// constant ...\n\t\t\t\t//\n\t\t\t\t// https://secure.php.net/ChangeLog-5.php#5.6.16\n\t\t\t\t// https://bugs.php.net/bug.php?id=68344\n\t\t\t\telseif (defined('MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT'))\n\t\t\t\t{\n\t\t\t\t\t$client_flags |= MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ( ! empty($ssl))\n\t\t\t{\n\t\t\t\t$client_flags |= MYSQLI_CLIENT_SSL;\n\t\t\t\t$this->_mysqli->ssl_set(\n\t\t\t\t\tisset($ssl['key']) ? $ssl['key'] : NULL,\n\t\t\t\t\tisset($ssl['cert']) ? $ssl['cert'] : NULL,\n\t\t\t\t\tisset($ssl['ca']) ? $ssl['ca'] : NULL,\n\t\t\t\t\tisset($ssl['capath']) ? $ssl['capath'] : NULL,\n\t\t\t\t\tisset($ssl['cipher']) ? $ssl['cipher'] : NULL\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif ($this->_mysqli->real_connect($hostname, $this->username, $this->password, $this->database, $port, $socket, $client_flags))\n\t\t{\n\t\t\t// Prior to version 5.7.3, MySQL silently downgrades to an unencrypted connection if SSL setup fails\n\t\t\tif (\n\t\t\t\t($client_flags & MYSQLI_CLIENT_SSL)\n\t\t\t\t&& version_compare($this->_mysqli->client_info, '5.7.3', '<=')\n\t\t\t\t&& empty($this->_mysqli->query(\"SHOW STATUS LIKE 'ssl_cipher'\")->fetch_object()->Value)\n\t\t\t)\n\t\t\t{\n\t\t\t\t$this->_mysqli->close();\n\t\t\t\t$message = 'MySQLi was configured for an SSL connection, but got an unencrypted connection instead!';\n\t\t\t\tlog_message('error', $message);\n\t\t\t\treturn ($this->db_debug) ? $this->display_error($message, '', TRUE) : FALSE;\n\t\t\t}\n\n\t\t\tif ( ! $this->_mysqli->set_charset($this->char_set))\n\t\t\t{\n\t\t\t\tlog_message('error', \"Database: Unable to set the configured connection charset ('{$this->char_set}').\");\n\t\t\t\t$this->_mysqli->close();\n\t\t\t\treturn ($this->db->db_debug) ? $this->display_error('db_unable_to_set_charset', $this->char_set) : FALSE;\n\t\t\t}\n\n\t\t\treturn $this->_mysqli;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reconnect\n\t *\n\t * Keep / reestablish the db connection if no queries have been\n\t * sent for a length of time exceeding the server's idle timeout\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function reconnect()\n\t{\n\t\tif ($this->conn_id !== FALSE && $this->conn_id->ping() === FALSE)\n\t\t{\n\t\t\t$this->conn_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select the database\n\t *\n\t * @param\tstring\t$database\n\t * @return\tbool\n\t */\n\tpublic function db_select($database = '')\n\t{\n\t\tif ($database === '')\n\t\t{\n\t\t\t$database = $this->database;\n\t\t}\n\n\t\tif ($this->conn_id->select_db($database))\n\t\t{\n\t\t\t$this->database = $database;\n\t\t\t$this->data_cache = array();\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\treturn $this->data_cache['version'] = $this->conn_id->server_info;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tmixed\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn $this->conn_id->query($this->_prep_query($sql));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Prep the query\n\t *\n\t * If needed, each database adapter can prep the query string\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tstring\n\t */\n\tprotected function _prep_query($sql)\n\t{\n\t\t// mysqli_affected_rows() returns 0 for \"DELETE FROM TABLE\" queries. This hack\n\t\t// modifies the query so that it a proper number of affected rows is returned.\n\t\tif ($this->delete_hack === TRUE && preg_match('/^\\s*DELETE\\s+FROM\\s+(\\S+)\\s*$/i', $sql))\n\t\t{\n\t\t\treturn trim($sql).' WHERE 1=1';\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\t$this->conn_id->autocommit(FALSE);\n\t\treturn is_php('5.5')\n\t\t\t? $this->conn_id->begin_transaction()\n\t\t\t: $this->simple_query('START TRANSACTION'); // can also be BEGIN or BEGIN WORK\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\tif ($this->conn_id->commit())\n\t\t{\n\t\t\t$this->conn_id->autocommit(TRUE);\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\tif ($this->conn_id->rollback())\n\t\t{\n\t\t\t$this->conn_id->autocommit(TRUE);\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\treturn $this->conn_id->real_escape_string($str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn $this->conn_id->affected_rows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tint\n\t */\n\tpublic function insert_id()\n\t{\n\t\treturn $this->conn_id->insert_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SHOW TABLES FROM '.$this->_escape_char.$this->database.$this->_escape_char;\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%'\";\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE))) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->Field;\n\n\t\t\tsscanf($query[$i]->Type, '%[a-z](%d)',\n\t\t\t\t$retval[$i]->type,\n\t\t\t\t$retval[$i]->max_length\n\t\t\t);\n\n\t\t\t$retval[$i]->default\t\t= $query[$i]->Default;\n\t\t\t$retval[$i]->primary_key\t= (int) ($query[$i]->Key === 'PRI');\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\tif ( ! empty($this->_mysqli->connect_errno))\n\t\t{\n\t\t\treturn array(\n\t\t\t\t'code' => $this->_mysqli->connect_errno,\n\t\t\t\t'message' => $this->_mysqli->connect_error\n\t\t\t);\n\t\t}\n\n\t\treturn array('code' => $this->conn_id->errno, 'message' => $this->conn_id->error);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * FROM tables\n\t *\n\t * Groups tables in FROM clauses if needed, so there is no confusion\n\t * about operator precedence.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _from_tables()\n\t{\n\t\tif ( ! empty($this->qb_join) && count($this->qb_from) > 1)\n\t\t{\n\t\t\treturn '('.implode(', ', $this->qb_from).')';\n\t\t}\n\n\t\treturn implode(', ', $this->qb_from);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\t$this->conn_id->close();\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysqli/mysqli_forge.php", "content": "db->char_set) && ! strpos($sql, 'CHARACTER SET') && ! strpos($sql, 'CHARSET'))\n\t\t{\n\t\t\t$sql .= ' DEFAULT CHARACTER SET = '.$this->db->char_set;\n\t\t}\n\n\t\tif ( ! empty($this->db->dbcollat) && ! strpos($sql, 'COLLATE'))\n\t\t{\n\t\t\t$sql .= ' COLLATE = '.$this->db->dbcollat;\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'DROP')\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$field[$i] = ($alter_type === 'ADD')\n\t\t\t\t\t\t? \"\\n\\tADD \".$field[$i]['_literal']\n\t\t\t\t\t\t: \"\\n\\tMODIFY \".$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tif ($alter_type === 'ADD')\n\t\t\t\t{\n\t\t\t\t\t$field[$i]['_literal'] = \"\\n\\tADD \";\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$field[$i]['_literal'] = empty($field[$i]['new_name']) ? \"\\n\\tMODIFY \" : \"\\n\\tCHANGE \";\n\t\t\t\t}\n\n\t\t\t\t$field[$i] = $field[$i]['_literal'].$this->_process_column($field[$i]);\n\t\t\t}\n\t\t}\n\n\t\treturn array($sql.implode(',', $field));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\t$extra_clause = isset($field['after'])\n\t\t\t? ' AFTER '.$this->db->escape_identifiers($field['after']) : '';\n\n\t\tif (empty($extra_clause) && isset($field['first']) && $field['first'] === TRUE)\n\t\t{\n\t\t\t$extra_clause = ' FIRST';\n\t\t}\n\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.(empty($field['new_name']) ? '' : ' '.$this->db->escape_identifiers($field['new_name']))\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['null']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['unique']\n\t\t\t.(empty($field['comment']) ? '' : ' COMMENT '.$field['comment'])\n\t\t\t.$extra_clause;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process indexes\n\t *\n\t * @param\tstring\t$table\t(ignored)\n\t * @return\tstring\n\t */\n\tprotected function _process_indexes($table)\n\t{\n\t\t$sql = '';\n\n\t\tfor ($i = 0, $c = count($this->keys); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_array($this->keys[$i]))\n\t\t\t{\n\t\t\t\tfor ($i2 = 0, $c2 = count($this->keys[$i]); $i2 < $c2; $i2++)\n\t\t\t\t{\n\t\t\t\t\tif ( ! isset($this->fields[$this->keys[$i][$i2]]))\n\t\t\t\t\t{\n\t\t\t\t\t\tunset($this->keys[$i][$i2]);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! isset($this->fields[$this->keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->keys[$i]);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tis_array($this->keys[$i]) OR $this->keys[$i] = array($this->keys[$i]);\n\n\t\t\t$sql .= \",\\n\\tKEY \".$this->db->escape_identifiers(implode('_', $this->keys[$i]))\n\t\t\t\t.' ('.implode(', ', $this->db->escape_identifiers($this->keys[$i])).')';\n\t\t}\n\n\t\t$this->keys = array();\n\n\t\treturn $sql;\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysqli/mysqli_result.php", "content": "num_rows)\n\t\t\t? $this->num_rows\n\t\t\t: $this->num_rows = $this->result_id->num_rows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn $this->result_id->field_count;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\t$this->result_id->field_seek(0);\n\t\twhile ($field = $this->result_id->fetch_field())\n\t\t{\n\t\t\t$field_names[] = $field->name;\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\t$field_data = $this->result_id->fetch_fields();\n\t\tfor ($i = 0, $c = count($field_data); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $field_data[$i]->name;\n\t\t\t$retval[$i]->type\t\t= static::_get_field_type($field_data[$i]->type);\n\t\t\t$retval[$i]->max_length\t\t= $field_data[$i]->max_length;\n\t\t\t$retval[$i]->primary_key\t= (int) ($field_data[$i]->flags & MYSQLI_PRI_KEY_FLAG);\n\t\t\t$retval[$i]->default\t\t= $field_data[$i]->def;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Get field type\n\t *\n\t * Extracts field type info from the bitflags returned by\n\t * mysqli_result::fetch_fields()\n\t *\n\t * @used-by\tCI_DB_mysqli_result::field_data()\n\t * @param\tint\t$type\n\t * @return\tstring\n\t */\n\tprivate static function _get_field_type($type)\n\t{\n\t\tstatic $map;\n\t\tisset($map) OR $map = array(\n\t\t\tMYSQLI_TYPE_DECIMAL => 'decimal',\n\t\t\tMYSQLI_TYPE_BIT => 'bit',\n\t\t\tMYSQLI_TYPE_TINY => 'tinyint',\n\t\t\tMYSQLI_TYPE_SHORT => 'smallint',\n\t\t\tMYSQLI_TYPE_INT24 => 'mediumint',\n\t\t\tMYSQLI_TYPE_LONG => 'int',\n\t\t\tMYSQLI_TYPE_LONGLONG => 'bigint',\n\t\t\tMYSQLI_TYPE_FLOAT => 'float',\n\t\t\tMYSQLI_TYPE_DOUBLE => 'double',\n\t\t\tMYSQLI_TYPE_TIMESTAMP => 'timestamp',\n\t\t\tMYSQLI_TYPE_DATE => 'date',\n\t\t\tMYSQLI_TYPE_TIME => 'time',\n\t\t\tMYSQLI_TYPE_DATETIME => 'datetime',\n\t\t\tMYSQLI_TYPE_YEAR => 'year',\n\t\t\tMYSQLI_TYPE_NEWDATE => 'date',\n\t\t\tMYSQLI_TYPE_INTERVAL => 'interval',\n\t\t\tMYSQLI_TYPE_ENUM => 'enum',\n\t\t\tMYSQLI_TYPE_SET => 'set',\n\t\t\tMYSQLI_TYPE_TINY_BLOB => 'tinyblob',\n\t\t\tMYSQLI_TYPE_MEDIUM_BLOB => 'mediumblob',\n\t\t\tMYSQLI_TYPE_BLOB => 'blob',\n\t\t\tMYSQLI_TYPE_LONG_BLOB => 'longblob',\n\t\t\tMYSQLI_TYPE_STRING => 'char',\n\t\t\tMYSQLI_TYPE_VAR_STRING => 'varchar',\n\t\t\tMYSQLI_TYPE_GEOMETRY => 'geometry'\n\t\t);\n\n\t\treturn isset($map[$type]) ? $map[$type] : $type;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_object($this->result_id))\n\t\t{\n\t\t\t$this->result_id->free();\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * @param\tint\t$n\n\t * @return\tbool\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\treturn $this->result_id->data_seek($n);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn $this->result_id->fetch_assoc();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn $this->result_id->fetch_object($class_name);\n\t}\n\n}\n" }, { "path": "system/database/drivers/mysqli/mysqli_utility.php", "content": "db->query('SHOW CREATE TABLE '.$this->db->escape_identifiers($this->db->database.'.'.$table));\n\n\t\t\t// No result means the table name was invalid\n\t\t\tif ($query === FALSE)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Write out the table schema\n\t\t\t$output .= '#'.$newline.'# TABLE STRUCTURE FOR: '.$table.$newline.'#'.$newline.$newline;\n\n\t\t\tif ($add_drop === TRUE)\n\t\t\t{\n\t\t\t\t$output .= 'DROP TABLE IF EXISTS '.$this->db->protect_identifiers($table).';'.$newline.$newline;\n\t\t\t}\n\n\t\t\t$i = 0;\n\t\t\t$result = $query->result_array();\n\t\t\tforeach ($result[0] as $val)\n\t\t\t{\n\t\t\t\tif ($i++ % 2)\n\t\t\t\t{\n\t\t\t\t\t$output .= $val.';'.$newline.$newline;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// If inserts are not needed we're done...\n\t\t\tif ($add_insert === FALSE)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Grab all the data from the current table\n\t\t\t$query = $this->db->query('SELECT * FROM '.$this->db->protect_identifiers($table));\n\n\t\t\tif ($query->num_rows() === 0)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Fetch the field names and determine if the field is an\n\t\t\t// integer type. We use this info to decide whether to\n\t\t\t// surround the data with quotes or not\n\n\t\t\t$i = 0;\n\t\t\t$field_str = '';\n\t\t\t$is_int = array();\n\t\t\twhile ($field = $query->result_id->fetch_field())\n\t\t\t{\n\t\t\t\t// Most versions of MySQL store timestamp as a string\n\t\t\t\t$is_int[$i] = in_array($field->type, array(MYSQLI_TYPE_TINY, MYSQLI_TYPE_SHORT, MYSQLI_TYPE_INT24, MYSQLI_TYPE_LONG), TRUE);\n\n\t\t\t\t// Create a string of field names\n\t\t\t\t$field_str .= $this->db->escape_identifiers($field->name).', ';\n\t\t\t\t$i++;\n\t\t\t}\n\n\t\t\t// Trim off the end comma\n\t\t\t$field_str = preg_replace('/, $/' , '', $field_str);\n\n\t\t\t// Build the insert string\n\t\t\tforeach ($query->result_array() as $row)\n\t\t\t{\n\t\t\t\t$val_str = '';\n\n\t\t\t\t$i = 0;\n\t\t\t\tforeach ($row as $v)\n\t\t\t\t{\n\t\t\t\t\t// Is the value NULL?\n\t\t\t\t\tif ($v === NULL)\n\t\t\t\t\t{\n\t\t\t\t\t\t$val_str .= 'NULL';\n\t\t\t\t\t}\n\t\t\t\t\telse\n\t\t\t\t\t{\n\t\t\t\t\t\t// Escape the data if it's not an integer\n\t\t\t\t\t\t$val_str .= ($is_int[$i] === FALSE) ? $this->db->escape($v) : $v;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Append a comma\n\t\t\t\t\t$val_str .= ', ';\n\t\t\t\t\t$i++;\n\t\t\t\t}\n\n\t\t\t\t// Remove the comma at the end of the string\n\t\t\t\t$val_str = preg_replace('/, $/' , '', $val_str);\n\n\t\t\t\t// Build the INSERT string\n\t\t\t\t$output .= 'INSERT INTO '.$this->db->protect_identifiers($table).' ('.$field_str.') VALUES ('.$val_str.');'.$newline;\n\t\t\t}\n\n\t\t\t$output .= $newline.$newline;\n\t\t}\n\n\t\t// Do we need to include a statement to re-enable foreign key checks?\n\t\tif ($foreign_key_checks === FALSE)\n\t\t{\n\t\t\t$output .= 'SET foreign_key_checks = 1;'.$newline;\n\t\t}\n\n\t\treturn $output;\n\t}\n\n}\n" }, { "path": "system/database/drivers/oci8/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/oci8/oci8_driver.php", "content": " '/^\\(DESCRIPTION=(\\(.+\\)){2,}\\)$/', // TNS\n\t\t\t// Easy Connect string (Oracle 10g+)\n\t\t\t'ec'\t=> '/^(\\/\\/)?[a-z0-9.:_-]+(:[1-9][0-9]{0,4})?(\\/[a-z0-9$_]+)?(:[^\\/])?(\\/[a-z0-9$_]+)?$/i',\n\t\t\t'in'\t=> '/^[a-z0-9$_]+$/i' // Instance name (defined in tnsnames.ora)\n\t\t);\n\n\t\t/* Space characters don't have any effect when actually\n\t\t * connecting, but can be a hassle while validating the DSN.\n\t\t */\n\t\t$this->dsn = str_replace(array(\"\\n\", \"\\r\", \"\\t\", ' '), '', $this->dsn);\n\n\t\tif ($this->dsn !== '')\n\t\t{\n\t\t\tforeach ($valid_dsns as $regexp)\n\t\t\t{\n\t\t\t\tif (preg_match($regexp, $this->dsn))\n\t\t\t\t{\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Legacy support for TNS in the hostname configuration field\n\t\t$this->hostname = str_replace(array(\"\\n\", \"\\r\", \"\\t\", ' '), '', $this->hostname);\n\t\tif (preg_match($valid_dsns['tns'], $this->hostname))\n\t\t{\n\t\t\t$this->dsn = $this->hostname;\n\t\t\treturn;\n\t\t}\n\t\telseif ($this->hostname !== '' && strpos($this->hostname, '/') === FALSE && strpos($this->hostname, ':') === FALSE\n\t\t\t&& (( ! empty($this->port) && ctype_digit($this->port)) OR $this->database !== ''))\n\t\t{\n\t\t\t/* If the hostname field isn't empty, doesn't contain\n\t\t\t * ':' and/or '/' and if port and/or database aren't\n\t\t\t * empty, then the hostname field is most likely indeed\n\t\t\t * just a hostname. Therefore we'll try and build an\n\t\t\t * Easy Connect string from these 3 settings, assuming\n\t\t\t * that the database field is a service name.\n\t\t\t */\n\t\t\t$this->dsn = $this->hostname\n\t\t\t\t.(( ! empty($this->port) && ctype_digit($this->port)) ? ':'.$this->port : '')\n\t\t\t\t.($this->database !== '' ? '/'.ltrim($this->database, '/') : '');\n\n\t\t\tif (preg_match($valid_dsns['ec'], $this->dsn))\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t/* At this point, we can only try and validate the hostname and\n\t\t * database fields separately as DSNs.\n\t\t */\n\t\tif (preg_match($valid_dsns['ec'], $this->hostname) OR preg_match($valid_dsns['in'], $this->hostname))\n\t\t{\n\t\t\t$this->dsn = $this->hostname;\n\t\t\treturn;\n\t\t}\n\n\t\t$this->database = str_replace(array(\"\\n\", \"\\r\", \"\\t\", ' '), '', $this->database);\n\t\tforeach ($valid_dsns as $regexp)\n\t\t{\n\t\t\tif (preg_match($regexp, $this->database))\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t/* Well - OK, an empty string should work as well.\n\t\t * PHP will try to use environment variables to\n\t\t * determine which Oracle instance to connect to.\n\t\t */\n\t\t$this->dsn = '';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Non-persistent database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tresource\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\t$func = ($persistent === TRUE) ? 'oci_pconnect' : 'oci_connect';\n\t\treturn empty($this->char_set)\n\t\t\t? $func($this->username, $this->password, $this->dsn)\n\t\t\t: $func($this->username, $this->password, $this->dsn, $this->char_set);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\tif ( ! $this->conn_id OR ($version_string = oci_server_version($this->conn_id)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\telseif (preg_match('#Release\\s(\\d+(?:\\.\\d+)+)#', $version_string, $match))\n\t\t{\n\t\t\treturn $this->data_cache['version'] = $match[1];\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tresource\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\t/* Oracle must parse the query before it is run. All of the actions with\n\t\t * the query are based on the statement id returned by oci_parse().\n\t\t */\n\t\t$this->result_id = oci_parse($this->conn_id, $sql);\n\t\toci_set_prefetch($this->result_id, 1000);\n\t\t$result = oci_execute($this->result_id, $this->commit_mode);\n\t\t$this->_error = oci_error($this->result_id);\n\t\t$this->is_write_type($sql) && $this->_affected_rows = oci_num_rows($this->result_id);\n\n\t\tif ($this->is_write_type($sql) OR $result === FALSE)\n\t\t{\n\t\t\toci_free_statement($this->result_id);\n\t\t\treturn $result;\n\t\t}\n\n\t\treturn $this->result_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\t$this->commit_mode = OCI_NO_AUTO_COMMIT;\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\t$this->commit_mode = OCI_COMMIT_ON_SUCCESS;\n\n\t\treturn oci_commit($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\t$this->commit_mode = OCI_COMMIT_ON_SUCCESS;\n\t\treturn oci_rollback($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn $this->_affected_rows;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tint\n\t */\n\tpublic function insert_id()\n\t{\n\t\t// not supported in oracle\n\t\treturn $this->display_error('db_unsupported_function');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"TABLE_NAME\" FROM \"ALL_TABLES\"';\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' WHERE \"TABLE_NAME\" LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\tif (strpos($table, '.') !== FALSE)\n\t\t{\n\t\t\tsscanf($table, '%[^.].%s', $owner, $table);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$owner = $this->username;\n\t\t}\n\n\t\treturn 'SELECT COLUMN_NAME FROM ALL_TAB_COLUMNS\n\t\t\tWHERE UPPER(OWNER) = '.$this->escape(strtoupper($owner)).'\n\t\t\t\tAND UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (strpos($table, '.') !== FALSE)\n\t\t{\n\t\t\tsscanf($table, '%[^.].%s', $owner, $table);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$owner = $this->username;\n\t\t}\n\n\t\t$sql = 'SELECT COLUMN_NAME, DATA_TYPE, CHAR_LENGTH, DATA_PRECISION, DATA_LENGTH, DATA_DEFAULT, NULLABLE\n\t\t\tFROM ALL_TAB_COLUMNS\n\t\t\tWHERE UPPER(OWNER) = '.$this->escape(strtoupper($owner)).'\n\t\t\t\tAND UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->COLUMN_NAME;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->DATA_TYPE;\n\n\t\t\t$length = ($query[$i]->CHAR_LENGTH > 0)\n\t\t\t\t? $query[$i]->CHAR_LENGTH : $query[$i]->DATA_PRECISION;\n\t\t\tif ($length === NULL)\n\t\t\t{\n\t\t\t\t$length = $query[$i]->DATA_LENGTH;\n\t\t\t}\n\t\t\t$retval[$i]->max_length\t\t= $length;\n\n\t\t\t$default = $query[$i]->DATA_DEFAULT;\n\t\t\tif ($default === NULL && $query[$i]->NULLABLE === 'N')\n\t\t\t{\n\t\t\t\t$default = '';\n\t\t\t}\n\t\t\t$retval[$i]->default = $default;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\tif ( ! empty($this->_error))\n\t\t{\n\t\t\treturn $this->_error;\n\t\t}\n\n\t\t// oci_error() returns an array that already contains\n\t\t// 'code' and 'message' keys, but it can return false\n\t\t// if there was no error ....\n\t\tif (is_resource($this->conn_id))\n\t\t{\n\t\t\t$error = oci_error($this->conn_id);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$error = oci_error();\n\t\t}\n\n\t\treturn is_array($error)\n\t\t\t? $error\n\t\t\t: array('code' => '', 'message' => '');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param \tarray\t$values\tINSERT values\n\t * @return\tstring\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\t$keys = implode(', ', $keys);\n\t\t$sql = \"INSERT ALL\\n\";\n\n\t\tfor ($i = 0, $c = count($values); $i < $c; $i++)\n\t\t{\n\t\t\t$sql .= '\tINTO '.$table.' ('.$keys.') VALUES '.$values[$i].\"\\n\";\n\t\t}\n\n\t\treturn $sql.'SELECT * FROM dual';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE TABLE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\tif ($this->qb_limit)\n\t\t{\n\t\t\t$this->where('rownum <= ',$this->qb_limit, FALSE);\n\t\t\t$this->qb_limit = FALSE;\n\t\t}\n\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\tif (version_compare($this->version(), '12.1', '>='))\n\t\t{\n\t\t\t// OFFSET-FETCH can be used only with the ORDER BY clause\n\t\t\tempty($this->qb_orderby) && $sql .= ' ORDER BY 1';\n\n\t\t\treturn $sql.' OFFSET '.(int) $this->qb_offset.' ROWS FETCH NEXT '.$this->qb_limit.' ROWS ONLY';\n\t\t}\n\n\t\t$this->limit_used = TRUE;\n\t\treturn 'SELECT * FROM (SELECT inner_query.*, rownum rnum FROM ('.$sql.') inner_query WHERE rownum < '.($this->qb_offset + $this->qb_limit + 1).')'\n\t\t\t.($this->qb_offset ? ' WHERE rnum >= '.($this->qb_offset + 1) : '');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\tif (is_resource($this->result_id))\n\t\t{\n\t\t\toci_free_statement($this->result_id);\n\t\t}\n\n\t\toci_close($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * We need to reset our $limit_used hack flag, so it doesn't propagate\n\t * to subsequent queries.\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _reset_select()\n\t{\n\t\t$this->limit_used = FALSE;\n\t\tparent::_reset_select();\n\t}\n}\n" }, { "path": "system/database/drivers/oci8/oci8_forge.php", "content": "db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$field[$i] = \"\\n\\t\".$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$field[$i]['_literal'] = \"\\n\\t\".$this->_process_column($field[$i]);\n\n\t\t\t\tif ( ! empty($field[$i]['comment']))\n\t\t\t\t{\n\t\t\t\t\t$sqls[] = 'COMMENT ON COLUMN '\n\t\t\t\t\t\t.$this->db->escape_identifiers($table).'.'.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t\t.' IS '.$field[$i]['comment'];\n\t\t\t\t}\n\n\t\t\t\tif ($alter_type === 'MODIFY' && ! empty($field[$i]['new_name']))\n\t\t\t\t{\n\t\t\t\t\t$sqls[] = $sql.' RENAME COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t\t.' TO '.$this->db->escape_identifiers($field[$i]['new_name']);\n\t\t\t\t}\n\n\t\t\t\t$field[$i] = \"\\n\\t\".$field[$i]['_literal'];\n\t\t\t}\n\t\t}\n\n\t\t$sql .= ' '.$alter_type.' ';\n\t\t$sql .= (count($field) === 1)\n\t\t\t\t? $field[0]\n\t\t\t\t: '('.implode(',', $field).')';\n\n\t\t// RENAME COLUMN must be executed after MODIFY\n\t\tarray_unshift($sqls, $sql);\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'number') !== FALSE && version_compare($this->db->version(), '12.1', '>='))\n\t\t{\n\t\t\t$field['auto_increment'] = ' GENERATED ALWAYS AS IDENTITY';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['null']\n\t\t\t.$field['unique'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tcase 'INT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tcase 'BIGINT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n}\n" }, { "path": "system/database/drivers/oci8/oci8_result.php", "content": "result_id = $driver_object->result_id;\n\t\t$this->limit_used = $driver_object->limit_used;\n\t\t$this->commit_mode =& $driver_object->commit_mode;\n\t\t$driver_object->result_id = FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\t$count = oci_num_fields($this->result_id);\n\n\t\t// if we used a limit we subtract it\n\t\treturn ($this->limit_used) ? $count - 1 : $count;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tfor ($c = 1, $fieldCount = $this->num_fields(); $c <= $fieldCount; $c++)\n\t\t{\n\t\t\t$field_names[] = oci_field_name($this->result_id, $c);\n\t\t}\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tfor ($c = 1, $fieldCount = $this->num_fields(); $c <= $fieldCount; $c++)\n\t\t{\n\t\t\t$F\t\t= new stdClass();\n\t\t\t$F->name\t= oci_field_name($this->result_id, $c);\n\t\t\t$F->type\t= oci_field_type($this->result_id, $c);\n\t\t\t$F->max_length\t= oci_field_size($this->result_id, $c);\n\n\t\t\t$retval[] = $F;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_resource($this->result_id))\n\t\t{\n\t\t\toci_free_statement($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn oci_fetch_assoc($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\t$row = oci_fetch_object($this->result_id);\n\n\t\tif ($class_name === 'stdClass' OR ! $row)\n\t\t{\n\t\t\treturn $row;\n\t\t}\n\n\t\t$class_name = new $class_name();\n\t\tforeach ($row as $key => $value)\n\t\t{\n\t\t\t$class_name->$key = $value;\n\t\t}\n\n\t\treturn $class_name;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Destructor\n\t *\n\t * Attempt to free remaining statement IDs.\n\t *\n\t * @see\thttps://github.com/bcit-ci/CodeIgniter/pull/5896\n\t * @return\tvoid\n\t */\n\tpublic function __destruct()\n\t{\n\t\t$this->free_result();\n\t}\n}\n" }, { "path": "system/database/drivers/oci8/oci8_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n\n}\n" }, { "path": "system/database/drivers/odbc/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/odbc/odbc_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = $this->hostname;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Non-persistent database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tresource\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\treturn ($persistent === TRUE)\n\t\t\t? odbc_pconnect($this->dsn, $this->username, $this->password)\n\t\t\t: odbc_connect($this->dsn, $this->username, $this->password);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Compile Bindings\n\t *\n\t * @param\tstring\t$sql\tSQL statement\n\t * @param\tarray\t$binds\tAn array of values to bind\n\t * @return\tstring\n\t */\n\tpublic function compile_binds($sql, $binds)\n\t{\n\t\tif (empty($binds) OR empty($this->bind_marker) OR strpos($sql, $this->bind_marker) === FALSE)\n\t\t{\n\t\t\treturn $sql;\n\t\t}\n\t\telseif ( ! is_array($binds))\n\t\t{\n\t\t\t$binds = array($binds);\n\t\t\t$bind_count = 1;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Make sure we're using numeric keys\n\t\t\t$binds = array_values($binds);\n\t\t\t$bind_count = count($binds);\n\t\t}\n\n\t\t// We'll need the marker length later\n\t\t$ml = strlen($this->bind_marker);\n\n\t\t// Make sure not to replace a chunk inside a string that happens to match the bind marker\n\t\tif ($c = preg_match_all(\"/'[^']*'|\\\"[^\\\"]*\\\"/i\", $sql, $matches))\n\t\t{\n\t\t\t$c = preg_match_all('/'.preg_quote($this->bind_marker, '/').'/i',\n\t\t\t\tstr_replace($matches[0],\n\t\t\t\t\tstr_replace($this->bind_marker, str_repeat(' ', $ml), $matches[0]),\n\t\t\t\t\t$sql, $c),\n\t\t\t\t$matches, PREG_OFFSET_CAPTURE);\n\n\t\t\t// Bind values' count must match the count of markers in the query\n\t\t\tif ($bind_count !== $c)\n\t\t\t{\n\t\t\t\treturn $sql;\n\t\t\t}\n\t\t}\n\t\telseif (($c = preg_match_all('/'.preg_quote($this->bind_marker, '/').'/i', $sql, $matches, PREG_OFFSET_CAPTURE)) !== $bind_count)\n\t\t{\n\t\t\treturn $sql;\n\t\t}\n\n\t\tif ($this->bind_marker !== '?')\n\t\t{\n\t\t\tdo\n\t\t\t{\n\t\t\t\t$c--;\n\t\t\t\t$sql = substr_replace($sql, '?', $matches[0][$c][1], $ml);\n\t\t\t}\n\t\t\twhile ($c !== 0);\n\t\t}\n\n\t\tif (FALSE !== ($this->odbc_result = odbc_prepare($this->conn_id, $sql)))\n\t\t{\n\t\t\t$this->binds = array_values($binds);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tresource\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\tif ( ! isset($this->odbc_result))\n\t\t{\n\t\t\treturn odbc_exec($this->conn_id, $sql);\n\t\t}\n\t\telseif ($this->odbc_result === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (TRUE === ($success = odbc_execute($this->odbc_result, $this->binds)))\n\t\t{\n\t\t\t// For queries that return result sets, return the result_id resource on success\n\t\t\t$this->is_write_type($sql) OR $success = $this->odbc_result;\n\t\t}\n\n\t\t$this->odbc_result = NULL;\n\t\t$this->binds = array();\n\n\t\treturn $success;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\treturn odbc_autocommit($this->conn_id, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\tif (odbc_commit($this->conn_id))\n\t\t{\n\t\t\todbc_autocommit($this->conn_id, TRUE);\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\tif (odbc_rollback($this->conn_id))\n\t\t{\n\t\t\todbc_autocommit($this->conn_id, TRUE);\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determines if a query is a \"write\" type.\n\t *\n\t * @param\tstring\tAn SQL query string\n\t * @return\tbool\n\t */\n\tpublic function is_write_type($sql)\n\t{\n\t\tif (preg_match('#^(INSERT|UPDATE).*RETURNING\\s.+(\\,\\s?.+)*$#is', $sql))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn parent::is_write_type($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\t$this->display_error('db_unsupported_feature');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn odbc_num_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tbool\n\t */\n\tpublic function insert_id()\n\t{\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = \"SELECT table_name FROM information_schema.tables WHERE table_schema = '\".$this->schema.\"'\";\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" AND table_name LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SHOW COLUMNS FROM '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data query\n\t *\n\t * Generates a platform-specific query so that the column data can be retrieved\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _field_data($table)\n\t{\n\t\treturn 'SELECT TOP 1 FROM '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => odbc_error($this->conn_id), 'message' => odbc_errormsg($this->conn_id));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\todbc_close($this->conn_id);\n\t}\n}\n" }, { "path": "system/database/drivers/odbc/odbc_forge.php", "content": "num_rows))\n\t\t{\n\t\t\treturn $this->num_rows;\n\t\t}\n\t\telseif (($this->num_rows = odbc_num_rows($this->result_id)) !== -1)\n\t\t{\n\t\t\treturn $this->num_rows;\n\t\t}\n\n\t\t// Work-around for ODBC subdrivers that don't support num_rows()\n\t\tif (count($this->result_array) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = count($this->result_array);\n\t\t}\n\t\telseif (count($this->result_object) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = count($this->result_object);\n\t\t}\n\n\t\treturn $this->num_rows = count($this->result_array());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn odbc_num_fields($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\t$num_fields = $this->num_fields();\n\n\t\tif ($num_fields > 0)\n\t\t{\n\t\t\tfor ($i = 1; $i <= $num_fields; $i++)\n\t\t\t{\n\t\t\t\t$field_names[] = odbc_field_name($this->result_id, $i);\n\t\t\t}\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tfor ($i = 0, $odbc_index = 1, $c = $this->num_fields(); $i < $c; $i++, $odbc_index++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= odbc_field_name($this->result_id, $odbc_index);\n\t\t\t$retval[$i]->type\t\t= odbc_field_type($this->result_id, $odbc_index);\n\t\t\t$retval[$i]->max_length\t\t= odbc_field_len($this->result_id, $odbc_index);\n\t\t\t$retval[$i]->primary_key\t= 0;\n\t\t\t$retval[$i]->default\t\t= '';\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_resource($this->result_id))\n\t\t{\n\t\t\todbc_free_result($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn odbc_fetch_array($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\t$row = odbc_fetch_object($this->result_id);\n\n\t\tif ($class_name === 'stdClass' OR ! $row)\n\t\t{\n\t\t\treturn $row;\n\t\t}\n\n\t\t$class_name = new $class_name();\n\t\tforeach ($row as $key => $value)\n\t\t{\n\t\t\t$class_name->$key = $value;\n\t\t}\n\n\t\treturn $class_name;\n\t}\n\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('odbc_fetch_array'))\n{\n\t/**\n\t * ODBC Fetch array\n\t *\n\t * Emulates the native odbc_fetch_array() function when\n\t * it is not available (odbc_fetch_array() requires unixODBC)\n\t *\n\t * @param\tresource\t&$result\n\t * @param\tint\t\t$rownumber\n\t * @return\tarray\n\t */\n\tfunction odbc_fetch_array(&$result, $rownumber = 1)\n\t{\n\t\t$rs = array();\n\t\tif ( ! odbc_fetch_into($result, $rs, $rownumber))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$rs_assoc = array();\n\t\tforeach ($rs as $k => $v)\n\t\t{\n\t\t\t$field_name = odbc_field_name($result, $k+1);\n\t\t\t$rs_assoc[$field_name] = $v;\n\t\t}\n\n\t\treturn $rs_assoc;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('odbc_fetch_object'))\n{\n\t/**\n\t * ODBC Fetch object\n\t *\n\t * Emulates the native odbc_fetch_object() function when\n\t * it is not available.\n\t *\n\t * @param\tresource\t&$result\n\t * @param\tint\t\t$rownumber\n\t * @return\tobject\n\t */\n\tfunction odbc_fetch_object(&$result, $rownumber = 1)\n\t{\n\t\t$rs = array();\n\t\tif ( ! odbc_fetch_into($result, $rs, $rownumber))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$rs_object = new stdClass();\n\t\tforeach ($rs as $k => $v)\n\t\t{\n\t\t\t$field_name = odbc_field_name($result, $k+1);\n\t\t\t$rs_object->$field_name = $v;\n\t\t}\n\n\t\treturn $rs_object;\n\t}\n}\n" }, { "path": "system/database/drivers/odbc/odbc_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/pdo/pdo_driver.php", "content": "dsn, $match) && count($match) === 2)\n\t\t{\n\t\t\t// If there is a minimum valid dsn string pattern found, we're done\n\t\t\t// This is for general PDO users, who tend to have a full DSN string.\n\t\t\t$this->subdriver = $match[1];\n\t\t\treturn;\n\t\t}\n\t\t// Legacy support for DSN specified in the hostname field\n\t\telseif (preg_match('/([^:]+):/', $this->hostname, $match) && count($match) === 2)\n\t\t{\n\t\t\t$this->dsn = $this->hostname;\n\t\t\t$this->hostname = NULL;\n\t\t\t$this->subdriver = $match[1];\n\t\t\treturn;\n\t\t}\n\t\telseif (in_array($this->subdriver, array('mssql', 'sybase'), TRUE))\n\t\t{\n\t\t\t$this->subdriver = 'dblib';\n\t\t}\n\t\telseif ($this->subdriver === '4D')\n\t\t{\n\t\t\t$this->subdriver = '4d';\n\t\t}\n\t\telseif ( ! in_array($this->subdriver, array('4d', 'cubrid', 'dblib', 'firebird', 'ibm', 'informix', 'mysql', 'oci', 'odbc', 'pgsql', 'sqlite', 'sqlsrv'), TRUE))\n\t\t{\n\t\t\tlog_message('error', 'PDO: Invalid or non-existent subdriver');\n\n\t\t\tif ($this->db_debug)\n\t\t\t{\n\t\t\t\tshow_error('Invalid or non-existent PDO subdriver');\n\t\t\t}\n\t\t}\n\n\t\t$this->dsn = NULL;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tobject\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tif ($persistent === TRUE)\n\t\t{\n\t\t\t$this->options[PDO::ATTR_PERSISTENT] = TRUE;\n\t\t}\n\n\t\t// From PHP8.0, default PDO::ATTR_ERRMODE is changed\n\t\t// from PDO::ERRMODE_SILENT to PDO::ERRMODE_EXCEPTION\n\t\t// as https://wiki.php.net/rfc/pdo_default_errmode\n\t\tif ( ! isset($this->options[PDO::ATTR_ERRMODE]))\n\t\t{\n\t\t\t$this->options[PDO::ATTR_ERRMODE] = PDO::ERRMODE_SILENT;\n\t\t}\n\n\t\ttry\n\t\t{\n\t\t\treturn new PDO($this->dsn, $this->username, $this->password, $this->options);\n\t\t}\n\t\tcatch (PDOException $e)\n\t\t{\n\t\t\tif ($this->db_debug && empty($this->failover))\n\t\t\t{\n\t\t\t\t$this->display_error($e->getMessage(), '', TRUE);\n\t\t\t}\n\n\t\t\treturn FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\t// Not all subdrivers support the getAttribute() method\n\t\ttry\n\t\t{\n\t\t\treturn $this->data_cache['version'] = $this->conn_id->getAttribute(PDO::ATTR_SERVER_VERSION);\n\t\t}\n\t\tcatch (PDOException $e)\n\t\t{\n\t\t\treturn parent::version();\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tSQL query\n\t * @return\tmixed\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn $this->conn_id->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\treturn $this->conn_id->beginTransaction();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\treturn $this->conn_id->commit();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\treturn $this->conn_id->rollBack();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\t// Escape the string\n\t\t$str = $this->conn_id->quote($str);\n\n\t\t// If there are duplicated quotes, trim them away\n\t\treturn ($str[0] === \"'\")\n\t\t\t? substr($str, 1, -1)\n\t\t\t: $str;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn is_object($this->result_id) ? $this->result_id->rowCount() : 0;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @param\tstring\t$name\n\t * @return\tint\n\t */\n\tpublic function insert_id($name = NULL)\n\t{\n\t\treturn $this->conn_id->lastInsertId($name);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data query\n\t *\n\t * Generates a platform-specific query so that the column data can be retrieved\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _field_data($table)\n\t{\n\t\treturn 'SELECT TOP 1 * FROM '.$this->protect_identifiers($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\t$error = array('code' => '00000', 'message' => '');\n\t\t$pdo_error = $this->conn_id->errorInfo();\n\n\t\tif (empty($pdo_error[0]))\n\t\t{\n\t\t\treturn $error;\n\t\t}\n\n\t\t$error['code'] = isset($pdo_error[1]) ? $pdo_error[0].'/'.$pdo_error[1] : $pdo_error[0];\n\t\tif (isset($pdo_error[2]))\n\t\t{\n\t\t\t$error['message'] = $pdo_error[2];\n\t\t}\n\n\t\treturn $error;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE TABLE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\t$this->result_id = FALSE;\n\t\t$this->conn_id = FALSE;\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/pdo_forge.php", "content": "num_rows))\n\t\t{\n\t\t\treturn $this->num_rows;\n\t\t}\n\t\telseif (count($this->result_array) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = count($this->result_array);\n\t\t}\n\t\telseif (count($this->result_object) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = count($this->result_object);\n\t\t}\n\t\telseif (($num_rows = $this->result_id->rowCount()) > 0)\n\t\t{\n\t\t\treturn $this->num_rows = $num_rows;\n\t\t}\n\n\t\treturn $this->num_rows = count($this->result_array());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn $this->result_id->columnCount();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tbool\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t// Might trigger an E_WARNING due to not all subdrivers\n\t\t\t// supporting getColumnMeta()\n\t\t\t$field_names[$i] = @$this->result_id->getColumnMeta($i);\n\t\t\t$field_names[$i] = $field_names[$i]['name'];\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\ttry\n\t\t{\n\t\t\t$retval = array();\n\n\t\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t\t{\n\t\t\t\t$field = $this->result_id->getColumnMeta($i);\n\n\t\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t\t$retval[$i]->name\t\t= $field['name'];\n\t\t\t\t$retval[$i]->type\t\t= isset($field['native_type']) ? $field['native_type'] : null;\n\t\t\t\t$retval[$i]->max_length\t\t= ($field['len'] > 0) ? $field['len'] : NULL;\n\t\t\t\t$retval[$i]->primary_key\t= (int) ( ! empty($field['flags']) && in_array('primary_key', $field['flags'], TRUE));\n\t\t\t}\n\n\t\t\treturn $retval;\n\t\t}\n\t\tcatch (Exception $e)\n\t\t{\n\t\t\tif ($this->db->db_debug)\n\t\t\t{\n\t\t\t\treturn $this->db->display_error('db_unsupported_feature');\n\t\t\t}\n\n\t\t\treturn FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_object($this->result_id))\n\t\t{\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn $this->result_id->fetch(PDO::FETCH_ASSOC);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn $this->result_id->fetchObject($class_name);\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/pdo_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_4d_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = '4D:host='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\n\t\t\tempty($this->port) OR $this->dsn .= ';port='.$this->port;\n\t\t\tempty($this->database) OR $this->dsn .= ';dbname='.$this->database;\n\t\t\tempty($this->char_set) OR $this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t\telseif ( ! empty($this->char_set) && strpos($this->dsn, 'charset=', 3) === FALSE)\n\t\t{\n\t\t\t$this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT '.$this->escape_identifiers('TABLE_NAME').' FROM '.$this->escape_identifiers('_USER_TABLES');\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' WHERE '.$this->escape_identifiers('TABLE_NAME').\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT '.$this->escape_identifiers('COLUMN_NAME').' FROM '.$this->escape_identifiers('_USER_COLUMNS')\n\t\t\t.' WHERE '.$this->escape_identifiers('TABLE_NAME').' = '.$this->escape($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data query\n\t *\n\t * Generates a platform-specific query so that the column data can be retrieved\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _field_data($table)\n\t{\n\t\treturn 'SELECT * FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE).' LIMIT 1';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\treturn $sql.' LIMIT '.$this->qb_limit.($this->qb_offset ? ' OFFSET '.$this->qb_offset : '');\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_4d_forge.php", "content": " 'INT',\n\t\t'SMALLINT'\t=> 'INT',\n\t\t'INT'\t\t=> 'INT64',\n\t\t'INT32'\t\t=> 'INT64'\n\t);\n\n\t/**\n\t * DEFAULT value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_default\t\t= FALSE;\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('ADD', 'DROP'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t// No method of modifying columns is supported\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['null']\n\t\t\t.$field['unique']\n\t\t\t.$field['auto_increment'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INTEGER':\n\t\t\t\t$attributes['TYPE'] = 'INT';\n\t\t\t\treturn;\n\t\t\tcase 'BIGINT':\n\t\t\t\t$attributes['TYPE'] = 'INT64';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute UNIQUE\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_unique(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['UNIQUE']) && $attributes['UNIQUE'] === TRUE)\n\t\t{\n\t\t\t$field['unique'] = ' UNIQUE';\n\n\t\t\t// UNIQUE must be used with NOT NULL\n\t\t\t$field['null'] = ' NOT NULL';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE)\n\t\t{\n\t\t\tif (stripos($field['type'], 'int') !== FALSE)\n\t\t\t{\n\t\t\t\t$field['auto_increment'] = ' AUTO_INCREMENT';\n\t\t\t}\n\t\t\telseif (strcasecmp($field['type'], 'UUID') === 0)\n\t\t\t{\n\t\t\t\t$field['auto_increment'] = ' AUTO_GENERATE';\n\t\t\t}\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_cubrid_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'cubrid:host='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\n\t\t\tempty($this->port) OR $this->dsn .= ';port='.$this->port;\n\t\t\tempty($this->database) OR $this->dsn .= ';dbname='.$this->database;\n\t\t\tempty($this->char_set) OR $this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SHOW TABLES';\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%'\";\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE))) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->Field;\n\n\t\t\tsscanf($query[$i]->Type, '%[a-z](%d)',\n\t\t\t\t$retval[$i]->type,\n\t\t\t\t$retval[$i]->max_length\n\t\t\t);\n\n\t\t\t$retval[$i]->default\t\t= $query[$i]->Default;\n\t\t\t$retval[$i]->primary_key\t= (int) ($query[$i]->Key === 'PRI');\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * FROM tables\n\t *\n\t * Groups tables in FROM clauses if needed, so there is no confusion\n\t * about operator precedence.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _from_tables()\n\t{\n\t\tif ( ! empty($this->qb_join) && count($this->qb_from) > 1)\n\t\t{\n\t\t\treturn '('.implode(', ', $this->qb_from).')';\n\t\t}\n\n\t\treturn implode(', ', $this->qb_from);\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_cubrid_forge.php", "content": " 'INTEGER',\n\t\t'SMALLINT'\t=> 'INTEGER',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'INTEGER'\t=> 'BIGINT',\n\t\t'BIGINT'\t=> 'NUMERIC',\n\t\t'FLOAT'\t\t=> 'DOUBLE',\n\t\t'REAL'\t\t=> 'DOUBLE'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('DROP', 'ADD'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' CHANGE '.$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$alter_type = empty($field[$i]['new_name']) ? ' MODIFY ' : ' CHANGE ';\n\t\t\t\t$sqls[] = $sql.$alter_type.$this->_process_column($field[$i]);\n\t\t\t}\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\t$extra_clause = isset($field['after'])\n\t\t\t? ' AFTER '.$this->db->escape_identifiers($field['after']) : '';\n\n\t\tif (empty($extra_clause) && isset($field['first']) && $field['first'] === TRUE)\n\t\t{\n\t\t\t$extra_clause = ' FIRST';\n\t\t}\n\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.(empty($field['new_name']) ? '' : ' '.$this->db->escape_identifiers($field['new_name']))\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['null']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['unique']\n\t\t\t.$extra_clause;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'LONGTEXT':\n\t\t\t\t$attributes['TYPE'] = 'STRING';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process indexes\n\t *\n\t * @param\tstring\t$table\t(ignored)\n\t * @return\tstring\n\t */\n\tprotected function _process_indexes($table)\n\t{\n\t\t$sql = '';\n\n\t\tfor ($i = 0, $c = count($this->keys); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_array($this->keys[$i]))\n\t\t\t{\n\t\t\t\tfor ($i2 = 0, $c2 = count($this->keys[$i]); $i2 < $c2; $i2++)\n\t\t\t\t{\n\t\t\t\t\tif ( ! isset($this->fields[$this->keys[$i][$i2]]))\n\t\t\t\t\t{\n\t\t\t\t\t\tunset($this->keys[$i][$i2]);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! isset($this->fields[$this->keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->keys[$i]);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tis_array($this->keys[$i]) OR $this->keys[$i] = array($this->keys[$i]);\n\n\t\t\t$sql .= \",\\n\\tKEY \".$this->db->escape_identifiers(implode('_', $this->keys[$i]))\n\t\t\t\t.' ('.implode(', ', $this->db->escape_identifiers($this->keys[$i])).')';\n\t\t}\n\n\t\t$this->keys = array();\n\n\t\treturn $sql;\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_dblib_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = $params['subdriver'].':host='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\n\t\t\tif ( ! empty($this->port))\n\t\t\t{\n\t\t\t\t$this->dsn .= (DIRECTORY_SEPARATOR === '\\\\' ? ',' : ':').$this->port;\n\t\t\t}\n\n\t\t\tempty($this->database) OR $this->dsn .= ';dbname='.$this->database;\n\t\t\tempty($this->char_set) OR $this->dsn .= ';charset='.$this->char_set;\n\t\t\tempty($this->appname) OR $this->dsn .= ';appname='.$this->appname;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tif ( ! empty($this->char_set) && strpos($this->dsn, 'charset=', 6) === FALSE)\n\t\t\t{\n\t\t\t\t$this->dsn .= ';charset='.$this->char_set;\n\t\t\t}\n\n\t\t\t$this->subdriver = 'dblib';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tobject\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tif ($persistent === TRUE)\n\t\t{\n\t\t\tlog_message('debug', \"dblib driver doesn't support persistent connections\");\n\t\t}\n\n\t\t$this->conn_id = parent::db_connect(FALSE);\n\n\t\tif ( ! is_object($this->conn_id))\n\t\t{\n\t\t\treturn $this->conn_id;\n\t\t}\n\n\t\t// Determine how identifiers are escaped\n\t\t$query = $this->query('SELECT CASE WHEN (@@OPTIONS | 256) = @@OPTIONS THEN 1 ELSE 0 END AS qi');\n\t\t$query = $query->row_array();\n\t\t$this->_quoted_identifier = empty($query) ? FALSE : (bool) $query['qi'];\n\t\t$this->_escape_char = ($this->_quoted_identifier) ? '\"' : array('[', ']');\n\n\t\treturn $this->conn_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT '.$this->escape_identifiers('name')\n\t\t\t.' FROM '.$this->escape_identifiers('sysobjects')\n\t\t\t.' WHERE '.$this->escape_identifiers('type').\" = 'U'\";\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' AND '.$this->escape_identifiers('name').\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql.' ORDER BY '.$this->escape_identifiers('name');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT COLUMN_NAME\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT COLUMN_NAME, DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, NUMERIC_PRECISION, COLUMN_DEFAULT\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->COLUMN_NAME;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->DATA_TYPE;\n\t\t\t$retval[$i]->max_length\t\t= ($query[$i]->CHARACTER_MAXIMUM_LENGTH > 0) ? $query[$i]->CHARACTER_MAXIMUM_LENGTH : $query[$i]->NUMERIC_PRECISION;\n\t\t\t$retval[$i]->default\t\t= $query[$i]->COLUMN_DEFAULT;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\tif ($this->qb_limit)\n\t\t{\n\t\t\treturn 'WITH ci_delete AS (SELECT TOP '.$this->qb_limit.' * FROM '.$table.$this->_compile_wh('qb_where').') DELETE FROM ci_delete';\n\t\t}\n\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t$limit = $this->qb_offset + $this->qb_limit;\n\n\t\t// As of SQL Server 2005 (9.0.*) ROW_NUMBER() is supported,\n\t\t// however an ORDER BY clause is required for it to work\n\t\tif (version_compare($this->version(), '9', '>=') && $this->qb_offset && ! empty($this->qb_orderby))\n\t\t{\n\t\t\t$orderby = $this->_compile_order_by();\n\n\t\t\t// We have to strip the ORDER BY clause\n\t\t\t$sql = trim(substr($sql, 0, strrpos($sql, $orderby)));\n\n\t\t\t// Get the fields to select from our subquery, so that we can avoid CI_rownum appearing in the actual results\n\t\t\tif (count($this->qb_select) === 0 OR strpos(implode(',', $this->qb_select), '*') !== FALSE)\n\t\t\t{\n\t\t\t\t$select = '*'; // Inevitable\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Use only field names and their aliases, everything else is out of our scope.\n\t\t\t\t$select = array();\n\t\t\t\t$field_regexp = ($this->_quoted_identifier)\n\t\t\t\t\t? '(\"[^\\\"]+\")' : '(\\[[^\\]]+\\])';\n\t\t\t\tfor ($i = 0, $c = count($this->qb_select); $i < $c; $i++)\n\t\t\t\t{\n\t\t\t\t\t$select[] = preg_match('/(?:\\s|\\.)'.$field_regexp.'$/i', $this->qb_select[$i], $m)\n\t\t\t\t\t\t? $m[1] : $this->qb_select[$i];\n\t\t\t\t}\n\t\t\t\t$select = implode(', ', $select);\n\t\t\t}\n\n\t\t\treturn 'SELECT '.$select.\" FROM (\\n\\n\"\n\t\t\t\t.preg_replace('/^(SELECT( DISTINCT)?)/i', '\\\\1 ROW_NUMBER() OVER('.trim($orderby).') AS '.$this->escape_identifiers('CI_rownum').', ', $sql)\n\t\t\t\t.\"\\n\\n) \".$this->escape_identifiers('CI_subquery')\n\t\t\t\t.\"\\nWHERE \".$this->escape_identifiers('CI_rownum').' BETWEEN '.($this->qb_offset + 1).' AND '.$limit;\n\t\t}\n\n\t\treturn preg_replace('/(^\\SELECT (DISTINCT)?)/i','\\\\1 TOP '.$limit.' ', $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring|bool\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\t// Multiple-value inserts are only supported as of SQL Server 2008\n\t\tif (version_compare($this->version(), '10', '>='))\n\t\t{\n\t\t\treturn parent::_insert_batch($table, $keys, $values);\n\t\t}\n\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return string\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\treturn $this->data_cache['version'] = $this->conn_id->query(\"SELECT SERVERPROPERTY('ProductVersion') AS ver\")->fetchColumn(0);\n\t}\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_dblib_forge.php", "content": " 'SMALLINT',\n\t\t'SMALLINT'\t=> 'INT',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'REAL'\t\t=> 'FLOAT'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('ADD', 'DROP'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table).' ALTER COLUMN ';\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\t$sqls[] = $sql.$this->_process_column($field[$i]);\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tif (isset($attributes['CONSTRAINT']) && strpos($attributes['TYPE'], 'INT') !== FALSE)\n\t\t{\n\t\t\tunset($attributes['CONSTRAINT']);\n\t\t}\n\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INTEGER':\n\t\t\t\t$attributes['TYPE'] = 'INT';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['auto_increment'] = ' IDENTITY(1,1)';\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_firebird_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'firebird:';\n\n\t\t\tif ( ! empty($this->database))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'dbname='.$this->database;\n\t\t\t}\n\t\t\telseif ( ! empty($this->hostname))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'dbname='.$this->hostname;\n\t\t\t}\n\n\t\t\tempty($this->char_set) OR $this->dsn .= ';charset='.$this->char_set;\n\t\t\tempty($this->role) OR $this->dsn .= ';role='.$this->role;\n\t\t}\n\t\telseif ( ! empty($this->char_set) && strpos($this->dsn, 'charset=', 9) === FALSE)\n\t\t{\n\t\t\t$this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"RDB$RELATION_NAME\" FROM \"RDB$RELATIONS\" WHERE \"RDB$RELATION_NAME\" NOT LIKE \\'RDB$%\\' AND \"RDB$RELATION_NAME\" NOT LIKE \\'MON$%\\'';\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' AND \"RDB$RELATION_NAME\" LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT \"RDB$FIELD_NAME\" FROM \"RDB$RELATION_FIELDS\" WHERE \"RDB$RELATION_NAME\" = '.$this->escape($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT \"rfields\".\"RDB$FIELD_NAME\" AS \"name\",\n\t\t\t\tCASE \"fields\".\"RDB$FIELD_TYPE\"\n\t\t\t\t\tWHEN 7 THEN \\'SMALLINT\\'\n\t\t\t\t\tWHEN 8 THEN \\'INTEGER\\'\n\t\t\t\t\tWHEN 9 THEN \\'QUAD\\'\n\t\t\t\t\tWHEN 10 THEN \\'FLOAT\\'\n\t\t\t\t\tWHEN 11 THEN \\'DFLOAT\\'\n\t\t\t\t\tWHEN 12 THEN \\'DATE\\'\n\t\t\t\t\tWHEN 13 THEN \\'TIME\\'\n\t\t\t\t\tWHEN 14 THEN \\'CHAR\\'\n\t\t\t\t\tWHEN 16 THEN \\'INT64\\'\n\t\t\t\t\tWHEN 27 THEN \\'DOUBLE\\'\n\t\t\t\t\tWHEN 35 THEN \\'TIMESTAMP\\'\n\t\t\t\t\tWHEN 37 THEN \\'VARCHAR\\'\n\t\t\t\t\tWHEN 40 THEN \\'CSTRING\\'\n\t\t\t\t\tWHEN 261 THEN \\'BLOB\\'\n\t\t\t\t\tELSE NULL\n\t\t\t\tEND AS \"type\",\n\t\t\t\t\"fields\".\"RDB$FIELD_LENGTH\" AS \"max_length\",\n\t\t\t\t\"rfields\".\"RDB$DEFAULT_VALUE\" AS \"default\"\n\t\t\tFROM \"RDB$RELATION_FIELDS\" \"rfields\"\n\t\t\t\tJOIN \"RDB$FIELDS\" \"fields\" ON \"rfields\".\"RDB$FIELD_SOURCE\" = \"fields\".\"RDB$FIELD_NAME\"\n\t\t\tWHERE \"rfields\".\"RDB$RELATION_NAME\" = '.$this->escape($table).'\n\t\t\tORDER BY \"rfields\".\"RDB$FIELD_POSITION\"';\n\n\t\treturn (($query = $this->query($sql)) !== FALSE)\n\t\t\t? $query->result_object()\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'DELETE FROM '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t// Limit clause depends on if Interbase or Firebird\n\t\tif (stripos($this->version(), 'firebird') !== FALSE)\n\t\t{\n\t\t\t$select = 'FIRST '.$this->qb_limit\n\t\t\t\t.($this->qb_offset > 0 ? ' SKIP '.$this->qb_offset : '');\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$select = 'ROWS '\n\t\t\t\t.($this->qb_offset > 0 ? $this->qb_offset.' TO '.($this->qb_limit + $this->qb_offset) : $this->qb_limit);\n\t\t}\n\n\t\treturn preg_replace('`SELECT`i', 'SELECT '.$select, $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring|bool\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_firebird_forge.php", "content": " 'INTEGER',\n\t\t'INTEGER'\t=> 'INT64',\n\t\t'FLOAT'\t\t=> 'DOUBLE PRECISION'\n\t);\n\n\t/**\n\t * NULL value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_null\t\t= 'NULL';\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create database\n\t *\n\t * @param\tstring\t$db_name\n\t * @return\tstring\n\t */\n\tpublic function create_database($db_name)\n\t{\n\t\t// Firebird databases are flat files, so a path is required\n\n\t\t// Hostname is needed for remote access\n\t\tempty($this->db->hostname) OR $db_name = $this->hostname.':'.$db_name;\n\n\t\treturn parent::create_database('\"'.$db_name.'\"');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop database\n\t *\n\t * @param\tstring\t$db_name\t(ignored)\n\t * @return\tbool\n\t */\n\tpublic function drop_database($db_name)\n\t{\n\t\tif ( ! ibase_drop_db($this->conn_id))\n\t\t{\n\t\t\treturn ($this->db->db_debug) ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t\t}\n\t\telseif ( ! empty($this->db->data_cache['db_names']))\n\t\t{\n\t\t\t$key = array_search(strtolower($this->db->database), array_map('strtolower', $this->db->data_cache['db_names']), TRUE);\n\t\t\tif ($key !== FALSE)\n\t\t\t{\n\t\t\t\tunset($this->db->data_cache['db_names'][$key]);\n\t\t\t}\n\t\t}\n\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('DROP', 'ADD'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tif (isset($field[$i]['type']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TYPE '.$field[$i]['type'].$field[$i]['length'];\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['default']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' SET '.$field[$i]['default'];\n\t\t\t}\n\n\t\t\tif (isset($field[$i]['null']))\n\t\t\t{\n\t\t\t\t$sqls[] = 'UPDATE \"RDB$RELATION_FIELDS\" SET \"RDB$NULL_FLAG\" = '\n\t\t\t\t\t.($field[$i]['null'] === TRUE ? 'NULL' : '1')\n\t\t\t\t\t.' WHERE \"RDB$FIELD_NAME\" = '.$this->db->escape($field[$i]['name'])\n\t\t\t\t\t.' AND \"RDB$RELATION_NAME\" = '.$this->db->escape($table);\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['new_name']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TO '.$this->db->escape_identifiers($field[$i]['new_name']);\n\t\t\t}\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['null']\n\t\t\t.$field['unique']\n\t\t\t.$field['default'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\treturn;\n\t\t\tcase 'BIGINT':\n\t\t\t\t$attributes['TYPE'] = 'INT64';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\t// Not supported\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_ibm_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'ibm:';\n\n\t\t\t// Pre-defined DSN\n\t\t\tif (empty($this->hostname) && empty($this->HOSTNAME) && empty($this->port) && empty($this->PORT))\n\t\t\t{\n\t\t\t\tif (isset($this->DSN))\n\t\t\t\t{\n\t\t\t\t\t$this->dsn .= 'DSN='.$this->DSN;\n\t\t\t\t}\n\t\t\t\telseif ( ! empty($this->database))\n\t\t\t\t{\n\t\t\t\t\t$this->dsn .= 'DSN='.$this->database;\n\t\t\t\t}\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t$this->dsn .= 'DRIVER='.(isset($this->DRIVER) ? '{'.$this->DRIVER.'}' : '{IBM DB2 ODBC DRIVER}').';';\n\n\t\t\tif (isset($this->DATABASE))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'DATABASE='.$this->DATABASE.';';\n\t\t\t}\n\t\t\telseif ( ! empty($this->database))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'DATABASE='.$this->database.';';\n\t\t\t}\n\n\t\t\tif (isset($this->HOSTNAME))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'HOSTNAME='.$this->HOSTNAME.';';\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$this->dsn .= 'HOSTNAME='.(empty($this->hostname) ? '127.0.0.1;' : $this->hostname.';');\n\t\t\t}\n\n\t\t\tif (isset($this->PORT))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'PORT='.$this->port.';';\n\t\t\t}\n\t\t\telseif ( ! empty($this->port))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';PORT='.$this->port.';';\n\t\t\t}\n\n\t\t\t$this->dsn .= 'PROTOCOL='.(isset($this->PROTOCOL) ? $this->PROTOCOL.';' : 'TCPIP;');\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"tabname\" FROM \"syscat\".\"tables\"\n\t\t\tWHERE \"type\" = \\'T\\' AND LOWER(\"tabschema\") = '.$this->escape(strtolower($this->database));\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' AND \"tabname\" LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT \"colname\" FROM \"syscat\".\"columns\"\n\t\t\tWHERE LOWER(\"tabschema\") = '.$this->escape(strtolower($this->database)).'\n\t\t\t\tAND LOWER(\"tabname\") = '.$this->escape(strtolower($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT \"colname\" AS \"name\", \"typename\" AS \"type\", \"default\" AS \"default\", \"length\" AS \"max_length\",\n\t\t\t\tCASE \"keyseq\" WHEN NULL THEN 0 ELSE 1 END AS \"primary_key\"\n\t\t\tFROM \"syscat\".\"columns\"\n\t\t\tWHERE LOWER(\"tabschema\") = '.$this->escape(strtolower($this->database)).'\n\t\t\t\tAND LOWER(\"tabname\") = '.$this->escape(strtolower($table)).'\n\t\t\tORDER BY \"colno\"';\n\n\t\treturn (($query = $this->query($sql)) !== FALSE)\n\t\t\t? $query->result_object()\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t$sql .= ' FETCH FIRST '.($this->qb_limit + $this->qb_offset).' ROWS ONLY';\n\n\t\treturn ($this->qb_offset)\n\t\t\t? 'SELECT * FROM ('.$sql.') WHERE rownum > '.$this->qb_offset\n\t\t\t: $sql;\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_ibm_forge.php", "content": " 'INTEGER',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'INTEGER'\t=> 'BIGINT'\n\t);\n\n\t/**\n\t * DEFAULT value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_default\t\t= FALSE;\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'CHANGE')\n\t\t{\n\t\t\t$alter_type = 'MODIFY';\n\t\t}\n\n\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute UNIQUE\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_unique(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['UNIQUE']) && $attributes['UNIQUE'] === TRUE)\n\t\t{\n\t\t\t$field['unique'] = ' UNIQUE';\n\n\t\t\t// UNIQUE must be used with NOT NULL\n\t\t\t$field['null'] = ' NOT NULL';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\t// Not supported\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_informix_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'informix:';\n\n\t\t\t// Pre-defined DSN\n\t\t\tif (empty($this->hostname) && empty($this->host) && empty($this->port) && empty($this->service))\n\t\t\t{\n\t\t\t\tif (isset($this->DSN))\n\t\t\t\t{\n\t\t\t\t\t$this->dsn .= 'DSN='.$this->DSN;\n\t\t\t\t}\n\t\t\t\telseif ( ! empty($this->database))\n\t\t\t\t{\n\t\t\t\t\t$this->dsn .= 'DSN='.$this->database;\n\t\t\t\t}\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (isset($this->host))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'host='.$this->host;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$this->dsn .= 'host='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\t\t\t}\n\n\t\t\tif (isset($this->service))\n\t\t\t{\n\t\t\t\t$this->dsn .= '; service='.$this->service;\n\t\t\t}\n\t\t\telseif ( ! empty($this->port))\n\t\t\t{\n\t\t\t\t$this->dsn .= '; service='.$this->port;\n\t\t\t}\n\n\t\t\tempty($this->database) OR $this->dsn .= '; database='.$this->database;\n\t\t\tempty($this->server) OR $this->dsn .= '; server='.$this->server;\n\n\t\t\t$this->dsn .= '; protocol='.(isset($this->protocol) ? $this->protocol : 'onsoctcp')\n\t\t\t\t.'; EnableScrollableCursors=1';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"tabname\" FROM \"systables\"\n\t\t\tWHERE \"tabid\" > 99 AND \"tabtype\" = \\'T\\' AND LOWER(\"owner\") = '.$this->escape(strtolower($this->username));\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' AND \"tabname\" LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\tif (strpos($table, '.') !== FALSE)\n\t\t{\n\t\t\tsscanf($table, '%[^.].%s', $owner, $table);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$owner = $this->username;\n\t\t}\n\n\t\treturn 'SELECT \"colname\" FROM \"systables\", \"syscolumns\"\n\t\t\tWHERE \"systables\".\"tabid\" = \"syscolumns\".\"tabid\"\n\t\t\t\tAND \"systables\".\"tabtype\" = \\'T\\'\n\t\t\t\tAND LOWER(\"systables\".\"owner\") = '.$this->escape(strtolower($owner)).'\n\t\t\t\tAND LOWER(\"systables\".\"tabname\") = '.$this->escape(strtolower($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT \"syscolumns\".\"colname\" AS \"name\",\n\t\t\t\tCASE \"syscolumns\".\"coltype\"\n\t\t\t\t\tWHEN 0 THEN \\'CHAR\\'\n\t\t\t\t\tWHEN 1 THEN \\'SMALLINT\\'\n\t\t\t\t\tWHEN 2 THEN \\'INTEGER\\'\n\t\t\t\t\tWHEN 3 THEN \\'FLOAT\\'\n\t\t\t\t\tWHEN 4 THEN \\'SMALLFLOAT\\'\n\t\t\t\t\tWHEN 5 THEN \\'DECIMAL\\'\n\t\t\t\t\tWHEN 6 THEN \\'SERIAL\\'\n\t\t\t\t\tWHEN 7 THEN \\'DATE\\'\n\t\t\t\t\tWHEN 8 THEN \\'MONEY\\'\n\t\t\t\t\tWHEN 9 THEN \\'NULL\\'\n\t\t\t\t\tWHEN 10 THEN \\'DATETIME\\'\n\t\t\t\t\tWHEN 11 THEN \\'BYTE\\'\n\t\t\t\t\tWHEN 12 THEN \\'TEXT\\'\n\t\t\t\t\tWHEN 13 THEN \\'VARCHAR\\'\n\t\t\t\t\tWHEN 14 THEN \\'INTERVAL\\'\n\t\t\t\t\tWHEN 15 THEN \\'NCHAR\\'\n\t\t\t\t\tWHEN 16 THEN \\'NVARCHAR\\'\n\t\t\t\t\tWHEN 17 THEN \\'INT8\\'\n\t\t\t\t\tWHEN 18 THEN \\'SERIAL8\\'\n\t\t\t\t\tWHEN 19 THEN \\'SET\\'\n\t\t\t\t\tWHEN 20 THEN \\'MULTISET\\'\n\t\t\t\t\tWHEN 21 THEN \\'LIST\\'\n\t\t\t\t\tWHEN 22 THEN \\'Unnamed ROW\\'\n\t\t\t\t\tWHEN 40 THEN \\'LVARCHAR\\'\n\t\t\t\t\tWHEN 41 THEN \\'BLOB/CLOB/BOOLEAN\\'\n\t\t\t\t\tWHEN 4118 THEN \\'Named ROW\\'\n\t\t\t\t\tELSE \"syscolumns\".\"coltype\"\n\t\t\t\tEND AS \"type\",\n\t\t\t\t\"syscolumns\".\"collength\" as \"max_length\",\n\t\t\t\tCASE \"sysdefaults\".\"type\"\n\t\t\t\t\tWHEN \\'L\\' THEN \"sysdefaults\".\"default\"\n\t\t\t\t\tELSE NULL\n\t\t\t\tEND AS \"default\"\n\t\t\tFROM \"syscolumns\", \"systables\", \"sysdefaults\"\n\t\t\tWHERE \"syscolumns\".\"tabid\" = \"systables\".\"tabid\"\n\t\t\t\tAND \"systables\".\"tabid\" = \"sysdefaults\".\"tabid\"\n\t\t\t\tAND \"syscolumns\".\"colno\" = \"sysdefaults\".\"colno\"\n\t\t\t\tAND \"systables\".\"tabtype\" = \\'T\\'\n\t\t\t\tAND LOWER(\"systables\".\"owner\") = '.$this->escape(strtolower($this->username)).'\n\t\t\t\tAND LOWER(\"systables\".\"tabname\") = '.$this->escape(strtolower($table)).'\n\t\t\tORDER BY \"syscolumns\".\"colno\"';\n\n\t\treturn (($query = $this->query($sql)) !== FALSE)\n\t\t\t? $query->result_object()\n\t\t\t: FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE TABLE ONLY '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\t$SQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t$select = 'SELECT '.($this->qb_offset ? 'SKIP '.$this->qb_offset : '').'FIRST '.$this->qb_limit.' ';\n\t\treturn preg_replace('/^(SELECT\\s)/i', $select, $sql, 1);\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_informix_forge.php", "content": " 'INTEGER',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'INTEGER'\t=> 'BIGINT',\n\t\t'REAL'\t\t=> 'DOUBLE PRECISION',\n\t\t'SMALLFLOAT'\t=> 'DOUBLE PRECISION'\n\t);\n\n\t/**\n\t * DEFAULT value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_default\t\t= ', ';\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'CHANGE')\n\t\t{\n\t\t\t$alter_type = 'MODIFY';\n\t\t}\n\n\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'BYTE':\n\t\t\tcase 'TEXT':\n\t\t\tcase 'BLOB':\n\t\t\tcase 'CLOB':\n\t\t\t\t$attributes['UNIQUE'] = FALSE;\n\t\t\t\tif (isset($attributes['DEFAULT']))\n\t\t\t\t{\n\t\t\t\t\tunset($attributes['DEFAULT']);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute UNIQUE\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_unique(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['UNIQUE']) && $attributes['UNIQUE'] === TRUE)\n\t\t{\n\t\t\t$field['unique'] = ' UNIQUE CONSTRAINT '.$this->db->escape_identifiers($field['name']);\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\t// Not supported\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_mysql_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'mysql:host='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\n\t\t\tempty($this->port) OR $this->dsn .= ';port='.$this->port;\n\t\t\tempty($this->database) OR $this->dsn .= ';dbname='.$this->database;\n\t\t\tempty($this->char_set) OR $this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t\telseif ( ! empty($this->char_set) && strpos($this->dsn, 'charset=', 6) === FALSE)\n\t\t{\n\t\t\t$this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tobject\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tif (isset($this->stricton))\n\t\t{\n\t\t\tif ($this->stricton)\n\t\t\t{\n\t\t\t\t$sql = 'CONCAT(@@sql_mode, \",\", \"STRICT_ALL_TABLES\")';\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$sql = 'REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(\n @@sql_mode,\n \"STRICT_ALL_TABLES,\", \"\"),\n \",STRICT_ALL_TABLES\", \"\"),\n \"STRICT_ALL_TABLES\", \"\"),\n \"STRICT_TRANS_TABLES,\", \"\"),\n \",STRICT_TRANS_TABLES\", \"\"),\n \"STRICT_TRANS_TABLES\", \"\")';\n\t\t\t}\n\n\t\t\tif ( ! empty($sql))\n\t\t\t{\n\t\t\t\tif (empty($this->options[PDO::MYSQL_ATTR_INIT_COMMAND]))\n\t\t\t\t{\n\t\t\t\t\t$this->options[PDO::MYSQL_ATTR_INIT_COMMAND] = 'SET SESSION sql_mode = '.$sql;\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$this->options[PDO::MYSQL_ATTR_INIT_COMMAND] .= ', @@session.sql_mode = '.$sql;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ($this->compress === TRUE)\n\t\t{\n\t\t\t$this->options[PDO::MYSQL_ATTR_COMPRESS] = TRUE;\n\t\t}\n\n\t\tif (is_array($this->encrypt))\n\t\t{\n\t\t\t$ssl = array();\n\t\t\tempty($this->encrypt['ssl_key']) OR $ssl[PDO::MYSQL_ATTR_SSL_KEY] = $this->encrypt['ssl_key'];\n\t\t\tempty($this->encrypt['ssl_cert']) OR $ssl[PDO::MYSQL_ATTR_SSL_CERT] = $this->encrypt['ssl_cert'];\n\t\t\tempty($this->encrypt['ssl_ca']) OR $ssl[PDO::MYSQL_ATTR_SSL_CA] = $this->encrypt['ssl_ca'];\n\t\t\tempty($this->encrypt['ssl_capath']) OR $ssl[PDO::MYSQL_ATTR_SSL_CAPATH] = $this->encrypt['ssl_capath'];\n\t\t\tempty($this->encrypt['ssl_cipher']) OR $ssl[PDO::MYSQL_ATTR_SSL_CIPHER] = $this->encrypt['ssl_cipher'];\n\n\t\t\tif (defined('PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT') && isset($this->encrypt['ssl_verify']))\n\t\t\t{\n\t\t\t\t$ssl[PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = $this->encrypt['ssl_verify'];\n\t\t\t}\n\n\t\t\t// DO NOT use array_merge() here!\n\t\t\t// It re-indexes numeric keys and the PDO_MYSQL_ATTR_SSL_* constants are integers.\n\t\t\tempty($ssl) OR $this->options += $ssl;\n\t\t}\n\n\t\t// Prior to version 5.7.3, MySQL silently downgrades to an unencrypted connection if SSL setup fails\n\t\tif (\n\t\t\t($pdo = parent::db_connect($persistent)) !== FALSE\n\t\t\t&& ! empty($ssl)\n\t\t\t&& version_compare($pdo->getAttribute(PDO::ATTR_CLIENT_VERSION), '5.7.3', '<=')\n\t\t\t&& empty($pdo->query(\"SHOW STATUS LIKE 'ssl_cipher'\")->fetchObject()->Value)\n\t\t)\n\t\t{\n\t\t\t$message = 'PDO_MYSQL was configured for an SSL connection, but got an unencrypted connection instead!';\n\t\t\tlog_message('error', $message);\n\t\t\treturn ($this->db_debug) ? $this->display_error($message, '', TRUE) : FALSE;\n\t\t}\n\n\t\treturn $pdo;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select the database\n\t *\n\t * @param\tstring\t$database\n\t * @return\tbool\n\t */\n\tpublic function db_select($database = '')\n\t{\n\t\tif ($database === '')\n\t\t{\n\t\t\t$database = $this->database;\n\t\t}\n\n\t\tif (FALSE !== $this->simple_query('USE '.$this->escape_identifiers($database)))\n\t\t{\n\t\t\t$this->database = $database;\n\t\t\t$this->data_cache = array();\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\t$this->conn_id->setAttribute(PDO::ATTR_AUTOCOMMIT, FALSE);\n\t\treturn $this->conn_id->beginTransaction();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\tif ($this->conn_id->commit())\n\t\t{\n\t\t\t$this->conn_id->setAttribute(PDO::ATTR_AUTOCOMMIT, TRUE);\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\tif ($this->conn_id->rollBack())\n\t\t{\n\t\t\t$this->conn_id->setAttribute(PDO::ATTR_AUTOCOMMIT, TRUE);\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SHOW TABLES FROM '.$this->_escape_char.$this->database.$this->_escape_char;\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%'\";\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('SHOW COLUMNS FROM '.$this->protect_identifiers($table, TRUE, NULL, FALSE))) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->Field;\n\n\t\t\tsscanf($query[$i]->Type, '%[a-z](%d)',\n\t\t\t\t$retval[$i]->type,\n\t\t\t\t$retval[$i]->max_length\n\t\t\t);\n\n\t\t\t$retval[$i]->default\t\t= $query[$i]->Default;\n\t\t\t$retval[$i]->primary_key\t= (int) ($query[$i]->Key === 'PRI');\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * FROM tables\n\t *\n\t * Groups tables in FROM clauses if needed, so there is no confusion\n\t * about operator precedence.\n\t *\n\t * @return\tstring\n\t */\n\tprotected function _from_tables()\n\t{\n\t\tif ( ! empty($this->qb_join) && count($this->qb_from) > 1)\n\t\t{\n\t\t\treturn '('.implode(', ', $this->qb_from).')';\n\t\t}\n\n\t\treturn implode(', ', $this->qb_from);\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_mysql_forge.php", "content": "db->char_set) && ! strpos($sql, 'CHARACTER SET') && ! strpos($sql, 'CHARSET'))\n\t\t{\n\t\t\t$sql .= ' DEFAULT CHARACTER SET = '.$this->db->char_set;\n\t\t}\n\n\t\tif ( ! empty($this->db->dbcollat) && ! strpos($sql, 'COLLATE'))\n\t\t{\n\t\t\t$sql .= ' COLLATE = '.$this->db->dbcollat;\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'DROP')\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$field[$i] = ($alter_type === 'ADD')\n\t\t\t\t\t\t? \"\\n\\tADD \".$field[$i]['_literal']\n\t\t\t\t\t\t: \"\\n\\tMODIFY \".$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tif ($alter_type === 'ADD')\n\t\t\t\t{\n\t\t\t\t\t$field[$i]['_literal'] = \"\\n\\tADD \";\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$field[$i]['_literal'] = empty($field[$i]['new_name']) ? \"\\n\\tMODIFY \" : \"\\n\\tCHANGE \";\n\t\t\t\t}\n\n\t\t\t\t$field[$i] = $field[$i]['_literal'].$this->_process_column($field[$i]);\n\t\t\t}\n\t\t}\n\n\t\treturn array($sql.implode(',', $field));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\t$extra_clause = isset($field['after'])\n\t\t\t? ' AFTER '.$this->db->escape_identifiers($field['after']) : '';\n\n\t\tif (empty($extra_clause) && isset($field['first']) && $field['first'] === TRUE)\n\t\t{\n\t\t\t$extra_clause = ' FIRST';\n\t\t}\n\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.(empty($field['new_name']) ? '' : ' '.$this->db->escape_identifiers($field['new_name']))\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['null']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['unique']\n\t\t\t.(empty($field['comment']) ? '' : ' COMMENT '.$field['comment'])\n\t\t\t.$extra_clause;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process indexes\n\t *\n\t * @param\tstring\t$table\t(ignored)\n\t * @return\tstring\n\t */\n\tprotected function _process_indexes($table)\n\t{\n\t\t$sql = '';\n\n\t\tfor ($i = 0, $c = count($this->keys); $i < $c; $i++)\n\t\t{\n\t\t\tif (is_array($this->keys[$i]))\n\t\t\t{\n\t\t\t\tfor ($i2 = 0, $c2 = count($this->keys[$i]); $i2 < $c2; $i2++)\n\t\t\t\t{\n\t\t\t\t\tif ( ! isset($this->fields[$this->keys[$i][$i2]]))\n\t\t\t\t\t{\n\t\t\t\t\t\tunset($this->keys[$i][$i2]);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif ( ! isset($this->fields[$this->keys[$i]]))\n\t\t\t{\n\t\t\t\tunset($this->keys[$i]);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tis_array($this->keys[$i]) OR $this->keys[$i] = array($this->keys[$i]);\n\n\t\t\t$sql .= \",\\n\\tKEY \".$this->db->escape_identifiers(implode('_', $this->keys[$i]))\n\t\t\t\t.' ('.implode(', ', $this->db->escape_identifiers($this->keys[$i])).')';\n\t\t}\n\n\t\t$this->keys = array();\n\n\t\treturn $sql;\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_oci_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'oci:dbname=';\n\n\t\t\t// Oracle has a slightly different PDO DSN format (Easy Connect),\n\t\t\t// which also supports pre-defined DSNs.\n\t\t\tif (empty($this->hostname) && empty($this->port))\n\t\t\t{\n\t\t\t\t$this->dsn .= $this->database;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$this->dsn .= '//'.(empty($this->hostname) ? '127.0.0.1' : $this->hostname)\n\t\t\t\t\t.(empty($this->port) ? '' : ':'.$this->port).'/';\n\n\t\t\t\tempty($this->database) OR $this->dsn .= $this->database;\n\t\t\t}\n\n\t\t\tempty($this->char_set) OR $this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t\telseif ( ! empty($this->char_set) && strpos($this->dsn, 'charset=', 4) === FALSE)\n\t\t{\n\t\t\t$this->dsn .= ';charset='.$this->char_set;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\t$version_string = parent::version();\n\t\tif (preg_match('#(Release\\s)?(?\\d+(?:\\.\\d+)+)#', $version_string, $match))\n\t\t{\n\t\t\treturn $this->data_cache['version'] = $match['version'];\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"TABLE_NAME\" FROM \"ALL_TABLES\"';\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' WHERE \"TABLE_NAME\" LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\tif (strpos($table, '.') !== FALSE)\n\t\t{\n\t\t\tsscanf($table, '%[^.].%s', $owner, $table);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$owner = $this->username;\n\t\t}\n\n\t\treturn 'SELECT COLUMN_NAME FROM ALL_TAB_COLUMNS\n\t\t\tWHERE UPPER(OWNER) = '.$this->escape(strtoupper($owner)).'\n\t\t\t\tAND UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (strpos($table, '.') !== FALSE)\n\t\t{\n\t\t\tsscanf($table, '%[^.].%s', $owner, $table);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$owner = $this->username;\n\t\t}\n\n\t\t$sql = 'SELECT COLUMN_NAME, DATA_TYPE, CHAR_LENGTH, DATA_PRECISION, DATA_LENGTH, DATA_DEFAULT, NULLABLE\n\t\t\tFROM ALL_TAB_COLUMNS\n\t\t\tWHERE UPPER(OWNER) = '.$this->escape(strtoupper($owner)).'\n\t\t\t\tAND UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->COLUMN_NAME;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->DATA_TYPE;\n\n\t\t\t$length = ($query[$i]->CHAR_LENGTH > 0)\n\t\t\t\t? $query[$i]->CHAR_LENGTH : $query[$i]->DATA_PRECISION;\n\t\t\tif ($length === NULL)\n\t\t\t{\n\t\t\t\t$length = $query[$i]->DATA_LENGTH;\n\t\t\t}\n\t\t\t$retval[$i]->max_length\t\t= $length;\n\n\t\t\t$default = $query[$i]->DATA_DEFAULT;\n\t\t\tif ($default === NULL && $query[$i]->NULLABLE === 'N')\n\t\t\t{\n\t\t\t\t$default = '';\n\t\t\t}\n\t\t\t$retval[$i]->default\t\t= $query[$i]->COLUMN_DEFAULT;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return \tstring\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\t$keys = implode(', ', $keys);\n\t\t$sql = \"INSERT ALL\\n\";\n\n\t\tfor ($i = 0, $c = count($values); $i < $c; $i++)\n\t\t{\n\t\t\t$sql .= '\tINTO '.$table.' ('.$keys.') VALUES '.$values[$i].\"\\n\";\n\t\t}\n\n\t\treturn $sql.'SELECT * FROM dual';\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\tif ($this->qb_limit)\n\t\t{\n\t\t\t$this->where('rownum <= ',$this->qb_limit, FALSE);\n\t\t\t$this->qb_limit = FALSE;\n\t\t}\n\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\tif (version_compare($this->version(), '12.1', '>='))\n\t\t{\n\t\t\t// OFFSET-FETCH can be used only with the ORDER BY clause\n\t\t\tempty($this->qb_orderby) && $sql .= ' ORDER BY 1';\n\n\t\t\treturn $sql.' OFFSET '.(int) $this->qb_offset.' ROWS FETCH NEXT '.$this->qb_limit.' ROWS ONLY';\n\t\t}\n\n\t\treturn 'SELECT * FROM (SELECT inner_query.*, rownum rnum FROM ('.$sql.') inner_query WHERE rownum < '.($this->qb_offset + $this->qb_limit + 1).')'\n\t\t\t.($this->qb_offset ? ' WHERE rnum >= '.($this->qb_offset + 1): '');\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_oci_forge.php", "content": "db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\t$field[$i] = \"\\n\\t\".$field[$i]['_literal'];\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$field[$i]['_literal'] = \"\\n\\t\".$this->_process_column($field[$i]);\n\n\t\t\t\tif ( ! empty($field[$i]['comment']))\n\t\t\t\t{\n\t\t\t\t\t$sqls[] = 'COMMENT ON COLUMN '\n\t\t\t\t\t\t.$this->db->escape_identifiers($table).'.'.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t\t.' IS '.$field[$i]['comment'];\n\t\t\t\t}\n\n\t\t\t\tif ($alter_type === 'MODIFY' && ! empty($field[$i]['new_name']))\n\t\t\t\t{\n\t\t\t\t\t$sqls[] = $sql.' RENAME COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t\t.' TO '.$this->db->escape_identifiers($field[$i]['new_name']);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$sql .= ' '.$alter_type.' ';\n\t\t$sql .= (count($field) === 1)\n\t\t\t\t? $field[0]\n\t\t\t\t: '('.implode(',', $field).')';\n\n\t\t// RENAME COLUMN must be executed after MODIFY\n\t\tarray_unshift($sqls, $sql);\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'number') !== FALSE && version_compare($this->db->version(), '12.1', '>='))\n\t\t{\n\t\t\t$field['auto_increment'] = ' GENERATED ALWAYS AS IDENTITY';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type'].$field['length']\n\t\t\t.$field['unsigned']\n\t\t\t.$field['default']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['null']\n\t\t\t.$field['unique'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tcase 'INT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tcase 'BIGINT':\n\t\t\t\t$attributes['TYPE'] = 'NUMBER';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_odbc_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'odbc:';\n\n\t\t\t// Pre-defined DSN\n\t\t\tif (empty($this->hostname) && empty($this->HOSTNAME) && empty($this->port) && empty($this->PORT))\n\t\t\t{\n\t\t\t\tif (isset($this->DSN))\n\t\t\t\t{\n\t\t\t\t\t$this->dsn .= 'DSN='.$this->DSN;\n\t\t\t\t}\n\t\t\t\telseif ( ! empty($this->database))\n\t\t\t\t{\n\t\t\t\t\t$this->dsn .= 'DSN='.$this->database;\n\t\t\t\t}\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// If the DSN is not pre-configured - try to build an IBM DB2 connection string\n\t\t\t$this->dsn .= 'DRIVER='.(isset($this->DRIVER) ? '{'.$this->DRIVER.'}' : '{IBM DB2 ODBC DRIVER}').';';\n\n\t\t\tif (isset($this->DATABASE))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'DATABASE='.$this->DATABASE.';';\n\t\t\t}\n\t\t\telseif ( ! empty($this->database))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'DATABASE='.$this->database.';';\n\t\t\t}\n\n\t\t\tif (isset($this->HOSTNAME))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'HOSTNAME='.$this->HOSTNAME.';';\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$this->dsn .= 'HOSTNAME='.(empty($this->hostname) ? '127.0.0.1;' : $this->hostname.';');\n\t\t\t}\n\n\t\t\tif (isset($this->PORT))\n\t\t\t{\n\t\t\t\t$this->dsn .= 'PORT='.$this->port.';';\n\t\t\t}\n\t\t\telseif ( ! empty($this->port))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';PORT='.$this->port.';';\n\t\t\t}\n\n\t\t\t$this->dsn .= 'PROTOCOL='.(isset($this->PROTOCOL) ? $this->PROTOCOL.';' : 'TCPIP;');\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\t$this->display_error('db_unsupported_feature');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determines if a query is a \"write\" type.\n\t *\n\t * @param\tstring\tAn SQL query string\n\t * @return\tbool\n\t */\n\tpublic function is_write_type($sql)\n\t{\n\t\tif (preg_match('#^(INSERT|UPDATE).*RETURNING\\s.+(\\,\\s?.+)*$#is', $sql))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn parent::is_write_type($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = \"SELECT table_name FROM information_schema.tables WHERE table_schema = '\".$this->schema.\"'\";\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.\" AND table_name LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT column_name FROM information_schema.columns WHERE table_name = '.$this->escape($table);\n\t}\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_odbc_forge.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'pgsql:host='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\n\t\t\tempty($this->port) OR $this->dsn .= ';port='.$this->port;\n\t\t\tempty($this->database) OR $this->dsn .= ';dbname='.$this->database;\n\n\t\t\tif ( ! empty($this->username))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';user='.$this->username;\n\t\t\t\tempty($this->password) OR $this->dsn .= ';password='.$this->password;\n\t\t\t}\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tobject\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\t$this->conn_id = parent::db_connect($persistent);\n\n\t\tif (is_object($this->conn_id) && ! empty($this->schema))\n\t\t{\n\t\t\t$this->simple_query('SET search_path TO '.$this->schema.',public');\n\t\t}\n\n\t\treturn $this->conn_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @param\tstring\t$name\n\t * @return\tint\n\t */\n\tpublic function insert_id($name = NULL)\n\t{\n\t\tif ($name === NULL && version_compare($this->version(), '8.1', '>='))\n\t\t{\n\t\t\t$query = $this->query('SELECT LASTVAL() AS ins_id');\n\t\t\t$query = $query->row();\n\t\t\treturn $query->ins_id;\n\t\t}\n\n\t\treturn $this->conn_id->lastInsertId($name);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determines if a query is a \"write\" type.\n\t *\n\t * @param\tstring\tAn SQL query string\n\t * @return\tbool\n\t */\n\tpublic function is_write_type($sql)\n\t{\n\t\tif (preg_match('#^(INSERT|UPDATE).*RETURNING\\s.+(\\,\\s?.+)*$#is', $sql))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn parent::is_write_type($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * \"Smart\" Escape String\n\t *\n\t * Escapes data based on type\n\t *\n\t * @param\tstring\t$str\n\t * @return\tmixed\n\t */\n\tpublic function escape($str)\n\t{\n\t\tif (is_bool($str))\n\t\t{\n\t\t\treturn ($str) ? 'TRUE' : 'FALSE';\n\t\t}\n\n\t\treturn parent::escape($str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ORDER BY\n\t *\n\t * @param\tstring\t$orderby\n\t * @param\tstring\t$direction\tASC, DESC or RANDOM\n\t * @param\tbool\t$escape\n\t * @return\tobject\n\t */\n\tpublic function order_by($orderby, $direction = '', $escape = NULL)\n\t{\n\t\t$direction = strtoupper(trim($direction));\n\t\tif ($direction === 'RANDOM')\n\t\t{\n\t\t\tif ( ! is_float($orderby) && ctype_digit((string) $orderby))\n\t\t\t{\n\t\t\t\t$orderby = ($orderby > 1)\n\t\t\t\t\t? (float) '0.'.$orderby\n\t\t\t\t\t: (float) $orderby;\n\t\t\t}\n\n\t\t\tif (is_float($orderby))\n\t\t\t{\n\t\t\t\t$this->simple_query('SET SEED '.$orderby);\n\t\t\t}\n\n\t\t\t$orderby = $this->_random_keyword[0];\n\t\t\t$direction = '';\n\t\t\t$escape = FALSE;\n\t\t}\n\n\t\treturn parent::order_by($orderby, $direction, $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"table_name\" FROM \"information_schema\".\"tables\" WHERE \"table_schema\" = \\''.$this->schema.\"'\";\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' AND \"table_name\" LIKE \\''\n\t\t\t\t.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT \"column_name\"\n\t\t\tFROM \"information_schema\".\"columns\"\n\t\t\tWHERE \"table_schema\" = \\''.$this->schema.'\\' AND LOWER(\"table_name\") = '.$this->escape(strtolower($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT \"column_name\", \"data_type\", \"character_maximum_length\", \"numeric_precision\", \"column_default\"\n\t\t\tFROM \"information_schema\".\"columns\"\n\t\t\tWHERE \"table_schema\" = \\''.$this->schema.'\\' AND LOWER(\"table_name\") = '.$this->escape(strtolower($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->column_name;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->data_type;\n\t\t\t$retval[$i]->max_length\t\t= ($query[$i]->character_maximum_length > 0) ? $query[$i]->character_maximum_length : $query[$i]->numeric_precision;\n\t\t\t$retval[$i]->default\t\t= $query[$i]->column_default;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update_Batch statement\n\t *\n\t * Generates a platform-specific batch update string from the supplied data\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$values\tUpdate data\n\t * @param\tstring\t$index\tWHERE key\n\t * @return\tstring\n\t */\n\tprotected function _update_batch($table, $values, $index)\n\t{\n\t\t$ids = array();\n\t\tforeach ($values as $key => $val)\n\t\t{\n\t\t\t$ids[] = $val[$index]['value'];\n\n\t\t\tforeach (array_keys($val) as $field)\n\t\t\t{\n\t\t\t\tif ($field !== $index)\n\t\t\t\t{\n\t\t\t\t\t$final[$val[$field]['field']][] = 'WHEN '.$val[$index]['value'].' THEN '.$val[$field]['value'];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$cases = '';\n\t\tforeach ($final as $k => $v)\n\t\t{\n\t\t\t$cases .= $k.' = (CASE '.$val[$index]['field'].\"\\n\"\n\t\t\t\t.implode(\"\\n\", $v).\"\\n\"\n\t\t\t\t.'ELSE '.$k.' END), ';\n\t\t}\n\n\t\t$this->where($val[$index]['field'].' IN('.implode(',', $ids).')', NULL, FALSE);\n\n\t\treturn 'UPDATE '.$table.' SET '.substr($cases, 0, -2).$this->_compile_wh('qb_where');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\treturn $sql.' LIMIT '.$this->qb_limit.($this->qb_offset ? ' OFFSET '.$this->qb_offset : '');\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_pgsql_forge.php", "content": " 'INTEGER',\n\t\t'SMALLINT'\t=> 'INTEGER',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'INT4'\t\t=> 'BIGINT',\n\t\t'INTEGER'\t=> 'BIGINT',\n\t\t'INT8'\t\t=> 'NUMERIC',\n\t\t'BIGINT'\t=> 'NUMERIC',\n\t\t'REAL'\t\t=> 'DOUBLE PRECISION',\n\t\t'FLOAT'\t\t=> 'DOUBLE PRECISION'\n\t);\n\n\t/**\n\t * NULL value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_null = 'NULL';\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Class constructor\n\t *\n\t * @param\tobject\t&$db\tDatabase object\n\t * @return\tvoid\n\t */\n\tpublic function __construct(&$db)\n\t{\n\t\tparent::__construct($db);\n\n\t\tif (version_compare($this->db->version(), '9.0', '>'))\n\t\t{\n\t\t\t$this->create_table_if = 'CREATE TABLE IF NOT EXISTS';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('DROP', 'ADD'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tif (version_compare($this->db->version(), '8', '>=') && isset($field[$i]['type']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TYPE '.$field[$i]['type'].$field[$i]['length'];\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['default']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' SET '.$field[$i]['default'];\n\t\t\t}\n\n\t\t\tif (isset($field[$i]['null']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.(trim($field[$i]['null']) === $this->_null ? ' DROP NOT NULL' : ' SET NOT NULL');\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['new_name']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' RENAME COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TO '.$this->db->escape_identifiers($field[$i]['new_name']);\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['comment']))\n\t\t\t{\n\t\t\t\t$sqls[] = 'COMMENT ON COLUMN '\n\t\t\t\t\t.$this->db->escape_identifiers($table).'.'.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' IS '.$field[$i]['comment'];\n\t\t\t}\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\t// Reset field lengths for data types that don't support it\n\t\tif (isset($attributes['CONSTRAINT']) && stripos($attributes['TYPE'], 'int') !== FALSE)\n\t\t{\n\t\t\t$attributes['CONSTRAINT'] = NULL;\n\t\t}\n\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE)\n\t\t{\n\t\t\t$field['type'] = ($field['type'] === 'NUMERIC')\n\t\t\t\t? 'BIGSERIAL'\n\t\t\t\t: 'SERIAL';\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_sqlite_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'sqlite:';\n\n\t\t\tif (empty($this->database) && empty($this->hostname))\n\t\t\t{\n\t\t\t\t$this->database = ':memory:';\n\t\t\t}\n\n\t\t\t$this->database = empty($this->database) ? $this->hostname : $this->database;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"NAME\" FROM \"SQLITE_MASTER\" WHERE \"TYPE\" = \\'table\\'';\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' AND \"NAME\" LIKE \\''.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @return\tarray\n\t */\n\tpublic function list_fields($table)\n\t{\n\t\tif (($result = $this->query('PRAGMA TABLE_INFO('.$this->protect_identifiers($table, TRUE, NULL, FALSE).')')) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$fields = array();\n\t\tforeach ($result->result_array() as $row)\n\t\t{\n\t\t\t$fields[] = $row['name'];\n\t\t}\n\n\t\treturn $fields;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('PRAGMA TABLE_INFO('.$this->protect_identifiers($table, TRUE, NULL, FALSE).')')) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$query = $query->result_array();\n\t\tif (empty($query))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]['name'];\n\t\t\t$retval[$i]->type\t\t= $query[$i]['type'];\n\t\t\t$retval[$i]->max_length\t\t= NULL;\n\t\t\t$retval[$i]->default\t\t= $query[$i]['dflt_value'];\n\t\t\t$retval[$i]->primary_key\t= isset($query[$i]['pk']) ? (int) $query[$i]['pk'] : 0;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Replace statement\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return \tstring\n\t */\n\tprotected function _replace($table, $keys, $values)\n\t{\n\t\treturn 'INSERT OR '.parent::_replace($table, $keys, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'DELETE FROM '.$table;\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_sqlite_forge.php", "content": "db->version(), '3.3', '<'))\n\t\t{\n\t\t\t$this->_create_table_if = FALSE;\n\t\t\t$this->_drop_table_if = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create database\n\t *\n\t * @param\tstring\t$db_name\t(ignored)\n\t * @return\tbool\n\t */\n\tpublic function create_database($db_name)\n\t{\n\t\t// In SQLite, a database is created when you connect to the database.\n\t\t// We'll return TRUE so that an error isn't generated\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop database\n\t *\n\t * @param\tstring\t$db_name\t(ignored)\n\t * @return\tbool\n\t */\n\tpublic function drop_database($db_name)\n\t{\n\t\t// In SQLite, a database is dropped when we delete a file\n\t\tif (file_exists($this->db->database))\n\t\t{\n\t\t\t// We need to close the pseudo-connection first\n\t\t\t$this->db->close();\n\t\t\tif ( ! @unlink($this->db->database))\n\t\t\t{\n\t\t\t\treturn $this->db->db_debug ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t\t\t}\n\t\t\telseif ( ! empty($this->db->data_cache['db_names']))\n\t\t\t{\n\t\t\t\t$key = array_search(strtolower($this->db->database), array_map('strtolower', $this->db->data_cache['db_names']), TRUE);\n\t\t\t\tif ($key !== FALSE)\n\t\t\t\t{\n\t\t\t\t\tunset($this->db->data_cache['db_names'][$key]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn $this->db->db_debug ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'DROP' OR $alter_type === 'CHANGE')\n\t\t{\n\t\t\t// drop_column():\n\t\t\t//\tBEGIN TRANSACTION;\n\t\t\t//\tCREATE TEMPORARY TABLE t1_backup(a,b);\n\t\t\t//\tINSERT INTO t1_backup SELECT a,b FROM t1;\n\t\t\t//\tDROP TABLE t1;\n\t\t\t//\tCREATE TABLE t1(a,b);\n\t\t\t//\tINSERT INTO t1 SELECT a,b FROM t1_backup;\n\t\t\t//\tDROP TABLE t1_backup;\n\t\t\t//\tCOMMIT;\n\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['null']\n\t\t\t.$field['unique']\n\t\t\t.$field['default'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'ENUM':\n\t\t\tcase 'SET':\n\t\t\t\t$attributes['TYPE'] = 'TEXT';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['type'] = 'INTEGER PRIMARY KEY';\n\t\t\t$field['default'] = '';\n\t\t\t$field['null'] = '';\n\t\t\t$field['unique'] = '';\n\t\t\t$field['auto_increment'] = ' AUTOINCREMENT';\n\n\t\t\t$this->primary_keys = array();\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_sqlsrv_driver.php", "content": "dsn))\n\t\t{\n\t\t\t$this->dsn = 'sqlsrv:Server='.(empty($this->hostname) ? '127.0.0.1' : $this->hostname);\n\n\t\t\tempty($this->port) OR $this->dsn .= ','.$this->port;\n\t\t\tempty($this->database) OR $this->dsn .= ';Database='.$this->database;\n\n\t\t\t// Some custom options\n\n\t\t\tif (isset($this->QuotedId))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';QuotedId='.$this->QuotedId;\n\t\t\t\t$this->_quoted_identifier = (bool) $this->QuotedId;\n\t\t\t}\n\n\t\t\tif (isset($this->ConnectionPooling))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';ConnectionPooling='.$this->ConnectionPooling;\n\t\t\t}\n\n\t\t\tif ($this->encrypt === TRUE)\n\t\t\t{\n\t\t\t\t$this->dsn .= ';Encrypt=1';\n\t\t\t}\n\n\t\t\tif (isset($this->TraceOn))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';TraceOn='.$this->TraceOn;\n\t\t\t}\n\n\t\t\tif (isset($this->TrustServerCertificate))\n\t\t\t{\n\t\t\t\t$this->dsn .= ';TrustServerCertificate='.$this->TrustServerCertificate;\n\t\t\t}\n\n\t\t\tempty($this->APP) OR $this->dsn .= ';APP='.$this->APP;\n\t\t\tempty($this->Failover_Partner) OR $this->dsn .= ';Failover_Partner='.$this->Failover_Partner;\n\t\t\tempty($this->LoginTimeout) OR $this->dsn .= ';LoginTimeout='.$this->LoginTimeout;\n\t\t\tempty($this->MultipleActiveResultSets) OR $this->dsn .= ';MultipleActiveResultSets='.$this->MultipleActiveResultSets;\n\t\t\tempty($this->TraceFile) OR $this->dsn .= ';TraceFile='.$this->TraceFile;\n\t\t\tempty($this->WSID) OR $this->dsn .= ';WSID='.$this->WSID;\n\t\t}\n\t\telseif (preg_match('/QuotedId=(0|1)/', $this->dsn, $match))\n\t\t{\n\t\t\t$this->_quoted_identifier = (bool) $match[1];\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tobject\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tif ( ! empty($this->char_set) && preg_match('/utf[^8]*8/i', $this->char_set))\n\t\t{\n\t\t\t$this->options[PDO::SQLSRV_ENCODING_UTF8] = 1;\n\t\t}\n\n\t\t$this->conn_id = parent::db_connect($persistent);\n\n\t\tif ( ! is_object($this->conn_id) OR is_bool($this->_quoted_identifier))\n\t\t{\n\t\t\treturn $this->conn_id;\n\t\t}\n\n\t\t// Determine how identifiers are escaped\n\t\t$query = $this->query('SELECT CASE WHEN (@@OPTIONS | 256) = @@OPTIONS THEN 1 ELSE 0 END AS qi');\n\t\t$query = $query->row_array();\n\t\t$this->_quoted_identifier = empty($query) ? FALSE : (bool) $query['qi'];\n\t\t$this->_escape_char = ($this->_quoted_identifier) ? '\"' : array('[', ']');\n\n\t\treturn $this->conn_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT '.$this->escape_identifiers('name')\n\t\t\t.' FROM '.$this->escape_identifiers('sysobjects')\n\t\t\t.' WHERE '.$this->escape_identifiers('type').\" = 'U'\";\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' AND '.$this->escape_identifiers('name').\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql.' ORDER BY '.$this->escape_identifiers('name');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT COLUMN_NAME\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT COLUMN_NAME, DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, NUMERIC_PRECISION, COLUMN_DEFAULT\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->COLUMN_NAME;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->DATA_TYPE;\n\t\t\t$retval[$i]->max_length\t\t= ($query[$i]->CHARACTER_MAXIMUM_LENGTH > 0) ? $query[$i]->CHARACTER_MAXIMUM_LENGTH : $query[$i]->NUMERIC_PRECISION;\n\t\t\t$retval[$i]->default\t\t= $query[$i]->COLUMN_DEFAULT;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\tif ($this->qb_limit)\n\t\t{\n\t\t\treturn 'WITH ci_delete AS (SELECT TOP '.$this->qb_limit.' * FROM '.$table.$this->_compile_wh('qb_where').') DELETE FROM ci_delete';\n\t\t}\n\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t// As of SQL Server 2012 (11.0.*) OFFSET is supported\n\t\tif (version_compare($this->version(), '11', '>='))\n\t\t{\n\t\t\t// SQL Server OFFSET-FETCH can be used only with the ORDER BY clause\n\t\t\tempty($this->qb_orderby) && $sql .= ' ORDER BY 1';\n\n\t\t\treturn $sql.' OFFSET '.(int) $this->qb_offset.' ROWS FETCH NEXT '.$this->qb_limit.' ROWS ONLY';\n\t\t}\n\n\t\t$limit = $this->qb_offset + $this->qb_limit;\n\n\t\t// An ORDER BY clause is required for ROW_NUMBER() to work\n\t\tif ($this->qb_offset && ! empty($this->qb_orderby))\n\t\t{\n\t\t\t$orderby = $this->_compile_order_by();\n\n\t\t\t// We have to strip the ORDER BY clause\n\t\t\t$sql = trim(substr($sql, 0, strrpos($sql, $orderby)));\n\n\t\t\t// Get the fields to select from our subquery, so that we can avoid CI_rownum appearing in the actual results\n\t\t\tif (count($this->qb_select) === 0 OR strpos(implode(',', $this->qb_select), '*') !== FALSE)\n\t\t\t{\n\t\t\t\t$select = '*'; // Inevitable\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Use only field names and their aliases, everything else is out of our scope.\n\t\t\t\t$select = array();\n\t\t\t\t$field_regexp = ($this->_quoted_identifier)\n\t\t\t\t\t? '(\"[^\\\"]+\")' : '(\\[[^\\]]+\\])';\n\t\t\t\tfor ($i = 0, $c = count($this->qb_select); $i < $c; $i++)\n\t\t\t\t{\n\t\t\t\t\t$select[] = preg_match('/(?:\\s|\\.)'.$field_regexp.'$/i', $this->qb_select[$i], $m)\n\t\t\t\t\t\t? $m[1] : $this->qb_select[$i];\n\t\t\t\t}\n\t\t\t\t$select = implode(', ', $select);\n\t\t\t}\n\n\t\t\treturn 'SELECT '.$select.\" FROM (\\n\\n\"\n\t\t\t\t.preg_replace('/^(SELECT( DISTINCT)?)/i', '\\\\1 ROW_NUMBER() OVER('.trim($orderby).') AS '.$this->escape_identifiers('CI_rownum').', ', $sql)\n\t\t\t\t.\"\\n\\n) \".$this->escape_identifiers('CI_subquery')\n\t\t\t\t.\"\\nWHERE \".$this->escape_identifiers('CI_rownum').' BETWEEN '.($this->qb_offset + 1).' AND '.$limit;\n\t\t}\n\n\t\treturn preg_replace('/(^\\SELECT (DISTINCT)?)/i','\\\\1 TOP '.$limit.' ', $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring|bool\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\t// Multiple-value inserts are only supported as of SQL Server 2008\n\t\tif (version_compare($this->version(), '10', '>='))\n\t\t{\n\t\t\treturn parent::_insert_batch($table, $keys, $values);\n\t\t}\n\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n\n}\n" }, { "path": "system/database/drivers/pdo/subdrivers/pdo_sqlsrv_forge.php", "content": " 'SMALLINT',\n\t\t'SMALLINT'\t=> 'INT',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'REAL'\t\t=> 'FLOAT'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('ADD', 'DROP'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table).' ALTER COLUMN ';\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\t$sqls[] = $sql.$this->_process_column($field[$i]);\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tif (isset($attributes['CONSTRAINT']) && strpos($attributes['TYPE'], 'INT') !== FALSE)\n\t\t{\n\t\t\tunset($attributes['CONSTRAINT']);\n\t\t}\n\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INTEGER':\n\t\t\t\t$attributes['TYPE'] = 'INT';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['auto_increment'] = ' IDENTITY(1,1)';\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/postgre/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/postgre/postgre_driver.php", "content": "dsn === '' OR $this->dsn = '';\n\n\t\tif (strpos($this->hostname, '/') !== FALSE)\n\t\t{\n\t\t\t// If UNIX sockets are used, we shouldn't set a port\n\t\t\t$this->port = '';\n\t\t}\n\n\t\t$this->hostname === '' OR $this->dsn = 'host='.$this->hostname.' ';\n\n\t\tif ( ! empty($this->port) && ctype_digit($this->port))\n\t\t{\n\t\t\t$this->dsn .= 'port='.$this->port.' ';\n\t\t}\n\n\t\tif ($this->username !== '')\n\t\t{\n\t\t\t$this->dsn .= 'user='.$this->username.' ';\n\n\t\t\t/* An empty password is valid!\n\t\t\t *\n\t\t\t * $db['password'] = NULL must be done in order to ignore it.\n\t\t\t */\n\t\t\t$this->password === NULL OR $this->dsn .= \"password='\".$this->password.\"' \";\n\t\t}\n\n\t\t$this->database === '' OR $this->dsn .= 'dbname='.$this->database.' ';\n\n\t\t/* We don't have these options as elements in our standard configuration\n\t\t * array, but they might be set by parse_url() if the configuration was\n\t\t * provided via string. Example:\n\t\t *\n\t\t * postgre://username:password@localhost:5432/database?connect_timeout=5&sslmode=1\n\t\t */\n\t\tforeach (array('connect_timeout', 'options', 'sslmode', 'service') as $key)\n\t\t{\n\t\t\tif (isset($this->$key) && is_string($this->$key) && $this->$key !== '')\n\t\t\t{\n\t\t\t\t$this->dsn .= $key.\"='\".$this->$key.\"' \";\n\t\t\t}\n\t\t}\n\n\t\t$this->dsn = rtrim($this->dsn);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$persistent\n\t * @return\tresource|object\n\t */\n\tpublic function db_connect($persistent = FALSE)\n\t{\n\t\tempty($this->dsn) && $this->_build_dsn();\n\t\t$this->conn_id = ($persistent === TRUE)\n\t\t\t? pg_pconnect($this->dsn)\n\t\t\t: pg_connect($this->dsn);\n\n\t\tif ($this->conn_id !== FALSE)\n\t\t{\n\t\t\tif ($persistent === TRUE\n\t\t\t\t&& pg_connection_status($this->conn_id) === PGSQL_CONNECTION_BAD\n\t\t\t\t&& pg_ping($this->conn_id) === FALSE\n\t\t\t)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tif (pg_set_client_encoding($this->conn_id, $this->char_set) !== 0)\n\t\t\t{\n\t\t\t\tlog_message('error', \"Database: Unable to set the configured connection charset ('{$this->char_set}').\");\n\t\t\t\tpg_close($this->conn_id);\n\t\t\t\treturn ($this->db->db_debug) ? $this->display_error('db_unable_to_set_charset', $this->char_set) : FALSE;\n\t\t\t}\n\n\t\t\tempty($this->schema) OR $this->simple_query('SET search_path TO '.$this->schema.',public');\n\t\t}\n\n\t\treturn $this->conn_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Reconnect\n\t *\n\t * Keep / reestablish the db connection if no queries have been\n\t * sent for a length of time exceeding the server's idle timeout\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function reconnect()\n\t{\n\t\tif (pg_ping($this->conn_id) === FALSE)\n\t\t{\n\t\t\t$this->conn_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\tif ( ! $this->conn_id OR ($pg_version = pg_version($this->conn_id)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t/* If PHP was compiled with PostgreSQL lib versions earlier\n\t\t * than 7.4, pg_version() won't return the server version\n\t\t * and so we'll have to fall back to running a query in\n\t\t * order to get it.\n\t\t */\n\t\treturn (isset($pg_version['server']) && preg_match('#^(\\d+\\.\\d+)#', $pg_version['server'], $match))\n\t\t\t? $this->data_cache['version'] = $match[1]\n\t\t\t: parent::version();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tresource|object\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn pg_query($this->conn_id, $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\treturn (bool) pg_query($this->conn_id, 'BEGIN');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\treturn (bool) pg_query($this->conn_id, 'COMMIT');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\treturn (bool) pg_query($this->conn_id, 'ROLLBACK');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Determines if a query is a \"write\" type.\n\t *\n\t * @param\tstring\tAn SQL query string\n\t * @return\tbool\n\t */\n\tpublic function is_write_type($sql)\n\t{\n\t\tif (preg_match('#^(INSERT|UPDATE).*RETURNING\\s.+(\\,\\s?.+)*$#is', $sql))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn parent::is_write_type($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\treturn pg_escape_string($this->conn_id, $str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * \"Smart\" Escape String\n\t *\n\t * Escapes data based on type\n\t *\n\t * @param\tstring\t$str\n\t * @return\tmixed\n\t */\n\tpublic function escape($str)\n\t{\n\t\tif (is_string($str) OR (is_object($str) && method_exists($str, '__toString')))\n\t\t{\n\t\t\treturn pg_escape_literal($this->conn_id, $str);\n\t\t}\n\t\telseif (is_bool($str))\n\t\t{\n\t\t\treturn ($str) ? 'TRUE' : 'FALSE';\n\t\t}\n\n\t\treturn parent::escape($str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn pg_affected_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tstring\n\t */\n\tpublic function insert_id()\n\t{\n\t\t$v = $this->version();\n\n\t\t$table\t= (func_num_args() > 0) ? func_get_arg(0) : NULL;\n\t\t$column\t= (func_num_args() > 1) ? func_get_arg(1) : NULL;\n\n\t\tif ($table === NULL && $v >= '8.1')\n\t\t{\n\t\t\t$sql = 'SELECT LASTVAL() AS ins_id';\n\t\t}\n\t\telseif ($table !== NULL)\n\t\t{\n\t\t\tif ($column !== NULL && $v >= '8.0')\n\t\t\t{\n\t\t\t\t$sql = 'SELECT pg_get_serial_sequence(\\''.$table.\"', '\".$column.\"') AS seq\";\n\t\t\t\t$query = $this->query($sql);\n\t\t\t\t$query = $query->row();\n\t\t\t\t$seq = $query->seq;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// seq_name passed in table parameter\n\t\t\t\t$seq = $table;\n\t\t\t}\n\n\t\t\t$sql = 'SELECT CURRVAL(\\''.$seq.\"') AS ins_id\";\n\t\t}\n\t\telse\n\t\t{\n\t\t\treturn pg_last_oid($this->result_id);\n\t\t}\n\n\t\t$query = $this->query($sql);\n\t\t$query = $query->row();\n\t\treturn (int) $query->ins_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT \"table_name\" FROM \"information_schema\".\"tables\" WHERE \"table_schema\" = \\''.$this->schema.\"'\";\n\n\t\tif ($prefix_limit !== FALSE && $this->dbprefix !== '')\n\t\t{\n\t\t\treturn $sql.' AND \"table_name\" LIKE \\''\n\t\t\t\t.$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_like_escape_str, $this->_like_escape_chr);\n\t\t}\n\n\t\treturn $sql;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT \"column_name\"\n\t\t\tFROM \"information_schema\".\"columns\"\n\t\t\tWHERE \"table_schema\" = \\''.$this->schema.'\\' AND LOWER(\"table_name\") = '.$this->escape(strtolower($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT \"column_name\", \"data_type\", \"character_maximum_length\", \"numeric_precision\", \"column_default\"\n\t\t\tFROM \"information_schema\".\"columns\"\n\t\t\tWHERE \"table_schema\" = \\''.$this->schema.'\\' AND LOWER(\"table_name\") = '.$this->escape(strtolower($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->column_name;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->data_type;\n\t\t\t$retval[$i]->max_length\t\t= ($query[$i]->character_maximum_length > 0) ? $query[$i]->character_maximum_length : $query[$i]->numeric_precision;\n\t\t\t$retval[$i]->default\t\t= $query[$i]->column_default;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => '', 'message' => pg_last_error($this->conn_id));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ORDER BY\n\t *\n\t * @param\tstring\t$orderby\n\t * @param\tstring\t$direction\tASC, DESC or RANDOM\n\t * @param\tbool\t$escape\n\t * @return\tobject\n\t */\n\tpublic function order_by($orderby, $direction = '', $escape = NULL)\n\t{\n\t\t$direction = strtoupper(trim($direction));\n\t\tif ($direction === 'RANDOM')\n\t\t{\n\t\t\tif ( ! is_float($orderby) && ctype_digit((string) $orderby))\n\t\t\t{\n\t\t\t\t$orderby = ($orderby > 1)\n\t\t\t\t\t? (float) '0.'.$orderby\n\t\t\t\t\t: (float) $orderby;\n\t\t\t}\n\n\t\t\tif (is_float($orderby))\n\t\t\t{\n\t\t\t\t$this->simple_query('SET SEED '.$orderby);\n\t\t\t}\n\n\t\t\t$orderby = $this->_random_keyword[0];\n\t\t\t$direction = '';\n\t\t\t$escape = FALSE;\n\t\t}\n\n\t\treturn parent::order_by($orderby, $direction, $escape);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update_Batch statement\n\t *\n\t * Generates a platform-specific batch update string from the supplied data\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$values\tUpdate data\n\t * @param\tstring\t$index\tWHERE key\n\t * @return\tstring\n\t */\n\tprotected function _update_batch($table, $values, $index)\n\t{\n\t\t$ids = array();\n\t\tforeach ($values as $key => $val)\n\t\t{\n\t\t\t$ids[] = $val[$index]['value'];\n\n\t\t\tforeach (array_keys($val) as $field)\n\t\t\t{\n\t\t\t\tif ($field !== $index)\n\t\t\t\t{\n\t\t\t\t\t$final[$val[$field]['field']][] = 'WHEN '.$val[$index]['value'].' THEN '.$val[$field]['value'];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t$cases = '';\n\t\tforeach ($final as $k => $v)\n\t\t{\n\t\t\t$cases .= $k.' = (CASE '.$val[$index]['field'].\"\\n\"\n\t\t\t\t.implode(\"\\n\", $v).\"\\n\"\n\t\t\t\t.'ELSE '.$k.' END), ';\n\t\t}\n\n\t\t$this->where($val[$index]['field'].' IN('.implode(',', $ids).')', NULL, FALSE);\n\n\t\treturn 'UPDATE '.$table.' SET '.substr($cases, 0, -2).$this->_compile_wh('qb_where');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\treturn $sql.' LIMIT '.$this->qb_limit.($this->qb_offset ? ' OFFSET '.$this->qb_offset : '');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\tpg_close($this->conn_id);\n\t}\n\n}\n" }, { "path": "system/database/drivers/postgre/postgre_forge.php", "content": " 'INTEGER',\n\t\t'SMALLINT'\t=> 'INTEGER',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'INT4'\t\t=> 'BIGINT',\n\t\t'INTEGER'\t=> 'BIGINT',\n\t\t'INT8'\t\t=> 'NUMERIC',\n\t\t'BIGINT'\t=> 'NUMERIC',\n\t\t'REAL'\t\t=> 'DOUBLE PRECISION',\n\t\t'FLOAT'\t\t=> 'DOUBLE PRECISION'\n\t);\n\n\t/**\n\t * NULL value representation in CREATE/ALTER TABLE statements\n\t *\n\t * @var\tstring\n\t */\n\tprotected $_null = 'NULL';\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Class constructor\n\t *\n\t * @param\tobject\t&$db\tDatabase object\n\t * @return\tvoid\n\t */\n\tpublic function __construct(&$db)\n\t{\n\t\tparent::__construct($db);\n\n\t\tif (version_compare($this->db->version(), '9.0', '>'))\n\t\t{\n\t\t\t$this->create_table_if = 'CREATE TABLE IF NOT EXISTS';\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('DROP', 'ADD'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table);\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\tif ($field[$i]['_literal'] !== FALSE)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tif (version_compare($this->db->version(), '8', '>=') && isset($field[$i]['type']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TYPE '.$field[$i]['type'].$field[$i]['length'];\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['default']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' SET '.$field[$i]['default'];\n\t\t\t}\n\n\t\t\tif (isset($field[$i]['null']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' ALTER COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.(trim($field[$i]['null']) === $this->_null ? ' DROP NOT NULL' : ' SET NOT NULL');\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['new_name']))\n\t\t\t{\n\t\t\t\t$sqls[] = $sql.' RENAME COLUMN '.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' TO '.$this->db->escape_identifiers($field[$i]['new_name']);\n\t\t\t}\n\n\t\t\tif ( ! empty($field[$i]['comment']))\n\t\t\t{\n\t\t\t\t$sqls[] = 'COMMENT ON COLUMN '\n\t\t\t\t\t.$this->db->escape_identifiers($table).'.'.$this->db->escape_identifiers($field[$i]['name'])\n\t\t\t\t\t.' IS '.$field[$i]['comment'];\n\t\t\t}\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\t// Reset field lengths for data types that don't support it\n\t\tif (isset($attributes['CONSTRAINT']) && stripos($attributes['TYPE'], 'int') !== FALSE)\n\t\t{\n\t\t\t$attributes['CONSTRAINT'] = NULL;\n\t\t}\n\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'TINYINT':\n\t\t\t\t$attributes['TYPE'] = 'SMALLINT';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE)\n\t\t{\n\t\t\t$field['type'] = ($field['type'] === 'NUMERIC')\n\t\t\t\t? 'BIGSERIAL'\n\t\t\t\t: 'SERIAL';\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/postgre/postgre_result.php", "content": "num_rows)\n\t\t\t? $this->num_rows\n\t\t\t: $this->num_rows = pg_num_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn pg_num_fields($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$field_names[] = pg_field_name($this->result_id, $i);\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= pg_field_name($this->result_id, $i);\n\t\t\t$retval[$i]->type\t\t= pg_field_type($this->result_id, $i);\n\t\t\t$retval[$i]->max_length\t\t= pg_field_size($this->result_id, $i);\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif ($this->result_id !== FALSE)\n\t\t{\n\t\t\tpg_free_result($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * @param\tint\t$n\n\t * @return\tbool\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\treturn pg_result_seek($this->result_id, $n);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn pg_fetch_assoc($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn pg_fetch_object($this->result_id, NULL, $class_name);\n\t}\n\n}\n" }, { "path": "system/database/drivers/postgre/postgre_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n}\n" }, { "path": "system/database/drivers/sqlite3/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/sqlite3/sqlite3_driver.php", "content": "password)\n\t\t\t\t? new SQLite3($this->database)\n\t\t\t\t: new SQLite3($this->database, SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE, $this->password);\n\t\t}\n\t\tcatch (Exception $e)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\t$version = SQLite3::version();\n\t\treturn $this->data_cache['version'] = $version['versionString'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @todo\tImplement use of SQLite3::querySingle(), if needed\n\t * @param\tstring\t$sql\n\t * @return\tmixed\tSQLite3Result object or bool\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn $this->is_write_type($sql)\n\t\t\t? $this->conn_id->exec($sql)\n\t\t\t: $this->conn_id->query($sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\treturn $this->conn_id->exec('BEGIN TRANSACTION');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\treturn $this->conn_id->exec('END TRANSACTION');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\treturn $this->conn_id->exec('ROLLBACK');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Platform-dependent string escape\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tprotected function _escape_str($str)\n\t{\n\t\treturn $this->conn_id->escapeString($str);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn $this->conn_id->changes();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * @return\tint\n\t */\n\tpublic function insert_id()\n\t{\n\t\treturn $this->conn_id->lastInsertRowID();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Show table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\t$prefix_limit\n\t * @return\tstring\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\treturn 'SELECT \"NAME\" FROM \"SQLITE_MASTER\" WHERE \"TYPE\" = \\'table\\''\n\t\t\t.(($prefix_limit !== FALSE && $this->dbprefix != '')\n\t\t\t\t? ' AND \"NAME\" LIKE \\''.$this->escape_like_str($this->dbprefix).'%\\' '.sprintf($this->_like_escape_str, $this->_like_escape_chr)\n\t\t\t\t: '');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @return\tarray\n\t */\n\tpublic function list_fields($table)\n\t{\n\t\tif (($result = $this->query('PRAGMA TABLE_INFO('.$this->protect_identifiers($table, TRUE, NULL, FALSE).')')) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$fields = array();\n\t\tforeach ($result->result_array() as $row)\n\t\t{\n\t\t\t$fields[] = $row['name'];\n\t\t}\n\n\t\treturn $fields;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\tif (($query = $this->query('PRAGMA TABLE_INFO('.$this->protect_identifiers($table, TRUE, NULL, FALSE).')')) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$query = $query->result_array();\n\t\tif (empty($query))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]['name'];\n\t\t\t$retval[$i]->type\t\t= $query[$i]['type'];\n\t\t\t$retval[$i]->max_length\t\t= NULL;\n\t\t\t$retval[$i]->default\t\t= $query[$i]['dflt_value'];\n\t\t\t$retval[$i]->primary_key\t= isset($query[$i]['pk']) ? (int) $query[$i]['pk'] : 0;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\treturn array('code' => $this->conn_id->lastErrorCode(), 'message' => $this->conn_id->lastErrorMsg());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Replace statement\n\t *\n\t * Generates a platform-specific replace string from the supplied data\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring\n\t */\n\tprotected function _replace($table, $keys, $values)\n\t{\n\t\treturn 'INSERT OR '.parent::_replace($table, $keys, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'DELETE FROM '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\t$this->conn_id->close();\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlite3/sqlite3_forge.php", "content": "db->version(), '3.3', '<'))\n\t\t{\n\t\t\t$this->_create_table_if = FALSE;\n\t\t\t$this->_drop_table_if = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create database\n\t *\n\t * @param\tstring\t$db_name\n\t * @return\tbool\n\t */\n\tpublic function create_database($db_name)\n\t{\n\t\t// In SQLite, a database is created when you connect to the database.\n\t\t// We'll return TRUE so that an error isn't generated\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Drop database\n\t *\n\t * @param\tstring\t$db_name\t(ignored)\n\t * @return\tbool\n\t */\n\tpublic function drop_database($db_name)\n\t{\n\t\t// In SQLite, a database is dropped when we delete a file\n\t\tif (file_exists($this->db->database))\n\t\t{\n\t\t\t// We need to close the pseudo-connection first\n\t\t\t$this->db->close();\n\t\t\tif ( ! @unlink($this->db->database))\n\t\t\t{\n\t\t\t\treturn $this->db->db_debug ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t\t\t}\n\t\t\telseif ( ! empty($this->db->data_cache['db_names']))\n\t\t\t{\n\t\t\t\t$key = array_search(strtolower($this->db->database), array_map('strtolower', $this->db->data_cache['db_names']), TRUE);\n\t\t\t\tif ($key !== FALSE)\n\t\t\t\t{\n\t\t\t\t\tunset($this->db->data_cache['db_names'][$key]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn $this->db->db_debug ? $this->db->display_error('db_unable_to_drop') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @todo\timplement drop_column(), modify_column()\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif ($alter_type === 'DROP' OR $alter_type === 'CHANGE')\n\t\t{\n\t\t\t// drop_column():\n\t\t\t//\tBEGIN TRANSACTION;\n\t\t\t//\tCREATE TEMPORARY TABLE t1_backup(a,b);\n\t\t\t//\tINSERT INTO t1_backup SELECT a,b FROM t1;\n\t\t\t//\tDROP TABLE t1;\n\t\t\t//\tCREATE TABLE t1(a,b);\n\t\t\t//\tINSERT INTO t1 SELECT a,b FROM t1_backup;\n\t\t\t//\tDROP TABLE t1_backup;\n\t\t\t//\tCOMMIT;\n\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Process column\n\t *\n\t * @param\tarray\t$field\n\t * @return\tstring\n\t */\n\tprotected function _process_column($field)\n\t{\n\t\treturn $this->db->escape_identifiers($field['name'])\n\t\t\t.' '.$field['type']\n\t\t\t.$field['auto_increment']\n\t\t\t.$field['null']\n\t\t\t.$field['unique']\n\t\t\t.$field['default'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'ENUM':\n\t\t\tcase 'SET':\n\t\t\t\t$attributes['TYPE'] = 'TEXT';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['type'] = 'INTEGER PRIMARY KEY';\n\t\t\t$field['default'] = '';\n\t\t\t$field['null'] = '';\n\t\t\t$field['unique'] = '';\n\t\t\t$field['auto_increment'] = ' AUTOINCREMENT';\n\n\t\t\t$this->primary_keys = array();\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlite3/sqlite3_result.php", "content": "result_id->numColumns();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$field_names[] = $this->result_id->columnName($i);\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\tstatic $data_types = array(\n\t\t\tSQLITE3_INTEGER\t=> 'integer',\n\t\t\tSQLITE3_FLOAT\t=> 'float',\n\t\t\tSQLITE3_TEXT\t=> 'text',\n\t\t\tSQLITE3_BLOB\t=> 'blob',\n\t\t\tSQLITE3_NULL\t=> 'null'\n\t\t);\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = $this->num_fields(); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $this->result_id->columnName($i);\n\n\t\t\t$type = $this->result_id->columnType($i);\n\t\t\t$retval[$i]->type\t\t= isset($data_types[$type]) ? $data_types[$type] : $type;\n\n\t\t\t$retval[$i]->max_length\t\t= NULL;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_object($this->result_id))\n\t\t{\n\t\t\t$this->result_id->finalize();\n\t\t\t$this->result_id = NULL;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn $this->result_id->fetchArray(SQLITE3_ASSOC);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\t// No native support for fetching rows as objects\n\t\tif (($row = $this->result_id->fetchArray(SQLITE3_ASSOC)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\telseif ($class_name === 'stdClass')\n\t\t{\n\t\t\treturn (object) $row;\n\t\t}\n\n\t\t$class_name = new $class_name();\n\t\tforeach (array_keys($row) as $key)\n\t\t{\n\t\t\t$class_name->$key = $row[$key];\n\t\t}\n\n\t\treturn $class_name;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Data Seek\n\t *\n\t * Moves the internal pointer to the desired offset. We call\n\t * this internally before fetching results to make sure the\n\t * result set starts at zero.\n\t *\n\t * @param\tint\t$n\t(ignored)\n\t * @return\tarray\n\t */\n\tpublic function data_seek($n = 0)\n\t{\n\t\t// Only resetting to the start of the result set is supported\n\t\treturn ($n > 0) ? FALSE : $this->result_id->reset();\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlite3/sqlite3_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlsrv/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/database/drivers/sqlsrv/sqlsrv_driver.php", "content": "scrollable === NULL)\n\t\t{\n\t\t\t$this->scrollable = defined('SQLSRV_CURSOR_CLIENT_BUFFERED')\n\t\t\t\t? SQLSRV_CURSOR_CLIENT_BUFFERED\n\t\t\t\t: FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database connection\n\t *\n\t * @param\tbool\t$pooling\n\t * @return\tresource\n\t */\n\tpublic function db_connect($pooling = FALSE)\n\t{\n\t\t$charset = in_array(strtolower($this->char_set), array('utf-8', 'utf8'), TRUE)\n\t\t\t? 'UTF-8' : SQLSRV_ENC_CHAR;\n\n\t\t$connection = array(\n\t\t\t'UID'\t\t\t=> empty($this->username) ? '' : $this->username,\n\t\t\t'PWD'\t\t\t=> empty($this->password) ? '' : $this->password,\n\t\t\t'Database'\t\t=> $this->database,\n\t\t\t'ConnectionPooling'\t=> ($pooling === TRUE) ? 1 : 0,\n\t\t\t'CharacterSet'\t\t=> $charset,\n\t\t\t'Encrypt'\t\t=> ($this->encrypt === TRUE) ? 1 : 0,\n\t\t\t'ReturnDatesAsStrings'\t=> 1\n\t\t);\n\n\t\t// If the username and password are both empty, assume this is a\n\t\t// 'Windows Authentication Mode' connection.\n\t\tif (empty($connection['UID']) && empty($connection['PWD']))\n\t\t{\n\t\t\tunset($connection['UID'], $connection['PWD']);\n\t\t}\n\n\t\tif (FALSE !== ($this->conn_id = sqlsrv_connect($this->hostname, $connection)))\n\t\t{\n\t\t\t// Determine how identifiers are escaped\n\t\t\t$query = $this->query('SELECT CASE WHEN (@@OPTIONS | 256) = @@OPTIONS THEN 1 ELSE 0 END AS qi');\n\t\t\t$query = $query->row_array();\n\t\t\t$this->_quoted_identifier = empty($query) ? FALSE : (bool) $query['qi'];\n\t\t\t$this->_escape_char = ($this->_quoted_identifier) ? '\"' : array('[', ']');\n\t\t}\n\n\t\treturn $this->conn_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Select the database\n\t *\n\t * @param\tstring\t$database\n\t * @return\tbool\n\t */\n\tpublic function db_select($database = '')\n\t{\n\t\tif ($database === '')\n\t\t{\n\t\t\t$database = $this->database;\n\t\t}\n\n\t\tif ($this->_execute('USE '.$this->escape_identifiers($database)))\n\t\t{\n\t\t\t$this->database = $database;\n\t\t\t$this->data_cache = array();\n\t\t\treturn TRUE;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Execute the query\n\t *\n\t * @param\tstring\t$sql\tan SQL query\n\t * @return\tresource\n\t */\n\tprotected function _execute($sql)\n\t{\n\t\treturn ($this->scrollable === FALSE OR $this->is_write_type($sql))\n\t\t\t? sqlsrv_query($this->conn_id, $sql)\n\t\t\t: sqlsrv_query($this->conn_id, $sql, NULL, array('Scrollable' => $this->scrollable));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Begin Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_begin()\n\t{\n\t\treturn sqlsrv_begin_transaction($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Commit Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_commit()\n\t{\n\t\treturn sqlsrv_commit($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Rollback Transaction\n\t *\n\t * @return\tbool\n\t */\n\tprotected function _trans_rollback()\n\t{\n\t\treturn sqlsrv_rollback($this->conn_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Affected Rows\n\t *\n\t * @return\tint\n\t */\n\tpublic function affected_rows()\n\t{\n\t\treturn sqlsrv_rows_affected($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert ID\n\t *\n\t * Returns the last id created in the Identity column.\n\t *\n\t * @return\tstring\n\t */\n\tpublic function insert_id()\n\t{\n\t\treturn $this->query('SELECT SCOPE_IDENTITY() AS insert_id')->row()->insert_id;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Database version number\n\t *\n\t * @return\tstring\n\t */\n\tpublic function version()\n\t{\n\t\tif (isset($this->data_cache['version']))\n\t\t{\n\t\t\treturn $this->data_cache['version'];\n\t\t}\n\n\t\tif ( ! $this->conn_id OR ($info = sqlsrv_server_info($this->conn_id)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\treturn $this->data_cache['version'] = $info['SQLServerVersion'];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List table query\n\t *\n\t * Generates a platform-specific query string so that the table names can be fetched\n\t *\n\t * @param\tbool\n\t * @return\tstring\t$prefix_limit\n\t */\n\tprotected function _list_tables($prefix_limit = FALSE)\n\t{\n\t\t$sql = 'SELECT '.$this->escape_identifiers('name')\n\t\t\t.' FROM '.$this->escape_identifiers('sysobjects')\n\t\t\t.' WHERE '.$this->escape_identifiers('type').\" = 'U'\";\n\n\t\tif ($prefix_limit === TRUE && $this->dbprefix !== '')\n\t\t{\n\t\t\t$sql .= ' AND '.$this->escape_identifiers('name').\" LIKE '\".$this->escape_like_str($this->dbprefix).\"%' \"\n\t\t\t\t.sprintf($this->_escape_like_str, $this->_escape_like_chr);\n\t\t}\n\n\t\treturn $sql.' ORDER BY '.$this->escape_identifiers('name');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * List column query\n\t *\n\t * Generates a platform-specific query string so that the column names can be fetched\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _list_columns($table = '')\n\t{\n\t\treturn 'SELECT COLUMN_NAME\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Returns an object with field data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tarray\n\t */\n\tpublic function field_data($table)\n\t{\n\t\t$sql = 'SELECT COLUMN_NAME, DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, NUMERIC_PRECISION, COLUMN_DEFAULT\n\t\t\tFROM INFORMATION_SCHEMA.Columns\n\t\t\tWHERE UPPER(TABLE_NAME) = '.$this->escape(strtoupper($table));\n\n\t\tif (($query = $this->query($sql)) === FALSE)\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\t\t$query = $query->result_object();\n\n\t\t$retval = array();\n\t\tfor ($i = 0, $c = count($query); $i < $c; $i++)\n\t\t{\n\t\t\t$retval[$i]\t\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t\t= $query[$i]->COLUMN_NAME;\n\t\t\t$retval[$i]->type\t\t= $query[$i]->DATA_TYPE;\n\t\t\t$retval[$i]->max_length\t\t= ($query[$i]->CHARACTER_MAXIMUM_LENGTH > 0) ? $query[$i]->CHARACTER_MAXIMUM_LENGTH : $query[$i]->NUMERIC_PRECISION;\n\t\t\t$retval[$i]->default\t\t= $query[$i]->COLUMN_DEFAULT;\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Error\n\t *\n\t * Returns an array containing code and message of the last\n\t * database error that has occurred.\n\t *\n\t * @return\tarray\n\t */\n\tpublic function error()\n\t{\n\t\t$error = array('code' => '00000', 'message' => '');\n\t\t$sqlsrv_errors = sqlsrv_errors(SQLSRV_ERR_ERRORS);\n\n\t\tif ( ! is_array($sqlsrv_errors))\n\t\t{\n\t\t\treturn $error;\n\t\t}\n\n\t\t$sqlsrv_error = array_shift($sqlsrv_errors);\n\t\tif (isset($sqlsrv_error['SQLSTATE']))\n\t\t{\n\t\t\t$error['code'] = isset($sqlsrv_error['code']) ? $sqlsrv_error['SQLSTATE'].'/'.$sqlsrv_error['code'] : $sqlsrv_error['SQLSTATE'];\n\t\t}\n\t\telseif (isset($sqlsrv_error['code']))\n\t\t{\n\t\t\t$error['code'] = $sqlsrv_error['code'];\n\t\t}\n\n\t\tif (isset($sqlsrv_error['message']))\n\t\t{\n\t\t\t$error['message'] = $sqlsrv_error['message'];\n\t\t}\n\n\t\treturn $error;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Update statement\n\t *\n\t * Generates a platform-specific update string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @param\tarray\t$values\n\t * @return\tstring\n\t */\n\tprotected function _update($table, $values)\n\t{\n\t\t$this->qb_limit = FALSE;\n\t\t$this->qb_orderby = array();\n\t\treturn parent::_update($table, $values);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Truncate statement\n\t *\n\t * Generates a platform-specific truncate string from the supplied data\n\t *\n\t * If the database does not support the TRUNCATE statement,\n\t * then this method maps to 'DELETE FROM table'\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _truncate($table)\n\t{\n\t\treturn 'TRUNCATE TABLE '.$table;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Delete statement\n\t *\n\t * Generates a platform-specific delete string from the supplied data\n\t *\n\t * @param\tstring\t$table\n\t * @return\tstring\n\t */\n\tprotected function _delete($table)\n\t{\n\t\tif ($this->qb_limit)\n\t\t{\n\t\t\treturn 'WITH ci_delete AS (SELECT TOP '.$this->qb_limit.' * FROM '.$table.$this->_compile_wh('qb_where').') DELETE FROM ci_delete';\n\t\t}\n\n\t\treturn parent::_delete($table);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * LIMIT\n\t *\n\t * Generates a platform-specific LIMIT clause\n\t *\n\t * @param\tstring\t$sql\tSQL Query\n\t * @return\tstring\n\t */\n\tprotected function _limit($sql)\n\t{\n\t\t// As of SQL Server 2012 (11.0.*) OFFSET is supported\n\t\tif (version_compare($this->version(), '11', '>='))\n\t\t{\n\t\t\t// SQL Server OFFSET-FETCH can be used only with the ORDER BY clause\n\t\t\tempty($this->qb_orderby) && $sql .= ' ORDER BY 1';\n\n\t\t\treturn $sql.' OFFSET '.(int) $this->qb_offset.' ROWS FETCH NEXT '.$this->qb_limit.' ROWS ONLY';\n\t\t}\n\n\t\t$limit = $this->qb_offset + $this->qb_limit;\n\n\t\t// An ORDER BY clause is required for ROW_NUMBER() to work\n\t\tif ($this->qb_offset && ! empty($this->qb_orderby))\n\t\t{\n\t\t\t$orderby = $this->_compile_order_by();\n\n\t\t\t// We have to strip the ORDER BY clause\n\t\t\t$sql = trim(substr($sql, 0, strrpos($sql, $orderby)));\n\n\t\t\t// Get the fields to select from our subquery, so that we can avoid CI_rownum appearing in the actual results\n\t\t\tif (count($this->qb_select) === 0 OR strpos(implode(',', $this->qb_select), '*') !== FALSE)\n\t\t\t{\n\t\t\t\t$select = '*'; // Inevitable\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Use only field names and their aliases, everything else is out of our scope.\n\t\t\t\t$select = array();\n\t\t\t\t$field_regexp = ($this->_quoted_identifier)\n\t\t\t\t\t? '(\"[^\\\"]+\")' : '(\\[[^\\]]+\\])';\n\t\t\t\tfor ($i = 0, $c = count($this->qb_select); $i < $c; $i++)\n\t\t\t\t{\n\t\t\t\t\t$select[] = preg_match('/(?:\\s|\\.)'.$field_regexp.'$/i', $this->qb_select[$i], $m)\n\t\t\t\t\t\t? $m[1] : $this->qb_select[$i];\n\t\t\t\t}\n\t\t\t\t$select = implode(', ', $select);\n\t\t\t}\n\n\t\t\treturn 'SELECT '.$select.\" FROM (\\n\\n\"\n\t\t\t\t.preg_replace('/^(SELECT( DISTINCT)?)/i', '\\\\1 ROW_NUMBER() OVER('.trim($orderby).') AS '.$this->escape_identifiers('CI_rownum').', ', $sql)\n\t\t\t\t.\"\\n\\n) \".$this->escape_identifiers('CI_subquery')\n\t\t\t\t.\"\\nWHERE \".$this->escape_identifiers('CI_rownum').' BETWEEN '.($this->qb_offset + 1).' AND '.$limit;\n\t\t}\n\n\t\treturn preg_replace('/(^\\SELECT (DISTINCT)?)/i','\\\\1 TOP '.$limit.' ', $sql);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Insert batch statement\n\t *\n\t * Generates a platform-specific insert string from the supplied data.\n\t *\n\t * @param\tstring\t$table\tTable name\n\t * @param\tarray\t$keys\tINSERT keys\n\t * @param\tarray\t$values\tINSERT values\n\t * @return\tstring|bool\n\t */\n\tprotected function _insert_batch($table, $keys, $values)\n\t{\n\t\t// Multiple-value inserts are only supported as of SQL Server 2008\n\t\tif (version_compare($this->version(), '10', '>='))\n\t\t{\n\t\t\treturn parent::_insert_batch($table, $keys, $values);\n\t\t}\n\n\t\treturn ($this->db_debug) ? $this->display_error('db_unsupported_feature') : FALSE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Close DB Connection\n\t *\n\t * @return\tvoid\n\t */\n\tprotected function _close()\n\t{\n\t\tsqlsrv_close($this->conn_id);\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlsrv/sqlsrv_forge.php", "content": " 'SMALLINT',\n\t\t'SMALLINT'\t=> 'INT',\n\t\t'INT'\t\t=> 'BIGINT',\n\t\t'REAL'\t\t=> 'FLOAT'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * ALTER TABLE\n\t *\n\t * @param\tstring\t$alter_type\tALTER type\n\t * @param\tstring\t$table\t\tTable name\n\t * @param\tmixed\t$field\t\tColumn definition\n\t * @return\tstring|string[]\n\t */\n\tprotected function _alter_table($alter_type, $table, $field)\n\t{\n\t\tif (in_array($alter_type, array('ADD', 'DROP'), TRUE))\n\t\t{\n\t\t\treturn parent::_alter_table($alter_type, $table, $field);\n\t\t}\n\n\t\t$sql = 'ALTER TABLE '.$this->db->escape_identifiers($table).' ALTER COLUMN ';\n\t\t$sqls = array();\n\t\tfor ($i = 0, $c = count($field); $i < $c; $i++)\n\t\t{\n\t\t\t$sqls[] = $sql.$this->_process_column($field[$i]);\n\t\t}\n\n\t\treturn $sqls;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute TYPE\n\t *\n\t * Performs a data type mapping between different databases.\n\t *\n\t * @param\tarray\t&$attributes\n\t * @return\tvoid\n\t */\n\tprotected function _attr_type(&$attributes)\n\t{\n\t\tif (isset($attributes['CONSTRAINT']) && strpos($attributes['TYPE'], 'INT') !== FALSE)\n\t\t{\n\t\t\tunset($attributes['CONSTRAINT']);\n\t\t}\n\n\t\tswitch (strtoupper($attributes['TYPE']))\n\t\t{\n\t\t\tcase 'MEDIUMINT':\n\t\t\t\t$attributes['TYPE'] = 'INTEGER';\n\t\t\t\t$attributes['UNSIGNED'] = FALSE;\n\t\t\t\treturn;\n\t\t\tcase 'INTEGER':\n\t\t\t\t$attributes['TYPE'] = 'INT';\n\t\t\t\treturn;\n\t\t\tdefault: return;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field attribute AUTO_INCREMENT\n\t *\n\t * @param\tarray\t&$attributes\n\t * @param\tarray\t&$field\n\t * @return\tvoid\n\t */\n\tprotected function _attr_auto_increment(&$attributes, &$field)\n\t{\n\t\tif ( ! empty($attributes['AUTO_INCREMENT']) && $attributes['AUTO_INCREMENT'] === TRUE && stripos($field['type'], 'int') !== FALSE)\n\t\t{\n\t\t\t$field['auto_increment'] = ' IDENTITY(1,1)';\n\t\t}\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlsrv/sqlsrv_result.php", "content": "scrollable = $driver_object->scrollable;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of rows in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_rows()\n\t{\n\t\t// sqlsrv_num_rows() doesn't work with the FORWARD and DYNAMIC cursors (FALSE is the same as FORWARD)\n\t\tif ( ! in_array($this->scrollable, array(FALSE, SQLSRV_CURSOR_FORWARD, SQLSRV_CURSOR_DYNAMIC), TRUE))\n\t\t{\n\t\t\treturn parent::num_rows();\n\t\t}\n\n\t\treturn is_int($this->num_rows)\n\t\t\t? $this->num_rows\n\t\t\t: $this->num_rows = sqlsrv_num_rows($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Number of fields in the result set\n\t *\n\t * @return\tint\n\t */\n\tpublic function num_fields()\n\t{\n\t\treturn @sqlsrv_num_fields($this->result_id);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Fetch Field Names\n\t *\n\t * Generates an array of column names\n\t *\n\t * @return\tarray\n\t */\n\tpublic function list_fields()\n\t{\n\t\t$field_names = array();\n\t\tforeach (sqlsrv_field_metadata($this->result_id) as $offset => $field)\n\t\t{\n\t\t\t$field_names[] = $field['Name'];\n\t\t}\n\n\t\treturn $field_names;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Field data\n\t *\n\t * Generates an array of objects containing field meta-data\n\t *\n\t * @return\tarray\n\t */\n\tpublic function field_data()\n\t{\n\t\t$retval = array();\n\t\tforeach (sqlsrv_field_metadata($this->result_id) as $i => $field)\n\t\t{\n\t\t\t$retval[$i]\t\t= new stdClass();\n\t\t\t$retval[$i]->name\t= $field['Name'];\n\t\t\t$retval[$i]->type\t= $field['Type'];\n\t\t\t$retval[$i]->max_length\t= $field['Size'];\n\t\t}\n\n\t\treturn $retval;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Free the result\n\t *\n\t * @return\tvoid\n\t */\n\tpublic function free_result()\n\t{\n\t\tif (is_resource($this->result_id))\n\t\t{\n\t\t\tsqlsrv_free_stmt($this->result_id);\n\t\t\t$this->result_id = FALSE;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - associative array\n\t *\n\t * Returns the result set as an array\n\t *\n\t * @return\tarray\n\t */\n\tprotected function _fetch_assoc()\n\t{\n\t\treturn sqlsrv_fetch_array($this->result_id, SQLSRV_FETCH_ASSOC);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Result - object\n\t *\n\t * Returns the result set as an object\n\t *\n\t * @param\tstring\t$class_name\n\t * @return\tobject\n\t */\n\tprotected function _fetch_object($class_name = 'stdClass')\n\t{\n\t\treturn sqlsrv_fetch_object($this->result_id, $class_name);\n\t}\n\n}\n" }, { "path": "system/database/drivers/sqlsrv/sqlsrv_utility.php", "content": "db->display_error('db_unsupported_feature');\n\t}\n\n}\n" }, { "path": "system/database/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/fonts/index.html", "content": "\n\n\n\t403 Forbidden\n\n\n\n

Directory access is forbidden.

\n\n\n\n" }, { "path": "system/helpers/array_helper.php", "content": " '',\n\t\t\t'img_path'\t=> '',\n\t\t\t'img_url'\t=> '',\n\t\t\t'img_width'\t=> '150',\n\t\t\t'img_height'\t=> '30',\n\t\t\t'img_alt'\t=> 'captcha',\n\t\t\t'img_class'\t=> '',\n\t\t\t'font_path'\t=> '',\n\t\t\t'font_size'\t=> 16,\n\t\t\t'expiration'\t=> 7200,\n\t\t\t'word_length'\t=> 8,\n\t\t\t'img_id'\t=> '',\n\t\t\t'pool'\t\t=> '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ',\n\t\t\t'colors'\t=> array(\n\t\t\t\t'background'\t=> array(255,255,255),\n\t\t\t\t'border'\t=> array(153,102,102),\n\t\t\t\t'text'\t\t=> array(204,153,153),\n\t\t\t\t'grid'\t\t=> array(255,182,182)\n\t\t\t)\n\t\t);\n\n\t\t$now = microtime(TRUE);\n\n\t\tforeach ($defaults as $key => $val)\n\t\t{\n\t\t\tif ( ! is_array($data) && empty($$key))\n\t\t\t{\n\t\t\t\t$$key = $val;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$$key = isset($data[$key]) ? $data[$key] : $val;\n\t\t\t}\n\t\t}\n\n\t\tif ( ! extension_loaded('gd'))\n\t\t{\n\t\t\tlog_message('error', 'create_captcha(): GD extension is not loaded.');\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ($img_path === '' OR $img_url === '')\n\t\t{\n\t\t\tlog_message('error', 'create_captcha(): img_path and img_url are required.');\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ( ! is_dir($img_path) OR ! is_really_writable($img_path))\n\t\t{\n\t\t\tlog_message('error', \"create_captcha(): '{$img_path}' is not a dir, nor is it writable.\");\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ($img_url !== '' OR $img_path !== '')\n\t\t{\n\t\t\tif ($img_path === '' OR $img_url === '')\n\t\t\t{\n\t\t\t\tlog_message('error', 'create_captcha(): $img_path and $img_url are required.');\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\tif ( ! is_dir($img_path) OR ! is_really_writable($img_path))\n\t\t\t{\n\t\t\t\tlog_message('error', \"create_captcha(): '{$img_path}' is not a dir, nor is it writable.\");\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Remove old images\n\t\t\t */\n\t\t\t$current_dir = @opendir($img_path);\n\t\t\twhile ($filename = @readdir($current_dir))\n\t\t\t{\n\t\t\t\tif (preg_match('#^(?\\d{10})\\.png$#', $filename, $match) && ($match['ts'] + $expiration) < $now)\n\t\t\t\t{\n\t\t\t\t\t@unlink($img_path.$filename);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t@closedir($current_dir);\n\n\t\t\t// This variable will later be used later to determine whether we write to disk or output a data:image URI\n\t\t\t$img_filename = $now.'.png';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$img_filename = NULL;\n\t\t}\n\n\t\t// -----------------------------------\n\t\t// Do we have a \"word\" yet?\n\t\t// -----------------------------------\n\n\t\tif (empty($word))\n\t\t{\n\t\t\t$word = '';\n\t\t\t$pool_length = strlen($pool);\n\t\t\t$rand_max = $pool_length - 1;\n\n\t\t\t// PHP7 or a suitable polyfill\n\t\t\tif (function_exists('random_int'))\n\t\t\t{\n\t\t\t\ttry\n\t\t\t\t{\n\t\t\t\t\tfor ($i = 0; $i < $word_length; $i++)\n\t\t\t\t\t{\n\t\t\t\t\t\t$word .= $pool[random_int(0, $rand_max)];\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tcatch (Exception $e)\n\t\t\t\t{\n\t\t\t\t\t// This means fallback to the next possible\n\t\t\t\t\t// alternative to random_int()\n\t\t\t\t\t$word = '';\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (empty($word))\n\t\t{\n\t\t\t// Nobody will have a larger character pool than\n\t\t\t// 256 characters, but let's handle it just in case ...\n\t\t\t//\n\t\t\t// No, I do not care that the fallback to mt_rand() can\n\t\t\t// handle it; if you trigger this, you're very obviously\n\t\t\t// trying to break it. -- Narf\n\t\t\tif ($pool_length > 256)\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\n\t\t\t// We'll try using the operating system's PRNG first,\n\t\t\t// which we can access through CI_Security::get_random_bytes()\n\t\t\t$security = get_instance()->security;\n\n\t\t\t// To avoid numerous get_random_bytes() calls, we'll\n\t\t\t// just try fetching as much bytes as we need at once.\n\t\t\tif (($bytes = $security->get_random_bytes($pool_length)) !== FALSE)\n\t\t\t{\n\t\t\t\t$byte_index = $word_index = 0;\n\t\t\t\twhile ($word_index < $word_length)\n\t\t\t\t{\n\t\t\t\t\t// Do we have more random data to use?\n\t\t\t\t\t// It could be exhausted by previous iterations\n\t\t\t\t\t// ignoring bytes higher than $rand_max.\n\t\t\t\t\tif ($byte_index === $pool_length)\n\t\t\t\t\t{\n\t\t\t\t\t\t// No failures should be possible if the\n\t\t\t\t\t\t// first get_random_bytes() call didn't\n\t\t\t\t\t\t// return FALSE, but still ...\n\t\t\t\t\t\tfor ($i = 0; $i < 5; $i++)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tif (($bytes = $security->get_random_bytes($pool_length)) === FALSE)\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t$byte_index = 0;\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif ($bytes === FALSE)\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t// Sadly, this means fallback to mt_rand()\n\t\t\t\t\t\t\t$word = '';\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tlist(, $rand_index) = unpack('C', $bytes[$byte_index++]);\n\t\t\t\t\tif ($rand_index > $rand_max)\n\t\t\t\t\t{\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t$word .= $pool[$rand_index];\n\t\t\t\t\t$word_index++;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (empty($word))\n\t\t{\n\t\t\tfor ($i = 0; $i < $word_length; $i++)\n\t\t\t{\n\t\t\t\t$word .= $pool[mt_rand(0, $rand_max)];\n\t\t\t}\n\t\t}\n\t\telseif ( ! is_string($word))\n\t\t{\n\t\t\t$word = (string) $word;\n\t\t}\n\n\t\t// -----------------------------------\n\t\t// Determine angle and position\n\t\t// -----------------------------------\n\t\t$length\t= strlen($word);\n\t\t$angle\t= ($length >= 6) ? mt_rand(-($length - 6), ($length - 6)) : 0;\n\t\t$x_axis\t= mt_rand(6, (360 / $length)-16);\n\t\t$y_axis = ($angle >= 0) ? mt_rand($img_height, $img_width) : mt_rand(6, $img_height);\n\n\t\t// Create image\n\t\t// PHP.net recommends imagecreatetruecolor(), but it isn't always available\n\t\t$im = function_exists('imagecreatetruecolor')\n\t\t\t? imagecreatetruecolor($img_width, $img_height)\n\t\t\t: imagecreate($img_width, $img_height);\n\n\t\t// -----------------------------------\n\t\t// Assign colors\n\t\t// ----------------------------------\n\n\t\tis_array($colors) OR $colors = $defaults['colors'];\n\n\t\tforeach (array_keys($defaults['colors']) as $key)\n\t\t{\n\t\t\t// Check for a possible missing value\n\t\t\tis_array($colors[$key]) OR $colors[$key] = $defaults['colors'][$key];\n\t\t\t$colors[$key] = imagecolorallocate($im, $colors[$key][0], $colors[$key][1], $colors[$key][2]);\n\t\t}\n\n\t\t// Create the rectangle\n\t\tImageFilledRectangle($im, 0, 0, $img_width, $img_height, $colors['background']);\n\n\t\t// -----------------------------------\n\t\t// Create the spiral pattern\n\t\t// -----------------------------------\n\t\t$theta\t\t= 1;\n\t\t$thetac\t\t= 7;\n\t\t$radius\t\t= 16;\n\t\t$circles\t= 20;\n\t\t$points\t\t= 32;\n\n\t\tfor ($i = 0, $cp = ($circles * $points) - 1; $i < $cp; $i++)\n\t\t{\n\t\t\t$theta += $thetac;\n\t\t\t$rad = $radius * ($i / $points);\n\t\t\t$x = round(($rad * cos($theta)) + $x_axis);\n\t\t\t$y = round(($rad * sin($theta)) + $y_axis);\n\t\t\t$theta += $thetac;\n\t\t\t$rad1 = $radius * (($i + 1) / $points);\n\t\t\t$x1 = round(($rad1 * cos($theta)) + $x_axis);\n\t\t\t$y1 = round(($rad1 * sin($theta)) + $y_axis);\n\t\t\timageline($im, $x, $y, $x1, $y1, $colors['grid']);\n\t\t\t$theta -= $thetac;\n\t\t}\n\n\t\t// -----------------------------------\n\t\t// Write the text\n\t\t// -----------------------------------\n\n\t\t$use_font = ($font_path !== '' && file_exists($font_path) && function_exists('imagettftext'));\n\t\tif ($use_font === FALSE)\n\t\t{\n\t\t\t($font_size > 5) && $font_size = 5;\n\t\t\t$x = mt_rand(0, $img_width / ($length / 3));\n\t\t\t$y = 0;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t($font_size > 30) && $font_size = 30;\n\t\t\t$x = mt_rand(0, $img_width / ($length / 1.5));\n\t\t\t$y = $font_size + 2;\n\t\t}\n\n\t\tfor ($i = 0; $i < $length; $i++)\n\t\t{\n\t\t\tif ($use_font === FALSE)\n\t\t\t{\n\t\t\t\t$y = mt_rand(0 , $img_height / 2);\n\t\t\t\timagestring($im, $font_size, $x, $y, $word[$i], $colors['text']);\n\t\t\t\t$x += ($font_size * 2);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$y = mt_rand($img_height / 2, $img_height - 3);\n\t\t\t\timagettftext($im, $font_size, $angle, $x, $y, $colors['text'], $font_path, $word[$i]);\n\t\t\t\t$x += $font_size;\n\t\t\t}\n\t\t}\n\n\t\t// Create the border\n\t\timagerectangle($im, 0, 0, $img_width - 1, $img_height - 1, $colors['border']);\n\n\t\t// -----------------------------------\n\t\t// Generate the image\n\t\t// -----------------------------------\n\n\t\tif (isset($img_filename))\n\t\t{\n\t\t\t$img_src = rtrim($img_url, '/').'/'.$img_filename;\n\t\t\timagepng($im, $img_path.$img_filename);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// I don't see an easier way to get the image contents without writing to file\n\t\t\t$buffer = fopen('php://memory', 'wb+');\n\t\t\timagepng($im, $buffer);\n\t\t\trewind($buffer);\n\t\t\t$img_src = '';\n\n\t\t\t// fread() will return an empty string (not FALSE) after the entire contents are read\n\t\t\twhile (strlen($read = fread($buffer, 4096)))\n\t\t\t{\n\t\t\t\t$img_src .= $read;\n\t\t\t}\n\n\t\t\tfclose($buffer);\n\t\t\t$img_src = 'data:image/png;base64,'.base64_encode($img_src);\n\t\t}\n\n\t\t$img_class = trim($img_class);\n\t\t$img_class = (bool) strlen($img_class) ? 'class=\"'.$img_class.'\" ' : '';\n\n\t\t$img = '';\n\t\tImageDestroy($im);\n\n\t\treturn array('word' => $word, 'time' => $now, 'image' => $img, 'filename' => $img_filename);\n\t}\n}\n" }, { "path": "system/helpers/cookie_helper.php", "content": "input->set_cookie($name, $value, $expire, $domain, $path, $prefix, $secure, $httponly, $samesite);\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('get_cookie'))\n{\n\t/**\n\t * Fetch an item from the COOKIE array\n\t *\n\t * @param\tstring\n\t * @param\tbool\n\t * @return\tmixed\n\t */\n\tfunction get_cookie($index, $xss_clean = FALSE)\n\t{\n\t\t$prefix = isset($_COOKIE[$index]) ? '' : config_item('cookie_prefix');\n\t\treturn get_instance()->input->cookie($prefix.$index, $xss_clean);\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('delete_cookie'))\n{\n\t/**\n\t * Delete a COOKIE\n\t *\n\t * @param\tmixed\n\t * @param\tstring\tthe cookie domain. Usually: .yourdomain.com\n\t * @param\tstring\tthe cookie path\n\t * @param\tstring\tthe cookie prefix\n\t * @return\tvoid\n\t */\n\tfunction delete_cookie($name, $domain = '', $path = '/', $prefix = '')\n\t{\n\t\tset_cookie($name, '', '', $domain, $path, $prefix);\n\t}\n}\n" }, { "path": "system/helpers/date_helper.php", "content": "format('j-n-Y G:i:s'), '%d-%d-%d %d:%d:%d', $day, $month, $year, $hour, $minute, $second);\n\n\t\treturn mktime($hour, $minute, $second, $month, $day, $year);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('mdate'))\n{\n\t/**\n\t * Convert MySQL Style Datecodes\n\t *\n\t * This function is identical to PHPs date() function,\n\t * except that it allows date codes to be formatted using\n\t * the MySQL style, where each code letter is preceded\n\t * with a percent sign: %Y %m %d etc...\n\t *\n\t * The benefit of doing dates this way is that you don't\n\t * have to worry about escaping your text letters that\n\t * match the date codes.\n\t *\n\t * @param\tstring\n\t * @param\tint\n\t * @return\tint\n\t */\n\tfunction mdate($datestr = '', $time = '')\n\t{\n\t\tif ($datestr === '')\n\t\t{\n\t\t\treturn '';\n\t\t}\n\t\telseif (empty($time))\n\t\t{\n\t\t\t$time = now();\n\t\t}\n\n\t\t$datestr = str_replace(\n\t\t\t'%\\\\',\n\t\t\t'',\n\t\t\tpreg_replace('/([a-z]+?){1}/i', '\\\\\\\\\\\\1', $datestr)\n\t\t);\n\n\t\treturn date($datestr, $time);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('timespan'))\n{\n\t/**\n\t * Timespan\n\t *\n\t * Returns a span of seconds in this format:\n\t *\t10 days 14 hours 36 minutes 47 seconds\n\t *\n\t * @param\tint\ta number of seconds\n\t * @param\tint\tUnix timestamp\n\t * @param\tint\ta number of display units\n\t * @return\tstring\n\t */\n\tfunction timespan($seconds = 1, $time = '', $units = 7)\n\t{\n\t\t$CI =& get_instance();\n\t\t$CI->lang->load('date');\n\n\t\tis_numeric($seconds) OR $seconds = 1;\n\t\tis_numeric($time) OR $time = time();\n\t\tis_numeric($units) OR $units = 7;\n\n\t\t$seconds = ($time <= $seconds) ? 1 : $time - $seconds;\n\n\t\t$str = array();\n\t\t$years = floor($seconds / 31557600);\n\n\t\tif ($years > 0)\n\t\t{\n\t\t\t$str[] = $years.' '.$CI->lang->line($years > 1 ? 'date_years' : 'date_year');\n\t\t}\n\n\t\t$seconds -= $years * 31557600;\n\t\t$months = floor($seconds / 2629743);\n\n\t\tif (count($str) < $units && ($years > 0 OR $months > 0))\n\t\t{\n\t\t\tif ($months > 0)\n\t\t\t{\n\t\t\t\t$str[] = $months.' '.$CI->lang->line($months > 1 ? 'date_months' : 'date_month');\n\t\t\t}\n\n\t\t\t$seconds -= $months * 2629743;\n\t\t}\n\n\t\t$weeks = floor($seconds / 604800);\n\n\t\tif (count($str) < $units && ($years > 0 OR $months > 0 OR $weeks > 0))\n\t\t{\n\t\t\tif ($weeks > 0)\n\t\t\t{\n\t\t\t\t$str[] = $weeks.' '.$CI->lang->line($weeks > 1 ? 'date_weeks' : 'date_week');\n\t\t\t}\n\n\t\t\t$seconds -= $weeks * 604800;\n\t\t}\n\n\t\t$days = floor($seconds / 86400);\n\n\t\tif (count($str) < $units && ($months > 0 OR $weeks > 0 OR $days > 0))\n\t\t{\n\t\t\tif ($days > 0)\n\t\t\t{\n\t\t\t\t$str[] = $days.' '.$CI->lang->line($days > 1 ? 'date_days' : 'date_day');\n\t\t\t}\n\n\t\t\t$seconds -= $days * 86400;\n\t\t}\n\n\t\t$hours = floor($seconds / 3600);\n\n\t\tif (count($str) < $units && ($days > 0 OR $hours > 0))\n\t\t{\n\t\t\tif ($hours > 0)\n\t\t\t{\n\t\t\t\t$str[] = $hours.' '.$CI->lang->line($hours > 1 ? 'date_hours' : 'date_hour');\n\t\t\t}\n\n\t\t\t$seconds -= $hours * 3600;\n\t\t}\n\n\t\t$minutes = floor($seconds / 60);\n\n\t\tif (count($str) < $units && ($days > 0 OR $hours > 0 OR $minutes > 0))\n\t\t{\n\t\t\tif ($minutes > 0)\n\t\t\t{\n\t\t\t\t$str[] = $minutes.' '.$CI->lang->line($minutes > 1 ? 'date_minutes' : 'date_minute');\n\t\t\t}\n\n\t\t\t$seconds -= $minutes * 60;\n\t\t}\n\n\t\tif (count($str) === 0)\n\t\t{\n\t\t\t$str[] = $seconds.' '.$CI->lang->line($seconds > 1 ? 'date_seconds' : 'date_second');\n\t\t}\n\n\t\treturn implode(', ', $str);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('days_in_month'))\n{\n\t/**\n\t * Number of days in a month\n\t *\n\t * Takes a month/year as input and returns the number of days\n\t * for the given month/year. Takes leap years into consideration.\n\t *\n\t * @param\tint\ta numeric month\n\t * @param\tint\ta numeric year\n\t * @return\tint\n\t */\n\tfunction days_in_month($month = 0, $year = '')\n\t{\n\t\tif ($month < 1 OR $month > 12)\n\t\t{\n\t\t\treturn 0;\n\t\t}\n\t\telseif ( ! is_numeric($year) OR strlen($year) !== 4)\n\t\t{\n\t\t\t$year = date('Y');\n\t\t}\n\n\t\tif (defined('CAL_GREGORIAN'))\n\t\t{\n\t\t\treturn cal_days_in_month(CAL_GREGORIAN, $month, $year);\n\t\t}\n\n\t\tif ($year >= 1970)\n\t\t{\n\t\t\treturn (int) date('t', mktime(12, 0, 0, $month, 1, $year));\n\t\t}\n\n\t\tif ($month == 2)\n\t\t{\n\t\t\tif ($year % 400 === 0 OR ($year % 4 === 0 && $year % 100 !== 0))\n\t\t\t{\n\t\t\t\treturn 29;\n\t\t\t}\n\t\t}\n\n\t\t$days_in_month\t= array(31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31);\n\t\treturn $days_in_month[$month - 1];\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('local_to_gmt'))\n{\n\t/**\n\t * Converts a local Unix timestamp to GMT\n\t *\n\t * @param\tint\tUnix timestamp\n\t * @return\tint\n\t */\n\tfunction local_to_gmt($time = '')\n\t{\n\t\tif ($time === '')\n\t\t{\n\t\t\t$time = time();\n\t\t}\n\n\t\treturn mktime(\n\t\t\tgmdate('G', $time),\n\t\t\tgmdate('i', $time),\n\t\t\tgmdate('s', $time),\n\t\t\tgmdate('n', $time),\n\t\t\tgmdate('j', $time),\n\t\t\tgmdate('Y', $time)\n\t\t);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('gmt_to_local'))\n{\n\t/**\n\t * Converts GMT time to a localized value\n\t *\n\t * Takes a Unix timestamp (in GMT) as input, and returns\n\t * at the local value based on the timezone and DST setting\n\t * submitted\n\t *\n\t * @param\tint\tUnix timestamp\n\t * @param\tstring\ttimezone\n\t * @param\tbool\twhether DST is active\n\t * @return\tint\n\t */\n\tfunction gmt_to_local($time = '', $timezone = 'UTC', $dst = FALSE)\n\t{\n\t\tif ($time === '')\n\t\t{\n\t\t\treturn now();\n\t\t}\n\n\t\t$time += timezones($timezone) * 3600;\n\n\t\treturn ($dst === TRUE) ? $time + 3600 : $time;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('mysql_to_unix'))\n{\n\t/**\n\t * Converts a MySQL Timestamp to Unix\n\t *\n\t * @param\tint\tMySQL timestamp YYYY-MM-DD HH:MM:SS\n\t * @return\tint\tUnix timstamp\n\t */\n\tfunction mysql_to_unix($time = '')\n\t{\n\t\t// We'll remove certain characters for backward compatibility\n\t\t// since the formatting changed with MySQL 4.1\n\t\t// YYYY-MM-DD HH:MM:SS\n\n\t\t$time = str_replace(array('-', ':', ' '), '', $time);\n\n\t\t// YYYYMMDDHHMMSS\n\t\treturn mktime(\n\t\t\tsubstr($time, 8, 2),\n\t\t\tsubstr($time, 10, 2),\n\t\t\tsubstr($time, 12, 2),\n\t\t\tsubstr($time, 4, 2),\n\t\t\tsubstr($time, 6, 2),\n\t\t\tsubstr($time, 0, 4)\n\t\t);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('unix_to_human'))\n{\n\t/**\n\t * Unix to \"Human\"\n\t *\n\t * Formats Unix timestamp to the following prototype: 2006-08-21 11:35 PM\n\t *\n\t * @param\tint\tUnix timestamp\n\t * @param\tbool\twhether to show seconds\n\t * @param\tstring\tformat: us or euro\n\t * @return\tstring\n\t */\n\tfunction unix_to_human($time = '', $seconds = FALSE, $fmt = 'us')\n\t{\n\t\t$r = date('Y', $time).'-'.date('m', $time).'-'.date('d', $time).' ';\n\n\t\tif ($fmt === 'us')\n\t\t{\n\t\t\t$r .= date('h', $time).':'.date('i', $time);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$r .= date('H', $time).':'.date('i', $time);\n\t\t}\n\n\t\tif ($seconds)\n\t\t{\n\t\t\t$r .= ':'.date('s', $time);\n\t\t}\n\n\t\tif ($fmt === 'us')\n\t\t{\n\t\t\treturn $r.' '.date('A', $time);\n\t\t}\n\n\t\treturn $r;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('human_to_unix'))\n{\n\t/**\n\t * Convert \"human\" date to GMT\n\t *\n\t * Reverses the above process\n\t *\n\t * @param\tstring\tformat: us or euro\n\t * @return\tint\n\t */\n\tfunction human_to_unix($datestr = '')\n\t{\n\t\tif ($datestr === '')\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$datestr = preg_replace('/\\040+/', ' ', trim($datestr));\n\n\t\tif ( ! preg_match('/^(\\d{2}|\\d{4})\\-[0-9]{1,2}\\-[0-9]{1,2}\\s[0-9]{1,2}:[0-9]{1,2}(?::[0-9]{1,2})?(?:\\s[AP]M)?$/i', $datestr))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tsscanf($datestr, '%d-%d-%d %s %s', $year, $month, $day, $time, $ampm);\n\t\tsscanf($time, '%d:%d:%d', $hour, $min, $sec);\n\t\tisset($sec) OR $sec = 0;\n\n\t\tif (isset($ampm))\n\t\t{\n\t\t\t$ampm = strtolower($ampm);\n\n\t\t\tif ($ampm[0] === 'p' && $hour < 12)\n\t\t\t{\n\t\t\t\t$hour += 12;\n\t\t\t}\n\t\t\telseif ($ampm[0] === 'a' && $hour === 12)\n\t\t\t{\n\t\t\t\t$hour = 0;\n\t\t\t}\n\t\t}\n\n\t\treturn mktime($hour, $min, $sec, $month, $day, $year);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('timezone_menu'))\n{\n\t/**\n\t * Timezone Menu\n\t *\n\t * Generates a drop-down menu of timezones.\n\t *\n\t * @param\tstring\ttimezone\n\t * @param\tstring\tclassname\n\t * @param\tstring\tmenu name\n\t * @param\tmixed\tattributes\n\t * @return\tstring\n\t */\n\tfunction timezone_menu($default = 'UTC', $class = '', $name = 'timezones', $attributes = '')\n\t{\n\t\t$CI =& get_instance();\n\t\t$CI->lang->load('date');\n\n\t\t$default = ($default === 'GMT') ? 'UTC' : $default;\n\n\t\t$menu = '';\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('timezones'))\n{\n\t/**\n\t * Timezones\n\t *\n\t * Returns an array of timezones. This is a helper function\n\t * for various other ones in this library\n\t *\n\t * @param\tstring\ttimezone\n\t * @return\tstring\n\t */\n\tfunction timezones($tz = '')\n\t{\n\t\t// Note: Don't change the order of these even though\n\t\t// some items appear to be in the wrong order\n\n\t\t$zones = array(\n\t\t\t'UM12'\t\t=> -12,\n\t\t\t'UM11'\t\t=> -11,\n\t\t\t'UM10'\t\t=> -10,\n\t\t\t'UM95'\t\t=> -9.5,\n\t\t\t'UM9'\t\t=> -9,\n\t\t\t'UM8'\t\t=> -8,\n\t\t\t'UM7'\t\t=> -7,\n\t\t\t'UM6'\t\t=> -6,\n\t\t\t'UM5'\t\t=> -5,\n\t\t\t'UM45'\t\t=> -4.5,\n\t\t\t'UM4'\t\t=> -4,\n\t\t\t'UM35'\t\t=> -3.5,\n\t\t\t'UM3'\t\t=> -3,\n\t\t\t'UM2'\t\t=> -2,\n\t\t\t'UM1'\t\t=> -1,\n\t\t\t'UTC'\t\t=> 0,\n\t\t\t'UP1'\t\t=> +1,\n\t\t\t'UP2'\t\t=> +2,\n\t\t\t'UP3'\t\t=> +3,\n\t\t\t'UP35'\t\t=> +3.5,\n\t\t\t'UP4'\t\t=> +4,\n\t\t\t'UP45'\t\t=> +4.5,\n\t\t\t'UP5'\t\t=> +5,\n\t\t\t'UP55'\t\t=> +5.5,\n\t\t\t'UP575'\t\t=> +5.75,\n\t\t\t'UP6'\t\t=> +6,\n\t\t\t'UP65'\t\t=> +6.5,\n\t\t\t'UP7'\t\t=> +7,\n\t\t\t'UP8'\t\t=> +8,\n\t\t\t'UP875'\t\t=> +8.75,\n\t\t\t'UP9'\t\t=> +9,\n\t\t\t'UP95'\t\t=> +9.5,\n\t\t\t'UP10'\t\t=> +10,\n\t\t\t'UP105'\t\t=> +10.5,\n\t\t\t'UP11'\t\t=> +11,\n\t\t\t'UP115'\t\t=> +11.5,\n\t\t\t'UP12'\t\t=> +12,\n\t\t\t'UP1275'\t=> +12.75,\n\t\t\t'UP13'\t\t=> +13,\n\t\t\t'UP14'\t\t=> +14\n\t\t);\n\n\t\tif ($tz === '')\n\t\t{\n\t\t\treturn $zones;\n\t\t}\n\n\t\treturn isset($zones[$tz]) ? $zones[$tz] : 0;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('date_range'))\n{\n\t/**\n\t * Date range\n\t *\n\t * Returns a list of dates within a specified period.\n\t *\n\t * @param\tint\tunix_start\tUNIX timestamp of period start date\n\t * @param\tint\tunix_end|days\tUNIX timestamp of period end date\n\t *\t\t\t\t\tor interval in days.\n\t * @param\tmixed\tis_unix\t\tSpecifies whether the second parameter\n\t *\t\t\t\t\tis a UNIX timestamp or a day interval\n\t *\t\t\t\t\t - TRUE or 'unix' for a timestamp\n\t *\t\t\t\t\t - FALSE or 'days' for an interval\n\t * @param\tstring date_format\tOutput date format, same as in date()\n\t * @return\tarray\n\t */\n\tfunction date_range($unix_start = '', $mixed = '', $is_unix = TRUE, $format = 'Y-m-d')\n\t{\n\t\tif ($unix_start == '' OR $mixed == '' OR $format == '')\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\t$is_unix = ! ( ! $is_unix OR $is_unix === 'days');\n\n\t\t// Validate input and try strtotime() on invalid timestamps/intervals, just in case\n\t\tif ( ( ! ctype_digit((string) $unix_start) && ($unix_start = @strtotime($unix_start)) === FALSE)\n\t\t\tOR ( ! ctype_digit((string) $mixed) && ($is_unix === FALSE OR ($mixed = @strtotime($mixed)) === FALSE))\n\t\t\tOR ($is_unix === TRUE && $mixed < $unix_start))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif ($is_unix && ($unix_start == $mixed OR date($format, $unix_start) === date($format, $mixed)))\n\t\t{\n\t\t\treturn array(date($format, $unix_start));\n\t\t}\n\n\t\t$range = array();\n\n\t\t$from = new DateTime();\n\t\t$from->setTimestamp($unix_start);\n\n\t\tif ($is_unix)\n\t\t{\n\t\t\t$arg = new DateTime();\n\t\t\t$arg->setTimestamp($mixed);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$arg = (int) $mixed;\n\t\t}\n\n\t\t$period = new DatePeriod($from, new DateInterval('P1D'), $arg);\n\t\tforeach ($period as $date)\n\t\t{\n\t\t\t$range[] = $date->format($format);\n\t\t}\n\n\t\t/* If a period end date was passed to the DatePeriod constructor, it might not\n\t\t * be in our results. Not sure if this is a bug or it's just possible because\n\t\t * the end date might actually be less than 24 hours away from the previously\n\t\t * generated DateTime object, but either way - we have to append it manually.\n\t\t */\n\t\tif ( ! is_int($arg) && $range[count($range) - 1] !== $arg->format($format))\n\t\t{\n\t\t\t$range[] = $arg->format($format);\n\t\t}\n\n\t\treturn $range;\n\t}\n}\n" }, { "path": "system/helpers/directory_helper.php", "content": " 0) && is_dir($source_dir.$file))\n\t\t\t\t{\n\t\t\t\t\t$filedata[$file] = directory_map($source_dir.$file, $new_depth, $hidden);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t$filedata[] = $file;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tclosedir($fp);\n\t\t\treturn $filedata;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n}\n" }, { "path": "system/helpers/download_helper.php", "content": " destination filename)\n\t * @param\tmixed\tthe data to be downloaded\n\t * @param\tbool\twhether to try and send the actual file MIME type\n\t * @return\tvoid\n\t */\n\tfunction force_download($filename = '', $data = '', $set_mime = FALSE)\n\t{\n\t\tif ($filename === '' OR $data === '')\n\t\t{\n\t\t\treturn;\n\t\t}\n\t\telseif ($data === NULL)\n\t\t{\n\t\t\t// Is $filename an array as ['local source path' => 'destination filename']?\n\t\t\tif (is_array($filename))\n\t\t\t{\n\t\t\t\tif (count($filename) !== 1)\n\t\t\t\t{\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\treset($filename);\n\t\t\t\t$filepath = key($filename);\n\t\t\t\t$filename = current($filename);\n\n\t\t\t\tif (is_int($filepath))\n\t\t\t\t{\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$filepath = $filename;\n\t\t\t\t$filename = explode('/', str_replace(DIRECTORY_SEPARATOR, '/', $filename));\n\t\t\t\t$filename = end($filename);\n\t\t\t}\n\n\t\t\tif ( ! @is_file($filepath) OR ($filesize = @filesize($filepath)) === FALSE)\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$filesize = strlen($data);\n\t\t}\n\n\t\t// Set the default MIME type to send\n\t\t$mime = 'application/octet-stream';\n\n\t\t$x = explode('.', $filename);\n\t\t$extension = end($x);\n\n\t\tif ($set_mime === TRUE)\n\t\t{\n\t\t\tif (count($x) === 1 OR $extension === '')\n\t\t\t{\n\t\t\t\t/* If we're going to detect the MIME type,\n\t\t\t\t * we'll need a file extension.\n\t\t\t\t */\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Load the mime types\n\t\t\t$mimes =& get_mimes();\n\n\t\t\t// Only change the default MIME if we can find one\n\t\t\tif (isset($mimes[$extension]))\n\t\t\t{\n\t\t\t\t$mime = is_array($mimes[$extension]) ? $mimes[$extension][0] : $mimes[$extension];\n\t\t\t}\n\t\t}\n\n\t\t/* It was reported that browsers on Android 2.1 (and possibly older as well)\n\t\t * need to have the filename extension upper-cased in order to be able to\n\t\t * download it.\n\t\t *\n\t\t * Reference: http://digiblog.de/2011/04/19/android-and-the-download-file-headers/\n\t\t */\n\t\tif (count($x) !== 1 && isset($_SERVER['HTTP_USER_AGENT']) && preg_match('/Android\\s(1|2\\.[01])/', $_SERVER['HTTP_USER_AGENT']))\n\t\t{\n\t\t\t$x[count($x) - 1] = strtoupper($extension);\n\t\t\t$filename = implode('.', $x);\n\t\t}\n\n\t\t// Clean output buffer\n\t\tif (ob_get_level() !== 0 && @ob_end_clean() === FALSE)\n\t\t{\n\t\t\t@ob_clean();\n\t\t}\n\n\t\t// RFC 6266 allows for multibyte filenames, but only in UTF-8,\n\t\t// so we have to make it conditional ...\n\t\t$charset = strtoupper(config_item('charset'));\n\t\t$utf8_filename = ($charset !== 'UTF-8')\n\t\t\t? get_instance()->utf8->convert_to_utf8($filename, $charset)\n\t\t\t: $filename;\n\t\tisset($utf8_filename[0]) && $utf8_filename = \" filename*=UTF-8''\".rawurlencode($utf8_filename);\n\n\t\t// Generate the server headers\n\t\theader('Content-Type: '.$mime);\n\t\theader('Content-Disposition: attachment; filename=\"'.$filename.'\";'.$utf8_filename);\n\t\theader('Expires: 0');\n\t\theader('Content-Transfer-Encoding: binary');\n\t\theader('Content-Length: '.$filesize);\n\t\theader('Cache-Control: private, no-transform, no-store, must-revalidate');\n\n\t\t// If we have raw data - just dump it\n\t\tif ($data !== NULL)\n\t\t{\n\t\t\texit($data);\n\t\t}\n\n\t\t// Flush the file\n\t\tif (@readfile($filepath) === FALSE)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\texit;\n\t}\n}\n" }, { "path": "system/helpers/file_helper.php", "content": " 0)\n\t\t\t? @rmdir($path)\n\t\t\t: TRUE;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('get_filenames'))\n{\n\t/**\n\t * Get Filenames\n\t *\n\t * Reads the specified directory and builds an array containing the filenames.\n\t * Any sub-folders contained within the specified path are read as well.\n\t *\n\t * @param\tstring\tpath to source\n\t * @param\tbool\twhether to include the path as part of the filename\n\t * @param\tbool\tinternal variable to determine recursion status - do not use in calls\n\t * @return\tarray\n\t */\n\tfunction get_filenames($source_dir, $include_path = FALSE, $_recursion = FALSE)\n\t{\n\t\tstatic $_filedata = array();\n\n\t\tif ($fp = @opendir($source_dir))\n\t\t{\n\t\t\t// reset the array and make sure $source_dir has a trailing slash on the initial call\n\t\t\tif ($_recursion === FALSE)\n\t\t\t{\n\t\t\t\t$_filedata = array();\n\t\t\t\t$source_dir = rtrim(realpath($source_dir), DIRECTORY_SEPARATOR).DIRECTORY_SEPARATOR;\n\t\t\t}\n\n\t\t\twhile (FALSE !== ($file = readdir($fp)))\n\t\t\t{\n\t\t\t\tif (is_dir($source_dir.$file) && $file[0] !== '.')\n\t\t\t\t{\n\t\t\t\t\tget_filenames($source_dir.$file.DIRECTORY_SEPARATOR, $include_path, TRUE);\n\t\t\t\t}\n\t\t\t\telseif ($file[0] !== '.')\n\t\t\t\t{\n\t\t\t\t\t$_filedata[] = ($include_path === TRUE) ? $source_dir.$file : $file;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tclosedir($fp);\n\t\t\treturn $_filedata;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('get_dir_file_info'))\n{\n\t/**\n\t * Get Directory File Information\n\t *\n\t * Reads the specified directory and builds an array containing the filenames,\n\t * filesize, dates, and permissions\n\t *\n\t * Any sub-folders contained within the specified path are read as well.\n\t *\n\t * @param\tstring\tpath to source\n\t * @param\tbool\tLook only at the top level directory specified?\n\t * @param\tbool\tinternal variable to determine recursion status - do not use in calls\n\t * @return\tarray\n\t */\n\tfunction get_dir_file_info($source_dir, $top_level_only = TRUE, $_recursion = FALSE)\n\t{\n\t\tstatic $_filedata = array();\n\t\t$relative_path = $source_dir;\n\n\t\tif ($fp = @opendir($source_dir))\n\t\t{\n\t\t\t// reset the array and make sure $source_dir has a trailing slash on the initial call\n\t\t\tif ($_recursion === FALSE)\n\t\t\t{\n\t\t\t\t$_filedata = array();\n\t\t\t\t$source_dir = rtrim(realpath($source_dir), DIRECTORY_SEPARATOR).DIRECTORY_SEPARATOR;\n\t\t\t}\n\n\t\t\t// Used to be foreach (scandir($source_dir, 1) as $file), but scandir() is simply not as fast\n\t\t\twhile (FALSE !== ($file = readdir($fp)))\n\t\t\t{\n\t\t\t\tif (is_dir($source_dir.$file) && $file[0] !== '.' && $top_level_only === FALSE)\n\t\t\t\t{\n\t\t\t\t\tget_dir_file_info($source_dir.$file.DIRECTORY_SEPARATOR, $top_level_only, TRUE);\n\t\t\t\t}\n\t\t\t\telseif ($file[0] !== '.')\n\t\t\t\t{\n\t\t\t\t\t$filedata = get_dir_file_info($source_dir.$file);\n\t\t\t\t\t$filedata['relative_path'] = $relative_path;\n\t\t\t\t\t$_filedata[] = $filedata;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tclosedir($fp);\n\t\t\treturn $_filedata;\n\t\t}\n\n\t\treturn FALSE;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('get_file_info'))\n{\n\t/**\n\t * Get File Info\n\t *\n\t * Given a file and path, returns the name, path, size, date modified\n\t * Second parameter allows you to explicitly declare what information you want returned\n\t * Options are: name, server_path, size, date, readable, writable, executable, fileperms\n\t * Returns FALSE if the file cannot be found.\n\t *\n\t * @param\tstring\tpath to file\n\t * @param\tmixed\tarray or comma separated string of information returned\n\t * @return\tarray\n\t */\n\tfunction get_file_info($file, $returned_values = array('name', 'server_path', 'size', 'date'))\n\t{\n\t\tif ( ! file_exists($file))\n\t\t{\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (is_string($returned_values))\n\t\t{\n\t\t\t$returned_values = explode(',', $returned_values);\n\t\t}\n\n\t\tforeach ($returned_values as $key)\n\t\t{\n\t\t\tswitch ($key)\n\t\t\t{\n\t\t\t\tcase 'name':\n\t\t\t\t\t$fileinfo['name'] = basename($file);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'server_path':\n\t\t\t\t\t$fileinfo['server_path'] = $file;\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'size':\n\t\t\t\t\t$fileinfo['size'] = filesize($file);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'date':\n\t\t\t\t\t$fileinfo['date'] = filemtime($file);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'readable':\n\t\t\t\t\t$fileinfo['readable'] = is_readable($file);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'writable':\n\t\t\t\t\t$fileinfo['writable'] = is_really_writable($file);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'executable':\n\t\t\t\t\t$fileinfo['executable'] = is_executable($file);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'fileperms':\n\t\t\t\t\t$fileinfo['fileperms'] = fileperms($file);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\treturn $fileinfo;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('get_mime_by_extension'))\n{\n\t/**\n\t * Get Mime by Extension\n\t *\n\t * Translates a file extension into a mime type based on config/mimes.php.\n\t * Returns FALSE if it can't determine the type, or open the mime config file\n\t *\n\t * Note: this is NOT an accurate way of determining file mime types, and is here strictly as a convenience\n\t * It should NOT be trusted, and should certainly NOT be used for security\n\t *\n\t * @param\tstring\t$filename\tFile name\n\t * @return\tstring\n\t */\n\tfunction get_mime_by_extension($filename)\n\t{\n\t\tstatic $mimes;\n\n\t\tif ( ! is_array($mimes))\n\t\t{\n\t\t\t$mimes = get_mimes();\n\n\t\t\tif (empty($mimes))\n\t\t\t{\n\t\t\t\treturn FALSE;\n\t\t\t}\n\t\t}\n\n\t\t$extension = strtolower(substr(strrchr($filename, '.'), 1));\n\n\t\tif (isset($mimes[$extension]))\n\t\t{\n\t\t\treturn is_array($mimes[$extension])\n\t\t\t\t? current($mimes[$extension]) // Multiple mime types, just give the first one\n\t\t\t\t: $mimes[$extension];\n\t\t}\n\n\t\treturn FALSE;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('symbolic_permissions'))\n{\n\t/**\n\t * Symbolic Permissions\n\t *\n\t * Takes a numeric value representing a file's permissions and returns\n\t * standard symbolic notation representing that value\n\t *\n\t * @param\tint\t$perms\tPermissions\n\t * @return\tstring\n\t */\n\tfunction symbolic_permissions($perms)\n\t{\n\t\tif (($perms & 0xC000) === 0xC000)\n\t\t{\n\t\t\t$symbolic = 's'; // Socket\n\t\t}\n\t\telseif (($perms & 0xA000) === 0xA000)\n\t\t{\n\t\t\t$symbolic = 'l'; // Symbolic Link\n\t\t}\n\t\telseif (($perms & 0x8000) === 0x8000)\n\t\t{\n\t\t\t$symbolic = '-'; // Regular\n\t\t}\n\t\telseif (($perms & 0x6000) === 0x6000)\n\t\t{\n\t\t\t$symbolic = 'b'; // Block special\n\t\t}\n\t\telseif (($perms & 0x4000) === 0x4000)\n\t\t{\n\t\t\t$symbolic = 'd'; // Directory\n\t\t}\n\t\telseif (($perms & 0x2000) === 0x2000)\n\t\t{\n\t\t\t$symbolic = 'c'; // Character special\n\t\t}\n\t\telseif (($perms & 0x1000) === 0x1000)\n\t\t{\n\t\t\t$symbolic = 'p'; // FIFO pipe\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$symbolic = 'u'; // Unknown\n\t\t}\n\n\t\t// Owner\n\t\t$symbolic .= (($perms & 0x0100) ? 'r' : '-')\n\t\t\t.(($perms & 0x0080) ? 'w' : '-')\n\t\t\t.(($perms & 0x0040) ? (($perms & 0x0800) ? 's' : 'x' ) : (($perms & 0x0800) ? 'S' : '-'));\n\n\t\t// Group\n\t\t$symbolic .= (($perms & 0x0020) ? 'r' : '-')\n\t\t\t.(($perms & 0x0010) ? 'w' : '-')\n\t\t\t.(($perms & 0x0008) ? (($perms & 0x0400) ? 's' : 'x' ) : (($perms & 0x0400) ? 'S' : '-'));\n\n\t\t// World\n\t\t$symbolic .= (($perms & 0x0004) ? 'r' : '-')\n\t\t\t.(($perms & 0x0002) ? 'w' : '-')\n\t\t\t.(($perms & 0x0001) ? (($perms & 0x0200) ? 't' : 'x' ) : (($perms & 0x0200) ? 'T' : '-'));\n\n\t\treturn $symbolic;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('octal_permissions'))\n{\n\t/**\n\t * Octal Permissions\n\t *\n\t * Takes a numeric value representing a file's permissions and returns\n\t * a three character string representing the file's octal permissions\n\t *\n\t * @param\tint\t$perms\tPermissions\n\t * @return\tstring\n\t */\n\tfunction octal_permissions($perms)\n\t{\n\t\treturn substr(sprintf('%o', $perms), -3);\n\t}\n}\n" }, { "path": "system/helpers/form_helper.php", "content": "config->site_url($CI->uri->uri_string());\n\t\t}\n\t\t// If an action is not a full URL then turn it into one\n\t\telseif (strpos($action, '://') === FALSE)\n\t\t{\n\t\t\t$action = $CI->config->site_url($action);\n\t\t}\n\n\t\t$attributes = _attributes_to_string($attributes);\n\n\t\tif (stripos($attributes, 'method=') === FALSE)\n\t\t{\n\t\t\t$attributes .= ' method=\"post\"';\n\t\t}\n\n\t\tif (stripos($attributes, 'accept-charset=') === FALSE)\n\t\t{\n\t\t\t$attributes .= ' accept-charset=\"'.strtolower(config_item('charset')).'\"';\n\t\t}\n\n\t\t$form = '
\\n\";\n\n\t\tif (is_array($hidden))\n\t\t{\n\t\t\tforeach ($hidden as $name => $value)\n\t\t\t{\n\t\t\t\t$form .= ''.\"\\n\";\n\t\t\t}\n\t\t}\n\n\t\t// Add CSRF field if enabled, but leave it out for GET requests and requests to external websites\n\t\tif ($CI->config->item('csrf_protection') === TRUE && strpos($action, $CI->config->base_url()) !== FALSE && ! stripos($form, 'method=\"get\"'))\n\t\t{\n\t\t\t// Prepend/append random-length \"white noise\" around the CSRF\n\t\t\t// token input, as a form of protection against BREACH attacks\n\t\t\tif (FALSE !== ($noise = $CI->security->get_random_bytes(1)))\n\t\t\t{\n\t\t\t\tlist(, $noise) = unpack('c', $noise);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$noise = mt_rand(-128, 127);\n\t\t\t}\n\n\t\t\t// Prepend if $noise has a negative value, append if positive, do nothing for zero\n\t\t\t$prepend = $append = '';\n\t\t\tif ($noise < 0)\n\t\t\t{\n\t\t\t\t$prepend = str_repeat(\" \", abs($noise));\n\t\t\t}\n\t\t\telseif ($noise > 0)\n\t\t\t{\n\t\t\t\t$append = str_repeat(\" \", $noise);\n\t\t\t}\n\n\t\t\t$form .= sprintf(\n\t\t\t\t'%s%s%s',\n\t\t\t\t$prepend,\n\t\t\t\t$CI->security->get_csrf_token_name(),\n\t\t\t\t$CI->security->get_csrf_hash(),\n\t\t\t\t$append,\n\t\t\t\t\"\\n\"\n\t\t\t);\n\t\t}\n\n\t\treturn $form;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_open_multipart'))\n{\n\t/**\n\t * Form Declaration - Multipart type\n\t *\n\t * Creates the opening portion of the form, but with \"multipart/form-data\".\n\t *\n\t * @param\tstring\tthe URI segments of the form destination\n\t * @param\tarray\ta key/value pair of attributes\n\t * @param\tarray\ta key/value pair hidden data\n\t * @return\tstring\n\t */\n\tfunction form_open_multipart($action = '', $attributes = array(), $hidden = array())\n\t{\n\t\tif (is_string($attributes))\n\t\t{\n\t\t\t$attributes .= ' enctype=\"multipart/form-data\"';\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$attributes['enctype'] = 'multipart/form-data';\n\t\t}\n\n\t\treturn form_open($action, $attributes, $hidden);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_hidden'))\n{\n\t/**\n\t * Hidden Input Field\n\t *\n\t * Generates hidden fields. You can pass a simple key/value string or\n\t * an associative array with multiple values.\n\t *\n\t * @param\tmixed\t$name\t\tField name\n\t * @param\tstring\t$value\t\tField value\n\t * @param\tbool\t$recursing\n\t * @return\tstring\n\t */\n\tfunction form_hidden($name, $value = '', $recursing = FALSE)\n\t{\n\t\tstatic $form;\n\n\t\tif ($recursing === FALSE)\n\t\t{\n\t\t\t$form = \"\\n\";\n\t\t}\n\n\t\tif (is_array($name))\n\t\t{\n\t\t\tforeach ($name as $key => $val)\n\t\t\t{\n\t\t\t\tform_hidden($key, $val, TRUE);\n\t\t\t}\n\n\t\t\treturn $form;\n\t\t}\n\n\t\tif ( ! is_array($value))\n\t\t{\n\t\t\t$form .= '\\n\";\n\t\t}\n\t\telse\n\t\t{\n\t\t\tforeach ($value as $k => $v)\n\t\t\t{\n\t\t\t\t$k = is_int($k) ? '' : $k;\n\t\t\t\tform_hidden($name.'['.$k.']', $v, TRUE);\n\t\t\t}\n\t\t}\n\n\t\treturn $form;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_input'))\n{\n\t/**\n\t * Text Input Field\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_input($data = '', $value = '', $extra = '')\n\t{\n\t\t$defaults = array(\n\t\t\t'type' => 'text',\n\t\t\t'name' => is_array($data) ? '' : $data,\n\t\t\t'value' => $value\n\t\t);\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_password'))\n{\n\t/**\n\t * Password Field\n\t *\n\t * Identical to the input function but adds the \"password\" type\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_password($data = '', $value = '', $extra = '')\n\t{\n\t\tis_array($data) OR $data = array('name' => $data);\n\t\t$data['type'] = 'password';\n\t\treturn form_input($data, $value, $extra);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_upload'))\n{\n\t/**\n\t * Upload Field\n\t *\n\t * Identical to the input function but adds the \"file\" type\n\t *\n\t * @param\tmixed\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_upload($data = '', $extra = '')\n\t{\n\t\t$defaults = array('type' => 'file', 'name' => '');\n\t\tis_array($data) OR $data = array('name' => $data);\n\t\t$data['type'] = 'file';\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_textarea'))\n{\n\t/**\n\t * Textarea field\n\t *\n\t * @param\tmixed\t$data\n\t * @param\tstring\t$value\n\t * @param\tmixed\t$extra\n\t * @return\tstring\n\t */\n\tfunction form_textarea($data = '', $value = '', $extra = '')\n\t{\n\t\t$defaults = array(\n\t\t\t'name' => is_array($data) ? '' : $data,\n\t\t\t'cols' => '40',\n\t\t\t'rows' => '10'\n\t\t);\n\n\t\tif ( ! is_array($data) OR ! isset($data['value']))\n\t\t{\n\t\t\t$val = $value;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$val = $data['value'];\n\t\t\tunset($data['value']); // textareas don't use the value attribute\n\t\t}\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_multiselect'))\n{\n\t/**\n\t * Multi-select menu\n\t *\n\t * @param\tstring\n\t * @param\tarray\n\t * @param\tmixed\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_multiselect($name = '', $options = array(), $selected = array(), $extra = '')\n\t{\n\t\t$extra = _attributes_to_string($extra);\n\t\tif (stripos($extra, 'multiple') === FALSE)\n\t\t{\n\t\t\t$extra .= ' multiple=\"multiple\"';\n\t\t}\n\n\t\treturn form_dropdown($name, $options, $selected, $extra);\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('form_dropdown'))\n{\n\t/**\n\t * Drop-down Menu\n\t *\n\t * @param\tmixed\t$data\n\t * @param\tmixed\t$options\n\t * @param\tmixed\t$selected\n\t * @param\tmixed\t$extra\n\t * @return\tstring\n\t */\n\tfunction form_dropdown($data = '', $options = array(), $selected = array(), $extra = '')\n\t{\n\t\t$defaults = array();\n\n\t\tif (is_array($data))\n\t\t{\n\t\t\tif (isset($data['selected']))\n\t\t\t{\n\t\t\t\t$selected = $data['selected'];\n\t\t\t\tunset($data['selected']); // select tags don't have a selected attribute\n\t\t\t}\n\n\t\t\tif (isset($data['options']))\n\t\t\t{\n\t\t\t\t$options = $data['options'];\n\t\t\t\tunset($data['options']); // select tags don't use an options attribute\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$defaults = array('name' => $data);\n\t\t}\n\n\t\tis_array($selected) OR $selected = array($selected);\n\t\tis_array($options) OR $options = array($options);\n\n\t\t// If no selected state was submitted we will attempt to set it automatically\n\t\tif (empty($selected))\n\t\t{\n\t\t\tif (is_array($data))\n\t\t\t{\n\t\t\t\tif (isset($data['name'], $_POST[$data['name']]))\n\t\t\t\t{\n\t\t\t\t\t$selected = array($_POST[$data['name']]);\n\t\t\t\t}\n\t\t\t}\n\t\t\telseif (isset($_POST[$data]))\n\t\t\t{\n\t\t\t\t$selected = array($_POST[$data]);\n\t\t\t}\n\t\t}\n\n\t\t$extra = _attributes_to_string($extra);\n\n\t\t$multiple = (count($selected) > 1 && stripos($extra, 'multiple') === FALSE) ? ' multiple=\"multiple\"' : '';\n\n\t\t$form = '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_checkbox'))\n{\n\t/**\n\t * Checkbox Field\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tbool\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_checkbox($data = '', $value = '', $checked = FALSE, $extra = '')\n\t{\n\t\t$defaults = array('type' => 'checkbox', 'name' => ( ! is_array($data) ? $data : ''), 'value' => $value);\n\n\t\tif (is_array($data) && array_key_exists('checked', $data))\n\t\t{\n\t\t\t$checked = $data['checked'];\n\n\t\t\tif ($checked == FALSE)\n\t\t\t{\n\t\t\t\tunset($data['checked']);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t$data['checked'] = 'checked';\n\t\t\t}\n\t\t}\n\n\t\tif ($checked == TRUE)\n\t\t{\n\t\t\t$defaults['checked'] = 'checked';\n\t\t}\n\t\telse\n\t\t{\n\t\t\tunset($defaults['checked']);\n\t\t}\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_radio'))\n{\n\t/**\n\t * Radio Button\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tbool\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_radio($data = '', $value = '', $checked = FALSE, $extra = '')\n\t{\n\t\tis_array($data) OR $data = array('name' => $data);\n\t\t$data['type'] = 'radio';\n\n\t\treturn form_checkbox($data, $value, $checked, $extra);\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_submit'))\n{\n\t/**\n\t * Submit Button\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_submit($data = '', $value = '', $extra = '')\n\t{\n\t\t$defaults = array(\n\t\t\t'type' => 'submit',\n\t\t\t'name' => is_array($data) ? '' : $data,\n\t\t\t'value' => $value\n\t\t);\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_reset'))\n{\n\t/**\n\t * Reset Button\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_reset($data = '', $value = '', $extra = '')\n\t{\n\t\t$defaults = array(\n\t\t\t'type' => 'reset',\n\t\t\t'name' => is_array($data) ? '' : $data,\n\t\t\t'value' => $value\n\t\t);\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_button'))\n{\n\t/**\n\t * Form Button\n\t *\n\t * @param\tmixed\n\t * @param\tstring\n\t * @param\tmixed\n\t * @return\tstring\n\t */\n\tfunction form_button($data = '', $content = '', $extra = '')\n\t{\n\t\t$defaults = array(\n\t\t\t'name' => is_array($data) ? '' : $data,\n\t\t\t'type' => 'button'\n\t\t);\n\n\t\tif (is_array($data) && isset($data['content']))\n\t\t{\n\t\t\t$content = $data['content'];\n\t\t\tunset($data['content']); // content is not an attribute\n\t\t}\n\n\t\treturn '\\n\";\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_label'))\n{\n\t/**\n\t * Form Label Tag\n\t *\n\t * @param\tstring\tThe text to appear onscreen\n\t * @param\tstring\tThe id the label applies to\n\t * @param\tmixed\tAdditional attributes\n\t * @return\tstring\n\t */\n\tfunction form_label($label_text = '', $id = '', $attributes = array())\n\t{\n\n\t\t$label = ''.$label_text.'';\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_fieldset'))\n{\n\t/**\n\t * Fieldset Tag\n\t *\n\t * Used to produce
text. To close fieldset\n\t * use form_fieldset_close()\n\t *\n\t * @param\tstring\tThe legend text\n\t * @param\tarray\tAdditional attributes\n\t * @return\tstring\n\t */\n\tfunction form_fieldset($legend_text = '', $attributes = array())\n\t{\n\t\t$fieldset = '\\n\";\n\t\tif ($legend_text !== '')\n\t\t{\n\t\t\treturn $fieldset.''.$legend_text.\"\\n\";\n\t\t}\n\n\t\treturn $fieldset;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_fieldset_close'))\n{\n\t/**\n\t * Fieldset Close Tag\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tfunction form_fieldset_close($extra = '')\n\t{\n\t\treturn '
'.$extra;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('form_close'))\n{\n\t/**\n\t * Form Close Tag\n\t *\n\t * @param\tstring\n\t * @return\tstring\n\t */\n\tfunction form_close($extra = '')\n\t{\n\t\treturn ''.$extra;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('set_value'))\n{\n\t/**\n\t * Form Value\n\t *\n\t * Grabs a value from the POST array for the specified field so you can\n\t * re-populate an input field or textarea. If Form Validation\n\t * is active it retrieves the info from the validation class\n\t *\n\t * @param\tstring\t$field\t\tField name\n\t * @param\tstring\t$default\tDefault value\n\t * @param\tbool\t$html_escape\tWhether to escape HTML special characters or not\n\t * @return\tstring\n\t */\n\tfunction set_value($field, $default = '', $html_escape = TRUE)\n\t{\n\t\t$CI =& get_instance();\n\n\t\t$value = (isset($CI->form_validation) && is_object($CI->form_validation) && $CI->form_validation->has_rule($field))\n\t\t\t? $CI->form_validation->set_value($field, $default)\n\t\t\t: $CI->input->post($field, FALSE);\n\n\t\tisset($value) OR $value = $default;\n\t\treturn ($html_escape) ? html_escape($value) : $value;\n\t}\n}\n\n// ------------------------------------------------------------------------\n\nif ( ! function_exists('set_select'))\n{\n\t/**\n\t * Set Select\n\t *\n\t * Let's you set the selected value of a \n\nEOH;\n\n\t\t$options = array(\n\t\t\t'small'\t\t=> 'Small Shirt',\n\t\t\t'med'\t\t=> 'Medium Shirt',\n\t\t\t'large'\t\t=> 'Large Shirt',\n\t\t\t'xlarge'\t=> 'Extra Large Shirt',\n\t\t);\n\n\t\t$this->assertEquals($expected, form_dropdown('shirts', $options, 'large'));\n\n\t\t$expected = <<\n\n\n\n\n\n\nEOH;\n\n\t\t$shirts_on_sale = array('small', 'large');\n\n\t\t$this->assertEquals($expected, form_dropdown('shirts', $options, $shirts_on_sale));\n\n\t\t$options = array(\n\t\t\t'Swedish Cars' => array(\n\t\t\t\t'volvo'\t=> 'Volvo',\n\t\t\t\t'saab'\t=> 'Saab'\n\t\t\t),\n\t\t\t'German Cars' => array(\n\t\t\t\t'mercedes'\t=> 'Mercedes',\n\t\t\t\t'audi'\t\t=> 'Audi'\n\t\t\t)\n\t\t);\n\n\t\t$expected = <<\n\n\n\n\n\n\n\n\n\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_dropdown('cars', $options, array('volvo', 'audi')));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_multiselect()\n\t{\n\t\t$expected = <<\n\n\n\n\n\n\nEOH;\n\n\t\t$options = array(\n\t\t\t'small'\t\t=> 'Small Shirt',\n\t\t\t'med'\t\t=> 'Medium Shirt',\n\t\t\t'large'\t\t=> 'Large Shirt',\n\t\t\t'xlarge'\t=> 'Extra Large Shirt',\n\t\t);\n\n\t\t$this->assertEquals($expected, form_multiselect('shirts[]', $options, array('med', 'large')));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_fieldset()\n\t{\n\t\t$expected = <<\nAddress Information\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_fieldset('Address Information'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_fieldset_close()\n\t{\n\t\t$expected = <<\nEOH;\n\n\t\t$this->assertEquals($expected, form_fieldset_close(''));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_checkbox()\n\t{\n\t\t$expected = <<\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_checkbox('newsletter', 'accept', TRUE));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_radio()\n\t{\n\t\t$expected = <<\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_radio('newsletter', 'accept', TRUE));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_submit()\n\t{\n\t\t$expected = <<\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_submit('mysubmit', 'Submit Post!'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_label()\n\t{\n\t\t$expected = <<What is your Name\nEOH;\n\n\t\t$this->assertEquals($expected, form_label('What is your Name', 'username'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_reset()\n\t{\n\t\t$expected = <<\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_reset('myreset', 'Reset'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_button()\n\t{\n\t\t$expected = <<content\n\nEOH;\n\n\t\t$this->assertEquals($expected, form_button('name', 'content'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_form_close()\n\t{\n\t\t$expected = <<\nEOH;\n\n\t\t$this->assertEquals($expected, form_close(''));\n\t}\n}\n" }, { "path": "tests/codeigniter/helpers/html_helper_test.php", "content": "helper('html');\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_heading()\n\t{\n\t\t$this->assertEquals('

foobar

', heading('foobar'));\n\t\t$this->assertEquals('

foobar

', heading('foobar', 2, 'class=\"bar\"'));\n\t}\n\n\tpublic function test_heading_array_attributes()\n\t{\n\t\t// Test array of attributes\n\t\t$this->assertEquals('

foobar

', heading('foobar', 2, array('class' => 'bar', 'id' => 'foo')));\n\t}\n\n\tpublic function test_heading_object_attributes()\n\t{\n\t\t// Test array of attributes\n\t\t$this->assertEquals('

foobar

', heading('foobar', 2, array('class' => 'bar', 'id' => 'foo')));\n\t\t$test = new stdClass;\n\t\t$test->class = \"bar\";\n\t\t$test->id = \"foo\";\n\t\t$this->assertEquals('

foobar

', heading('foobar', 2, $test));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_img()\n\t{\n\t\t$this->ci_set_config('base_url', 'http://localhost/');\n\t\t$this->assertEquals('\"\"', img(\"test\"));\n\t\t$this->assertEquals('\"\"', img(\"data:foo/bar,baz\"));\n\t\t$this->assertEquals('\"\"', img(\"data://foo\"));\n\t\t$this->assertEquals('\"\"', img(\"//foo.bar/baz\"));\n\t\t$this->assertEquals('\"\"', img(\"http://foo.bar/baz\"));\n\t\t$this->assertEquals('\"\"', img(\"https://foo.bar/baz\"));\n\t\t$this->assertEquals('\"\"', img(\"ftp://foo.bar/baz\"));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_Ul()\n\t{\n\t\t$expect = <<\n
  • foo
    • \n
  • bar
    • \n\n\nEOH;\n\n\t\t$expect = ltrim($expect);\n\t\t$list = array('foo', 'bar');\n\n\t\t$this->assertEquals(ltrim($expect), ul($list));\n\n\t\t$expect = <<\n
  • foo
    • \n
  • bar
    • \n\n\nEOH;\n\n\t\t$expect = ltrim($expect);\n\n\t\t$this->assertEquals($expect, ul($list, 'class=\"test\"'));\n\n\t\t$this->assertEquals($expect, ul($list, array('class' => 'test')));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_meta()\n\t{\n\t\t$this->assertEquals(\n\t\t\t\"\\n\",\n\t\t\tmeta('test', 'foo')\n\t\t);\n\n\t\t$this->assertEquals(\n\t\t\t\"\\n\",\n\t\t\tmeta(array('name' => 'foo'))\n\t\t);\n\n\t\t$this->assertEquals(\n\t\t\t\"\\n\",\n\t\t\tmeta(array('name' => 'foo', 'type' => 'charset'))\n\t\t);\n\n\t\t$this->assertEquals(\n\t\t\t\"\\n\",\n\t\t\tmeta(array('name' => 'foo', 'type' => 'charset'))\n\t\t);\n\t}\n}\n" }, { "path": "tests/codeigniter/helpers/inflector_helper_test.php", "content": "helper('inflector');\n\t}\n\n\tpublic function test_singular()\n\t{\n\t\t$strs = array(\n\t\t\t'tellies' => 'telly',\n\t\t\t'smellies' => 'smelly',\n\t\t\t'abjectnesses' => 'abjectness',\n\t\t\t'smells' => 'smell',\n\t\t\t'equipment' => 'equipment'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, singular($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_plural()\n\t{\n\t\t$strs = array(\n\t\t\t'telly' => 'tellies',\n\t\t\t'smelly' => 'smellies',\n\t\t\t'abjectness' => 'abjectnesses', // ref : https://en.wiktionary.org/wiki/abjectnesses\n\t\t\t'smell' => 'smells',\n\t\t\t'witch' => 'witches',\n\t\t\t'equipment' => 'equipment'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, plural($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_camelize()\n\t{\n\t\t$strs = array(\n\t\t\t'this is the string'\t=> 'thisIsTheString',\n\t\t\t'this is another one' => 'thisIsAnotherOne',\n\t\t\t'i-am-playing-a-trick' => 'i-am-playing-a-trick',\n\t\t\t'what_do_you_think-yo?' => 'whatDoYouThink-yo?',\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, camelize($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_underscore()\n\t{\n\t\t$strs = array(\n\t\t\t'this is the string' => 'this_is_the_string',\n\t\t\t'this is another one' => 'this_is_another_one',\n\t\t\t'i-am-playing-a-trick' => 'i-am-playing-a-trick',\n\t\t\t'what_do_you_think-yo?' => 'what_do_you_think-yo?',\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, underscore($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_humanize()\n\t{\n\t\t$strs = array(\n\t\t\t'this_is_the_string' => 'This Is The String',\n\t\t\t'this_is_another_one' => 'This Is Another One',\n\t\t\t'i-am-playing-a-trick' => 'I-am-playing-a-trick',\n\t\t\t'what_do_you_think-yo?' => 'What Do You Think-yo?',\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, humanize($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_ordinal_format()\n\t{\n\t\t$strs = array(\n\t\t\t1 => '1st',\n\t\t\t2 => '2nd',\n\t\t\t4 => '4th',\n\t\t\t11 => '11th',\n\t\t\t12 => '12th',\n\t\t\t13 => '13th',\n\t\t\t'something else' => 'something else',\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, ordinal_format($str));\n\t\t}\n\t}\n}\n" }, { "path": "tests/codeigniter/helpers/language_helper_test.php", "content": "helper('language');\n\t\t$lang = $this->getMockBuilder('CI_Lang')->setMethods(array('line'))->getMock();\n\t\t$lang->expects($this->any())->method('line')->will($this->returnValue(FALSE));\n\t\t$this->ci_instance_var('lang', $lang);\n\n\t\t$this->assertFalse(lang(1));\n\t\t$this->assertEquals('', lang(1, 'foo', array('class' => 'bar')));\n\t}\n\n}\n" }, { "path": "tests/codeigniter/helpers/number_helper_test.php", "content": "helper('number');\n\n\t\t// Grab the core lang class\n\t\t$lang_cls = $this->ci_core_class('lang');\n\n\t\t// Mock away load, too much going on in there,\n\t\t// we'll just check for the expected parameter\n\t\t$lang = $this->getMockBuilder('CI_Lang')->setMethods(array('load'))->getMock();\n\t\t$lang->expects($this->once())\n\t\t\t ->method('load')\n\t\t\t ->with($this->equalTo('number'));\n\n\t\t// Assign the proper language array\n\t\t$lang->language = $this->lang('number');\n\n\t\t// We don't have a controller, so just create\n\t\t// a cheap class to act as our super object.\n\t\t// Make sure it has a lang attribute.\n\t\t$this->ci_instance_var('lang', $lang);\n\t}\n\n\tpublic function test_byte_format()\n\t{\n\t\t$this->assertEquals('456 Bytes', byte_format(456));\n\t}\n\n\tpublic function test_kb_format()\n\t{\n\t\t$this->assertEquals('4.5 KB', byte_format(4567));\n\t}\n\n\tpublic function test_kb_format_medium()\n\t{\n\t\t$this->assertEquals('44.6 KB', byte_format(45678));\n\t}\n\n\tpublic function test_kb_format_large()\n\t{\n\t\t$this->assertEquals('446.1 KB', byte_format(456789));\n\t}\n\n\tpublic function test_mb_format()\n\t{\n\t\t$this->assertEquals('3.3 MB', byte_format(3456789));\n\t}\n\n\tpublic function test_gb_format()\n\t{\n\t\t$this->assertEquals('1.8 GB', byte_format(1932735283.2));\n\t}\n\n\tpublic function test_tb_format()\n\t{\n\t\t$this->assertEquals('112,283.3 TB', byte_format(123456789123456789));\n\t}\n\n}\n" }, { "path": "tests/codeigniter/helpers/path_helper_test.php", "content": "helper('path');\n\t}\n\n\tpublic function test_set_realpath()\n\t{\n\t\t$this->assertEquals(getcwd().DIRECTORY_SEPARATOR, set_realpath(getcwd()));\n\t}\n\n\tpublic function test_set_realpath_nonexistent_directory()\n\t{\n\t\t$expected = '/path/to/nowhere';\n\t\t$this->assertEquals($expected, set_realpath('/path/to/nowhere', FALSE));\n\t}\n\n\tpublic function test_set_realpath_error_trigger()\n\t{\n\t\t$this->setExpectedException(\n\t\t\t\t'RuntimeException', 'CI Error: Not a valid path: /path/to/nowhere'\n\t\t);\n\n\t\tset_realpath('/path/to/nowhere', TRUE);\n\t}\n\n}\n" }, { "path": "tests/codeigniter/helpers/security_helper_test.php", "content": "helper('security');\n\t\t$obj = new stdClass;\n\t\t$obj->security = new Mock_Core_Security('UTF-8');\n\t\t$this->ci_instance($obj);\n\t}\n\n\tfunction test_xss_clean()\n\t{\n\t\t$this->assertEquals('foo', xss_clean('foo'));\n\n\t\t$this->assertEquals(\"Hello, i try to [removed]alert('Hack');[removed] your site\", xss_clean(\"Hello, i try to your site\"));\n\t}\n\n\tfunction test_sanitize_filename()\n\t{\n\t\t$this->assertEquals('hello.doc', sanitize_filename('hello.doc'));\n\n\t\t$filename = './';\n\t\t$this->assertEquals('foo', sanitize_filename($filename));\n\t}\n\n\tfunction test_strip_image_tags()\n\t{\n\t\t$this->assertEquals('http://example.com/spacer.gif', strip_image_tags('http://example.com/spacer.gif'));\n\n\t\t$this->assertEquals('http://example.com/spacer.gif', strip_image_tags('\"Who'));\n\t}\n\n\tfunction test_encode_php_tags()\n\t{\n\t\t$this->assertEquals('<? echo $foo; ?>', encode_php_tags(''));\n\t}\n\n}\n" }, { "path": "tests/codeigniter/helpers/string_helper_test.php", "content": "helper('string');\n\t}\n\n\tpublic function test_strip_slashes()\n\t{\n\t\t$expected = array(\n\t\t\t\"Is your name O'reilly?\",\n\t\t\t\"No, my name is O'connor.\"\n\t\t);\n\n\t\t$str = array(\n\t\t\t\"Is your name O\\'reilly?\",\n\t\t\t\"No, my name is O\\'connor.\"\n\t\t);\n\n\t\t$this->assertEquals($expected, strip_slashes($str));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_strip_quotes()\n\t{\n\t\t$strs = array(\n\t\t\t'\"me oh my!\"'\t\t=> 'me oh my!',\n\t\t\t\"it's a winner!\"\t=> 'its a winner!',\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, strip_quotes($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_quotes_to_entities()\n\t{\n\t\t$strs = array(\n\t\t\t'\"me oh my!\"'\t\t=> '"me oh my!"',\n\t\t\t\"it's a winner!\"\t=> 'it's a winner!',\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, quotes_to_entities($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_reduce_double_slashes()\n\t{\n\t\t$strs = array(\n\t\t\t'http://codeigniter.com'\t\t=> 'http://codeigniter.com',\n\t\t\t'//var/www/html/example.com/'\t=> '/var/www/html/example.com/',\n\t\t\t'/var/www/html//index.php'\t\t=> '/var/www/html/index.php'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, reduce_double_slashes($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_reduce_multiples()\n\t{\n\t\t$strs = array(\n\t\t\t'Fred, Bill,, Joe, Jimmy'\t=> 'Fred, Bill, Joe, Jimmy',\n\t\t\t'Ringo, John, Paul,,'\t\t=> 'Ringo, John, Paul,'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, reduce_multiples($str));\n\t\t}\n\n\t\t$strs = array(\n\t\t\t'Fred, Bill,, Joe, Jimmy'\t=> 'Fred, Bill, Joe, Jimmy',\n\t\t\t'Ringo, John, Paul,,'\t\t=> 'Ringo, John, Paul'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, reduce_multiples($str, ',', TRUE));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_random_string()\n\t{\n\t\t$this->assertEquals(16, strlen(random_string('alnum', 16)));\n\t\t$this->assertEquals(32, strlen(random_string('md5', 16)));\n\t\t$this->assertEquals('string', gettype(random_string('numeric', 16)));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_increment_string()\n\t{\n\t\t$this->assertEquals('my-test_1', increment_string('my-test'));\n\t\t$this->assertEquals('my-test-1', increment_string('my-test', '-'));\n\t\t$this->assertEquals('file_5', increment_string('file_4'));\n\t\t$this->assertEquals('file-5', increment_string('file-4', '-'));\n\t\t$this->assertEquals('file-5', increment_string('file-4', '-'));\n\t\t$this->assertEquals('file-1', increment_string('file', '-', '1'));\n\t\t$this->assertEquals(124, increment_string('123', ''));\n\t}\n\n}\n" }, { "path": "tests/codeigniter/helpers/text_helper_test.php", "content": "helper('text');\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_word_limiter()\n\t{\n\t\t$long_string = 'Once upon a time, a framework had no tests. It sad. So some nice people began to write tests. The more time that went on, the happier it became. Everyone was happy.';\n\n\t\t$this->assertEquals('Once upon a time,…', word_limiter($long_string, 4));\n\t\t$this->assertEquals('Once upon a time,…', word_limiter($long_string, 4, '…'));\n\t\t$this->assertEquals('', word_limiter('', 4));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_character_limiter()\n\t{\n\t\t$long_string = 'Once upon a time, a framework had no tests. It sad. So some nice people began to write tests. The more time that went on, the happier it became. Everyone was happy.';\n\n\t\t$this->assertEquals('Once upon a time, a…', character_limiter($long_string, 20));\n\t\t$this->assertEquals('Once upon a time, a…', character_limiter($long_string, 20, '…'));\n\t\t$this->assertEquals('Short', character_limiter('Short', 20));\n\t\t$this->assertEquals('Short', character_limiter('Short', 5));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_ascii_to_entities()\n\t{\n\t\t$strs = array(\n\t\t\t'“‘ “test”'\t\t\t=> '“‘ “test”',\n\t\t\t'†¥¨ˆøåß∂ƒ©˙∆˚¬'\t=> '†¥¨ˆøåß∂ƒ©˙∆˚¬'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, ascii_to_entities($str));\n\t\t}\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_entities_to_ascii()\n\t{\n\t\t$strs = array(\n\t\t\t'“‘ “test”' => '“‘ “test”',\n\t\t\t'†¥¨ˆøåß∂ƒ©˙∆˚¬' => '†¥¨ˆøåß∂ƒ©˙∆˚¬'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, entities_to_ascii($str));\n\t\t}\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_convert_accented_characters()\n\t{\n\t\tif (substr(PHP_VERSION, 0, 3) === '7.4')\n\t\t{\n\t\t\treturn $this->markTestSkipped('For some reason all PHP 7.4 instances on GitHub Actions trigger a parse error when foreign_chars.php is loaded');\n\t\t}\n\n\t\t$this->ci_vfs_clone('application/config/foreign_chars.php');\n\t\t$this->assertEquals('AAAeEEEIIOOEUUUeY', convert_accented_characters('ÀÂÄÈÊËÎÏÔŒÙÛÜŸ'));\n\t\t$this->assertEquals('a e i o u n ue', convert_accented_characters('á é í ó ú ñ ü'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_censored_words()\n\t{\n\t\t$censored = array('boob', 'nerd', 'ass', 'fart');\n\n\t\t$strs = array(\n\t\t\t'Ted bobbled the ball' \t\t\t=> 'Ted bobbled the ball',\n\t\t\t'Jake is a nerdo'\t\t\t\t=> 'Jake is a nerdo',\n\t\t\t'The borg will assimilate you'\t=> 'The borg will assimilate you',\n\t\t\t'Did Mary Fart?'\t\t\t\t=> 'Did Mary $*#?',\n\t\t\t'Jake is really a boob'\t\t\t=> 'Jake is really a $*#'\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, word_censor($str, $censored, '$*#'));\n\t\t}\n\n\t\t// test censored words being sent as a string\n\t\t$this->assertEquals('test', word_censor('test', 'test'));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_highlight_code()\n\t{\n\t\t$expect = \"\\n<?php var_dump(\\$this); ?> \\n\\n\";\n\n\t\t$this->assertEquals($expect, highlight_code(''));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\t/**\n\t * @runInSeparateProcess\n\t */\n\tpublic function test_highlight_phrase()\n\t{\n\t\tdefine('UTF8_ENABLED', FALSE);\n\n\t\t$strs = array(\n\t\t\t'this is a phrase' => 'this is a phrase',\n\t\t\t'this is another' => 'this is another',\n\t\t\t'Gimme a test, Sally' => 'Gimme a test, Sally',\n\t\t\t'Or tell me what this is' => 'Or tell me what this is',\n\t\t\t'' => ''\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, highlight_phrase($str, 'this is'));\n\t\t}\n\n\t\t$this->assertEquals('this is a strong test', highlight_phrase('this is a strong test', 'this is', '', ''));\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_ellipsize()\n\t{\n\t\t$strs = array(\n\t\t\t'0'\t\t=> array(\n\t\t\t\t'this is my string'\t\t\t\t=> '… my string',\n\t\t\t\t\"here's another one\"\t\t\t=> '…nother one',\n\t\t\t\t'this one is just a bit longer'\t=> '…bit longer',\n\t\t\t\t'short'\t\t\t\t\t\t\t=> 'short'\n\t\t\t),\n\t\t\t'.5'\t=> array(\n\t\t\t\t'this is my string'\t\t\t\t=> 'this …tring',\n\t\t\t\t\"here's another one\"\t\t\t=> \"here'…r one\",\n\t\t\t\t'this one is just a bit longer'\t=> 'this …onger',\n\t\t\t\t'short'\t\t\t\t\t\t\t=> 'short'\n\t\t\t),\n\t\t\t'1'\t=> array(\n\t\t\t\t'this is my string'\t\t\t\t=> 'this is my…',\n\t\t\t\t\"here's another one\"\t\t\t=> \"here's ano…\",\n\t\t\t\t'this one is just a bit longer'\t=> 'this one i…',\n\t\t\t\t'short'\t\t\t\t\t\t\t=> 'short'\n\t\t\t),\n\t\t);\n\n\t\tforeach ($strs as $pos => $s)\n\t\t{\n\t\t\tforeach ($s as $str => $expect)\n\t\t\t{\n\t\t\t\t$this->assertEquals($expect, ellipsize($str, 10, $pos));\n\t\t\t}\n\t\t}\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_word_wrap()\n\t{\n\t\t$string = 'Here is a simple string of text that will help us demonstrate this function.';\n\t\t$this->assertEquals(substr_count(word_wrap($string, 25), \"\\n\"), 4);\n\t}\n\n\t// ------------------------------------------------------------------------\n\n\tpublic function test_default_word_wrap_charlim()\n\t{\n\t\t$string = \"Here is a longer string of text that will help us demonstrate the default charlim of this function.\";\n\t\t$this->assertEquals(strpos(word_wrap($string), \"\\n\"), 73);\n\t}\n\n}\n" }, { "path": "tests/codeigniter/helpers/url_helper_test.php", "content": "helper('url');\n\t}\n\n\t/**\n\t * @runInSeparateProcess\n\t */\n\tpublic function test_url_title()\n\t{\n\t\tdefine('UTF8_ENABLED', FALSE);\n\n\t\t$words = array(\n\t\t\t'foo bar /' \t=> 'foo-bar',\n\t\t\t'\\ testing 12' => 'testing-12'\n\t\t);\n\n\t\tforeach ($words as $in => $out)\n\t\t{\n\t\t\t$this->assertEquals($out, url_title($in, '-', TRUE));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * @runInSeparateProcess\n\t */\n\tpublic function test_url_title_extra_dashes()\n\t{\n\t\tdefine('UTF8_ENABLED', FALSE);\n\n\t\t$words = array(\n\t\t\t'_foo bar_' \t=> 'foo_bar',\n\t\t\t'_What\\'s wrong with CSS?_' => 'Whats_wrong_with_CSS'\n\t\t);\n\n\t\tforeach ($words as $in => $out)\n\t\t{\n\t\t\t$this->assertEquals($out, url_title($in, '_'));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_prep_url()\n\t{\n\t\t$this->assertEquals('http://codeigniter.com', prep_url('codeigniter.com'));\n\t\t$this->assertEquals('http://www.codeigniter.com', prep_url('www.codeigniter.com'));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_auto_link_url()\n\t{\n\t\t$strings = array(\n\t\t\t'www.codeigniter.com test' => '
    www.codeigniter.com test',\n\t\t\t'This is my noreply@codeigniter.com test' => 'This is my noreply@codeigniter.com test',\n\t\t\t'
    www.google.com' => '
    www.google.com',\n\t\t\t'Download CodeIgniter at www.codeigniter.com. Period test.' => 'Download CodeIgniter at www.codeigniter.com. Period test.',\n\t\t\t'Download CodeIgniter at www.codeigniter.com, comma test' => 'Download CodeIgniter at www.codeigniter.com, comma test',\n\t\t\t'This one: ://codeigniter.com must not break this one: http://codeigniter.com' => 'This one: ://codeigniter.com must not break this one: http://codeigniter.com',\n\t\t\t'Trailing slash: https://codeigniter.com/ fubar' => 'Trailing slash: https://codeigniter.com/ fubar'\n\t\t);\n\n\t\tforeach ($strings as $in => $out)\n\t\t{\n\t\t\t$this->assertEquals($out, auto_link($in, 'url'));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_pull_675()\n\t{\n\t\t$strings = array(\n\t\t\t'
    www.google.com' => '
    www.google.com',\n\t\t);\n\n\t\tforeach ($strings as $in => $out)\n\t\t{\n\t\t\t$this->assertEquals($out, auto_link($in, 'url'));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_issue_5331()\n\t{\n\t\t$this->assertEquals(\n\t\t\t'this is some text that includes '.safe_mailto('www.email@domain.com').' which is causing an issue',\n\t\t\tauto_link('this is some text that includes www.email@domain.com which is causing an issue')\n\t\t);\n\t}\n}\n" }, { "path": "tests/codeigniter/helpers/xml_helper_test.php", "content": "helper('xml');\n\t}\n\n\tpublic function test_xml_convert()\n\t{\n\t\t$this->assertEquals('<tag>my & test - </tag>', xml_convert('my & test - '));\n\t}\n\n}" }, { "path": "tests/codeigniter/libraries/Calendar_test.php", "content": "ci_instance_var('load', $this->getMockBuilder('CI_Loader')->setMethods(array('helper'))->getMock());\n\n\t\t$lang = $this->getMockBuilder('CI_Lang')->setMethods(array('load', 'line'))->getMock();\n\t\t$lang->expects($this->any())->method('line')->will($this->returnValue(FALSE));\n\t\t$this->ci_instance_var('lang', $lang);\n\n\t\t$this->calendar = new CI_Calendar();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_initialize()\n\t{\n\t\t$this->calendar->initialize(array(\n\t\t\t'month_type'\t=>\t'short',\n\t\t\t'start_day'\t=>\t'monday'\n\t\t));\n\t\t$this->assertEquals('short', $this->calendar->month_type);\n\t\t$this->assertEquals('monday', $this->calendar->start_day);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_generate()\n\t{\n\t\t$no_events = '\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    September 2011
    SuMoTuWeThFrSa
        123
    45678910
    11121314151617
    18192021222324
    252627282930 
    ';\n\n\t\t$this->assertEquals($no_events, $this->calendar->generate(2011, 9));\n\n\t\t$data = array(\n\t\t\t3 => 'http://example.com/news/article/2006/03/',\n\t\t\t7 => 'http://example.com/news/article/2006/07/',\n\t\t\t13 => 'http://example.com/news/article/2006/13/',\n\t\t\t26 => 'http://example.com/news/article/2006/26/'\n\t\t);\n\n\t\t$events = '\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    September 2011
    SuMoTuWeThFrSa
        123
    45678910
    11121314151617
    18192021222324
    252627282930 
    ';\n\n\t\t$this->assertEquals($events, $this->calendar->generate(2011, 9, $data));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_get_month_name()\n\t{\n\t\t$this->calendar->month_type = NULL;\n\t\t$this->assertEquals('January', $this->calendar->get_month_name('01'));\n\n\t\t$this->calendar->month_type = 'short';\n\t\t$this->assertEquals('Jan', $this->calendar->get_month_name('01'));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_get_day_names()\n\t{\n\t\t$this->assertEquals(array(\n\t\t\t'Sunday',\n\t\t\t'Monday',\n\t\t\t'Tuesday',\n\t\t\t'Wednesday',\n\t\t\t'Thursday',\n\t\t\t'Friday',\n\t\t\t'Saturday'\n\t\t), $this->calendar->get_day_names('long'));\n\n\t\t$this->assertEquals(array(\n\t\t\t'Sun',\n\t\t\t'Mon',\n\t\t\t'Tue',\n\t\t\t'Wed',\n\t\t\t'Thu',\n\t\t\t'Fri',\n\t\t\t'Sat'\n\t\t), $this->calendar->get_day_names('short'));\n\n\t\t$this->calendar->day_type = NULL;\n\n\t\t$this->assertEquals(array(\n\t\t\t'Su',\n\t\t\t'Mo',\n\t\t\t'Tu',\n\t\t\t'We',\n\t\t\t'Th',\n\t\t\t'Fr',\n\t\t\t'Sa'\n\t\t), $this->calendar->get_day_names());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_adjust_date()\n\t{\n\t\t$this->assertEquals(array('month' => 8, 'year' => 2012), $this->calendar->adjust_date(8, 2012));\n\t\t$this->assertEquals(array('month' => 1, 'year' => 2013), $this->calendar->adjust_date(13, 2012));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_get_total_days()\n\t{\n\t\t$this->assertEquals(0, $this->calendar->get_total_days(13, 2012));\n\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(1, 2012));\n\t\t$this->assertEquals(28, $this->calendar->get_total_days(2, 2011));\n\t\t$this->assertEquals(29, $this->calendar->get_total_days(2, 2012));\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(3, 2012));\n\t\t$this->assertEquals(30, $this->calendar->get_total_days(4, 2012));\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(5, 2012));\n\t\t$this->assertEquals(30, $this->calendar->get_total_days(6, 2012));\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(7, 2012));\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(8, 2012));\n\t\t$this->assertEquals(30, $this->calendar->get_total_days(9, 2012));\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(10, 2012));\n\t\t$this->assertEquals(30, $this->calendar->get_total_days(11, 2012));\n\t\t$this->assertEquals(31, $this->calendar->get_total_days(12, 2012));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_default_template()\n\t{\n\t\t$array = array(\n\t\t\t'table_open'\t\t\t=> '',\n\t\t\t'heading_row_start'\t\t=> '',\n\t\t\t'heading_previous_cell'\t\t=> '',\n\t\t\t'heading_title_cell'\t\t=> '',\n\t\t\t'heading_next_cell'\t\t=> '',\n\t\t\t'heading_row_end'\t\t=> '',\n\t\t\t'week_row_start'\t\t=> '',\n\t\t\t'week_day_cell'\t\t\t=> '',\n\t\t\t'week_row_end'\t\t\t=> '',\n\t\t\t'cal_row_start'\t\t\t=> '',\n\t\t\t'cal_cell_start'\t\t=> '',\n\t\t\t'cal_cell_end_today'\t\t=> '',\n\t\t\t'cal_row_end'\t\t\t=> '',\n\t\t\t'table_close'\t\t\t=> '
    <<{heading}>>
    {week_day}
    ',\n\t\t\t'cal_cell_start_today'\t\t=> '',\n\t\t\t'cal_cell_content'\t\t=> '{day}',\n\t\t\t'cal_cell_content_today'\t=> '{day}',\n\t\t\t'cal_cell_no_content'\t\t=> '{day}',\n\t\t\t'cal_cell_no_content_today'\t=> '{day}',\n\t\t\t'cal_cell_blank'\t\t=> ' ',\n\t\t\t'cal_cell_end'\t\t\t=> '
    ',\n\t\t\t'cal_cell_start_other'\t\t=> '',\n\t\t\t'cal_cell_other'\t\t=> '{day}',\n\t\t\t'cal_cell_end_other'\t\t=> ''\n\t\t);\n\n\t\t$this->assertEquals($array, $this->calendar->default_template());\n\t}\n\n}\n" }, { "path": "tests/codeigniter/libraries/Driver_test.php", "content": "subclass = 'Mock_Libraries_';\n\t\t$this->ci_set_config('subclass_prefix', $this->subclass);\n\n\t\t// Mock Loader->get_package_paths\n\t\t$paths = 'get_package_paths';\n\t\t$ldr = $this->getMockBuilder('CI_Loader')->setMethods(array($paths))->getMock();\n\t\t$ldr->expects($this->any())->method($paths)->will($this->returnValue(array(APPPATH, BASEPATH)));\n\t\t$this->ci_instance_var('load', $ldr);\n\n\t\t// Create mock driver library\n\t\t$this->name = 'Driver';\n\t\t$this->lib = new Mock_Libraries_Driver();\n\t}\n\n\t/**\n\t * Test driver child loading\n\t */\n\tpublic function test_load_driver()\n\t{\n\t\t// Create driver file\n\t\t$driver = 'basic';\n\t\t$file = $this->name.'_'.$driver;\n\t\t$class = 'CI_'.$file;\n\t\t$prop = 'called';\n\t\t$content = ''.$prop.' = TRUE; } }';\n\t\t$this->ci_vfs_create($file, $content, $this->ci_base_root, array('libraries', $this->name, 'drivers'));\n\n\t\t// Make driver valid\n\t\t$this->lib->driver_list($driver);\n\n\t\t// Load driver\n\t\t$this->assertNotNull($this->lib->load_driver($driver));\n\n\t\t// Did lib name get set?\n\t\t$this->assertEquals($this->name, $this->lib->get_name());\n\n\t\t// Was driver loaded?\n\t\t$this->assertObjectHasAttribute($driver, $this->lib);\n\t\t$this->assertInstanceOf($class, $this->lib->$driver);\n\t\t$this->assertInstanceOf('CI_Driver', $this->lib->$driver);\n\n\t\t// Was decorate called?\n\t\t$this->assertObjectHasAttribute($prop, $this->lib->$driver);\n\t\t$this->assertTrue($this->lib->$driver->$prop);\n\n\t\t// Do we get an error for an invalid driver?\n\t\t$driver = 'unlisted';\n\t\t$this->setExpectedException('RuntimeException', 'CI Error: Invalid driver requested: '.$this->name.'_'.$driver);\n\t\t$this->lib->load_driver($driver);\n\t}\n\n\t/**\n\t * Test loading lowercase from app path\n\t */\n\tpublic function test_load_app_driver()\n\t{\n\t\t// Create driver file\n\t\t$driver = 'lowpack';\n\t\t$file = $this->name.'_'.$driver;\n\t\t$class = 'CI_'.$file;\n\t\t$content = 'ci_vfs_create($file, $content, $this->ci_app_root,\n\t\t\tarray('libraries', $this->name, 'drivers'));\n\n\t\t// Make valid list\n\t\t$nodriver = 'absent';\n\t\t$this->lib->driver_list(array($driver, $nodriver));\n\n\t\t// Load driver\n\t\t$this->assertNotNull($this->lib->load_driver($driver));\n\n\t\t// Was driver loaded?\n\t\t$this->assertObjectHasAttribute($driver, $this->lib);\n\t\t$this->assertInstanceOf($class, $this->lib->$driver);\n\t\t$this->assertInstanceOf('CI_Driver', $this->lib->$driver);\n\n\t\t// Do we get an error for a non-existent driver?\n\t\t$this->setExpectedException('RuntimeException', 'CI Error: Unable to load the requested driver: CI_'.\n\t\t\t$this->name.'_'.$nodriver);\n\t\t$this->lib->load_driver($nodriver);\n\t}\n\n\t/**\n\t * Test loading driver extension\n\t */\n\tpublic function test_load_driver_ext()\n\t{\n\t\t// Create base file\n\t\t$driver = 'extend';\n\t\t$base = $this->name.'_'.$driver;\n\t\t$baseclass = 'CI_'.$base;\n\t\t$content = 'ci_vfs_create($base, $content, $this->ci_base_root, array('libraries', $this->name, 'drivers'));\n\n\t\t// Create driver file\n\t\t$class = $this->subclass.$base;\n\t\t$content = 'ci_vfs_create($class, $content, $this->ci_app_root, array('libraries', $this->name, 'drivers'));\n\n\t\t// Make valid list\n\t\t$this->lib->driver_list($driver);\n\n\t\t// Load driver\n\t\t$this->assertNotNull($this->lib->load_driver($driver));\n\n\t\t// Was driver loaded?\n\t\t$this->assertObjectHasAttribute($driver, $this->lib);\n\t\t$this->assertInstanceOf($class, $this->lib->$driver);\n\t\t$this->assertInstanceOf($baseclass, $this->lib->$driver);\n\t\t$this->assertInstanceOf('CI_Driver', $this->lib->$driver);\n\n\t\t// Create driver extension without base\n\t\t$driver = 'baseless';\n\t\t$base = $this->name.'_'.$driver;\n\t\t$class = $this->subclass.$base;\n\t\t$content = 'ci_vfs_create($class, $content, $this->ci_app_root, array('libraries', $this->name, 'drivers'));\n\t\t$this->lib->driver_list($driver);\n\n\t\t// Do we get an error when base class isn't found?\n\t\t$this->setExpectedException('RuntimeException', 'CI Error: Unable to load the requested class: CI_'.$base);\n\t\t$this->lib->load_driver($driver);\n\t}\n\n\t/**\n\t * Test decorating driver with parent attributes\n\t */\n\tpublic function test_decorate()\n\t{\n\t\t// Create parent with a method and property to access\n\t\t$pclass = 'Test_Parent';\n\t\t$prop = 'parent_prop';\n\t\t$value = 'initial';\n\t\t$method = 'parent_func';\n\t\t$return = 'func return';\n\t\t$code = 'class '.$pclass.' { public $'.$prop.' = \\''.$value.'\\'; '.\n\t\t\t'public function '.$method.'() { return \\''.$return.'\\'; } }';\n\t\teval($code);\n\t\t$parent = new $pclass();\n\n\t\t// Create child driver to decorate\n\t\t$class = 'Test_Driver';\n\t\teval('class '.$class.' extends CI_Driver { }');\n\t\t$child = new $class();\n\n\t\t// Decorate child\n\t\t$child->decorate($parent);\n\n\t\t// Do we get the initial parent property value?\n\t\t$this->assertEquals($value, $child->$prop);\n\n\t\t// Can we change the parent property?\n\t\t$newval = 'changed';\n\t\t$child->$prop = $newval;\n\t\t$this->assertEquals($newval, $parent->$prop);\n\n\t\t// Do we get back the updated value?\n\t\t$this->assertEquals($newval, $child->$prop);\n\n\t\t// Can we call the parent method?\n\t\t$this->assertEquals($return, $child->$method());\n\t}\n\n}\n" }, { "path": "tests/codeigniter/libraries/Encryption_test.php", "content": "encryption = new Mock_Libraries_Encryption();\n\n\t\tif (version_compare(PHP_VERSION, '7.1', '<'))\n\t\t{\n\t\t\t$this->markTestSkipped('Ubuntu-latest OpenSSL is not working correct in some older PHP versions.');\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * __construct test\n\t *\n\t * Covers behavior with $config['encryption_key'] set or not\n\t */\n\tpublic function test___construct()\n\t{\n\t\t// Assume no configuration from set_up()\n\t\t$this->assertNull($this->encryption->get_key());\n\n\t\t// Try with an empty value\n\t\t$this->ci_set_config('encryption_key');\n\t\t$this->encrypt = new Mock_Libraries_Encryption();\n\t\t$this->assertNull($this->encrypt->get_key());\n\n\t\t$this->ci_set_config('encryption_key', str_repeat(\"\\x0\", 16));\n\t\t$this->encrypt = new Mock_Libraries_Encryption();\n\t\t$this->assertEquals(str_repeat(\"\\x0\", 16), $this->encrypt->get_key());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * hkdf() test\n\t *\n\t * Applies test vectors described in Appendix A(1-3) RFC5869.\n\t * Described vectors 4-7 SHA-1, which we don't support and are\n\t * therefore excluded.\n\t *\n\t * Because our implementation is a single method instead of being\n\t * split into hkdf_extract() and hkdf_expand(), we cannot test for\n\t * the PRK value. As long as the OKM is correct though, it's fine.\n\t *\n\t * @link\thttps://tools.ietf.org/rfc/rfc5869.txt\n\t */\n\tpublic function test_hkdf()\n\t{\n\t\t$vectors = array(\n\t\t\t// A.1: Basic test case with SHA-256\n\t\t\tarray(\n\t\t\t\t'digest' => 'sha256',\n\t\t\t\t'ikm' => \"\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\",\n\t\t\t\t'salt' => \"\\x00\\x01\\x02\\x03\\x04\\x05\\x06\\x07\\x08\\x09\\x0a\\x0b\\x0c\",\n\t\t\t\t'length' => 42,\n\t\t\t\t'info' => \"\\xf0\\xf1\\xf2\\xf3\\xf4\\xf5\\xf6\\xf7\\xf8\\xf9\",\n\t\t\t//\t'prk' => \"\\x07\\x77\\x09\\x36\\x2c\\x2e\\x32\\xdf\\x0d\\xdc\\x3f\\x0d\\xc4\\x7b\\xba\\x63\\x90\\xb6\\xc7\\x3b\\xb5\\x0f\\x9c\\x31\\x22\\xec\\x84\\x4a\\xd7\\xc2\\xb3\\xe5\",\n\t\t\t\t'okm' => \"\\x3c\\xb2\\x5f\\x25\\xfa\\xac\\xd5\\x7a\\x90\\x43\\x4f\\x64\\xd0\\x36\\x2f\\x2a\\x2d\\x2d\\x0a\\x90\\xcf\\x1a\\x5a\\x4c\\x5d\\xb0\\x2d\\x56\\xec\\xc4\\xc5\\xbf\\x34\\x00\\x72\\x08\\xd5\\xb8\\x87\\x18\\x58\\x65\"\n\t\t\t),\n\t\t\t// A.2: Test with SHA-256 and longer inputs/outputs\n\t\t\tarray(\n\t\t\t\t'digest' => 'sha256',\n\t\t\t\t'ikm' => \"\\x00\\x01\\x02\\x03\\x04\\x05\\x06\\x07\\x08\\x09\\x0a\\x0b\\x0c\\x0d\\x0e\\x0f\\x10\\x11\\x12\\x13\\x14\\x15\\x16\\x17\\x18\\x19\\x1a\\x1b\\x1c\\x1d\\x1e\\x1f\\x20\\x21\\x22\\x23\\x24\\x25\\x26\\x27\\x28\\x29\\x2a\\x2b\\x2c\\x2d\\x2e\\x2f\\x30\\x31\\x32\\x33\\x34\\x35\\x36\\x37\\x38\\x39\\x3a\\x3b\\x3c\\x3d\\x3e\\x3f\\x40\\x41\\x42\\x43\\x44\\x45\\x46\\x47\\x48\\x49\\x4a\\x4b\\x4c\\x4d\\x4e\\x4f\",\n\t\t\t\t'salt' => \"\\x60\\x61\\x62\\x63\\x64\\x65\\x66\\x67\\x68\\x69\\x6a\\x6b\\x6c\\x6d\\x6e\\x6f\\x70\\x71\\x72\\x73\\x74\\x75\\x76\\x77\\x78\\x79\\x7a\\x7b\\x7c\\x7d\\x7e\\x7f\\x80\\x81\\x82\\x83\\x84\\x85\\x86\\x87\\x88\\x89\\x8a\\x8b\\x8c\\x8d\\x8e\\x8f\\x90\\x91\\x92\\x93\\x94\\x95\\x96\\x97\\x98\\x99\\x9a\\x9b\\x9c\\x9d\\x9e\\x9f\\xa0\\xa1\\xa2\\xa3\\xa4\\xa5\\xa6\\xa7\\xa8\\xa9\\xaa\\xab\\xac\\xad\\xae\\xaf\",\n\t\t\t\t'length' => 82,\n\t\t\t\t'info' => \"\\xb0\\xb1\\xb2\\xb3\\xb4\\xb5\\xb6\\xb7\\xb8\\xb9\\xba\\xbb\\xbc\\xbd\\xbe\\xbf\\xc0\\xc1\\xc2\\xc3\\xc4\\xc5\\xc6\\xc7\\xc8\\xc9\\xca\\xcb\\xcc\\xcd\\xce\\xcf\\xd0\\xd1\\xd2\\xd3\\xd4\\xd5\\xd6\\xd7\\xd8\\xd9\\xda\\xdb\\xdc\\xdd\\xde\\xdf\\xe0\\xe1\\xe2\\xe3\\xe4\\xe5\\xe6\\xe7\\xe8\\xe9\\xea\\xeb\\xec\\xed\\xee\\xef\\xf0\\xf1\\xf2\\xf3\\xf4\\xf5\\xf6\\xf7\\xf8\\xf9\\xfa\\xfb\\xfc\\xfd\\xfe\\xff\",\n\t\t\t//\t'prk' => \"\\x06\\xa6\\xb8\\x8c\\x58\\x53\\x36\\x1a\\x06\\x10\\x4c\\x9c\\xeb\\x35\\xb4\\x5c\\xef\\x76\\x00\\x14\\x90\\x46\\x71\\x01\\x4a\\x19\\x3f\\x40\\xc1\\x5f\\xc2\\x44\",\n\t\t\t\t'okm' => \"\\xb1\\x1e\\x39\\x8d\\xc8\\x03\\x27\\xa1\\xc8\\xe7\\xf7\\x8c\\x59\\x6a\\x49\\x34\\x4f\\x01\\x2e\\xda\\x2d\\x4e\\xfa\\xd8\\xa0\\x50\\xcc\\x4c\\x19\\xaf\\xa9\\x7c\\x59\\x04\\x5a\\x99\\xca\\xc7\\x82\\x72\\x71\\xcb\\x41\\xc6\\x5e\\x59\\x0e\\x09\\xda\\x32\\x75\\x60\\x0c\\x2f\\x09\\xb8\\x36\\x77\\x93\\xa9\\xac\\xa3\\xdb\\x71\\xcc\\x30\\xc5\\x81\\x79\\xec\\x3e\\x87\\xc1\\x4c\\x01\\xd5\\xc1\\xf3\\x43\\x4f\\x1d\\x87\",\n\t\t\t),\n\t\t\t// A.3: Test with SHA-256 and zero-length salt/info\n\t\t\tarray(\n\t\t\t\t'digest' => 'sha256',\n\t\t\t\t'ikm' => \"\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\\x0b\",\n\t\t\t\t'salt' => '',\n\t\t\t\t'length' => 42,\n\t\t\t\t'info' => '',\n\t\t\t//\t'prk' => \"\\x19\\xef\\x24\\xa3\\x2c\\x71\\x7b\\x16\\x7f\\x33\\xa9\\x1d\\x6f\\x64\\x8b\\xdf\\x96\\x59\\x67\\x76\\xaf\\xdb\\x63\\x77\\xac\\x43\\x4c\\x1c\\x29\\x3c\\xcb\\x04\",\n\t\t\t\t'okm' => \"\\x8d\\xa4\\xe7\\x75\\xa5\\x63\\xc1\\x8f\\x71\\x5f\\x80\\x2a\\x06\\x3c\\x5a\\x31\\xb8\\xa1\\x1f\\x5c\\x5e\\xe1\\x87\\x9e\\xc3\\x45\\x4e\\x5f\\x3c\\x73\\x8d\\x2d\\x9d\\x20\\x13\\x95\\xfa\\xa4\\xb6\\x1a\\x96\\xc8\",\n\t\t\t)\n\t\t);\n\n\t\tforeach ($vectors as $test)\n\t\t{\n\t\t\t$this->assertEquals(\n\t\t\t\t$test['okm'],\n\t\t\t\t$this->encryption->hkdf(\n\t\t\t\t\t$test['ikm'],\n\t\t\t\t\t$test['digest'],\n\t\t\t\t\t$test['salt'],\n\t\t\t\t\t$test['length'],\n\t\t\t\t\t$test['info']\n\t\t\t\t)\n\t\t\t);\n\t\t}\n\n\t\t// Test default length, it must match the digest size\n\t\t$hkdf_result = $this->encryption->hkdf('foobar', 'sha512');\n\t\t$this->assertEquals(\n\t\t\t64,\n\t\t\tdefined('MB_OVERLOAD_STRING')\n\t\t\t\t? mb_strlen($hkdf_result, '8bit')\n\t\t\t\t: strlen($hkdf_result)\n\t\t);\n\n\t\t// Test maximum length (RFC5869 says that it must be up to 255 times the digest size)\n\t\t$hkdf_result = $this->encryption->hkdf('foobar', 'sha384', NULL, 48 * 255);\n\t\t$this->assertEquals(\n\t\t\t12240,\n\t\t\tdefined('MB_OVERLOAD_STRING')\n\t\t\t\t? mb_strlen($hkdf_result, '8bit')\n\t\t\t\t: strlen($hkdf_result)\n\t\t);\n\t\t$this->assertFalse($this->encryption->hkdf('foobar', 'sha224', NULL, 28 * 255 + 1));\n\n\t\t// CI-specific test for an invalid digest\n\t\t$this->assertFalse($this->encryption->hkdf('fobar', 'sha1'));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * _get_params() test\n\t */\n\tpublic function test__get_params()\n\t{\n\t\t$key = str_repeat(\"\\x0\", 16);\n\n\t\t// Invalid custom parameters\n\t\t$params = array(\n\t\t\t// No cipher, mode or key\n\t\t\tarray('cipher' => 'aes-128', 'mode' => 'cbc'),\n\t\t\tarray('cipher' => 'aes-128', 'key' => $key),\n\t\t\tarray('mode' => 'cbc', 'key' => $key),\n\t\t\t// No HMAC key or not a valid digest\n\t\t\tarray('cipher' => 'aes-128', 'mode' => 'cbc', 'key' => $key),\n\t\t\tarray('cipher' => 'aes-128', 'mode' => 'cbc', 'key' => $key, 'hmac_digest' => 'sha1', 'hmac_key' => $key),\n\t\t\t// Invalid mode\n\t\t\tarray('cipher' => 'aes-128', 'mode' => 'foo', 'key' => $key, 'hmac_digest' => 'sha256', 'hmac_key' => $key)\n\t\t);\n\n\t\tfor ($i = 0, $c = count($params); $i < $c; $i++)\n\t\t{\n\t\t\t$this->assertFalse($this->encryption->__get_params($params[$i]));\n\t\t}\n\n\t\t// Valid parameters\n\t\t$params = array(\n\t\t\t'cipher' => 'aes-128',\n\t\t\t'mode' => 'cbc',\n\t\t\t'key' => str_repeat(\"\\x0\", 16),\n\t\t\t'hmac_key' => str_repeat(\"\\x0\", 16)\n\t\t);\n\n\t\t$this->assertEquals('array', gettype($this->encryption->__get_params($params)));\n\n\t\t$params['base64'] = TRUE;\n\t\t$params['hmac_digest'] = 'sha512';\n\n\t\t// Including all parameters\n\t\t$params = array(\n\t\t\t'cipher' => 'aes-128',\n\t\t\t'mode' => 'cbc',\n\t\t\t'key' => str_repeat(\"\\x0\", 16),\n\t\t\t'raw_data' => TRUE,\n\t\t\t'hmac_key' => str_repeat(\"\\x0\", 16),\n\t\t\t'hmac_digest' => 'sha256'\n\t\t);\n\n\t\t$output = $this->encryption->__get_params($params);\n\t\tunset($output['handle'], $output['cipher'], $params['raw_data'], $params['cipher']);\n\t\t$params['base64'] = FALSE;\n\t\t$this->assertEquals($params, $output);\n\n\t\t// HMAC disabled\n\t\tunset($params['hmac_key'], $params['hmac_digest']);\n\t\t$params['hmac'] = $params['raw_data'] = FALSE;\n\t\t$params['cipher'] = 'aes-128';\n\t\t$output = $this->encryption->__get_params($params);\n\t\tunset($output['handle'], $output['cipher'], $params['hmac'], $params['raw_data'], $params['cipher']);\n\t\t$params['base64'] = TRUE;\n\t\t$params['hmac_digest'] = $params['hmac_key'] = NULL;\n\t\t$this->assertEquals($params, $output);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * initialize(), encrypt(), decrypt() test\n\t *\n\t * Testing the three methods separately is not realistic as they are\n\t * designed to work together. A more thorough test for initialize()\n\t * though is the OpenSSL/MCrypt compatibility test.\n\t *\n\t * @depends\ttest_hkdf\n\t * @depends\ttest__get_params\n\t */\n\tpublic function test_initialize_encrypt_decrypt()\n\t{\n\t\t$message = 'This is a plain-text message.';\n\t\t$key = \"\\xd0\\xc9\\x08\\xc4\\xde\\x52\\x12\\x6e\\xf8\\xcc\\xdb\\x03\\xea\\xa0\\x3a\\x5c\";\n\n\t\t// Default state (AES-128/Rijndael-128 in CBC mode)\n\t\t$this->encryption->initialize(array('key' => $key));\n\n\t\t// Was the key properly set?\n\t\t$this->assertEquals($key, $this->encryption->get_key());\n\n\t\t$this->assertEquals($message, $this->encryption->decrypt($this->encryption->encrypt($message)));\n\n\t\t// Try DES3 in OFB mode, just for the sake of changing stuff\n\t\t$this->encryption->initialize(array('cipher' => 'tripledes', 'mode' => 'ofb', 'key' => substr($key, 0, 8)));\n\t\t$this->assertEquals($message, $this->encryption->decrypt($this->encryption->encrypt($message)));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * encrypt(), decrypt test with custom parameters\n\t *\n\t * @depends\ttest__get_params\n\t */\n\tpublic function test_encrypt_decrypt_custom()\n\t{\n\t\t$message = 'Another plain-text message.';\n\n\t\t// A random invalid parameter\n\t\t$this->assertFalse($this->encryption->encrypt($message, array('foo')));\n\t\t$this->assertFalse($this->encryption->decrypt($message, array('foo')));\n\n\t\t// No HMAC, binary output\n\t\t$params = array(\n\t\t\t'cipher' => 'tripledes',\n\t\t\t'mode' => 'cfb',\n\t\t\t'key' => str_repeat(\"\\x1\", 16),\n\t\t\t'base64' => FALSE,\n\t\t\t'hmac' => FALSE\n\t\t);\n\n\t\t$ciphertext = $this->encryption->encrypt($message, $params);\n\n\t\t$this->assertEquals($message, $this->encryption->decrypt($ciphertext, $params));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * _mcrypt_get_handle() test\n\t */\n\tpublic function test__mcrypt_get_handle()\n\t{\n\t\tif ($this->encryption->drivers['mcrypt'] === FALSE)\n\t\t{\n\t\t\treturn $this->markTestSkipped('Cannot test MCrypt because it is not available.');\n\t\t}\n\t\telseif (version_compare(PHP_VERSION, '7.1.0-alpha', '>='))\n\t\t{\n\t\t\treturn $this->markTestSkipped('ext/mcrypt is deprecated since PHP 7.1 and will generate notices here.');\n\t\t}\n\n\t\t$this->assertInternalType('resource', $this->encryption->__driver_get_handle('mcrypt', 'rijndael-128', 'cbc'));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * _openssl_get_handle() test\n\t */\n\tpublic function test__openssl_mcrypt_get_handle()\n\t{\n\t\tif ($this->encryption->drivers['openssl'] === FALSE)\n\t\t{\n\t\t\treturn $this->markTestSkipped('Cannot test OpenSSL because it is not available.');\n\t\t}\n\n\t\t$this->assertEquals('aes-128-cbc', $this->encryption->__driver_get_handle('openssl', 'aes-128', 'cbc'));\n\t\t$this->assertEquals('rc4-40', $this->encryption->__driver_get_handle('openssl', 'rc4-40', 'stream'));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * OpenSSL/MCrypt portability test\n\t *\n\t * Amongst the obvious stuff, _cipher_alias() is also tested here.\n\t */\n\tpublic function test_portability()\n\t{\n\t\tif ( ! $this->encryption->drivers['mcrypt'] OR ! $this->encryption->drivers['openssl'])\n\t\t{\n\t\t\t$this->markTestSkipped('Both MCrypt and OpenSSL support are required for portability tests.');\n\t\t\treturn;\n\t\t}\n\t\telseif (version_compare(PHP_VERSION, '7.1.0-alpha', '>='))\n\t\t{\n\t\t\treturn $this->markTestSkipped('ext/mcrypt is deprecated since PHP 7.1 and will generate notices here.');\n\t\t}\n\n\t\t$message = 'This is a message encrypted via MCrypt and decrypted via OpenSSL, or vice-versa.';\n\n\t\t// Format is: , , \n\t\t$portable = array(\n\t\t\tarray('aes-128', 'cbc', 16),\n\t\t\tarray('aes-128', 'cfb', 16),\n\t\t\tarray('aes-128', 'cfb8', 16),\n\t\t\tarray('aes-128', 'ofb', 16),\n\t\t\tarray('aes-128', 'ecb', 16),\n\t\t\tarray('aes-128', 'ctr', 16),\n\t\t\tarray('aes-192', 'cbc', 24),\n\t\t\tarray('aes-192', 'cfb', 24),\n\t\t\tarray('aes-192', 'cfb8', 24),\n\t\t\tarray('aes-192', 'ofb', 24),\n\t\t\tarray('aes-192', 'ecb', 24),\n\t\t\tarray('aes-192', 'ctr', 24),\n\t\t\tarray('aes-256', 'cbc', 32),\n\t\t\tarray('aes-256', 'cfb', 32),\n\t\t\tarray('aes-256', 'cfb8', 32),\n\t\t\tarray('aes-256', 'ofb', 32),\n\t\t\tarray('aes-256', 'ecb', 32),\n\t\t\tarray('aes-256', 'ctr', 32),\n\t\t\tarray('des', 'cbc', 7),\n\t\t\tarray('des', 'cfb', 7),\n\t\t\tarray('des', 'cfb8', 7),\n\t\t\tarray('des', 'ofb', 7),\n\t\t\tarray('des', 'ecb', 7),\n\t\t\tarray('tripledes', 'cbc', 7),\n\t\t\tarray('tripledes', 'cfb', 7),\n\t\t\tarray('tripledes', 'cfb8', 7),\n\t\t\tarray('tripledes', 'ofb', 7),\n\t\t\tarray('tripledes', 'cbc', 14),\n\t\t\tarray('tripledes', 'cfb', 14),\n\t\t\tarray('tripledes', 'cfb8', 14),\n\t\t\tarray('tripledes', 'ofb', 14),\n\t\t\tarray('tripledes', 'cbc', 21),\n\t\t\tarray('tripledes', 'cfb', 21),\n\t\t\tarray('tripledes', 'cfb8', 21),\n\t\t\tarray('tripledes', 'ofb', 21),\n\t\t\tarray('blowfish', 'cbc', 16),\n\t\t\tarray('blowfish', 'cfb', 16),\n\t\t\tarray('blowfish', 'ofb', 16),\n\t\t\tarray('blowfish', 'ecb', 16),\n\t\t\tarray('blowfish', 'cbc', 56),\n\t\t\tarray('blowfish', 'cfb', 56),\n\t\t\tarray('blowfish', 'ofb', 56),\n\t\t\tarray('blowfish', 'ecb', 56),\n\t\t\tarray('cast5', 'cbc', 11),\n\t\t\tarray('cast5', 'cfb', 11),\n\t\t\tarray('cast5', 'ofb', 11),\n\t\t\tarray('cast5', 'ecb', 11),\n\t\t\tarray('cast5', 'cbc', 16),\n\t\t\tarray('cast5', 'cfb', 16),\n\t\t\tarray('cast5', 'ofb', 16),\n\t\t\tarray('cast5', 'ecb', 16),\n\t\t\tarray('rc4', 'stream', 5),\n\t\t\tarray('rc4', 'stream', 8),\n\t\t\tarray('rc4', 'stream', 16),\n\t\t\tarray('rc4', 'stream', 32),\n\t\t\tarray('rc4', 'stream', 64),\n\t\t\tarray('rc4', 'stream', 128),\n\t\t\tarray('rc4', 'stream', 256)\n\t\t);\n\t\t$driver_index = array('mcrypt', 'openssl');\n\n\t\tforeach ($portable as &$test)\n\t\t{\n\t\t\t// Add some randomness to the selected driver\n\t\t\t$driver = mt_rand(0,1);\n\t\t\t$params = array(\n\t\t\t\t'driver' => $driver_index[$driver],\n\t\t\t\t'cipher' => $test[0],\n\t\t\t\t'mode' => $test[1],\n\t\t\t\t'key' => openssl_random_pseudo_bytes($test[2])\n\t\t\t);\n\n\t\t\t$this->encryption->initialize($params);\n\t\t\t$ciphertext = $this->encryption->encrypt($message);\n\n\t\t\t$driver = (int) ! $driver;\n\t\t\t$params['driver'] = $driver_index[$driver];\n\n\t\t\t$this->encryption->initialize($params);\n\t\t\t$this->assertEquals($message, $this->encryption->decrypt($ciphertext));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * __get() test\n\t */\n\tpublic function test_magic_get()\n\t{\n\t\t$this->assertNull($this->encryption->foo);\n\t\t$this->assertEquals(array('mcrypt', 'openssl'), array_keys($this->encryption->drivers));\n\n\t\t// 'stream' mode is translated into an empty string for OpenSSL\n\t\t$this->encryption->initialize(array('cipher' => 'rc4', 'mode' => 'stream'));\n\t\t$this->assertEquals('stream', $this->encryption->mode);\n\t}\n\n}\n" }, { "path": "tests/codeigniter/libraries/Form_validation_test.php", "content": "helper() looks in the wrong directories for unit tests,\n\t\t// We'll use CI_TestCase->helper() instead\n\t\t$loader = $this->getMockBuilder('CI_Loader')->setMethods(array('helper'))->getMock();\n\n\t\t// Same applies for lang\n\t\t$lang = $this->getMockBuilder('CI_Lang')->setMethods(array('load'))->getMock();\n\n\t\t$security = new Mock_Core_Security('UTF-8');\n\t\t$input = new CI_Input($security);\n\n\t\t$this->ci_instance_var('lang', $lang);\n\t\t$this->ci_instance_var('load', $loader);\n\t\t$this->ci_instance_var('input', $input);\n\n\t\t$this->lang('form_validation');\n\t\t$this->helper('form');\n\n\t\t$this->form_validation = new CI_Form_validation();\n\t}\n\n\tpublic function test_empty_array_input()\n\t{\n\t\t$this->assertFalse(\n\t\t\t$this->run_rules(\n\t\t\t\tarray(array('field' => 'foo', 'label' => 'Foo Label', 'rules' => 'required')),\n\t\t\t\tarray('foo' => array())\n\t\t\t)\n\t\t);\n\t}\n\n\tpublic function test_rule_required()\n\t{\n\t\t$rules = array(array('field' => 'foo', 'label' => 'Foo', 'rules' => 'is_numeric'));\n\n\t\t// Empty, not required\n\t\t$this->assertTrue($this->run_rules($rules, array('foo' => '')));\n\n\t\t// Not required, but also not empty\n\t\t$this->assertTrue($this->run_rules($rules, array('foo' => '123')));\n\t\t$this->assertFalse($this->run_rules($rules, array('foo' => 'bar')));\n\n\t\t// Required variations\n\t\t$rules[0]['rules'] .= '|required';\n\t\t$this->assertTrue($this->run_rules($rules, array('foo' => '123')));\n\t\t$this->assertFalse($this->run_rules($rules, array('foo' => '')));\n\t\t$this->assertFalse($this->run_rules($rules, array('foo' => ' ')));\n\t\t$this->assertFalse($this->run_rules($rules, array('foo' => 'bar')));\n\t}\n\n\tpublic function test_rule_is_array()\n\t{\n\t\t$rules = array(array('field' => 'foo', 'label' => 'Foo', 'rules' => 'is_array'));\n\t\t$this->assertTrue($this->run_rules($rules, array('foo' => array('1', '2'))));\n\t\t$this->assertFalse($this->run_rules($rules, array('foo' => '')));\n\t}\n\n\tpublic function test_rule_matches()\n\t{\n\t\t$rules = array(\n\t\t\tarray('field' => 'foo', 'label' => 'label', 'rules' => 'required'),\n\t\t\tarray('field' => 'bar', 'label' => 'label2', 'rules' => 'matches[foo]')\n\t\t);\n\t\t$values_base = array('foo' => 'sample');\n\n\t\t$this->assertTrue($this->run_rules($rules, array_merge($values_base, array('bar' => 'sample'))));\n\n\t\t$this->assertFalse($this->run_rules($rules, array_merge($values_base, array('bar' => ''))));\n\t\t$this->assertFalse($this->run_rules($rules, array_merge($values_base, array('bar' => 'Sample'))));\n\t\t$this->assertFalse($this->run_rules($rules, array_merge($values_base, array('bar' => ' sample'))));\n\t}\n\n\tpublic function test_rule_differs()\n\t{\n\t\t$rules = array(\n\t\t\tarray('field' => 'foo', 'label' => 'label', 'rules' => 'required'),\n\t\t\tarray('field' => 'bar', 'label' => 'label2', 'rules' => 'differs[foo]')\n\t\t);\n\t\t$values_base = array('foo' => 'sample');\n\n\t\t$this->assertTrue($this->run_rules($rules, array_merge($values_base, array('bar' => 'does_not_match'))));\n\t\t$this->assertTrue($this->run_rules($rules, array_merge($values_base, array('bar' => 'Sample'))));\n\t\t$this->assertTrue($this->run_rules($rules, array_merge($values_base, array('bar' => ' sample'))));\n\n\t\t$this->assertFalse($this->run_rules($rules, array_merge($values_base, array('bar' => 'sample'))));\n\t}\n\n\tpublic function test_rule_min_length()\n\t{\n\t\t$this->assertTrue($this->form_validation->min_length('12345', '5'));\n\t\t$this->assertTrue($this->form_validation->min_length('test', '0'));\n\n\t\t$this->assertFalse($this->form_validation->min_length('123', '4'));\n\t\t$this->assertFalse($this->form_validation->min_length('should_fail', 'A'));\n\t\t$this->assertFalse($this->form_validation->min_length('', '4'));\n\t}\n\n\tpublic function test_rule_max_length()\n\t{\n\t\t$this->assertTrue($this->form_validation->max_length('', '4'));\n\t\t$this->assertTrue($this->form_validation->max_length('1234', '4'));\n\n\t\t$this->assertFalse($this->form_validation->max_length('12345', '4'));\n\t\t$this->assertFalse($this->form_validation->max_length('should_fail', 'A'));\n\t}\n\n\tpublic function test_rule_exact_length()\n\t{\n\t\t$this->assertTrue($this->form_validation->exact_length('1234', '4'));\n\n\t\t$this->assertFalse($this->form_validation->exact_length('', '3'));\n\t\t$this->assertFalse($this->form_validation->exact_length('12345', '4'));\n\t\t$this->assertFalse($this->form_validation->exact_length('123', '4'));\n\t\t$this->assertFalse($this->form_validation->exact_length('should_fail', 'A'));\n\t}\n\n\tpublic function test_rule_greater_than()\n\t{\n\t\t$this->assertTrue($this->form_validation->greater_than('-10', '-11'));\n\t\t$this->assertTrue($this->form_validation->greater_than('10', '9'));\n\n\t\t$this->assertFalse($this->form_validation->greater_than('10', '10'));\n\t\t$this->assertFalse($this->form_validation->greater_than('10', 'a'));\n\t\t$this->assertFalse($this->form_validation->greater_than('10a', '10'));\n\t}\n\n\tpublic function test_rule_greater_than_equal_to()\n\t{\n\t\t$this->assertTrue($this->form_validation->greater_than_equal_to('0', '0'));\n\t\t$this->assertTrue($this->form_validation->greater_than_equal_to('1', '0'));\n\n\t\t$this->assertFalse($this->form_validation->greater_than_equal_to('-1', '0'));\n\t\t$this->assertFalse($this->form_validation->greater_than_equal_to('10a', '0'));\n\t}\n\n\tpublic function test_rule_less_than()\n\t{\n\t\t$this->assertTrue($this->form_validation->less_than('4', '5'));\n\t\t$this->assertTrue($this->form_validation->less_than('-1', '0'));\n\n\t\t$this->assertFalse($this->form_validation->less_than('4', '4'));\n\t\t$this->assertFalse($this->form_validation->less_than('10a', '5'));\n\t}\n\n\tpublic function test_rule_less_than_equal_to()\n\t{\n\t\t$this->assertTrue($this->form_validation->less_than_equal_to('-1', '0'));\n\t\t$this->assertTrue($this->form_validation->less_than_equal_to('-1', '-1'));\n\t\t$this->assertTrue($this->form_validation->less_than_equal_to('4', '4'));\n\n\t\t$this->assertFalse($this->form_validation->less_than_equal_to('0', '-1'));\n\t\t$this->assertFalse($this->form_validation->less_than_equal_to('10a', '0'));\n\t}\n\n\tpublic function test_rule_in_list()\n\t{\n\t\t$this->assertTrue($this->form_validation->in_list('red', 'red,Blue,123'));\n\t\t$this->assertTrue($this->form_validation->in_list('Blue', 'red,Blue,123'));\n\t\t$this->assertTrue($this->form_validation->in_list('123', 'red,Blue,123'));\n\n\t\t$this->assertFalse($this->form_validation->in_list('Red', 'red,Blue,123'));\n\t\t$this->assertFalse($this->form_validation->in_list(' red', 'red,Blue,123'));\n\t\t$this->assertFalse($this->form_validation->in_list('1234', 'red,Blue,123'));\n\t}\n\n\tpublic function test_rule_alpha()\n\t{\n\t\t$this->assertTrue($this->form_validation->alpha('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ'));\n\n\t\t$this->assertFalse($this->form_validation->alpha('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ '));\n\t\t$this->assertFalse($this->form_validation->alpha('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ1'));\n\t\t$this->assertFalse($this->form_validation->alpha('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ*'));\n\t}\n\n\tpublic function test_rule_alpha_numeric()\n\t{\n\t\t$this->assertTrue($this->form_validation->alpha_numeric('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789'));\n\n\t\t$this->assertFalse($this->form_validation->alpha_numeric('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789\\ '));\n\t\t$this->assertFalse($this->form_validation->alpha_numeric('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789_'));\n\t}\n\n\tpublic function test_rule_alpha_numeric_spaces()\n\t{\n\t\t$this->assertTrue($this->form_validation->alpha_numeric_spaces(' abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789'));\n\n\t\t$this->assertFalse($this->form_validation->alpha_numeric_spaces(' abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789_'));\n\t}\n\n\tpublic function test_rule_alpha_dash()\n\t{\n\t\t$this->assertTrue($this->form_validation->alpha_dash('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789-_'));\n\n\t\t$this->assertFalse($this->form_validation->alpha_dash('abcdefghijklmnopqrstuvwxyzABCDEFGHLIJKLMNOPQRSTUVWXYZ0123456789-_\\ '));\n\t}\n\n\tpublic function test_rule_numeric()\n\t{\n\t\t$this->assertTrue($this->form_validation->numeric('0'));\n\t\t$this->assertTrue($this->form_validation->numeric('12314'));\n\t\t$this->assertTrue($this->form_validation->numeric('-42'));\n\n\t\t$this->assertFalse($this->form_validation->numeric('123a'));\n\t\t$this->assertFalse($this->form_validation->numeric('--1'));\n\t}\n\n\tpublic function test_rule_integer()\n\t{\n\t\t$this->assertTrue($this->form_validation->integer('0'));\n\t\t$this->assertTrue($this->form_validation->integer('42'));\n\t\t$this->assertTrue($this->form_validation->integer('-1'));\n\n\t\t$this->assertFalse($this->form_validation->integer('124a'));\n\t\t$this->assertFalse($this->form_validation->integer('1.9'));\n\t\t$this->assertFalse($this->form_validation->integer('--1'));\n\t}\n\n\tpublic function test_rule_decimal()\n\t{\n\t\t$this->assertTrue($this->form_validation->decimal('1.0'));\n\t\t$this->assertTrue($this->form_validation->decimal('-0.98'));\n\n\t\t$this->assertFalse($this->form_validation->decimal('0'));\n\t\t$this->assertFalse($this->form_validation->decimal('1.0a'));\n\t\t$this->assertFalse($this->form_validation->decimal('-i'));\n\t\t$this->assertFalse($this->form_validation->decimal('--1'));\n\t}\n\n\tpublic function test_rule_is_natural()\n\t{\n\t\t$this->assertTrue($this->form_validation->is_natural('0'));\n\t\t$this->assertTrue($this->form_validation->is_natural('12'));\n\n\t\t$this->assertFalse($this->form_validation->is_natural('42a'));\n\t\t$this->assertFalse($this->form_validation->is_natural('-1'));\n\t}\n\n\tpublic function test_rule_is_natural_no_zero()\n\t{\n\t\t$this->assertTrue($this->form_validation->is_natural_no_zero('42'));\n\n\t\t$this->assertFalse($this->form_validation->is_natural_no_zero('0'));\n\t\t$this->assertFalse($this->form_validation->is_natural_no_zero('42a'));\n\t\t$this->assertFalse($this->form_validation->is_natural_no_zero('-1'));\n\t}\n\n\tpublic function test_rule_valid_url()\n\t{\n\t\t$this->assertTrue($this->form_validation->valid_url('www.codeigniter.com'));\n\t\t$this->assertTrue($this->form_validation->valid_url('http://codeigniter.com'));\n\n\t\t// https://bugs.php.net/bug.php?id=51192\n\t\t$this->assertTrue($this->form_validation->valid_url('http://accept-dashes.tld'));\n\t\t$this->assertFalse($this->form_validation->valid_url('http://reject_underscores.tld'));\n\n\t\t// https://github.com/bcit-ci/CodeIgniter/issues/4415\n\t\t$this->assertTrue($this->form_validation->valid_url('http://[::1]/ipv6'));\n\n\t\t// URI scheme case-sensitivity: https://github.com/bcit-ci/CodeIgniter/pull/4758\n\t\t$this->assertTrue($this->form_validation->valid_url('HtTp://127.0.0.1/'));\n\n\t\t// https://github.com/bcit-ci/CodeIgniter/issues/5755\n\t\t$this->assertFalse($this->form_validation->valid_url('1'));\n\n\t\t$this->assertFalse($this->form_validation->valid_url('htt://www.codeIgniter.com'));\n\t\t$this->assertFalse($this->form_validation->valid_url(''));\n\t\t$this->assertFalse($this->form_validation->valid_url('code igniter'));\n\t}\n\n\tpublic function test_rule_valid_email()\n\t{\n\t\t$this->assertTrue($this->form_validation->valid_email('email@sample.com'));\n\t\t$this->assertFalse($this->form_validation->valid_email('email@sample.com foo bar'));\n\t\t$this->assertFalse($this->form_validation->valid_email('valid_email', '@sample.com'));\n\t}\n\n\tpublic function test_rule_valid_emails()\n\t{\n\t\t$this->assertTrue($this->form_validation->valid_emails('1@sample.com,2@sample.com'));\n\t\t$this->assertTrue($this->form_validation->valid_emails('email@sample.com'));\n\n\t\t$this->assertFalse($this->form_validation->valid_emails('valid_email', '@sample.com'));\n\t\t$this->assertFalse($this->form_validation->valid_emails('@sample.com,2@sample.com,validemail@email.ca'));\n\t}\n\n\tpublic function test_rule_valid_ip()\n\t{\n\t\t$this->assertTrue($this->form_validation->valid_ip('127.0.0.1'));\n\t\t$this->assertTrue($this->form_validation->valid_ip('127.0.0.1', 'ipv4'));\n\t\t$this->assertTrue($this->form_validation->valid_ip('2001:0db8:85a3:0000:0000:8a2e:0370:7334'));\n\t\t$this->assertTrue($this->form_validation->valid_ip('2001:0db8:85a3:0000:0000:8a2e:0370:7334', 'ipv6'));\n\n\t\t$this->assertFalse($this->form_validation->valid_ip('2001:0db8:85a3:0000:0000:8a2e:0370:7334', 'ipv4'));\n\t\t$this->assertFalse($this->form_validation->valid_ip('127.0.0.1', 'ipv6'));\n\t\t$this->assertFalse($this->form_validation->valid_ip('H001:0db8:85a3:0000:0000:8a2e:0370:7334'));\n\t\t$this->assertFalse($this->form_validation->valid_ip('127.0.0.259'));\n\t}\n\n\tpublic function test_rule_valid_mac()\n\t{\n\t\t$this->assertTrue($this->form_validation->valid_mac(\"01-23-45-67-89-aB\"));\n\t\t$this->assertTrue($this->form_validation->valid_mac(\"01:23:45:67:89:aB\"));\n\t\t$this->assertTrue($this->form_validation->valid_mac(\"0123.4567.89aB\"));\n\n\t\t$this->assertFalse($this->form_validation->valid_mac(\"-01-23-45-67-89-ab\"));\n\t\t$this->assertFalse($this->form_validation->valid_mac(\"01:23:45:67:89:ab:\"));\n\t\t$this->assertFalse($this->form_validation->valid_mac(\"01:23:45:67:89:ab\\n\"));\n\t\t$this->assertFalse($this->form_validation->valid_mac(\"01:23:45:67:89:ag:\"));\n\t\t$this->assertFalse($this->form_validation->valid_mac('0123456789ab'));\n\t}\n\n\tpublic function test_rule_valid_base64()\n\t{\n\t\t$this->assertTrue($this->form_validation->valid_base64(base64_encode('string')));\n\t\t$this->assertFalse($this->form_validation->valid_base64('FA08GG'));\n\t}\n\n\tpublic function test_set_data()\n\t{\n\t\t$data = array('field' => 'some_data');\n\t\t$this->form_validation->set_data($data);\n\t\t$this->form_validation->set_rules('field', 'label', 'required');\n\t\t$this->assertTrue($this->form_validation->run());\n\n\t\t// Test with empty array\n\t\t$_POST = array();\n\t\t$this->form_validation->reset_validation();\n\t\t$data = array('field' => 'some_data');\n\t\t$this->form_validation->set_data($data);\n\t\t// This should do nothing. Old data will still be used\n\t\t$this->form_validation->set_data(array());\n\t\t$this->form_validation->set_rules('field', 'label', 'required');\n\t\t$this->assertTrue($this->form_validation->run());\n\t}\n\n\tpublic function test_set_message()\n\t{\n\t\t$err_message = 'What a terrible error!';\n\t\t$rules = array(\n\t\t\tarray(\n\t\t\t\t'field' => 'req_field',\n\t\t\t\t'label' => 'label',\n\t\t\t\t'rules' => 'required'\n\t\t\t)\n\t\t);\n\t\t$errorless_data = array('req_field' => 'some text');\n\t\t$erroneous_data = array('req_field' => '');\n\n\t\t$this->form_validation->set_message('required', $err_message);\n\t\t$this->form_validation->set_data($erroneous_data);\n\t\t$this->form_validation->set_rules($rules);\n\t\t$this->form_validation->run();\n\t\t$this->assertEquals('

    '.$err_message.'

    ', $this->form_validation->error('req_field'));\n\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_message('required', $err_message);\n\t\t$this->form_validation->set_data($errorless_data);\n\t\t$this->form_validation->set_rules($rules);\n\t\t$this->form_validation->run();\n\t\t$this->assertEquals('', $this->form_validation->error('req_field'));\n\t}\n\n\tpublic function test_set_error_delimiters()\n\t{\n\t\t$prefix = '
    ';\n\t\t$suffix = '
    ';\n\t\t$this->form_validation->set_error_delimiters($prefix, $suffix);\n\t\t$this->form_validation->set_rules('foo', 'label', 'required');\n\t\t$_POST = array('foo' => '');\n\t\t$this->form_validation->run();\n\t\t$error_msg = $this->form_validation->error('foo');\n\n\t\t$this->assertStringStartsWith($prefix, $error_msg);\n\t\t$this->assertTrue(strrpos($error_msg, $suffix, -strlen($suffix)) === (strlen($error_msg) - strlen($suffix)));\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_error_array()\n\t{\n\t\t$error_message = 'What a terrible error!';\n\t\t$this->form_validation->set_message('required', $error_message);\n\t\t$this->form_validation->set_rules('foo', 'label', 'required');\n\t\t$_POST = array('foo' => '');\n\t\t$this->form_validation->run();\n\t\t$error_array = $this->form_validation->error_array();\n\t\t$this->assertEquals($error_message, $error_array['foo']);\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_error_string()\n\t{\n\t\t$error_message = 'What a terrible error!';\n\t\t$prefix_default = '';\n\t\t$suffix_default = '';\n\t\t$prefix_test = '';\n\t\t$suffix_test = '';\n\t\t$this->form_validation->set_error_delimiters($prefix_default, $suffix_default);\n\t\t$this->form_validation->set_message('required', $error_message);\n\t\t$this->form_validation->set_rules('foo', 'label', 'required');\n\t\t$_POST = array('foo' => '');\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals($prefix_default.$error_message.$suffix_default.\"\\n\", $this->form_validation->error_string());\n\t\t$this->assertEquals($prefix_test.$error_message.$suffix_default.\"\\n\", $this->form_validation->error_string($prefix_test, ''));\n\t\t$this->assertEquals($prefix_default.$error_message.$suffix_test.\"\\n\", $this->form_validation->error_string('', $suffix_test));\n\t\t$this->assertEquals($prefix_test.$error_message.$suffix_test.\"\\n\", $this->form_validation->error_string($prefix_test, $suffix_test));\n\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('foo', 'label', 'required');\n\t\t$_POST = array('foo' => 'bar');\n\t\t$this->form_validation->run();\n\t\t$this->assertEquals('', $this->form_validation->error_string());\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_run()\n\t{\n\t\t// form_validation->run() is tested in many of the other unit tests\n\t\t// This test will only test run(group='') when group is not empty\n\t\t$config = array(\n\t\t\t'pass' => array(\n\t\t\t\tarray(\n\t\t\t\t\t'field' => 'username',\n\t\t\t\t\t'label' => 'user',\n\t\t\t\t\t'rules' => 'alpha_numeric'\n\t\t\t\t)\n\t\t\t),\n\t\t\t'fail' => array(\n\t\t\t\tarray(\n\t\t\t\t\t'field' => 'username',\n\t\t\t\t\t'label' => 'user',\n\t\t\t\t\t'rules' => 'alpha'\n\t\t\t\t)\n\t\t\t)\n\t\t);\n\t\t$_POST = array('username' => 'foo42');\n\t\t$form_validation = new CI_Form_validation($config);\n\t\t$this->assertTrue($form_validation->run('pass'));\n\n\t\t$form_validation = new CI_Form_validation($config);\n\t\t$this->assertFalse($form_validation->run('fail'));\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_set_rules_exception()\n\t{\n\t\t$this->setExpectedException('BadMethodCallException');\n\t\t$this->form_validation->set_rules('foo', 'bar');\n\t}\n\n\tpublic function test_has_rule()\n\t{\n\t\t$this->form_validation->set_rules('foo', 'label', 'required');\n\n\t\t$this->assertTrue($this->form_validation->has_rule('foo'));\n\t\t$this->assertFalse($this->form_validation->has_rule('bar'));\n\t}\n\n\tpublic function test_set_value()\n\t{\n\t\t$default = 'default';\n\t\t$this->form_validation->set_rules('foo', 'label', 'required');\n\t\t$this->form_validation->set_rules('bar[]', 'label', 'required');\n\n\t\t// No post data yet: should return the default value provided\n\t\t$this->assertEquals($default, $this->form_validation->set_value('foo', $default));\n\t\t$_POST = array('foo' => 'foo', 'bar' => array('bar1', 'bar2'));\n\t\t$this->form_validation->run();\n\t\t$this->assertEquals('foo', $this->form_validation->set_value('foo', $default));\n\t\t$this->assertEquals('bar1', $this->form_validation->set_value('bar[]', $default));\n\t\t$this->assertEquals('bar2', $this->form_validation->set_value('bar[]', $default));\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_issue_5202()\n\t{\n\t\t$data = array('person' => array('firstname' => 'Dick', 'lastname' => 'Tracy '));\n\t\t$this->form_validation->set_rules('person[firstname]', 'First Name', 'required|trim');\n\t\t$this->form_validation->set_rules('person[lastname]', 'Last Name', 'required|trim');\n\t\t$this->form_validation->set_data($data);\n\t\t$valid = $this->form_validation->run('', $data);\n\n\t\t$this->assertTrue($valid);\n\t\t$this->assertEquals('Dick', $data['person']['firstname']);\n\t\t$this->assertEquals('Tracy', $data['person']['lastname']);\n\t}\n\n\tpublic function test_set_select()\n\t{\n\t\t// Test 1: No options selected\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals('', $this->form_validation->set_select('select', 'foo'));\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select', 'bar', TRUE));\n\n\t\t// Test 2: 1 option selected\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('select', 'label', 'alpha_numeric');\n\t\t$_POST = array('select' => 'foo');\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select', 'foo'));\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select', 'foo', TRUE));\n\t\t$this->assertEquals('', $this->form_validation->set_select('select', 'bar'));\n\t\t$this->assertEquals('', $this->form_validation->set_select('select', 'bar', TRUE));\n\n\t\t// Test 3: Multiple options selected\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('select[]', 'label', 'alpha_numeric');\n\t\t$_POST = array('select' => array('foo', 'bar'));\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select[]', 'foo'));\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select[]', 'foo', TRUE));\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select[]', 'bar'));\n\t\t$this->assertEquals(' selected=\"selected\"', $this->form_validation->set_select('select[]', 'bar', TRUE));\n\t\t$this->assertEquals('', $this->form_validation->set_select('select[]', 'foobar'));\n\t\t$this->assertEquals('', $this->form_validation->set_select('select[]', 'foobar', TRUE));\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_set_radio()\n\t{\n\t\t// Test 1: No options selected\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals('', $this->form_validation->set_radio('select', 'foo'));\n\t\t// Default should only work when no rules are set\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select', 'bar', TRUE));\n\n\t\t// Test 2: 1 option selected\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('select', 'label', 'alpha_numeric');\n\t\t$_POST = array('select' => 'foo');\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select', 'foo'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select', 'foo', TRUE));\n\t\t$this->assertEquals('', $this->form_validation->set_radio('select', 'bar'));\n\t\t$this->assertEquals('', $this->form_validation->set_radio('select', 'bar', TRUE));\n\n\t\t// Test 3: Multiple options checked\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('select[]', 'label', 'alpha_numeric');\n\t\t$_POST = array('select' => array('foo', 'bar'));\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select[]', 'foo'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select[]', 'foo', TRUE));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select[]', 'bar'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_radio('select[]', 'bar', TRUE));\n\t\t$this->assertEquals('', $this->form_validation->set_radio('select[]', 'foobar'));\n\t\t$this->assertEquals('', $this->form_validation->set_radio('select[]', 'foobar', TRUE));\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_set_checkbox()\n\t{\n\t\t// Test 1: No options selected\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals('', $this->form_validation->set_checkbox('select', 'foo'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select', 'bar', TRUE));\n\n\t\t// Test 2: 1 option selected\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('select', 'label', 'alpha_numeric');\n\t\t$_POST = array('select' => 'foo');\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select', 'foo'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select', 'foo', TRUE));\n\t\t$this->assertEquals('', $this->form_validation->set_checkbox('select', 'bar'));\n\t\t$this->assertEquals('', $this->form_validation->set_checkbox('select', 'bar', TRUE));\n\n\t\t// Test 3: Multiple options selected\n\t\t$this->form_validation->reset_validation();\n\t\t$this->form_validation->set_rules('select[]', 'label', 'alpha_numeric');\n\t\t$_POST = array('select' => array('foo', 'bar'));\n\t\t$this->form_validation->run();\n\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select[]', 'foo'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select[]', 'foo', TRUE));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select[]', 'bar'));\n\t\t$this->assertEquals(' checked=\"checked\"', $this->form_validation->set_checkbox('select[]', 'bar', TRUE));\n\t\t$this->assertEquals('', $this->form_validation->set_checkbox('select[]', 'foobar'));\n\t\t$this->assertEquals('', $this->form_validation->set_checkbox('select[]', 'foobar', TRUE));\n\n\t\t$_POST = array();\n\t}\n\n\tpublic function test_regex_match()\n\t{\n\t\t$regex = '/f[a-zA-Z]+/';\n\t\t$this->assertTrue($this->form_validation->regex_match('foo', $regex));\n\t\t$this->assertFalse($this->form_validation->regex_match('bar', $regex));\n\t}\n\n\tpublic function test_prep_url()\n\t{\n\t\t$this->assertEquals('', $this->form_validation->prep_url(''));\n\t\t$this->assertEquals('http://codeigniter.com', $this->form_validation->prep_url('codeigniter.com'));\n\t\t$this->assertEquals('https://codeigniter.com', $this->form_validation->prep_url('https://codeigniter.com'));\n\t\t$this->assertEquals('http://codeigniter.com', $this->form_validation->prep_url('http://codeigniter.com'));\n\t\t$this->assertEquals('http://www.codeigniter.com', $this->form_validation->prep_url('www.codeigniter.com'));\n\t}\n\n\tpublic function test_encode_php_tags()\n\t{\n\t\t$this->assertEquals(\"<?php\", $this->form_validation->encode_php_tags('assertEquals('?>', $this->form_validation->encode_php_tags('?>'));\n\t}\n\n\tpublic function test_validated_data_assignment()\n\t{\n\t\t$_POST = $post_original = array('foo' => ' bar ', 'bar' => 'baz');\n\n\t\t$this->form_validation->set_data($_POST);\n\t\t$this->form_validation->set_rules('foo', 'Foo', 'required|trim');\n\n\t\t$data_processed = NULL;\n\t\t$validation_result = $this->form_validation->run('', $data_processed);\n\n\t\t$this->assertTrue($validation_result);\n\t\t$this->assertEquals($post_original, $_POST);\n\t\t$this->assertEquals(array('foo' => 'bar', 'bar' => 'baz'), $data_processed);\n\n\t\t$_POST = array();\n\t}\n\n\t/**\n\t * Run rules\n\t *\n\t * Helper method to set rules and run them at once, not\n\t * an actual test case.\n\t */\n\tpublic function run_rules($rules, $values)\n\t{\n\t\t$this->form_validation->reset_validation();\n\t\t$_POST = array();\n\t\t$this->form_validation->set_rules($rules);\n\n\t\tforeach ($values as $field => $value)\n\t\t{\n\t\t\t$_POST[$field] = $value;\n\t\t}\n\n\t\t$valid = $this->form_validation->run();\n\t\t$_POST = array();\n\n\t\treturn $valid;\n\t}\n}\n" }, { "path": "tests/codeigniter/libraries/Parser_test.php", "content": "parser = new CI_Parser();\n\t\t$this->ci_instance_var('parser', $this->parser);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_set_delimiters()\n\t{\n\t\t// Make sure default delimiters are there\n\t\t$this->assertEquals('{', $this->parser->l_delim);\n\t\t$this->assertEquals('}', $this->parser->r_delim);\n\n\t\t// Change them to square brackets\n\t\t$this->parser->set_delimiters('[', ']');\n\n\t\t// Make sure they changed\n\t\t$this->assertEquals('[', $this->parser->l_delim);\n\t\t$this->assertEquals(']', $this->parser->r_delim);\n\n\t\t// Reset them\n\t\t$this->parser->set_delimiters();\n\n\t\t// Make sure default delimiters are there\n\t\t$this->assertEquals('{', $this->parser->l_delim);\n\t\t$this->assertEquals('}', $this->parser->r_delim);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_parse_string()\n\t{\n\t\t$data = array(\n\t\t\t'title' => 'Page Title',\n\t\t\t'body' => 'Lorem ipsum dolor sit amet.'\n\t\t);\n\n\t\t$template = \"{title}\\n{body}\";\n\n\t\t$result = implode(\"\\n\", $data);\n\n\t\t$this->assertEquals($result, $this->parser->parse_string($template, $data, TRUE));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_parse()\n\t{\n\t\t$this->_parse_no_template();\n\t\t$this->_parse_var_pair();\n\t\t$this->_mismatched_var_pair();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _parse_no_template()\n\t{\n\t\t$this->assertFalse($this->parser->parse_string('', '', TRUE));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _parse_var_pair()\n\t{\n\t\t$data = array(\n\t\t\t'title'\t\t=> 'Super Heroes',\n\t\t\t'powers'\t=> array(array('invisibility' => 'yes', 'flying' => 'no'))\n\t\t);\n\n\t\t$template = \"{title}\\n{powers}{invisibility}\\n{flying}{/powers}\\nsecond:{powers} {invisibility} {flying}{/powers}\";\n\n\t\t$this->assertEquals(\"Super Heroes\\nyes\\nno\\nsecond: yes no\", $this->parser->parse_string($template, $data, TRUE));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _mismatched_var_pair()\n\t{\n\t\t$data = array(\n\t\t\t'title'\t\t=> 'Super Heroes',\n\t\t\t'powers'\t=> array(array('invisibility' => 'yes', 'flying' => 'no'))\n\t\t);\n\n\t\t$template = \"{title}\\n{powers}{invisibility}\\n{flying}\";\n\t\t$result = \"Super Heroes\\n{powers}{invisibility}\\n{flying}\";\n\n\t\t$this->assertEquals($result, $this->parser->parse_string($template, $data, TRUE));\n\t}\n\n}" }, { "path": "tests/codeigniter/libraries/Session_test.php", "content": " 0,\n\t\t'use_only_cookies' => 0,\n\t\t'cache_limiter' => FALSE\n\t);\n\tprotected $setting_vals = array();\n\tprotected $cookie_vals;\n\tprotected $session;\n\n\t/**\n\t * Set up test framework\n\t */\n\tpublic function set_up()\n\t{\nreturn;\n\t\t// Override settings\n\t\tforeach ($this->settings as $name => $value) {\n\t\t\t$this->setting_vals[$name] = ini_get('session.'.$name);\n\t\t\tini_set('session.'.$name, $value);\n\t\t}\n\n\t\t// Start with clean environment\n\t\t$this->cookie_vals = $_COOKIE;\n\t\t$_COOKIE = array();\n\n\t\t// Set subclass prefix to match our mock\n\t\t$this->ci_set_config('subclass_prefix', 'Mock_Libraries_');\n\n\t\t// Establish necessary support classes\n\t\t$ci = $this->ci_instance();\n\t\t$ldr = $this->ci_core_class('load');\n\t\t$ci->load = new $ldr();\n\t\t$security = new Mock_Core_Security('UTF-8');\n\t\t$ci->input = new CI_Input($security);\n\n\t\t// Make sure string helper is available\n\t\t$this->ci_vfs_clone('system/helpers/string_helper.php');\n\n\t\t// Attach session instance locally\n\t\t$config = array(\n\t\t\t'sess_encrypt_cookie' => FALSE,\n\t\t\t'sess_use_database' => FALSE,\n\t\t\t'sess_table_name' => '',\n\t\t\t'sess_expiration' => 7200,\n\t\t\t'sess_expire_on_close' => FALSE,\n\t\t\t'sess_match_ip' => FALSE,\n\t\t\t'sess_match_useragent' => TRUE,\n\t\t\t'sess_cookie_name' => 'ci_session',\n\t\t\t'cookie_path' => '',\n\t\t\t'cookie_domain' => '',\n\t\t\t'cookie_secure' => FALSE,\n\t\t\t'cookie_httponly' => FALSE,\n\t\t\t'sess_time_to_update' => 300,\n\t\t\t'time_reference' => 'local',\n\t\t\t'cookie_prefix' => '',\n\t\t\t'encryption_key' => 'foobar'\n\t\t);\n\t\t$this->session = new Mock_Libraries_Session($config);\n\t}\n\n\t/**\n\t * Tear down test framework\n\t */\n\tpublic function tear_down()\n\t{\nreturn;\n\t\t// Restore environment\n\t\tif (session_id()) session_destroy();\n\t\t$_SESSION = array();\n\t\t$_COOKIE = $this->cookie_vals;\n\n\t\t// Restore settings\n\t\tforeach ($this->settings as $name => $value) {\n\t\t\tini_set('session.'.$name, $this->setting_vals[$name]);\n\t\t}\n\t}\n\n\t/**\n\t * Test set_userdata() function\n\t */\n\tpublic function test_set_userdata()\n\t{\nreturn;\n\t\t// Set userdata values for each driver\n\t\t$key1 = 'test1';\n\t\t$ckey2 = 'test2';\n\t\t$nkey2 = 'test3';\n\t\t$cmsg1 = 'Some test data';\n\t\t$cmsg2 = 42;\n\t\t$nmsg1 = 'Other test data';\n\t\t$nmsg2 = TRUE;\n\t\t$this->session->cookie->set_userdata($key1, $cmsg1);\n\t\t$this->session->set_userdata($ckey2, $cmsg2);\n\t\t$this->session->native->set_userdata($key1, $nmsg1);\n\t\t$this->session->set_userdata($nkey2, $nmsg2);\n\n\t\t// Verify independent messages\n\t\t$this->assertEquals($cmsg1, $this->session->cookie->userdata($key1));\n\t\t$this->assertEquals($nmsg1, $this->session->native->userdata($key1));\n\n\t\t// Verify pre-selected driver sets\n\t\t$this->assertEquals($cmsg2, $this->session->cookie->userdata($ckey2));\n\t\t$this->assertEquals($nmsg2, $this->session->native->userdata($nkey2));\n\n\t\t// Verify no crossover\n\t\t$this->assertNull($this->session->cookie->userdata($nkey2));\n\t\t$this->assertNull($this->session->native->userdata($ckey2));\n\t}\n\n\t/**\n\t * Test the has_userdata() function\n\t */\n\tpublic function test_has_userdata()\n\t{\nreturn;\n\t\t// Set a userdata value for each driver\n\t\t$key = 'hastest';\n\t\t$cmsg = 'My test data';\n\t\t$this->session->cookie->set_userdata($key, $cmsg);\n\t\t$nmsg = 'Your test data';\n\t\t$this->session->native->set_userdata($key, $nmsg);\n\n\t\t// Verify values exist\n\t\t$this->assertTrue($this->session->cookie->has_userdata($key));\n\t\t$this->assertTrue($this->session->native->has_userdata($key));\n\n\t\t// Verify non-existent values\n\t\t$nokey = 'hasnot';\n\t\t$this->assertFalse($this->session->cookie->has_userdata($nokey));\n\t\t$this->assertFalse($this->session->native->has_userdata($nokey));\n\t}\n\n\t/**\n\t * Test the all_userdata() function\n\t */\n\tpublic function test_all_userdata()\n\t{\nreturn;\n\t\t// Set a specific series of data for each driver\n\t\t$cdata = array(\n\t\t\t'one' => 'first',\n\t\t\t'two' => 'second',\n\t\t\t'three' => 'third',\n\t\t\t'foo' => 'bar',\n\t\t\t'bar' => 'baz'\n\t\t);\n\t\t$ndata = array(\n\t\t\t'one' => 'gold',\n\t\t\t'two' => 'silver',\n\t\t\t'three' => 'bronze',\n\t\t\t'foo' => 'baz',\n\t\t\t'bar' => 'foo'\n\t\t);\n\t\t$this->session->cookie->set_userdata($cdata);\n\t\t$this->session->native->set_userdata($ndata);\n\n\t\t// Make sure all values are present\n\t\t$call = $this->session->cookie->userdata();\n\t\tforeach ($cdata as $key => $value) {\n\t\t\t$this->assertEquals($value, $call[$key]);\n\t\t}\n\t\t$nall = $this->session->native->userdata();\n\t\tforeach ($ndata as $key => $value) {\n\t\t\t$this->assertEquals($value, $nall[$key]);\n\t\t}\n\t}\n\n\t/**\n\t * Test the unset_userdata() function\n\t */\n\tpublic function test_unset_userdata()\n\t{\nreturn;\n\t\t// Set a userdata message for each driver\n\t\t$key = 'untest';\n\t\t$cmsg = 'Other test data';\n\t\t$this->session->cookie->set_userdata($key, $cmsg);\n\t\t$nmsg = 'Sundry test data';\n\t\t$this->session->native->set_userdata($key, $nmsg);\n\n\t\t// Verify independent messages\n\t\t$this->assertEquals($this->session->cookie->userdata($key), $cmsg);\n\t\t$this->assertEquals($this->session->native->userdata($key), $nmsg);\n\n\t\t// Unset them and verify absence\n\t\t$this->session->cookie->unset_userdata($key);\n\t\t$this->session->native->unset_userdata($key);\n\t\t$this->assertNull($this->session->cookie->userdata($key));\n\t\t$this->assertNull($this->session->native->userdata($key));\n\t}\n\n\t/**\n\t * Test the flashdata() functions\n\t */\n\tpublic function test_flashdata()\n\t{\nreturn;\n\t\t// Set flashdata message for each driver\n\t\t$key = 'fltest';\n\t\t$cmsg = 'Some flash data';\n\t\t$this->session->cookie->set_flashdata($key, $cmsg);\n\t\t$nmsg = 'Other flash data';\n\t\t$this->session->native->set_flashdata($key, $nmsg);\n\n\t\t// Simulate page reload\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\n\t\t// Verify independent messages\n\t\t$this->assertEquals($cmsg, $this->session->cookie->flashdata($key));\n\t\t$this->assertEquals($nmsg, $this->session->native->flashdata($key));\n\n\t\t// Simulate next page reload\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\n\t\t// Verify absence of messages\n\t\t$this->assertNull($this->session->cookie->flashdata($key));\n\t\t$this->assertNull($this->session->native->flashdata($key));\n\t}\n\n\t/**\n\t * Test the keep_flashdata() function\n\t */\n\tpublic function test_keep_flashdata()\n\t{\nreturn;\n\t\t// Set flashdata message for each driver\n\t\t$key = 'kfltest';\n\t\t$cmsg = 'My flash data';\n\t\t$this->session->cookie->set_flashdata($key, $cmsg);\n\t\t$nmsg = 'Your flash data';\n\t\t$this->session->native->set_flashdata($key, $nmsg);\n\n\t\t// Simulate page reload and verify independent messages\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEquals($cmsg, $this->session->cookie->flashdata($key));\n\t\t$this->assertEquals($nmsg, $this->session->native->flashdata($key));\n\n\t\t// Keep messages\n\t\t$this->session->cookie->keep_flashdata($key);\n\t\t$this->session->native->keep_flashdata($key);\n\n\t\t// Simulate next page reload and verify message persistence\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEquals($cmsg, $this->session->cookie->flashdata($key));\n\t\t$this->assertEquals($nmsg, $this->session->native->flashdata($key));\n\n\t\t// Simulate next page reload and verify absence of messages\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertNull($this->session->cookie->flashdata($key));\n\t\t$this->assertNull($this->session->native->flashdata($key));\n\t}\n\n\tpublic function test_keep_flashdata_with_array()\n\t{\nreturn;\n\t\t// Set flashdata array for each driver\n\t\t$cdata = array(\n\t\t\t'one' => 'first',\n\t\t\t'two' => 'second',\n\t\t\t'three' => 'third',\n\t\t\t'foo' => 'bar',\n\t\t\t'bar' => 'baz'\n\t\t);\n\t\t$ndata = array(\n\t\t\t'one' => 'gold',\n\t\t\t'two' => 'silver',\n\t\t\t'three' => 'bronze',\n\t\t\t'foo' => 'baz',\n\t\t\t'bar' => 'foo'\n\t\t);\n\t\t$kdata = array(\n\t\t\t'one',\n\t\t\t'two',\n\t\t\t'three',\n\t\t\t'foo',\n\t\t\t'bar'\n\t\t);\n\t\t$this->session->cookie->set_flashdata($cdata);\n\t\t$this->session->native->set_flashdata($ndata);\n\n\t\t// Simulate page reload and verify independent messages\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEquals($cdata, $this->session->cookie->flashdata());\n\t\t$this->assertEquals($ndata, $this->session->native->flashdata());\n\n\t\t// Keep messages\n\t\t$this->session->cookie->keep_flashdata($kdata);\n\t\t$this->session->native->keep_flashdata($kdata);\n\n\t\t// Simulate next page reload and verify message persistence\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEquals($cdata, $this->session->cookie->flashdata());\n\t\t$this->assertEquals($ndata, $this->session->native->flashdata());\n\n\t\t// Simulate next page reload and verify absence of messages\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEmpty($this->session->cookie->flashdata());\n\t\t$this->assertEmpty($this->session->native->flashdata());\n\t}\n\n\t/**\n\t * Test the all_flashdata() function\n\t */\n\tpublic function test_all_flashdata()\n\t{\nreturn;\n\t\t// Set a specific series of data for each driver\n\t\t$cdata = array(\n\t\t\t'one' => 'first',\n\t\t\t'two' => 'second',\n\t\t\t'three' => 'third',\n\t\t\t'foo' => 'bar',\n\t\t\t'bar' => 'baz'\n\t\t);\n\t\t$ndata = array(\n\t\t\t'one' => 'gold',\n\t\t\t'two' => 'silver',\n\t\t\t'three' => 'bronze',\n\t\t\t'foo' => 'baz',\n\t\t\t'bar' => 'foo'\n\t\t);\n\t\t$this->session->cookie->set_flashdata($cdata);\n\t\t$this->session->native->set_flashdata($ndata);\n\n\t\t// Simulate page reload and make sure all values are present\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEquals($cdata, $this->session->cookie->flashdata());\n\t\t$this->assertEquals($ndata, $this->session->native->flashdata());\n\t}\n\n\t/**\n\t * Test the tempdata() functions\n\t */\n\tpublic function test_set_tempdata()\n\t{\nreturn;\n\t\t// Set tempdata message for each driver - 1 second timeout\n\t\t$key = 'tmptest';\n\t\t$cmsg = 'Some temp data';\n\t\t$this->session->cookie->set_tempdata($key, $cmsg, 1);\n\t\t$nmsg = 'Other temp data';\n\t\t$this->session->native->set_tempdata($key, $nmsg, 1);\n\n\t\t// Simulate page reload and verify independent messages\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertEquals($cmsg, $this->session->cookie->tempdata($key));\n\t\t$this->assertEquals($nmsg, $this->session->native->tempdata($key));\n\n\t\t// Wait 2 seconds, simulate page reload and verify message absence\n\t\tsleep(2);\n\t\t$this->session->cookie->reload();\n\t\t$this->session->native->reload();\n\t\t$this->assertNull($this->session->cookie->tempdata($key));\n\t\t$this->assertNull($this->session->native->tempdata($key));\n\t}\n\n\t/**\n\t * Test the unset_tempdata() function\n\t */\n\tpublic function test_unset_tempdata()\n\t{\nreturn;\n\t\t// Set tempdata message for each driver - 1 second timeout\n\t\t$key = 'utmptest';\n\t\t$cmsg = 'My temp data';\n\t\t$this->session->cookie->set_tempdata($key, $cmsg, 1);\n\t\t$nmsg = 'Your temp data';\n\t\t$this->session->native->set_tempdata($key, $nmsg, 1);\n\n\t\t// Verify independent messages\n\t\t$this->assertEquals($cmsg, $this->session->cookie->tempdata($key));\n\t\t$this->assertEquals($nmsg, $this->session->native->tempdata($key));\n\n\t\t// Unset data and verify message absence\n\t\t$this->session->cookie->unset_tempdata($key);\n\t\t$this->session->native->unset_tempdata($key);\n\t\t$this->assertNull($this->session->cookie->tempdata($key));\n\t\t$this->assertNull($this->session->native->tempdata($key));\n\t}\n\n\t/**\n\t * Test the sess_regenerate() function\n\t */\n\tpublic function test_sess_regenerate()\n\t{\nreturn;\n\t\t// Get current session id, regenerate, and compare\n\t\t// Cookie driver\n\t\t$oldid = $this->session->cookie->userdata('session_id');\n\t\t$this->session->cookie->sess_regenerate();\n\t\t$newid = $this->session->cookie->userdata('session_id');\n\t\t$this->assertNotEquals($oldid, $newid);\n\n\t\t// Native driver - bug #55267 (https://bugs.php.net/bug.php?id=55267) prevents testing this\n\t\t// $oldid = session_id();\n\t\t// $this->session->native->sess_regenerate();\n\t\t// $oldid = session_id();\n\t\t// $this->assertNotEquals($oldid, $newid);\n\t}\n\n\t/**\n\t * Test the sess_destroy() function\n\t */\n\tpublic function test_sess_destroy()\n\t{\nreturn;\n\t\t// Set a userdata message, destroy session, and verify absence\n\t\t$key = 'dsttest';\n\t\t$msg = 'More test data';\n\n\t\t// Cookie driver\n\t\t$this->session->cookie->set_userdata($key, $msg);\n\t\t$this->assertEquals($msg, $this->session->cookie->userdata($key));\n\t\t$this->session->cookie->sess_destroy();\n\t\t$this->assertNull($this->session->cookie->userdata($key));\n\n\t\t// Native driver\n\t\t$this->session->native->set_userdata($key, $msg);\n\t\t$this->assertEquals($msg, $this->session->native->userdata($key));\n\t\t$this->session->native->sess_destroy();\n\t\t$this->assertNull($this->session->native->userdata($key));\n\t}\n\n}\n" }, { "path": "tests/codeigniter/libraries/Table_test.php", "content": "table = new Mock_Libraries_Table();\n\t\t$this->ci_instance_var('table', $this->table);\n\t}\n\n\t// Setter Methods\n\t// --------------------------------------------------------------------\n\n\tpublic function test_set_template()\n\t{\n\t\t$this->assertFalse($this->table->set_template('not an array'));\n\n\t\t$template = array('a' => 'b');\n\n\t\t$this->table->set_template($template);\n\t\t$this->assertEquals($template, $this->table->template);\n\t}\n\n\tpublic function test_set_empty()\n\t{\n\t\t$this->table->set_empty('nada');\n\t\t$this->assertEquals('nada', $this->table->empty_cells);\n\t}\n\n\tpublic function test_set_caption()\n\t{\n\t\t$this->table->set_caption('awesome cap');\n\t\t$this->assertEquals('awesome cap', $this->table->caption);\n\t}\n\n\t/*\n\t * @depends\ttest_prep_args\n\t */\n\tpublic function test_set_heading()\n\t{\n\t\t// uses _prep_args internally, so we'll just do a quick\n\t\t// check to verify that func_get_args and prep_args are\n\t\t// being called.\n\n\t\t$this->table->set_heading('name', 'color', 'size');\n\n\t\t$this->assertEquals(\n\t\t\tarray(\n\t\t\t\tarray('data' => 'name'),\n\t\t\t\tarray('data' => 'color'),\n\t\t\t\tarray('data' => 'size')\n\t\t\t),\n\t\t\t$this->table->heading\n\t\t);\n\t}\n\n\t/*\n\t * @depends\ttest_prep_args\n\t */\n\tpublic function test_add_row()\n\t{\n\t\t// uses _prep_args internally, so we'll just do a quick\n\t\t// check to verify that func_get_args and prep_args are\n\t\t// being called.\n\n\t\t$this->table->add_row('my', 'pony', 'sings');\n\t\t$this->table->add_row('your', 'pony', 'stinks');\n\t\t$this->table->add_row('my pony', '>', 'your pony');\n\n\t\t$this->assertCount(3, $this->table->rows);\n\n\t\t$this->assertEquals(\n\t\t\tarray(\n\t\t\t\tarray('data' => 'your'),\n\t\t\t\tarray('data' => 'pony'),\n\t\t\t\tarray('data' => 'stinks')\n\t\t\t),\n\t\t\t$this->table->rows[1]\n\t\t);\n\t}\n\n\t// Uility Methods\n\t// --------------------------------------------------------------------\n\n\tpublic function test_prep_args()\n\t{\n\t\t$expected = array(\n\t\t\tarray('data' => 'name'),\n\t\t\tarray('data' => 'color'),\n\t\t\tarray('data' => 'size')\n\t\t);\n\n\t\t$this->assertEquals(\n\t\t\t$expected,\n\t\t\t$this->table->prep_args(array('name', 'color', 'size'))\n\t\t);\n\n\t\t// with cell attributes\n\t\t// need to add that new argument row to our expected outcome\n\t\t$expected[] = array('data' => 'weight', 'class' => 'awesome');\n\n\t\t$this->assertEquals(\n\t\t\t$expected,\n\t\t\t$this->table->prep_args(array('name', 'color', 'size', array('data' => 'weight', 'class' => 'awesome')))\n\t\t);\n\t}\n\n\tpublic function test_default_template_keys()\n\t{\n\t\t$keys = array(\n\t\t\t'table_open',\n\t\t\t'thead_open', 'thead_close',\n\t\t\t'heading_row_start', 'heading_row_end', 'heading_cell_start', 'heading_cell_end',\n\t\t\t'tbody_open', 'tbody_close',\n\t\t\t'row_start', 'row_end', 'cell_start', 'cell_end',\n\t\t\t'row_alt_start', 'row_alt_end', 'cell_alt_start', 'cell_alt_end',\n\t\t\t'table_close'\n\t\t);\n\n\t\tforeach ($keys as $key)\n\t\t{\n\t\t\t$this->assertArrayHasKey($key, $this->table->default_template());\n\t\t}\n\t}\n\n\tpublic function test_compile_template()\n\t{\n\t\t$this->assertFalse($this->table->set_template('invalid_junk'));\n\n\t\t// non default key\n\t\t$this->table->set_template(array('nonsense' => 'foo'));\n\t\t$this->table->compile_template();\n\n\t\t$this->assertArrayHasKey('nonsense', $this->table->template);\n\t\t$this->assertEquals('foo', $this->table->template['nonsense']);\n\n\t\t// override default\n\t\t$this->table->set_template(array('table_close' => ''));\n\t\t$this->table->compile_template();\n\n\t\t$this->assertArrayHasKey('table_close', $this->table->template);\n\t\t$this->assertEquals('', $this->table->template['table_close']);\n\t}\n\n\tpublic function test_make_columns()\n\t{\n\t\t// Test bogus parameters\n\t\t$this->assertFalse($this->table->make_columns('invalid_junk'));\n\t\t$this->assertFalse($this->table->make_columns(array()));\n\t\t$this->assertFalse($this->table->make_columns(array('one', 'two'), '2.5'));\n\n\t\t// Now on to the actual column creation\n\n\t\t$five_values = array(\n\t\t\t'Laura', 'Red', '15',\n\t\t\t'Katie', 'Blue'\n\t\t);\n\n\t\t// No column count - no changes to the array\n\t\t$this->assertEquals(\n\t\t\t$five_values,\n\t\t\t$this->table->make_columns($five_values)\n\t\t);\n\n\t\t// Column count of 3 leaves us with one  \n\t\t$this->assertEquals(\n\t\t\tarray(\n\t\t\t\tarray('Laura', 'Red', '15'),\n\t\t\t\tarray('Katie', 'Blue', ' ')\n\t\t\t),\n\t\t\t$this->table->make_columns($five_values, 3)\n\t\t);\n\t}\n\n\tpublic function test_clear()\n\t{\n\t\t$this->table->set_heading('Name', 'Color', 'Size');\n\n\t\t// Make columns changes auto_heading\n\t\t$rows = $this->table->make_columns(array(\n\t\t\t'Laura', 'Red', '15',\n\t\t\t'Katie', 'Blue'\n\t\t), 3);\n\n\t\tforeach ($rows as $row)\n\t\t{\n\t\t\t$this->table->add_row($row);\n\t\t}\n\n\t\t$this->assertFalse($this->table->auto_heading);\n\t\t$this->assertCount(3, $this->table->heading);\n\t\t$this->assertCount(2, $this->table->rows);\n\n\t\t$this->table->clear();\n\n\t\t$this->assertTrue($this->table->auto_heading);\n\t\t$this->assertEmpty($this->table->heading);\n\t\t$this->assertEmpty($this->table->rows);\n\t}\n\n\tpublic function test_set_from_array()\n\t{\n\t\t$data = array(\n\t\t\tarray('name', 'color', 'number'),\n\t\t\tarray('Laura', 'Red', '22'),\n\t\t\tarray('Katie', 'Blue')\n\t\t);\n\n\t\t$this->table->auto_heading = FALSE;\n\t\t$this->table->set_from_array($data);\n\t\t$this->assertEmpty($this->table->heading);\n\n\t\t$this->table->clear();\n\n\t\t$this->table->set_from_array($data);\n\t\t$this->assertCount(2, $this->table->rows);\n\n\t\t$expected = array(\n\t\t\tarray('data' => 'name'),\n\t\t\tarray('data' => 'color'),\n\t\t\tarray('data' => 'number')\n\t\t);\n\n\t\t$this->assertEquals($expected, $this->table->heading);\n\n\t\t$expected = array(\n\t\t\tarray('data' => 'Katie'),\n\t\t\tarray('data' => 'Blue'),\n\t\t);\n\n\t\t$this->assertEquals($expected, $this->table->rows[1]);\n\t}\n\n\tpublic function test_set_from_object()\n\t{\n\t\t// This needs to be passed by reference to CI_DB_result::__construct()\n\t\t$dummy = new stdClass();\n\t\t$dummy->conn_id = NULL;\n\t\t$dummy->result_id = NULL;\n\n\t\t$db_result = new DB_result_dummy($dummy);\n\n\t\t$this->table->set_from_db_result($db_result);\n\n\t\t$expected = array(\n\t\t\tarray('data' => 'name'),\n\t\t\tarray('data' => 'email')\n\t\t);\n\n\t\t$this->assertEquals($expected, $this->table->heading);\n\n\t\t$expected = array(\n\t\t\t'name' => array('data' => 'Foo Bar'),\n\t\t\t'email' => array('data' => 'foo@bar.com'),\n\t\t);\n\n\t\t$this->assertEquals($expected, $this->table->rows[1]);\n\t}\n\n\tpublic function test_generate()\n\t{\n\t\t// Prepare the data\n\t\t$data = array(\n\t\t\tarray('Name', 'Color', 'Size'),\n\t\t\tarray('Fred', 'Blue', 'Small'),\n\t\t\tarray('Mary', 'Red', 'Large'),\n\t\t\tarray('John', 'Green', 'Medium')\n\t\t);\n\n\t\t$table = $this->table->generate($data);\n\n\t\t// Test the table header\n\t\t$this->assertEquals(1, substr_count($table, 'Name'));\n\t\t$this->assertEquals(1, substr_count($table, 'Color'));\n\t\t$this->assertEquals(1, substr_count($table, 'Size'));\n\n\t\t// Test the first entry\n\t\t$this->assertEquals(1, substr_count($table, 'Fred'));\n\t\t$this->assertEquals(1, substr_count($table, 'Blue'));\n\t\t$this->assertEquals(1, substr_count($table, 'Small'));\n\t}\n\n}\n\n// We need this for the _set_from_db_result() test\nclass DB_result_dummy extends CI_DB_result\n{\n\tpublic function list_fields()\n\t{\n\t\treturn array('name', 'email');\n\t}\n\n\tpublic function result_array()\n\t{\n\t\treturn array(\n\t\t\tarray('name' => 'John Doe', 'email' => 'john@doe.com'),\n\t\t\tarray('name' => 'Foo Bar', 'email' => 'foo@bar.com')\n\t\t);\n\t}\n}\n" }, { "path": "tests/codeigniter/libraries/Typography_test.php", "content": "type = new CI_Typography();\n\t\t$this->ci_instance('type', $this->type);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Tests the format_characters() function.\n\t *\n\t * this can and should grow.\n\t */\n\tpublic function test_format_characters()\n\t{\n\t\t$strs = array(\n\t\t\t'\"double quotes\"' \t\t\t\t=> '“double quotes”',\n\t\t\t'\"testing\" in \"theory\" that is' => '“testing” in “theory” that is',\n\t\t\t\"Here's what I'm\" \t\t\t\t=> 'Here’s what I’m',\n\t\t\t'&' \t\t\t\t\t\t\t=> '&',\n\t\t\t'&' \t\t\t\t\t\t=> '&',\n\t\t\t' '\t\t\t\t\t\t=> ' ',\n\t\t\t'--'\t\t\t\t\t\t\t=> '—',\n\t\t\t'foo...'\t\t\t\t\t\t=> 'foo…',\n\t\t\t'foo..'\t\t\t\t\t\t\t=> 'foo..',\n\t\t\t'foo...bar.'\t\t\t\t\t=> 'foo…bar.',\n\t\t\t'test. new'\t\t\t\t\t=> 'test.  new',\n\t\t);\n\n\t\tforeach ($strs as $str => $expected)\n\t\t{\n\t\t\t$this->assertEquals($expected, $this->type->format_characters($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_nl2br_except_pre()\n\t{\n\t\t$str = <<\nI am inside a pre tag. Please don't mess with me.\n\nk?\n\n\nThat's my story and I'm sticking to it.\n\nThe End.\nEOH;\n\n\t\t$expected = <<\n
    \nI like to skip.
    \n
    \nJump
    \n
    \nand sing.
    \n
    \n
    \nI am inside a pre tag.  Please don't mess with me.\n\nk?\n

    \n
    \nThat's my story and I'm sticking to it.
    \n
    \nThe End.\nEOH;\n\n\t\t$this->assertEquals($expected, $this->type->nl2br_except_pre($str));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_auto_typography()\n\t{\n\t\t$this->_blank_string();\n\t\t$this->_standardize_new_lines();\n\t\t$this->_reduce_linebreaks();\n\t\t$this->_remove_comments();\n\t\t$this->_protect_pre();\n\t\t$this->_no_opening_block();\n\t\t$this->_protect_braced_quotes();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _blank_string()\n\t{\n\t\t// Test blank string\n\t\t$this->assertEquals('', $this->type->auto_typography(''));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _standardize_new_lines()\n\t{\n\t\t$strs = array(\n\t\t\t\"My string\\rhas return characters\"\t=> \"

    My string
    \\nhas return characters

    \",\n\t\t\t'This one does not!' \t\t\t\t=> '

    This one does not!

    '\n\t\t);\n\n\t\tforeach ($strs as $str => $expect)\n\t\t{\n\t\t\t$this->assertEquals($expect, $this->type->auto_typography($str));\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _reduce_linebreaks()\n\t{\n\t\t$str = \"This has way too many linebreaks.\\n\\n\\n\\nSee?\";\n\t\t$expect = \"

    This has way too many linebreaks.

    \\n\\n

    See?

    \";\n\n\t\t$this->assertEquals($expect, $this->type->auto_typography($str, TRUE));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _remove_comments()\n\t{\n\t\t$str = ' But no!';\n\t\t$expect = '

      But no!

    ';\n\n\t\t$this->assertEquals($expect, $this->type->auto_typography($str));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _protect_pre()\n\t{\n\t\t$str = '

    My Sentence

    var_dump($this);
    ';\n\t\t$expect = '

    My Sentence

    var_dump($this);
    ';\n\n\t\t$this->assertEquals($expect, $this->type->auto_typography($str));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tprivate function _no_opening_block()\n\t{\n\t\t$str = 'My Sentence
    var_dump($this);
    ';\n\t\t$expect = '

    My Sentence

    var_dump($this);
    ';\n\n\t\t$this->assertEquals($expect, $this->type->auto_typography($str));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function _protect_braced_quotes()\n\t{\n\t\t$this->type->protect_braced_quotes = TRUE;\n\n\t\t$str = 'Test {parse=\"foobar\"}';\n\t\t$expect = '

    Test {parse=\"foobar\"}

    ';\n\n\t\t$this->assertEquals($expect, $this->type->auto_typography($str));\n\n\t\t$this->type->protect_braced_quotes = FALSE;\n\n\t\t$str = 'Test {parse=\"foobar\"}';\n\t\t$expect = '

    Test {parse=“foobar”}

    ';\n\n\t\t$this->assertEquals($expect, $this->type->auto_typography($str));\n\t}\n\n}" }, { "path": "tests/codeigniter/libraries/Upload_test.php", "content": "ci_instance();\n\t\t$ci->upload = new CI_Upload();\n\t\t$ci->security = new Mock_Core_Security('UTF-8');\n\t\t$ci->lang = $this->getMockBuilder('CI_Lang')->setMethods(array('load', 'line'))->getMock();\n\t\t$ci->lang->expects($this->any())->method('line')->will($this->returnValue(FALSE));\n\t\t$this->upload = $ci->upload;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test___construct_initialize()\n\t{\n\t\t// via __construct\n\n\t\t$upload = new CI_Upload(\n\t\t\tarray(\n\t\t\t\t'file_name' => 'foo',\n\t\t\t\t'file_ext_tolower' => TRUE\n\t\t\t)\n\t\t);\n\n\t\t$reflection = new ReflectionClass($upload);\n\t\t$reflection = $reflection->getProperty('_file_name_override');\n\t\t$reflection->setAccessible(TRUE);\n\t\t$this->assertEquals('foo', $reflection->getValue($upload));\n\n\t\t$this->assertTrue($upload->file_ext_tolower);\n\n\t\t// reset (defaults to true)\n\n\t\t$upload->initialize(array('file_name' => 'bar'));\n\t\t$this->assertEquals('bar', $upload->file_name);\n\t\t$this->assertFalse($upload->file_ext_tolower);\n\n\t\t// no reset\n\n\t\t$upload->initialize(array('file_ext_tolower' => TRUE), FALSE);\n\t\t$this->assertTrue($upload->file_ext_tolower);\n\t\t$this->assertEquals('bar', $upload->file_name);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_do_upload()\n\t{\n\t\t$this->markTestSkipped(\"We can't test this at the moment because of the call to is_uploaded_file() in do_upload() which isn't supported by vfsStream.\");\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tfunction test_data()\n\t{\n\t\t$data = array(\n\t\t\t\t'file_name'\t\t=> 'hello.txt',\n\t\t\t\t'file_type'\t\t=> 'text/plain',\n\t\t\t\t'file_path'\t\t=> '/tmp/',\n\t\t\t\t'full_path'\t\t=> '/tmp/hello.txt',\n\t\t\t\t'raw_name'\t\t=> 'hello',\n\t\t\t\t'orig_name'\t\t=> 'hello.txt',\n\t\t\t\t'client_name'\t\t=> '',\n\t\t\t\t'file_ext'\t\t=> '.txt',\n\t\t\t\t'file_size'\t\t=> 100,\n\t\t\t\t'is_image'\t\t=> FALSE,\n\t\t\t\t'image_width'\t\t=> '',\n\t\t\t\t'image_height'\t\t=> '',\n\t\t\t\t'image_type'\t\t=> '',\n\t\t\t\t'image_size_str'\t=> ''\n\t\t\t);\n\n\t\t$this->upload->set_upload_path('/tmp/');\n\n\t\tforeach ($data as $k => $v)\n\t\t{\n\t\t\t$this->upload->{$k}\t= $v;\n\t\t}\n\n\t\t$this->assertEquals('hello.txt', $this->upload->data('file_name'));\n\t\t$this->assertEquals($data, $this->upload->data());\n\t}\n\n\tfunction test_set_upload_path()\n\t{\n\t\t$this->upload->set_upload_path('/tmp/');\n\t\t$this->assertEquals('/tmp/', $this->upload->upload_path);\n\n\t\t$this->upload->set_upload_path('/tmp');\n\t\t$this->assertEquals('/tmp/', $this->upload->upload_path);\n\t}\n\n\tfunction test_set_filename()\n\t{\n\t\t$dir = 'uploads';\n\t\t$isnew = 'helloworld.txt';\n\t\t$exists = 'hello-world.txt';\n\t\t$this->ci_vfs_create($exists, 'Hello world.', $this->ci_app_root, $dir);\n\t\t$path = $this->ci_vfs_path($dir.'/', APPPATH);\n\t\t$this->upload->file_ext = '.txt';\n\n\t\t$this->assertEquals($isnew, $this->upload->set_filename($path, $isnew));\n\t\t$this->assertEquals('hello-world1.txt', $this->upload->set_filename($path, $exists));\n\t}\n\n\tfunction test_set_max_filesize()\n\t{\n\t\t$this->upload->set_max_filesize(100);\n\t\t$this->assertEquals(100, $this->upload->max_size);\n\t}\n\n\tfunction test_set_max_filename()\n\t{\n\t\t$this->upload->set_max_filename(100);\n\t\t$this->assertEquals(100, $this->upload->max_filename);\n\t}\n\n\tfunction test_set_max_width()\n\t{\n\t\t$this->upload->set_max_width(100);\n\t\t$this->assertEquals(100, $this->upload->max_width);\n\t}\n\n\tfunction test_set_max_height()\n\t{\n\t\t$this->upload->set_max_height(100);\n\t\t$this->assertEquals(100, $this->upload->max_height);\n\t}\n\n\tfunction test_set_allowed_types()\n\t{\n\t\t$this->upload->set_allowed_types('*');\n\t\t$this->assertEquals('*', $this->upload->allowed_types);\n\n\t\t$this->upload->set_allowed_types('foo|bar');\n\t\t$this->assertEquals(array('foo', 'bar'), $this->upload->allowed_types);\n\t}\n\n\tfunction test_set_image_properties()\n\t{\n\t\t$this->upload->file_type = 'image/gif';\n\t\t$this->upload->file_temp = realpath(PROJECT_BASE.'tests/mocks/uploads/ci_logo.gif');\n\n\t\t$props = array(\n\t\t\t'image_width'\t=>\t170,\n\t\t\t'image_height'\t=>\t73,\n\t\t\t'image_type'\t=>\t'gif',\n\t\t\t'image_size_str'\t=>\t'width=\"170\" height=\"73\"'\n\t\t);\n\n\t\t$this->upload->set_image_properties($this->upload->file_temp);\n\n\t\t$this->assertEquals($props['image_width'], $this->upload->image_width);\n\t\t$this->assertEquals($props['image_height'], $this->upload->image_height);\n\t\t$this->assertEquals($props['image_type'], $this->upload->image_type);\n\t\t$this->assertEquals($props['image_size_str'], $this->upload->image_size_str);\n\t}\n\n\tfunction test_set_xss_clean()\n\t{\n\t\t$this->upload->set_xss_clean(TRUE);\n\t\t$this->assertTrue($this->upload->xss_clean);\n\n\t\t$this->upload->set_xss_clean(FALSE);\n\t\t$this->assertFalse($this->upload->xss_clean);\n\t}\n\n\tfunction test_is_image()\n\t{\n\t\t$this->upload->file_type = 'image/x-png';\n\t\t$this->assertTrue($this->upload->is_image());\n\n\t\t$this->upload->file_type = 'text/plain';\n\t\t$this->assertFalse($this->upload->is_image());\n\t}\n\n\tfunction test_is_allowed_filetype()\n\t{\n\t\t$this->upload->allowed_types = array('html', 'gif');\n\n\t\t$this->upload->file_ext = '.txt';\n\t\t$this->upload->file_type = 'text/plain';\n\t\t$this->assertFalse($this->upload->is_allowed_filetype(FALSE));\n\t\t$this->assertFalse($this->upload->is_allowed_filetype(TRUE));\n\n\t\t$this->upload->file_ext = '.html';\n\t\t$this->upload->file_type = 'text/html';\n\t\t$this->assertTrue($this->upload->is_allowed_filetype(FALSE));\n\t\t$this->assertTrue($this->upload->is_allowed_filetype(TRUE));\n\n\t\t$this->upload->file_temp = realpath(PROJECT_BASE.'tests/mocks/uploads/ci_logo.gif');\n\t\t$this->upload->file_ext = '.gif';\n\t\t$this->upload->file_type = 'image/gif';\n\t\t$this->assertTrue($this->upload->is_allowed_filetype());\n\t}\n\n\tfunction test_is_allowed_filesize()\n\t{\n\t\t$this->upload->max_size = 100;\n\t\t$this->upload->file_size = 99;\n\n\t\t$this->assertTrue($this->upload->is_allowed_filesize());\n\n\t\t$this->upload->file_size = 101;\n\t\t$this->assertFalse($this->upload->is_allowed_filesize());\n\t}\n\n\tfunction test_is_allowed_dimensions()\n\t{\n\t\t$this->upload->file_type = 'text/plain';\n\t\t$this->assertTrue($this->upload->is_allowed_dimensions());\n\n\t\t$this->upload->file_type = 'image/gif';\n\t\t$this->upload->file_temp = realpath(PROJECT_BASE.'tests/mocks/uploads/ci_logo.gif');\n\n\t\t$this->upload->max_width = 10;\n\t\t$this->assertFalse($this->upload->is_allowed_dimensions());\n\n\t\t$this->upload->max_width = 170;\n\t\t$this->upload->max_height = 10;\n\t\t$this->assertFalse($this->upload->is_allowed_dimensions());\n\n\t\t$this->upload->max_height = 73;\n\t\t$this->assertTrue($this->upload->is_allowed_dimensions());\n\t}\n\n\tfunction test_validate_upload_path()\n\t{\n\t\t$this->upload->upload_path = '';\n\t\t$this->assertFalse($this->upload->validate_upload_path());\n\n\t\t$dir = 'uploads';\n\t\t$this->ci_vfs_mkdir($dir);\n\t\t$this->upload->upload_path = $this->ci_vfs_path($dir);\n\t\t$this->assertTrue($this->upload->validate_upload_path());\n\t}\n\n\tfunction test_get_extension()\n\t{\n\t\t$this->assertEquals('.txt', $this->upload->get_extension('hello.txt'));\n\t\t$this->assertEquals('.htaccess', $this->upload->get_extension('.htaccess'));\n\t\t$this->assertEquals('', $this->upload->get_extension('hello'));\n\t}\n\n\tfunction test_limit_filename_length()\n\t{\n\t\t$this->assertEquals('hello.txt', $this->upload->limit_filename_length('hello.txt', 10));\n\t\t$this->assertEquals('hello.txt', $this->upload->limit_filename_length('hello-world.txt', 9));\n\t}\n\n\tfunction test_do_xss_clean()\n\t{\n\t\t$dir = 'uploads';\n\t\t$file1 = 'file1.txt';\n\t\t$file2 = 'file2.txt';\n\t\t$file3 = 'file3.txt';\n\t\t$this->ci_vfs_create($file1, 'The billy goat was waiting for them.', $this->ci_vfs_root, $dir);\n\t\t$this->ci_vfs_create($file2, '', $this->ci_vfs_root, $dir);\n\t\t$this->ci_vfs_create($file3, '', $this->ci_vfs_root, $dir);\n\n\t\t$this->upload->file_temp = $this->ci_vfs_path($file1, $dir);\n\t\t$this->assertTrue($this->upload->do_xss_clean());\n\n\t\t$this->upload->file_temp = $this->ci_vfs_path($file2, $dir);\n\t\t$this->assertFalse($this->upload->do_xss_clean());\n\n\t\t$this->upload->file_temp = $this->ci_vfs_path($file3, $dir);\n\t\t$this->assertFalse($this->upload->do_xss_clean());\n\n\t\t$this->upload->file_temp = realpath(PROJECT_BASE.'tests/mocks/uploads/ci_logo.gif');\n\t\t$this->assertTrue($this->upload->do_xss_clean());\n\t}\n\n\tfunction test_set_error()\n\t{\n\t\t$errors = array(\n\t\t\t'An error!'\n\t\t);\n\n\t\t$another = 'Another error!';\n\n\t\t$this->upload->set_error($errors);\n\t\t$this->assertEquals($errors, $this->upload->error_msg);\n\n\t\t$errors[] = $another;\n\t\t$this->upload->set_error($another);\n\t\t$this->assertEquals($errors, $this->upload->error_msg);\n\t}\n\n\tfunction test_display_errors()\n\t{\n\t\t$this->upload->error_msg[] = 'Error test';\n\t\t$this->assertEquals('

    Error test

    ', $this->upload->display_errors());\n\t}\n\n}\n" }, { "path": "tests/codeigniter/libraries/Useragent_test.php", "content": "_user_agent;\n\n\t\t$this->ci_vfs_clone('application/config/user_agents.php');\n\t\t$this->agent = new CI_User_agent();\n\t\t$this->ci_instance_var('agent', $this->agent);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_accept_lang()\n\t{\n\t\t$_SERVER['HTTP_ACCEPT_LANGUAGE'] = 'en';\n\t\t$this->assertTrue($this->agent->accept_lang());\n\t\tunset($_SERVER['HTTP_ACCEPT_LANGUAGE']);\n\t\t$this->assertTrue($this->agent->accept_lang('en'));\n\t\t$this->assertFalse($this->agent->accept_lang('fr'));\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_mobile()\n\t{\n\t\t// Mobile Not Set\n\t\t$_SERVER['HTTP_USER_AGENT'] = $this->_mobile_ua;\n\t\t$this->assertEquals('', $this->agent->mobile());\n\t\tunset($_SERVER['HTTP_USER_AGENT']);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_is_functions()\n\t{\n\t\t$this->assertTrue($this->agent->is_browser());\n\t\t$this->assertTrue($this->agent->is_browser('Safari'));\n\t\t$this->assertFalse($this->agent->is_browser('Firefox'));\n\t\t$this->assertFalse($this->agent->is_robot());\n\t\t$this->assertFalse($this->agent->is_mobile());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_referrer()\n\t{\n\t\t$_SERVER['HTTP_REFERER'] = 'http://codeigniter.com/userguide3/';\n\t\t$this->assertTrue($this->agent->is_referral());\n\t\t$this->assertEquals('http://codeigniter.com/userguide3/', $this->agent->referrer());\n\n\t\t$this->agent->referer = NULL;\n\t\tunset($_SERVER['HTTP_REFERER']);\n\t\t$this->assertFalse($this->agent->is_referral());\n\t\t$this->assertEquals('', $this->agent->referrer());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_agent_string()\n\t{\n\t\t$this->assertEquals($this->_user_agent, $this->agent->agent_string());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_browser_info()\n\t{\n\t\t$this->assertEquals('Mac OS X', $this->agent->platform());\n\t\t$this->assertEquals('Safari', $this->agent->browser());\n\t\t$this->assertEquals('533.20.27', $this->agent->version());\n\t\t$this->assertEquals('', $this->agent->robot());\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function test_charsets()\n\t{\n\t\t$_SERVER['HTTP_ACCEPT_CHARSET'] = 'utf8';\n\t\t$this->agent->charsets = array();\n\t\t$this->agent->charsets();\n\t\t$this->assertTrue($this->agent->accept_charset('utf8'));\n\t\t$this->assertFalse($this->agent->accept_charset('foo'));\n\t\t$this->assertEquals('utf8', $this->agent->charsets[0]);\n\n\t\t$_SERVER['HTTP_ACCEPT_CHARSET'] = '';\n\t\t$this->agent->charsets = array();\n\t\t$this->assertFalse($this->agent->accept_charset());\n\t\t$this->assertEquals('Undefined', $this->agent->charsets[0]);\n\n\t\t$_SERVER['HTTP_ACCEPT_CHARSET'] = 'iso-8859-5, unicode-1-1; q=0.8';\n\t\t$this->agent->charsets = array();\n\t\t$this->assertTrue($this->agent->accept_charset('iso-8859-5'));\n\t\t$this->assertTrue($this->agent->accept_charset('unicode-1-1'));\n\t\t$this->assertFalse($this->agent->accept_charset('foo'));\n\t\t$this->assertEquals('iso-8859-5', $this->agent->charsets[0]);\n\t\t$this->assertEquals('unicode-1-1', $this->agent->charsets[1]);\n\n\t\tunset($_SERVER['HTTP_ACCEPT_CHARSET']);\n\t}\n\n\tpublic function test_parse()\n\t{\n\t\t$new_agent = 'Mozilla/5.0 (Android; Mobile; rv:13.0) Gecko/13.0 Firefox/13.0';\n\t\t$this->agent->parse($new_agent);\n\n\t\t$this->assertEquals('Android', $this->agent->platform());\n\t\t$this->assertEquals('Firefox', $this->agent->browser());\n\t\t$this->assertEquals('13.0', $this->agent->version());\n\t\t$this->assertEquals('', $this->agent->robot());\n\t\t$this->assertEquals('Android', $this->agent->mobile());\n\t\t$this->assertEquals($new_agent, $this->agent->agent_string());\n\t\t$this->assertTrue($this->agent->is_browser());\n\t\t$this->assertFalse($this->agent->is_robot());\n\t\t$this->assertTrue($this->agent->is_mobile());\n\t\t$this->assertTrue($this->agent->is_mobile('android'));\n\t}\n\n}" }, { "path": "tests/mocks/autoloader.php", "content": " 'bm',\n\t\t'config'\t=> 'cfg',\n\t\t'hooks'\t\t=> 'ext',\n\t\t'utf8'\t\t=> 'uni',\n\t\t'router'\t=> 'rtr',\n\t\t'output'\t=> 'out',\n\t\t'security'\t=> 'sec',\n\t\t'input'\t\t=> 'in',\n\t\t'lang'\t\t=> 'lang',\n\t\t'loader'\t=> 'load',\n\t\t'model'\t\t=> 'model'\n\t);\n\n\t// --------------------------------------------------------------------\n\n\tpublic function __construct($name = null, array $data = array(), $dataName = '')\n\t{\n\t\tparent::__construct($name, $data, $dataName);\n\t\t$this->ci_instance = new stdClass();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function setUp()\n\t{\n\t\t// Setup VFS with base directories\n\t\t$this->ci_vfs_root = vfsStream::setup('');\n\t\t$this->ci_app_root = vfsStream::newDirectory('application')->at($this->ci_vfs_root);\n\t\t$this->ci_base_root = vfsStream::newDirectory('system')->at($this->ci_vfs_root);\n\t\t$this->ci_view_root = vfsStream::newDirectory('views')->at($this->ci_app_root);\n\t\t$this->ci_readonly_dir = vfsStream::newDirectory('readonly', 555)->at($this->ci_app_root);\n\n\t\tif (method_exists($this, 'set_up'))\n\t\t{\n\t\t\t$this->set_up();\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function tearDown()\n\t{\n\t\tif (method_exists($this, 'tear_down'))\n\t\t{\n\t\t\t$this->tear_down();\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic static function instance()\n\t{\n\t\treturn self::$ci_test_instance;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function ci_set_config($key = '', $val = '')\n\t{\n\t\t// Add test config\n\t\tif ( ! isset($this->ci_instance->config))\n\t\t{\n\t\t\t$this->ci_instance->config = new CI_TestConfig();\n\t\t}\n\n\t\t// Empty key means just do setup above\n\t\tif ($key === '')\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\tif (is_array($key))\n\t\t{\n\t\t\t$this->ci_instance->config->config = $key;\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->ci_instance->config->config[$key] = $val;\n\t\t}\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function ci_get_config()\n\t{\n\t\treturn isset($this->ci_instance->config) ? $this->ci_instance->config->config : array();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function ci_instance($obj = FALSE)\n\t{\n\t\tif ( ! is_object($obj))\n\t\t{\n\t\t\treturn $this->ci_instance;\n\t\t}\n\n\t\t$this->ci_instance = $obj;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function ci_instance_var($name, $obj = FALSE)\n\t{\n\t\tif ( ! is_object($obj))\n\t\t{\n\t\t\treturn $this->ci_instance->$name;\n\t\t}\n\n\t\t$this->ci_instance->$name =& $obj;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Grab a core class\n\t *\n\t * Loads the correct core class without extensions\n\t * and returns a reference to the class name in the\n\t * globals array with the correct key. This way the\n\t * test can modify the variable it assigns to and\n\t * still maintain the global.\n\t */\n\tpublic function &ci_core_class($name)\n\t{\n\t\t$name = strtolower($name);\n\n\t\tif (isset($this->global_map[$name]))\n\t\t{\n\t\t\t$class_name = ucfirst($name);\n\t\t\t$global_name = $this->global_map[$name];\n\t\t}\n\t\telseif (in_array($name, $this->global_map))\n\t\t{\n\t\t\t$class_name = ucfirst(array_search($name, $this->global_map));\n\t\t\t$global_name = $name;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tthrow new Exception('Not a valid core class.');\n\t\t}\n\n\t\tif ( ! class_exists('CI_'.$class_name))\n\t\t{\n\t\t\trequire_once SYSTEM_PATH.'core/'.$class_name.'.php';\n\t\t}\n\n\t\t$GLOBALS[strtoupper($global_name)] = 'CI_'.$class_name;\n\t\treturn $GLOBALS[strtoupper($global_name)];\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t// convenience function for global mocks\n\tpublic function ci_set_core_class($name, $obj)\n\t{\n\t\t$orig =& $this->ci_core_class($name);\n\t\t$orig = $obj;\n\t}\n\n\t/**\n\t * Create VFS directory\n\t *\n\t * @param\tstring\tDirectory name\n\t * @param\tobject\tOptional root to create in\n\t * @return\tobject\tNew directory object\n\t */\n\tpublic function ci_vfs_mkdir($name, $root = NULL)\n\t{\n\t\t// Check for root\n\t\tif ( ! $root)\n\t\t{\n\t\t\t$root = $this->ci_vfs_root;\n\t\t}\n\n\t\t// Return new directory object\n\t\treturn vfsStream::newDirectory($name)->at($root);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Create VFS content\n\t *\n\t * @param\tstring\tFile name\n\t * @param\tstring\tFile content\n\t * @param\tobject\tVFS directory object\n\t * @param\tmixed\tOptional subdirectory path or array of subs\n\t * @return\tvoid\n\t */\n\tpublic function ci_vfs_create($file, $content = '', $root = NULL, $path = NULL)\n\t{\n\t\t// Check for array\n\t\tif (is_array($file))\n\t\t{\n\t\t\tforeach ($file as $name => $content)\n\t\t\t{\n\t\t\t\t$this->ci_vfs_create($name, $content, $root, $path);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Assert .php extension if none given\n\t\tif (pathinfo($file, PATHINFO_EXTENSION) == '')\n\t\t{\n\t\t\t$file .= '.php';\n\t\t}\n\n\t\t// Build content\n\t\t$tree = array($file => $content);\n\n\t\t// Check for path\n\t\t$subs = array();\n\t\tif ($path)\n\t\t{\n\t\t\t// Explode if not array\n\t\t\t$subs = is_array($path) ? $path : explode('/', trim($path, '/'));\n\t\t}\n\n\t\t// Check for root\n\t\tif ( ! $root)\n\t\t{\n\t\t\t// Use base VFS root\n\t\t\t$root = $this->ci_vfs_root;\n\t\t}\n\n\t\t// Handle subdirectories\n\t\twhile (($dir = array_shift($subs)))\n\t\t{\n\t\t\t// See if subdir exists under current root\n\t\t\t$dir_root = $root->getChild($dir);\n\t\t\tif ($dir_root)\n\t\t\t{\n\t\t\t\t// Yes - recurse into subdir\n\t\t\t\t$root = $dir_root;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// No - put subdirectory back and quit\n\t\t\t\tarray_unshift($subs, $dir);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\t// Create any remaining subdirectories\n\t\tif ($subs)\n\t\t{\n\t\t\tforeach (array_reverse($subs) as $dir)\n\t\t\t{\n\t\t\t\t// Wrap content in subdirectory for creation\n\t\t\t\t$tree = array($dir => $tree);\n\t\t\t}\n\t\t}\n\n\t\t// Create tree\n\t\tvfsStream::create($tree, $root);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Clone a real file into VFS\n\t *\n\t * @param\tstring\tPath from base directory\n\t * @return\tbool\tTRUE on success, otherwise FALSE\n\t */\n\tpublic function ci_vfs_clone($path, $dest='')\n\t{\n\t\t// Check for array\n\t\tif (is_array($path))\n\t\t{\n\t\t\tforeach ($path as $file)\n\t\t\t{\n\t\t\t\t$this->ci_vfs_clone($file, $dest);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Get real file contents\n\t\t$content = file_get_contents(PROJECT_BASE.$path);\n\t\tif ($content === FALSE)\n\t\t{\n\t\t\t// Couldn't find file to clone\n\t\t\treturn FALSE;\n\t\t}\n\n\t\tif (empty($dest))\n\t\t{\n\t\t\t$dest = dirname($path);\n\t\t}\n\n\t\t$this->ci_vfs_create(basename($path), $content, NULL, $dest);\n\t\treturn TRUE;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Helper to get a VFS URL path\n\t *\n\t * @param\tstring\tPath\n\t * @param\tstring\tOptional base path\n\t * @return\tstring\tPath URL\n\t */\n\tpublic function ci_vfs_path($path, $base = '')\n\t{\n\t\t// Check for base path\n\t\tif ($base)\n\t\t{\n\t\t\t// Prepend to path\n\t\t\t$path = rtrim($base, '/').'/'.ltrim($path, '/');\n\n\t\t\t// Is it already in URL form?\n\t\t\tif (strpos($path, '://') !== FALSE)\n\t\t\t{\n\t\t\t\t// Done - return path\n\t\t\t\treturn $path;\n\t\t\t}\n\t\t}\n\n\t\t// Trim leading slash and return URL\n\t\treturn vfsStream::url(ltrim($path, '/'));\n\t}\n\n\t// --------------------------------------------------------------------\n\t// Internals\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * Overwrite runBare\n\t *\n\t * PHPUnit instantiates the test classes before\n\t * running them individually. So right before a test\n\t * runs we set our instance. Normally this step would\n\t * happen in setUp, but someone is bound to forget to\n\t * call the parent method and debugging this is no fun.\n\t */\n\tpublic function runBare()\n\t{\n\t\tself::$ci_test_instance = $this;\n\t\tparent::runBare();\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function helper($name)\n\t{\n\t\trequire_once(SYSTEM_PATH.'helpers/'.$name.'_helper.php');\n\t}\n\n\t// --------------------------------------------------------------------\n\n\tpublic function lang($name)\n\t{\n\t\trequire(SYSTEM_PATH.'language/english/'.$name.'_lang.php');\n\t\treturn $lang;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * This overload is useful to create a stub, that need to have a specific method.\n\t */\n\tpublic function __call($method, $args)\n\t{\n\t\tif ($this->{$method} instanceof Closure)\n\t\t{\n\t\t\treturn call_user_func_array($this->{$method},$args);\n\t\t}\n\n\t\treturn parent::__call($method, $args);\n\t}\n\n\tpublic function setExpectedException($exception_class, $exception_message = '', $exception_code = null)\n\t{\n\t\t$use_expect_exception = method_exists($this, 'expectException');\n\n\t\tif ($use_expect_exception)\n\t\t{\n\t\t\t$this->expectException($exception_class);\n\t\t\t$exception_message !== '' && $this->expectExceptionMessage($exception_message);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tparent::setExpectedException($exception_class, $exception_message, $exception_code);\n\t\t}\n\t}\n}\n" }, { "path": "tests/mocks/ci_testconfig.php", "content": "config[$key]) ? $this->config[$key] : FALSE;\n\t}\n\n\tpublic function load($file = '', $use_sections = FALSE, $fail_gracefully = FALSE)\n\t{\n\t\t$this->loaded[] = $file;\n\t\treturn TRUE;\n\t}\n\n}\n" }, { "path": "tests/mocks/core/common.php", "content": "ci_instance();\n\t\treturn $test;\n\t}\n}\n\n// --------------------------------------------------------------------\n\nif ( ! function_exists('get_config'))\n{\n\tfunction &get_config()\n\t{\n\t\t$test = CI_TestCase::instance();\n\t\t$config = $test->ci_get_config();\n\t\treturn $config;\n\t}\n}\n\nif ( ! function_exists('config_item'))\n{\n\tfunction config_item($item)\n\t{\n\t\t$config =& get_config();\n\n\t\tif ( ! isset($config[$item]))\n\t\t{\n\t\t\treturn NULL;\n\t\t}\n\n\t\treturn $config[$item];\n\t}\n}\n\nif ( ! function_exists('get_mimes'))\n{\n\t/**\n\t * Returns the MIME types array from config/mimes.php\n\t *\n\t * @return\tarray\n\t */\n\tfunction &get_mimes()\n\t{\n\t\tstatic $_mimes = array();\n\n\t\tif (empty($_mimes))\n\t\t{\n\t\t\t$path = realpath(PROJECT_BASE.'application/config/mimes.php');\n\t\t\tif (is_file($path))\n\t\t\t{\n\t\t\t\t$_mimes = include($path);\n\t\t\t}\n\t\t}\n\n\t\treturn $_mimes;\n\t}\n}\n\n// --------------------------------------------------------------------\n\n/*\nif ( ! function_exists('load_class'))\n{\n\tfunction load_class($class, $directory = 'libraries', $prefix = 'CI_')\n\t{\n\t\tif ($directory !== 'core' OR $prefix !== 'CI_')\n\t\t{\n\t\t\tthrow new Exception('Not Implemented: Non-core load_class()');\n\t\t}\n\n\t\t$test = CI_TestCase::instance();\n\n\t\t$obj =& $test->ci_core_class($class);\n\n\t\tif (is_string($obj))\n\t\t{\n\t\t\tthrow new Exception('Bad Isolation: Use ci_set_core_class to set '.$class);\n\t\t}\n\n\t\treturn $obj;\n\t}\n}\n*/\n\n// Clean up error messages\n// --------------------------------------------------------------------\n\nif ( ! function_exists('show_error'))\n{\n\tfunction show_error($message, $status_code = 500, $heading = 'An Error Was Encountered')\n\t{\n\t\tthrow new RuntimeException('CI Error: '.$message);\n\t}\n}\n\nif ( ! function_exists('show_404'))\n{\n\tfunction show_404($page = '', $log_error = TRUE)\n\t{\n\t\tthrow new RuntimeException('CI Error: 404');\n\t}\n}\n\nif ( ! function_exists('_exception_handler'))\n{\n\tfunction _exception_handler($severity, $message, $filepath, $line)\n\t{\n\t\tthrow new RuntimeException('CI Exception: '.$message.' | '.$filepath.' | '.$line);\n\t}\n}\n\n// We assume a few things about our environment ...\n// --------------------------------------------------------------------\nif ( ! function_exists('is_loaded'))\n{\n\tfunction &is_loaded()\n\t{\n\t\t$loaded = array();\n\t\treturn $loaded;\n\t}\n}\n\nif ( ! function_exists('log_message'))\n{\n\tfunction log_message($level, $message)\n\t{\n\t\treturn TRUE;\n\t}\n}\n\nif ( ! function_exists('set_status_header'))\n{\n\tfunction set_status_header($code = 200, $text = '')\n\t{\n\t\treturn TRUE;\n\t}\n}\n\nif ( ! function_exists('is_cli'))\n{\n\t// In order to test HTTP functionality, we need to lie about this\n\tfunction is_cli()\n\t{\n\t\treturn FALSE;\n\t}\n}" }, { "path": "tests/mocks/core/security.php", "content": "{'_'.$property}) ? $this->{'_'.$property} : NULL;\n\t}\n\n\tpublic function remove_evil_attributes($str, $is_image)\n\t{\n\t\treturn $this->_remove_evil_attributes($str, $is_image);\n\t}\n\n\t// Override inaccessible protected method\n\tpublic function __call($method, $params)\n\t{\n\t\tif (is_callable(array($this, '_'.$method)))\n\t\t{\n\t\t\treturn call_user_func_array(array($this, '_'.$method), $params);\n\t\t}\n\n\t\tthrow new BadMethodCallException('Method '.$method.' was not found');\n\t}\n\n}\n" }, { "path": "tests/mocks/core/uri.php", "content": "ci_core_class('cfg');\n\n\t\t// set predictable config values\n\t\t$test->ci_set_config(array(\n\t\t\t'index_page'\t\t=> 'index.php',\n\t\t\t'base_url'\t\t=> 'http://example.com/',\n\t\t\t'subclass_prefix'\t=> 'MY_',\n\t\t\t'enable_query_strings'\t=> FALSE,\n\t\t\t'permitted_uri_chars'\t=> 'a-z 0-9~%.:_\\-'\n\t\t));\n\n\t\t$this->config = new $cls;\n\n\t\tif ($this->config->item('enable_query_strings') !== TRUE OR is_cli())\n\t\t{\n\t\t\t$this->_permitted_uri_chars = $this->config->item('permitted_uri_chars');\n\t\t}\n\t}\n\n\tpublic function _set_permitted_uri_chars($value)\n\t{\n\t\t$this->_permitted_uri_chars = $value;\n\t}\n\n}" }, { "path": "tests/mocks/database/config/mysql.php", "content": " array(\n\t\t'dsn' => '',\n\t\t'hostname' => '127.0.0.1',\n\t\t'username' => 'travis',\n\t\t'password' => 'travis',\n\t\t'database' => 'ci_test',\n\t\t'dbdriver' => 'mysql'\n\t),\n\n\t// Database configuration with failover\n\t'mysql_failover' => array(\n\t\t'dsn' => '',\n\t\t'hostname' => '127.0.0.1',\n\t\t'username' => 'not_travis',\n\t\t'password' => 'wrong password',\n\t\t'database' => 'not_ci_test',\n\t\t'dbdriver' => 'mysql',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => '',\n\t\t\t\t'hostname' => '127.0.0.1',\n\t\t\t\t'username' => 'travis',\n\t\t\t\t'password' => 'travis',\n\t\t\t\t'database' => 'ci_test',\n\t\t\t\t'dbdriver' => 'mysql',\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/config/mysqli.php", "content": " array(\n\t\t'dsn' => '',\n\t\t'hostname' => '127.0.0.1',\n\t\t'username' => 'travis',\n\t\t'password' => 'travis',\n\t\t'database' => 'ci_test',\n\t\t'dbdriver' => 'mysqli'\n\t),\n\n\t// Database configuration with failover\n\t'mysqli_failover' => array(\n\t\t'dsn' => '',\n\t\t'hostname' => '127.0.0.1',\n\t\t'username' => 'not_travis',\n\t\t'password' => 'wrong password',\n\t\t'database' => 'not_ci_test',\n\t\t'dbdriver' => 'mysqli',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => '',\n\t\t\t\t'hostname' => '127.0.0.1',\n\t\t\t\t'username' => 'travis',\n\t\t\t\t'password' => 'travis',\n\t\t\t\t'database' => 'ci_test',\n\t\t\t\t'dbdriver' => 'mysqli',\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/config/pdo/mysql.php", "content": " array(\n\t\t'dsn' => 'mysql:host=127.0.0.1;dbname=ci_test',\n\t\t'hostname' => '127.0.0.1',\n\t\t'username' => 'travis',\n\t\t'password' => 'travis',\n\t\t'database' => 'ci_test',\n\t\t'dbdriver' => 'pdo',\n\t\t'subdriver' => 'mysql'\n\t),\n\n\t// Database configuration with failover\n\t'pdo/mysql_failover' => array(\n\t\t'dsn' => '',\n\t\t'hostname' => '127.0.0.1',\n\t\t'username' => 'not_travis',\n\t\t'password' => 'wrong password',\n\t\t'database' => 'not_ci_test',\n\t\t'dbdriver' => 'pdo',\n\t\t'subdriver' => 'mysql',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => 'mysql:host=127.0.0.1;dbname=ci_test',\n\t\t\t\t'hostname' => '127.0.0.1',\n\t\t\t\t'username' => 'travis',\n\t\t\t\t'password' => 'travis',\n\t\t\t\t'database' => 'ci_test',\n\t\t\t\t'dbdriver' => 'pdo',\n\t\t\t\t'subdriver' => 'mysql'\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/config/pdo/pgsql.php", "content": " array(\n\t\t'dsn' => 'pgsql:host=localhost;port=5432;dbname=ci_test;',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'postgres',\n\t\t'password' => 'postgres',\n\t\t'database' => 'ci_test',\n\t\t'dbdriver' => 'pdo',\n\t\t'subdriver' => 'pgsql'\n\t),\n\n\t// Database configuration with failover\n\t'pdo/pgsql_failover' => array(\n\t\t'dsn' => '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'not_travis',\n\t\t'password' => 'wrong password',\n\t\t'database' => 'not_ci_test',\n\t\t'dbdriver' => 'pdo',\n\t\t'subdriver' => 'pgsql',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => 'pgsql:host=localhost;port=5432;dbname=ci_test;',\n\t\t\t\t'hostname' => 'localhost',\n\t\t\t\t'username' => 'postgres',\n\t\t\t\t'password' => 'postgres',\n\t\t\t\t'database' => 'ci_test',\n\t\t\t\t'dbdriver' => 'pdo',\n\t\t\t\t'subdriver' => 'pgsql'\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/config/pdo/sqlite.php", "content": " array(\n\t\t'dsn' => 'sqlite:/'.realpath(__DIR__.'/../..').'/ci_test.sqlite',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'sqlite',\n\t\t'password' => 'sqlite',\n\t\t'database' => 'sqlite',\n\t\t'dbdriver' => 'pdo',\n\t\t'subdriver' => 'sqlite'\n\t),\n\n\t// Database configuration with failover\n\t'pdo/sqlite_failover' => array(\n\t\t'dsn' => 'sqlite:not_exists.sqlite',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'sqlite',\n\t\t'password' => 'sqlite',\n\t\t'database' => 'sqlite',\n\t\t'dbdriver' => 'pdo',\n\t\t'subdriver' => 'sqlite',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => 'sqlite:/'.realpath(__DIR__.'/../..').'/ci_test.sqlite',\n\t\t\t\t'hostname' => 'localhost',\n\t\t\t\t'username' => 'sqlite',\n\t\t\t\t'password' => 'sqlite',\n\t\t\t\t'database' => 'sqlite',\n\t\t\t\t'dbdriver' => 'pdo',\n\t\t\t\t'subdriver' => 'sqlite'\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/config/pgsql.php", "content": " array(\n\t\t'dsn' => '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'postgres',\n\t\t'password' => 'postgres',\n\t\t'database' => 'ci_test',\n\t\t'dbdriver' => 'postgre'\n\t),\n\n\t// Database configuration with failover\n\t'pgsql_failover' => array(\n\t\t'dsn' => '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'not_travis',\n\t\t'password' => 'wrong password',\n\t\t'database' => 'not_ci_test',\n\t\t'dbdriver' => 'postgre',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => '',\n\t\t\t\t'hostname' => 'localhost',\n\t\t\t\t'username' => 'postgres',\n\t\t\t\t'password' => 'postgres',\n\t\t\t\t'database' => 'ci_test',\n\t\t\t\t'dbdriver' => 'postgre',\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/config/sqlite.php", "content": " array(\n\t\t'dsn' => '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'sqlite',\n\t\t'password' => 'sqlite',\n\t\t'database' => realpath(__DIR__.'/..').'/ci_test.sqlite',\n\t\t'dbdriver' => 'sqlite3'\n\t),\n\n\t// Database configuration with failover\n\t'sqlite_failover' => array(\n\t\t'dsn' => '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'sqlite',\n\t\t'password' => 'sqlite',\n\t\t'database' => '../not_exists.sqlite',\n\t\t'dbdriver' => 'sqlite3',\n\t\t'failover' => array(\n\t\t\tarray(\n\t\t\t\t'dsn' => '',\n\t\t\t\t'hostname' => 'localhost',\n\t\t\t\t'username' => 'sqlite',\n\t\t\t\t'password' => 'sqlite',\n\t\t\t\t'database' => realpath(__DIR__.'/..').'/ci_test.sqlite',\n\t\t\t\t'dbdriver' => 'sqlite3'\n\t\t\t)\n\t\t)\n\t)\n);" }, { "path": "tests/mocks/database/db/driver.php", "content": "ci_db_driver = new $driver_class($config);\n\t\t}\n\t}\n\n\t/**\n\t * Overloading method, emulate the actual driver method (multiple inheritance workaround)\n\t */\n\tpublic function __call($method, $arguments)\n\t{\n\t\tif ( ! is_callable(array($this->ci_db_driver, $method)))\n\t\t{\n\t\t\tthrow new BadMethodCallException($method. ' not exists or not implemented');\n\t\t}\n\n\t\treturn call_user_func_array(array($this->ci_db_driver, $method), $arguments);\n\t}\n\n}\n\nclass CI_DB extends CI_DB_query_builder {}" }, { "path": "tests/mocks/database/db.php", "content": "config = $config;\n\t}\n\n\t/**\n\t * Build DSN connection string for DB driver instantiate process\n\t *\n\t * @param \tstring \tGroup name\n\t * @return \tstring \tDSN Connection string\n\t */\n\tpublic function set_dsn($group = 'default')\n\t{\n\t\tif ( ! isset($this->config[$group]))\n\t\t{\n\t\t\tthrow new InvalidArgumentException('Group '.$group.' not exists');\n\t\t}\n\n\t\tself::$dbdriver = $this->config[$group]['dbdriver'];\n\t\tif (isset($this->config[$group]['subdriver']))\n\t\t{\n\t\t\tself::$subdriver = $this->config[$group]['subdriver'];\n\t\t}\n\n\t\t$params = array(\n\t\t\t'dbprefix' => '',\n\t\t\t'pconnect' => FALSE,\n\t\t\t'db_debug' => FALSE,\n\t\t\t'cache_on' => FALSE,\n\t\t\t'cachedir' => '',\n\t\t\t'char_set' => 'utf8',\n\t\t\t'dbcollat' => 'utf8_general_ci',\n\t\t\t'swap_pre' => '',\n\t\t\t'stricton' => FALSE\n\t\t);\n\n\t\t$config = array_merge($this->config[$group], $params);\n\t\t$dsnstring = empty($config['dsn']) ? FALSE : $config['dsn'];\n\t\t$subdriver = empty($config['subdriver']) ? FALSE: $config['subdriver'];\n\t\t$failover = empty($config['failover']) ? FALSE : $config['failover'];\n\n\t\t$dsn = $config['dbdriver'].'://'.$config['username'].':'.$config['password']\n\t\t\t\t\t.'@'.$config['hostname'].'/'.$config['database'];\n\n\t\t// Build the parameter\n\t\t$other_params = array_slice($config, 6);\n\t\tif ($dsnstring) $other_params['dsn'] = $dsnstring;\n\t\tif ($subdriver) $other_params['subdriver'] = $subdriver;\n\t\tif ($failover) $other_params['failover'] = $failover;\n\n\t\treturn $dsn.'?'.http_build_query($other_params);\n\t}\n\n\t/**\n\t * Return a database config array\n\t *\n\t * @see \t./config\n\t * @param\tstring\tDriver based configuration\n\t * @return\tarray\n\t */\n\tpublic static function config($driver)\n\t{\n\t\t$dir = realpath(dirname(__FILE__)).DIRECTORY_SEPARATOR;\n\t\treturn include($dir.'config'.DIRECTORY_SEPARATOR.$driver.'.php');\n\t}\n\n\t/**\n\t * Main DB method wrapper\n\t *\n\t * @param \tstring\tGroup or DSN string\n\t * @param \tbool\n\t * @return \tobject\n\t */\n\tpublic static function DB($group, $query_builder = FALSE)\n\t{\n\t\t// Create dummy driver and builder files to \"load\" - the mocks have\n\t\t// already triggered autoloading of the real files\n\t\t$case = CI_TestCase::instance();\n\t\t$driver = self::$dbdriver;\n\t\t$subdriver = self::$subdriver;\n\t\t$case->ci_vfs_create(array(\n\t\t\t'DB_driver.php' => '',\n\t\t\t'DB_result.php' => '',\n\t\t\t'DB_forge.php' => '',\n\t\t\t'DB_query_builder.php' => ''\n\t\t), '', $case->ci_base_root, 'database');\n\t\tif (file_exists(SYSTEM_PATH.'database/drivers/'.$driver.'/'.$driver.'_driver.php'))\n\t\t{\n\t\t\t$case->ci_vfs_create(array(\n\t\t\t\t$driver.'_driver.php' => '',\n\t\t\t\t$driver.'_result.php' => '',\n\t\t\t\t$driver.'_forge.php' => ''\n\t\t\t), '', $case->ci_base_root, 'database/drivers/'.$driver);\n\t\t}\n\t\tif ($subdriver)\n\t\t{\n\t\t\t$case->ci_vfs_create(array(\n\t\t\t\t$driver.'_'.$subdriver.'_driver.php' => '',\n\t\t\t\t$driver.'_'.$subdriver.'_forge.php' => ''\n\t\t\t), '', $case->ci_base_root, 'database/drivers/'.$driver.'/subdrivers');\n\t\t}\n\n\t\tinclude_once(SYSTEM_PATH.'database/DB.php');\n\n\t\ttry\n\t\t{\n\t\t\t$db = DB($group, $query_builder);\n\t\t}\n\t\tcatch (Exception $e)\n\t\t{\n\t\t\tthrow new RuntimeException($e->getMessage());\n\t\t}\n\n\t\treturn $db;\n\t}\n\n}" }, { "path": "tests/mocks/database/drivers/mysql.php", "content": "='))\n\t\t\t{\n\t\t\t\terror_reporting(E_ALL & ~E_DEPRECATED);\n\t\t\t}\n\n\t\t\t$config = Mock_Database_DB::config($driver);\n\t\t\t$connection = new Mock_Database_DB($config);\n\t\t\t$db = Mock_Database_DB::DB($connection->set_dsn($driver), TRUE);\n\n\t\t\tCI_TestCase::instance()->ci_instance_var('db', $db);\n\n\t\t\t$loader = new CI_Loader();\n\t\t\t$loader->dbforge();\n\t\t\t$forge = CI_TestCase::instance()->ci_instance_var('dbforge');\n\n\t\t\tself::$db = $db;\n\t\t\tself::$forge = $forge;\n\t\t\tself::$driver = $driver;\n\t\t}\n\n\t\treturn self::$db;\n\t}\n\n\t/**\n\t * Create the dummy tables\n\t *\n\t * @return void\n\t */\n\tpublic static function create_tables()\n\t{\n\t\t// User Table\n\t\tself::$forge->add_field(array(\n\t\t\t'id' => array(\n\t\t\t\t'type' => 'INTEGER',\n\t\t\t\t'constraint' => 3\n\t\t\t),\n\t\t\t'name' => array(\n\t\t\t\t'type' => 'VARCHAR',\n\t\t\t\t'constraint' => 40\n\t\t\t),\n\t\t\t'email' => array(\n\t\t\t\t'type' => 'VARCHAR',\n\t\t\t\t'constraint' => 100\n\t\t\t),\n\t\t\t'country' => array(\n\t\t\t\t'type' => 'VARCHAR',\n\t\t\t\t'constraint' => 40\n\t\t\t)\n\t\t));\n\t\tself::$forge->add_key('id', TRUE);\n\t\tself::$forge->create_table('user', TRUE) OR show_error('Unable to create the `user` table');\n\n\t\t// Job Table\n\t\tself::$forge->add_field(array(\n\t\t\t'id' => array(\n\t\t\t\t'type' => 'INTEGER',\n\t\t\t\t'constraint' => 3\n\t\t\t),\n\t\t\t'name' => array(\n\t\t\t\t'type' => 'VARCHAR',\n\t\t\t\t'constraint' => 40\n\t\t\t),\n\t\t\t'description' => array(\n\t\t\t\t'type' => 'TEXT'\n\t\t\t)\n\t\t));\n\t\tself::$forge->add_key('id', TRUE);\n\t\tself::$forge->create_table('job', TRUE) OR show_error('Unable to create the `job` table');\n\n\t\t// Misc Table\n\t\tself::$forge->add_field(array(\n\t\t\t'id' => array(\n\t\t\t\t'type' => 'INTEGER',\n\t\t\t\t'constraint' => 3\n\t\t\t),\n\t\t\t'key' => array(\n\t\t\t\t'type' => 'VARCHAR',\n\t\t\t\t'constraint' => 40\n\t\t\t),\n\t\t\t'value' => array(\n\t\t\t\t'type' => 'TEXT'\n\t\t\t)\n\t\t));\n\t\tself::$forge->add_key('id', TRUE);\n\t\tself::$forge->create_table('misc', TRUE) OR show_error('Unable to create the `misc` table');\n\t}\n\n\t/**\n\t * Create the dummy datas\n\t *\n\t * @return void\n\t */\n\tpublic static function create_data()\n\t{\n\t\t// Job Data\n\t\t$data = array(\n\t\t\t'user' => array(\n\t\t\t\tarray('id' => 1, 'name' => 'Derek Jones', 'email' => 'derek@world.com', 'country' => 'US'),\n\t\t\t\tarray('id' => 2, 'name' => 'Ahmadinejad', 'email' => 'ahmadinejad@world.com', 'country' => 'Iran'),\n\t\t\t\tarray('id' => 3, 'name' => 'Richard A Causey', 'email' => 'richard@world.com', 'country' => 'US'),\n\t\t\t\tarray('id' => 4, 'name' => 'Chris Martin', 'email' => 'chris@world.com', 'country' => 'UK')\n\t\t\t),\n\t\t\t'job' => array(\n\t\t\t\tarray('id' => 1, 'name' => 'Developer', 'description' => 'Awesome job, but sometimes makes you bored'),\n\t\t\t\tarray('id' => 2, 'name' => 'Politician', 'description' => 'This is not really a job'),\n\t\t\t\tarray('id' => 3, 'name' => 'Accountant', 'description' => 'Boring job, but you will get free snack at lunch'),\n\t\t\t\tarray('id' => 4, 'name' => 'Musician', 'description' => 'Only Coldplay can actually called Musician')\n\t\t\t),\n\t\t\t'misc' => array(\n\t\t\t\tarray('id' => 1, 'key' => '\\\\xxxfoo456', 'value' => 'Entry with \\\\xxx'),\n\t\t\t\tarray('id' => 2, 'key' => '\\\\%foo456', 'value' => 'Entry with \\\\%'),\n\t\t\t\tarray('id' => 3, 'key' => 'spaces and tabs', 'value' => ' One two three\ttab')\n\t\t\t)\n\t\t);\n\n\t\tforeach ($data as $table => $dummy_data)\n\t\t{\n\t\t\tself::$db->truncate($table) OR show_error(\"Unable to truncate `{$table}` table\");\n\n\t\t\tforeach ($dummy_data as $single_dummy_data)\n\t\t\t{\n\t\t\t\tself::$db->insert($table, $single_dummy_data) OR show_error(\"Unable to insert data into `{$table}` table\");\n\t\t\t}\n\t\t}\n\t}\n\n}\n" }, { "path": "tests/mocks/libraries/driver.php", "content": "valid_drivers;\n\t\t}\n\n\t\t$this->valid_drivers = (array) $drivers;\n\t}\n\n\t/**\n\t * Get library name\n\t */\n\tpublic function get_name()\n\t{\n\t\treturn $this->lib_name;\n\t}\n}" }, { "path": "tests/mocks/libraries/encryption.php", "content": "_get_params($params);\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * get_key()\n\t *\n\t * Allows checking for key changes.\n\t */\n\tpublic function get_key()\n\t{\n\t\treturn $this->_key;\n\t}\n\n\t// --------------------------------------------------------------------\n\n\t/**\n\t * __driver_get_handle()\n\t *\n\t * Allows checking for _mcrypt_get_handle(), _openssl_get_handle()\n\t */\n\tpublic function __driver_get_handle($driver, $cipher, $mode)\n\t{\n\t\treturn $this->{'_'.$driver.'_get_handle'}($cipher, $mode);\n\t}\n\n}" }, { "path": "tests/mocks/libraries/session.php", "content": "_flashdata_sweep();\n\t\t$this->_flashdata_mark();\n\t\t$this->_tempdata_sweep();\n\t}\n}\n\n/**\n * Mock cookie driver to overload cookie setting\n */\nclass Mock_Libraries_Session_cookie extends CI_Session_cookie {\n\t/**\n\t * Overload _setcookie to manage $_COOKIE values, since actual cookies can't be set in unit testing\n\t */\n\tprotected function _setcookie($name, $value = '', $expire = 0, $path = '', $domain = '', $secure = FALSE, $httponly = FALSE)\n\t{\n\t\tif (empty($value) OR $expire <= time())\n\t\t{\n\t\t\tunset($_COOKIE[$name]);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$_COOKIE[$name] = $value;\n\t\t}\n\t}\n}\n\nclass Mock_Libraries_Session_native extends CI_Session_native {}" }, { "path": "tests/mocks/libraries/table.php", "content": "\n\n\n\t\n\t\t\n\t\t\t./codeigniter/core\n\t\t\t./codeigniter/helpers\n\t\t\t./codeigniter/libraries\n\t\t\n\t\n\t\n\t\t\n\t\t\t../system/\n\t\t\n\t\n\n" }, { "path": "tests/travis/mysql.phpunit.xml", "content": "\n\n\n\t\n \n \n\t\n\t\t\n\t\t\t../codeigniter\n\t\t\n\t\n\t\n \n ../../system\n \n\t\n" }, { "path": "tests/travis/mysqli.phpunit.xml", "content": "\n\n\n\t\n \n \n\t\n\t\t\n\t\t\t../codeigniter\n\t\t\n\t\n\t\n \n ../../system\n \n\t\n" }, { "path": "tests/travis/pdo/mysql.phpunit.xml", "content": "\n\n\n\t\n \n \n\t\n\t\t\n\t\t\t../../codeigniter\n\t\t\n\t\n\t\n \n ../../../system\n \n\t\n" }, { "path": "tests/travis/pdo/pgsql.phpunit.xml", "content": "\n\n\n\t\n \n \n\t\n\t\t\n\t\t\t../../codeigniter\n\t\t\n\t\n\t\n \n ../../../system\n \n\t\n" }, { "path": "tests/travis/pdo/sqlite.phpunit.xml", "content": "\n\n\n\t\n \n \n\t\n\t\t\n\t\t\t../../codeigniter\n\t\t\n\t\n\t\n \n ../../../system\n \n\t\n" }, { "path": "tests/travis/pgsql.phpunit.xml", "content": "\n\n\n\t\n \n \n\t\n\t\t\n\t\t\t../codeigniter\n\t\t\n\t\n\t\n \n ../../system\n \n\t\n" }, { "path": "tests/travis/sqlite.phpunit.xml", "content": "\n\n \n \n ../../system\n \n \n \n \n \n \n \n ../codeigniter\n \n \n\n" }, { "path": "user_guide_src/Makefile", "content": "# Makefile for Sphinx documentation\n#\n\n# You can set these variables from the command line.\nSPHINXOPTS =\nSPHINXBUILD = sphinx-build\nPAPER =\nBUILDDIR = build\n\n# Internal variables.\nPAPEROPT_a4 = -D latex_paper_size=a4\nPAPEROPT_letter = -D latex_paper_size=letter\nALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source\n\n.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest\n\nhelp:\n\t@echo \"Please use \\`make ' where is one of\"\n\t@echo \" html to make standalone HTML files\"\n\t@echo \" dirhtml to make HTML files named index.html in directories\"\n\t@echo \" singlehtml to make a single large HTML file\"\n\t@echo \" pickle to make pickle files\"\n\t@echo \" json to make JSON files\"\n\t@echo \" htmlhelp to make HTML files and a HTML help project\"\n\t@echo \" qthelp to make HTML files and a qthelp project\"\n\t@echo \" devhelp to make HTML files and a Devhelp project\"\n\t@echo \" epub to make an epub\"\n\t@echo \" latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter\"\n\t@echo \" latexpdf to make LaTeX files and run them through pdflatex\"\n\t@echo \" text to make text files\"\n\t@echo \" man to make manual pages\"\n\t@echo \" changes to make an overview of all changed/added/deprecated items\"\n\t@echo \" linkcheck to check all external links for integrity\"\n\t@echo \" doctest to run all doctests embedded in the documentation (if enabled)\"\n\nclean:\n\t-rm -rf $(BUILDDIR)/*\n\nhtml:\n\t$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html\n\t@echo\n\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)/html.\"\n\ndirhtml:\n\t$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml\n\t@echo\n\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)/dirhtml.\"\n\nsinglehtml:\n\t$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml\n\t@echo\n\t@echo \"Build finished. The HTML page is in $(BUILDDIR)/singlehtml.\"\n\npickle:\n\t$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle\n\t@echo\n\t@echo \"Build finished; now you can process the pickle files.\"\n\njson:\n\t$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json\n\t@echo\n\t@echo \"Build finished; now you can process the JSON files.\"\n\nhtmlhelp:\n\t$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp\n\t@echo\n\t@echo \"Build finished; now you can run HTML Help Workshop with the\" \\\n\t \".hhp project file in $(BUILDDIR)/htmlhelp.\"\n\nqthelp:\n\t$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp\n\t@echo\n\t@echo \"Build finished; now you can run \"qcollectiongenerator\" with the\" \\\n\t \".qhcp project file in $(BUILDDIR)/qthelp, like this:\"\n\t@echo \"# qcollectiongenerator $(BUILDDIR)/qthelp/CodeIgniter.qhcp\"\n\t@echo \"To view the help file:\"\n\t@echo \"# assistant -collectionFile $(BUILDDIR)/qthelp/CodeIgniter.qhc\"\n\ndevhelp:\n\t$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp\n\t@echo\n\t@echo \"Build finished.\"\n\t@echo \"To view the help file:\"\n\t@echo \"# mkdir -p $$HOME/.local/share/devhelp/CodeIgniter\"\n\t@echo \"# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/CodeIgniter\"\n\t@echo \"# devhelp\"\n\nepub:\n\t$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub\n\t@echo\n\t@echo \"Build finished. The epub file is in $(BUILDDIR)/epub.\"\n\nlatex:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo\n\t@echo \"Build finished; the LaTeX files are in $(BUILDDIR)/latex.\"\n\t@echo \"Run \\`make' in that directory to run these through (pdf)latex\" \\\n\t \"(use \\`make latexpdf' here to do that automatically).\"\n\nlatexpdf:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo \"Running LaTeX files through pdflatex...\"\n\tmake -C $(BUILDDIR)/latex all-pdf\n\t@echo \"pdflatex finished; the PDF files are in $(BUILDDIR)/latex.\"\n\ntext:\n\t$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text\n\t@echo\n\t@echo \"Build finished. The text files are in $(BUILDDIR)/text.\"\n\nman:\n\t$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man\n\t@echo\n\t@echo \"Build finished. The manual pages are in $(BUILDDIR)/man.\"\n\nchanges:\n\t$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes\n\t@echo\n\t@echo \"The overview file is in $(BUILDDIR)/changes.\"\n\nlinkcheck:\n\t$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck\n\t@echo\n\t@echo \"Link check complete; look for any errors in the above output \" \\\n\t \"or in $(BUILDDIR)/linkcheck/output.txt.\"\n\ndoctest:\n\t$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest\n\t@echo \"Testing of doctests in the sources finished, look at the \" \\\n\t \"results in $(BUILDDIR)/doctest/output.txt.\"\n" }, { "path": "user_guide_src/README.rst", "content": "######################\nCodeIgniter User Guide\n######################\n\n******************\nSetup Instructions\n******************\n\nThe CodeIgniter user guide uses Sphinx to manage the documentation and\noutput it to various formats. Pages are written in human-readable\n`ReStructured Text `_ format.\n\nPrerequisites\n=============\n\nSphinx requires Python 2.7. If you are on OS X, then you already have Python.\nYou can confirm in a Terminal window by executing the ``python`` command\nwithout any parameters. It should load up and tell you which version you have\ninstalled.\n\nNote: If you're not on Python 2.7, then you must upgrade. E.g. Install 2.7.2\nfrom https://python.org/download/releases/2.7.2/\n\nInstallation\n============\n\n1. Install `easy_install `_\n2. ``easy_install \"sphinx==1.6.3\"``\n3. ``easy_install \"sphinxcontrib-phpdomain==0.1.3.post1\"``\n4. Install the CI Lexer which allows PHP, HTML, CSS, and JavaScript syntax highlighting in code examples (see *cilexer/README*)\n5. ``cd user_guide_src``\n6. ``make html``\n\nEditing and Creating Documentation\n==================================\n\nAll of the source files exist under *source/* and is where you will add new\ndocumentation or modify existing documentation. Just as with code changes,\nwe recommend working from feature branches and making pull requests to\nthe *develop* branch of this repo.\n\nSo where's the HTML?\n====================\n\nObviously, the HTML documentation is what we care most about, as it is the\nprimary documentation that our users encounter. Since revisions to the built\nfiles are not of value, they are not under source control. This also allows\nyou to regenerate as necessary if you want to \"preview\" your work. Generating\nthe HTML is very simple. From the root directory of your user guide repo\nfork issue the command you used at the end of the installation instructions::\n\n\tmake html\n\nYou will see it do a whiz-bang compilation, at which point the fully rendered\nuser guide and images will be in *build/html/*. After the HTML has been built,\neach successive build will only rebuild files that have changed, saving\nconsiderable time. If for any reason you want to \"reset\" your build files,\nsimply delete the *build* folder's contents and rebuild.\n\n***************\nStyle Guideline\n***************\n\nPlease refer to source/documentation/index.rst for general guidelines for\nusing Sphinx to document CodeIgniter.\n" }, { "path": "user_guide_src/cilexer/README", "content": "To install the CodeIgniter Lexer to Pygments, run:\n\n\tsudo python setup.py install\n\nConfirm with\n\n\tpygmentize -L\n\t\n\nYou should see in the lexer output:\n\n* ci, codeigniter:\n CodeIgniter (filenames *.html, *.css, *.php, *.xml, *.static)\n\nYou will need to run setup.py and install the cilexer package anytime after cilexer/cilexer.py is updated\n\nNOTE: Depending on how you installed Sphinx and Pygments,\nyou may be installing to the wrong version. \nIf you need to install to a different version of python\nspecify its path when using setup.py, e.g.:\n\n\tsudo /usr/bin/python2.5 setup.py install" }, { "path": "user_guide_src/cilexer/cilexer/__init__.py", "content": "\n" }, { "path": "user_guide_src/cilexer/cilexer/cilexer.py", "content": "# CodeIgniter\n# https://codeigniter.com\n#\n# An open source application development framework for PHP\n#\n# This content is released under the MIT License (MIT)\n#\n# Copyright (c) 2014 - 2017, British Columbia Institute of Technology\n#\n# Permission is hereby granted, free of charge, to any person obtaining a copy\n# of this software and associated documentation files (the \"Software\"), to deal\n# in the Software without restriction, including without limitation the rights\n# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the Software is\n# furnished to do so, subject to the following conditions:\n#\n# The above copyright notice and this permission notice shall be included in\n# all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n# THE SOFTWARE.\n#\n# Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)\n# Copyright (c) 2014 - 2016, British Columbia Institute of Technology (https://bcit.ca/)\n#\n# https://opensource.org/licenses/MIT\tMIT License\n\nimport re\nimport copy\n\nfrom pygments.lexer import DelegatingLexer\nfrom pygments.lexers.web import PhpLexer, HtmlLexer\n\n__all__ = ['CodeIgniterLexer']\n\n\nclass CodeIgniterLexer(DelegatingLexer):\n \"\"\"\n Handles HTML, PHP, JavaScript, and CSS is highlighted\n PHP is highlighted with the \"startline\" option\n \"\"\"\n\n name = 'CodeIgniter'\n aliases = ['ci', 'codeigniter']\n filenames = ['*.html', '*.css', '*.php', '*.xml', '*.static']\n mimetypes = ['text/html', 'application/xhtml+xml']\n\n def __init__(self, **options):\n super(CodeIgniterLexer, self).__init__(HtmlLexer,\n PhpLexer,\n startinline=True)\n" }, { "path": "user_guide_src/cilexer/setup.py", "content": "\"\"\"\nInstall and setup CodeIgniter highlighting for Pygments.\n\"\"\"\n\nfrom setuptools import setup\n\nentry_points = \"\"\"\n[pygments.lexers]\ncilexer = cilexer.cilexer:CodeIgniterLexer\n\"\"\"\n\nsetup(\n name='pycilexer',\n version='0.1',\n description=__doc__,\n author=\"EllisLab, Inc.\",\n packages=['cilexer'],\n install_requires=(\n 'sphinx >= 1.0.7',\n 'sphinxcontrib-phpdomain >= 0.1.3-1'\n ),\n entry_points=entry_points\n)\n" }, { "path": "user_guide_src/source/DCO.rst", "content": "#####################################\nDeveloper's Certificate of Origin 1.1\n#####################################\n\nBy making a contribution to this project, I certify that:\n\n(1)\tThe contribution was created in whole or in part by me and I\n\thave the right to submit it under the open source license\n\tindicated in the file; or\n\n(2)\tThe contribution is based upon previous work that, to the best\n\tof my knowledge, is covered under an appropriate open source\n\tlicense and I have the right under that license to submit that\n\twork with modifications, whether created in whole or in part\n\tby me, under the same open source license (unless I am\n\tpermitted to submit under a different license), as indicated\n\tin the file; or\n\n(3)\tThe contribution was provided directly to me by some other\n\tperson who certified (1), (2) or (3) and I have not modified\n\tit.\n\n(4)\tI understand and agree that this project and the contribution\n\tare public and that a record of the contribution (including all\n\tpersonal information I submit with it, including my sign-off) is\n\tmaintained indefinitely and may be redistributed consistent with\n\tthis project or the open source license(s) involved.\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/LICENSE", "content": "The MIT License (MIT)\n\nCopyright (c) 2013 Dave Snider\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/__init__.py", "content": "\"\"\"Sphinx ReadTheDocs theme.\n\nFrom https://github.com/ryan-roemer/sphinx-bootstrap-theme.\n\n\"\"\"\nimport os\n\nVERSION = (0, 1, 5)\n\n__version__ = \".\".join(str(v) for v in VERSION)\n__version_full__ = __version__\n\n\ndef get_html_theme_path():\n \"\"\"Return list of HTML theme paths.\"\"\"\n cur_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))\n return cur_dir\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/breadcrumbs.html", "content": "
    \n \n
    \n
    \n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/footer.html", "content": "
    \n {% if next or prev %}\n
    \n {% if next %}\n Next \n {% endif %}\n {% if prev %}\n Previous\n {% endif %}\n
    \n {% endif %}\n\n
    \n\n
    \n

    \n {%- if show_copyright %}\n {%- if hasdoc('copyright') %}\n {% trans path=pathto('copyright'), copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %}\n {%- else %}\n {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %}\n {%- endif %}\n {%- endif %}\n\n {%- if last_updated %}\n {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}\n {%- endif %}\n

    \n
    \n\n {% trans %}Built with Sphinx using a theme provided by Read the Docs{% endtrans %}.\n \n
    \n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/layout.html", "content": "{# TEMPLATE VAR SETTINGS #}\n{%- set url_root = pathto('', 1) %}\n{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}\n{%- if not embedded and docstitle %}\n {%- set titlesuffix = \" — \"|safe + docstitle|e %}\n{%- else %}\n {%- set titlesuffix = \"\" %}\n{%- endif %}\n\n\n\n \n\n \n \n {% block htmltitle %}\n {{ title|striptags|e }}{{ titlesuffix }}\n {% endblock %}\n\n {# FAVICON #}\n {% if favicon %}\n \n {% endif %}\n\n {# CSS #}\n \n\n {# OPENSEARCH #}\n {% if not embedded %}\n {% if use_opensearch %}\n \n {% endif %}\n\n {% endif %}\n\n {# RTD hosts this file, so just load on non RTD builds #}\n {% if not READTHEDOCS %}\n \n {% endif %}\n\n {% for cssfile in css_files %}\n \n {% endfor %}\n\n {%- block linktags %}\n {%- if hasdoc('about') %}\n \n {%- endif %}\n {%- if hasdoc('genindex') %}\n \n {%- endif %}\n {%- if hasdoc('search') %}\n \n {%- endif %}\n {%- if hasdoc('copyright') %}\n \n {%- endif %}\n \n {%- if parents %}\n \n {%- endif %}\n {%- if next %}\n \n {%- endif %}\n {%- if prev %}\n \n {%- endif %}\n {%- endblock %}\n {%- block extrahead %} {% endblock %}\n\n {# Keep modernizr in head - http://modernizr.com/docs/#installing #}\n \n\n\n\n\n\n {% include \"pulldown.html\" %}\n\n
    \n\n {# SIDE NAV, TOGGLES ON MOBILE #}\n \n\n
    \n\n {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}\n \n\n\n {# PAGE CONTENT #}\n
    \n
    \n {% include \"breadcrumbs.html\" %}\n
    \n {% block body %}{% endblock %}\n
    \n {% include \"footer.html\" %}\n
    \n
    \n\n
    \n\n
    \n {% include \"versions.html\" %}\n\n {% if not embedded %}\n\n \n {%- for scriptfile in script_files %}\n \n {%- endfor %}\n\n {% endif %}\n\n {# RTD hosts this file, so just load on non RTD builds #}\n {% if not READTHEDOCS %}\n \n {% endif %}\n\n {# STICKY NAVIGATION #}\n {% if theme_sticky_navigation %}\n \n {% endif %}\n\n {%- block footer %} {% endblock %}\n\n\n\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/layout_old.html", "content": "{#\n basic/layout.html\n ~~~~~~~~~~~~~~~~~\n\n Master layout template for Sphinx themes.\n\n :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.\n :license: BSD, see LICENSE for details.\n#}\n{%- block doctype -%}\n\n{%- endblock %}\n{%- set reldelim1 = reldelim1 is not defined and ' »' or reldelim1 %}\n{%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %}\n{%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and\n (sidebars != []) %}\n{%- set url_root = pathto('', 1) %}\n{# XXX necessary? #}\n{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}\n{%- if not embedded and docstitle %}\n {%- set titlesuffix = \" — \"|safe + docstitle|e %}\n{%- else %}\n {%- set titlesuffix = \"\" %}\n{%- endif %}\n\n{%- macro relbar() %}\n
    \n

    {{ _('Navigation') }}

    \n
      \n {%- for rellink in rellinks %}\n
    • \n {{ rellink[3] }}\n {%- if not loop.first %}{{ reldelim2 }}{% endif %}
      • \n {%- endfor %}\n {%- block rootrellink %}\n
    • {{ shorttitle|e }}{{ reldelim1 }}
      • \n {%- endblock %}\n {%- for parent in parents %}\n
    • {{ parent.title }}{{ reldelim1 }}
      • \n {%- endfor %}\n {%- block relbaritems %} {% endblock %}\n
    \n
    \n{%- endmacro %}\n\n{%- macro sidebar() %}\n {%- if render_sidebar %}\n
    \n
    \n {%- block sidebarlogo %}\n {%- if logo %}\n

    \n \"Logo\"/\n

    \n {%- endif %}\n {%- endblock %}\n {%- if sidebars != None %}\n {#- new style sidebar: explicitly include/exclude templates #}\n {%- for sidebartemplate in sidebars %}\n {%- include sidebartemplate %}\n {%- endfor %}\n {%- else %}\n {#- old style sidebars: using blocks -- should be deprecated #}\n {%- block sidebartoc %}\n {%- include \"localtoc.html\" %}\n {%- endblock %}\n {%- block sidebarrel %}\n {%- include \"relations.html\" %}\n {%- endblock %}\n {%- block sidebarsourcelink %}\n {%- include \"sourcelink.html\" %}\n {%- endblock %}\n {%- if customsidebar %}\n {%- include customsidebar %}\n {%- endif %}\n {%- block sidebarsearch %}\n {%- include \"searchbox.html\" %}\n {%- endblock %}\n {%- endif %}\n
    \n
    \n {%- endif %}\n{%- endmacro %}\n\n{%- macro script() %}\n \n {%- for scriptfile in script_files %}\n \n {%- endfor %}\n{%- endmacro %}\n\n{%- macro css() %}\n \n \n {%- for cssfile in css_files %}\n \n {%- endfor %}\n{%- endmacro %}\n\n\n \n \n {{ metatags }}\n {%- block htmltitle %}\n {{ title|striptags|e }}{{ titlesuffix }}\n {%- endblock %}\n {{ css() }}\n {%- if not embedded %}\n {{ script() }}\n {%- if use_opensearch %}\n \n {%- endif %}\n {%- if favicon %}\n \n {%- endif %}\n {%- endif %}\n{%- block linktags %}\n {%- if hasdoc('about') %}\n \n {%- endif %}\n {%- if hasdoc('genindex') %}\n \n {%- endif %}\n {%- if hasdoc('search') %}\n \n {%- endif %}\n {%- if hasdoc('copyright') %}\n \n {%- endif %}\n \n {%- if parents %}\n \n {%- endif %}\n {%- if next %}\n \n {%- endif %}\n {%- if prev %}\n \n {%- endif %}\n{%- endblock %}\n{%- block extrahead %} {% endblock %}\n \n \n{%- block header %}{% endblock %}\n\n{%- block relbar1 %}{{ relbar() }}{% endblock %}\n\n{%- block content %}\n {%- block sidebar1 %} {# possible location for sidebar #} {% endblock %}\n\n
    \n {%- block document %}\n
    \n {%- if render_sidebar %}\n
    \n {%- endif %}\n
    \n {% block body %} {% endblock %}\n
    \n {%- if render_sidebar %}\n
    \n {%- endif %}\n
    \n {%- endblock %}\n\n {%- block sidebar2 %}{{ sidebar() }}{% endblock %}\n
    \n
    \n{%- endblock %}\n\n{%- block relbar2 %}{{ relbar() }}{% endblock %}\n\n{%- block footer %}\n
    \n {%- if show_copyright %}\n {%- if hasdoc('copyright') %}\n {% trans path=pathto('copyright'), copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %}\n {%- else %}\n {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %}\n {%- endif %}\n {%- endif %}\n {%- if last_updated %}\n {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}\n {%- endif %}\n {%- if show_sphinx %}\n {% trans sphinx_version=sphinx_version|e %}Created using Sphinx {{ sphinx_version }}.{% endtrans %}\n {%- endif %}\n
    \n

    asdf asdf asdf asdf 22

    \n{%- endblock %}\n \n\n\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/pulldown.html", "content": "
    \n
    \n {% block ciNav %}\n {% set toctree = toctree(maxdepth=2, collapse=False, includehidden=False) %}\n {% if toctree %}\n
    \n {{ toctree }}\n
    \n {% endif %}\n {% endblock %}\n
    \n
    \n
    \n \n \"Toggle\n \n
    \n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/search.html", "content": "{#\n basic/search.html\n ~~~~~~~~~~~~~~~~~\n\n Template for the search page.\n\n :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.\n :license: BSD, see LICENSE for details.\n#}\n{%- extends \"layout.html\" %}\n{% set title = _('Search') %}\n{% set script_files = script_files + ['_static/searchtools.js'] %}\n{% block footer %}\n \n {# this is used when loading the search index using $.ajax fails,\n such as on Chrome for documents on localhost #}\n \n {{ super() }}\n{% endblock %}\n{% block body %}\n \n\n {% if search_performed %}\n

    {{ _('Search Results') }}

    \n {% if not search_results %}\n

    {{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\\'ve selected enough categories.') }}

    \n {% endif %}\n {% endif %}\n
    \n {% if search_results %}\n
      \n {% for href, caption, context in search_results %}\n
    • \n {{ caption }}\n

      {{ context|e }}

      \n
      • \n {% endfor %}\n
    \n {% endif %}\n
    \n{% endblock %}\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/searchbox.html", "content": "{%- if builder != 'singlehtml' %}\n
    \n
    \n \n \n \n
    \n
    \n{%- endif %}\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/static/css/badge_only.css", "content": ".fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:\"\"}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url(\"../font/fontawesome_webfont.eot\");src:url(\"../font/fontawesome_webfont.eot?#iefix\") format(\"embedded-opentype\"),url(\"../font/fontawesome_webfont.woff\") format(\"woff\"),url(\"../font/fontawesome_webfont.ttf\") format(\"truetype\"),url(\"../font/fontawesome_webfont.svg#FontAwesome\") format(\"svg\")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:0.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:\"\"}.icon-book:before{content:\"\"}.fa-caret-down:before{content:\"\"}.icon-caret-down:before{content:\"\"}.fa-caret-up:before{content:\"\"}.icon-caret-up:before{content:\"\"}.fa-caret-left:before{content:\"\"}.icon-caret-left:before{content:\"\"}.fa-caret-right:before{content:\"\"}.icon-caret-right:before{content:\"\"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:\"\"}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}\n/*# sourceMappingURL=badge_only.css.map */\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/static/css/citheme.css", "content": "@import 'theme.css';\n\n.highlighted {\n\tpadding: 0px !important;\n\tfont-weight: inherit !important;\n\tbackground-color: #f1d40f !important;\n}\n\n#nav {\n\tbackground-color: #494949;\n\tmargin: 0;\n\tpadding: 0;\n\tdisplay: none;\n}\n\n#nav2 {\n\tbackground: url(data:image/jpeg;base64,/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3kAAQAEAAAARgAA/+4ADkFkb2JlAGTAAAAAAf/bAIQABAMDAwMDBAMDBAYEAwQGBwUEBAUHCAYGBwYGCAoICQkJCQgKCgwMDAwMCgwMDQ0MDBERERERFBQUFBQUFBQUFAEEBQUIBwgPCgoPFA4ODhQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgAMgAzAwERAAIRAQMRAf/EAFkAAQADAQAAAAAAAAAAAAAAAAABBQcIAQEAAAAAAAAAAAAAAAAAAAAAEAABAgYDAAAAAAAAAAAAAAAAAVERAtMEFJRVBxgRAQAAAAAAAAAAAAAAAAAAAAD/2gAMAwEAAhEDEQA/AMRAAAAAAAA7a87dZcCu3e1wHnbrLgV272uA87dZcCu3e1wHnbrLgV272uA87dZcCu3e1wHnbrLgV272uA87dZcCu3e1wN/wJGAYEjAMCRgGBIwDAkYBgSMAwJGAsoIwCCMAgjAIIwCCMAgjAIIwEgAAAAAAAAAAAAAAAAAAAAAAAH//2Q==) repeat-x scroll left top transparent;\n\tmargin: 0;\n\tpadding: 0 310px 0 0;\n\ttext-align: right;\n\tdisplay: none;\n}\n\n#nav_inner {\n\tbackground-color: transparent;\n\tfont-family: Lucida Grande,Verdana,Geneva,sans-serif;\n\tfont-size: 11px;\n\tmargin: 0;\n\tpadding: 8px 12px 0 20px;\n}\n\ndiv#pulldown-menu {\n\t-moz-column-count: 5;\n\t-moz-column-gap: 20px;\n\t-webkit-column-count: 5;\n\t-webkit-column-gap: 20px;\n\tcolumn-count: 5;\n\tcolumn-gap: 20px;\n\t-webkit-column-rule: 1px groove #b8b8b8;\n\t-moz-column-rule: 1px groove #b8b8b8;\n\tcolumn-rule: 1px groove #b8b8b8;\n}\n\n#pulldown-menu > ul {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\t-webkit-column-break-inside: avoid; /*Chrome, Safari*/\n\tdisplay: table;\t/*Firefox*/\n\tbreak-inside: avoid; /*IE 10+ theoretically*/\n}\n\n#pulldown-menu ul li.toctree-l2 {\n\tfont-size: 0.82em;\n\tmargin-left: 20px;\n\tlist-style-image: url(data:image/gif;base64,R0lGODlhCwAJALMJAO7u7uTk5PLy8unp6fb29t7e3vj4+Li4uIWFheTk5AAAAAAAAAAAAAAAAAAAAAAAACH5BAEAAAkALAAAAAALAAkAAAQoMJ1JqTQ4Z3SI98jHCWSJkByArCyiHkMsIzEX3DeCc0Xv+4hEa5iIAAA7);\n}\n\n#pulldown-menu ul li.toctree-l1 a {\n\tcolor: #ffffff;\n\ttext-decoration: none;\n\tfont-size: 12px;\n\tfont-family: \"Roboto Slab\",\"ff-tisa-web-pro\",\"Georgia\",Arial,sans-serif;\n\tfont-weight: 700;\n}\n\n#pulldown-menu ul li.toctree-l2 a {\n\ttext-decoration: none;\n\tfont-size: 11px;\n\tline-height: 1.4em;\n\tfont-weight: 300;\n\tfont-family: Lucida Grande,Verdana,Geneva,sans-serif;\n\tcolor: #aaaaaa;\n}\n\n/*hide pulldown menu on mobile devices*/\n@media (max-width: 768px) { /*tablet size defined by theme*/\n\t#closeMe {\n\t\tdisplay: none;\n\t}\n\n\t#pulldown {\n\t\tdisplay: none;\n\t}\n\n\t#openToc {\n\t\tdisplay: none;\n\t}\n}" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/static/css/theme.css", "content": "*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}[hidden]{display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:hover,a:active{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;color:#000;text-decoration:none}mark{background:#ff0;color:#000;font-style:italic;font-weight:bold}pre,code,.rst-content tt,kbd,samp{font-family:monospace,serif;_font-family:\"courier new\",monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:before,q:after{content:\"\";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}ul,ol,dl{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure{margin:0}form{margin:0}fieldset{border:0;margin:0;padding:0}label{cursor:pointer}legend{border:0;*margin-left:-7px;padding:0;white-space:normal}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=\"button\"],input[type=\"reset\"],input[type=\"submit\"]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=\"checkbox\"],input[type=\"radio\"]{box-sizing:border-box;padding:0;*width:13px;*height:13px}input[type=\"search\"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=\"search\"]::-webkit-search-decoration,input[type=\"search\"]::-webkit-search-cancel-button{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:0.2em 0;background:#ccc;color:#000;padding:0.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none !important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{html,body,section{background:none !important}*{box-shadow:none !important;text-shadow:none !important;filter:none !important;-ms-filter:none !important}a,a:visited{text-decoration:underline}.ir a:after,a[href^=\"javascript:\"]:after,a[href^=\"#\"]:after{content:\"\"}pre,blockquote{page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:1.5cm 0.5cm 2.5cm}p,h2,h3{orphans:3;widows:3}h2,h3{page-break-after:avoid}}.fa:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.btn,input[type=\"text\"],input[type=\"password\"],input[type=\"email\"],input[type=\"url\"],input[type=\"date\"],input[type=\"month\"],input[type=\"time\"],input[type=\"datetime\"],input[type=\"datetime-local\"],input[type=\"week\"],input[type=\"number\"],input[type=\"search\"],input[type=\"tel\"],input[type=\"color\"],select,textarea,.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a,.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a,.wy-nav-top a{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:\"\"}.clearfix:after{clear:both}/*!\n * Font Awesome 4.1.0 by @davegandy - http://fontawesome.io - @fontawesome\n * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)\n */@font-face{font-family:'FontAwesome';src:url(\"../fonts/fontawesome-webfont.eot?v=4.1.0\");src:url(\"../fonts/fontawesome-webfont.eot?#iefix&v=4.1.0\") format(\"embedded-opentype\"),url(\"../fonts/fontawesome-webfont.woff?v=4.1.0\") format(\"woff\"),url(\"../fonts/fontawesome-webfont.ttf?v=4.1.0\") format(\"truetype\"),url(\"../fonts/fontawesome-webfont.svg?v=4.1.0#fontawesomeregular\") format(\"svg\");font-weight:normal;font-style:normal}.fa,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.icon{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:0.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:0.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:solid 0.08em #eee;border-radius:.1em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.rst-content .pull-left.admonition-title,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content dl dt .pull-left.headerlink,.pull-left.icon{margin-right:.3em}.fa.pull-right,.rst-content .pull-right.admonition-title,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content dl dt .pull-right.headerlink,.pull-right.icon{margin-left:.3em}.fa-spin{-webkit-animation:spin 2s infinite linear;-moz-animation:spin 2s infinite linear;-o-animation:spin 2s infinite linear;animation:spin 2s infinite linear}@-moz-keyframes spin{0%{-moz-transform:rotate(0deg)}100%{-moz-transform:rotate(359deg)}}@-webkit-keyframes spin{0%{-webkit-transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg)}}@-o-keyframes spin{0%{-o-transform:rotate(0deg)}100%{-o-transform:rotate(359deg)}}@keyframes spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=1);-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=2);-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=3);-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=0);-webkit-transform:scale(-1, 1);-moz-transform:scale(-1, 1);-ms-transform:scale(-1, 1);-o-transform:scale(-1, 1);transform:scale(-1, 1)}.fa-flip-vertical{filter:progid:DXImageTransform.Microsoft.BasicImage(rotation=2);-webkit-transform:scale(1, -1);-moz-transform:scale(1, -1);-ms-transform:scale(1, -1);-o-transform:scale(1, -1);transform:scale(1, -1)}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:\"\"}.fa-music:before{content:\"\"}.fa-search:before,.icon-search:before{content:\"\"}.fa-envelope-o:before{content:\"\"}.fa-heart:before{content:\"\"}.fa-star:before{content:\"\"}.fa-star-o:before{content:\"\"}.fa-user:before{content:\"\"}.fa-film:before{content:\"\"}.fa-th-large:before{content:\"\"}.fa-th:before{content:\"\"}.fa-th-list:before{content:\"\"}.fa-check:before{content:\"\"}.fa-times:before{content:\"\"}.fa-search-plus:before{content:\"\"}.fa-search-minus:before{content:\"\"}.fa-power-off:before{content:\"\"}.fa-signal:before{content:\"\"}.fa-gear:before,.fa-cog:before{content:\"\"}.fa-trash-o:before{content:\"\"}.fa-home:before,.icon-home:before{content:\"\"}.fa-file-o:before{content:\"\"}.fa-clock-o:before{content:\"\"}.fa-road:before{content:\"\"}.fa-download:before{content:\"\"}.fa-arrow-circle-o-down:before{content:\"\"}.fa-arrow-circle-o-up:before{content:\"\"}.fa-inbox:before{content:\"\"}.fa-play-circle-o:before{content:\"\"}.fa-rotate-right:before,.fa-repeat:before{content:\"\"}.fa-refresh:before{content:\"\"}.fa-list-alt:before{content:\"\"}.fa-lock:before{content:\"\"}.fa-flag:before{content:\"\"}.fa-headphones:before{content:\"\"}.fa-volume-off:before{content:\"\"}.fa-volume-down:before{content:\"\"}.fa-volume-up:before{content:\"\"}.fa-qrcode:before{content:\"\"}.fa-barcode:before{content:\"\"}.fa-tag:before{content:\"\"}.fa-tags:before{content:\"\"}.fa-book:before,.icon-book:before{content:\"\"}.fa-bookmark:before{content:\"\"}.fa-print:before{content:\"\"}.fa-camera:before{content:\"\"}.fa-font:before{content:\"\"}.fa-bold:before{content:\"\"}.fa-italic:before{content:\"\"}.fa-text-height:before{content:\"\"}.fa-text-width:before{content:\"\"}.fa-align-left:before{content:\"\"}.fa-align-center:before{content:\"\"}.fa-align-right:before{content:\"\"}.fa-align-justify:before{content:\"\"}.fa-list:before{content:\"\"}.fa-dedent:before,.fa-outdent:before{content:\"\"}.fa-indent:before{content:\"\"}.fa-video-camera:before{content:\"\"}.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:\"\"}.fa-pencil:before{content:\"\"}.fa-map-marker:before{content:\"\"}.fa-adjust:before{content:\"\"}.fa-tint:before{content:\"\"}.fa-edit:before,.fa-pencil-square-o:before{content:\"\"}.fa-share-square-o:before{content:\"\"}.fa-check-square-o:before{content:\"\"}.fa-arrows:before{content:\"\"}.fa-step-backward:before{content:\"\"}.fa-fast-backward:before{content:\"\"}.fa-backward:before{content:\"\"}.fa-play:before{content:\"\"}.fa-pause:before{content:\"\"}.fa-stop:before{content:\"\"}.fa-forward:before{content:\"\"}.fa-fast-forward:before{content:\"\"}.fa-step-forward:before{content:\"\"}.fa-eject:before{content:\"\"}.fa-chevron-left:before{content:\"\"}.fa-chevron-right:before{content:\"\"}.fa-plus-circle:before{content:\"\"}.fa-minus-circle:before{content:\"\"}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:\"\"}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:\"\"}.fa-question-circle:before{content:\"\"}.fa-info-circle:before{content:\"\"}.fa-crosshairs:before{content:\"\"}.fa-times-circle-o:before{content:\"\"}.fa-check-circle-o:before{content:\"\"}.fa-ban:before{content:\"\"}.fa-arrow-left:before{content:\"\"}.fa-arrow-right:before{content:\"\"}.fa-arrow-up:before{content:\"\"}.fa-arrow-down:before{content:\"\"}.fa-mail-forward:before,.fa-share:before{content:\"\"}.fa-expand:before{content:\"\"}.fa-compress:before{content:\"\"}.fa-plus:before{content:\"\"}.fa-minus:before{content:\"\"}.fa-asterisk:before{content:\"\"}.fa-exclamation-circle:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.rst-content .admonition-title:before{content:\"\"}.fa-gift:before{content:\"\"}.fa-leaf:before{content:\"\"}.fa-fire:before,.icon-fire:before{content:\"\"}.fa-eye:before{content:\"\"}.fa-eye-slash:before{content:\"\"}.fa-warning:before,.fa-exclamation-triangle:before{content:\"\"}.fa-plane:before{content:\"\"}.fa-calendar:before{content:\"\"}.fa-random:before{content:\"\"}.fa-comment:before{content:\"\"}.fa-magnet:before{content:\"\"}.fa-chevron-up:before{content:\"\"}.fa-chevron-down:before{content:\"\"}.fa-retweet:before{content:\"\"}.fa-shopping-cart:before{content:\"\"}.fa-folder:before{content:\"\"}.fa-folder-open:before{content:\"\"}.fa-arrows-v:before{content:\"\"}.fa-arrows-h:before{content:\"\"}.fa-bar-chart-o:before{content:\"\"}.fa-twitter-square:before{content:\"\"}.fa-facebook-square:before{content:\"\"}.fa-camera-retro:before{content:\"\"}.fa-key:before{content:\"\"}.fa-gears:before,.fa-cogs:before{content:\"\"}.fa-comments:before{content:\"\"}.fa-thumbs-o-up:before{content:\"\"}.fa-thumbs-o-down:before{content:\"\"}.fa-star-half:before{content:\"\"}.fa-heart-o:before{content:\"\"}.fa-sign-out:before{content:\"\"}.fa-linkedin-square:before{content:\"\"}.fa-thumb-tack:before{content:\"\"}.fa-external-link:before{content:\"\"}.fa-sign-in:before{content:\"\"}.fa-trophy:before{content:\"\"}.fa-github-square:before{content:\"\"}.fa-upload:before{content:\"\"}.fa-lemon-o:before{content:\"\"}.fa-phone:before{content:\"\"}.fa-square-o:before{content:\"\"}.fa-bookmark-o:before{content:\"\"}.fa-phone-square:before{content:\"\"}.fa-twitter:before{content:\"\"}.fa-facebook:before{content:\"\"}.fa-github:before,.icon-github:before{content:\"\"}.fa-unlock:before{content:\"\"}.fa-credit-card:before{content:\"\"}.fa-rss:before{content:\"\"}.fa-hdd-o:before{content:\"\"}.fa-bullhorn:before{content:\"\"}.fa-bell:before{content:\"\"}.fa-certificate:before{content:\"\"}.fa-hand-o-right:before{content:\"\"}.fa-hand-o-left:before{content:\"\"}.fa-hand-o-up:before{content:\"\"}.fa-hand-o-down:before{content:\"\"}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:\"\"}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:\"\"}.fa-arrow-circle-up:before{content:\"\"}.fa-arrow-circle-down:before{content:\"\"}.fa-globe:before{content:\"\"}.fa-wrench:before{content:\"\"}.fa-tasks:before{content:\"\"}.fa-filter:before{content:\"\"}.fa-briefcase:before{content:\"\"}.fa-arrows-alt:before{content:\"\"}.fa-group:before,.fa-users:before{content:\"\"}.fa-chain:before,.fa-link:before,.icon-link:before{content:\"\"}.fa-cloud:before{content:\"\"}.fa-flask:before{content:\"\"}.fa-cut:before,.fa-scissors:before{content:\"\"}.fa-copy:before,.fa-files-o:before{content:\"\"}.fa-paperclip:before{content:\"\"}.fa-save:before,.fa-floppy-o:before{content:\"\"}.fa-square:before{content:\"\"}.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:\"\"}.fa-list-ul:before{content:\"\"}.fa-list-ol:before{content:\"\"}.fa-strikethrough:before{content:\"\"}.fa-underline:before{content:\"\"}.fa-table:before{content:\"\"}.fa-magic:before{content:\"\"}.fa-truck:before{content:\"\"}.fa-pinterest:before{content:\"\"}.fa-pinterest-square:before{content:\"\"}.fa-google-plus-square:before{content:\"\"}.fa-google-plus:before{content:\"\"}.fa-money:before{content:\"\"}.fa-caret-down:before,.wy-dropdown .caret:before,.icon-caret-down:before{content:\"\"}.fa-caret-up:before{content:\"\"}.fa-caret-left:before{content:\"\"}.fa-caret-right:before{content:\"\"}.fa-columns:before{content:\"\"}.fa-unsorted:before,.fa-sort:before{content:\"\"}.fa-sort-down:before,.fa-sort-desc:before{content:\"\"}.fa-sort-up:before,.fa-sort-asc:before{content:\"\"}.fa-envelope:before{content:\"\"}.fa-linkedin:before{content:\"\"}.fa-rotate-left:before,.fa-undo:before{content:\"\"}.fa-legal:before,.fa-gavel:before{content:\"\"}.fa-dashboard:before,.fa-tachometer:before{content:\"\"}.fa-comment-o:before{content:\"\"}.fa-comments-o:before{content:\"\"}.fa-flash:before,.fa-bolt:before{content:\"\"}.fa-sitemap:before{content:\"\"}.fa-umbrella:before{content:\"\"}.fa-paste:before,.fa-clipboard:before{content:\"\"}.fa-lightbulb-o:before{content:\"\"}.fa-exchange:before{content:\"\"}.fa-cloud-download:before{content:\"\"}.fa-cloud-upload:before{content:\"\"}.fa-user-md:before{content:\"\"}.fa-stethoscope:before{content:\"\"}.fa-suitcase:before{content:\"\"}.fa-bell-o:before{content:\"\"}.fa-coffee:before{content:\"\"}.fa-cutlery:before{content:\"\"}.fa-file-text-o:before{content:\"\"}.fa-building-o:before{content:\"\"}.fa-hospital-o:before{content:\"\"}.fa-ambulance:before{content:\"\"}.fa-medkit:before{content:\"\"}.fa-fighter-jet:before{content:\"\"}.fa-beer:before{content:\"\"}.fa-h-square:before{content:\"\"}.fa-plus-square:before{content:\"\"}.fa-angle-double-left:before{content:\"\"}.fa-angle-double-right:before{content:\"\"}.fa-angle-double-up:before{content:\"\"}.fa-angle-double-down:before{content:\"\"}.fa-angle-left:before{content:\"\"}.fa-angle-right:before{content:\"\"}.fa-angle-up:before{content:\"\"}.fa-angle-down:before{content:\"\"}.fa-desktop:before{content:\"\"}.fa-laptop:before{content:\"\"}.fa-tablet:before{content:\"\"}.fa-mobile-phone:before,.fa-mobile:before{content:\"\"}.fa-circle-o:before{content:\"\"}.fa-quote-left:before{content:\"\"}.fa-quote-right:before{content:\"\"}.fa-spinner:before{content:\"\"}.fa-circle:before{content:\"\"}.fa-mail-reply:before,.fa-reply:before{content:\"\"}.fa-github-alt:before{content:\"\"}.fa-folder-o:before{content:\"\"}.fa-folder-open-o:before{content:\"\"}.fa-smile-o:before{content:\"\"}.fa-frown-o:before{content:\"\"}.fa-meh-o:before{content:\"\"}.fa-gamepad:before{content:\"\"}.fa-keyboard-o:before{content:\"\"}.fa-flag-o:before{content:\"\"}.fa-flag-checkered:before{content:\"\"}.fa-terminal:before{content:\"\"}.fa-code:before{content:\"\"}.fa-mail-reply-all:before,.fa-reply-all:before{content:\"\"}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:\"\"}.fa-location-arrow:before{content:\"\"}.fa-crop:before{content:\"\"}.fa-code-fork:before{content:\"\"}.fa-unlink:before,.fa-chain-broken:before{content:\"\"}.fa-question:before{content:\"\"}.fa-info:before{content:\"\"}.fa-exclamation:before{content:\"\"}.fa-superscript:before{content:\"\"}.fa-subscript:before{content:\"\"}.fa-eraser:before{content:\"\"}.fa-puzzle-piece:before{content:\"\"}.fa-microphone:before{content:\"\"}.fa-microphone-slash:before{content:\"\"}.fa-shield:before{content:\"\"}.fa-calendar-o:before{content:\"\"}.fa-fire-extinguisher:before{content:\"\"}.fa-rocket:before{content:\"\"}.fa-maxcdn:before{content:\"\"}.fa-chevron-circle-left:before{content:\"\"}.fa-chevron-circle-right:before{content:\"\"}.fa-chevron-circle-up:before{content:\"\"}.fa-chevron-circle-down:before{content:\"\"}.fa-html5:before{content:\"\"}.fa-css3:before{content:\"\"}.fa-anchor:before{content:\"\"}.fa-unlock-alt:before{content:\"\"}.fa-bullseye:before{content:\"\"}.fa-ellipsis-h:before{content:\"\"}.fa-ellipsis-v:before{content:\"\"}.fa-rss-square:before{content:\"\"}.fa-play-circle:before{content:\"\"}.fa-ticket:before{content:\"\"}.fa-minus-square:before{content:\"\"}.fa-minus-square-o:before{content:\"\"}.fa-level-up:before{content:\"\"}.fa-level-down:before{content:\"\"}.fa-check-square:before{content:\"\"}.fa-pencil-square:before{content:\"\"}.fa-external-link-square:before{content:\"\"}.fa-share-square:before{content:\"\"}.fa-compass:before{content:\"\"}.fa-toggle-down:before,.fa-caret-square-o-down:before{content:\"\"}.fa-toggle-up:before,.fa-caret-square-o-up:before{content:\"\"}.fa-toggle-right:before,.fa-caret-square-o-right:before{content:\"\"}.fa-euro:before,.fa-eur:before{content:\"\"}.fa-gbp:before{content:\"\"}.fa-dollar:before,.fa-usd:before{content:\"\"}.fa-rupee:before,.fa-inr:before{content:\"\"}.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:\"\"}.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:\"\"}.fa-won:before,.fa-krw:before{content:\"\"}.fa-bitcoin:before,.fa-btc:before{content:\"\"}.fa-file:before{content:\"\"}.fa-file-text:before{content:\"\"}.fa-sort-alpha-asc:before{content:\"\"}.fa-sort-alpha-desc:before{content:\"\"}.fa-sort-amount-asc:before{content:\"\"}.fa-sort-amount-desc:before{content:\"\"}.fa-sort-numeric-asc:before{content:\"\"}.fa-sort-numeric-desc:before{content:\"\"}.fa-thumbs-up:before{content:\"\"}.fa-thumbs-down:before{content:\"\"}.fa-youtube-square:before{content:\"\"}.fa-youtube:before{content:\"\"}.fa-xing:before{content:\"\"}.fa-xing-square:before{content:\"\"}.fa-youtube-play:before{content:\"\"}.fa-dropbox:before{content:\"\"}.fa-stack-overflow:before{content:\"\"}.fa-instagram:before{content:\"\"}.fa-flickr:before{content:\"\"}.fa-adn:before{content:\"\"}.fa-bitbucket:before,.icon-bitbucket:before{content:\"\"}.fa-bitbucket-square:before{content:\"\"}.fa-tumblr:before{content:\"\"}.fa-tumblr-square:before{content:\"\"}.fa-long-arrow-down:before{content:\"\"}.fa-long-arrow-up:before{content:\"\"}.fa-long-arrow-left:before{content:\"\"}.fa-long-arrow-right:before{content:\"\"}.fa-apple:before{content:\"\"}.fa-windows:before{content:\"\"}.fa-android:before{content:\"\"}.fa-linux:before{content:\"\"}.fa-dribbble:before{content:\"\"}.fa-skype:before{content:\"\"}.fa-foursquare:before{content:\"\"}.fa-trello:before{content:\"\"}.fa-female:before{content:\"\"}.fa-male:before{content:\"\"}.fa-gittip:before{content:\"\"}.fa-sun-o:before{content:\"\"}.fa-moon-o:before{content:\"\"}.fa-archive:before{content:\"\"}.fa-bug:before{content:\"\"}.fa-vk:before{content:\"\"}.fa-weibo:before{content:\"\"}.fa-renren:before{content:\"\"}.fa-pagelines:before{content:\"\"}.fa-stack-exchange:before{content:\"\"}.fa-arrow-circle-o-right:before{content:\"\"}.fa-arrow-circle-o-left:before{content:\"\"}.fa-toggle-left:before,.fa-caret-square-o-left:before{content:\"\"}.fa-dot-circle-o:before{content:\"\"}.fa-wheelchair:before{content:\"\"}.fa-vimeo-square:before{content:\"\"}.fa-turkish-lira:before,.fa-try:before{content:\"\"}.fa-plus-square-o:before{content:\"\"}.fa-space-shuttle:before{content:\"\"}.fa-slack:before{content:\"\"}.fa-envelope-square:before{content:\"\"}.fa-wordpress:before{content:\"\"}.fa-openid:before{content:\"\"}.fa-institution:before,.fa-bank:before,.fa-university:before{content:\"\"}.fa-mortar-board:before,.fa-graduation-cap:before{content:\"\"}.fa-yahoo:before{content:\"\"}.fa-google:before{content:\"\"}.fa-reddit:before{content:\"\"}.fa-reddit-square:before{content:\"\"}.fa-stumbleupon-circle:before{content:\"\"}.fa-stumbleupon:before{content:\"\"}.fa-delicious:before{content:\"\"}.fa-digg:before{content:\"\"}.fa-pied-piper-square:before,.fa-pied-piper:before{content:\"\"}.fa-pied-piper-alt:before{content:\"\"}.fa-drupal:before{content:\"\"}.fa-joomla:before{content:\"\"}.fa-language:before{content:\"\"}.fa-fax:before{content:\"\"}.fa-building:before{content:\"\"}.fa-child:before{content:\"\"}.fa-paw:before{content:\"\"}.fa-spoon:before{content:\"\"}.fa-cube:before{content:\"\"}.fa-cubes:before{content:\"\"}.fa-behance:before{content:\"\"}.fa-behance-square:before{content:\"\"}.fa-steam:before{content:\"\"}.fa-steam-square:before{content:\"\"}.fa-recycle:before{content:\"\"}.fa-automobile:before,.fa-car:before{content:\"\"}.fa-cab:before,.fa-taxi:before{content:\"\"}.fa-tree:before{content:\"\"}.fa-spotify:before{content:\"\"}.fa-deviantart:before{content:\"\"}.fa-soundcloud:before{content:\"\"}.fa-database:before{content:\"\"}.fa-file-pdf-o:before{content:\"\"}.fa-file-word-o:before{content:\"\"}.fa-file-excel-o:before{content:\"\"}.fa-file-powerpoint-o:before{content:\"\"}.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:\"\"}.fa-file-zip-o:before,.fa-file-archive-o:before{content:\"\"}.fa-file-sound-o:before,.fa-file-audio-o:before{content:\"\"}.fa-file-movie-o:before,.fa-file-video-o:before{content:\"\"}.fa-file-code-o:before{content:\"\"}.fa-vine:before{content:\"\"}.fa-codepen:before{content:\"\"}.fa-jsfiddle:before{content:\"\"}.fa-life-bouy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:\"\"}.fa-circle-o-notch:before{content:\"\"}.fa-ra:before,.fa-rebel:before{content:\"\"}.fa-ge:before,.fa-empire:before{content:\"\"}.fa-git-square:before{content:\"\"}.fa-git:before{content:\"\"}.fa-hacker-news:before{content:\"\"}.fa-tencent-weibo:before{content:\"\"}.fa-qq:before{content:\"\"}.fa-wechat:before,.fa-weixin:before{content:\"\"}.fa-send:before,.fa-paper-plane:before{content:\"\"}.fa-send-o:before,.fa-paper-plane-o:before{content:\"\"}.fa-history:before{content:\"\"}.fa-circle-thin:before{content:\"\"}.fa-header:before{content:\"\"}.fa-paragraph:before{content:\"\"}.fa-sliders:before{content:\"\"}.fa-share-alt:before{content:\"\"}.fa-share-alt-square:before{content:\"\"}.fa-bomb:before{content:\"\"}.fa,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.icon,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context{font-family:inherit}.fa:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before{font-family:\"FontAwesome\";display:inline-block;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa,a .rst-content .admonition-title,.rst-content a .admonition-title,a .rst-content h1 .headerlink,.rst-content h1 a .headerlink,a .rst-content h2 .headerlink,.rst-content h2 a .headerlink,a .rst-content h3 .headerlink,.rst-content h3 a .headerlink,a .rst-content h4 .headerlink,.rst-content h4 a .headerlink,a .rst-content h5 .headerlink,.rst-content h5 a .headerlink,a .rst-content h6 .headerlink,.rst-content h6 a .headerlink,a .rst-content dl dt .headerlink,.rst-content dl dt a .headerlink,a .icon{display:inline-block;text-decoration:inherit}.btn .fa,.btn .rst-content .admonition-title,.rst-content .btn .admonition-title,.btn .rst-content h1 .headerlink,.rst-content h1 .btn .headerlink,.btn .rst-content h2 .headerlink,.rst-content h2 .btn .headerlink,.btn .rst-content h3 .headerlink,.rst-content h3 .btn .headerlink,.btn .rst-content h4 .headerlink,.rst-content h4 .btn .headerlink,.btn .rst-content h5 .headerlink,.rst-content h5 .btn .headerlink,.btn .rst-content h6 .headerlink,.rst-content h6 .btn .headerlink,.btn .rst-content dl dt .headerlink,.rst-content dl dt .btn .headerlink,.btn .icon,.nav .fa,.nav .rst-content .admonition-title,.rst-content .nav .admonition-title,.nav .rst-content h1 .headerlink,.rst-content h1 .nav .headerlink,.nav .rst-content h2 .headerlink,.rst-content h2 .nav .headerlink,.nav .rst-content h3 .headerlink,.rst-content h3 .nav .headerlink,.nav .rst-content h4 .headerlink,.rst-content h4 .nav .headerlink,.nav .rst-content h5 .headerlink,.rst-content h5 .nav .headerlink,.nav .rst-content h6 .headerlink,.rst-content h6 .nav .headerlink,.nav .rst-content dl dt .headerlink,.rst-content dl dt .nav .headerlink,.nav .icon{display:inline}.btn .fa.fa-large,.btn .rst-content .fa-large.admonition-title,.rst-content .btn .fa-large.admonition-title,.btn .rst-content h1 .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.btn .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .btn .fa-large.headerlink,.btn .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .fa-large.admonition-title,.rst-content .nav .fa-large.admonition-title,.nav .rst-content h1 .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.nav .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.nav .fa-large.icon{line-height:0.9em}.btn .fa.fa-spin,.btn .rst-content .fa-spin.admonition-title,.rst-content .btn .fa-spin.admonition-title,.btn .rst-content h1 .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.btn .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .btn .fa-spin.headerlink,.btn .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .fa-spin.admonition-title,.rst-content .nav .fa-spin.admonition-title,.nav .rst-content h1 .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.nav .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.nav .fa-spin.icon{display:inline-block}.btn.fa:before,.rst-content .btn.admonition-title:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content dl dt .btn.headerlink:before,.btn.icon:before{opacity:0.5;-webkit-transition:opacity 0.05s ease-in;-moz-transition:opacity 0.05s ease-in;transition:opacity 0.05s ease-in}.btn.fa:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.btn.icon:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .rst-content .admonition-title:before,.rst-content .btn-mini .admonition-title:before,.btn-mini .rst-content h1 .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.btn-mini .rst-content dl dt .headerlink:before,.rst-content dl dt .btn-mini .headerlink:before,.btn-mini .icon:before{font-size:14px;vertical-align:-15%}.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo{padding:12px;line-height:24px;margin-bottom:24px;background:#dedede}.wy-alert-title,.rst-content .admonition-title{color:#fff;font-weight:bold;display:block;color:#fff;background:#8ba8af;margin:-12px;padding:6px 12px;margin-bottom:12px}.wy-alert.wy-alert-danger,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.admonition-todo{background:#fdf3f2}.wy-alert.wy-alert-danger .wy-alert-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .danger .wy-alert-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .danger .admonition-title,.rst-content .error .admonition-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title{background:#f29f97}.wy-alert.wy-alert-warning,.rst-content .wy-alert-warning.note,.rst-content .attention,.rst-content .caution,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.tip,.rst-content .warning,.rst-content .wy-alert-warning.seealso,.rst-content .admonition-todo{background:#ffedcc}.wy-alert.wy-alert-warning .wy-alert-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .attention .wy-alert-title,.rst-content .caution .wy-alert-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .admonition-todo .wy-alert-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .attention .admonition-title,.rst-content .caution .admonition-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .warning .admonition-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .admonition-todo .admonition-title{background:#f0b37e}.wy-alert.wy-alert-info,.rst-content .note,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.rst-content .seealso,.rst-content .wy-alert-info.admonition-todo{background:#dedede}.wy-alert.wy-alert-info .wy-alert-title,.rst-content .note .wy-alert-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.rst-content .note .admonition-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .seealso .admonition-title,.rst-content .wy-alert-info.admonition-todo .admonition-title{background:#8ba8af}.wy-alert.wy-alert-success,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.warning,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.admonition-todo{background:#dedede}.wy-alert.wy-alert-success .wy-alert-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .hint .wy-alert-title,.rst-content .important .wy-alert-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .hint .admonition-title,.rst-content .important .admonition-title,.rst-content .tip .admonition-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.admonition-todo .admonition-title{background:#dd4814}.wy-alert.wy-alert-neutral,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.admonition-todo{background:#f3f6f6}.wy-alert.wy-alert-neutral .wy-alert-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .admonition-title{color:#404040;background:#e1e4e5}.wy-alert.wy-alert-neutral a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.admonition-todo a{color:#dd4814}.wy-alert p:last-child,.rst-content .note p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.rst-content .seealso p:last-child,.rst-content .admonition-todo p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0px;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,0.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all 0.3s ease-in;-moz-transition:all 0.3s ease-in;transition:all 0.3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27AE60}.wy-tray-container li.wy-tray-item-info{background:#dd4814}.wy-tray-container li.wy-tray-item-warning{background:#E67E22}.wy-tray-container li.wy-tray-item-danger{background:#E74C3C}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width: 768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px 12px;color:#fff;border:1px solid rgba(0,0,0,0.1);background-color:#27AE60;text-decoration:none;font-weight:normal;font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif;box-shadow:0px 1px 2px -1px rgba(255,255,255,0.5) inset,0px -2px 0px 0px rgba(0,0,0,0.1) inset;outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all 0.1s linear;-moz-transition:all 0.1s linear;transition:all 0.1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:0px -1px 0px 0px rgba(0,0,0,0.05) inset,0px 2px 0px 0px rgba(0,0,0,0.1) inset;padding:8px 12px 6px 12px}.btn:visited{color:#fff}.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:0.4;cursor:not-allowed;box-shadow:none}.btn-disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:0.4;cursor:not-allowed;box-shadow:none}.btn-disabled:hover,.btn-disabled:focus,.btn-disabled:active{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:0.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#dd4814 !important}.btn-info:hover{background-color:#2e8ece !important}.btn-neutral{background-color:#f3f6f6 !important;color:#404040 !important}.btn-neutral:hover{background-color:#e5ebeb !important;color:#404040}.btn-neutral:visited{color:#404040 !important}.btn-success{background-color:#27AE60 !important}.btn-success:hover{background-color:#295 !important}.btn-danger{background-color:#E74C3C !important}.btn-danger:hover{background-color:#ea6153 !important}.btn-warning{background-color:#E67E22 !important}.btn-warning:hover{background-color:#e98b39 !important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f !important}.btn-link{background-color:transparent !important;color:#dd4814;box-shadow:none;border-color:transparent !important}.btn-link:hover{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:active{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:visited{color:#97310e}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:before,.wy-btn-group:after{display:table;content:\"\"}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:solid 1px #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,0.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#dd4814;color:#fff}.wy-dropdown-menu>dd.divider{border-top:solid 1px #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=\"search\"]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#dd4814;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;text-align:right}.wy-dropdown-arrow:before{content:\" \";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned input,.wy-form-aligned textarea,.wy-form-aligned select,.wy-form-aligned .wy-help-inline,.wy-form-aligned label{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{border:0;margin:0;padding:0}legend{display:block;width:100%;border:0;padding:0;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label{display:block;margin:0 0 0.3125em 0;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;*zoom:1;max-width:68em;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:before,.wy-control-group:after{display:table;content:\"\"}.wy-control-group:after{clear:both}.wy-control-group:before,.wy-control-group:after{display:table;content:\"\"}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:\" *\";color:#E74C3C}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full input[type=\"text\"],.wy-control-group .wy-form-full input[type=\"password\"],.wy-control-group .wy-form-full input[type=\"email\"],.wy-control-group .wy-form-full input[type=\"url\"],.wy-control-group .wy-form-full input[type=\"date\"],.wy-control-group .wy-form-full input[type=\"month\"],.wy-control-group .wy-form-full input[type=\"time\"],.wy-control-group .wy-form-full input[type=\"datetime\"],.wy-control-group .wy-form-full input[type=\"datetime-local\"],.wy-control-group .wy-form-full input[type=\"week\"],.wy-control-group .wy-form-full input[type=\"number\"],.wy-control-group .wy-form-full input[type=\"search\"],.wy-control-group .wy-form-full input[type=\"tel\"],.wy-control-group .wy-form-full input[type=\"color\"],.wy-control-group .wy-form-halves input[type=\"text\"],.wy-control-group .wy-form-halves input[type=\"password\"],.wy-control-group .wy-form-halves input[type=\"email\"],.wy-control-group .wy-form-halves input[type=\"url\"],.wy-control-group .wy-form-halves input[type=\"date\"],.wy-control-group .wy-form-halves input[type=\"month\"],.wy-control-group .wy-form-halves input[type=\"time\"],.wy-control-group .wy-form-halves input[type=\"datetime\"],.wy-control-group .wy-form-halves input[type=\"datetime-local\"],.wy-control-group .wy-form-halves input[type=\"week\"],.wy-control-group .wy-form-halves input[type=\"number\"],.wy-control-group .wy-form-halves input[type=\"search\"],.wy-control-group .wy-form-halves input[type=\"tel\"],.wy-control-group .wy-form-halves input[type=\"color\"],.wy-control-group .wy-form-thirds input[type=\"text\"],.wy-control-group .wy-form-thirds input[type=\"password\"],.wy-control-group .wy-form-thirds input[type=\"email\"],.wy-control-group .wy-form-thirds input[type=\"url\"],.wy-control-group .wy-form-thirds input[type=\"date\"],.wy-control-group .wy-form-thirds input[type=\"month\"],.wy-control-group .wy-form-thirds input[type=\"time\"],.wy-control-group .wy-form-thirds input[type=\"datetime\"],.wy-control-group .wy-form-thirds input[type=\"datetime-local\"],.wy-control-group .wy-form-thirds input[type=\"week\"],.wy-control-group .wy-form-thirds input[type=\"number\"],.wy-control-group .wy-form-thirds input[type=\"search\"],.wy-control-group .wy-form-thirds input[type=\"tel\"],.wy-control-group .wy-form-thirds input[type=\"color\"]{width:100%}.wy-control-group .wy-form-full{float:left;display:block;margin-right:2.35765%;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child{margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n+1){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child{margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control{margin:6px 0 0 0;font-size:90%}.wy-control-no-input{display:inline-block;margin:6px 0 0 0;font-size:90%}.wy-control-group.fluid-input input[type=\"text\"],.wy-control-group.fluid-input input[type=\"password\"],.wy-control-group.fluid-input input[type=\"email\"],.wy-control-group.fluid-input input[type=\"url\"],.wy-control-group.fluid-input input[type=\"date\"],.wy-control-group.fluid-input input[type=\"month\"],.wy-control-group.fluid-input input[type=\"time\"],.wy-control-group.fluid-input input[type=\"datetime\"],.wy-control-group.fluid-input input[type=\"datetime-local\"],.wy-control-group.fluid-input input[type=\"week\"],.wy-control-group.fluid-input input[type=\"number\"],.wy-control-group.fluid-input input[type=\"search\"],.wy-control-group.fluid-input input[type=\"tel\"],.wy-control-group.fluid-input input[type=\"color\"]{width:100%}.wy-form-message-inline{display:inline-block;padding-left:0.3em;color:#666;vertical-align:middle;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:0.3125em;font-style:italic}input{line-height:normal}input[type=\"button\"],input[type=\"reset\"],input[type=\"submit\"]{-webkit-appearance:button;cursor:pointer;font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif;*overflow:visible}input[type=\"text\"],input[type=\"password\"],input[type=\"email\"],input[type=\"url\"],input[type=\"date\"],input[type=\"month\"],input[type=\"time\"],input[type=\"datetime\"],input[type=\"datetime-local\"],input[type=\"week\"],input[type=\"number\"],input[type=\"search\"],input[type=\"tel\"],input[type=\"color\"]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border 0.3s linear;-moz-transition:border 0.3s linear;transition:border 0.3s linear}input[type=\"datetime-local\"]{padding:0.34375em 0.625em}input[disabled]{cursor:default}input[type=\"checkbox\"],input[type=\"radio\"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:0;margin-right:0.3125em;*height:13px;*width:13px}input[type=\"search\"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=\"search\"]::-webkit-search-cancel-button,input[type=\"search\"]::-webkit-search-decoration{-webkit-appearance:none}input[type=\"text\"]:focus,input[type=\"password\"]:focus,input[type=\"email\"]:focus,input[type=\"url\"]:focus,input[type=\"date\"]:focus,input[type=\"month\"]:focus,input[type=\"time\"]:focus,input[type=\"datetime\"]:focus,input[type=\"datetime-local\"]:focus,input[type=\"week\"]:focus,input[type=\"number\"]:focus,input[type=\"search\"]:focus,input[type=\"tel\"]:focus,input[type=\"color\"]:focus{outline:0;outline:thin dotted \\9;border-color:#333}input.no-focus:focus{border-color:#ccc !important}input[type=\"file\"]:focus,input[type=\"radio\"]:focus,input[type=\"checkbox\"]:focus{outline:thin dotted #333;outline:1px auto #129FEA}input[type=\"text\"][disabled],input[type=\"password\"][disabled],input[type=\"email\"][disabled],input[type=\"url\"][disabled],input[type=\"date\"][disabled],input[type=\"month\"][disabled],input[type=\"time\"][disabled],input[type=\"datetime\"][disabled],input[type=\"datetime-local\"][disabled],input[type=\"week\"][disabled],input[type=\"number\"][disabled],input[type=\"search\"][disabled],input[type=\"tel\"][disabled],input[type=\"color\"][disabled]{cursor:not-allowed;background-color:#f3f6f6;color:#cad2d3}input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#E74C3C;border:1px solid #E74C3C}input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#E74C3C}input[type=\"file\"]:focus:invalid:focus,input[type=\"radio\"]:focus:invalid:focus,input[type=\"checkbox\"]:focus:invalid:focus{outline-color:#E74C3C}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif}select,textarea{padding:0.5em 0.625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border 0.3s linear;-moz-transition:border 0.3s linear;transition:border 0.3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;background-color:#fff;color:#cad2d3;border-color:transparent}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:solid 1px #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#E74C3C}.wy-control-group.wy-control-group-error input[type=\"text\"],.wy-control-group.wy-control-group-error input[type=\"password\"],.wy-control-group.wy-control-group-error input[type=\"email\"],.wy-control-group.wy-control-group-error input[type=\"url\"],.wy-control-group.wy-control-group-error input[type=\"date\"],.wy-control-group.wy-control-group-error input[type=\"month\"],.wy-control-group.wy-control-group-error input[type=\"time\"],.wy-control-group.wy-control-group-error input[type=\"datetime\"],.wy-control-group.wy-control-group-error input[type=\"datetime-local\"],.wy-control-group.wy-control-group-error input[type=\"week\"],.wy-control-group.wy-control-group-error input[type=\"number\"],.wy-control-group.wy-control-group-error input[type=\"search\"],.wy-control-group.wy-control-group-error input[type=\"tel\"],.wy-control-group.wy-control-group-error input[type=\"color\"]{border:solid 1px #E74C3C}.wy-control-group.wy-control-group-error textarea{border:solid 1px #E74C3C}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:0.5em 0.625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27AE60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#E74C3C}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#E67E22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#dd4814}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width: 480px){.wy-form button[type=\"submit\"]{margin:0.7em 0 0}.wy-form input[type=\"text\"],.wy-form input[type=\"password\"],.wy-form input[type=\"email\"],.wy-form input[type=\"url\"],.wy-form input[type=\"date\"],.wy-form input[type=\"month\"],.wy-form input[type=\"time\"],.wy-form input[type=\"datetime\"],.wy-form input[type=\"datetime-local\"],.wy-form input[type=\"week\"],.wy-form input[type=\"number\"],.wy-form input[type=\"search\"],.wy-form input[type=\"tel\"],.wy-form input[type=\"color\"]{margin-bottom:0.3em;display:block}.wy-form label{margin-bottom:0.3em;display:block}.wy-form input[type=\"password\"],.wy-form input[type=\"email\"],.wy-form input[type=\"url\"],.wy-form input[type=\"date\"],.wy-form input[type=\"month\"],.wy-form input[type=\"time\"],.wy-form input[type=\"datetime\"],.wy-form input[type=\"datetime-local\"],.wy-form input[type=\"week\"],.wy-form input[type=\"number\"],.wy-form input[type=\"search\"],.wy-form input[type=\"tel\"],.wy-form input[type=\"color\"]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:0.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0 0}.wy-form .wy-help-inline,.wy-form-message-inline,.wy-form-message{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width: 768px){.tablet-hide{display:none}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}}@media screen and (max-width: 480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.wy-table,.rst-content table.docutils,.rst-content table.field-list{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.wy-table caption,.rst-content table.docutils caption,.rst-content table.field-list caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td,.wy-table th,.rst-content table.docutils th,.rst-content table.field-list th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.wy-table td:first-child,.rst-content table.docutils td:first-child,.rst-content table.field-list td:first-child,.wy-table th:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list th:first-child{border-left-width:0}.wy-table thead,.rst-content table.docutils thead,.rst-content table.field-list thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.wy-table thead th,.rst-content table.docutils thead th,.rst-content table.field-list thead th{font-weight:bold;border-bottom:solid 2px #e1e4e5}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td{background-color:transparent;vertical-align:middle}.wy-table td p,.rst-content table.docutils td p,.rst-content table.field-list td p{line-height:18px}.wy-table td p:last-child,.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child{margin-bottom:0}.wy-table .wy-table-cell-min,.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min{width:1%;padding-right:0}.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:gray;font-size:90%}.wy-table-tertiary{color:gray;font-size:80%}.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td,.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td{background-color:#f3f6f6}.wy-table-backed{background-color:#f3f6f6}.wy-table-bordered-all,.rst-content table.docutils{border:1px solid #e1e4e5}.wy-table-bordered-all td,.rst-content table.docutils td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.wy-table-bordered-all tbody>tr:last-child td,.rst-content table.docutils tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px 0;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0 !important}a{color:#dd4814;text-decoration:none;cursor:pointer}a:hover{color:#97310e}a:visited{color:#97310e}html{height:100%;overflow-x:hidden}body{font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif;font-weight:normal;color:#404040;min-height:100%;overflow-x:hidden;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#E67E22 !important}a.wy-text-warning:hover{color:#eb9950 !important}.wy-text-info{color:#dd4814 !important}a.wy-text-info:hover{color:#409ad5 !important}.wy-text-success{color:#27AE60 !important}a.wy-text-success:hover{color:#36d278 !important}.wy-text-danger{color:#E74C3C !important}a.wy-text-danger:hover{color:#ed7669 !important}.wy-text-neutral{color:#404040 !important}a.wy-text-neutral:hover{color:#595959 !important}h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:\"Roboto Slab\",\"ff-tisa-web-pro\",\"Georgia\",Arial,sans-serif}p{line-height:24px;margin:0;font-size:16px;margin-bottom:24px}h1{font-size:175%}h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}code,.rst-content tt{white-space:nowrap;max-width:100%;background:#fff;border:solid 1px #e1e4e5;font-size:75%;padding:0 5px;font-family:Consolas,\"Andale Mono WT\",\"Andale Mono\",\"Lucida Console\",\"Lucida Sans Typewriter\",\"DejaVu Sans Mono\",\"Bitstream Vera Sans Mono\",\"Liberation Mono\",\"Nimbus Mono L\",Monaco,\"Courier New\",Courier,monospace;color:#E74C3C;overflow-x:auto}code.code-large,.rst-content tt.code-large{font-size:90%}.wy-plain-list-disc,.rst-content .section ul,.rst-content .toctree-wrapper ul,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.wy-plain-list-disc li,.rst-content .section ul li,.rst-content .toctree-wrapper ul li,article ul li{list-style:disc;margin-left:24px}.wy-plain-list-disc li p:last-child,.rst-content .section ul li p:last-child,.rst-content .toctree-wrapper ul li p:last-child,article ul li p:last-child{margin-bottom:0}.wy-plain-list-disc li ul,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li ul,article ul li ul{margin-bottom:0}.wy-plain-list-disc li li,.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,article ul li li{list-style:circle}.wy-plain-list-disc li li li,.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,article ul li li li{list-style:square}.wy-plain-list-disc li ol li,.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,article ul li ol li{list-style:decimal}.wy-plain-list-decimal,.rst-content .section ol,.rst-content ol.arabic,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.wy-plain-list-decimal li,.rst-content .section ol li,.rst-content ol.arabic li,article ol li{list-style:decimal;margin-left:24px}.wy-plain-list-decimal li p:last-child,.rst-content .section ol li p:last-child,.rst-content ol.arabic li p:last-child,article ol li p:last-child{margin-bottom:0}.wy-plain-list-decimal li ul,.rst-content .section ol li ul,.rst-content ol.arabic li ul,article ol li ul{margin-bottom:0}.wy-plain-list-decimal li ul li,.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,article ol li ul li{list-style:disc}.codeblock-example{border:1px solid #e1e4e5;border-bottom:none;padding:24px;padding-top:48px;font-weight:500;background:#fff;position:relative}.codeblock-example:after{content:\"Example\";position:absolute;top:0px;left:0px;background:#97310e;color:#fff;padding:6px 12px}.codeblock-example.prettyprint-example-only{border:1px solid #e1e4e5;margin-bottom:24px}.codeblock,pre.literal-block,.rst-content .literal-block,.rst-content pre.literal-block,div[class^='highlight']{border:1px solid #e1e4e5;padding:0px;overflow-x:auto;background:#fff;margin:1px 0 24px 0}.codeblock div[class^='highlight'],pre.literal-block div[class^='highlight'],.rst-content .literal-block div[class^='highlight'],div[class^='highlight'] div[class^='highlight']{border:none;background:none;margin:0}div[class^='highlight'] td.code{width:100%}.linenodiv pre{border-right:solid 1px #e6e9ea;margin:0;padding:12px 12px;font-family:Consolas,\"Andale Mono WT\",\"Andale Mono\",\"Lucida Console\",\"Lucida Sans Typewriter\",\"DejaVu Sans Mono\",\"Bitstream Vera Sans Mono\",\"Liberation Mono\",\"Nimbus Mono L\",Monaco,\"Courier New\",Courier,monospace;font-size:12px;line-height:1.5;color:#d9d9d9}div[class^='highlight'] pre{white-space:pre;margin:0;padding:12px 12px;font-family:Consolas,\"Andale Mono WT\",\"Andale Mono\",\"Lucida Console\",\"Lucida Sans Typewriter\",\"DejaVu Sans Mono\",\"Bitstream Vera Sans Mono\",\"Liberation Mono\",\"Nimbus Mono L\",Monaco,\"Courier New\",Courier,monospace;font-size:12px;line-height:1.5;display:block;overflow:auto;color:#404040}@media print{.codeblock,pre.literal-block,.rst-content .literal-block,.rst-content pre.literal-block,div[class^='highlight'],div[class^='highlight'] pre{white-space:pre-wrap}}.hll{background-color:#ffc;margin:0 -12px;padding:0 12px;display:block}.c{color:#998;font-style:italic}.err{color:#a61717;background-color:#e3d2d2}.k{font-weight:bold}.o{font-weight:bold}.cm{color:#998;font-style:italic}.cp{color:#999;font-weight:bold}.c1{color:#998;font-style:italic}.cs{color:#999;font-weight:bold;font-style:italic}.gd{color:#000;background-color:#fdd}.gd .x{color:#000;background-color:#faa}.ge{font-style:italic}.gr{color:#a00}.gh{color:#999}.gi{color:#000;background-color:#dfd}.gi .x{color:#000;background-color:#afa}.go{color:#888}.gp{color:#555}.gs{font-weight:bold}.gu{color:purple;font-weight:bold}.gt{color:#a00}.kc{font-weight:bold}.kd{font-weight:bold}.kn{font-weight:bold}.kp{font-weight:bold}.kr{font-weight:bold}.kt{color:#458;font-weight:bold}.m{color:#099}.s{color:#d14}.n{color:#333}.na{color:teal}.nb{color:#0086b3}.nc{color:#458;font-weight:bold}.no{color:teal}.ni{color:purple}.ne{color:#900;font-weight:bold}.nf{color:#900;font-weight:bold}.nn{color:#555}.nt{color:navy}.nv{color:teal}.ow{font-weight:bold}.w{color:#bbb}.mf{color:#099}.mh{color:#099}.mi{color:#099}.mo{color:#099}.sb{color:#d14}.sc{color:#d14}.sd{color:#d14}.s2{color:#d14}.se{color:#d14}.sh{color:#d14}.si{color:#d14}.sx{color:#d14}.sr{color:#009926}.s1{color:#d14}.ss{color:#990073}.bp{color:#999}.vc{color:teal}.vg{color:teal}.vi{color:teal}.il{color:#099}.gc{color:#999;background-color:#EAF2F5}.wy-breadcrumbs li{display:inline-block}.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}.wy-breadcrumbs li a{display:inline-block;padding:5px}.wy-breadcrumbs li a:first-child{padding-left:0}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width: 480px){.wy-breadcrumbs-extra{display:none}.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:before,.wy-menu-horiz:after{display:table;content:\"\"}.wy-menu-horiz:after{clear:both}.wy-menu-horiz ul,.wy-menu-horiz li{display:inline-block}.wy-menu-horiz li:hover{background:rgba(255,255,255,0.1)}.wy-menu-horiz li.divide-left{border-left:solid 1px #404040}.wy-menu-horiz li.divide-right{border-right:solid 1px #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical header{height:32px;display:inline-block;line-height:32px;padding:0 1.618em;display:block;font-weight:bold;text-transform:uppercase;font-size:80%;color:#dd4814;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:solid 1px #404040}.wy-menu-vertical li.divide-bottom{border-bottom:solid 1px #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:gray;border-right:solid 1px #c9c9c9;padding:0.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a{color:#404040;padding:0.4045em 1.618em;font-weight:bold;position:relative;background:#fcfcfc;border:none;border-bottom:solid 1px #c9c9c9;border-top:solid 1px #c9c9c9;padding-left:1.618em -4px}.wy-menu-vertical li.on a:hover,.wy-menu-vertical li.current>a:hover{background:#fcfcfc}.wy-menu-vertical li.toctree-l2.current>a{background:#c9c9c9;padding:0.4045em 2.427em}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical .local-toc li ul{display:block}.wy-menu-vertical li ul li a{margin-bottom:0;color:#b3b3b3;font-weight:normal}.wy-menu-vertical a{display:inline-block;line-height:18px;padding:0.4045em 1.618em;display:block;position:relative;font-size:90%;color:#b3b3b3}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:active{background-color:#dd4814;cursor:pointer;color:#fff}.wy-side-nav-search{z-index:200;background-color:#dd4814;text-align:center;padding:0.809em;display:block;color:#fcfcfc;margin-bottom:0.809em}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#97310e}.wy-side-nav-search img{display:block;margin:auto auto 0.809em auto;height:45px;width:45px;background-color:#dd4814;padding:5px;border-radius:100%}.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a{color:#fcfcfc;font-size:100%;font-weight:bold;display:inline-block;padding:4px 6px;margin-bottom:0.809em}.wy-side-nav-search>a:hover,.wy-side-nav-search .wy-dropdown>a:hover{background:rgba(255,255,255,0.1)}.wy-nav .wy-menu-vertical header{color:#dd4814}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#dd4814;color:#fff}[data-menu-wrap]{-webkit-transition:all 0.2s ease-in;-moz-transition:all 0.2s ease-in;transition:all 0.2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:left repeat-y #fcfcfc;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyRpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMy1jMDExIDY2LjE0NTY2MSwgMjAxMi8wMi8wNi0xNDo1NjoyNyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoTWFjaW50b3NoKSIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDoxOERBMTRGRDBFMUUxMUUzODUwMkJCOThDMEVFNURFMCIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDoxOERBMTRGRTBFMUUxMUUzODUwMkJCOThDMEVFNURFMCI+IDx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOjE4REExNEZCMEUxRTExRTM4NTAyQkI5OEMwRUU1REUwIiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOjE4REExNEZDMEUxRTExRTM4NTAyQkI5OEMwRUU1REUwIi8+IDwvcmRmOkRlc2NyaXB0aW9uPiA8L3JkZjpSREY+IDwveDp4bXBtZXRhPiA8P3hwYWNrZXQgZW5kPSJyIj8+EwrlwAAAAA5JREFUeNpiMDU0BAgwAAE2AJgB9BnaAAAAAElFTkSuQmCC);background-size:300px 1px}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:absolute;top:0;left:0;width:300px;overflow:hidden;min-height:100%;background:#343131;z-index:200}.wy-nav-top{display:none;background:#dd4814;color:#fff;padding:0.4045em 0.809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:before,.wy-nav-top:after{display:table;content:\"\"}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:bold}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#dd4814;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100x;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,0.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:#999}footer p{margin-bottom:12px}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:before,.rst-footer-buttons:after{display:table;content:\"\"}.rst-footer-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:solid 1px #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:solid 1px #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:gray;font-size:90%}@media screen and (max-width: 768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-nav-content-wrap{margin-left:0!important}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width: 1400px){.wy-nav-content-wrap{background:rgba(0,0,0,0.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,footer,.wy-nav-side{display:none}.wy-nav-content-wrap{margin-left:0}}nav.stickynav{position:fixed;top:0}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:\"Lato\",\"proxima-nova\",\"Helvetica Neue\",Arial,sans-serif;z-index:400}.rst-versions a{color:#dd4814;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:\"\"}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .icon{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}.rst-content img{max-width:100%;height:auto !important}.rst-content div.figure{margin-bottom:24px}.rst-content div.figure.align-center{text-align:center}.rst-content .section>img,.rst-content .section>a>img{margin-bottom:24px}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content .note .last,.rst-content .attention .last,.rst-content .caution .last,.rst-content .danger .last,.rst-content .error .last,.rst-content .hint .last,.rst-content .important .last,.rst-content .tip .last,.rst-content .warning .last,.rst-content .seealso .last,.rst-content .admonition-todo .last{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,0.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent !important;border-color:rgba(0,0,0,0.1) !important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha li{list-style:upper-alpha}.rst-content .section ol p,.rst-content .section ul p{margin-bottom:12px}.rst-content .line-block{margin-left:24px}.rst-content .topic-title{font-weight:bold;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0px 0px 24px 24px}.rst-content .align-left{float:left;margin:0px 24px 24px 0px}.rst-content .align-center{margin:auto;display:block}.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink{display:none;visibility:hidden;font-size:14px}.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content dl dt .headerlink:after{visibility:visible;content:\"\";font-family:FontAwesome;display:inline-block}.rst-content h1:hover .headerlink,.rst-content h2:hover .headerlink,.rst-content h3:hover .headerlink,.rst-content h4:hover .headerlink,.rst-content h5:hover .headerlink,.rst-content h6:hover .headerlink,.rst-content dl dt:hover .headerlink{display:inline-block}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:solid 1px #e1e4e5}.rst-content .sidebar p,.rst-content .sidebar ul,.rst-content .sidebar dl{font-size:90%}.rst-content .sidebar .last{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:\"Roboto Slab\",\"ff-tisa-web-pro\",\"Georgia\",Arial,sans-serif;font-weight:bold;background:#e1e4e5;padding:6px 12px;margin:-24px;margin-bottom:24px;font-size:100%}.rst-content .highlighted{background:#F1C40F;display:inline-block;font-weight:bold;padding:0 6px}.rst-content .footnote-reference,.rst-content .citation-reference{vertical-align:super;font-size:90%}.rst-content table.docutils.citation,.rst-content table.docutils.footnote{background:none;border:none;color:#999}.rst-content table.docutils.citation td,.rst-content table.docutils.citation tr,.rst-content table.docutils.footnote td,.rst-content table.docutils.footnote tr{border:none;background-color:transparent !important;white-space:normal}.rst-content table.docutils.citation td.label,.rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}.rst-content table.field-list{border:none}.rst-content table.field-list td{border:none;padding-top:5px}.rst-content table.field-list td>strong{display:inline-block;margin-top:3px}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left;padding-left:0}.rst-content tt{color:#000}.rst-content tt big,.rst-content tt em{font-size:100% !important;line-height:normal}.rst-content tt .xref,a .rst-content tt{font-weight:bold}.rst-content a tt{color:#dd4814}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:bold}.rst-content dl p,.rst-content dl table,.rst-content dl ul,.rst-content dl ol{margin-bottom:12px !important}.rst-content dl dd{margin:0 0 12px 24px}.rst-content dl:not(.docutils){margin-bottom:24px}.rst-content dl:not(.docutils) dt{display:inline-block;margin:6px 0;font-size:90%;line-height:normal;background:#dedede;color:#dd4814;border-top:solid 3px #8ba8af;padding:6px;position:relative}.rst-content dl:not(.docutils) dt:before{color:#8ba8af}.rst-content dl:not(.docutils) dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dl dt{margin-bottom:6px;border:none;border-left:solid 3px #ccc;background:#f0f0f0;color:gray}.rst-content dl:not(.docutils) dl dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dt:first-child{margin-top:0}.rst-content dl:not(.docutils) tt{font-weight:bold}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname{background-color:transparent;border:none;padding:0;font-size:100% !important}.rst-content dl:not(.docutils) tt.descname{font-weight:bold}.rst-content dl:not(.docutils) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:bold}.rst-content dl:not(.docutils) .property{display:inline-block;padding-right:8px}.rst-content .viewcode-link,.rst-content .viewcode-back{display:inline-block;color:#27AE60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:bold}@media screen and (max-width: 480px){.rst-content .sidebar{width:100%}}span[id*='MathJax-Span']{color:#404040}.math{text-align:center}\n/*# sourceMappingURL=theme.css.map */\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/static/js/oldtheme.js", "content": "$( document ).ready(function() {\n // Shift nav in mobile when clicking the menu.\n $(document).on('click', \"[data-toggle='wy-nav-top']\", function() {\n $(\"[data-toggle='wy-nav-shift']\").toggleClass(\"shift\");\n $(\"[data-toggle='rst-versions']\").toggleClass(\"shift\");\n });\n // Close menu when you click a link.\n $(document).on('click', \".wy-menu-vertical .current ul li a\", function() {\n $(\"[data-toggle='wy-nav-shift']\").removeClass(\"shift\");\n $(\"[data-toggle='rst-versions']\").toggleClass(\"shift\");\n });\n $(document).on('click', \"[data-toggle='rst-current-version']\", function() {\n $(\"[data-toggle='rst-versions']\").toggleClass(\"shift-up\");\n }); \n // Make tables responsive\n $(\"table.docutils:not(.field-list)\").wrap(\"
    \");\n});\n\nwindow.SphinxRtdTheme = (function (jquery) {\n var stickyNav = (function () {\n var navBar,\n win,\n stickyNavCssClass = 'stickynav',\n applyStickNav = function () {\n if (navBar.height() <= win.height()) {\n navBar.addClass(stickyNavCssClass);\n } else {\n navBar.removeClass(stickyNavCssClass);\n }\n },\n enable = function () {\n applyStickNav();\n win.on('resize', applyStickNav);\n },\n init = function () {\n navBar = jquery('nav.wy-nav-side:first');\n win = jquery(window);\n };\n jquery(init);\n return {\n enable : enable\n };\n }());\n return {\n StickyNav : stickyNav\n };\n}($));\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/static/js/theme.js", "content": "$(document).ready(function () {\n // Shift nav in mobile when clicking the menu.\n $(document).on('click', \"[data-toggle='wy-nav-top']\", function () {\n $(\"[data-toggle='wy-nav-shift']\").toggleClass(\"shift\");\n $(\"[data-toggle='rst-versions']\").toggleClass(\"shift\");\n });\n // Close menu when you click a link.\n $(document).on('click', \".wy-menu-vertical .current ul li a\", function () {\n $(\"[data-toggle='wy-nav-shift']\").removeClass(\"shift\");\n $(\"[data-toggle='rst-versions']\").toggleClass(\"shift\");\n });\n $(document).on('click', \"[data-toggle='rst-current-version']\", function () {\n $(\"[data-toggle='rst-versions']\").toggleClass(\"shift-up\");\n });\n // Make tables responsive\n $(\"table.docutils:not(.field-list)\").wrap(\"
    \");\n // ---\n // START DOC MODIFICATION BY RUFNEX\n // v1.0 04.02.2015\n // Add ToogleButton to get FullWidth-View by Johannes Gamperl codeigniter.de\n\n $('#openToc').click(function () {\n $('#nav').slideToggle();\n });\n $('#closeMe').click(function () {\n if (getCookie('ciNav') != 'yes') {\n setCookie('ciNav', 'yes', 365);\n } else {\n setCookie('ciNav', 'no', 365);\n }\n tocFlip();\n });\n var tocFlip = function(){\n if (getCookie('ciNav') == 'yes') {\n $('#nav2').show();\n $('#topMenu').remove();\n $('body').css({ background: 'none' });\n $('.wy-nav-content-wrap').css({ background: 'none', 'margin-left': 0 });\n $('.wy-breadcrumbs').append('
    ' + $('.wy-form').parent().html() + '
    ');\n $('.wy-nav-side').toggle();\n } else {\n $('#topMenu').remove();\n $('#nav').hide();\n $('#nav2').hide();\n $('body').css({ background: '#edf0f2;' });\n $('.wy-nav-content-wrap').css({ background: 'none repeat scroll 0 0 #fcfcfc;', 'margin-left': '300px' });\n $('.wy-nav-side').show();\n }\n };\n if (getCookie('ciNav') == 'yes')\n {\n tocFlip();\n //$('#nav').slideToggle();\n }\n // END MODIFICATION ---\n\n});\n\n// Rufnex Cookie functions\nfunction setCookie(cname, cvalue, exdays) {\n // expire the old cookie if existed to avoid multiple cookies with the same name\n if (getCookie(cname)) {\n document.cookie = cname + \"=;expires=Thu, 01 Jan 1970 00:00:00 GMT\";\n }\n var d = new Date();\n d.setTime(d.getTime() + (exdays * 24 * 60 * 60 * 1000));\n var expires = \"expires=\" + d.toGMTString();\n document.cookie = cname + \"=\" + cvalue + \"; \" + expires + \"; path=/\";\n}\nfunction getCookie(cname) {\n var name = cname + \"=\";\n var ca = document.cookie.split(';');\n for (var i = 0; i < ca.length; i++) {\n var c = ca[i];\n while (c.charAt(0) == ' ')\n c = c.substring(1);\n if (c.indexOf(name) == 0) {\n return c.substring(name.length, c.length);\n }\n }\n return '';\n}\n// End\n\n// resize window\n$(window).on('resize', function(){\n // show side nav on small screens when pulldown is enabled\n if (getCookie('ciNav') == 'yes' && $(window).width() <= 768) { // 768px is the tablet size defined by the theme\n $('.wy-nav-side').show();\n }\n // changing css with jquery seems to override the default css media query\n // change margin\n else if (getCookie('ciNav') == 'no' && $(window).width() <= 768) {\n $('.wy-nav-content-wrap').css({'margin-left': 0});\n }\n // hide side nav on large screens when pulldown is enabled\n else if (getCookie('ciNav') == 'yes' && $(window).width() > 768) {\n $('.wy-nav-side').hide();\n }\n // change margin\n else if (getCookie('ciNav') == 'no' && $(window).width() > 768) {\n $('.wy-nav-content-wrap').css({'margin-left': '300px'});\n }\n});\n\nwindow.SphinxRtdTheme = (function (jquery) {\n var stickyNav = (function () {\n var navBar,\n win,\n stickyNavCssClass = 'stickynav',\n applyStickNav = function () {\n if (navBar.height() <= win.height()) {\n navBar.addClass(stickyNavCssClass);\n } else {\n navBar.removeClass(stickyNavCssClass);\n }\n },\n enable = function () {\n applyStickNav();\n win.on('resize', applyStickNav);\n },\n init = function () {\n navBar = jquery('nav.wy-nav-side:first');\n win = jquery(window);\n };\n jquery(init);\n return {\n enable: enable\n };\n }());\n return {\n StickyNav: stickyNav\n };\n}($));\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/theme.conf", "content": "[theme]\ninherit = basic\nstylesheet = css/citheme.css\n\n[options]\ntypekit_id = hiw1hhg\nanalytics_id = \nsticky_navigation = False\n" }, { "path": "user_guide_src/source/_themes/sphinx_rtd_theme/versions.html", "content": "{% if READTHEDOCS %}\n{# Add rst-badge after rst-versions for small badge style. #}\n
    \n \n Read the Docs\n v: {{ current_version }}\n \n \n
    \n
    \n
    Versions
    \n {% for slug, url in versions %}\n
    {{ slug }}
    \n {% endfor %}\n
    \n
    \n
    Downloads
    \n {% for type, url in downloads %}\n
    {{ type }}
    \n {% endfor %}\n
    \n
    \n
    On Read the Docs
    \n
    \n Project Home\n
    \n
    \n Builds\n
    \n
    \n
    \n Free document hosting provided by Read the Docs.\n\n
    \n
    \n{% endif %}\n\n" }, { "path": "user_guide_src/source/changelog.rst", "content": "##########\nChange Log\n##########\n\nVersion 3.2.0\n=============\n\nRelease Date: Not Released\n\n- General Changes\n\n - Officially dropped any kind of support for anything under PHP 5.4.8.\n - Updated Welcome view and HTML error templates with new styling.\n - Updated configurable directory paths to handle missing trailing ``DIRECTORY_SEPARATOR`` automatically.\n - Added support for HTTP status codes 103, 207, 308, 421 and 451 to :doc:`common function ` :php:func:`set_status_header()`.\n\n- Core\n\n - Added a ``$config['log_file']`` option.\n - Removed ``$config['log_file_extension']``.\n - Removed ``$config['rewrite_short_tags']`` (irrelevant on PHP 5.4+).\n - Removed previously deprecated ``$config['global_xss_filtering']``.\n - Removed previously deprecated :doc:`Routing Class ` methods ``fetch_directory()``, ``fetch_class()`` and ``fetch_method()`` (use the respective class properties instead).\n - Removed previously deprecated :doc:`Config Library ` method ``system_url()`` (encourages insecure practices).\n - Changed :doc:`URI Library ` to ignore the ``$config['url_suffix']``, ``$config['permitted_uri_chars']`` configuration settings for CLI requests.\n - Changed :doc:`Loader ` method ``model()`` to always check if the loaded class extends ``CI_Model``.\n - Changed :doc:`Output Library ` method ``_display()`` default parameter value to ``NULL`` instead of empty string.\n\n - :doc:`Input Library ` changes include:\n\n - Removed previously deprecated ``$config['allow_get_array']``.\n - Removed previously deprecated ``$config['standardize_newlines']``.\n - Removed previously deprecated method ``is_cli_request()`` (use :php:func:`is_cli()` instead).\n - Changed the ``set_cookie()`` method's default expiry time to 0 (expires when browser is closed).\n - Changed the ``set_cookie()`` method to delete the cookie if a negative expiry time is passed to it.\n - Allowed usage of nested array keys in ``get_post()``, ``post_get()`` methods.\n\n- Libraries\n\n - Removed previously deprecated *Encrypt Library*.\n - Removed previously deprecated *Cart Library*.\n - Removed previously deprecated *Javascript Library* (it was always experimental in the first place).\n - Removed previously deprecated ``anchor_class`` option from :doc:`Pagination Library `.\n - Added TLS and UNIX socket connection support to :doc:`Session Library ` 'redis' driver.\n - Updated :doc:`ZIP Library ` method ``read_dir()`` to include hidden (dot-prefixed) files.\n\n - :doc:`Cache Library ` changes include:\n\n - Added 'apcu' driver.\n - Added UNIX socket connection support to the 'memcached' driver.\n - Added 'database' configuration option to the 'redis' driver, allowing to auto-select another database.\n - Added method ``get_loaded_driver()`` to return the currently used driver.\n - Changed the 'memcached' driver to ignore configurations that don't specify a hostname.\n - Removed the *socket_type* configuration setting from the 'redis' driver.\n - Changed data serialization logic in 'redis' driver for better performance.\n\n - :doc:`Form Validation Library ` changes include:\n\n - Removed previously deprecated method ``prep_for_form()`` / rule *prep_for_form*.\n - Removed previously deprecated ability to use language translations without the ``'form_validation_'`` prefix.\n - Changed method ``set_rules()`` to throw a ``BadMethodCallException`` when its first parameter is not an array and the ``$rules`` one is unused.\n - Added rule **valid_mac**, which replicates PHP's native ``filter_var()`` with ``FILTER_VALIDATE_MAC``.\n - Added ability to validate entire arrays at once, if ``is_array`` is within the list of rules.\n - Added ability to fetch processed data via a second parameter to ``run()``.\n\n - :doc:`HTML Table Library ` changes include:\n\n - Changed method ``clear()`` to also reset captions.\n\n - :doc:`Email Library ` changes include:\n\n - Changed the default value of the **validate** option to ``TRUE``.\n - Changed the ``send()`` method to always return ``TRUE`` when sending multiple batches of emails.\n\n\n - :doc:`Image Manipulation Library ` changes include:\n\n - Added option to change the output filename via the ``new_name`` option when rendering images with ``dynamic_output``.\n - Updated to serve multibyte filenames when rendering images with ``dynamic_output``, if possible.\n - Added WebP image support.\n\n- :doc:`Database ` changes include:\n\n - Removed the option to disable the :doc:`Query Builder `.\n - Removed driver-specific ``$curs_id`` property and ``get_cursor()``, ``stored_procedure()`` methods from OCI8 driver.\n - Removed previously deprecated 'sqlite' driver (used for SQLite version 2; no longer shipped with PHP 5.4+).\n - Removed method ``db_set_charset()`` and the ability to change a connection character set at runtime.\n - Changed method ``initialize()`` to return void and instead throw a ``RuntimeException`` in case of failure.\n - Changed method ``db_connect()`` to always set the connection character set (if supported by the driver) and to fail if it can't.\n\n - :doc:`Database Forge `:\n\n - Added support for declaring date/time type fields default values as ``CURRENT_TIMESTAMP`` and similar.\n - Removed previously deprecated ``$_after`` parameter for ``add_column()``.\n\n - :doc:`Query Builder `:\n\n - Added methods ``having_in()``, ``or_having_in()``, ``not_having_in()``, ``or_not_having_in()``.\n - Updated methods ``where_in()``, ``or_where_in()``, ``not_where_in()``, ``or_not_where_in()`` to reject non-array inputs for the second parameter.\n - Updated method ``join()`` to allow accepting ``NATURAL`` clauses in its third parameter.\n - Updated logic to allow dots in alias names.\n\n- Helpers\n\n - Removed previously deprecated *Email Helper* (had only two functions, aliases for PHP's native ``filter_var()`` and ``mail()``).\n - Removed previously deprecated *Smiley Helper*.\n - Removed previously deprecated :doc:`Date Helper ` function ``standard_date()`` (use PHP's native ``date()`` instead).\n - Removed previously deprecated :doc:`Date Helper ` function ``nice_date()`` (use PHP's native ``DateTime::format()`` instead).\n - Removed previously deprecated :doc:`Security Helper ` function ``do_hash()`` (use PHP's native ``hash()`` instead).\n - Removed previously deprecated :doc:`File Helper ` function ``read_file()`` (use PHP's native ``file_get_contents()`` instead).\n - Removed previously deprecated options ``'dash'`` and ``'underscore'`` from :doc:`URL Helper ` function :php:func:`url_title()`.\n - Added new function :php:func:`ordinal_format()` to :doc:`Inflector Helper `.\n\n - :doc:`Download Helper ` changes include:\n\n - Updated :php:func:`force_download()` to allow existing files to be renamed for download.\n - Updated :php:func:`force_download()` to better utilize available server memory.\n - Updated :php:func:`force_download()` to serve multibyte filenames when possible, via the ``filename*`` attribute specified by IETF `RFC 6266 `_.\n\n - :doc:`String Helper ` changes include:\n\n - Removed previously deprecated function ``trim_slashes()`` (use PHP's native ``trim()`` with ``'/'`` instead).\n - Removed previously deprecated function ``repeater()`` (use PHP's native ``str_repeat()`` instead).\n - Removed previously deprecated ``'unique'`` and ``'encrypt'`` options from ``random_string()``.\n\n - :doc:`HTML Helper ` changes include:\n\n - Removed previously deprecated function ``br()`` (use PHP's native ``str_repeat()`` with ``'
    '`` instead).\n - Removed previously deprecated function ``nbs()`` (use PHP's native ``str_repeat()`` with ``' '`` instead).\n - Updated function :php:func:`meta()` with support for \"charset\" and \"property\" properties.\n - Changed function :php:func:`doctype()` default document type to HTML 5.\n\n - :doc:`Form Helper ` changes include:\n\n - Removed previously deprecated function ``form_prep()`` (use :php:func:`html_escape()` instead).\n - Removed the second (out of three) parameter from the :php:func:`form_upload()` function (it was never used).\n\n - :doc:`CAPTCHA Helper ` changes include:\n\n - Added 'img_alt' option with a default value of 'captcha'.\n - Added 'img_class' option.\n - Added ability to generate ``data:image/png;base64`` URIs instead of writing image files to disk.\n - Updated to always create PNG images instead of JPEG.\n - Removed previously deprecated usage with ``$img_path``, ``$img_url``, ``$font_path`` as extra parameters instead of array options.\n\nBug fixes for 3.2.0\n===================\n\n- Fixed a bug (#5562) - :doc:`Cache Library ` 'redis' driver would pointlessly attempt to perform its functions if a connection to the Redis server failed.\n- Fixed a bug (#92) - :doc:`File Helper ` function :php:func:`get_dir_file_info()` output could have colliding array keys.\n\nVersion 3.1.13\n==============\n\nRelease Date: Mar 3, 2022\n\nBug fixes for 3.1.13\n====================\n\n- Fixed a bug (#6107) - :doc:`Session Library ` broke for PHP 5 due to a misnamed polyfill interface.\n\nVersion 3.1.12\n==============\n\nRelease Date: Mar 3, 2022\n\n- **Security**\n\n - Fixed a possible session fixation vulnerability where ``session.use_strict_mode`` wasn't enforced on PHP 7+.\n\n- General Changes\n\n - Improved logging of error conditions in :doc:`CAPTCHA Helper ` function :php:func:`create_captcha()`.\n - Added ``AUTO_INCREMENT`` support for Oracle 12.1+ to :doc:`Database Forge `.\n - Added ``FULL [OUTER] JOIN`` support to :doc:`Query Builder `.\n - Added support for detecting WebP image type to :doc:`File Uploading Library `.\n - Added method :doc:`Database Library ` method ``trans_active()`` to expose transaction state.\n - Updated :doc:`Database Library ` 'pdo' driver to attempt to free resources in order to allow connections to be closed.\n - Added ``SameSite=Strict`` attribute to the CSRF cookie sent by the :doc:`Security Class `.\n - Added ``$config['cookie_samesite']`` option and ``$samesite`` parameter to :doc:`Input Library ` method ``set_cookie()``.\n - Added ``SameSite`` support through ``$config['sess_samesite']`` option to the :doc:`Session Library `.\n - Added a wrapper class around :doc:`Session ` drivers to deal with compatibility between PHP 8.1 and older versions.\n - Updated a lot of code for PHP 8.0 and 8.1 compatibility.\n\nBug fixes for 3.1.12\n====================\n\n- Fixed a bug (#5834) - :doc:`Query Builder ` method ``count_all_results()`` triggered an SQL error for queries with a ``HAVING`` clause.\n- Fixed a bug (#5840) - :doc:`Cache Library ` 'redis' driver triggered an ``E_DEPRECATED`` warning about ``sRemove()`` with phpRedis 5.\n- Fixed a bug (#5857) - :doc:`Session ` data could be corrupted after a concurrent request write with the 'files' driver due to a filesize cache being incorrect.\n- Fixed a bug (#5861) - :doc:`Cache Library ` 'redis' driver would always use phpRedis 5 ``del()`` due to an incorrect version check.\n- Fixed a bug (#5879) - :doc:`Profiler Library ` triggered an ``E_DEPRECATED`` warning on PHP 7.4+.\n- Fixed a bug (#5901) - :doc:`Database Library ` methods ``list_fields()`` and ``field_data()`` ignored the configured table schema on PostgreSQL.\n- Fixed a bug (#5906) - :doc:`Database Library ` 'postgre' driver couldn't use the failover feature without a ``$config['dsn']``.\n- Fixed a bug (#5903) - :doc:`common function ` :php:func:`set_status_header()` didn't recognize 'HTTP/2.0' as a valid ``$_SERVER['SERVER_PROTOCOL']``.\n- Fixed a bug (#6013) - :doc:`Session ` flashdata didn't work on PHP 8.\n- Fixed a bug (#6006) - ``is_callable()`` change in PHP 8 broke :doc:`Migrations `, a part of :doc:`XML-RPC ` and an edge case in 404 detection logic.\n- Fixed a bug (#5729) - :doc:`Query Builder ` possibly not detecting ``NOT BETWEEN`` expression.\n\nVersion 3.1.11\n==============\n\nRelease Date: Sep 19, 2019\n\n- General Changes\n\n - Changed ``CI_Log`` to append ``PHP_EOL`` instead of ``\\n`` at the end of log messages.\n - Improved performance in :doc:`Cache Library ` 'redis' driver with non-scalar variables.\n - Altered the :doc:`Session Library ` 'files' driver to log error and trigger a session start failure instead of throwing an ``Exception`` in case of unusable ``$config['sess_save_path']``.\n - Updated the :doc:`Session ` and :doc:`Cache ` libraries' 'redis' driver to work with phpRedis 5.\n\nBug fixes for 3.1.11\n--------------------\n\n- Fixed a bug (#5681) - :doc:`Database Forge ` method ``modify_column()`` produced erroneous SQL for ``DEFAULT`` attribute changes under PostgreSQL, Firebird.\n- Fixed a bug (#5692) - :doc:`Database Forge ` didn't handle column nullability with the 'oci8', 'pdo/oci' drivers.\n- Fixed a bug (#5701) - :doc:`Database ` driver 'pdo/pgsql' produced incorrect DSNs when constructing from a configuration array.\n- Fixed a bug (#5708) - :doc:`Session Library ` 'redis' driver too often failed with locking-related errors that could've been avoided.\n- Fixed a bug (#5703) - :doc:`Session Library ` triggered an ``E_WARNING`` message about changing ``session.save_path`` during an active session when it fails to obtain a lock.\n- Fixed a bug where :doc:`Session Library ` 'database' driver didn't trigger a failure if it can't obtain a lock.\n- Fixed a bug (#5755) - :doc:`Form Validation Library ` rule **valid_url** accepted digit-only domains due to a PHP bug.\n- Fixed a bug (#5753) - :doc:`Cache Library ` 'redis' driver methods ``increment()``, ``decrement()`` ignored their ``$offset`` parameter.\n- Fixed a bug (#5779) - :doc:`Session Library ` 'redis' only attempted to validate session IDs in case the connection to Redis failed.\n- Fixed a bug (#5774) - :doc:`Database Results ` method ``custom_result_object()`` didn't properly handle empty result sets, triggering ``E_WARNING`` messages on PHP 7.2+.\n- Fixed a bug (#5788) - :doc:`Database Results ` method ``field_data()`` triggered an ``E_NOTICE`` error with PDO when a field type is not recognized by PHP.\n- Fixed a bug (#5796) - :doc:`Query Builder ` method ``list_tables()`` triggered an SQL syntax error under MySQL when the database schema is a numeric string.\n- Fixed a bug where :doc:`Security Class ` would trigger an ``E_WARNING`` if CSRF inputs are arrays instead of strings.\n\nVersion 3.1.10\n==============\n\nRelease Date: Jan 16, 2019\n\n- General Changes\n\n - Added 'ssl_verify' support to the 'pdo/mysql' :doc:`Database ` driver.\n - Renamed :doc:`Inflector Helper ` function ``is_countable()`` to :php:func:`word_is_countable()` due to the former colliding with one introduced in PHP 7.3.0.\n\nBug fixes for 3.1.10\n--------------------\n\n- Fixed a bug (#5526) - :doc:`Session Library ` had a syntax error in its 'memcached' driver.\n- Fixed a bug (#5542) - :doc:`Database Forge ` method ``modify_column()`` always made fields ``NOT NULL`` when attempting to modify their nullable property under PostgreSQL.\n- Fixed a bug (#5561) - :doc:`Database Library ` didn't allow SSL connection configuration with only the 'ssl_verify' option when using the 'mysqli' driver.\n- Fixed a bug (#5545) - :doc:`Session Library ` crashed due to a caching-related error with the 'files' driver.\n- Fixed a bug (#5571) - :doc:`XML-RPC Library ` had a typo that triggered an ``E_WARNING`` message on PHP 7.2.\n- Fixed a bug (#5587) - :doc:`Database Forge ` method ``create_table()`` generated an ``E_WARNING`` message.\n- Fixed a bug (#5590) - :doc:`Form Validation Library ` rule **valid_base64** didn't have a default error message.\n- Fixed a bug (#5624) - :doc:`Database Library ` methods ``list_fields()``, ``field_exists()`` returned incorrect results after tables are modified.\n- Fixed a bug (#5627) - :doc:`Database ` driver 'mysqli' triggered an ``E_WARNING`` message if there's no ``'port'`` specified in the database configuration.\n- Fixed a bug (#5651) - :doc:`Database Caching ` could try to delete non-existent cache files due to a race condition.\n- Fixed a bug (#5652) - :doc:`CAPTCHA Helper ` function :php:func:`create_captcha()` didn't comply with CSS standards.\n- Fixed a bug (#5605) - :doc:`Form Validation Library ` didn't nullify array inputs that are expected to be strings.\n\nVersion 3.1.9\n=============\n\nRelease Date: Jun 12, 2018\n\n- **Security**\n\n - Updated :doc:`URL Helper ` function :php:func:`auto_link()` to add ``rel=\"noopener\"`` to generated links in order to prevent tab hijacking.\n - Fixed a possible session fixation vulnerability where the :doc:`Session Library ` enabled ``session.use_strict_mode`` but it didn't actually do anything (thanks to Aamer Shah, Prasanna Kumar).\n\n- General Changes\n\n - Updated :doc:`Query Builder ` method ``limit()`` to allow ``0`` values.\n - Updated :doc:`Email Library ` and :doc:`Form Validation Library ` to discard the results of failed ``idn_to_ascii()`` calls while validating e-mail addresses.\n\nBug fixes for 3.1.9\n-------------------\n\n- Fixed a regression (#5448) - :doc:`Query Builder ` methods ``like()``, ``or_like()`` (and siblings) didn't apply *dbprefix* or identifier escaping.\n- Fixed a regression (#5462) - :doc:`Query Builder ` methods ``like()``, ``or_like()`` (and siblings) produced incorrect SQL syntax when used with ``'before'`` as the third parameter.\n- Fixed a bug (#5516) - :doc:`HTML Helper ` functions :php:func:`img()`, :php:func:`link_tag()` would output results with double slashes if a prefix slash was included in their path inputs.\n\nVersion 3.1.8\n=============\n\nRelease Date: Mar 22, 2018\n\n- **Security**\n\n - Updated :doc:`Security Library ` method ``xss_clean()`` to also filter JavaScript tag functions.\n - Fixed a bug where :doc:`Security Library ` method ``xss_clean()`` didn't check for parentheses around JavaScript's ``document``.\n\n- General Changes\n\n - Updated :doc:`Email Library ` to always negotiate between TLS 1.0, 1.1, 1.2 when possible (PHP 5.6+) for SMTP connections.\n - Updated :doc:`Database Library ` method ``version()`` to exclude suffixes to the main version numbers with the 'postgre' driver.\n\nBug fixes for 3.1.8\n-------------------\n\n- Fixed a bug where :doc:`Form Validation Library `, :doc:`Email Library ` tried to use ``INTL_IDNA_VARIANT_UTS46`` when it was undeclared.\n- Fixed a bug where :doc:`Query Builder ` methods ``where()``, ``having()`` treated values passed to them as arbitrary SQL.\n- Fixed a bug (#5423) - :doc:`Database Library ` method ``insert_id()`` failed due to incorrect server version parsing with the 'postgre' driver.\n- Fixed a bug (#5425) - :doc:`XML-RPC Library ` produced an error message related to ``count()`` on PHP 7.2.\n- Fixed a bug (#5434) - :doc:`Image Manipulation Library ` attempted to ``chmod()`` while rendering images with the ``dynamic_output`` option.\n- Fixed a bug (#5435) - :doc:`Database Results ` method ``field_data()`` hid info about one field if ``limit()`` was previously used with the 'oci8' driver.\n\nVersion 3.1.7\n=============\n\nRelease Date: Jan 13, 2018\n\n- General Changes\n\n - Updated :doc:`Form Validation Library ` rule ``valid_email`` to use ``INTL_IDNA_VARIANT_UTS46`` for non-ASCII domain names.\n - Updated :doc:`Email Library ` to use ``INTL_IDNA_VARIANT_UTS46`` for non-ASCII domain names.\n - Updated :doc:`Loader Library ` method ``model()`` to log both ``CI_Model`` class loading and individual models' initialization.\n - Updated :doc:`Pagination Library ` to preserve previously set attributes while calling ``initialize()``.\n - Updated :doc:`Cache Library ` to automatically add items to cache on ``increment()``, ``decrement()`` calls for missing keys.\n - Deprecated usage of :doc:`CAPTCHA Helper ` function :php:func:`create_captcha()` with parameters other than ``$data``.\n\nBug fixes for 3.1.7\n-------------------\n\n- Fixed a regression (#5276) - :doc:`Database Utilities ` method ``backup()`` generated incorrect ``INSERT`` statements with the 'mysqli' driver.\n- Fixed a regression where :doc:`Database Results ` method ``field_data()`` returned incorrect type names.\n- Fixed a bug (#5278) - :doc:`URL Helper ` function :php:func:`auto_link()` didn't detect trailing slashes in URLs.\n- Fixed a regression (#5282) - :doc:`Query Builder ` method ``count_all_results()`` breaks ``ORDER BY`` clauses for subsequent queries.\n- Fixed a bug (#5279) - :doc:`Query Builder ` didn't account for already escaped identifiers while applying database name prefixes.\n- Fixed a bug (#5331) - :doc:`URL Helper ` function :php:func:`auto_link()` converted e-mail addresses starting with 'www.' to both \"url\" and \"email\" links.\n- Fixed a bug where ``$config['allow_get_array']`` defaulted to ``FALSE`` if it didn't exist in the config file.\n- Fixed a bug (#5379) - :doc:`Session Library ` would incorrectly fail to obtain a lock that it already has on PHP 7 with the 'memcached' driver.\n\nVersion 3.1.6\n=============\n\nRelease Date: Sep 25, 2017\n\n- **Security**\n\n - Fixed a potential object injection in :doc:`Cache Library ` 'apc' driver when ``save()`` is used with ``$raw = TRUE`` (thanks to Tomas Bortoli).\n\n- General Changes\n\n - Deprecated :doc:`Cache Library Library ` driver 'apc'.\n - Updated the :doc:`Session Library ` 'redis', 'memcached' drivers to reduce the potential of a locking race conditions.\n\n\nBug fixes for 3.1.6\n-------------------\n\n- Fixed a bug (#5164) - :doc:`Loader Library ` method ``library()`` ignored requests to load libraries previously assigned to super-object properties named differently than the library name.\n- Fixed a bug (#5168) - :doc:`Query Builder ` method ``count_all_results()`` produced erroneous queries on Microsoft SQL Server when ``ORDER BY`` clauses are cached.\n- Fixed a bug (#5128) - :doc:`Profiler ` didn't wrap ``$_SESSION`` and configuration arrays in ``
    `` tags.\n-  Fixed a bug (#5183) - :doc:`Database Library ` method ``is_write_type()`` didn't return TRUE for ``MERGE`` statements.\n-  Fixed a bug where :doc:`Image Manipulation Library ` didn't escape image source paths passed to NetPBM as shell arguments.\n-  Fixed a bug (#5236) - :doc:`Query Builder ` methods ``limit()``, ``offset()`` break SQL Server 2005, 2008 queries with ``\"\".*`` in the ``SELECT`` clause.\n-  Fixed a bug (#5243) - :doc:`Database Library ` method ``version()`` didn't work with the 'pdo/dblib' driver.\n-  Fixed a bug (#5246) - :doc:`Database transactions ` status wasn't reset unless ``trans_complete()`` was called.\n-  Fixed a bug (#5260) - :doc:`Database Utilities ` method ``backup()`` generated incorrect ``INSERT`` statements with the 'mysqli' driver.\n-  Fixed a bug where :doc:`Database Results ` method ``field_data()`` didn't parse field types with the 'mysqli' driver.\n\nVersion 3.1.5\n=============\n\nRelease Date: Jun 19, 2017\n\n-  **Security**\n\n   -  :doc:`Form Validation Library ` rule ``valid_email`` could be bypassed if ``idn_to_ascii()`` is available.\n\n-  General Changes\n\n   -  Updated :doc:`Form Helper ` function :php:func:`form_label()` to accept HTML attributes as a string.\n\nBug fixes for 3.1.5\n-------------------\n\n-  Fixed a bug (#5070) - :doc:`Email Library ` didn't properly detect 7-bit encoding.\n-  Fixed a bug (#5084) - :doc:`XML-RPC Library ` errored because of a variable name typo.\n-  Fixed a bug (#5108) - :doc:`Inflector Helper ` function :php:func:`singular()` didn't properly handle 'quizzes'.\n-  Fixed a regression (#5131) - private controller methods triggered PHP errors instead of a 404 response.\n-  Fixed a bug (#5150) - :doc:`Database Forge ` method ``modify_column()`` triggered an error while renaming columns with the 'oci8', 'pdo/oci' drivers.\n-  Fixed a bug (#5155) - :doc:`Query Builder ` method ``count_all_results()`` returned incorrect result for queries using ``LIMIT``, ``OFFSET``.\n\nVersion 3.1.4\n=============\n\nRelease Date: Mar 20, 2017\n\n-  **Security**\n\n   -  Fixed a header injection vulnerability in :doc:`common function ` :php:func:`set_status_header()` under Apache (thanks to Guillermo Caminer from `Flowgate `_).\n   -  Fixed byte-safety issues in **Encrypt Library** (DEPRECATED) when ``mbstring.func_overload`` is enabled.\n   -  Fixed byte-safety issues in :doc:`Encryption Library ` when ``mbstring.func_overload`` is enabled.\n   -  Fixed byte-safety issues in :doc:`compatibility functions ` ``password_hash()``, ``hash_pbkdf2()`` when ``mbstring.func_overload`` is enabled.\n   -  Updated **Encrypt Library** (DEPRECATED) to call ``mcrypt_create_iv()`` with ``MCRYPT_DEV_URANDOM``.\n\n-  General Changes\n\n   -  Updated the :doc:`Image Manipulation Library ` to work-around an issue with some JPEGs when using GD.\n\nBug fixes for 3.1.4\n-------------------\n\n-  Fixed a regression (#4975) - :doc:`Loader Library ` couldn't handle objects passed as view variables.\n-  Fixed a bug (#4977) - :doc:`Loader Library ` method ``helper()`` could accept any character as a filename extension separator.\n-  Fixed a regression where the :doc:`Session Library ` would fail on a ``session_regenerate_id(TRUE)`` call with the 'database' driver.\n-  Fixed a bug (#4987) - :doc:`Query Builder ` caching didn't keep track of table aliases.\n-  Fixed a bug where :doc:`Text Helper ` function ``ascii_to_entities()`` wasn't byte-safe when ``mbstring.func_overload`` is enabled.\n-  Fixed a bug where ``CI_Log``, ``CI_Output``, ``CI_Email`` and ``CI_Zip`` didn't handle strings in a byte-safe manner when ``mbstring.func_overload`` is enabled.\n-  Fixed a bug where :doc:`Session Library ` didn't read session data in a byte-safe manner when ``mbstring.func_overload`` is enabled.\n-  Fixed a bug (#4990) - :doc:`Profiler ` didn't close ``
    `` tags it generated.\n-  Fixed a bug (#4990) - :doc:`Profiler ` didn't HTML-escape quotes for ``$_SESSION`` variables.\n-  Fixed a bug where :doc:`Input Library ` method ``set_cookie()`` didn't allow its *httponly* and *secure* parameters to be overriden to ``FALSE``.\n-  Fixed a bug (#5006) - :doc:`common function ` :php:func:`get_mimes()` didn't load *application/config/mimes.php* if an environment specific config exists.\n-  Fixed a bug (#5006) - :doc:`common function ` :php:func:`remove_invisible_characters()` didn't remove URL-encoded ``0x7F``.\n-  Fixed a bug (#4815) - :doc:`Database Library ` stripped URL-encoded sequences while escaping strings with the 'mssql' driver.\n-  Fixed a bug (#5044) - :doc:`HTML Helper ` function :php:func:`img()` didn't accept ``data:`` URI schemes for the image source.\n-  Fixed a bug (#5050) - :doc:`Database Library ` tried to access an undefined property in a number of error handling cases.\n-  Fixed a bug (#5057) - :doc:`Database ` driver 'postgre' didn't actually apply extra options (such as 'connect_timeout') to its DSN.\n\nVersion 3.1.3\n=============\n\nRelease Date: Jan 09, 2017\n\n-  **Security**\n\n   -  Fixed an XSS vulnerability in :doc:`Security Library ` method ``xss_clean()``.\n   -  Fixed a possible file inclusion vulnerability in :doc:`Loader Library ` method ``vars()``.\n   -  Fixed a possible remote code execution vulnerability in the :doc:`Email Library ` when 'mail' or 'sendmail' are used (thanks to Paul Buonopane from `NamePros `_).\n   -  Added protection against timing side-channel attacks in :doc:`Security Library ` method ``csrf_verify()``.\n   -  Added protection against BREACH attacks targeting the CSRF token field generated by :doc:`Form Helper ` function :php:func:`form_open()`.\n\n-  General Changes\n\n   -  Deprecated ``$config['allow_get_array']``.\n   -  Deprecated ``$config['standardize_newlines']``.\n   -  Deprecated :doc:`Date Helper ` function ``nice_date()``.\n\nBug fixes for 3.1.3\n-------------------\n\n-  Fixed a bug (#4886) - :doc:`Database Library ` didn't differentiate bind markers inside double-quoted strings in queries.\n-  Fixed a bug (#4890) - :doc:`XML-RPC Library ` didn't work on PHP 7.\n-  Fixed a regression (#4887) - :doc:`File Uploading Library ` triggered fatal errors due to numerous PHP distribution channels (XAMPP and cPanel confirmed) explicitly disabling ext/fileinfo by default.\n-  Fixed a bug (#4679) - :doc:`Input Library ` method ``ip_address()`` didn't properly resolve ``$config['proxy_ips']`` IPv6 addresses.\n-  Fixed a bug (#4902) - :doc:`Image Manipulation Library ` processing via ImageMagick didn't work.\n-  Fixed a bug (#4905) - :doc:`Loader Library ` didn't take into account possible user-provided directory paths when loading helpers.\n-  Fixed a bug (#4916) - :doc:`Session Library ` with ``sess_match_ip`` enabled was unusable for IPv6 clients when using the 'database' driver on MySQL 5.7.5+.\n-  Fixed a bug (#4917) - :doc:`Date Helper ` function ``nice_date()`` didn't handle YYYYMMDD inputs properly.\n-  Fixed a bug (#4923) - :doc:`Session Library ` could execute an erroneous SQL query with the 'database' driver, if the lock attempt times out.\n-  Fixed a bug (#4927) - :doc:`Output Library ` method ``get_header()`` returned the first matching header, regardless of whether it would be replaced by a second ``set_header()`` call.\n-  Fixed a bug (#4844) - :doc:`Email Library ` didn't apply ``escapeshellarg()`` to the while passing the Sendmail ``-f`` parameter through ``popen()``.\n-  Fixed a bug (#4928) - the bootstrap file didn't check if *config/constants.php* exists before trying to load it.\n-  Fixed a bug (#4937) - :doc:`Image Manipulation Library ` method ``initialize()`` didn't translate *new_image* inputs to absolute paths.\n-  Fixed a bug (#4941) - :doc:`Query Builder ` method ``order_by()`` didn't work with 'RANDOM' under the 'pdo/sqlite' driver.\n-  Fixed a regression (#4892) - :doc:`Query Builder ` method ``update_batch()`` didn't properly handle identifier escaping.\n-  Fixed a bug (#4953) - :doc:`Database Forge ` method ``create_table()`` didn't update an internal tables list cache if it exists but is empty.\n-  Fixed a bug (#4958) - :doc:`Query Builder ` method ``count_all_results()`` didn't take into account cached ``ORDER BY`` clauses.\n-  Fixed a bug (#4804) - :doc:`Query Builder ` method ``insert_batch()`` could fail if the input array pointer was modified.\n-  Fixed a bug (#4962) - :doc:`Database Force ` method ``alter_table()`` would fail with the 'oci8' driver.\n-  Fixed a bug (#4457) - :doc:`Image Manipulation Library ` method ``get_image_properties()`` didn't detect invalid images.\n-  Fixed a bug (#4765) - :doc:`Email Library ` didn't send the ``User-Agent`` header without a prior call to ``clear()``.\n\nVersion 3.1.2\n=============\n\nRelease Date: Oct 28, 2016\n\n-  **Security**\n\n   -  Fixed a number of new vulnerabilities in :doc:`Security Library ` method ``xss_clean()``.\n\n-  General Changes\n\n   -  Allowed PHP 4-style constructors (``Matching_name::Matching_name()`` methods) to be used as routes, if there's a ``__construct()`` to override them.\n\nBug fixes for 3.1.2\n-------------------\n\n-  Fixed a regression (#4874) - :doc:`Session Library ` didn't take into account ``session.hash_bits_per_character`` when validating session IDs.\n-  Fixed a bug (#4871) - :doc:`Query Builder ` method ``update_batch()`` didn't properly handle identifier escaping.\n-  Fixed a bug (#4884) - :doc:`Query Builder ` didn't properly parse field names ending in 'is' when used inside WHERE and HAVING statements.\n-  Fixed a bug where ``CI_Log``, ``CI_Output``, ``CI_Email`` and ``CI_Zip`` didn't handle strings in a byte-safe manner when ``mbstring.func_overload`` is enabled.\n\nVersion 3.1.1\n=============\n\nRelease Date: Oct 22, 2016\n\n-  **Security**\n\n   -  Fixed a flaw in :doc:`Security Library ` method ``entity_decode()`` (used by ``xss_clean()``) that affects HTML 5 entities when using PHP 5.3.\n\n-  General Changes\n\n   -  Added ``E_PARSE`` to the list of error levels detected by the shutdown handler.\n   -  Updated :doc:`Inflector Helper ` ``is_countable()`` with more words.\n   -  Updated :doc:`common function ` :php:func:`set_status_header()` with new status codes from IETF RFCs\n      `2817 `_ (426)\n      and `6585 `_ (428, 429, 431, 511).\n\nBug fixes for 3.1.1\n-------------------\n\n-  Fixed a bug (#4732) - :doc:`Session Library ` triggered errors while writing data for a newly-created sessions with the 'memcached' driver.\n-  Fixed a regression (#4736) - :doc:`Image Manipulation Library ` processing via ImageMagick didn't work.\n-  Fixed a bug (#4737) - :doc:`Query Builder ` didn't add an ``OFFSET`` when ``LIMIT`` is zero or unused.\n-  Fixed a regression (#4739) - :doc:`Email Library ` doesn't properly separate attachment bodies from headers.\n-  Fixed a bug (#4754) - :doc:`Unit Testing Library ` method ``result()`` didn't translate ``res_datatype``.\n-  Fixed a bug (#4759) - :doc:`Form Validation `, :doc:`Trackback ` and :doc:`XML-RPC ` libraries treated URI schemes in a case-sensitive manner.\n-  Fixed a bug (#4762) - :doc:`Cache Library ` 'file' driver method ``get_metadata()`` checked TTL time against ``mtime`` instead of the cache item's creation time.\n-  Fixed a bug where :doc:`File Uploading Library ` generated error messages on PHP 7.1.\n-  Fixed a bug (#4780) - :doc:`compatibility function ` ``hex2bin()`` didn't reject inputs of type \"resource\".\n-  Fixed a bug (#4787) - :doc:`Form Validation Library ` method ``valid_email()`` triggered ``E_WARNING`` when input emails have empty domain names.\n-  Fixed a bug (#4805) - :doc:`Database ` driver 'mysqli' didn't use the ``MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT`` flag properly.\n-  Fixed a bug (#4808) - :doc:`Database ` method ``is_write_type()`` only looked at the first line of a queries using ``RETURNING`` with the 'postgre', 'pdo/pgsql', 'odbc' and 'pdo/odbc' drivers.\n-  Fixed a bug where :doc:`Query Builder ` method ``insert_batch()`` tried to execute an unsupported SQL query with the 'ibase' and 'pdo/firebird' drivers.\n-  Fixed a bug (#4809) - :doc:`Database ` driver 'pdo/mysql' didn't turn off ``AUTOCOMMIT`` when starting a transaction.\n-  Fixed a bug (#4822) - :doc:`CAPTCHA Helper ` didn't clear expired PNG images.\n-  Fixed a bug (#4823) - :doc:`Session Library ` 'files' driver could enter an infinite loop if ``mbstring.func_overload`` is enabled.\n-  Fixed a bug (#4851) - :doc:`Database Forge ` didn't quote schema names passed to its ``create_database()`` method.\n-  Fixed a bug (#4863) - :doc:`HTML Table Library ` method ``set_caption()`` was missing method chaining support.\n-  Fixed a bug (#4843) - :doc:`XML-RPC Library ` client class didn't set a read/write socket timeout.\n-  Fixed a bug (#4865) - uncaught exceptions didn't set the HTTP Response status code to 500 unless ``display_errors`` was turned On.\n-  Fixed a bug (#4830) - :doc:`Session Library ` didn't take into account the new session INI settings in PHP 7.1.\n\nVersion 3.1.0\n=============\n\nRelease Date: July 26, 2016\n\n-  **Security**\n\n   -  Fixed an SQL injection in the 'odbc' database driver.\n   -  Updated :php:func:`set_realpath()` :doc:`Path Helper ` function to filter-out ``php://`` wrapper inputs.\n   -  Officially dropped any kind of support for PHP 5.2.x and anything under 5.3.7.\n\n-  General Changes\n\n   -  Updated :doc:`Image Manipulation Library ` to validate *width* and *height* configuration values.\n   -  Updated :doc:`Encryption Library ` to always prefer ``random_bytes()`` when it is available.\n   -  Updated :doc:`Session Library ` to log 'debug' messages when using fallbacks to *session.save_path* (php.ini) or 'sess_use_database', 'sess_table_name' settings.\n   -  Added a 'LONGTEXT' to 'STRING' alias to :doc:`Database Forge ` for the 'cubrid', 'pdo/cubrid' drivers.\n   -  Added 'TINYINT', 'MEDIUMINT', 'INT' and 'BIGINT' aliases to 'NUMBER' to :doc:`Database Forge ` for the 'oci8', 'pdo/oci' drivers.\n\n   -  :php:func:`password_hash()` :doc:`compatibility function ` changes:\n\n      - Changed salt-generation logic to prefer ``random_bytes()`` when it is available.\n      - Changed salt-generation logic to prefer direct access to */dev/urandom* over ``openssl_random_pseudo_bytes()``.\n      - Changed salt-generation logic to error if ``openssl_random_pseudo_bytes()`` sets its ``$crypto_strong`` flag to FALSE.\n\nBug fixes for 3.1.0\n-------------------\n\n-  Fixed a bug where :doc:`Image Manipulation Library ` didn't escape image source paths passed to ImageMagick as shell arguments.\n-  Fixed a bug (#861) - :doc:`Database Forge ` method ``create_table()`` incorrectly accepts field width constraints for MSSQL/SQLSRV integer-type columns.\n-  Fixed a bug (#4562) - :doc:`Cache Library ` didn't check if ``Memcached::quit()`` is available before calling it.\n-  Fixed a bug (#4563) - :doc:`Input Library ` method ``request_headers()`` ignores ``$xss_clean`` parameter value after first call.\n-  Fixed a bug (#4605) - :doc:`Config Library ` method ``site_url()`` stripped trailing slashes from relative URIs passed to it.\n-  Fixed a bug (#4613) - :doc:`Email Library ` failed to send multiple emails via SMTP due to \"already authenticated\" errors when keep-alive is enabled.\n-  Fixed a bug (#4633) - :doc:`Form Validation Library ` ignored multiple \"callback\" rules for empty, non-required fields.\n-  Fixed a bug (#4637) - :doc:`Database ` method ``error()`` returned ``FALSE`` with the 'oci8' driver if there was no error.\n-  Fixed a bug (#4647) - :doc:`Query Builder ` method ``count_all_results()`` doesn't take into account ``GROUP BY`` clauses while deciding whether to do a subquery or not.\n-  Fixed a bug where :doc:`Session Library ` 'redis' driver didn't properly detect if a connection is properly closed on PHP 5.x.\n-  Fixed a bug (#4583) - :doc:`Email Library ` didn't properly handle inline attachments in HTML emails.\n-  Fixed a bug where :doc:`Database ` method ``db_select()`` didn't clear metadata cached for the previously used database.\n-  Fixed a bug (#4675) - :doc:`File Helper ` function :php:func:`delete_files()` treated symbolic links as regular directories.\n-  Fixed a bug (#4674) - :doc:`Database ` driver 'dblib' triggered E_WARNING messages while connecting.\n-  Fixed a bug (#4678) - :doc:`Database Forge ` tried to use unsupported ``IF NOT EXISTS`` clause when creating tables on Oracle.\n-  Fixed a bug (#4691) - :doc:`File Uploading Library ` method ``data()`` returns wrong 'raw_name' when the filename extension is also contained in the raw filename.\n-  Fixed a bug (#4679) - :doc:`Input Library ` method ``ip_address()`` errors with a matching ``$config['proxy_ips']`` IPv6 address.\n-  Fixed a bug (#4695) - :doc:`User Agent Library ` didn't load the *config/user_agents.php* file when there's no ``User-Agent`` HTTP request header.\n-  Fixed a bug (#4713) - :doc:`Query Builder ` methods ``insert_batch()``, ``update_batch()`` could return wrong affected rows count.\n-  Fixed a bug (#4712) - :doc:`Email Library ` doesn't sent ``RSET`` to SMTP servers after a failure and while using keep-alive.\n-  Fixed a bug (#4724) - :doc:`Common function ` :php:func:`is_https()` compared the ``X-Forwarded-Proto`` HTTP header case-sensitively.\n-  Fixed a bug (#4725) - :doc:`Common function ` :php:func:`remove_invisible_characters()` searched case-sensitively for URL-encoded characters.\n\nVersion 3.0.6\n=============\n\nRelease Date: March 21, 2016\n\n-  General Changes\n\n   -  Added a destructor to :doc:`Cache Library ` 'memcached' driver to ensure that Memcache(d) connections are properly closed.\n   -  Deprecated :doc:`Form Validation Library ` method ``prep_for_form()``.\n\nBug fixes for 3.0.6\n-------------------\n\n-  Fixed a bug (#4516) - :doc:`Form Validation Library ` always accepted empty array inputs.\n-  Fixed a bug where :doc:`Session Library ` allowed accessing ``$_SESSION`` values as class properties but ``isset()`` didn't work on them.\n-  Fixed a bug where :doc:`Form Validation Library ` modified the ``$_POST`` array when the data being validated was actually provided via ``set_data()``.\n-  Fixed a bug (#4539) - :doc:`Migration Library ` applied migrations before validating that all migrations within the requested version range are valid.\n-  Fixed a bug (#4539) - :doc:`Migration Library ` triggered failures for migrations that are out of the requested version range.\n\nVersion 3.0.5\n=============\n\nRelease Date: March 11, 2016\n\n-  Core\n\n   -  Changed :doc:`Loader Library ` to allow ``$autoload['drivers']`` assigning with custom property names.\n   -  Changed :doc:`Loader Library ` to ignore variables prefixed with '_ci_' when loading views.\n\n-  General Changes\n\n   -  Updated the :doc:`Session Library ` to produce friendlier error messages on failures with drivers other than 'files'.\n\n-  :doc:`Query Builder `\n\n   -  Added a ``$batch_size`` parameter to the ``insert_batch()`` method (defaults to 100).\n   -  Added a ``$batch_size`` parameter to the ``update_batch()`` method (defaults to 100).\n\nBug fixes for 3.0.5\n-------------------\n\n-  Fixed a bug (#4391) - :doc:`Email Library ` method ``reply_to()`` didn't apply Q-encoding.\n-  Fixed a bug (#4384) - :doc:`Pagination Library ` ignored (possible) *cur_page* configuration value.\n-  Fixed a bug (#4395) - :doc:`Query Builder ` method ``count_all_results()`` still fails if an ``ORDER BY`` condition is used.\n-  Fixed a bug (#4399) - :doc:`Query Builder ` methods ``insert_batch()``, ``update_batch()`` produced confusing error messages when called with no data and *db_debug* is enabled.\n-  Fixed a bug (#4401) - :doc:`Query Builder ` breaks ``WHERE`` and ``HAVING`` conditions that use ``IN()`` with strings containing a closing parenthesis.\n-  Fixed a regression in :doc:`Form Helper ` functions :php:func:`set_checkbox()`, :php:func:`set_radio()` where \"checked\" inputs aren't recognized after a form submit.\n-  Fixed a bug (#4407) - :doc:`Text Helper ` function :php:func:`word_censor()` doesn't work under PHP 7 if there's no custom replacement provided.\n-  Fixed a bug (#4415) - :doc:`Form Validation Library ` rule **valid_url** didn't accept URLs with IPv6 addresses enclosed in square brackets under PHP 5 (upstream bug).\n-  Fixed a bug (#4427) - :doc:`CAPTCHA Helper ` triggers an error if the provided character pool is too small.\n-  Fixed a bug (#4430) - :doc:`File Uploading Library ` option **file_ext_tolower** didn't work.\n-  Fixed a bug (#4431) - :doc:`Query Builder ` method ``join()`` discarded opening parentheses.\n-  Fixed a bug (#4424) - :doc:`Session Library ` triggered a PHP warning when writing a newly created session with the 'redis' driver.\n-  Fixed a bug (#4437) - :doc:`Inflector Helper ` function :php:func:`humanize()` didn't escape its ``$separator`` parameter while using it in a regular expression.\n-  Fixed a bug where :doc:`Session Library ` didn't properly handle its locks' statuses with the 'memcached' driver.\n-  Fixed a bug where :doc:`Session Library ` triggered a PHP warning when writing a newly created session with the 'memcached' driver.\n-  Fixed a bug (#4449) - :doc:`Query Builder ` method ``join()`` breaks conditions containing ``IS NULL``, ``IS NOT NULL``.\n-  Fixed a bug (#4491) - :doc:`Session Library ` didn't clean-up internal variables for emulated locks with the 'redis' driver.\n-  Fixed a bug where :doc:`Session Library ` didn't clean-up internal variables for emulated locks with the 'memcached' driver.\n-  Fixed a bug where :doc:`Database ` transactions didn't work with the 'ibase' driver.\n-  Fixed a bug (#4475) - :doc:`Security Library ` method ``strip_image_tags()`` preserves only the first URL character from non-quoted *src* attributes.\n-  Fixed a bug where :doc:`Profiler Library ` didn't apply ``htmlspecialchars()`` to all displayed inputs.\n-  Fixed a bug (#4277) - :doc:`Cache Library ` triggered fatal errors if accessing the Memcache(d) and/or Redis driver and they are not available on the system.\n-  Fixed a bug where :doc:`Cache Library ` method ``is_supported()`` logged an error message when it returns ``FALSE`` for the APC and Wincache drivers.\n\nVersion 3.0.4\n=============\n\nRelease Date: January 13, 2016\n\n-  General Changes\n\n   -  Updated :doc:`Security Library ` method ``get_random_bytes()`` to use PHP 7's ``random_bytes()`` function when possible.\n   -  Updated :doc:`Encryption Library ` method ``create_key()`` to use PHP 7's ``random_bytes()`` function when possible.\n\n-  :doc:`Database `\n\n   -  Added support for ``OFFSET-FETCH`` with Oracle 12c for the 'oci8' and 'pdo/oci' drivers.\n   -  Added support for the new ``MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT`` constant from `PHP 5.6.16 `_ for the 'mysqli' driver.\n\nBug fixes for 3.0.4\n-------------------\n\n-  Fixed a bug (#4212) - :doc:`Query Builder ` method ``count_all_results()`` could fail if an ``ORDER BY`` condition is used.\n-  Fixed a bug where :doc:`Form Helper ` functions :php:func:`set_checkbox()`, :php:func:`set_radio()` didn't \"uncheck\" inputs on a submitted form if the default state is \"checked\".\n-  Fixed a bug (#4217) - :doc:`Config Library ` method ``base_url()`` didn't use proper formatting for IPv6 when it falls back to ``$_SERVER['SERVER_ADDR']``.\n-  Fixed a bug where :doc:`CAPTCHA Helper ` entered an infinite loop while generating a random string.\n-  Fixed a bug (#4223) - :doc:`Database ` method ``simple_query()`` blindly executes queries without checking if the connection was initialized properly.\n-  Fixed a bug (#4244) - :doc:`Email Library ` could improperly use \"unsafe\" US-ASCII characters during Quoted-printable encoding.\n-  Fixed a bug (#4245) - :doc:`Database Forge ` couldn't properly handle ``SET`` and ``ENUM`` type fields with string values.\n-  Fixed a bug (#4283) - :doc:`String Helper ` function :php:func:`alternator()` couldn't be called without arguments.\n-  Fixed a bug (#4306) - :doc:`Database ` method ``version()`` didn't work properly with the 'mssql' driver.\n-  Fixed a bug (#4039) - :doc:`Session Library ` could generate multiple (redundant) warnings in case of a read failure with the 'files' driver, due to a bug in PHP.\n-  Fixed a bug where :doc:`Session Library ` didn't have proper error handling on PHP 5 (due to a PHP bug).\n-  Fixed a bug (#4312) - :doc:`Form Validation Library ` didn't provide error feedback for failed validation on empty requests.\n-  Fixed a bug where :doc:`Database ` method `version()` returned banner text instead of only the version number with the 'oci8' and 'pdo/oci' drivers.\n-  Fixed a bug (#4331) - :doc:`Database ` method ``error()`` didn't really work for connection errors with the 'mysqli' driver.\n-  Fixed a bug (#4343) - :doc:`Email Library ` failing with a *\"More than one 'from' person\"* message when using *sendmail*.\n-  Fixed a bug (#4350) - :doc:`Loader Library ` method ``model()`` logic directly instantiated the ``CI_Model`` or ``MY_Model`` classes.\n-  Fixed a bug (#4337) - :doc:`Database ` method ``query()`` didn't return a result set for queries with the ``RETURNING`` statement on PostgreSQL.\n-  Fixed a bug (#4362) - :doc:`Session Library ` doesn't properly maintain its state after ID regeneration with the 'redis' and 'memcached' drivers on PHP 7.\n-  Fixed a bug (#4349) - :doc:`Database ` drivers 'mysql', 'mysqli', 'pdo/mysql' discard other ``sql_mode`` flags when \"stricton\" is enabled.\n-  Fixed a bug (#4349) - :doc:`Database ` drivers 'mysql', 'mysqli', 'pdo/mysql' don't turn off ``STRICT_TRANS_TABLES`` on MySQL 5.7+ when \"stricton\" is disabled.\n-  Fixed a bug (#4374) - :doc:`Session Library ` with the 'database' driver could be affected by userspace :doc:`Query Builder ` conditions.\n\nVersion 3.0.3\n=============\n\nRelease Date: October 31, 2015\n\n-  **Security**\n\n   -  Fixed an XSS attack vector in :doc:`Security Library ` method ``xss_clean()``.\n   -  Changed :doc:`Config Library ` method ``base_url()`` to fallback to ``$_SERVER['SERVER_ADDR']`` when ``$config['base_url']`` is empty in order to avoid *Host* header injections.\n   -  Changed :doc:`CAPTCHA Helper ` to use the operating system's PRNG when possible.\n\n-  :doc:`Database `\n\n   -  Optimized :doc:`Database Utility ` method ``csv_from_result()`` for speed with larger result sets.\n   -  Added proper return values to :doc:`Database Transactions ` method ``trans_start()``.\n\nBug fixes for 3.0.3\n-------------------\n\n-  Fixed a bug (#4170) - :doc:`Database ` method ``insert_id()`` could return an identity from the wrong scope with the 'sqlsrv' driver.\n-  Fixed a bug (#4179) - :doc:`Session Library ` doesn't properly maintain its state after ID regeneration with the 'database' driver on PHP 7.\n-  Fixed a bug (#4173) - :doc:`Database Forge ` method ``add_key()`` didn't allow creation of non-PRIMARY composite keys after the \"bugfix\" for #3968.\n-  Fixed a bug (#4171) - :doc:`Database Transactions ` didn't work with nesting in methods ``trans_begin()``, ``trans_commit()``, ``trans_rollback()``.\n-  Fixed a bug where :doc:`Database Transaction ` methods ``trans_begin()``, ``trans_commit()``, ``trans_rollback()`` ignored failures.\n-  Fixed a bug where all :doc:`Database Transaction ` methods returned TRUE while transactions are actually disabled.\n-  Fixed a bug where :doc:`common function ` :php:func:`html_escape()` modified keys of its array inputs.\n-  Fixed a bug (#4192) - :doc:`Email Library ` wouldn't always have proper Quoted-printable encoding due to a bug in PHP's own ``mb_mime_encodeheader()`` function.\n\nVersion 3.0.2\n=============\n\nRelease Date: October 8, 2015\n\n-  **Security**\n\n   -  Fixed a number of XSS attack vectors in :doc:`Security Library ` method ``xss_clean()``  (thanks to Frans Rosén from `Detectify `_).\n\n-  General Changes\n\n   -  Updated the *application/config/constants.php* file to check if constants aren't already defined before doing that.\n   -  Changed :doc:`Loader Library ` method ``model()`` to only apply ``ucfirst()`` and not ``strtolower()`` to the requested class name.\n   -  Changed :doc:`Config Library ` methods ``base_url()``, ``site_url()`` to allow protocol-relative URLs by passing an empty string as the protocol.\n\nBug fixes for 3.0.2\n-------------------\n\n-  Fixed a bug (#2284) - :doc:`Database ` method ``protect_identifiers()`` breaks when :doc:`Query Builder ` isn't enabled.\n-  Fixed a bug (#4052) - :doc:`Routing ` with anonymous functions didn't work for routes that don't use regular expressions.\n-  Fixed a bug (#4056) - :doc:`Input Library ` method ``get_request_header()`` could not return a value unless ``request_headers()`` was called beforehand.\n-  Fixed a bug where the :doc:`Database Class ` entered an endless loop if it fails to connect with the 'sqlsrv' driver.\n-  Fixed a bug (#4065) - :doc:`Database ` method ``protect_identifiers()`` treats a traling space as an alias separator if the input doesn't contain ' AS '.\n-  Fixed a bug (#4066) - :doc:`Cache Library ` couldn't fallback to a backup driver if the primary one is Memcache(d) or Redis.\n-  Fixed a bug (#4073) - :doc:`Email Library ` method ``send()`` could return TRUE in case of an actual failure when an SMTP command fails.\n-  Fixed a bug (#4086) - :doc:`Query Builder ` didn't apply *dbprefix* to LIKE conditions if the pattern included spaces.\n-  Fixed a bug (#4091) - :doc:`Cache Library ` 'file' driver could be tricked into accepting empty cache item IDs.\n-  Fixed a bug (#4093) - :doc:`Query Builder ` modified string values containing 'AND', 'OR' while compiling WHERE conditions.\n-  Fixed a bug (#4096) - :doc:`Query Builder ` didn't apply *dbprefix* when compiling BETWEEN conditions.\n-  Fixed a bug (#4105) - :doc:`Form Validation Library ` didn't allow pipe characters inside \"bracket parameters\" when using a string ruleset.\n-  Fixed a bug (#4109) - :doc:`Routing ` to *default_controller* didn't work when *enable_query_strings* is set to TRUE.\n-  Fixed a bug (#4044) - :doc:`Cache Library ` 'redis' driver didn't catch ``RedisException`` that could be thrown during authentication.\n-  Fixed a bug (#4120) - :doc:`Database ` method ``error()`` didn't return error info when called after ``query()`` with the 'mssql' driver.\n-  Fixed a bug (#4116) - :doc:`Pagination Library ` set the wrong page number on the \"data-ci-pagination-page\" attribute in generated links.\n-  Fixed a bug where :doc:`Pagination Library ` added the 'rel=\"start\"' attribute to the first displayed link even if it's not actually linking the first page.\n-  Fixed a bug (#4137) - :doc:`Error Handling ` breaks for the new ``Error`` exceptions under PHP 7.\n-  Fixed a bug (#4126) - :doc:`Form Validation Library ` method ``reset_validation()`` discarded validation rules from config files.\n\nVersion 3.0.1\n=============\n\nRelease Date: August 7, 2015\n\n-  Core\n\n   -  Added DoS mitigation to :php:func:`hash_pbkdf2()` :doc:`compatibility function `.\n\n-  Database\n\n   -  Added ``list_fields()`` support for SQLite ('sqlite3' and 'pdo_sqlite' drivers).\n   -  Added SSL connection support for the 'mysqli' and 'pdo_mysql' drivers.\n\n-  Libraries\n\n   -  :doc:`File Uploading Library ` changes:\n\n      - Changed method ``set_error()`` to accept a custom log level (defaults to 'error').\n      - Errors \"no_file_selected\", \"file_partial\", \"stopped_by_extension\", \"no_file_types\", \"invalid_filetype\", \"bad_filename\" are now logged at the 'debug' level.\n      - Errors \"file_exceeds_limit\", \"file_exceeds_form_limit\", \"invalid_filesize\", \"invalid_dimensions\" are now logged at the 'info' level.\n\n   -  Added 'is_resource' to the available expectations in :doc:`Unit Testing Library `.\n\n-  Helpers\n\n   -  Added Unicode support to :doc:`URL Helper ` function :php:func:`url_title()`.\n   -  Added support for passing the \"extra\" parameter as an array to all :doc:`Form Helper ` functions that use it.\n\n-  Core\n\n   -  Added support for defining a list of specific query parameters in ``$config['cache_query_string']`` for the :doc:`Output Library `.\n   -  Added class existence and inheritance checks to ``CI_Loader::model()`` in order to ease debugging in case of name collisions.\n\nBug fixes for 3.0.1\n-------------------\n\n-  Fixed a bug (#3733) - Autoloading of libraries with aliases didn't work, although it was advertised to.\n-  Fixed a bug (#3744) - Redis :doc:`Caching ` driver didn't handle authentication failures properly.\n-  Fixed a bug (#3761) - :doc:`URL Helper ` function :php:func:`anchor()` didn't work with array inputs.\n-  Fixed a bug (#3773) - ``db_select()`` didn't work for MySQL with the PDO :doc:`Database ` driver.\n-  Fixed a bug (#3771) - :doc:`Form Validation Library ` was looking for a 'form_validation\\_' prefix when trying to translate field name labels.\n-  Fixed a bug (#3787) - :doc:`FTP Library ` method ``delete_dir()`` failed when the target has subdirectories.\n-  Fixed a bug (#3801) - :doc:`Output Library ` method ``_display_cache()`` incorrectly looked for the last modified time of a directory instead of the cache file.\n-  Fixed a bug (#3816) - :doc:`Form Validation Library ` treated empty string values as non-existing ones.\n-  Fixed a bug (#3823) - :doc:`Session Library ` drivers Redis and Memcached didn't properly handle locks that are blocking the request for more than 30 seconds.\n-  Fixed a bug (#3846) - :doc:`Image Manipulation Library ` method `image_mirror_gd()` didn't properly initialize its variables.\n-  Fixed a bug (#3854) - `field_data()` didn't work properly with the Oracle (OCI8) database driver.\n-  Fixed a bug in the :doc:`Database Utility Class ` method ``csv_from_result()`` didn't work with a whitespace CSV delimiter.\n-  Fixed a bug (#3890) - :doc:`Input Library ` method ``get_request_header()`` treated header names as case-sensitive.\n-  Fixed a bug (#3903) - :doc:`Form Validation Library ` ignored \"unnamed\" closure validation rules.\n-  Fixed a bug (#3904) - :doc:`Form Validation Library ` ignored \"named\" callback rules when the field is empty and there's no 'required' rule.\n-  Fixed a bug (#3922) - :doc:`Email ` and :doc:`XML-RPC ` libraries could enter an infinite loop due to `PHP bug #39598 `_.\n-  Fixed a bug (#3913) - :doc:`Cache Library ` didn't work with the direct ``$this->cache->$driver_name->method()`` syntax with Redis and Memcache(d).\n-  Fixed a bug (#3932) - :doc:`Query Builder ` didn't properly compile WHERE and HAVING conditions for field names that end with \"and\", \"or\".\n-  Fixed a bug in :doc:`Query Builder ` where ``delete()`` didn't properly work on multiple tables with a WHERE condition previously set via ``where()``.\n-  Fixed a bug (#3952) - :doc:`Database ` method ``list_fields()`` didn't work with SQLite3.\n-  Fixed a bug (#3955) - :doc:`Cache Library ` methods ``increment()`` and ``decrement()`` ignored the 'key_prefix' setting.\n-  Fixed a bug (#3963) - :doc:`Unit Testing Library ` wrongly tried to translate filenames, line numbers and notes values in test results.\n-  Fixed a bug (#3965) - :doc:`File Uploading Library ` ignored the \"encrypt_name\" setting when \"overwrite\" is enabled.\n-  Fixed a bug (#3968) - :doc:`Database Forge ` method ``add_key()`` didn't treat array inputs as composite keys unless it's a PRIMARY KEY.\n-  Fixed a bug (#3715) - :doc:`Pagination Library ` could generate broken link when a protocol-relative base URL is used.\n-  Fixed a bug (#3828) - :doc:`Output Library ` method ``delete_cache()`` couldn't delete index page caches.\n-  Fixed a bug (#3704) - :doc:`Database ` method ``stored_procedure()`` in the 'oci8' driver didn't properly bind parameters.\n-  Fixed a bug (#3778) - :doc:`Download Helper ` function :php:func:`force_download()` incorrectly sent a *Pragma* response header.\n-  Fixed a bug (#3752) - ``$routing['directory']`` overrides were not properly handled and always resulted in a 404 \"Not Found\" error.\n-  Fixed a bug (#3279) - :doc:`Query Builder ` methods ``update()`` and ``get_compiled_update()`` did double escaping on the table name if it was provided via ``from()``.\n-  Fixed a bug (#3991) - ``$config['rewrite_short_tags']`` never worked due to ``function_exists('eval')`` always returning FALSE.\n-  Fixed a bug where the :doc:`File Uploading Library ` library will not properly configure its maximum file size unless the input value is of type integer.\n-  Fixed a bug (#4000) - :doc:`Pagination Library ` didn't enable \"rel\" attributes by default if no attributes-related config options were used.\n-  Fixed a bug (#4004) - :doc:`URI Class ` didn't properly parse the request URI if it contains a colon followed by a digit.\n-  Fixed a bug in :doc:`Query Builder ` where the ``$escape`` parameter for some methods only affected field names.\n-  Fixed a bug (#4012) - :doc:`Query Builder ` methods ``where_in()``, ``or_where_in()``, ``where_not_in()``, ``or_where_not_in()`` didn't take into account previously cached WHERE conditions when query cache is in use.\n-  Fixed a bug (#4015) - :doc:`Email Library ` method ``set_header()`` didn't support method chaining, although it was advertised.\n-  Fixed a bug (#4027) - :doc:`Routing ` with HTTP verbs only worked if the route request method was declared in all-lowercase letters.\n-  Fixed a bug (#4026) - :doc:`Database Transactions ` always rollback if any previous ``query()`` call fails.\n-  Fixed a bug (#4023) - :doc:`String Helper ` function ``increment_string()`` didn't escape its ``$separator`` parameter.\n\nVersion 3.0.0\n=============\n\nRelease Date: March 30, 2015\n\n-  License\n\n   -  CodeIgniter has been relicensed with the `MIT License `_, eliminating its old proprietary licensing.\n\n-  General Changes\n\n   -  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.\n   -  Changed filenaming convention (class file names now must be Ucfirst and everything else in lowercase).\n   -  Changed the default database driver to 'mysqli' (the old 'mysql' driver is DEPRECATED).\n   -  ``$_SERVER['CI_ENV']`` can now be set to control the ``ENVIRONMENT`` constant.\n   -  Added an optional backtrace to php-error template.\n   -  Added Android to the list of user agents.\n   -  Added Windows 7, Windows 8, Windows 8.1, Android, Blackberry, iOS and PlayStation 3 to the list of user platforms.\n   -  Added Fennec (Firefox for mobile) to the list of mobile user agents.\n   -  Ability to log certain error types, not all under a threshold.\n   -  Added support for pem, p10, p12, p7a, p7c, p7m, p7r, p7s, crt, crl, der, kdb, rsa, cer, sst, csr Certs to mimes.php.\n   -  Added support for pgp, gpg, zsh and cdr files to mimes.php.\n   -  Added support for 3gp, 3g2, mp4, wmv, f4v, vlc Video files to mimes.php.\n   -  Added support for m4a, aac, m4u, xspf, au, ac3, flac, ogg, wma Audio files to mimes.php.\n   -  Added support for kmz and kml (Google Earth) files to mimes.php.\n   -  Added support for ics Calendar files to mimes.php.\n   -  Added support for rar, jar and 7zip archives to mimes.php.\n   -  Updated support for xml ('application/xml') and xsl ('application/xml', 'text/xsl') files in mimes.php.\n   -  Updated support for doc files in mimes.php.\n   -  Updated support for docx files in mimes.php.\n   -  Updated support for php files in mimes.php.\n   -  Updated support for zip files in mimes.php.\n   -  Updated support for csv files in mimes.php.\n   -  Added Romanian, Greek, Vietnamese and Cyrilic characters in *application/config/foreign_characters.php*.\n   -  Changed logger to only chmod when file is first created.\n   -  Removed previously deprecated SHA1 Library.\n   -  Removed previously deprecated use of ``$autoload['core']`` in *application/config/autoload.php*.\n      Only entries in ``$autoload['libraries']`` are auto-loaded now.\n   -  Removed previously deprecated EXT constant.\n   -  Updated all classes to be written in PHP 5 style, with visibility declarations and no ``var`` usage for properties.\n   -  Added an Exception handler.\n   -  Moved error templates to *application/views/errors/* and made the path configurable via ``$config['error_views_path']``.\n   -  Added support non-HTML error templates for CLI applications.\n   -  Moved the Log class to *application/core/*\n   -  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.\n   -  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.\n   -  Path constants BASEPATH, APPPATH and VIEWPATH are now (internally) defined as absolute paths.\n   -  Updated email validation methods to use ``filter_var()`` instead of PCRE.\n   -  Changed environment defaults to report all errors in *development* and only fatal ones in *testing*, *production* but only display them in *development*.\n   -  Updated *ip_address* database field lengths from 16 to 45 for supporting IPv6 address on :doc:`Trackback Library ` and :doc:`Captcha Helper `.\n   -  Removed *cheatsheets* and *quick_reference* PDFs from the documentation.\n   -  Added availability checks where usage of dangerous functions like ``eval()`` and ``exec()`` is required.\n   -  Added support for changing the file extension of log files using ``$config['log_file_extension']``.\n   -  Added support for turning newline standardization on/off via ``$config['standardize_newlines']`` and set it to FALSE by default.\n   -  Added configuration setting ``$config['composer_autoload']`` to enable loading of a `Composer `_ auto-loader.\n   -  Removed the automatic conversion of 'programmatic characters' to HTML entities from the :doc:`URI Library `.\n   -  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).\n\n-  Helpers\n\n   -  :doc:`Date Helper ` changes include:\n\n      - Added an optional third parameter to :php:func:`timespan()` that constrains the number of time units displayed.\n      - Added an optional parameter to :php:func:`timezone_menu()` that allows more attributes to be added to the generated select tag.\n      - Added function :php:func:`date_range()` that generates a list of dates between a specified period.\n      - Deprecated ``standard_date()``, which now just uses the native ``date()`` with `DateTime constants `_.\n      - Changed :php:func:`now()` to work with all timezone strings supported by PHP.\n      - Changed :php:func:`days_in_month()` to use the native ``cal_days_in_month()`` PHP function, if available.\n\n   -  :doc:`URL Helper ` changes include:\n\n      - Deprecated *separator* options **dash** and **underscore** for function :php:func:`url_title()` (they are only aliases for '-' and '_' respectively).\n      - :php:func:`url_title()` will now trim extra dashes from beginning and end.\n      - :php:func:`anchor_popup()` will now fill the *href* attribute with the URL and its JS code will return FALSE instead.\n      - Added JS window name support to the :php:func:`anchor_popup()` function.\n      - Added support for menubar attribute to the :php:func:`anchor_popup()`.\n      - Added support (auto-detection) for HTTP/1.1 response codes 303, 307 in :php:func:`redirect()`.\n      - Changed :php:func:`redirect()` to choose the **refresh** method only on IIS servers, instead of all servers on Windows (when **auto** is used).\n      - Changed :php:func:`anchor()`, :php:func:`anchor_popup()`, and :php:func:`redirect()` to support protocol-relative URLs (e.g. *//ellislab.com/codeigniter*).\n\n   -  :doc:`HTML Helper ` changes include:\n\n      - Added more doctypes.\n      - Changed application and environment config files to be loaded in a cascade-like manner.\n      - Changed :php:func:`doctype()` to cache and only load once the doctypes array.\n      - Deprecated functions ``nbs()`` and ``br()``, which are just aliases for the native ``str_repeat()`` with `` `` and ``
    `` respectively.\n\n   -  :doc:`Inflector Helper ` changes include:\n\n      - Changed :php:func:`humanize()` to allow passing an input separator as its second parameter.\n      - Changed :php:func:`humanize()` and :php:func:`underscore()` to utilize `mbstring `_, if available.\n      - Changed :php:func:`plural()` and :php:func:`singular()` to avoid double pluralization and support more words.\n\n   -  :doc:`Download Helper ` changes include:\n\n      - Added an optional third parameter to :php:func:`force_download()` that enables/disables sending the actual file MIME type in the Content-Type header (disabled by default).\n      - Added a work-around in :php:func:`force_download()` for a bug Android <= 2.1, where the filename extension needs to be in uppercase.\n      - Added support for reading from an existing file path by passing NULL as the second parameter to :php:func:`force_download()` (useful for large files and/or safely transmitting binary data).\n\n   -  :doc:`Form Helper ` changes include:\n\n      - :php:func:`form_dropdown()` will now also take an array for unity with other form helpers.\n      - ``form_prep()`` is now DEPRECATED and only acts as an alias for :doc:`common function ` :php:func:`html_escape()`.\n      - :php:func:`set_value()` will now also accept a third argument, allowing to turn off HTML escaping of the value.\n\n   -  :doc:`Security Helper ` changes include:\n\n      - ``do_hash()`` now uses PHP's native ``hash()`` function (supporting more algorithms) and is deprecated.\n      - :php:func:`strip_image_tags()` is now an alias for the same method in the :doc:`Security Library `.\n\n   -  *Smiley Helper* changes include:\n\n      - Deprecated the whole helper as too specific for CodeIgniter.\n      - Removed previously deprecated function ``js_insert_smiley()``.\n      - Changed application and environment config files to be loaded in a cascade-like manner.\n      - The smileys array is now cached and loaded only once.\n\n   -  :doc:`File Helper ` changes include:\n\n      - :php:func:`set_realpath()` can now also handle file paths as opposed to just directories.\n      - Added an optional paramater to :php:func:`delete_files()` to enable it to skip deleting files such as *.htaccess* and *index.html*.\n      - Deprecated function ``read_file()`` - it's just an alias for PHP's native ``file_get_contents()``.\n\n   -  :doc:`String Helper ` changes include:\n\n      - Deprecated function ``repeater()`` - it's just an alias for PHP's native ``str_repeat()``.\n      - Deprecated function ``trim_slashes()`` - it's just an alias for PHP's native ``trim()`` (with a slash as its second argument).\n      - Deprecated randomization type options **unique** and **encrypt** for funcion :php:func:`random_string()` (they are only aliases for **md5** and **sha1** respectively).\n\n   -  :doc:`CAPTCHA Helper ` changes include:\n\n      - Added *word_length* and *pool* options to allow customization of the generated word.\n      - Added *colors* configuration to allow customization for the *background*, *border*, *text* and *grid* colors.\n      - Added *filename* to the returned array elements.\n      - Updated to use `imagepng()` in case that `imagejpeg()` isn't available.\n      - Added **font_size** option to allow customization of font size.\n      - Added **img_id** option to set id attribute of captcha image.\n\n   -  :doc:`Text Helper ` changes include:\n\n      - Changed the default tag for use in :php:func:`highlight_phrase()` to ```` (formerly ````).\n      - Changed :php:func:`character_limiter()`, :php:func:`word_wrap()` and :php:func:`ellipsize()` to utilize `mbstring `_ or `iconv `_, if available.\n\n   -  :doc:`Directory Helper ` :php:func:`directory_map()` will now append ``DIRECTORY_SEPARATOR`` to directory names in the returned array.\n   -  :doc:`Array Helper ` :php:func:`element()` and :php:func:`elements()` now return NULL instead of FALSE when the required elements don't exist.\n   -  :doc:`Language Helper ` :php:func:`lang()` now accepts an optional list of additional HTML attributes.\n   -  Deprecated the *Email Helper* as its ``valid_email()``, ``send_email()`` functions are now only aliases for PHP native functions ``filter_var()`` and ``mail()`` respectively.\n\n-  Database\n\n   -  DEPRECATED the 'mysql', 'sqlite', 'mssql' and 'pdo/dblib' (also known as 'pdo/mssql' or 'pdo/sybase') drivers.\n   -  Added **dsn** configuration setting for drivers that support DSN strings (PDO, PostgreSQL, Oracle, ODBC, CUBRID).\n   -  Added **schema** configuration setting (defaults to *public*) for drivers that might need it (currently used by PostgreSQL and ODBC).\n   -  Added **save_queries** configuration setting to *application/config/database.php* (defaults to ``TRUE``).\n   -  Removed **autoinit** configuration setting as it doesn't make sense to instantiate the database class but not connect to the database.\n   -  Added subdrivers support (currently only used by PDO).\n   -  Added an optional database name parameter to ``db_select()``.\n   -  Removed ``protect_identifiers()`` and renamed internal method ``_protect_identifiers()`` to it instead - it was just an alias.\n   -  Renamed internal method ``_escape_identifiers()`` to ``escape_identifiers()``.\n   -  Updated ``escape_identifiers()`` to accept an array of fields as well as strings.\n   -  MySQL and MySQLi drivers now require at least MySQL version 5.1.\n   -  Added a ``$persistent`` parameter to ``db_connect()`` and changed ``db_pconnect()`` to be an alias for ``db_connect(TRUE)``.\n   -  ``db_set_charset()`` now only requires one parameter (collation was only needed due to legacy support for MySQL versions prior to 5.1).\n   -  ``db_select()`` will now always (if required by the driver) be called by ``db_connect()`` instead of only when initializing.\n   -  Replaced the ``_error_message()`` and ``_error_number()`` methods with ``error()``, which returns an array containing the last database error code and message.\n   -  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.\n   -  Added capability for packages to hold *config/database.php* config files.\n   -  Added MySQL client compression support.\n   -  Added encrypted connections support (for *mysql*, *sqlsrv* and PDO with *sqlsrv*).\n   -  Removed :doc:`Loader Class ` from Database error tracing to better find the likely culprit.\n   -  Added support for SQLite3 database driver.\n   -  Added Interbase/Firebird database support via the *ibase* driver.\n   -  Added ODBC support for ``create_database()``, ``drop_database()`` and ``drop_table()`` in :doc:`Database Forge `.\n   -  Added support to binding arrays as ``IN()`` sets in ``query()``.\n\n   -  :doc:`Query Builder ` changes include:\n\n      - Renamed the Active Record class to Query Builder to remove confusion with the Active Record design pattern.\n      - Added the ability to insert objects with ``insert_batch()``.\n      - 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()``.\n      - 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()``.\n      - Added support for ``join()`` with multiple conditions.\n      - Added support for *USING* in ``join()``.\n      - Added support for *EXISTS* in ``where()``.\n      - Added seed values support for random ordering with ``order_by(seed, 'RANDOM')``.\n      - Changed ``limit()`` to ignore NULL values instead of always casting to integer.\n      - Changed ``offset()`` to ignore empty values instead of always casting to integer.\n      - Methods ``insert_batch()`` and ``update_batch()`` now return an integer representing the number of rows affected by them.\n      - 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``.\n      - Added method chaining support to ``reset_query()``, ``start_cache()``, ``stop_cache()`` and ``flush_cache()``.\n      - Added an optional second parameter to ``count_all_results()`` to disable resetting of QB values.\n\n   -  :doc:`Database Results ` changes include:\n\n      - 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.\n      - Added method ``unbuffered_row()`` for fetching a row without prefetching the whole result (consume less memory).\n      - Renamed former method ``_data_seek()`` to ``data_seek()`` and made it public.\n\n   -  Improved support for the MySQLi driver, including:\n\n      - OOP style usage of the PHP extension is now used, instead of the procedural aliases.\n      - Server version checking is now done via ``mysqli::$server_info`` instead of running an SQL query.\n      - Added persistent connections support for PHP >= 5.3.\n      - Added support for configuring socket pipe connections.\n      - Added support for ``backup()`` in :doc:`Database Utilities `.\n      - Changed methods ``trans_begin()``, ``trans_commit()`` and ``trans_rollback()`` to use the PHP API instead of sending queries.\n\n   -  Improved support of the PDO driver, including:\n\n      - Added support for ``create_database()``, ``drop_database()`` and ``drop_table()`` in :doc:`Database Forge `.\n      - Added support for ``list_fields()`` in :doc:`Database Results `.\n      - Subdrivers are now isolated from each other instead of being in one large class.\n\n   -  Improved support of the PostgreSQL driver, including:\n\n      - ``pg_version()`` is now used to get the database version number, when possible.\n      - Added ``db_set_charset()`` support.\n      - Added support for ``optimize_table()`` in :doc:`Database Utilities ` (rebuilds table indexes).\n      - Added boolean data type support in ``escape()``.\n      - Added ``update_batch()`` support.\n      - Removed ``limit()`` and ``order_by()`` support for *UPDATE* and *DELETE* queries as PostgreSQL does not support those features.\n      - Added a work-around for dead persistent connections to be re-created after a database restart.\n      - Changed ``db_connect()`` to include the (new) **schema** value into Postgre's **search_path** session variable.\n      - ``pg_escape_literal()`` is now used for escaping strings, if available.\n\n   -  Improved support of the CUBRID driver, including:\n\n      - Added DSN string support.\n      - Added persistent connections support.\n      - Improved ``list_databases()`` in :doc:`Database Utility ` (until now only the currently used database was returned).\n\n   -  Improved support of the MSSQL and SQLSRV drivers, including:\n\n      - Added random ordering support.\n      - Added support for ``optimize_table()`` in :doc:`Database Utility `.\n      - Added escaping with *QUOTE_IDENTIFIER* setting detection.\n      - Added port handling support for UNIX-based systems (MSSQL driver).\n      - Added *OFFSET* support for SQL Server 2005 and above.\n      - Added ``db_set_charset()`` support (MSSQL driver).\n      - Added a *scrollable* property to enable configuration of the cursor to use (SQLSRV driver).\n      - Added support and auto-detection for the ``SQLSRV_CURSOR_CLIENT_BUFFERED`` scrollable cursor flag (SQLSRV driver).\n      - Changed default behavior to not use ``SQLSRV_CURSOR_STATIC`` due to performance issues (SQLSRV driver).\n\n   -  Improved support of the Oracle (OCI8) driver, including:\n\n      - Added DSN string support (Easy Connect and TNS).\n      - Added support for ``drop_table()`` in :doc:`Database Forge `.\n      - Added support for ``list_databases()`` in :doc:`Database Utilities `.\n      - Generally improved for speed and cleaned up all of its components.\n      - ``num_rows()`` is now only called explicitly by the developer and no longer re-executes statements.\n\n   -  Improved support of the SQLite driver, including:\n\n      - Added support for ``replace()`` in :doc:`Query Builder `.\n      - Added support for ``drop_table()`` in :doc:`Database Forge `.\n\n   -  :doc:`Database Forge ` changes include:\n\n      - Added an optional second parameter to ``drop_table()`` that allows adding the **IF EXISTS** condition, which is no longer the default.\n      - Added support for passing a custom database object to the loader.\n      - Added support for passing custom table attributes (such as ``ENGINE`` for MySQL) to ``create_table()``.\n      - Added support for usage of the *FIRST* clause in ``add_column()`` for MySQL and CUBRID.\n      - Added partial support for field comments (MySQL, PostgreSQL, Oracle).\n      - Deprecated ``add_column()``'s third method. *AFTER* clause should now be added to the field definition array instead.\n      - Overall improved support for all of the drivers.\n\n   -  :doc:`Database Utility ` changes include:\n\n      - Added support for passing a custom database object to the loader.\n      - Modified the class to no longer extend :doc:`Database Forge `, which has been a deprecated behavior for awhile.\n      - Overall improved support for all of the drivers.\n      - 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.\n\n-  Libraries\n\n   -  Added a new :doc:`Encryption Library ` to replace the old, largely insecure **Encrypt Library**.\n\n   -  **Encrypt Library** changes include:\n\n      -  Deprecated the library in favor of the new :doc:`Encryption Library `.\n      -  Added support for hashing algorithms other than SHA1 and MD5.\n      -  Removed previously deprecated ``sha1()`` method.\n\n   -  :doc:`Session Library ` changes include:\n\n      -  Completely re-written the library to use self-contained drivers via ``$config['sess_driver']``.\n      -  Added 'files', 'database', 'redis' and 'memcached' drivers (using 'files' by default).\n      -  Added ``$config['sess_save_path']`` setting to specify where the session data is stored, depending on the driver.\n      -  Dropped support for storing session data in cookies (which renders ``$config['sess_encrypt_cookie']`` useless and is therefore also removed).\n      -  Dropped official  support for storing session data in databases other than MySQL and PostgreSQL.\n      -  Changed table structure for the 'database' driver.\n      -  Added a new **tempdata** feature that allows setting userdata items with expiration time (``mark_as_temp()``, ``tempdata()``, ``set_tempdata()``, ``unset_tempdata()``).\n      -  Changed method ``keep_flashdata()`` to also accept an array of keys.\n      -  Changed methods ``userdata()``, ``flashdata()`` to return an array of all userdata/flashdata when no parameter is passed.\n      -  Deprecated method ``all_userdata()`` - it is now just an alias for ``userdata()`` with no parameters.\n      -  Added method ``has_userdata()`` that verifies the existence of a userdata item.\n      -  Added *debug* level log messages for key events in the session validation process.\n      -  Dropped support for the *sess_match_useragent* option.\n\n   -  :doc:`File Uploading Library ` changes include:\n\n      -  Added method chaining support.\n      -  Added support for using array notation in file field names.\n      -  Added **max_filename_increment** and **file_ext_tolower** configuration settings.\n      -  Added **min_width** and **min_height** configuration settings for images.\n      -  Added **mod_mime_fix** configuration setting to disable suffixing multiple file extensions with an underscore.\n      -  Added the possibility pass **allowed_types** as an array.\n      -  Added an ``$index`` parameter to the method ``data()``.\n      -  Added a ``$reset`` parameter to method ``initialize()``.\n      -  Removed method ``clean_file_name()`` and its usage in favor of :doc:`Security Library `'s ``sanitize_filename()``.\n      -  Removed method ``mimes_types()``.\n      -  Changed ``CI_Upload::_prep_filename()`` to simply replace all (but the last) dots in the filename with underscores, instead of suffixing them.\n\n   -  :doc:`Calendar Library ` changes include:\n\n      -  Added method chaining support.\n      -  Added configuration to generate days of other months instead of blank cells.\n      -  Added auto-configuration for *next_prev_url* if it is empty and *show_prev_next* is set to TRUE.\n      -  Added support for templating via an array in addition to the encoded string.\n      -  Changed method ``get_total_days()`` to be an alias for :doc:`Date Helper ` :php:func:`days_in_month()`.\n\n   -  *Cart Library* changes include:\n\n      -  Deprecated the library as too specific for CodeIgniter.\n      -  Added method ``remove()`` to remove a cart item, updating with quantity of 0 seemed like a hack but has remained to retain compatibility.\n      -  Added method ``get_item()`` to enable retrieving data for a single cart item.\n      -  Added unicode support for product names.\n      -  Added support for disabling product name strictness via the ``$product_name_safe`` property.\n      -  Changed ``insert()`` method to auto-increment quantity for an item when inserted twice instead of resetting it.\n      -\t Changed ``update()`` method to support updating all properties attached to an item and not to require 'qty'.\n\n   -  :doc:`Image Manipulation Library ` changes include:\n\n      -  The ``initialize()`` method now only sets existing class properties.\n      -  Added support for 3-length hex color values for *wm_font_color* and *wm_shadow_color* properties, as well as validation for them.\n      -  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.\n      -  If property *maintain_ratio* is set to TRUE, ``image_reproportion()`` now doesn't need both width and height to be specified.\n      -  Property *maintain_ratio* is now taken into account when resizing images using ImageMagick library.\n      -  Added support for maintaining transparency for PNG images when watermarking.\n      -  Added a **file_permissions** setting.\n\n   -  :doc:`Form Validation Library ` changes include:\n\n      -  Added method ``error_array()`` to return all error messages as an array.\n      -  Added method ``set_data()`` to set an alternative data array to be validated instead of the default ``$_POST``.\n      -  Added method ``reset_validation()`` which resets internal validation variables in case of multiple validation routines.\n      -  Added support for setting error delimiters in the config file via ``$config['error_prefix']`` and ``$config['error_suffix']``.\n      -  Internal method ``_execute()`` now considers input data to be invalid if a specified rule is not found.\n      -  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).\n      -  Native PHP functions used as rules can now accept an additional parameter, other than the data itself.\n      -  Updated method ``set_rules()`` to accept an array of rules as well as a string.\n      -  Fields that have empty rules set no longer run through validation (and therefore are not considered erroneous).\n      -  Added rule **differs** to check if the value of a field differs from the value of another field.\n      -  Added rule **valid_url**.\n      -  Added rule **in_list** to check if the value of a field is within a given list.\n      -  Added support for named parameters in error messages.\n      -  :doc:`Language ` line keys must now be prefixed with **form_validation_**.\n      -  Added rule **alpha_numeric_spaces**.\n      -  Added support for custom error messages per field rule.\n      -  Added support for callable rules when they are passed as an array.\n      -  Added support for non-ASCII domains in **valid_email** rule, depending on the Intl extension.\n      -  Changed the debug message about an error message not being set to include the rule name it is about.\n\n   -  :doc:`Caching Library ` changes include:\n\n      -  Added Wincache driver.\n      -  Added Redis driver.\n      -  Added a *key_prefix* option for cache IDs.\n      -  Updated driver ``is_supported()`` methods to log at the \"debug\" level.\n      -  Added option to store raw values instead of CI-formatted ones (APC, Memcache).\n      -  Added atomic increment/decrement feature via ``increment()``, ``decrement()``.\n\n   -  :doc:`E-mail Library ` changes include:\n\n      -  Added a custom filename parameter to ``attach()`` as ``$this->email->attach($filename, $disposition, $newname)``.\n      -  Added possibility to send attachment as buffer string in ``attach()`` as ``$this->email->attach($buffer, $disposition, $newname, $mime)``.\n      -  Added possibility to attach remote files by passing a URL.\n      -  Added method ``attachment_cid()`` to enable embedding inline attachments into HTML.\n      -  Added dsn (delivery status notification) option.\n      -  Renamed method ``_set_header()`` to ``set_header()`` and made it public to enable adding custom headers.\n      -  Successfully sent emails will automatically clear the parameters.\n      -  Added a *return_path* parameter to the ``from()`` method.\n      -  Removed the second parameter (character limit) from internal method ``_prep_quoted_printable()`` as it is never used.\n      -  Internal method ``_prep_quoted_printable()`` will now utilize the native ``quoted_printable_encode()``, ``imap_8bit()`` functions (if available) when CRLF is set to \"\\r\\n\".\n      -  Default charset now relies on the global ``$config['charset']`` setting.\n      -  Removed unused protected method ``_get_ip()`` (:doc:`Input Library `'s ``ip_address()`` should be used anyway).\n      -  Internal method ``_prep_q_encoding()`` now utilizes PHP's *mbstring* and *iconv* extensions (when available) and no longer has a second (``$from``) argument.\n      -  Added an optional parameter to ``print_debugger()`` to allow specifying which parts of the message should be printed ('headers', 'subject', 'body').\n      -  Added SMTP keepalive option to avoid opening the connection for each ``send()`` call. Accessible as ``$smtp_keepalive``.\n      -  Public method ``set_header()`` now filters the input by removing all \"\\\\r\" and \"\\\\n\" characters.\n      -  Added support for non-ASCII domains in ``valid_email()``, depending on the Intl extension.\n\n   -  :doc:`Pagination Library ` changes include:\n\n      -  Deprecated usage of the \"anchor_class\" setting (use the new \"attributes\" setting instead).\n      -  Added method chaining support to ``initialize()`` method.\n      -  Added support for the anchor \"rel\" attribute.\n      -  Added support for setting custom attributes.\n      -  Added support for language translations of the *first_link*, *next_link*, *prev_link* and *last_link* values.\n      -  Added support for ``$config['num_links'] = 0`` configuration.\n      -  Added ``$config['reuse_query_string']`` to allow automatic repopulation of query string arguments, combined with normal URI segments.\n      -  Added ``$config['use_global_url_suffix']`` to allow overriding the library 'suffix' value with that of the global ``$config['url_suffix']`` setting.\n      -  Removed the default `` `` from a number of the configuration variables.\n\n   -  :doc:`Profiler Library ` changes include:\n\n      -  Database object names are now being displayed.\n      -  The sum of all queries running times in seconds is now being displayed.\n      -  Added support for displaying the HTTP DNT (\"Do Not Track\") header.\n      -  Added support for displaying ``$_FILES``.\n\n   -  :doc:`Migration Library ` changes include:\n\n      -  Added support for timestamp-based migrations (enabled by default).\n      -  Added ``$config['migration_type']`` to allow switching between *sequential* and *timestamp* migrations.\n\n   -  :doc:`XML-RPC Library ` changes include:\n\n      -  Added the ability to use a proxy.\n      -  Added Basic HTTP authentication support.\n\n   -  :doc:`User Agent Library ` changes include:\n\n      - Added check to detect if robots are pretending to be mobile clients (helps with e.g. Google indexing mobile website versions).\n      - Added method ``parse()`` to allow parsing a custom user-agent string, different from the current visitor's.\n\n   -  :doc:`HTML Table Library ` changes include:\n\n      - Added method chaining support.\n      - Added support for setting table class defaults in a config file.\n\n   -  :doc:`Zip Library ` changes include:\n\n      - Method ``read_file()`` can now also alter the original file path/name while adding files to an archive.\n      - Added support for changing the compression level.\n\n   -  :doc:`Trackback Library ` method ``receive()`` will now utilize ``iconv()`` if it is available but ``mb_convert_encoding()`` is not.\n\n-  Core\n\n   -  :doc:`Routing ` changes include:\n\n      -  Added support for multiple levels of controller directories.\n      -  Added support for per-directory *default_controller* and *404_override* classes.\n      -  Added possibility to route requests using HTTP verbs.\n      -  Added possibility to route requests using callbacks.\n      -  Added a new reserved route (*translate_uri_dashes*) to allow usage of dashes in the controller and method URI segments.\n      -  Deprecated methods ``fetch_directory()``, ``fetch_class()`` and ``fetch_method()`` in favor of their respective public properties.\n      -  Removed method ``_set_overrides()`` and moved its logic to the class constructor.\n\n   -  :doc:`URI Library ` changes include:\n\n      -  Added conditional PCRE UTF-8 support to the \"invalid URI characters\" check and removed the ``preg_quote()`` call from it to allow more flexibility.\n      -  Renamed method ``_filter_uri()`` to ``filter_uri()``.\n      -  Changed method ``filter_uri()`` to accept by reference and removed its return value.\n      -  Changed private methods to protected so that MY_URI can override them.\n      -  Renamed internal method ``_parse_cli_args()`` to ``_parse_argv()``.\n      -  Renamed internal method ``_detect_uri()`` to ``_parse_request_uri()``.\n      -  Changed ``_parse_request_uri()`` to accept absolute URIs for compatibility with HTTP/1.1 as per `RFC2616 `.\n      -  Added protected method ``_parse_query_string()`` to URI paths in the the **QUERY_STRING** value, like ``_parse_request_uri()`` does.\n      -  Changed URI string detection logic to always default to **REQUEST_URI** unless configured otherwise or under CLI.\n      -  Removed methods ``_remove_url_suffix()``, ``_explode_segments()`` and moved their logic into ``_set_uri_string()``.\n      -  Removed method ``_fetch_uri_string()`` and moved its logic into the class constructor.\n      -  Removed method ``_reindex_segments()``.\n\n   -  :doc:`Loader Library ` changes include:\n\n      -  Added method chaining support.\n      -  Added method ``get_vars()`` to the Loader to retrieve all variables loaded with ``$this->load->vars()``.\n      -  ``_ci_autoloader()`` is now a protected method.\n      -  Added autoloading of drivers with ``$autoload['drivers']``.\n      -  ``$config['rewrite_short_tags']`` now has no effect when using PHP 5.4 as ``` changes include:\n\n      -  Deprecated the ``$config['global_xss_filtering']`` setting.\n      -  Added ``method()`` to retrieve ``$_SERVER['REQUEST_METHOD']``.\n      -  Added support for arrays and network addresses (e.g. 192.168.1.1/24) for use with the *proxy_ips* setting.\n      -  Added method ``input_stream()`` to aid in using **php://input** stream data such as one passed via PUT, DELETE and PATCH requests.\n      -  Changed method ``valid_ip()`` to use PHP's native ``filter_var()`` function.\n      -  Changed internal method ``_sanitize_globals()`` to skip enforcing reversal of *register_globals* in PHP 5.4+, where this functionality no longer exists.\n      -  Changed methods ``get()``, ``post()``, ``get_post()``, ``cookie()``, ``server()``, ``user_agent()`` to return NULL instead of FALSE when no value is found.\n      -  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.\n      -  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.\n      -  Changed method ``_fetch_from_array()`` to parse array notation in field name.\n      -  Changed method ``_fetch_from_array()`` to allow retrieving multiple fields at once.\n      -  Added an option for ``_clean_input_keys()`` to return FALSE instead of terminating the whole script.\n      -  Deprecated the ``is_cli_request()`` method, it is now an alias for the new :php:func:`is_cli()` common function.\n      -  Added an ``$xss_clean`` parameter to method ``user_agent()`` and removed the ``$user_agent`` property.\n      -  Added property ``$raw_input_stream`` to access **php://input** data.\n\n   -  :doc:`Common functions ` changes include:\n\n      -  Added function :php:func:`get_mimes()` to return the *application/config/mimes.php* array.\n      -  Added support for HTTP code 303 (\"See Other\") in :php:func:`set_status_header()`.\n      -  Removed redundant conditional to determine HTTP server protocol in :php:func:`set_status_header()`.\n      -  Renamed ``_exception_handler()`` to ``_error_handler()`` and replaced it with a real exception handler.\n      -  Changed ``_error_handler()`` to respect php.ini *display_errors* setting.\n      -  Added function :php:func:`is_https()` to check if a secure connection is used.\n      -  Added function :php:func:`is_cli()` to replace the ``CI_Input::is_cli_request()`` method.\n      -  Added function :php:func:`function_usable()` to work around a bug in `Suhosin `.\n      -  Removed the third (`$php_error`) argument from function :php:func:`log_message()`.\n      -  Changed internal function ``load_class()`` to accept a constructor parameter instead of (previously unused) class name prefix.\n      -  Removed default parameter value of :php:func:`is_php()`.\n      -  Added a second argument ``$double_encode`` to :php:func:`html_escape()`.\n      -  Changed function :php:func:`config_item()` to return NULL instead of FALSE when no value is found.\n      -  Changed function :php:func:`set_status_header()` to return immediately when run under CLI.\n\n   -  :doc:`Output Library ` changes include:\n\n      -  Added a second argument to method ``set_content_type()`` that allows setting the document charset as well.\n      -  Added methods ``get_content_type()`` and ``get_header()``.\n      -  Added method ``delete_cache()``.\n      -  Added configuration option ``$config['cache_query_string']`` to enable taking the query string into account when caching.\n      -  Changed caching behavior to compress the output before storing it, if ``$config['compress_output']`` is enabled.\n\n   -  :doc:`Config Library ` changes include:\n\n      -  Changed ``site_url()`` method  to accept an array as well.\n      -  Removed internal method ``_assign_to_config()`` and moved its implementation to *CodeIgniter.php* instead.\n      -  ``item()`` now returns NULL instead of FALSE when the required config item doesn't exist.\n      -  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.\n      -  Added HTTP \"Host\" header character validation to prevent cache poisoning attacks when ``base_url`` auto-detection is used.\n\n   -  :doc:`Security Library ` changes include:\n\n      -  Added ``$config['csrf_regeneration']``, which makes CSRF token regeneration optional.\n      -  Added ``$config['csrf_exclude_uris']``, allowing for exclusion of URIs from the CSRF protection (regular expressions are supported).\n      -  Added method ``strip_image_tags()``.\n      -  Added method ``get_random_bytes()`` and switched CSRF & XSS token generation to use it.\n      -  Modified method ``sanitize_filename()`` to read a public ``$filename_bad_chars`` property for getting the invalid characters list.\n      -  Return status code of 403 instead of a 500 if CSRF protection is enabled but a token is missing from a request.\n\n   -  :doc:`Language Library ` changes include:\n\n      -  Changed method ``load()`` to filter the language name with ``ctype_alpha()``.\n      -  Changed method ``load()`` to also accept an array of language files.\n      -  Added an optional second parameter to method ``line()`` to disable error logging for line keys that were not found.\n      -  Language files are now loaded in a cascading style with the one in **system/** always loaded and overridden afterwards, if another one is found.\n\n   -  :doc:`Hooks Library ` changes include:\n\n      -  Added support for closure hooks (or anything that ``is_callable()`` returns TRUE for).\n      -  Renamed method ``_call_hook()`` to ``call_hook()``.\n      -  Class instances are now stored in order to maintain their state.\n\n   -  UTF-8 Library changes include:\n\n      -  ``UTF8_ENABLED`` now requires only one of `Multibyte String `_ or `iconv `_ to be available instead of both.\n      -  Changed method ``clean_string()`` to utilize ``mb_convert_encoding()`` if it is available.\n      -  Renamed method ``_is_ascii()`` to ``is_ascii()`` and made it public.\n\n   -  Log Library changes include:\n\n      -  Added a ``$config['log_file_permissions']`` setting.\n      -  Changed the library constructor to try to create the **log_path** directory if it doesn't exist.\n      -  Added support for microseconds (\"u\" date format character) in ``$config['log_date_format']``.\n\n   -  Added :doc:`compatibility layers ` for:\n\n      - `Multibyte String `_ (limited support).\n      - `Hash `_ (``hash_equals()``, ``hash_pbkdf2()``).\n      - `Password Hashing `_.\n      - `Standard Functions ``array_column()``, ``array_replace()``, ``array_replace_recursive()``, ``hex2bin()``, ``quoted_printable_encode()``.\n\n   -  Removed ``CI_CORE`` boolean constant from *CodeIgniter.php* (no longer Reactor and Core versions).\n   -  Added support for HTTP-Only cookies with new config option *cookie_httponly* (default FALSE).\n   -  ``$config['time_reference']`` now supports all timezone strings supported by PHP.\n   -  Fatal PHP errors are now also passed to ``_error_handler()``, so they can be logged.\n\n\nBug fixes for 3.0\n-----------------\n\n-  Fixed a bug where ``unlink()`` raised an error if cache file did not exist when you try to delete it.\n-  Fixed a bug (#181) - a typo in the form validation language file.\n-  Fixed a bug (#159, #163) - :doc:`Query Builder ` nested transactions didn't work properly due to ``$_trans_depth`` not being incremented.\n-  Fixed a bug (#737, #75) - :doc:`Pagination ` anchor class was not set properly when using initialize method.\n-  Fixed a bug (#419) - :doc:`URL Helper ` :php:func:`auto_link()` didn't recognize URLs that come after a word boundary.\n-  Fixed a bug (#724) - :doc:`Form Validation Library ` rule **is_unique** didn't check if a database connection exists.\n-  Fixed a bug (#647) - :doc:`Zip Library ` internal method ``_get_mod_time()`` didn't suppress possible \"stat failed\" errors generated by ``filemtime()``.\n-  Fixed a bug (#157, #174) - :doc:`Image Manipulation Library ` method ``clear()`` didn't completely clear properties.\n-  Fixed a bug where :doc:`Database Forge ` method ``create_table()`` with PostgreSQL database could lead to fetching the whole table.\n-  Fixed a bug (#795) - :doc:`Form Helper ` :php:func:`form_open()` didn't add the default form *method* and *accept-charset* when an empty array is passed to it.\n-  Fixed a bug (#797) - :doc:`Date Helper ` :php:func:`timespan()` was using incorrect seconds for year and month.\n-  Fixed a bug in *Cart Library* method ``contents()`` where if called without a TRUE (or equal) parameter, it would fail due to a typo.\n-  Fixed a bug (#406) - SQLSRV DB driver not returning resource on ``db_pconnect()``.\n-  Fixed a bug in :doc:`Image Manipulation Library ` method ``gd_loaded()`` where it was possible for the script execution to end or a PHP E_WARNING message to be emitted.\n-  Fixed a bug in the :doc:`Pagination library ` where when use_page_numbers=TRUE previous link and page 1 link did not have the same url.\n-  Fixed a bug (#561) - errors in :doc:`XML-RPC Library ` were not properly escaped.\n-  Fixed a bug (#904) - :doc:`Loader Library ` method ``initialize()`` caused a PHP Fatal error to be triggered if error level E_STRICT is used.\n-  Fixed a hosting edge case where an empty ``$_SERVER['HTTPS']`` variable would evaluate to 'on'.\n-  Fixed a bug (#154) - :doc:`Session Library ` method ``sess_update()`` caused the session to be destroyed on pages where multiple AJAX requests were executed at once.\n-  Fixed a possible bug in :doc:`Input Libary ` method ``is_ajax_request()`` where some clients might not send the X-Requested-With HTTP header value exactly as 'XmlHttpRequest'.\n-  Fixed a bug (#1039) - :doc:`Database Utilities ` internal method ``_backup()`` method failed for the 'mysql' driver due to a table name not being escaped.\n-  Fixed a bug (#1070) - ``CI_DB_driver::initialize()`` didn't set a character set if a database is not selected.\n-  Fixed a bug (#177) - :doc:`Form Validation Library ` method ``set_value()`` didn't set the default value if POST data is NULL.\n-  Fixed a bug (#68, #414) - :Oracle's ``escape_str()`` didn't properly escape LIKE wild characters.\n-  Fixed a bug (#81) - ODBC's ``list_fields()`` and ``field_data()`` methods skipped the first column due to ``odbc_field_*()`` functions' index starting at 1 instead of 0.\n-  Fixed a bug (#129) - ODBC's ``num_rows()`` method returned -1 in some cases, due to not all subdrivers supporting the ``odbc_num_rows()`` function.\n-  Fixed a bug (#153) - E_NOTICE being generated by ``getimagesize()`` in the :doc:`File Uploading Library `.\n-  Fixed a bug (#611) - SQLSRV's error handling methods used to issue warnings when there's no actual error.\n-  Fixed a bug (#1036) - ``is_write_type()`` method in the :doc:`Database Library ` didn't return TRUE for RENAME queries.\n-  Fixed a bug in PDO's ``_version()`` method where it used to return the client version as opposed to the server one.\n-  Fixed a bug in PDO's ``insert_id()`` method where it could've failed if it's used with Postgre versions prior to 8.1.\n-  Fixed a bug in CUBRID's ``affected_rows()`` method where a connection resource was passed to ``cubrid_affected_rows()`` instead of a result.\n-  Fixed a bug (#638) - ``db_set_charset()`` ignored its arguments and always used the configured charset instead.\n-  Fixed a bug (#413) - Oracle's error handling methods used to only return connection-related errors.\n-  Fixed a bug (#1101) - :doc:`Database Result ` method ``field_data()`` for 'mysql', 'mysqli' drivers was implemented as if it was handling a DESCRIBE result instead of the actual result set.\n-  Fixed a bug in Oracle's :doc:`Database Forge ` method ``_create_table()`` where it failed with AUTO_INCREMENT as it's not supported.\n-  Fixed a bug (#1080) - when using the SMTP protocol, :doc:`Email Library ` method ``send()`` was returning TRUE even if the connection/authentication against the server failed.\n-  Fixed a bug (#306) - ODBC's ``insert_id()`` method was calling non-existent function ``odbc_insert_id()``, which resulted in a fatal error.\n-  Fixed a bug in Oracle's :doc:`Database Result ` implementation where the cursor ID passed to it was always NULL.\n-  Fixed a bug (#64) - Regular expression in *DB_query_builder.php* failed to handle queries containing SQL bracket delimiters in the JOIN condition.\n-  Fixed a bug in the :doc:`Session Library ` where a PHP E_NOTICE error was triggered by ``_unserialize()`` due to results from databases such as MSSQL and Oracle being space-padded on the right.\n-  Fixed a bug (#501) - :doc:`Form Validation Library ` method ``set_rules()`` depended on ``count($_POST)`` instead of actually checking if the request method 'POST' before aborting.\n-  Fixed a bug (#136) - PostgreSQL and MySQL's ``escape_str()`` method didn't properly escape LIKE wild characters.\n-  Fixed a bug in :doc:`Loader Library ` method ``library()`` where some PHP versions wouldn't execute the class constructor.\n-  Fixed a bug (#88) - An unexisting property was used for configuration of the Memcache cache driver.\n-  Fixed a bug (#14) - :doc:`Database Forge ` method ``create_database()`` didn't utilize the configured database character set.\n-  Fixed a bug (#23, #1238) - :doc:`Database Caching ` method ``delete_all()`` used to delete .htaccess and index.html files, which is a potential security risk.\n-  Fixed a bug in :doc:`Trackback Library ` method ``validate_url()`` where it didn't actually do anything, due to input not being passed by reference.\n-  Fixed a bug (#11, #183, #863) - :doc:`Form Validation Library ` method ``_execute()`` silently continued to the next rule, if a rule method/function is not found.\n-  Fixed a bug (#122) - routed URI string was being reported incorrectly in sub-directories.\n-  Fixed a bug (#1241) - :doc:`Zip Library ` method ``read_dir()`` wasn't compatible with Windows.\n-  Fixed a bug (#306) - ODBC driver didn't have an ``_insert_batch()`` method, which resulted in fatal error being triggered when ``insert_batch()`` is used with it.\n-  Fixed a bug in MSSQL and SQLSrv's ``_truncate()`` where the TABLE keyword was missing.\n-  Fixed a bug in PDO's ``trans_commit()`` method where it failed due to an erroneous property name.\n-  Fixed a bug (#798) - :doc:`Query Builder ` method ``update()`` used to ignore LIKE conditions that were set with ``like()``.\n-  Fixed a bug in Oracle's and MSSQL's ``delete()`` methods where an erroneous SQL statement was generated when used with ``limit()``.\n-  Fixed a bug in SQLSRV's ``delete()`` method where ``like()`` and ``limit()`` conditions were ignored.\n-  Fixed a bug (#1265) - Database connections were always closed, regardless of the 'pconnect' option value.\n-  Fixed a bug (#128) - :doc:`Language Library ` did not correctly keep track of loaded language files.\n-  Fixed a bug (#1349) - :doc:`File Uploading Library ` method ``get_extension()`` returned the original filename when it didn't have an actual extension.\n-  Fixed a bug (#1273) - :doc:`Query Builder ` method ``set_update_batch()`` generated an E_NOTICE message.\n-  Fixed a bug (#44, #110) - :doc:`File Uploading Library ` method ``clean_file_name()`` didn't clear '!' and '#' characters.\n-  Fixed a bug (#121) - :doc:`Database Results ` method ``row()`` returned an array when there's no actual result to be returned.\n-  Fixed a bug (#319) - SQLSRV's ``affected_rows()`` method failed due to a scrollable cursor being created for write-type queries.\n-  Fixed a bug (#356) - :doc:`Database ` driver 'postgre' didn't have an ``_update_batch()`` method, which resulted in fatal error being triggered when ``update_batch()`` is used with it.\n-  Fixed a bug (#784, #862) - :doc:`Database Forge ` method ``create_table()`` failed on SQLSRV/MSSQL when used with 'IF NOT EXISTS'.\n-  Fixed a bug (#1419) - :doc:`Driver Library ` had a static variable that was causing an error.\n-  Fixed a bug (#1411) - the :doc:`Email Library ` used its own short list of MIMEs instead the one from *config/mimes.php*.\n-  Fixed a bug where php.ini setting *magic_quotes_runtime* wasn't turned off for PHP 5.3 (where it is indeed deprecated, but not non-existent).\n-  Fixed a bug (#666) - :doc:`Output Library ` method ``set_content_type()`` didn't set the document charset.\n-  Fixed a bug (#784, #861) - :doc:`Database Forge ` method ``create_table()`` used to accept constraints for MSSQL/SQLSRV integer-type columns.\n-  Fixed a bug (#706) - SQLSRV/MSSSQL :doc:`Database ` drivers didn't escape field names.\n-  Fixed a bug (#1452) - :doc:`Query Builder ` method ``protect_identifiers()`` didn't properly detect identifiers with spaces in their names.\n-  Fixed a bug where :doc:`Query Builder ` method ``protect_identifiers()`` ignored its extra arguments when the value passed to it is an array.\n-  Fixed a bug where :doc:`Query Builder ` internal method ``_has_operator()`` didn't detect BETWEEN.\n-  Fixed a bug where :doc:`Query Builder ` method ``join()`` failed with identifiers containing dashes.\n-  Fixed a bug (#1264) - :doc:`Database Forge ` and :doc:`Database Utilities ` didn't update/reset the databases and tables list cache when a table or a database is created, dropped or renamed.\n-  Fixed a bug (#7) - :doc:`Query Builder ` method ``join()`` only escaped one set of conditions.\n-  Fixed a bug (#1321) - ``CI_Exceptions`` couldn't find the *errors/* directory in some cases.\n-  Fixed a bug (#1202) - **Encrypt Library** ``encode_from_legacy()`` didn't set back the encrypt mode on failure.\n-  Fixed a bug (#145) - :doc:`Database Class ` method ``compile_binds()`` failed when the bind marker was present in a literal string within the query.\n-  Fixed a bug in :doc:`Query Builder ` method ``protect_identifiers()`` where if passed along with the field names, operators got escaped as well.\n-  Fixed a bug (#10) - :doc:`URI Library ` internal method ``_detect_uri()`` failed with paths containing a colon.\n-  Fixed a bug (#1387) - :doc:`Query Builder ` method ``from()`` didn't escape table aliases.\n-  Fixed a bug (#520) - :doc:`Date Helper ` function ``nice_date()`` failed when the optional second parameter is not passed.\n-  Fixed a bug (#318) - :doc:`Profiling Library ` setting *query_toggle_count* was not settable as described in the manual.\n-  Fixed a bug (#938) - :doc:`Config Library ` method ``site_url()`` added a question mark to the URL string when query strings are enabled even if it already existed.\n-  Fixed a bug (#999) - :doc:`Config Library ` method ``site_url()`` always appended ``$config['url_suffix']`` to the end of the URL string, regardless of whether a query string exists in it.\n-  Fixed a bug where :doc:`URL Helper ` function :php:func:`anchor_popup()` ignored the attributes argument if it is not an array.\n-  Fixed a bug (#1328) - :doc:`Form Validation Library ` didn't properly check the type of the form fields before processing them.\n-  Fixed a bug (#79) - :doc:`Form Validation Library ` didn't properly validate array fields that use associative keys or have custom indexes.\n-  Fixed a bug (#427) - :doc:`Form Validation Library ` method ``strip_image_tags()`` was an alias to a non-existent method.\n-  Fixed a bug (#1545) - :doc:`Query Builder ` method ``limit()`` wasn't executed properly under Oracle.\n-  Fixed a bug (#1551) - :doc:`Date Helper ` function ``standard_date()`` didn't properly format *W3C* and *ATOM* standard dates.\n-  Fixed a bug where :doc:`Query Builder ` method ``join()`` escaped literal values as if they were fields.\n-  Fixed a bug (#135) - PHP Error logging was impossible without the errors being displayed.\n-  Fixed a bug (#1613) - :doc:`Form Helper ` functions :php:func:`form_multiselect()`, :php:func:`form_dropdown()` didn't properly handle empty array option groups.\n-  Fixed a bug (#1605) - :doc:`Pagination Library ` produced incorrect *previous* and *next* link values.\n-  Fixed a bug in SQLSRV's ``affected_rows()`` method where an erroneous function name was used.\n-  Fixed a bug (#1000) - Change syntax of ``$view_file`` to ``$_ci_view_file`` to prevent being overwritten by application.\n-  Fixed a bug (#1757) - :doc:`Directory Helper ` function :php:func:`directory_map()` was skipping files and directories named '0'.\n-  Fixed a bug (#1789) - :doc:`Database Library ` method ``escape_str()`` escaped quote characters in LIKE conditions twice under MySQL.\n-  Fixed a bug (#395) - :doc:`Unit Testing Library ` method ``result()`` didn't properly check array result columns when called from ``report()``.\n-  Fixed a bug (#1692) - :doc:`Database Class ` method ``display_error()`` didn't properly trace the possible error source on Windows systems.\n-  Fixed a bug (#1745) - :doc:`Database Class ` method ``is_write_type()`` didn't return TRUE for LOAD queries.\n-  Fixed a bug (#1765) - :doc:`Database Class ` didn't properly detect connection errors for the 'mysqli' driver.\n-  Fixed a bug (#1257) - :doc:`Query Builder ` used to (unnecessarily) group FROM clause contents, which breaks certain queries and is invalid for some databases.\n-  Fixed a bug (#1709) - :doc:`Email ` headers were broken when using long email subjects and \\r\\n as CRLF.\n-  Fixed a bug where ``MB_ENABLED`` constant was only declared if ``UTF8_ENABLED`` was set to TRUE.\n-  Fixed a bug where the :doc:`Session Library ` accepted cookies with *last_activity* values being in the future.\n-  Fixed a bug (#1897) - :doc:`Email Library ` triggered PHP E_WARNING errors when *mail* protocol used and ``to()`` is never called.\n-  Fixed a bug (#1409) - :doc:`Email Library ` didn't properly handle multibyte characters when applying Q-encoding to headers.\n-  Fixed a bug where :doc:`Email Library ` ignored its *wordwrap* setting while handling alternative messages.\n-  Fixed a bug (#1476, #1909) - :doc:`Pagination Library ` didn't take into account actual routing when determining the current page.\n-  Fixed a bug (#1766) - :doc:`Query Builder ` didn't always take into account the *dbprefix* setting.\n-  Fixed a bug (#779) - :doc:`URI Class ` didn't always trim slashes from the *uri_string* as shown in the documentation.\n-  Fixed a bug (#134) - :doc:`Database Caching ` method ``delete_cache()`` didn't work in some cases due to *cachedir* not being initialized properly.\n-  Fixed a bug (#191) - :doc:`Loader Library ` ignored attempts for (re)loading databases to ``get_instance()->db`` even when the old database connection is dead.\n-  Fixed a bug (#1255) - :doc:`User Agent Library ` method ``is_referral()`` only checked if ``$_SERVER['HTTP_REFERER']`` exists.\n-  Fixed a bug (#1146) - :doc:`Download Helper ` function :php:func:`force_download()` incorrectly sent *Cache-Control* directives *pre-check* and *post-check* to Internet Explorer.\n-  Fixed a bug (#1811) - :doc:`URI Library ` didn't properly cache segments for ``uri_to_assoc()`` and ``ruri_to_assoc()``.\n-  Fixed a bug (#1506) - :doc:`Form Helpers ` set empty *name* attributes.\n-  Fixed a bug (#59) - :doc:`Query Builder ` method ``count_all_results()`` ignored the DISTINCT clause.\n-  Fixed a bug (#1624) - :doc:`Form Validation Library ` rule **matches** didn't property handle array field names.\n-  Fixed a bug (#1630) - :doc:`Form Helper ` function :php:func:`set_value()` didn't escape HTML entities.\n-  Fixed a bug (#142) - :doc:`Form Helper ` function :php:func:`form_dropdown()` didn't escape HTML entities in option values.\n-  Fixed a bug (#50) - :doc:`Session Library ` unnecessarily stripped slashed from serialized data, making it impossible to read objects in a namespace.\n-  Fixed a bug (#658) - :doc:`Routing ` wildcard **:any** didn't work as advertised and matched multiple URI segments instead of all characters within a single segment.\n-  Fixed a bug (#1938) - :doc:`Email Library ` removed multiple spaces inside a pre-formatted plain text message.\n-  Fixed a bug (#122) - :doc:`URI Library ` method ``ruri_string()`` didn't include a directory if one is used.\n-  Fixed a bug - :doc:`Routing Library ` didn't properly handle *default_controller* in a subdirectory when a method is also specified.\n-  Fixed a bug (#953) - :doc:`post_controller_constructor hook ` wasn't called with a *404_override*.\n-  Fixed a bug (#1220) - :doc:`Profiler Library ` didn't display information for database objects that are instantiated inside models.\n-  Fixed a bug (#1978) - :doc:`Directory Helper ` function :php:func:`directory_map()`'s return array didn't make a distinction between directories and file indexes when a directory with a numeric name is present.\n-  Fixed a bug (#777) - :doc:`Loader Library ` didn't look for helper extensions in added package paths.\n-  Fixed a bug (#18) - :doc:`APC Cache ` driver didn't (un)serialize data, resulting in failure to store objects.\n-  Fixed a bug (#188) - :doc:`Unit Testing Library ` filled up logs with error messages for non-existing language keys.\n-  Fixed a bug (#113) - :doc:`Form Validation Library ` didn't properly handle empty fields that were specified as an array.\n-  Fixed a bug (#2061) - :doc:`Routing Class ` didn't properly sanitize directory, controller and function triggers with **enable_query_strings** set to TRUE.\n-  Fixed a bug - SQLSRV didn't support ``escape_like_str()`` or escaping an array of values.\n-  Fixed a bug - :doc:`Database Results ` method ``list_fields()`` didn't reset its field pointer for the 'mysql', 'mysqli' and 'mssql' drivers.\n-  Fixed a bug (#2211) - :doc:`Migration Library ` extensions couldn't execute ``CI_Migration::__construct()``.\n-  Fixed a bug (#2255) - :doc:`Email Library ` didn't apply *smtp_timeout* to socket reads and writes.\n-  Fixed a bug (#2239) - :doc:`Email Library ` improperly handled the Subject when used with *bcc_batch_mode* resulting in E_WARNING messages and an empty Subject.\n-  Fixed a bug (#2234) - :doc:`Query Builder ` didn't reset JOIN cache for write-type queries.\n-  Fixed a bug (#2298) - :doc:`Database Results ` method ``next_row()`` kept returning the last row, allowing for infinite loops.\n-  Fixed a bug (#2236, #2639) - :doc:`Form Helper ` functions :php:func:`set_value()`, :php:func:`set_select()`, :php:func:`set_radio()`, :php:func:`set_checkbox()` didn't parse array notation for keys if the rule was not present in the :doc:`Form Validation Library `.\n-  Fixed a bug (#2353) - :doc:`Query Builder ` erroneously prefixed literal strings with **dbprefix**.\n-  Fixed a bug (#78) - *Cart Library* didn't allow non-English letters in product names.\n-  Fixed a bug (#77) - :doc:`Database Class ` didn't properly handle the transaction \"test mode\" flag.\n-  Fixed a bug (#2380) - :doc:`URI Routing ` method ``fetch_method()`` returned 'index' if the requested method name matches its controller name.\n-  Fixed a bug (#2388) - :doc:`Email Library ` used to ignore attachment errors, resulting in broken emails being sent.\n-  Fixed a bug (#2498) - :doc:`Form Validation Library ` rule **valid_base64** only checked characters instead of actual validity.\n-  Fixed a bug (#2425) - OCI8 :doc:`database ` driver method ``stored_procedure()`` didn't log an error unless **db_debug** was set to TRUE.\n-  Fixed a bug (#2490) - :doc:`Database Class ` method ``query()`` returning boolean instead of a result object for PostgreSQL-specific *INSERT INTO ... RETURNING* statements.\n-  Fixed a bug (#249) - :doc:`Cache Library ` didn't properly handle Memcache(d) configurations with missing options.\n-  Fixed a bug (#180) - :php:func:`config_item()` didn't take into account run-time configuration changes.\n-  Fixed a bug (#2551) - :doc:`Loader Library ` method ``library()`` didn't properly check if a class that is being loaded already exists.\n-  Fixed a bug (#2560) - :doc:`Form Helper ` function :php:func:`form_open()` set the 'method=\"post\"' attribute only if the passed attributes equaled an empty string.\n-  Fixed a bug (#2585) - :doc:`Query Builder ` methods ``min()``, ``max()``, ``avg()``, ``sum()`` didn't escape field names.\n-  Fixed a bug (#2590) - :doc:`Common function ` :php:func:`log_message()` didn't actually cache the ``CI_Log`` class instance.\n-  Fixed a bug (#2609) - :doc:`Common function ` :php:func:`get_config()` optional argument was only effective on first function call. Also, it can now add items, in addition to updating existing items.\n-  Fixed a bug in the 'postgre' :doc:`database ` driver where the connection ID wasn't passed to ``pg_escape_string()``.\n-  Fixed a bug (#33) - Script execution was terminated when an invalid cookie key was encountered.\n-  Fixed a bug (#2691) - nested :doc:`database ` transactions could end in a deadlock when an error is encountered with *db_debug* set to TRUE.\n-  Fixed a bug (#2515) - ``_exception_handler()`` used to send the 200 \"OK\" HTTP status code and didn't stop script exection even on fatal errors.\n-  Fixed a bug - Redis :doc:`Caching ` driver didn't handle connection failures properly.\n-  Fixed a bug (#2756) - :doc:`Database Class ` executed the MySQL-specific `SET SESSION sql_mode` query for all drivers when the 'stricton' option is set.\n-  Fixed a bug (#2579) - :doc:`Query Builder ` \"no escape\" functionality didn't work properly with query cache.\n-  Fixed a bug (#2237) - :doc:`Parser Library ` failed if the same tag pair is used more than once within a template.\n-  Fixed a bug (#2143) - :doc:`Form Validation Library ` didn't check for rule groups named in a *controller/method* manner when trying to load from a config file.\n-  Fixed a bug (#2762) - :doc:`Hooks Class ` didn't properly check if the called class/function exists.\n-  Fixed a bug (#148) - :doc:`Input Library ` internal method ``_clean_input_data()`` assumed that it data is URL-encoded, stripping certain character sequences from it.\n-  Fixed a bug (#346) - with ``$config['global_xss_filtering']`` turned on, the ``$_GET``, ``$_POST``, ``$_COOKIE`` and ``$_SERVER`` superglobals were overwritten during initialization time, resulting in XSS filtering being either performed twice or there was no possible way to get the original data, even though options for this do exist.\n-  Fixed an edge case (#555) - :doc:`User Agent Library ` reported an incorrect version Opera 10+ due to a non-standard user-agent string.\n-  Fixed a bug (#133) - :doc:`Text Helper ` :php:func:`ascii_to_entities()` stripped the last character if it happens to be in the extended ASCII group.\n-  Fixed a bug (#2822) - ``fwrite()`` was used incorrectly throughout the whole framework, allowing incomplete writes when writing to a network stream and possibly a few other edge cases.\n-  Fixed a bug where :doc:`User Agent Library ` methods ``accept_charset()`` and ``accept_lang()`` didn't properly parse HTTP headers that contain spaces.\n-  Fixed a bug where *default_controller* was called instad of triggering a 404 error if the current route is in a controller directory.\n-  Fixed a bug (#2737) - :doc:`XML-RPC Library ` used objects as array keys, which triggered E_NOTICE messages.\n-  Fixed a bug (#2771) - :doc:`Security Library ` method ``xss_clean()`` didn't take into account HTML5 entities.\n-  Fixed a bug (#2856) - ODBC method ``affected_rows()`` passed an incorrect value to ``odbc_num_rows()``.\n-  Fixed a bug (#43) :doc:`Image Manipulation Library ` method ``text_watermark()`` didn't properly determine watermark placement.\n-  Fixed a bug where :doc:`HTML Table Library ` ignored its *auto_heading* setting if headings were not already set.\n-  Fixed a bug (#2364) - :doc:`Pagination Library ` appended the query string (if used) multiple times when there are successive calls to ``create_links()`` with no ``initialize()`` in between them.\n-  Partially fixed a bug (#261) - UTF-8 class method ``clean_string()`` generating log messages and/or not producing the desired result due to an upstream bug in iconv.\n-  Fixed a bug where ``CI_Xmlrpcs::parseRequest()`` could fail if ``$HTTP_RAW_POST_DATA`` is not populated.\n-  Fixed a bug in :doc:`Zip Library ` internal method ``_get_mod_time()`` where it was not parsing result returned by ``filemtime()``.\n-  Fixed a bug (#3161) - :doc:`Cache Library ` methods `increment()`, `decrement()` didn't auto-create non-existent items when using redis and/or file storage.\n-  Fixed a bug (#3189) - :doc:`Parser Library ` used double replacement on ``key->value`` pairs, exposing a potential template injection vulnerability.\n-  Fixed a bug (#3573) - :doc:`Email Library ` violated `RFC5321 `_ by sending 'localhost.localdomain' as a hostname.\n-  Fixed a bug (#3572) - ``CI_Security::_remove_evil_attributes()`` failed for large-sized inputs due to *pcre.backtrack_limit* and didn't properly match HTML tags.\n\nVersion 2.2.3\n=============\n\nRelease Date: July 14, 2015\n\n-  Security\n\n   - Removed a fallback to ``mysql_escape_string()`` in the 'mysql' database driver (``escape_str()`` method) when there's no active database connection.\n\nVersion 2.2.2\n=============\n\nRelease Date: April 15, 2015\n\n-  General Changes\n\n   - Added HTTP \"Host\" header character validation to prevent cache poisoning attacks when *base_url* auto-detection is used.\n   - Added *FSCommand* and *seekSegmentTime* to the \"evil attributes\" list in ``CI_Security::xss_clean()``.\n\nBug fixes for 2.2.2\n-------------------\n\n-  Fixed a bug (#3665) - ``CI_Security::entity_decode()`` triggered warnings under some circumstances.\n\nVersion 2.2.1\n=============\n\nRelease Date: January 22, 2015\n\n-  General Changes\n\n   - Improved security in ``xss_clean()``.\n   - Updated timezones in :doc:`Date Helper `.\n\nBug fixes for 2.2.1\n-------------------\n\n-  Fixed a bug (#3094) - Internal method ``CI_Input::_clean_input_data()`` breaks encrypted session cookies.\n-  Fixed a bug (#2268) - :doc:`Security Library ` method ``xss_clean()`` didn't properly match JavaScript events.\n-  Fixed a bug (#3309) - :doc:`Security Library ` method ``xss_clean()`` used an overly-invasive pattern to strip JS event handlers.\n-  Fixed a bug (#2771) - :doc:`Security Library ` method ``xss_clean()`` didn't take into account HTML5 entities.\n-  Fixed a bug (#73) - :doc:`Security Library ` method ``sanitize_filename()`` could be tricked by an XSS attack.\n-  Fixed a bug (#2681) - :doc:`Security Library ` method ``entity_decode()`` used the ``PREG_REPLACE_EVAL`` flag, which is deprecated since PHP 5.5.\n-  Fixed a bug (#3302) - Internal function ``get_config()`` triggered an E_NOTICE message on PHP 5.6.\n-  Fixed a bug (#2508) - :doc:`Config Library ` didn't properly detect if the current request is via HTTPS.\n-  Fixed a bug (#3314) - SQLSRV :doc:`Database driver `'s method ``count_all()`` didn't escape the supplied table name.\n-  Fixed a bug (#3404) - MySQLi :doc:`Database driver `'s method ``escape_str()`` had a wrong fallback to ``mysql_escape_string()`` when there was no active connection.\n-  Fixed a bug in the :doc:`Session Library ` where session ID regeneration occurred during AJAX requests.\n\nVersion 2.2.0\n=============\n\nRelease Date: June 2, 2014\n\n-  General Changes\n\n   - Security: **Encrypt Library** method ``xor_encode()`` has been removed. The Encrypt Class now requires the Mcrypt extension to be installed.\n   - Security: The :doc:`Session Library ` now uses HMAC authentication instead of a simple MD5 checksum.\n\nBug fixes for 2.2.0\n-------------------\n\n-  Fixed an edge case (#2583) in the :doc:`Email Library ` where `Suhosin ` blocked messages sent via ``mail()`` due to trailing newspaces in headers.\n-  Fixed a bug (#696) - make ``oci_execute()`` calls inside ``num_rows()`` non-committing, since they are only there to reset which row is next in line for oci_fetch calls and thus don't need to be committed.\n-  Fixed a bug (#2689) - :doc:`Database Force ` methods ``create_table()``, ``drop_table()`` and ``rename_table()`` produced broken SQL for tge 'sqlsrv' driver.\n-  Fixed a bug (#2427) - PDO :doc:`Database driver ` didn't properly check for query failures.\n-  Fixed a bug in the :doc:`Session Library ` where authentication was not performed for encrypted cookies.\n\nVersion 2.1.4\n=============\n\nRelease Date: July 8, 2013\n\n-  General Changes\n\n   - Improved security in ``xss_clean()``.\n\nBug fixes for 2.1.4\n-------------------\n\n-  Fixed a bug (#1936) - :doc:`Migration Library ` method ``latest()`` had a typo when retrieving language values.\n-  Fixed a bug (#2021) - :doc:`Migration Library ` configuration file was mistakenly using Windows style line feeds.\n-  Fixed a bug (#1273) - ``E_NOTICE`` being generated by :doc:`Query Builder `'s ``set_update_batch()`` method.\n-  Fixed a bug (#2337) - :doc:`Email Library ` method ``print_debugger()`` didn't apply ``htmlspecialchars()`` to headers.\n\nVersion 2.1.3\n=============\n\nRelease Date: October 8, 2012\n\n-  Core\n\n   - :doc:`Common function ` ``is_loaded()`` now returns a reference.\n\nBug fixes for 2.1.3\n-------------------\n\n-  Fixed a bug (#1543) - File-based :doc:`Caching ` method ``get_metadata()`` used a non-existent array key to look for the TTL value.\n-  Fixed a bug (#1314) - :doc:`Session Library ` method ``sess_destroy()`` didn't destroy the userdata array.\n-  Fixed a bug (#804) - :doc:`Profiler library ` was trying to handle objects as strings in some cases, resulting in *E_WARNING* messages being issued by ``htmlspecialchars()``.\n-  Fixed a bug (#1699) - :doc:`Migration Library ` ignored the ``$config['migration_path']`` setting.\n-  Fixed a bug (#227) - :doc:`Input Library ` allowed unconditional spoofing of HTTP clients' IP addresses through the *HTTP_CLIENT_IP* header.\n-  Fixed a bug (#907) - :doc:`Input Library ` ignored *HTTP_X_CLUSTER_CLIENT_IP* and *HTTP_X_CLIENT_IP* headers when checking for proxies.\n-  Fixed a bug (#940) - ``csrf_verify()`` used to set the CSRF cookie while processing a POST request with no actual POST data, which resulted in validating a request that should be considered invalid.\n-  Fixed a bug (#499) - :doc:`Security Library ` where a CSRF cookie was created even if ``$config['csrf_protection']`` is set to FALSE.\n-  Fixed a bug (#1715) - :doc:`Input Library ` triggered ``csrf_verify()`` on CLI requests.\n-  Fixed a bug (#751) - :doc:`Query Builder ` didn't properly handle cached field escaping overrides.\n-  Fixed a bug (#2004) - :doc:`Query Builder ` didn't properly merge cached calls with non-cache ones.\n\nVersion 2.1.2\n=============\n\nRelease Date: June 29, 2012\n\n-  General Changes\n\n   -  Improved security in ``xss_clean()``.\n\nVersion 2.1.1\n=============\n\nRelease Date: June 12, 2012\n\n-  General Changes\n\n   -  Fixed support for docx, xlsx files in mimes.php.\n\n-  Libraries\n\n   -  Further improved MIME type detection in the :doc:`File Uploading Library `.\n   -  Added support for IPv6 to the :doc:`Input Library `.\n   -  Added support for the IP format parameter to the :doc:`Form Validation Library `.\n\n-  Helpers\n\n   -  ``url_title()`` performance and output improved. You can now use any string as the word delimiter, but 'dash' and 'underscore' are still supported.\n\nBug fixes for 2.1.1\n-------------------\n\n-  Fixed a bug (#697) - A wrong array key was used in the :doc:`File Uploading Library ` to check for mime-types.\n-  Fixed a bug - ``form_open()`` compared $action against ``site_url()`` instead of ``base_url()``.\n-  Fixed a bug - ``CI_Upload::_file_mime_type()`` could've failed if ``mime_content_type()`` is used for the detection and returns FALSE.\n-  Fixed a bug (#538) - Windows paths were ignored when using the :doc:`Image Manipulation Library ` to create a new file.\n-  Fixed a bug - When database caching was enabled, $this->db->query() checked the cache before binding variables which resulted in cached queries never being found.\n-  Fixed a bug - CSRF cookie value was allowed to be any (non-empty) string before being written to the output, making code injection a risk.\n-  Fixed a bug (#726) - PDO put a 'dbname' argument in its connection string regardless of the database platform in use, which made it impossible to use SQLite.\n-  Fixed a bug - ``CI_DB_pdo_driver::num_rows()`` was not returning properly value with SELECT queries, cause it was relying on ``PDOStatement::rowCount()``.\n-  Fixed a bug (#1059) - ``CI_Image_lib::clear()`` was not correctly clearing all necessary object properties, namely width and height.\n\nVersion 2.1.0\n=============\n\nRelease Date: November 14, 2011\n\n-  General Changes\n\n   -  Callback validation rules can now accept parameters like any other\n      validation rule.\n   -  Added html_escape() to :doc:`Common\n      functions ` to escape HTML output\n      for preventing XSS.\n\n-  Helpers\n\n   -  Added increment_string() to :doc:`String\n      Helper ` to turn \"foo\" into \"foo-1\"\n      or \"foo-1\" into \"foo-2\".\n   -  Altered form helper - made action on form_open_multipart helper\n      function call optional. Fixes (#65)\n   -  url_title() will now trim extra dashes from beginning and end.\n   -  Improved speed of :doc:`String Helper `'s random_string() method\n\n-  Database\n\n   -  Added a `CUBRID `_ driver to the :doc:`Database\n      Driver `. Thanks to the CUBRID team for\n      supplying this patch.\n   -  Added a PDO driver to the :doc:`Database Driver `.\n   -  Typecast limit and offset in the :doc:`Database\n      Driver ` to integers to avoid possible\n      injection.\n   -  Added additional option 'none' for the optional third argument for\n      $this->db->like() in the :doc:`Database\n      Driver `.\n   -  Added $this->db->insert_batch() support to the OCI8 (Oracle) driver.\n   -  Added failover if the main connections in the config should fail\n\n-  Libraries\n\n   -  Changed ``$this->cart->insert()`` in the *Cart Library*\n      to return the Row ID if a single item was inserted successfully.\n   -  Added support to set an optional parameter in your callback rules\n      of validation using the :doc:`Form Validation\n      Library `.\n   -  Added a :doc:`Migration library ` to assist with applying\n      incremental updates to your database schema.\n   -  Driver children can be located in any package path.\n   -  Added max_filename_increment config setting for Upload library.\n   -  Added ``is_unique`` to the :doc:`Form Validation library `.\n   -  Added $config['use_page_numbers'] to the :doc:`Pagination library `, which enables real page numbers in the URI.\n   -  Added TLS and SSL Encryption for SMTP.\n\n-  Core\n\n   -  Changed private functions in CI_URI to protected so MY_URI can\n      override them.\n   -  Removed CI_CORE boolean constant from CodeIgniter.php (no longer Reactor and Core versions).\n\nBug fixes for 2.1.0\n-------------------\n\n-  Fixed #378 Robots identified as regular browsers by the User Agent\n   class.\n-  If a config class was loaded first then a library with the same name\n   is loaded, the config would be ignored.\n-  Fixed a bug (Reactor #19) where 1) the 404_override route was being\n   ignored in some cases, and 2) auto-loaded libraries were not\n   available to the 404_override controller when a controller existed\n   but the requested method did not.\n-  Fixed a bug (Reactor #89) where MySQL export would fail if the table\n   had hyphens or other non alphanumeric/underscore characters.\n-  Fixed a bug (#105) that stopped query errors from being logged unless database debugging was enabled\n-  Fixed a bug (#160) - Removed unneeded array copy in the file cache\n   driver.\n-  Fixed a bug (#150) - field_data() now correctly returns column\n   length.\n-  Fixed a bug (#8) - load_class() now looks for core classes in\n   APPPATH first, allowing them to be replaced.\n-  Fixed a bug (#24) - ODBC database driver called incorrect parent in __construct().\n-  Fixed a bug (#85) - OCI8 (Oracle) database escape_str() function did not escape correct.\n-  Fixed a bug (#344) - Using schema found in :doc:`Saving Session Data to a Database `, system would throw error \"user_data does not have a default value\" when deleting then creating a session.\n-  Fixed a bug (#112) - OCI8 (Oracle) driver didn't pass the configured database character set when connecting.\n-  Fixed a bug (#182) - OCI8 (Oracle) driver used to re-execute the statement whenever num_rows() is called.\n-  Fixed a bug (#82) - WHERE clause field names in the DB update_string() method were not escaped, resulting in failed queries in some cases.\n-  Fixed a bug (#89) - Fix a variable type mismatch in DB display_error() where an array is expected, but a string could be set instead.\n-  Fixed a bug (#467) - Suppress warnings generated from get_magic_quotes_gpc() (deprecated in PHP 5.4)\n-  Fixed a bug (#484) - First time _csrf_set_hash() is called, hash is never set to the cookie (in Security.php).\n-  Fixed a bug (#60) - Added _file_mime_type() method to the :doc:`File Uploading Library ` in order to fix a possible MIME-type injection.\n-  Fixed a bug (#537) - Support for all wav type in browser.\n-  Fixed a bug (#576) - Using ini_get() function to detect if apc is enabled or not.\n-  Fixed invalid date time format in :doc:`Date helper ` and :doc:`XMLRPC library `.\n-  Fixed a bug (#200) - MySQL queries would be malformed after calling db->count_all() then db->get().\n\nVersion 2.0.3\n=============\n\nRelease Date: August 20, 2011\n\n-  Security\n\n   -  An improvement was made to the MySQL and MySQLi drivers to prevent\n      exposing a potential vector for SQL injection on sites using\n      multi-byte character sets in the database client connection.\n      An incompatibility in PHP versions < 5.2.3 and MySQL < 5.0.7 with\n      *mysql_set_charset()* creates a situation where using multi-byte\n      character sets on these environments may potentially expose a SQL\n      injection attack vector. Latin-1, UTF-8, and other \"low ASCII\"\n      character sets are unaffected on all environments.\n\n      If you are running or considering running a multi-byte character\n      set for your database connection, please pay close attention to\n      the server environment you are deploying on to ensure you are not\n      vulnerable.\n\n-  General Changes\n\n   -  Fixed a bug where there was a misspelling within a code comment in\n      the index.php file.\n   -  Added Session Class userdata to the output profiler. Additionally,\n      added a show/hide toggle on HTTP Headers, Session Data and Config\n      Variables.\n   -  Removed internal usage of the EXT constant.\n   -  Visual updates to the welcome_message view file and default error\n      templates. Thanks to `danijelb `_\n      for the pull request.\n   -  Added insert_batch() function to the PostgreSQL database driver.\n      Thanks to epallerols for the patch.\n   -  Added \"application/x-csv\" to mimes.php.\n   -  Fixed a bug where :doc:`Email library `\n      attachments with a \".\" in the name would using invalid MIME-types.\n\n-  Helpers\n\n   -  Added an optional third parameter to heading() which allows adding\n      html attributes to the rendered heading tag.\n   -  form_open() now only adds a hidden (Cross-site Reference Forgery)\n      protection field when the form's action is internal and is set to\n      the post method. (Reactor #165)\n   -  Re-worked plural() and singular() functions in the :doc:`Inflector\n      helper ` to support considerably\n      more words.\n\n-  Libraries\n\n   -  Altered Session to use a longer match against the user_agent\n      string. See upgrade notes if using database sessions.\n   -  Added $this->db->set_dbprefix() to the :doc:`Database\n      Driver `.\n   -  Changed ``$this->cart->insert()`` in the *Cart Library*\n      to return the Row ID if a single item was inserted successfully.\n   -  Added $this->load->get_var() to the :doc:`Loader\n      library ` to retrieve global vars set with\n      $this->load->view() and $this->load->vars().\n   -  Changed $this->db->having() to insert quotes using escape() rather\n      than escape_str().\n\nBug fixes for 2.0.3\n-------------------\n\n-  Added ENVIRONMENT to reserved constants. (Reactor #196)\n-  Changed server check to ensure SCRIPT_NAME is defined. (Reactor #57)\n-  Removed APPPATH.'third_party' from the packages autoloader to negate\n   needless file stats if no packages exist or if the developer does not\n   load any other packages by default.\n-  Fixed a bug (Reactor #231) where Sessions Library database table\n   example SQL did not contain an index on last_activity. See :doc:`Upgrade\n   Notes `.\n-  Fixed a bug (Reactor #229) where the Sessions Library example SQL in\n   the documentation contained incorrect SQL.\n-  Fixed a bug (Core #340) where when passing in the second parameter to\n   $this->db->select(), column names in subsequent queries would not be\n   properly escaped.\n-  Fixed issue #199 - Attributes passed as string does not include a\n   space between it and the opening tag.\n-  Fixed a bug where the method ``$this->cart->total_items()`` from\n   *Cart Library* now returns the sum of the quantity\n   of all items in the cart instead of your total count.\n-  Fixed a bug where not setting 'null' when adding fields in db_forge\n   for mysql and mysqli drivers would default to NULL instead of NOT\n   NULL as the docs suggest.\n-  Fixed a bug where using $this->db->select_max(),\n   $this->db->select_min(), etc could throw notices. Thanks to w43l for\n   the patch.\n-  Replace checks for STDIN with php_sapi_name() == 'cli' which on the\n   whole is more reliable. This should get parameters in crontab\n   working.\n\nVersion 2.0.2\n=============\n\nRelease Date: April 7, 2011\nHg Tag: v2.0.2\n\n-  General changes\n\n   -  The :doc:`Security library <./libraries/security>` was moved to\n      the core and is now loaded automatically. Please remove your\n      loading calls.\n   -  The CI_SHA class is now deprecated. All supported versions of PHP\n      provide a sha1() function.\n   -  constants.php will now be loaded from the environment folder if\n      available.\n   -  Added language key error logging\n   -  Made Environment Support optional. Comment out or delete the\n      constant to stop environment checks.\n   -  Added Environment Support for Hooks.\n   -  Added CI\\_ Prefix to the :doc:`Cache driver `.\n   -  Added :doc:`CLI usage <./general/cli>` documentation.\n\n-  Helpers\n\n   -  Removed the previously deprecated ``dohash()`` from the :doc:`Security\n      helper <./helpers/security_helper>`; use ``do_hash()`` instead.\n   -  Changed the 'plural' function so that it doesn't ruin the\n      captalization of your string. It also take into consideration\n      acronyms which are all caps.\n\n-  Database\n\n   -  $this->db->count_all_results() will now return an integer\n      instead of a string.\n\nBug fixes for 2.0.2\n-------------------\n\n-  Fixed a bug (Reactor #145) where the Output Library had\n   parse_exec_vars set to protected.\n-  Fixed a bug (Reactor #80) where is_really_writable would create an\n   empty file when on Windows or with safe_mode enabled.\n-  Fixed various bugs with User Guide.\n-  Added is_cli_request() method to documentation for :doc:`Input\n   class `.\n-  Added form_validation_lang entries for decimal, less_than and\n   greater_than.\n-  Fixed issue #153 Escape Str Bug in MSSQL driver.\n-  Fixed issue #172 Google Chrome 11 posts incorrectly when action is empty.\n\nVersion 2.0.1\n=============\n\nRelease Date: March 15, 2011\nHg Tag: v2.0.1\n\n-  General changes\n\n   -  Added $config['cookie_secure'] to the config file to allow\n      requiring a secure (HTTPS) in order to set cookies.\n   -  Added the constant CI_CORE to help differentiate between Core:\n      TRUE and Reactor: FALSE.\n   -  Added an ENVIRONMENT constant in index.php, which affects PHP\n      error reporting settings, and optionally, which configuration\n      files are loaded (see below). Read more on the :doc:`Handling\n      Environments ` page.\n   -  Added support for\n      :ref:`environment-specific `\n      configuration files.\n\n-  Libraries\n\n   -  Added decimal, less_than and greater_than rules to the :doc:`Form\n      validation Class `.\n   -  :doc:`Input Class ` methods post() and get()\n      will now return a full array if the first argument is not\n      provided.\n   -  Secure cookies can now be made with the set_cookie() helper and\n      :doc:`Input Class ` method.\n   -  Added set_content_type() to :doc:`Output\n      Class ` to set the output Content-Type\n      HTTP header based on a MIME Type or a config/mimes.php array key.\n   -  :doc:`Output Class ` will now support method\n      chaining.\n\n-  Helpers\n\n   -  Changed the logic for form_open() in :doc:`Form\n      helper `. If no value is passed it will\n      submit to the current URL.\n\nBug fixes for 2.0.1\n-------------------\n\n-  CLI requests can now be run from any folder, not just when CD'ed next\n   to index.php.\n-  Fixed issue #41: Added audio/mp3 mime type to mp3.\n-  Fixed a bug (Core #329) where the file caching driver referenced the\n   incorrect cache directory.\n-  Fixed a bug (Reactor #69) where the SHA1 library was named\n   incorrectly.\n\n.. _2.0.0-changelog:\n\nVersion 2.0.0\n=============\n\nRelease Date: January 28, 2011\nHg Tag: v2.0.0\n\n-  General changes\n\n   -  PHP 4 support is removed. CodeIgniter now requires PHP 5.1.6.\n   -  Scaffolding, having been deprecated for a number of versions, has\n      been removed.\n   -  Plugins have been removed, in favor of Helpers. The CAPTCHA plugin\n      has been converted to a Helper and\n      :doc:`documented <./helpers/captcha_helper>`. The JavaScript\n      calendar plugin was removed due to the ready availability of great\n      JavaScript calendars, particularly with jQuery.\n   -  Added new special Library type:\n      :doc:`Drivers <./general/drivers>`.\n   -  Added full query-string support. See the config file for details.\n   -  Moved the application folder outside of the system folder.\n   -  Moved system/cache and system/logs directories to the application\n      directory.\n   -  Added routing overrides to the main index.php file, enabling the\n      normal routing to be overridden on a per \"index\" file basis.\n   -  Added the ability to set config values (or override config values)\n      directly from data set in the main index.php file. This allows a\n      single application to be used with multiple front controllers,\n      each having its own config values.\n   -  Added $config['directory_trigger'] to the config file so that a\n      controller sub-directory can be specified when running _GET\n      strings instead of URI segments.\n   -  Added ability to set \"Package\" paths - specific paths where the\n      Loader and Config classes should try to look first for a requested\n      file. This allows distribution of sub-applications with their own\n      libraries, models, config files, etc. in a single \"package\"\n      directory. See the :doc:`Loader class `\n      documentation for more details.\n   -  In-development code is now hosted at BitBucket .\n   -  Removed the deprecated Validation Class.\n   -  Added CI\\_ Prefix to all core classes.\n   -  Package paths can now be set in application/config/autoload.php.\n   -  :doc:`Upload library ` file_name can\n      now be set without an extension, the extension will be taken from\n      the uploaded file instead of the given name.\n   -  In :doc:`Database Forge ` the name can be omitted\n      from $this->dbforge->modify_column()'s 2nd param if you aren't\n      changing the name.\n   -  $config['base_url'] is now empty by default and will guess what\n      it should be.\n   -  Enabled full Command Line Interface compatibility with\n      config['uri_protocol'] = 'CLI';.\n\n-  Libraries\n\n   -  Added a :doc:`Cache driver ` with APC,\n      memcached, and file-based support.\n   -  Added $prefix, $suffix and $first_url properties to :doc:`Pagination\n      library <./libraries/pagination>`.\n   -  Added the ability to suppress first, previous, next, last, and\n      page links by setting their values to FALSE in the :doc:`Pagination\n      library <./libraries/pagination>`.\n   -  Added :doc:`Security library <./libraries/security>`, which now\n      contains the xss_clean function, filename_security function and\n      other security related functions.\n   -  Added CSRF (Cross-site Reference Forgery) protection to the\n      :doc:`Security library <./libraries/security>`.\n   -  Added $parse_exec_vars property to Output library.\n   -  Added ability to enable / disable individual sections of the\n      :doc:`Profiler `\n   -  Added a wildcard option $config['allowed_types'] = '\\*' to the\n      :doc:`File Uploading Class <./libraries/file_uploading>`.\n   -  Added an 'object' config variable to the XML-RPC Server library so\n      that one can specify the object to look for requested methods,\n      instead of assuming it is in the $CI superobject.\n   -  Added \"is_object\" into the list of unit tests capable of being\n      run.\n   -  Table library will generate an empty cell with a blank string, or\n      NULL value.\n   -  Added ability to set tag attributes for individual cells in the\n      Table library\n   -  Added a parse_string() method to the :doc:`Parser\n      Class `.\n   -  Added HTTP headers and Config information to the\n      :doc:`Profiler ` output.\n   -  Added Chrome and Flock to the list of detectable browsers by\n      browser() in the :doc:`User Agent Class `.\n   -  The :doc:`Unit Test Class ` now has an\n      optional \"notes\" field available to it, and allows for discrete\n      display of test result items using\n      $this->unit->set_test_items().\n   -  Added a $xss_clean class variable to the XMLRPC library, enabling\n      control over the use of the Security library's xss_clean()\n      method.\n   -  Added a download() method to the :doc:`FTP\n      library `\n   -  Changed do_xss_clean() to return FALSE if the uploaded file\n      fails XSS checks.\n   -  Added stripslashes() and trim()ing of double quotes from $_FILES\n      type value to standardize input in Upload library.\n   -  Added a second parameter (boolean) to\n      $this->zip->read_dir('/path/to/directory', FALSE) to remove the\n      preceding trail of empty folders when creating a Zip archive. This\n      example would contain a zip with \"directory\" and all of its\n      contents.\n   -  Added ability in the Image Library to handle PNG transparency for\n      resize operations when using the GD lib.\n   -  Modified the Session class to prevent use if no encryption key is\n      set in the config file.\n   -  Added a new config item to the Session class\n      sess_expire_on_close to allow sessions to auto-expire when the\n      browser window is closed.\n   -  Improved performance of the Encryption library on servers where\n      Mcrypt is available.\n   -  Changed the default encryption mode in the Encryption library to\n      CBC.\n   -  Added an encode_from_legacy() method to provide a way to\n      transition encrypted data from CodeIgniter 1.x to CodeIgniter 2.x.\n      Please see the :doc:`upgrade\n      instructions <./installation/upgrade_200>` for details.\n   -  Altered Form_Validation library to allow for method chaining on\n      set_rules(), set_message() and set_error_delimiters()\n      functions.\n   -  Altered Email Library to allow for method chaining.\n   -  Added request_headers(), get_request_header() and\n      is_ajax_request() to the input class.\n   -  Altered :doc:`User agent library ` so that\n      is_browser(), is_mobile() and is_robot() can optionally check\n      for a specific browser or mobile device.\n   -  Altered :doc:`Input library ` so that post() and\n      get() will return all POST and GET items (respectively) if there\n      are no parameters passed in.\n\n-  Database\n\n   -  :doc:`database configuration <./database/configuration>`.\n   -  Added autoinit value to :doc:`database\n      configuration <./database/configuration>`.\n   -  Added stricton value to :doc:`database\n      configuration <./database/configuration>`.\n   -  Added database_exists() to the :doc:`Database Utilities\n      Class `.\n   -  Semantic change to db->version() function to allow a list of\n      exceptions for databases with functions to return version string\n      instead of specially formed SQL queries. Currently this list only\n      includes Oracle and SQLite.\n   -  Fixed a bug where driver specific table identifier protection\n      could lead to malformed queries in the field_data() functions.\n   -  Fixed a bug where an undefined class variable was referenced in\n      database drivers.\n   -  Modified the database errors to show the filename and line number\n      of the problematic query.\n   -  Removed the following deprecated functions: orwhere, orlike,\n      groupby, orhaving, orderby, getwhere.\n   -  Removed deprecated _drop_database() and _create_database()\n      functions from the db utility drivers.\n   -  Improved dbforge create_table() function for the Postgres driver.\n\n-  Helpers\n\n   -  Added convert_accented_characters() function to :doc:`text\n      helper <./helpers/text_helper>`.\n   -  Added accept-charset to the list of inserted attributes of\n      form_open() in the :doc:`Form Helper `.\n   -  Deprecated the ``dohash()`` function in favour of ``do_hash()`` for\n      naming consistency.\n   -  Non-backwards compatible change made to get_dir_file_info() in\n      the :doc:`File Helper `. No longer recurses\n      by default so as to encourage responsible use (this function can\n      cause server performance issues when used without caution).\n   -  Modified the second parameter of directory_map() in the\n      :doc:`Directory Helper ` to accept an\n      integer to specify recursion depth.\n   -  Modified delete_files() in the :doc:`File\n      Helper ` to return FALSE on failure.\n   -  Added an optional second parameter to byte_format() in the\n      :doc:`Number Helper ` to allow for decimal\n      precision.\n   -  Added alpha, and sha1 string types to random_string() in the\n      :doc:`String Helper `.\n   -  Modified prep_url() so as to not prepend \\http:// if the supplied\n      string already has a scheme.\n   -  Modified get_file_info in the file helper, changing filectime()\n      to filemtime() for dates.\n   -  Modified ``smiley_js()`` to add optional third parameter to return\n      only the javascript with no script tags.\n   -  The img() function of the :doc:`HTML\n      helper <./helpers/html_helper>` will now generate an empty\n      string as an alt attribute if one is not provided.\n   -  If CSRF is enabled in the application config file, form_open()\n      will automatically insert it as a hidden field.\n   -  Added sanitize_filename() into the :doc:`Security\n      helper <./helpers/security_helper>`.\n   -  Added ellipsize() to the :doc:`Text\n      Helper <./helpers/text_helper>`\n   -  Added elements() to the :doc:`Array\n      Helper <./helpers/array_helper>`\n\n-  Other Changes\n\n   -  Added an optional second parameter to show_404() to disable\n      logging.\n   -  Updated loader to automatically apply the sub-class prefix as an\n      option when loading classes. Class names can be prefixed with the\n      standard \"CI\\_\" or the same prefix as the subclass prefix, or no\n      prefix at all.\n   -  Increased randomness with is_really_writable() to avoid file\n      collisions when hundreds or thousands of requests occur at once.\n   -  Switched some DIR_WRITE_MODE constant uses to FILE_WRITE_MODE\n      where files and not directories are being operated on.\n   -  get_mime_by_extension() is now case insensitive.\n   -  Added \"default\" to the list :doc:`Reserved\n      Names `.\n   -  Added 'application/x-msdownload' for .exe files and\n      'application/x-gzip-compressed' for .tgz files to\n      config/mimes.php.\n   -  Updated the output library to no longer compress output or send\n      content-length headers if the server runs with\n      zlib.output_compression enabled.\n   -  Eliminated a call to is_really_writable() on each request unless\n      it is really needed (Output caching)\n   -  Documented append_output() in the :doc:`Output\n      Class `.\n   -  Documented a second argument in the decode() function for the\n      **Encrypt Class**.\n   -  Documented db->close().\n   -  Updated the router to support a default route with any number of\n      segments.\n   -  Moved _remove_invisible_characters() function from the\n      :doc:`Security Library ` to :doc:`common\n      functions. `\n   -  Added audio/mpeg3 as a valid mime type for MP3.\n\nBug fixes for 2.0.0\n-------------------\n\n-  Fixed a bug where you could not change the User-Agent when sending\n   email.\n-  Fixed a bug where the Output class would send incorrect cached output\n   for controllers implementing their own _output() method.\n-  Fixed a bug where a failed query would not have a saved query\n   execution time causing errors in the Profiler\n-  Fixed a bug that was writing log entries when multiple identical\n   helpers and plugins were loaded.\n-  Fixed assorted user guide typos or examples (#10693, #8951, #7825,\n   #8660, #7883, #6771, #10656).\n-  Fixed a language key in the profiler: \"profiler_no_memory_usage\"\n   to \"profiler_no_memory\".\n-  Fixed an error in the Zip library that didn't allow downloading on\n   PHP 4 servers.\n-  Fixed a bug in the Form Validation library where fields passed as\n   rule parameters were not being translated (#9132)\n-  Modified inflector helper to properly pluralize words that end in\n   'ch' or 'sh'\n-  Fixed a bug in xss_clean() that was not allowing hyphens in query\n   strings of submitted URLs.\n-  Fixed bugs in get_dir_file_info() and get_file_info() in the\n   File Helper with recursion, and file paths on Windows.\n-  Fixed a bug where Active Record override parameter would not let you\n   disable Active Record if it was enabled in your database config file.\n-  Fixed a bug in reduce_double_slashes() in the String Helper to\n   properly remove duplicate leading slashes (#7585)\n-  Fixed a bug in values_parsing() of the XML-RPC library which\n   prevented NULL variables typed as 'string' from being handled\n   properly.\n-  Fixed a bug were form_open_multipart() didn't accept string\n   attribute arguments (#10930).\n-  Fixed a bug (#10470) where get_mime_by_extension() was case\n   sensitive.\n-  Fixed a bug where some error messages for the SQLite and Oracle\n   drivers would not display.\n-  Fixed a bug where files created with the Zip Library would result in\n   file creation dates of 1980.\n-  Fixed a bug in the Session library that would result in PHP error\n   when attempting to store values with objects.\n-  Fixed a bug where extending the Controller class would result in a\n   fatal PHP error.\n-  Fixed a PHP Strict Standards Error in the index.php file.\n-  Fixed a bug where getimagesize() was being needlessly checked on\n   non-image files in is_allowed_type().\n-  Fixed a bug in the Encryption library where an empty key was not\n   triggering an error.\n-  Fixed a bug in the Email library where CC and BCC recipients were not\n   reset when using the clear() method (#109).\n-  Fixed a bug in the URL Helper where prep_url() could cause a PHP\n   error on PHP versions < 5.1.2.\n-  Added a log message in core/output if the cache directory config\n   value was not found.\n-  Fixed a bug where multiple libraries could not be loaded by passing\n   an array to load->library()\n-  Fixed a bug in the html helper where too much white space was\n   rendered between the src and alt tags in the img() function.\n-  Fixed a bug in the profilers _compile_queries() function.\n-  Fixed a bug in the date helper where the DATE_ISO8601 variable was\n   returning an incorrectly formatted date string.\n\nVersion 1.7.2\n=============\n\nRelease Date: September 11, 2009\nHg Tag: v1.7.2\n\n-  Libraries\n\n   -  Added a new *Cart Class*.\n   -  Added the ability to pass $config['file_name'] for the :doc:`File\n      Uploading Class ` and rename the\n      uploaded file.\n   -  Changed order of listed user-agents so Safari would more\n      accurately report itself. (#6844)\n\n-  Database\n\n   -  Switched from using gettype() in escape() to is\\_* methods, since\n      future PHP versions might change its output.\n   -  Updated all database drivers to handle arrays in escape_str()\n   -  Added escape_like_str() method for escaping strings to be used\n      in LIKE conditions\n   -  Updated Active Record to utilize the new LIKE escaping mechanism.\n   -  Added reconnect() method to DB drivers to try to keep alive /\n      reestablish a connection after a long idle.\n   -  Modified MSSQL driver to use mssql_get_last_message() for error\n      messages.\n\n-  Helpers\n\n   -  Added form_multiselect() to the :doc:`Form\n      helper `.\n   -  Modified form_hidden() in the :doc:`Form\n      helper ` to accept multi-dimensional\n      arrays.\n   -  Modified ``form_prep()`` in the :doc:`Form\n      helper ` to keep track of prepped\n      fields to avoid multiple prep/mutation from subsequent calls which\n      can occur when using Form Validation and form helper functions to\n      output form fields.\n   -  Modified directory_map() in the :doc:`Directory\n      helper ` to allow the inclusion of\n      hidden files, and to return FALSE on failure to read directory.\n   -  Modified the *Smiley helper* to work\n      with multiple fields and insert the smiley at the last known\n      cursor position.\n\n-  General\n\n   -  Compatible with PHP 5.3.0.\n   -  Modified :doc:`show_error() ` to allow sending\n      of HTTP server response codes.\n   -  Modified :doc:`show_404() ` to send 404 status\n      code, removing non-CGI compatible header() statement from\n      error_404.php template.\n   -  Added set_status_header() to the :doc:`Common\n      functions ` to allow use when the\n      Output class is unavailable.\n   -  Added is_php() to :doc:`Common\n      functions ` to facilitate PHP\n      version comparisons.\n   -  Added 2 CodeIgniter \"cheatsheets\" (thanks to DesignFellow.com for\n      this contribution).\n\nBug fixes for 1.7.2\n-------------------\n\n-  Fixed assorted user guide typos or examples (#6743, #7214, #7516,\n   #7287, #7852, #8224, #8324, #8349).\n-  Fixed a bug in the Form Validation library where multiple callbacks\n   weren't working (#6110)\n-  doctype helper default value was missing a \"1\".\n-  Fixed a bug in the language class when outputting an error for an\n   unfound file.\n-  Fixed a bug in the Calendar library where the shortname was output\n   for \"May\".\n-  Fixed a bug with ORIG_PATH_INFO that was allowing URIs of just a\n   slash through.\n-  Fixed a fatal error in the Oracle and ODBC drivers (#6752)\n-  Fixed a bug where xml_from_result() was checking for a nonexistent\n   method.\n-  Fixed a bug where Database Forge's add_column and modify_column\n   were not looping through when sent multiple fields.\n-  Fixed a bug where the File Helper was using '/' instead of the\n   DIRECTORY_SEPARATOR constant.\n-  Fixed a bug to prevent PHP errors when attempting to use sendmail on\n   servers that have manually disabled the PHP popen() function.\n-  Fixed a bug that would cause PHP errors in XML-RPC data if the PHP\n   data type did not match the specified XML-RPC type.\n-  Fixed a bug in the XML-RPC class with parsing dateTime.iso8601 data\n   types.\n-  Fixed a case sensitive string replacement in xss_clean()\n-  Fixed a bug in form_textarea() where form data was not prepped\n   correctly.\n-  Fixed a bug in ``form_prep()`` causing it to not preserve entities in\n   the user's original input when called back into a form element\n-  Fixed a bug in _protect_identifiers() where the swap prefix\n   ($swap_pre) was not being observed.\n-  Fixed a bug where the 400 status header sent with the 'disallowed URI\n   characters' was not compatible with CGI environments.\n-  Fixed a bug in the typography class where heading tags could have\n   paragraph tags inserted when using auto_typography().\n\nVersion 1.7.1\n=============\n\nRelease Date: February 10, 2009\nHg Tag: 1.7.1\n\n-  Libraries\n\n   -  Fixed an arbitrary script execution security flaw (#6068) in the\n      Form Validation library (thanks to hkk)\n   -  Changed default current page indicator in the Pagination library\n      to use  instead of \n   -  A \"HTTP/1.1 400 Bad Request\" header is now sent when disallowed\n      characters are encountered.\n   -  Added , , , and  to the Typography parser's\n      inline elements.\n   -  Added more accurate error reporting for the Email library when\n      using sendmail.\n   -  Removed a strict type check from the rotate() function of the\n      :doc:`Image Manipulation Class `.\n   -  Added enhanced error checking in file saving in the Image library\n      when using the GD lib.\n   -  Added an additional newline between multipart email headers and\n      the MIME message text for better compatibility with a variety of\n      MUAs.\n   -  Made modest improvements to efficiency and accuracy of\n      explode_name() in the Image lib.\n\n-  Database\n\n   -  Added where_in to the list of expected arguments received by\n      delete().\n\n-  Helpers\n\n   -  Added the ability to have optgroups in form_dropdown() within the\n      :doc:`form helper `.\n   -  Added a doctype() function to the :doc:`HTML\n      helper `.\n   -  Added ability to force lowercase for url_title() in the :doc:`URL\n      helper `.\n   -  Changed the default \"type\" of form_button() to \"button\" from\n      \"submit\" in the :doc:`form helper `.\n   -  Changed redirect() in the URL helper to allow redirections to URLs\n      outside of the CI site.\n   -  Updated get_cookie() to try to fetch the cookie using the global\n      cookie prefix if the requested cookie name doesn't exist.\n\n-  Other Changes\n\n   -  Improved security in xss_clean() to help prevent attacks\n      targeting Internet Explorer.\n   -  Added 'application/msexcel' to config/mimes.php for .xls files.\n   -  Added 'proxy_ips' config item to whitelist reverse proxy servers\n      from which to trust the HTTP_X_FORWARDED_FOR header to to\n      determine the visitor's IP address.\n   -  Improved accuracy of Upload::is_allowed_filetype() for images\n      (#6715)\n\nBug fixes for 1.7.1\n-------------------\n\n-  Database\n\n   -  Fixed a bug when doing 'random' on order_by() (#5706).\n   -  Fixed a bug where adding a primary key through Forge could fail\n      (#5731).\n   -  Fixed a bug when using DB cache on multiple databases (#5737).\n   -  Fixed a bug where TRUNCATE was not considered a \"write\" query\n      (#6619).\n   -  Fixed a bug where csv_from_result() was checking for a\n      nonexistent method.\n   -  Fixed a bug _protect_identifiers() where it was improperly\n      removing all pipe symbols from items\n\n-  Fixed assorted user guide typos or examples (#5998, #6093, #6259,\n   #6339, #6432, #6521).\n-  Fixed a bug in the MySQLi driver when no port is specified\n-  Fixed a bug (#5702), in which the field label was not being fetched\n   properly, when \"matching\" one field to another.\n-  Fixed a bug in which identifers were not being escaped properly when\n   reserved characters were used.\n-  Fixed a bug with the regular expression used to protect submitted\n   paragraph tags in auto typography.\n-  Fixed a bug where double dashes within tag attributes were being\n   converted to em dash entities.\n-  Fixed a bug where double spaces within tag attributes were being\n   converted to non-breaking space entities.\n-  Fixed some accuracy issues with curly quotes in\n   Typography::format_characters()\n-  Changed a few docblock comments to reflect actual return values.\n-  Fixed a bug with high ascii characters in subject and from email\n   headers.\n-  Fixed a bug in xss_clean() where whitespace following a validated\n   character entity would not be preserved.\n-  Fixed a bug where HTML comments and 
     tags were being parsed in\n   Typography::auto_typography().\n-  Fixed a bug with non-breaking space cleanup in\n   Typography::auto_typography().\n-  Fixed a bug in database escaping where a compound statement (ie:\n   SUM()) wasn't handled correctly with database prefixes.\n-  Fixed a bug when an opening quote is preceded by a paragraph tag and\n   immediately followed by another tag.\n-  Fixed a bug in the Text Helper affecting some locales where\n   word_censor() would not work on words beginning or ending with an\n   accented character.\n-  Fixed a bug in the Text Helper character limiter where the provided\n   limit intersects the last word of the string.\n-  Fixed a bug (#6342) with plural() in the Inflection helper with words\n   ending in \"y\".\n-  Fixed bug (#6517) where Routed URI segments returned by\n   URI::rsegment() method were incorrect for the default controller.\n-  Fixed a bug (#6706) in the Security Helper where xss_clean() was\n   using a deprecated second argument.\n-  Fixed a bug in the URL helper url_title() function where trailing\n   periods were allowed at the end of a URL.\n-  Fixed a bug (#6669) in the Email class when CRLF's are used for the\n   newline character with headers when used with the \"mail\" protocol.\n-  Fixed a bug (#6500) where URI::A_filter_uri() was exit()ing an\n   error instead of using show_error().\n-  Fixed a bug (#6592) in the File Helper where get_dir_file_info()\n   where recursion was not occurring properly.\n-  Tweaked Typography::auto_typography() for some edge-cases.\n\nVersion 1.7\n===========\n\nRelease Date: October 23, 2008\nHg Tag: 1.7.0\n\n-  Libraries\n\n   -  Added a new :doc:`Form Validation\n      Class `. It simplifies setting\n      rules and field names, supports arrays as field names, allows\n      groups of validation rules to be saved in a config file, and adds\n      some helper functions for use in view files. **Please note that\n      the old Validation class is now deprecated**. We will leave it in\n      the library folder for some time so that existing applications\n      that use it will not break, but you are encouraged to migrate to\n      the new version.\n   -  Updated the :doc:`Sessions class ` so that\n      any custom data being saved gets stored to a database rather than\n      the session cookie (assuming you are using a database to store\n      session data), permitting much more data to be saved.\n   -  Added the ability to store libraries in subdirectories within\n      either the main \"libraries\" or the local application \"libraries\"\n      folder. Please see the :doc:`Loader class ` for\n      more info.\n   -  Added the ability to assign library objects to your own variable\n      names when you use $this->load->library(). Please see the :doc:`Loader\n      class ` for more info.\n   -  Added controller class/method info to :doc:`Profiler\n      class ` and support for multiple database\n      connections.\n   -  Improved the \"auto typography\" feature and moved it out of the\n      helper into its own :doc:`Typography\n      Class `.\n   -  Improved performance and accuracy of xss_clean(), including\n      reduction of false positives on image/file tests.\n   -  Improved :doc:`Parser class <./libraries/parser>` to allow\n      multiple calls to the parse() function. The output of each is\n      appended in the output.\n   -  Added max_filename option to set a file name length limit in the\n      :doc:`File Upload Class `.\n   -  Added set_status_header() function to :doc:`Output\n      class `.\n   -  Modified :doc:`Pagination ` class to only\n      output the \"First\" link when the link for page one would not be\n      shown.\n   -  Added support for mb_strlen in the :doc:`Form\n      Validation ` class so that\n      multi-byte languages will calculate string lengths properly.\n\n-  Database\n\n   -  Improved Active Record class to allow full path column and table\n      names: hostname.database.table.column. Also improved the alias\n      handling.\n   -  Improved how table and column names are escaped and prefixed. It\n      now honors full path names when adding prefixes and escaping.\n   -  Added Active Record caching feature to \"update\" and \"delete\"\n      functions.\n   -  Added removal of non-printing control characters in escape_str()\n      of DB drivers that do not have native PHP escaping mechanisms\n      (mssql, oci8, odbc), to avoid potential SQL errors, and possible\n      sources of SQL injection.\n   -  Added port support to MySQL, MySQLi, and MS SQL database drivers.\n   -  Added driver name variable in each DB driver, based on bug report\n      #4436.\n\n-  Helpers\n\n   -  Added several new \"setting\" functions to the :doc:`Form\n      helper ` that allow POST data to be\n      retrieved and set into forms. These are intended to be used on\n      their own, or with the new :doc:`Form Validation\n      Class `.\n   -  Added current_url() and uri_segments() to :doc:`URL\n      helper `.\n   -  Altered auto_link() in the :doc:`URL\n      helper ` so that email addresses with\n      \"+\" included will be linked.\n   -  Added meta() function to :doc:`HTML\n      helper `.\n   -  Improved accuracy of calculations in :doc:`Number\n      helper `.\n   -  Removed added newlines (\"\\\\n\") from most form and html helper\n      functions.\n   -  Tightened up validation in the :doc:`Date\n      helper ` function human_to_unix(),\n      and eliminated the POSIX regex.\n   -  Updated :doc:`Date helper ` to match the\n      world's current time zones and offsets.\n   -  Modified url_title() in the :doc:`URL\n      helper ` to remove characters and digits\n      that are part of character entities, to allow dashes, underscores,\n      and periods regardless of the $separator, and to allow uppercase\n      characters.\n   -  Added support for arbitrary attributes in anchor_popup() of the\n      :doc:`URL helper `.\n\n-  Other Changes\n\n   -  Added :doc:`PHP Style Guide <./general/styleguide>` to docs.\n   -  Added sanitization in xss_clean() for a deprecated HTML tag that\n      could be abused in user input in Internet Explorer.\n   -  Added a few openxml document mime types, and an additional mobile\n      agent to mimes.php and user_agents.php respectively.\n   -  Added a file lock check during caching, before trying to write to\n      the file.\n   -  Modified Cookie key cleaning to unset a few troublesome key names\n      that can be present in certain environments, preventing CI from\n      halting execution.\n   -  Changed the output of the profiler to use style attribute rather\n      than clear, and added the id \"codeigniter_profiler\" to the\n      container div.\n\nBug fixes for 1.7.0\n-------------------\n\n-  Fixed bug in xss_clean() that could remove some desirable tag\n   attributes.\n-  Fixed assorted user guide typos or examples (#4807, #4812, #4840,\n   #4862, #4864, #4899, #4930, #5006, #5071, #5158, #5229, #5254,\n   #5351).\n-  Fixed an edit from 1.6.3 that made the $robots array in\n   user_agents.php go poof.\n-  Fixed a bug in the :doc:`Email library ` with\n   quoted-printable encoding improperly encoding space and tab\n   characters.\n-  Modified XSS sanitization to no longer add semicolons after &[single\n   letter], such as in M&M's, B&B, etc.\n-  Modified XSS sanitization to no longer strip XHTML image tags of\n   closing slashes.\n-  Fixed a bug in the Session class when database sessions are used\n   where upon session update all userdata would be errantly written to\n   the session cookie.\n-  Fixed a bug (#4536) in backups with the MySQL driver where some\n   legacy code was causing certain characters to be double escaped.\n-  Fixed a routing bug (#4661) that occurred when the default route\n   pointed to a subfolder.\n-  Fixed the spelling of \"Dhaka\" in the timezone_menu() function of the\n   :doc:`Date helper. `\n-  Fixed the spelling of \"raspberry\" in config/smileys.php.\n-  Fixed incorrect parenthesis in form_open() function (#5135).\n-  Fixed a bug that was ignoring case when comparing controller methods\n   (#4560).\n-  Fixed a bug (#4615) that was not setting SMTP authorization settings\n   when using the initialize function.\n-  Fixed a bug in highlight_code() in the :doc:`Text\n   helper ` that would leave a stray \n   in certain cases.\n-  Fixed Oracle bug (#3306) that was preventing multiple queries in one\n   action.\n-  Fixed ODBC bug that was ignoring connection params due to its use of\n   a constructor.\n-  Fixed a DB driver bug with num_rows() that would cause an error with\n   the Oracle driver.\n-  Fixed MS SQL bug (#4915). Added brackets around database name in MS\n   SQL driver when selecting the database, in the event that reserved\n   characters are used in the name.\n-  Fixed a DB caching bug (4718) in which the path was incorrect when no\n   URI segments were present.\n-  Fixed Image_lib class bug #4562. A path was not defined for NetPBM.\n-  Fixed Image_lib class bug #4532. When cropping an image with\n   identical height/width settings on output, a copy is made.\n-  Fixed DB_driver bug (4900), in which a database error was not being\n   logged correctly.\n-  Fixed DB backup bug in which field names were not being escaped.\n-  Fixed a DB Active Record caching bug in which multiple calls to\n   cached data were not being honored.\n-  Fixed a bug in the Session class that was disallowing slashes in the\n   serialized array.\n-  Fixed a Form Validation bug in which the \"isset\" error message was\n   being trigged by the \"required\" rule.\n-  Fixed a spelling error in a Loader error message.\n-  Fixed a bug (5050) with IP validation with empty segments.\n-  Fixed a bug in which the parser was being greedy if multiple\n   identical sets of tags were encountered.\n\nVersion 1.6.3\n=============\n\nRelease Date: June 26, 2008\nHg Tag: v1.6.3\n\nVersion 1.6.3 is a security and maintenance release and is recommended\nfor all users.\n\n-  Database\n\n   -  Modified MySQL/MySQLi Forge class to give explicit names to keys\n   -  Added ability to set multiple column non-primary keys to the\n      :doc:`Forge class `\n   -  Added ability to set additional database config values in :doc:`DSN\n      connections ` via the query string.\n\n-  Libraries\n\n   -  Set the mime type check in the :doc:`Upload\n      class ` to reference the global\n      mimes variable.\n   -  Added support for query strings to the :doc:`Pagination\n      class `, automatically detected or\n      explicitly declared.\n   -  Added get_post() to the :doc:`Input class `.\n   -  Documented get() in the :doc:`Input class `.\n   -  Added the ability to automatically output language items as form\n      labels in the :doc:`Language class `.\n\n-  Helpers\n\n   -  Added a :doc:`Language helper `.\n   -  Added a :doc:`Number helper `.\n   -  :doc:`Form helper ` refactored to allow\n      form_open() and form_fieldset() to accept arrays or strings as\n      arguments.\n\n-  Other changes\n\n   -  Improved security in xss_clean().\n   -  Removed an unused Router reference in _display_cache().\n   -  Added ability to :doc:`use xss_clean() to test\n      images ` for XSS, useful for upload\n      security.\n   -  Considerably expanded list of mobile user-agents in\n      config/user_agents.php.\n   -  Charset information in the userguide has been moved above title\n      for internationalization purposes (#4614).\n   -  Added \"Using Associative Arrays In a Request Parameter\" example to\n      the :doc:`XMLRPC userguide page `.\n   -  Removed maxlength and size as automatically added attributes of\n      form_input() in the :doc:`form helper `.\n   -  Documented the language file use of byte_format() in the :doc:`number\n      helper `.\n\nBug fixes for 1.6.3\n-------------------\n\n-  Added a language key for valid_emails in validation_lang.php.\n-  Amended fixes for bug (#3419) with parsing DSN database connections.\n-  Moved the _has_operator() function (#4535) into DB_driver from\n   DB_active_rec.\n-  Fixed a syntax error in upload_lang.php.\n-  Fixed a bug (#4542) with a regular expression in the Image library.\n-  Fixed a bug (#4561) where orhaving() wasn't properly passing values.\n-  Removed some unused variables from the code (#4563).\n-  Fixed a bug where having() was not adding an = into the statement\n   (#4568).\n-  Fixed assorted user guide typos or examples (#4574, #4706).\n-  Added quoted-printable headers to Email class when the multi-part\n   override is used.\n-  Fixed a double opening 
     tag in the index pages of each system\n   directory.\n\nVersion 1.6.2\n=============\n\nRelease Date: May 13, 2008\nHg Tag: 1.6.2\n\n-  Active Record\n\n   -  Added the ability to prevent escaping in having() clauses.\n   -  Added rename_table() into :doc:`DBForge <./database/forge>`.\n   -  Fixed a bug that wasn't allowing escaping to be turned off if the\n      value of a query was NULL.\n   -  DB Forge is now assigned to any models that exist after loading\n      (#3457).\n\n-  Database\n\n   -  Added :doc:`Strict Mode <./database/transactions>` to database\n      transactions.\n   -  Escape behaviour in where() clauses has changed; values in those\n      with the \"FALSE\" argument are no longer escaped (ie: quoted).\n\n-  Config\n\n   -  Added 'application/vnd.ms-powerpoint' to list of mime types.\n   -  Added 'audio/mpg' to list of mime types.\n   -  Added new user-modifiable file constants.php containing file mode\n      and fopen constants.\n   -  Added the ability to set CRLF settings via config in the\n      :doc:`Email ` class.\n\n-  Libraries\n\n   -  Added increased security for filename handling in the Upload\n      library.\n   -  Added increased security for sessions for client-side data\n      tampering.\n   -  The MySQLi forge class is now in sync with MySQL forge.\n   -  Added the ability to set CRLF settings via config in the\n      :doc:`Email ` class.\n   -  :doc:`Unit Testing ` results are now\n      colour coded, and a change was made to the default template of\n      results.\n   -  Added a valid_emails rule to the Validation class.\n   -  The :doc:`Zip class ` now exits within download().\n   -  The :doc:`Zip class ` has undergone a substantial\n      re-write for speed and clarity (thanks stanleyxu for the hard work\n      and code contribution in bug report #3425!)\n\n-  Helpers\n\n   -  Added a Compatibility\n      Helper for using some common\n      PHP 5 functions safely in applications that might run on PHP 4\n      servers (thanks Seppo for the hard work and code contribution!)\n   -  Added form_button() in the :doc:`Form\n      helper `.\n   -  Changed the radio() and checkbox() functions to default to not\n      checked by default.\n   -  Added the ability to include an optional HTTP Response Code in the\n      redirect() function of the :doc:`URL\n      Helper `.\n   -  Modified img() in the :doc:`HTML Helper ` to\n      remove an unneeded space (#4208).\n   -  Modified anchor() in the :doc:`URL helper `\n      to no longer add a default title= attribute (#4209).\n   -  The :doc:`Download helper ` now exits\n      within force_download().\n   -  Added get_dir_file_info(), get_file_info(), and\n      get_mime_by_extension() to the :doc:`File\n      Helper `.\n   -  Added symbolic_permissions() and octal_permissions() to the\n      :doc:`File helper `.\n\n-  Plugins\n\n   -  Modified captcha generation to first look for the function\n      imagecreatetruecolor, and fallback to imagecreate if it isn't\n      available (#4226).\n\n-  Other Changes\n\n   -  Added ability for :doc:`xss_clean() ` to accept\n      arrays.\n   -  Removed closing PHP tags from all PHP files to avoid accidental\n      output and potential 'cannot modify headers' errors.\n   -  Removed \"scripts\" from the auto-load search path. Scripts were\n      deprecated in Version 1.4.1 (September 21, 2006). If you still\n      need to use them for legacy reasons, they must now be manually\n      loaded in each Controller.\n   -  Added a :doc:`Reserved Names ` page to\n      the userguide, and migrated reserved controller names into it.\n   -  Added a :doc:`Common Functions ` page\n      to the userguide for globally available functions.\n   -  Improved security and performance of xss_clean().\n\nBugfixes for 1.6.2\n------------------\n\n-  Fixed a bug where SET queries were not being handled as \"write\"\n   queries.\n-  Fixed a bug (#3191) with ORIG_PATH_INFO URI parsing.\n-  Fixed a bug in DB Forge, when inserting an id field (#3456).\n-  Fixed a bug in the table library that could cause identically\n   constructed rows to be dropped (#3459).\n-  Fixed DB Driver and MySQLi result driver checking for resources\n   instead of objects (#3461).\n-  Fixed an AR_caching error where it wasn't tracking table aliases\n   (#3463).\n-  Fixed a bug in AR compiling, where select statements with arguments\n   got incorrectly escaped (#3478).\n-  Fixed an incorrect documentation of $this->load->language (#3520).\n-  Fixed bugs (#3523, #4350) in get_filenames() with recursion and\n   problems with Windows when $include_path is used.\n-  Fixed a bug (#4153) in the XML-RPC class preventing dateTime.iso8601\n   from being used.\n-  Fixed an AR bug with or_where_not_in() (#4171).\n-  Fixed a bug with :doc:`xss_clean() ` that would\n   add semicolons to GET URI variable strings.\n-  Fixed a bug (#4206) in the Directory Helper where the directory\n   resource was not being closed, and minor improvements.\n-  Fixed a bug in the FTP library where delete_dir() was not working\n   recursively (#4215).\n-  Fixed a Validation bug when set_rules() is used with a non-array\n   field name and rule (#4220).\n-  Fixed a bug (#4223) where DB caching would not work for returned DB\n   objects or multiple DB connections.\n-  Fixed a bug in the Upload library that might output the same error\n   twice (#4390).\n-  Fixed an AR bug when joining with a table alias and table prefix\n   (#4400).\n-  Fixed a bug in the DB class testing the $params argument.\n-  Fixed a bug in the Table library where the integer 0 in cell data\n   would be displayed as a blank cell.\n-  Fixed a bug in link_tag() of the :doc:`URL\n   helper ` where a key was passed instead of\n   a value.\n-  Fixed a bug in DB_result::row() that prevented it from returning\n   individual fields with MySQL NULL values.\n-  Fixed a bug where SMTP emails were not having dot transformation\n   performed on lines that begin with a dot.\n-  Fixed a bug in display_error() in the DB driver that was\n   instantiating new Language and Exception objects, and not using the\n   error heading.\n-  Fixed a bug (#4413) where a URI containing slashes only e.g.\n   '\\http://example.com/index.php?//' would result in PHP errors\n-  Fixed an array to string conversion error in the Validation library\n   (#4425)\n-  Fixed bug (#4451, #4299, #4339) where failed transactions will not\n   rollback when debug mode is enabled.\n-  Fixed a bug (#4506) with overlay_watermark() in the Image library\n   preventing support for PNG-24s with alpha transparency\n-  Fixed assorted user guide typos (#3453, #4364, #4379, #4399, #4408,\n   #4412, #4448, #4488).\n\nVersion 1.6.1\n=============\n\nRelease Date: February 12, 2008\nHg Tag: 1.6.1\n\n-  Active Record\n\n   -  Added :ref:`Active Record\n      Caching `.\n   -  Made Active Record fully database-prefix aware.\n\n-  Database drivers\n\n   -  Added support for setting client character set and collation for\n      MySQLi.\n\n-  Core Changes\n\n   -  Modified xss_clean() to be more intelligent with its handling of\n      URL encoded strings.\n   -  Added $_SERVER, $_FILES, $_ENV, and $_SESSION to sanitization\n      of globals.\n   -  Added a :doc:`Path Helper <./helpers/path_helper>`.\n   -  Simplified _reindex_segments() in the URI class.\n   -  Escaped the '-' in the default 'permitted_uri_chars' config\n      item, to prevent errors if developers just try to add additional\n      characters to the end of the default expression.\n   -  Modified method calling to controllers to show a 404 when a\n      private or protected method is accessed via a URL.\n   -  Modified framework initiated 404s to log the controller and method\n      for invalid requests.\n\n-  Helpers\n\n   -  Modified get_filenames() in the File Helper to return FALSE if\n      the $source_dir is not readable.\n\nBugfixes for 1.6.1\n------------------\n\n-  Deprecated is_numeric as a validation rule. Use of numeric and\n   integer are preferred.\n-  Fixed bug (#3379) in DBForge with SQLite for table creation.\n-  Made Active Record fully database prefix aware (#3384).\n-  Fixed a bug where DBForge was outputting invalid SQL in Postgres by\n   adding brackets around the tables in FROM.\n-  Changed the behaviour of Active Record's update() to make the WHERE\n   clause optional (#3395).\n-  Fixed a bug (#3396) where certain POST variables would cause a PHP\n   warning.\n-  Fixed a bug in query binding (#3402).\n-  Changed order of SQL keywords in the Profiler $highlight array so OR\n   would not be highlighted before ORDER BY.\n-  Fixed a bug (#3404) where the MySQLi driver was testing if\n   $this->conn_id was a resource instead of an object.\n-  Fixed a bug (#3419) connecting to a database via a DSN string.\n-  Fixed a bug (#3445) where the routed segment array was not re-indexed\n   to begin with 1 when the default controller is used.\n-  Fixed assorted user guide typos.\n\nVersion 1.6.0\n=============\n\nRelease Date: January 30, 2008\n\n-  DBForge\n\n   -  Added :doc:`DBForge <./database/forge>` to the database tools.\n   -  Moved create_database() and drop_database() into\n      :doc:`DBForge <./database/forge>`.\n   -  Added add_field(), add_key(), create_table(), drop_table(),\n      add_column(), drop_column(), modify_column() into\n      :doc:`DBForge <./database/forge>`.\n\n-  Active Record\n\n   -  Added protect_identifiers() in :doc:`Active\n      Record <./database/query_builder>`.\n   -  All AR queries are backticked if appropriate to the database.\n   -  Added where_in(), or_where_in(), where_not_in(),\n      or_where_not_in(), not_like() and or_not_like() to :doc:`Active\n      Record <./database/query_builder>`.\n   -  Added support for limit() into update() and delete() statements in\n      :doc:`Active Record <./database/query_builder>`.\n   -  Added empty_table() and truncate_table() to :doc:`Active\n      Record <./database/query_builder>`.\n   -  Added the ability to pass an array of tables to the delete()\n      statement in :doc:`Active Record <./database/query_builder>`.\n   -  Added count_all_results() function to :doc:`Active\n      Record <./database/query_builder>`.\n   -  Added select_max(), select_min(), select_avg() and\n      select_sum() to :doc:`Active Record <./database/query_builder>`.\n   -  Added the ability to use aliases with joins in :doc:`Active\n      Record <./database/query_builder>`.\n   -  Added a third parameter to Active Record's like() clause to\n      control where the wildcard goes.\n   -  Added a third parameter to set() in :doc:`Active\n      Record <./database/query_builder>` that withholds escaping\n      data.\n   -  Changed the behaviour of variables submitted to the where() clause\n      with no values to auto set \"IS NULL\"\n\n-  Other Database Related\n\n   -  MySQL driver now requires MySQL 4.1+\n   -  Added $this->DB->save_queries variable to DB driver, enabling\n      queries to get saved or not. Previously they were always saved.\n   -  Added $this->db->dbprefix() to manually add database prefixes.\n   -  Added 'random' as an order_by() option , and removed \"rand()\" as\n      a listed option as it was MySQL only.\n   -  Added a check for NULL fields in the MySQL database backup\n      utility.\n   -  Added \"constrain_by_prefix\" parameter to db->list_table()\n      function. If set to TRUE it will limit the result to only table\n      names with the current prefix.\n   -  Deprecated from Active Record; getwhere() for get_where();\n      groupby() for group_by(); havingor() for having_or(); orderby()\n      for order_by; orwhere() for or_where(); and orlike() for\n      or_like().\n   -  Modified csv_from_result() to output CSV data more in the spirit\n      of basic rules of RFC 4180.\n   -  Added 'char_set' and 'dbcollat' database configuration settings,\n      to explicitly set the client communication properly.\n   -  Removed 'active_r' configuration setting and replaced with a\n      global $active_record setting, which is more in harmony with the\n      global nature of the behavior (#1834).\n\n-  Core changes\n\n   -  Added ability to load multiple views, whose content will be\n      appended to the output in the order loaded.\n   -  Added the ability to :doc:`auto-load <./general/autoloader>`\n      :doc:`Models <./general/models>`.\n   -  Reorganized the URI and Routes classes for better clarity.\n   -  Added Compat.php to allow function overrides for older versions of\n      PHP or PHP environments missing certain extensions / libraries\n   -  Added memory usage, GET, URI string data, and individual query\n      execution time to Profiler output.\n   -  Deprecated Scaffolding.\n   -  Added is_really_writable() to Common.php to provide a\n      cross-platform reliable method of testing file/folder writability.\n\n-  Libraries\n\n   -  Changed the load protocol of Models to allow for extension.\n   -  Strengthened the Encryption library to help protect against man in\n      the middle attacks when MCRYPT_MODE_CBC mode is used.\n   -  Added Flashdata variables, session_id regeneration and\n      configurable session update times to the :doc:`Session\n      class. <./libraries/sessions>`\n   -  Removed 'last_visit' from the Session class.\n   -  Added a language entry for valid_ip validation error.\n   -  Modified ``prep_for_form()`` in the Validation class to accept\n      arrays, adding support for POST array validation (via callbacks\n      only)\n   -  Added an \"integer\" rule into the Validation library.\n   -  Added valid_base64() to the Validation library.\n   -  Documented clear() in the :doc:`Image\n      Processing <./libraries/image_lib>` library.\n   -  Changed the behaviour of custom callbacks so that they no longer\n      trigger the \"required\" rule.\n   -  Modified Upload class $_FILES error messages to be more precise.\n   -  Moved the safe mode and auth checks for the Email library into the\n      constructor.\n   -  Modified variable names in _ci_load() method of Loader class to\n      avoid conflicts with view variables.\n   -  Added a few additional mime type variations for CSV.\n   -  Enabled the 'system' methods for the XML-RPC Server library,\n      except for 'system.multicall' which is still disabled.\n\n-  Helpers & Plugins\n\n   -  Added link_tag() to the :doc:`HTML\n      helper. <./helpers/html_helper>`\n   -  Added img() to the :doc:`HTML helper. <./helpers/html_helper>`\n   -  Added ability to :doc:`\"extend\" Helpers <./general/helpers>`.\n   -  Added an *Email Helper* into core helpers.\n   -  Added strip_quotes() function to :doc:`string\n      helper <./helpers/string_helper>`.\n   -  Added reduce_multiples() function to :doc:`string\n      helper <./helpers/string_helper>`.\n   -  Added quotes_to_entities() function to :doc:`string\n      helper <./helpers/string_helper>`.\n   -  Added form_fieldset(), form_fieldset_close(), form_label(),\n      and form_reset() function to :doc:`form\n      helper <./helpers/form_helper>`.\n   -  Added support for external urls in form_open().\n   -  Removed support for db_backup in MySQLi due to incompatible\n      functions.\n   -  Javascript Calendar plugin now uses the months and days from the\n      calendar language file, instead of hard-coded values,\n      internationalizing it.\n\n-  Documentation Changes\n\n   -  Added Writing Documentation section\n      for the community to use in writing their own documentation.\n   -  Added titles to all user manual pages.\n   -  Added attributes into  of userguide for valid html.\n   -  Added :doc:`Zip Encoding Class `\n      to the table of contents of the userguide.\n   -  Moved part of the userguide menu javascript to an external file.\n   -  Documented distinct() in :doc:`Active\n      Record <./database/query_builder>`.\n   -  Documented the timezones() function in the :doc:`Date\n      Helper <./helpers/date_helper>`.\n   -  Documented unset_userdata in the :doc:`Session\n      class <./libraries/sessions>`.\n   -  Documented 2 config options to the :doc:`Database\n      configuration <./database/configuration>` page.\n\nBug fixes for Version 1.6.0\n---------------------------\n\n-  Fixed a bug (#1813) preventing using $CI->db in the same application\n   with returned database objects.\n-  Fixed a bug (#1842) where the $this->uri->rsegments array would not\n   include the 'index' method if routed to the controller without an\n   implicit method.\n-  Fixed a bug (#1872) where word_limiter() was not retaining\n   whitespace.\n-  Fixed a bug (#1890) in csv_from_result() where content that\n   included the delimiter would break the file.\n-  Fixed a bug (#2542)in the clean_email() method of the Email class to\n   allow for non-numeric / non-sequential array keys.\n-  Fixed a bug (#2545) in _html_entity_decode_callback() when\n   'global_xss_filtering' is enabled.\n-  Fixed a bug (#2668) in the :doc:`parser class <./libraries/parser>`\n   where numeric data was ignored.\n-  Fixed a bug (#2679) where the \"previous\" pagination link would get\n   drawn on the first page.\n-  Fixed a bug (#2702) in _object_to_array that broke some types of\n   inserts and updates.\n-  Fixed a bug (#2732) in the SQLite driver for PHP 4.\n-  Fixed a bug (#2754) in Pagination to scan for non-positive\n   num_links.\n-  Fixed a bug (#2762) in the :doc:`Session\n   library <./libraries/sessions>` where user agent matching would\n   fail on user agents ending with a space.\n-  Fixed a bug (#2784) $field_names[] vs $Ffield_names[] in postgres\n   and sqlite drivers.\n-  Fixed a bug (#2810) in the typography helper causing extraneous\n   paragraph tags when string contains tags.\n-  Fixed a bug (#2849) where arguments passed to a subfolder controller\n   method would be incorrectly shifted, dropping the 3rd segment value.\n-  Fixed a bug (#2858) which referenced a wrong variable in the Image\n   class.\n-  Fixed a bug (#2875)when loading plugin files as _plugin. and not\n   _pi.\n-  Fixed a bug (#2912) in get_filenames() in the :doc:`File\n   Helper ` where the array wasn't cleared\n   after each call.\n-  Fixed a bug (#2974) in highlight_phrase() that caused an error with\n   slashes.\n-  Fixed a bug (#3003) in the Encryption Library to support modes other\n   than MCRYPT_MODE_ECB\n-  Fixed a bug (#3015) in the :doc:`User Agent\n   library <./libraries/user_agent>` where more than 2 languages\n   where not reported with languages().\n-  Fixed a bug (#3017) in the :doc:`Email <./libraries/email>` library\n   where some timezones were calculated incorrectly.\n-  Fixed a bug (#3024) in which master_dim wasn't getting reset by\n   clear() in the Image library.\n-  Fixed a bug (#3156) in Text Helper highlight_code() causing PHP tags\n   to be handled incorrectly.\n-  Fixed a bug (#3166) that prevented num_rows from working in Oracle.\n-  Fixed a bug (#3175) preventing certain libraries from working\n   properly when autoloaded in PHP 4.\n-  Fixed a bug (#3267) in the Typography Helper where unordered list was\n   listed \"un.\n-  Fixed a bug (#3268) where the Router could leave '/' as the path.\n-  Fixed a bug (#3279) where the Email class was sending the wrong\n   Content-Transfer-Encoding for some character sets.\n-  Fixed a bug (#3284) where the rsegment array would not be set\n   properly if the requested URI contained more segments than the routed\n   URI.\n-  Removed extraneous load of $CFG in _display_cache() of the Output\n   class (#3285).\n-  Removed an extraneous call to loading models (#3286).\n-  Fixed a bug (#3310) with sanitization of globals in the Input class\n   that could unset CI's global variables.\n-  Fixed a bug (#3314) which would cause the top level path to be\n   deleted in delete_files() of the File helper.\n-  Fixed a bug (#3328) where the smiley helper might return an undefined\n   variable.\n-  Fixed a bug (#3330) in the FTP class where a comparison wasn't\n   getting made.\n-  Removed an unused parameter from Profiler (#3332).\n-  Fixed a bug in database driver where num_rows property wasn't\n   getting updated.\n-  Fixed a bug in the :doc:`upload\n   library <./libraries/file_uploading>` when allowed_files\n   wasn't defined.\n-  Fixed a bug in word_wrap() of the Text Helper that incorrectly\n   referenced an object.\n-  Fixed a bug in Validation where valid_ip() wasn't called properly.\n-  Fixed a bug in Validation where individual error messages for\n   checkboxes wasn't supported.\n-  Fixed a bug in captcha calling an invalid PHP function.\n-  Fixed a bug in the cookie helper \"set_cookie\" function. It was not\n   honoring the config settings.\n-  Fixed a bug that was making validation callbacks required even when\n   not set as such.\n-  Fixed a bug in the XML-RPC library so if a type is specified, a more\n   intelligent decision is made as to the default type.\n-  Fixed an example of comma-separated emails in the email library\n   documentation.\n-  Fixed an example in the Calendar library for Showing Next/Previous\n   Month Links.\n-  Fixed a typo in the database language file.\n-  Fixed a typo in the image language file \"suppor\" to \"support\".\n-  Fixed an example for XML RPC.\n-  Fixed an example of accept_charset() in the :doc:`User Agent\n   Library <./libraries/user_agent>`.\n-  Fixed a typo in the docblock comments that had CodeIgniter spelled\n   CodeIgnitor.\n-  Fixed a typo in the :doc:`String Helper <./helpers/string_helper>`\n   (uniquid changed to uniqid).\n-  Fixed typos in the email Language class\n   (email_attachment_unredable, email_filed_smtp_login), and FTP\n   Class (ftp_unable_to_remame).\n-  Added a stripslashes() into the Upload Library.\n-  Fixed a series of grammatical and spelling errors in the language\n   files.\n-  Fixed assorted user guide typos.\n\nVersion 1.5.4\n=============\n\nRelease Date: July 12, 2007\n\n-  Added :doc:`custom Language files <./libraries/language>` to the\n   :doc:`autoload <./general/autoloader>` options.\n-  Added stripslashes() to the _clean_input_data() function in the\n   :doc:`Input class <./libraries/input>` when magic quotes is on so\n   that data will always be un-slashed within the framework.\n-  Added array to string into the :doc:`profiler `.\n-  Added some additional mime types in application/config/mimes.php.\n-  Added filename_security() method to :doc:`Input\n   library <./libraries/input>`.\n-  Added some additional arguments to the :doc:`Inflection\n   helper <./helpers/inflector_helper>` singular() to compensate\n   for words ending in \"s\". Also added a force parameter to pluralize().\n-  Added $config['charset'] to the config file. Default value is\n   'UTF-8', used in some string handling functions.\n-  Fixed MSSQL insert_id().\n-  Fixed a logic error in the DB trans_status() function. It was\n   incorrectly returning TRUE on failure and FALSE on success.\n-  Fixed a bug that was allowing multiple load attempts on extended\n   classes.\n-  Fixed a bug in the bootstrap file that was incorrectly attempting to\n   discern the full server path even when it was explicity set by the\n   user.\n-  Fixed a bug in the escape_str() function in the MySQL driver.\n-  Fixed a typo in the :doc:`Calendar library <./libraries/calendar>`\n-  Fixed a typo in rpcs.php library\n-  Fixed a bug in the :doc:`Zip library <./libraries/zip>`, providing\n   PC Zip file compatibility with Mac OS X\n-  Fixed a bug in router that was ignoring the scaffolding route for\n   optimization\n-  Fixed an IP validation bug.\n-  Fixed a bug in display of POST keys in the\n   :doc:`Profiler <./general/profiling>` output\n-  Fixed a bug in display of queries with characters that would be\n   interpreted as HTML in the :doc:`Profiler <./general/profiling>`\n   output\n-  Fixed a bug in display of Email class print debugger with characters\n   that would be interpreted as HTML in the debugging output\n-  Fixed a bug in the Content-Transfer-Encoding of HTML emails with the\n   quoted-printable MIME type\n-  Fixed a bug where one could unset certain PHP superglobals by setting\n   them via GET or POST data\n-  Fixed an undefined function error in the insert_id() function of the\n   PostgreSQL driver\n-  Fixed various doc typos.\n-  Documented two functions from the :doc:`String\n   helper <./helpers/string_helper>` that were missing from the\n   user guide: ``trim_slashes()`` and ``reduce_double_slashes()``.\n-  Docs now validate to XHTML 1 transitional\n-  Updated the XSS Filtering to take into account the IE expression()\n   ability and improved certain deletions to prevent possible exploits\n-  Modified the Router so that when Query Strings are Enabled, the\n   controller trigger and function trigger values are sanitized for\n   filename include security.\n-  Modified the is_image() method in the Upload library to take into\n   account Windows IE 6/7 eccentricities when dealing with MIMEs\n-  Modified XSS Cleaning routine to be more performance friendly and\n   compatible with PHP 5.2's new PCRE backtrack and recursion limits.\n-  Modified the :doc:`URL Helper <./helpers/url_helper>` to type cast\n   the $title as a string in case a numeric value is supplied\n-  Modified Form Helper form_dropdown() to type cast the keys and\n   values of the options array as strings, allowing numeric values to be\n   properly set as 'selected'\n-  Deprecated the use if is_numeric() in various places since it allows\n   periods. Due to compatibility problems with ctype_digit(), making it\n   unreliable in some installations, the following regular expression\n   was used instead: preg_match(\"/[^0-9]/\", $n)\n-  Deprecated: APPVER has been deprecated and replaced with CI_VERSION\n   for clarity.\n\nVersion 1.5.3\n=============\n\nRelease Date: April 15, 2007\n\n-  Added array to string into the profiler\n-  Code Igniter references updated to CodeIgniter\n-  pMachine references updated to EllisLab\n-  Fixed a bug in the ``repeater()`` function of :doc:`string\n   helper <./helpers/string_helper>`.\n-  Fixed a bug in ODBC driver\n-  Fixed a bug in result_array() that was returning an empty array when\n   no result is produced.\n-  Fixed a bug in the redirect function of the :doc:`url\n   helper <./helpers/url_helper>`.\n-  Fixed an undefined variable in Loader\n-  Fixed a version bug in the Postgres driver\n-  Fixed a bug in the textarea function of the form helper for use with\n   strings\n-  Fixed doc typos.\n\nVersion 1.5.2\n=============\n\nRelease Date: February 13, 2007\n\n-  Added subversion information\n   to the :doc:`downloads ` page.\n-  Added support for captions in the :doc:`Table\n   Library <./libraries/table>`\n-  Fixed a bug in the\n   :doc:`download_helper ` that was causing\n   Internet Explorer to load rather than download\n-  Fixed a bug in the Active Record Join function that was not taking\n   table prefixes into consideration.\n-  Removed unescaped variables in error messages of Input and Router\n   classes\n-  Fixed a bug in the Loader that was causing errors on Libraries loaded\n   twice. A debug message is now silently made in the log.\n-  Fixed a bug in the :doc:`form helper ` that\n   gave textarea a value attribute\n-  Fixed a bug in the :doc:`Image Library ` that\n   was ignoring resizing the same size image\n-  Fixed some doc typos.\n\nVersion 1.5.1\n=============\n\nRelease Date: November 23, 2006\n\n-  Added support for submitting arrays of libraries in the\n   $this->load->library function.\n-  Added support for naming custom library files in lower or uppercase.\n-  Fixed a bug related to output buffering.\n-  Fixed a bug in the active record class that was not resetting query\n   data after a completed query.\n-  Fixed a bug that was suppressing errors in controllers.\n-  Fixed a problem that can cause a loop to occur when the config file\n   is missing.\n-  Fixed a bug that occurred when multiple models were loaded with the\n   third parameter set to TRUE.\n-  Fixed an oversight that was not unsetting globals properly in the\n   input sanitize function.\n-  Fixed some bugs in the Oracle DB driver.\n-  Fixed an incorrectly named variable in the MySQLi result driver.\n-  Fixed some doc typos.\n\nVersion 1.5.0.1\n===============\n\nRelease Date: October 31, 2006\n\n-  Fixed a problem in which duplicate attempts to load helpers and\n   classes were not being stopped.\n-  Fixed a bug in the word_wrap() helper function.\n-  Fixed an invalid color Hex number in the Profiler class.\n-  Fixed a corrupted image in the user guide.\n\nVersion 1.5.0\n=============\n\nRelease Date: October 30, 2006\n\n-  Added :doc:`DB utility class <./database/utilities>`, permitting DB\n   backups, CVS or XML files from DB results, and various other\n   functions.\n-  Added :doc:`Database Caching Class <./database/caching>`.\n-  Added :doc:`transaction support <./database/transactions>` to the\n   database classes.\n-  Added :doc:`Profiler Class <./general/profiling>` which generates a\n   report of Benchmark execution times, queries, and POST data at the\n   bottom of your pages.\n-  Added :doc:`User Agent Library <./libraries/user_agent>` which\n   allows browsers, robots, and mobile devises to be identified.\n-  Added :doc:`HTML Table Class <./libraries/table>` , enabling tables\n   to be generated from arrays or database results.\n-  Added :doc:`Zip Encoding Library <./libraries/zip>`.\n-  Added :doc:`FTP Library <./libraries/ftp>`.\n-  Added the ability to :doc:`extend\n   libraries <./general/creating_libraries>` and :doc:`extend core\n   classes <./general/core_classes>`, in addition to being able to\n   replace them.\n-  Added support for storing :doc:`models within\n   sub-folders <./general/models>`.\n-  Added :doc:`Download Helper <./helpers/download_helper>`.\n-  Added :doc:`simple_query() <./database/queries>` function to the\n   database classes\n-  Added ``standard_date()`` function function to the :doc:`Date Helper `.\n-  Added :doc:`$query->free_result() <./database/results>` to database\n   class.\n-  Added :doc:`$query->list_fields() <./database/metadata>` function to\n   database class\n-  Added :doc:`$this->db->platform() <./database/helpers>` function\n-  Added new :doc:`File Helper <./helpers/file_helper>`:\n   get_filenames()\n-  Added new helper: *Smiley Helper*\n-  Added support for 
       and 
         lists in the :doc:`HTML\n   Helper <./helpers/html_helper>`\n-  Added the ability to rewrite :doc:`short\n   tags <./general/alternative_php>` on-the-fly, converting them\n   to standard PHP statements, for those servers that do not support\n   short tags. This allows the cleaner syntax to be used regardless of\n   whether it's supported by the server.\n-  Added the ability to :doc:`rename or relocate the \"application\"\n   folder <./general/managing_apps>`.\n-  Added more thorough initialization in the upload class so that all\n   class variables are reset.\n-  Added \"is_numeric\" to validation, which uses the native PHP\n   is_numeric function.\n-  Improved the URI handler to make it more reliable when the\n   $config['uri_protocol'] item is set to AUTO.\n-  Moved most of the functions in the Controller class into the Loader\n   class, allowing fewer reserved function names for controllers when\n   running under PHP 5.\n-  Updated the DB Result class to return an empty array when\n   $query->result() doesn't produce a result.\n-  Updated the input->cookie() and input->post() functions in :doc:`Input\n   Class <./libraries/input>` to permit arrays contained cookies\n   that are arrays to be run through the XSS filter.\n-  Documented three functions from the Validation\n   class that were missing from the user\n   guide: set_select(), set_radio(), and set_checkbox().\n-  Fixed a bug in the Email class related to SMTP Helo data.\n-  Fixed a bug in the word wrapping helper and function in the email\n   class.\n-  Fixed a bug in the validation class.\n-  Fixed a bug in the typography helper that was incorrectly wrapping\n   block level elements in paragraph tags.\n-  Fixed a problem in the ``form_prep()`` function that was double encoding\n   entities.\n-  Fixed a bug that affects some versions of PHP when output buffering\n   is nested.\n-  Fixed a bug that caused CI to stop working when the PHP magic\n   __get() or __set() functions were used within models or\n   controllers.\n-  Fixed a pagination bug that was permitting negative values in the\n   URL.\n-  Fixed an oversight in which the Loader class was not allowed to be\n   extended.\n-  Changed _get_config() to get_config() since the function is not a\n   private one.\n-  **Deprecated \"init\" folder**. Initialization happens automatically\n   now. :doc:`Please see documentation <./general/creating_libraries>`.\n-  **Deprecated** $this->db->field_names() USE\n   $this->db->list_fields()\n-  **Deprecated** the $config['log_errors'] item from the config.php\n   file. Instead, $config['log_threshold'] can be set to \"0\" to turn it\n   off.\n\nVersion 1.4.1\n=============\n\nRelease Date: September 21, 2006\n\n-  Added a new feature that passes URI segments directly to your\n   function calls as parameters. See the\n   :doc:`Controllers ` page for more info.\n-  Added support for a function named _output(), which when used in\n   your controllers will received the final rendered output from the\n   output class. More info in the :doc:`Controllers `\n   page.\n-  Added several new functions in the :doc:`URI\n   Class <./libraries/uri>` to let you retrieve and manipulate URI\n   segments that have been re-routed using the :doc:`URI\n   Routing ` feature. Previously, the URI class did not\n   permit you to access any re-routed URI segments, but now it does.\n-  Added :doc:`$this->output->set_header() <./libraries/output>`\n   function, which allows you to set server headers.\n-  Updated plugins, helpers, and language classes to allow your\n   application folder to contain its own plugins, helpers, and language\n   folders. Previously they were always treated as global for your\n   entire installation. If your application folder contains any of these\n   resources they will be used *instead* the global ones.\n-  Added :doc:`Inflector helper <./helpers/inflector_helper>`.\n-  Added element() function in the :doc:`array\n   helper <./helpers/array_helper>`.\n-  Added RAND() to active record orderby() function.\n-  Added delete_cookie() and get_cookie() to :doc:`Cookie\n   helper <./helpers/cookie_helper>`, even though the input class\n   has a cookie fetching function.\n-  Added Oracle database driver (still undergoing testing so it might\n   have some bugs).\n-  Added the ability to combine pseudo-variables and php variables in\n   the template parser class.\n-  Added output compression option to the config file.\n-  Removed the is_numeric test from the db->escape() function.\n-  Fixed a MySQLi bug that was causing error messages not to contain\n   proper error data.\n-  Fixed a bug in the email class which was causing it to ignore\n   explicitly set alternative headers.\n-  Fixed a bug that was causing a PHP error when the Exceptions class\n   was called within the get_config() function since it was causing\n   problems.\n-  Fixed an oversight in the cookie helper in which the config file\n   cookie settings were not being honored.\n-  Fixed an oversight in the upload class. An item mentioned in the 1.4\n   changelog was missing.\n-  Added some code to allow email attachments to be reset when sending\n   batches of email.\n-  Deprecated the application/scripts folder. It will continue to work\n   for legacy users, but it is recommended that you create your own\n   :doc:`libraries <./general/libraries>` or\n   :doc:`models <./general/models>` instead. It was originally added\n   before CI had user libraries or models, but it's not needed anymore.\n-  Deprecated the $autoload['core'] item from the autoload.php file.\n   Instead, please now use: $autoload['libraries']\n-  Deprecated the following database functions:\n   $this->db->smart_escape_str() and $this->db->fields().\n\nVersion 1.4.0\n=============\n\nRelease Date: September 17, 2006\n\n-  Added :doc:`Hooks <./general/hooks>` feature, enabling you to tap\n   into and modify the inner workings of the framework without hacking\n   the core files.\n-  Added the ability to organize controller files :doc:`into\n   sub-folders `. Kudos to Marco for\n   suggesting this (and the next two) feature.\n-  Added regular expressions support for :doc:`routing\n   rules <./general/routing>`.\n-  Added the ability to :doc:`remap function\n   calls <./general/controllers>` within your controllers.\n-  Added the ability to :doc:`replace core system\n   classes <./general/core_classes>` with your own classes.\n-  Added support for % character in URL.\n-  Added the ability to supply full URLs using the\n   :doc:`anchor() <./helpers/url_helper>` helper function.\n-  Added mode parameter to :doc:`file_write() <./helpers/file_helper>`\n   helper.\n-  Added support for changing the port number in the :doc:`Postgres\n   driver <./database/configuration>`.\n-  Moved the list of \"allowed URI characters\" out of the Router class\n   and into the config file.\n-  Moved the MIME type array out of the Upload class and into its own\n   file in the application/config/ folder.\n-  Updated the Upload class to allow the upload field name to be set\n   when calling :doc:`do_upload() <./libraries/file_uploading>`.\n-  Updated the :doc:`Config Library <./libraries/config>` to be able to\n   load config files silently, and to be able to assign config files to\n   their own index (to avoid collisions if you use multiple config\n   files).\n-  Updated the URI Protocol code to allow more options so that URLs will\n   work more reliably in different environments.\n-  Updated the form_open() helper to allow the GET method to be used.\n-  Updated the MySQLi execute() function with some code to help prevent\n   lost connection errors.\n-  Updated the SQLite Driver to check for object support before\n   attempting to return results as objects. If unsupported it returns an\n   array.\n-  Updated the Models loader function to allow multiple loads of the\n   same model.\n-  Updated the MS SQL driver so that single quotes are escaped.\n-  Updated the Postgres and ODBC drivers for better compatibility.\n-  Removed a strtolower() call that was changing URL segments to lower\n   case.\n-  Removed some references that were interfering with PHP 4.4.1\n   compatibility.\n-  Removed backticks from Postgres class since these are not needed.\n-  Renamed display() to _display() in the Output class to make it clear\n   that it's a private function.\n-  Deprecated the hash() function due to a naming conflict with a native\n   PHP function with the same name. Please use dohash() instead.\n-  Fixed an bug that was preventing the input class from unsetting GET\n   variables.\n-  Fixed a router bug that was making it too greedy when matching end\n   segments.\n-  Fixed a bug that was preventing multiple discrete database calls.\n-  Fixed a bug in which loading a language file was producing a \"file\n   contains no data\" message.\n-  Fixed a session bug caused by the XSS Filtering feature inadvertently\n   changing the case of certain words.\n-  Fixed some missing prefixes when using the database prefix feature.\n-  Fixed a typo in the Calendar class (cal_november).\n-  Fixed a bug in the form_checkbox() helper.\n-  Fixed a bug that was allowing the second segment of the URI to be\n   identical to the class name.\n-  Fixed an evaluation bug in the database initialization function.\n-  Fixed a minor bug in one of the error messages in the language class.\n-  Fixed a bug in the date helper timespan function.\n-  Fixed an undefined variable in the DB Driver class.\n-  Fixed a bug in which dollar signs used as binding replacement values\n   in the DB class would be treated as RegEx back-references.\n-  Fixed a bug in the set_hash() function which was preventing MD5 from\n   being used.\n-  Fixed a couple bugs in the Unit Testing class.\n-  Fixed an incorrectly named variable in the Validation class.\n-  Fixed an incorrectly named variable in the URI class.\n-  Fixed a bug in the config class that was preventing the base URL from\n   being called properly.\n-  Fixed a bug in the validation class that was not permitting callbacks\n   if the form field was empty.\n-  Fixed a problem that was preventing scaffolding from working properly\n   with MySQLi.\n-  Fixed some MS SQL bugs.\n-  Fixed some doc typos.\n\nVersion 1.3.3\n=============\n\nRelease Date: June 1, 2006\n\n-  Models do **not** connect automatically to the database as of this\n   version. :doc:`More info here <./general/models>`.\n-  Updated the Sessions class to utilize the active record class when\n   running session related queries. Previously the queries assumed MySQL\n   syntax.\n-  Updated alternator() function to re-initialize when called with no\n   arguments, allowing multiple calls.\n-  Fixed a bug in the active record \"having\" function.\n-  Fixed a problem in the validation class which was making checkboxes\n   be ignored when required.\n-  Fixed a bug in the word_limiter() helper function. It was cutting\n   off the fist word.\n-  Fixed a bug in the xss_clean function due to a PHP bug that affects\n   some versions of html_entity_decode.\n-  Fixed a validation bug that was preventing rules from being set twice\n   in one controller.\n-  Fixed a calendar bug that was not letting it use dynamically loaded\n   languages.\n-  Fixed a bug in the active record class when using WHERE clauses with\n   LIKE\n-  Fixed a bug in the hash() security helper.\n-  Fixed some typos.\n\nVersion 1.3.2\n=============\n\nRelease Date: April 17, 2006\n\n-  Changed the behavior of the validation class such that if a\n   \"required\" rule is NOT explicitly stated for a field then all other\n   tests get ignored.\n-  Fixed a bug in the Controller class that was causing it to look in\n   the local \"init\" folder instead of the main system one.\n-  Fixed a bug in the init_pagination file. The $config item was not\n   being set correctly.\n-  Fixed a bug in the auto typography helper that was causing\n   inconsistent behavior.\n-  Fixed a couple bugs in the Model class.\n-  Fixed some documentation typos and errata.\n\nVersion 1.3.1\n=============\n\nRelease Date: April 11, 2006\n\n-  Added a :doc:`Unit Testing Library <./libraries/unit_testing>`.\n-  Added the ability to pass objects to the **insert()** and\n   **update()** database functions. This feature enables you to (among\n   other things) use your :doc:`Model class <./general/models>`\n   variables to run queries with. See the Models page for details.\n-  Added the ability to pass objects to the :doc:`view loading\n   function <./general/views>`: $this->load->view('my_view',\n   $object);\n-  Added getwhere function to :doc:`Active Record\n   class <./database/query_builder>`.\n-  Added count_all function to :doc:`Active Record\n   class <./database/query_builder>`.\n-  Added language file for scaffolding and fixed a scaffolding bug that\n   occurs when there are no rows in the specified table.\n-  Added :doc:`$this->db->last_query() <./database/queries>`, which\n   allows you to view your last query that was run.\n-  Added a new mime type to the upload class for better compatibility.\n-  Changed how cache files are read to prevent PHP errors if the cache\n   file contains an XML tag, which PHP wants to interpret as a short\n   tag.\n-  Fixed a bug in a couple of the active record functions (where and\n   orderby).\n-  Fixed a bug in the image library when realpath() returns false.\n-  Fixed a bug in the Models that was preventing libraries from being\n   used within them.\n-  Fixed a bug in the \"exact_length\" function of the validation class.\n-  Fixed some typos in the user guide\n\nVersion 1.3\n===========\n\nRelease Date: April 3, 2006\n\n-  Added support for :doc:`Models `.\n-  Redesigned the database libraries to support additional RDBMs\n   (Postgres, MySQLi, etc.).\n-  Redesigned the :doc:`Active Record class <./database/query_builder>`\n   to enable more varied types of queries with simpler syntax, and\n   advanced features like JOINs.\n-  Added a feature to the database class that lets you run :doc:`custom\n   function calls <./database/call_function>`.\n-  Added support for :doc:`private functions ` in your\n   controllers. Any controller function name that starts with an\n   underscore will not be served by a URI request.\n-  Added the ability to pass your own initialization parameters to your\n   :doc:`custom core libraries ` when using\n   $this->load->library()\n-  Added support for running standard :doc:`query string URLs `.\n   These can be optionally enabled in your config file.\n-  Added the ability to :doc:`specify a \"suffix\" `, which will be\n   appended to your URLs. For example, you could add .html to your URLs,\n   making them appear static. This feature is enabled in your config\n   file.\n-  Added a new error template for use with native PHP errors.\n-  Added \"alternator\" function in the :doc:`string\n   helpers <./helpers/string_helper>`.\n-  Removed slashing from the input class. After much debate we decided\n   to kill this feature.\n-  Change the commenting style in the scripts to the PEAR standard so\n   that IDEs and tools like phpDocumenter can harvest the comments.\n-  Added better class and function name-spacing to avoid collisions with\n   user developed classes. All CodeIgniter classes are now prefixed with\n   CI\\_ and all controller methods are prefixed with _ci to avoid\n   controller collisions. A list of reserved function names can be\n   :doc:`found here `.\n-  Redesigned how the \"CI\" super object is referenced, depending on\n   whether PHP 4 or 5 is being run, since PHP 5 allows a more graceful\n   way to manage objects that utilizes a bit less resources.\n-  Deprecated: $this->db->use_table() has been deprecated. Please read\n   the :doc:`Active Record <./database/query_builder>` page for\n   information.\n-  Deprecated: $this->db->smart_escape_str() has been deprecated.\n   Please use this instead: $this->db->escape()\n-  Fixed a bug in the exception handler which was preventing some PHP\n   errors from showing up.\n-  Fixed a typo in the URI class. $this->total_segment() should be\n   plural: $this->total_segments()\n-  Fixed some typos in the default calendar template\n-  Fixed some typos in the user guide\n\nVersion 1.2\n===========\n\nRelease Date: March 21, 2006\n\n-  Redesigned some internal aspects of the framework to resolve scoping\n   problems that surfaced during the beta tests. The problem was most\n   notable when instantiating classes in your constructors, particularly\n   if those classes in turn did work in their constructors.\n-  Added a global function named\n   :doc:`get_instance() ` allowing the main\n   CodeIgniter object to be accessible throughout your own classes.\n-  Added new :doc:`File Helper <./helpers/file_helper>`:\n   delete_files()\n-  Added new :doc:`URL Helpers <./helpers/url_helper>`: base_url(),\n   index_page()\n-  Added the ability to create your own :doc:`core\n   libraries ` and store them in your local\n   application directory.\n-  Added an overwrite option to the :doc:`Upload\n   class <./libraries/file_uploading>`, enabling files to be\n   overwritten rather than having the file name appended.\n-  Added Javascript Calendar plugin.\n-  Added search feature to user guide. Note: This is done using Google,\n   which at the time of this writing has not crawled all the pages of\n   the docs.\n-  Updated the parser class so that it allows tag pars within other tag\n   pairs.\n-  Fixed a bug in the DB \"where\" function.\n-  Fixed a bug that was preventing custom config files to be\n   auto-loaded.\n-  Fixed a bug in the mysql class bind feature that prevented question\n   marks in the replacement data.\n-  Fixed some bugs in the xss_clean function\n\nVersion Beta 1.1\n================\n\nRelease Date: March 10, 2006\n\n-  Added a :doc:`Calendaring class <./libraries/calendar>`.\n-  Added support for running :doc:`multiple\n   applications ` that share a common CodeIgniter\n   backend.\n-  Moved the \"uri protocol\" variable from the index.php file into the\n   config.php file\n-  Fixed a problem that was preventing certain function calls from\n   working within constructors.\n-  Fixed a problem that was preventing the $this->load->library function\n   from working in constructors.\n-  Fixed a bug that occurred when the session class was loaded using the\n   auto-load routine.\n-  Fixed a bug that can happen with PHP versions that do not support the\n   E_STRICT constant\n-  Fixed a data type error in the form_radio function (form helper)\n-  Fixed a bug that was preventing the xss_clean function from being\n   called from the validation class.\n-  Fixed the cookie related config names, which were incorrectly\n   specified as $conf rather than $config\n-  Fixed a pagination problem in the scaffolding.\n-  Fixed a bug in the mysql class \"where\" function.\n-  Fixed a regex problem in some code that trimmed duplicate slashes.\n-  Fixed a bug in the ``br()`` function in the HTML helper\n-  Fixed a syntax mistake in the form_dropdown function in the Form\n   Helper.\n-  Removed the \"style\" attributes form the form helpers.\n-  Updated the documentation. Added \"next/previous\" links to each page\n   and fixed various typos.\n\nVersion Beta 1.0\n================\n\nRelease Date: February 28, 2006\n\nFirst publicly released version.\n"
  },
  {
    "path": "user_guide_src/source/conf.py",
    "content": "# -*- coding: utf-8 -*-\n#\n# CodeIgniter documentation build configuration file, created by\n# sphinx-quickstart on Sun Aug 28 07:24:38 2011.\n#\n# This file is execfile()d with the current directory set to its containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\n\nimport sys, os\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#sys.path.insert(0, os.path.abspath('.'))\n\n# -- General configuration -----------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be extensions\n# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.\nextensions = ['sphinx.ext.ifconfig', 'sphinxcontrib.phpdomain']\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = ['_templates']\n\n# The suffix of source filenames.\nsource_suffix = '.rst'\n\n# The encoding of source files.\n#source_encoding = 'utf-8-sig'\n\n# The master toctree document.\nmaster_doc = 'index'\n\n# General information about the project.\nproject = u'CodeIgniter'\ncopyright = u'2019 - 2022, CodeIgniter Foundation'\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = '3.1.14-dev'\n# The full version, including alpha/beta/rc tags.\nrelease = '3.1.14-dev'\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#language = None\n\n# There are two options for replacing |today|: either, you set today to some\n# non-false value, then it is used:\n#today = ''\n# Else, today_fmt is used as the format for a strftime call.\n#today_fmt = '%B %d, %Y'\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\nexclude_patterns = []\n\n# The reST default role (used for this markup: `text`) to use for all documents.\n#default_role = None\n\n# If true, '()' will be appended to :php:func: etc. cross-reference text.\n#add_function_parentheses = True\n\n# If true, the current module name will be prepended to all description\n# unit titles (such as .. php:function::).\n#add_module_names = True\n\n# If true, sectionauthor and moduleauthor directives will be shown in the\n# output. They are ignored by default.\n#show_authors = False\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = 'trac'\nhighlight_language = 'ci'\n\n# A list of ignored prefixes for module index sorting.\n#modindex_common_prefix = []\n\n\n# -- Options for HTML output ---------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = 'sphinx_rtd_theme'\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\n# Specifying a few options; just a starting point & we can play with it.\nhtml_theme_options = {\n\n}\n\n# Add any paths that contain custom themes here, relative to this directory.\nhtml_theme_path = [\"./_themes\"]\n\n# The name for this set of Sphinx documents.  If None, it defaults to\n# \" v documentation\".\n#html_title = None\n\n# A shorter title for the navigation bar.  Default is the same as html_title.\n#html_short_title = None\n\n# The name of an image file (relative to this directory) to place at the top\n# of the sidebar.\n#html_logo = None\n\n# The name of an image file (within the static path) to use as favicon of the\n# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32\n# pixels large.\nhtml_favicon = 'images/ci-icon.ico'\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\n#html_static_path = ['_static']\n\n# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,\n# using the given strftime format.\nhtml_last_updated_fmt = '%b %d, %Y'\n\n# If true, SmartyPants will be used to convert quotes and dashes to\n# typographically correct entities.\n#html_use_smartypants = True\n\n# Custom sidebar templates, maps document names to template names.\n#html_sidebars = {}\n\n# Additional templates that should be rendered to pages, maps page names to\n# template names.\n#html_additional_pages = {}\n\n# If false, no module index is generated.\n#html_domain_indices = True\n\n# If false, no index is generated.\n#html_use_index = True\n\n# If true, the index is split into individual pages for each letter.\n#html_split_index = False\n\n# If true, links to the reST sources are added to the pages.\n#html_show_sourcelink = True\n\n# If true, \"Created using Sphinx\" is shown in the HTML footer. Default is True.\n#html_show_sphinx = True\n\n# If true, \"(C) Copyright ...\" is shown in the HTML footer. Default is True.\n#html_show_copyright = True\n\n# If true, an OpenSearch description file will be output, and all pages will\n# contain a  tag referring to it.  The value of this option must be the\n# base URL from which the finished HTML is served.\n#html_use_opensearch = ''\n\n# This is the file name suffix for HTML files (e.g. \".xhtml\").\n#html_file_suffix = None\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = 'CodeIgniterdoc'\n\nhtml_copy_source = False\n\n# -- Options for LaTeX output --------------------------------------------------\n\n# The paper size ('letter' or 'a4').\n#latex_paper_size = 'letter'\n\n# The font size ('10pt', '11pt' or '12pt').\n#latex_font_size = '10pt'\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title, author, documentclass [howto/manual]).\nlatex_documents = [\n  ('index', 'CodeIgniter.tex', u'CodeIgniter Documentation',\n   u'British Columbia Institute of Technology', 'manual'),\n]\n\n# The name of an image file (relative to this directory) to place at the top of\n# the title page.\n#latex_logo = None\n\n# For \"manual\" documents, if this is true, then toplevel headings are parts,\n# not chapters.\n#latex_use_parts = False\n\n# If true, show page references after internal links.\n#latex_show_pagerefs = False\n\n# If true, show URL addresses after external links.\n#latex_show_urls = False\n\n# Additional stuff for the LaTeX preamble.\n#latex_preamble = ''\n\n# Documents to append as an appendix to all manuals.\n#latex_appendices = []\n\n# If false, no module index is generated.\n#latex_domain_indices = True\n\n\n# -- Options for manual page output --------------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [\n    ('index', 'codeigniter', u'CodeIgniter Documentation',\n     [u'British Columbia Institute of Technology'], 1)\n]\n\n\n# -- Options for Epub output ---------------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = u'CodeIgniter'\nepub_author = u'British Columbia Institute of Technology'\nepub_publisher = u'British Columbia Institute of Technology'\nepub_copyright = u'2014 - 2019, British Columbia Institute of Technology'\n\n# The language of the text. It defaults to the language option\n# or en if the language is not set.\n#epub_language = ''\n\n# The scheme of the identifier. Typical schemes are ISBN or URL.\n#epub_scheme = ''\n\n# The unique identifier of the text. This can be a ISBN number\n# or the project homepage.\n#epub_identifier = ''\n\n# A unique identification for the text.\n#epub_uid = ''\n\n# HTML files that should be inserted before the pages created by sphinx.\n# The format is a list of tuples containing the path and title.\n#epub_pre_files = []\n\n# HTML files shat should be inserted after the pages created by sphinx.\n# The format is a list of tuples containing the path and title.\n#epub_post_files = []\n\n# A list of files that should not be packed into the epub file.\n#epub_exclude_files = []\n\n# The depth of the table of contents in toc.ncx.\n#epub_tocdepth = 3\n\n# Allow duplicate toc entries.\n#epub_tocdup = True\n"
  },
  {
    "path": "user_guide_src/source/contributing/index.rst",
    "content": "###########################\nContributing to CodeIgniter\n###########################\n\n.. toctree::\n\t:titlesonly:\n\n\t../documentation/index\n\t../DCO\n\nCodeIgniter is a community driven project and accepts contributions of code\nand documentation from the community. These contributions are made in the form\nof Issues or `Pull Requests `_ \non the `CodeIgniter repository `_ on GitHub.\n\nIssues are a quick way to point out a bug. If you find a bug or documentation\nerror in CodeIgniter then please check a few things first:\n\n- There is not already an open Issue\n- The issue has already been fixed (check the develop branch, or look for\n  closed Issues)\n- Is it something really obvious that you fix it yourself?\n\nReporting issues is helpful but an even better approach is to send a Pull\nRequest, which is done by \"Forking\" the main repository and committing to your\nown copy. This will require you to use the version control system called Git.\n\n*******\nSupport\n*******\n\nPlease note that GitHub is not for general support questions! If you are\nhaving trouble using a feature of CodeIgniter, ask for help on our\n`forums `_ instead.\n\nIf you are not sure whether you are using something correctly or if you\nhave found a bug, again - please ask on the forums first.\n\n********\nSecurity\n********\n\nDid you find a security issue in CodeIgniter?\n\nPlease *don't* disclose it publicly, but e-mail us at security@codeigniter.com,\nor report it via our page on `HackerOne `_.\n\nIf you've found a critical vulnerability, we'd be happy to credit you in our\n`ChangeLog <../changelog>`.\n\n****************************\nTips for a Good Issue Report\n****************************\n\nUse a descriptive subject line (eg parser library chokes on commas) rather than a vague one (eg. your code broke).\n\nAddress a single issue in a report.\n\nIdentify the CodeIgniter version (eg 3.0-develop) and the component if you know it (eg. parser library)\n\nExplain what you expected to happen, and what did happen.\nInclude error messages and stacktrace, if any.\n\nInclude short code segments if they help to explain.\nUse a pastebin or dropbox facility to include longer segments of code or screenshots - do not include them in the issue report itself.\nThis means setting a reasonable expiry for those, until the issue is resolved or closed.\n\nIf you know how to fix the issue, you can do so in your own fork & branch, and submit a pull request.\nThe issue report information above should be part of that.\n\nIf your issue report can describe the steps to reproduce the problem, that is great.\nIf you can include a unit test that reproduces the problem, that is even better, as it gives whoever is fixing\nit a clearer target!\n\n\n**********\nGuidelines\n**********\n\nBefore we look into how, here are the guidelines. If your Pull Requests fail\nto pass these guidelines it will be declined and you will need to re-submit\nwhen you’ve made the changes. This might sound a bit tough, but it is required\nfor us to maintain quality of the code-base.\n\nPHP Style\n=========\n\nAll code must meet the `Style Guide\n`_, which is\nessentially the `Allman indent style\n`_, underscores and\nreadable operators. This makes certain that all code is the same format as the\nexisting code and means it will be as readable as possible.\n\nDocumentation\n=============\n\nIf you change anything that requires a change to documentation then you will\nneed to add it. New classes, methods, parameters, changing default values, etc\nare all things that will require a change to documentation. The change-log\nmust also be updated for every change. Also PHPDoc blocks must be maintained.\n\nCompatibility\n=============\n\nCodeIgniter recommends PHP 5.6 or newer to be used, but it should be\ncompatible with PHP 5.4.8 so all code supplied must stick to this\nrequirement. If PHP 5.5 (and above) functions or features are used then\nthere must be a fallback for PHP 5.4.8.\n\nBranching\n=========\n\nCodeIgniter uses the `Git-Flow\n`_ branching model\nwhich requires all pull requests to be sent to the \"develop\" branch. This is\nwhere the next planned version will be developed. The \"master\" branch will\nalways contain the latest stable version and is kept clean so a \"hotfix\" (e.g:\nan emergency security patch) can be applied to master to create a new version,\nwithout worrying about other features holding it up. For this reason all\ncommits need to be made to \"develop\" and any sent to \"master\" will be closed\nautomatically. If you have multiple changes to submit, please place all\nchanges into their own branch on your fork.\n\nOne thing at a time: A pull request should only contain one change. That does\nnot mean only one commit, but one change - however many commits it took. The\nreason for this is that if you change X and Y but send a pull request for both\nat the same time, we might really want X but disagree with Y, meaning we\ncannot merge the request. Using the Git-Flow branching model you can create\nnew branches for both of these features and send two requests.\n\nSigning\n=======\nYou must sign your work, certifying that you either wrote the work or\notherwise have the right to pass it on to an open source project. git makes\nthis trivial as you merely have to use `--signoff` on your commits to your\nCodeIgniter fork.\n\n.. code-block:: bash\n\n\tgit commit --signoff\n\nor simply\n\n.. code-block:: bash\n\n\tgit commit -s\n\nThis will sign your commits with the information setup in your git config, e.g.\n\n\tSigned-off-by: John Q Public \n\nIf you are using Tower there is a \"Sign-Off\" checkbox in the commit window. You\ncould even alias git commit to use the -s flag so you don’t have to think about\nit.\n\nBy signing your work in this manner, you certify to a \"Developer's Certificate\nof Origin\". The current version of this certificate is in the :doc:`/DCO` file\nin the root of this documentation.\n"
  },
  {
    "path": "user_guide_src/source/database/caching.rst",
    "content": "######################\nDatabase Caching Class\n######################\n\nThe Database Caching Class permits you to cache your queries as text\nfiles for reduced database load.\n\n.. important:: This class is initialized automatically by the database\n\tdriver when caching is enabled. Do NOT load this class manually.\n\n.. important:: Not all query result functions are available when you\n\tuse caching. Please read this page carefully.\n\nEnabling Caching\n================\n\nCaching is enabled in three steps:\n\n-  Create a writable directory on your server where the cache files can\n   be stored.\n-  Set the path to your cache folder in your\n   application/config/database.php file.\n-  Enable the caching feature, either globally by setting the preference\n   in your application/config/database.php file, or manually as\n   described below.\n\nOnce enabled, caching will happen automatically whenever a page is\nloaded that contains database queries.\n\nHow Does Caching Work?\n======================\n\nCodeIgniter's query caching system happens dynamically when your pages\nare viewed. When caching is enabled, the first time a web page is\nloaded, the query result object will be serialized and stored in a text\nfile on your server. The next time the page is loaded the cache file\nwill be used instead of accessing your database. Your database usage can\neffectively be reduced to zero for any pages that have been cached.\n\nOnly read-type (SELECT) queries can be cached, since these are the only\ntype of queries that produce a result. Write-type (INSERT, UPDATE, etc.)\nqueries, since they don't generate a result, will not be cached by the\nsystem.\n\nCache files DO NOT expire. Any queries that have been cached will remain\ncached until you delete them. The caching system permits you clear\ncaches associated with individual pages, or you can delete the entire\ncollection of cache files. Typically you'll want to use the housekeeping\nfunctions described below to delete cache files after certain events\ntake place, like when you've added new information to your database.\n\nWill Caching Improve Your Site's Performance?\n=============================================\n\nGetting a performance gain as a result of caching depends on many\nfactors. If you have a highly optimized database under very little load,\nyou probably won't see a performance boost. If your database is under\nheavy use you probably will see an improved response, assuming your\nfile-system is not overly taxed. Remember that caching simply changes\nhow your information is retrieved, shifting it from being a database\noperation to a file-system one.\n\nIn some clustered server environments, for example, caching may be\ndetrimental since file-system operations are so intense. On single\nservers in shared environments, caching will probably be beneficial.\nUnfortunately there is no single answer to the question of whether you\nshould cache your database. It really depends on your situation.\n\nHow are Cache Files Stored?\n===========================\n\nCodeIgniter places the result of EACH query into its own cache file.\nSets of cache files are further organized into sub-folders corresponding\nto your controller functions. To be precise, the sub-folders are named\nidentically to the first two segments of your URI (the controller class\nname and function name).\n\nFor example, let's say you have a controller called blog with a function\ncalled comments that contains three queries. The caching system will\ncreate a cache folder called blog+comments, into which it will write\nthree cache files.\n\nIf you use dynamic queries that change based on information in your URI\n(when using pagination, for example), each instance of the query will\nproduce its own cache file. It's possible, therefore, to end up with\nmany times more cache files than you have queries.\n\nManaging your Cache Files\n=========================\n\nSince cache files do not expire, you'll need to build deletion routines\ninto your application. For example, let's say you have a blog that\nallows user commenting. Whenever a new comment is submitted you'll want\nto delete the cache files associated with the controller function that\nserves up your comments. You'll find two delete functions described\nbelow that help you clear data.\n\nNot All Database Functions Work with Caching\n============================================\n\nLastly, we need to point out that the result object that is cached is a\nsimplified version of the full result object. For that reason, some of\nthe query result functions are not available for use.\n\nThe following functions ARE NOT available when using a cached result\nobject:\n\n-  num_fields()\n-  field_names()\n-  field_data()\n-  free_result()\n\nAlso, the two database resources (result_id and conn_id) are not\navailable when caching, since result resources only pertain to run-time\noperations.\n\n******************\nFunction Reference\n******************\n\n$this->db->cache_on() / $this->db->cache_off()\n================================================\n\nManually enables/disables caching. This can be useful if you want to\nkeep certain queries from being cached. Example::\n\n\t// Turn caching on\n\t$this->db->cache_on();\n\t$query = $this->db->query(\"SELECT * FROM mytable\");\n\t\n\t// Turn caching off for this one query\n\t$this->db->cache_off();\n\t$query = $this->db->query(\"SELECT * FROM members WHERE member_id = '$current_user'\");\n\t\n\t// Turn caching back on\n\t$this->db->cache_on();\n\t$query = $this->db->query(\"SELECT * FROM another_table\");\n\n$this->db->cache_delete()\n==========================\n\nDeletes the cache files associated with a particular page. This is\nuseful if you need to clear caching after you update your database.\n\nThe caching system saves your cache files to folders that correspond to\nthe URI of the page you are viewing. For example, if you are viewing a\npage at example.com/index.php/blog/comments, the caching system will put\nall cache files associated with it in a folder called blog+comments. To\ndelete those particular cache files you will use::\n\n\t$this->db->cache_delete('blog', 'comments');\n\nIf you do not use any parameters the current URI will be used when\ndetermining what should be cleared.\n\n$this->db->cache_delete_all()\n===============================\n\nClears all existing cache files. Example::\n\n\t$this->db->cache_delete_all();\n\n"
  },
  {
    "path": "user_guide_src/source/database/call_function.rst",
    "content": "#####################\nCustom Function Calls\n#####################\n\n$this->db->call_function();\n============================\n\nThis function enables you to call PHP database functions that are not\nnatively included in CodeIgniter, in a platform independent manner. For\nexample, let's say you want to call the mysql_get_client_info()\nfunction, which is **not** natively supported by CodeIgniter. You could\ndo so like this::\n\n\t$this->db->call_function('get_client_info');\n\nYou must supply the name of the function, **without** the mysql\\_\nprefix, in the first parameter. The prefix is added automatically based\non which database driver is currently being used. This permits you to\nrun the same function on different database platforms. Obviously not all\nfunction calls are identical between platforms, so there are limits to\nhow useful this function can be in terms of portability.\n\nAny parameters needed by the function you are calling will be added to\nthe second parameter.\n\n::\n\n\t$this->db->call_function('some_function', $param1, $param2, etc..);\n\nOften, you will either need to supply a database connection ID or a\ndatabase result ID. The connection ID can be accessed using::\n\n\t$this->db->conn_id;\n\nThe result ID can be accessed from within your result object, like this::\n\n\t$query = $this->db->query(\"SOME QUERY\");\n\t\n\t$query->result_id;"
  },
  {
    "path": "user_guide_src/source/database/configuration.rst",
    "content": "######################\nDatabase Configuration\n######################\n\nCodeIgniter has a config file that lets you store your database\nconnection values (username, password, database name, etc.). The config\nfile is located at application/config/database.php. You can also set\ndatabase connection values for specific\n:doc:`environments <../libraries/config>` by placing **database.php**\nin the respective environment config folder.\n\nThe config settings are stored in a multi-dimensional array with this\nprototype::\n\n\t$db['default'] = array(\n\t\t'dsn'\t=> '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'root',\n\t\t'password' => '',\n\t\t'database' => 'database_name',\n\t\t'dbdriver' => 'mysqli',\n\t\t'dbprefix' => '',\n\t\t'pconnect' => TRUE,\n\t\t'db_debug' => TRUE,\n\t\t'cache_on' => FALSE,\n\t\t'cachedir' => '',\n\t\t'char_set' => 'utf8',\n\t\t'dbcollat' => 'utf8_general_ci',\n\t\t'swap_pre' => '',\n\t\t'encrypt' => FALSE,\n\t\t'compress' => FALSE,\n\t\t'stricton' => FALSE,\n\t\t'failover' => array()\n\t);\n\nSome database drivers (such as PDO, PostgreSQL, Oracle, ODBC) might\nrequire a full DSN string to be provided. If that is the case, you\nshould use the 'dsn' configuration setting, as if you're using the\ndriver's underlying native PHP extension, like this::\n\n\t// PDO\n\t$db['default']['dsn'] = 'pgsql:host=localhost;port=5432;dbname=database_name';\n\n\t// Oracle\n\t$db['default']['dsn'] = '//localhost/XE';\n\n.. note:: If you do not specify a DSN string for a driver that requires it, CodeIgniter\n\twill try to build it with the rest of the provided settings.\n\n.. note:: If you provide a DSN string and it is missing some valid settings (e.g. the\n\tdatabase character set), which are present in the rest of the configuration\n\tfields, CodeIgniter will append them.\n\nYou can also specify failovers for the situation when the main connection cannot connect for some reason.\nThese failovers can be specified by setting the failover for a connection like this::\n\n\t$db['default']['failover'] = array(\n\t\t\tarray(\n\t\t\t\t'hostname' => 'localhost1',\n\t\t\t\t'username' => '',\n\t\t\t\t'password' => '',\n\t\t\t\t'database' => '',\n\t\t\t\t'dbdriver' => 'mysqli',\n\t\t\t\t'dbprefix' => '',\n\t\t\t\t'pconnect' => TRUE,\n\t\t\t\t'db_debug' => TRUE,\n\t\t\t\t'cache_on' => FALSE,\n\t\t\t\t'cachedir' => '',\n\t\t\t\t'char_set' => 'utf8',\n\t\t\t\t'dbcollat' => 'utf8_general_ci',\n\t\t\t\t'swap_pre' => '',\n\t\t\t\t'encrypt' => FALSE,\n\t\t\t\t'compress' => FALSE,\n\t\t\t\t'stricton' => FALSE\n\t\t\t),\n\t\t\tarray(\n\t\t\t\t'hostname' => 'localhost2',\n\t\t\t\t'username' => '',\n\t\t\t\t'password' => '',\n\t\t\t\t'database' => '',\n\t\t\t\t'dbdriver' => 'mysqli',\n\t\t\t\t'dbprefix' => '',\n\t\t\t\t'pconnect' => TRUE,\n\t\t\t\t'db_debug' => TRUE,\n\t\t\t\t'cache_on' => FALSE,\n\t\t\t\t'cachedir' => '',\n\t\t\t\t'char_set' => 'utf8',\n\t\t\t\t'dbcollat' => 'utf8_general_ci',\n\t\t\t\t'swap_pre' => '',\n\t\t\t\t'encrypt' => FALSE,\n\t\t\t\t'compress' => FALSE,\n\t\t\t\t'stricton' => FALSE\n\t\t\t)\n\t\t);\n\nYou can specify as many failovers as you like.\n\nThe reason we use a multi-dimensional array rather than a more simple\none is to permit you to optionally store multiple sets of connection\nvalues. If, for example, you run multiple environments (development,\nproduction, test, etc.) under a single installation, you can set up a\nconnection group for each, then switch between groups as needed. For\nexample, to set up a \"test\" environment you would do this::\n\n\t$db['test'] = array(\n\t\t'dsn'\t=> '',\n\t\t'hostname' => 'localhost',\n\t\t'username' => 'root',\n\t\t'password' => '',\n\t\t'database' => 'database_name',\n\t\t'dbdriver' => 'mysqli',\n\t\t'dbprefix' => '',\n\t\t'pconnect' => TRUE,\n\t\t'db_debug' => TRUE,\n\t\t'cache_on' => FALSE,\n\t\t'cachedir' => '',\n\t\t'char_set' => 'utf8',\n\t\t'dbcollat' => 'utf8_general_ci',\n\t\t'swap_pre' => '',\n\t\t'compress' => FALSE,\n\t\t'encrypt' => FALSE,\n\t\t'stricton' => FALSE,\n\t\t'failover' => array()\n\t);\n\nThen, to globally tell the system to use that group you would set this\nvariable located in the config file::\n\n\t$active_group = 'test';\n\n.. note:: The name 'test' is arbitrary. It can be anything you want. By\n\tdefault we've used the word \"default\" for the primary connection,\n\tbut it too can be renamed to something more relevant to your project.\n\nExplanation of Values:\n----------------------\n\n======================  ===========================================================================================================\n Name Config             Description\n======================  ===========================================================================================================\n**dsn**\t\t\tThe DSN connect string (an all-in-one configuration sequence).\n**hostname**\t\tThe hostname of your database server. Often this is 'localhost'.\n**username**\t\tThe username used to connect to the database.\n**password**\t\tThe password used to connect to the database.\n**database**\t\tThe name of the database you want to connect to.\n**dbdriver**\t\tThe database type. ie: mysqli, postgre, odbc, etc. Must be specified in lower case.\n**dbprefix**\t\tAn optional table prefix which will added to the table name when running\n\t\t\t:doc:`Query Builder ` queries. This permits multiple CodeIgniter\n\t\t\tinstallations to share one database.\n**pconnect**\t\tTRUE/FALSE (boolean) - Whether to use a persistent connection.\n**db_debug**\t\tTRUE/FALSE (boolean) - Whether database errors should be displayed.\n**cache_on**\t\tTRUE/FALSE (boolean) - Whether database query caching is enabled,\n\t\t\tsee also :doc:`Database Caching Class `.\n**cachedir**\t\tThe absolute server path to your database query cache directory.\n**char_set**\t\tThe character set used in communicating with the database.\n**dbcollat**\t\tThe character collation used in communicating with the database\n\n\t\t\t.. note:: Only used in the 'mysql' and 'mysqli' drivers.\n\n**swap_pre**\t\tA default table prefix that should be swapped with dbprefix. This is useful for distributed\n\t\t\tapplications where you might run manually written queries, and need the prefix to still be\n\t\t\tcustomizable by the end user.\n**schema**\t\tThe database schema, defaults to 'public'. Used by PostgreSQL and ODBC drivers.\n**encrypt**\t\tWhether or not to use an encrypted connection.\n\n\t\t\t  - 'mysql' (deprecated), 'sqlsrv' and 'pdo/sqlsrv' drivers accept TRUE/FALSE\n\t\t\t  - 'mysqli' and 'pdo/mysql' drivers accept an array with the following options:\n\t\t\t  \n\t\t\t    - 'ssl_key'    - Path to the private key file\n\t\t\t    - 'ssl_cert'   - Path to the public key certificate file\n\t\t\t    - 'ssl_ca'     - Path to the certificate authority file\n\t\t\t    - 'ssl_capath' - Path to a directory containing trusted CA certificates in PEM format\n\t\t\t    - 'ssl_cipher' - List of *allowed* ciphers to be used for the encryption, separated by colons (':')\n\t\t\t    - 'ssl_verify' - TRUE/FALSE; Whether to verify the server certificate or not ('mysqli' only)\n\n**compress**\t\tWhether or not to use client compression (MySQL only).\n**stricton**\t\tTRUE/FALSE (boolean) - Whether to force \"Strict Mode\" connections, good for ensuring strict SQL\n\t\t\twhile developing an application.\n**port**\t\tThe database port number. To use this value you have to add a line to the database config array.\n\t\t\t::\n\n\t\t\t\t$db['default']['port'] = 5432;\n\n======================  ===========================================================================================================\n\n.. note:: Depending on what database platform you are using (MySQL, PostgreSQL,\n\tetc.) not all values will be needed. For example, when using SQLite you\n\twill not need to supply a username or password, and the database name\n\twill be the path to your database file. The information above assumes\n\tyou are using MySQL.\n"
  },
  {
    "path": "user_guide_src/source/database/connecting.rst",
    "content": "###########################\nConnecting to your Database\n###########################\n\nThere are two ways to connect to a database:\n\nAutomatically Connecting\n========================\n\nThe \"auto connect\" feature will load and instantiate the database class\nwith every page load. To enable \"auto connecting\", add the word database\nto the library array, as indicated in the following file:\n\napplication/config/autoload.php\n\nManually Connecting\n===================\n\nIf only some of your pages require database connectivity you can\nmanually connect to your database by adding this line of code in any\nfunction where it is needed, or in your class constructor to make the\ndatabase available globally in that class.\n\n::\n\n\t$this->load->database();\n\nIf the above function does **not** contain any information in the first\nparameter it will connect to the group specified in your database config\nfile. For most people, this is the preferred method of use.\n\nAvailable Parameters\n--------------------\n\n#. The database connection values, passed either as an array or a DSN\n   string.\n#. TRUE/FALSE (boolean). Whether to return the connection ID (see\n   Connecting to Multiple Databases below).\n#. TRUE/FALSE (boolean). Whether to enable the Query Builder class. Set\n   to TRUE by default.\n\nManually Connecting to a Database\n---------------------------------\n\nThe first parameter of this function can **optionally** be used to\nspecify a particular database group from your config file, or you can\neven submit connection values for a database that is not specified in\nyour config file. Examples:\n\nTo choose a specific group from your config file you can do this::\n\n\t$this->load->database('group_name');\n\nWhere group_name is the name of the connection group from your config\nfile.\n\nTo connect manually to a desired database you can pass an array of\nvalues::\n\n\t$config['hostname'] = 'localhost';\n\t$config['username'] = 'myusername';\n\t$config['password'] = 'mypassword';\n\t$config['database'] = 'mydatabase';\n\t$config['dbdriver'] = 'mysqli';\n\t$config['dbprefix'] = '';\n\t$config['pconnect'] = FALSE;\n\t$config['db_debug'] = TRUE;\n\t$config['cache_on'] = FALSE;\n\t$config['cachedir'] = '';\n\t$config['char_set'] = 'utf8';\n\t$config['dbcollat'] = 'utf8_general_ci';\n\t$this->load->database($config);\n\nFor information on each of these values please see the :doc:`configuration\npage `.\n\n.. note:: For the PDO driver, you should use the $config['dsn'] setting\n\tinstead of 'hostname' and 'database':\n\n\t|\n\t| $config['dsn'] = 'mysql:host=localhost;dbname=mydatabase';\n\nOr you can submit your database values as a Data Source Name. DSNs must\nhave this prototype::\n\n\t$dsn = 'dbdriver://username:password@hostname/database';  \n\t$this->load->database($dsn);\n\nTo override default config values when connecting with a DSN string, add\nthe config variables as a query string.\n\n::\n\n\t$dsn = 'dbdriver://username:password@hostname/database?char_set=utf8&dbcollat=utf8_general_ci&cache_on=true&cachedir=/path/to/cache';  \n\t$this->load->database($dsn);\n\nConnecting to Multiple Databases\n================================\n\nIf you need to connect to more than one database simultaneously you can\ndo so as follows::\n\n\t$DB1 = $this->load->database('group_one', TRUE); \n\t$DB2 = $this->load->database('group_two', TRUE);\n\nNote: Change the words \"group_one\" and \"group_two\" to the specific\ngroup names you are connecting to (or you can pass the connection values\nas indicated above).\n\nBy setting the second parameter to TRUE (boolean) the function will\nreturn the database object.\n\n.. note:: When you connect this way, you will use your object name to issue\n\tcommands rather than the syntax used throughout this guide. In other\n\twords, rather than issuing commands with:\n\t\n\t|\n\t| $this->db->query();\n\t| $this->db->result();\n\t| etc...\n\t|\n\t| You will instead use:\n\t|\n\t| $DB1->query();\n\t| $DB1->result();\n\t| etc...\n\n.. note:: You don't need to create separate database configurations if you\n\tonly need to use a different database on the same connection. You\n\tcan switch to a different database when you need to, like this:\n\n\t| $this->db->db_select($database2_name);\n\nReconnecting / Keeping the Connection Alive\n===========================================\n\nIf the database server's idle timeout is exceeded while you're doing\nsome heavy PHP lifting (processing an image, for instance), you should\nconsider pinging the server by using the reconnect() method before\nsending further queries, which can gracefully keep the connection alive\nor re-establish it.\n\n::\n\n\t$this->db->reconnect();\n\nManually closing the Connection\n===============================\n\nWhile CodeIgniter intelligently takes care of closing your database\nconnections, you can explicitly close the connection.\n\n::\n\n\t$this->db->close();"
  },
  {
    "path": "user_guide_src/source/database/db_driver_reference.rst",
    "content": "###################\nDB Driver Reference\n###################\n\nThis is the platform-independent base DB implementation class.\nThis class will not be called directly. Rather, the adapter\nclass for the specific database will extend and instantiate it.\n\nThe how-to material for this has been split over several articles.\nThis article is intended to be a reference for them.\n\n.. important:: Not all methods are supported by all database drivers,\n\tsome of them may fail (and return FALSE) if the underlying\n\tdriver does not support them.\n\n.. php:class:: CI_DB_driver\n\n\t.. php:method:: initialize()\n\n\t\t:rtype:\tvoid\n\t\t:throws:\tRuntimeException\tIn case of failure\n\n\t\tInitialize database settings, establish a connection to\n\t\tthe database.\n\n\t.. php:method:: db_connect($persistent = TRUE)\n\n\t\t:param\tbool\t$persistent: Whether to establish a persistent connection or a regular one\n\t\t:returns:\tDatabase connection resource/object or FALSE on failure\n\t\t:rtype:\tmixed\n\n\t\tEstablish a connection with the database.\n\n\t\t.. note:: The returned value depends on the underlying\n\t\t\tdriver in use. For example, a ``mysqli`` instance\n\t\t\twill be returned with the 'mysqli' driver.\n\n\t.. php:method:: db_pconnect()\n\n\t\t:returns:\tDatabase connection resource/object or FALSE on failure\n\t\t:rtype:\tmixed\n\n\t\tEstablish a persistent connection with the database.\n\n\t\t.. note:: This method is just an alias for ``db_connect(TRUE)``.\n\n\t.. php:method:: reconnect()\n\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tKeep / reestablish the database connection if no queries\n\t\thave been sent for a length of time exceeding the\n\t\tserver's idle timeout.\n\n\t.. php:method:: db_select([$database = ''])\n\n\t\t:param\tstring\t$database: Database name\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tSelect / switch the current database.\n\n\t.. php:method:: platform()\n\n\t\t:returns:\tPlatform name\n\t\t:rtype:\tstring\n\n\t\tThe name of the platform in use (mysql, mssql, etc...).\n\n\t.. php:method:: version()\n\n\t\t:returns:\tThe version of the database being used\n\t\t:rtype:\tstring\n\n\t\tDatabase version number.\n\n\t.. php:method:: query($sql[, $binds = FALSE[, $return_object = NULL]])\n\n\t\t:param\tstring\t$sql: The SQL statement to execute\n\t\t:param\tarray\t$binds: An array of binding data\n\t\t:param\tbool\t$return_object: Whether to return a result object or not\n\t\t:returns:\tTRUE for successful \"write-type\" queries, CI_DB_result instance (method chaining) on \"query\" success, FALSE on failure\n\t\t:rtype:\tmixed\n\n\t\tExecute an SQL query.\n\n\t\tAccepts an SQL string as input and returns a result object\n\t\tupon successful execution of a \"read\" type query.\n\n\t\tReturns:\n\n\t\t   - Boolean TRUE upon successful execution of a \"write type\" queries\n\t\t   - Boolean FALSE upon failure\n\t\t   - ``CI_DB_result`` object for \"read type\" queries\n\n\t\t.. note: If 'db_debug' setting is set to TRUE, an error\n\t\t\tpage will be displayed instead of returning FALSE\n\t\t\ton failures and script execution will stop.\n\n\t.. php:method:: simple_query($sql)\n\n\t\t:param\tstring\t$sql: The SQL statement to execute\n\t\t:returns:\tWhatever the underlying driver's \"query\" function returns\n\t\t:rtype:\tmixed\n\n\t\tA simplified version of the ``query()`` method, appropriate\n\t\tfor use when you don't need to get a result object or to\n\t\tjust send a query to the database and not care for the result.\n\n\t.. php:method:: affected_rows()\n\n\t\t:returns:\tNumber of rows affected\n\t\t:rtype:\tint\n\n\t\tReturns the number of rows *changed* by the last executed query.\n\n\t\tUseful for checking how much rows were created, updated or deleted\n\t\tduring the last executed query.\n\n\t.. php:method:: trans_strict([$mode = TRUE])\n\n\t\t:param\tbool\t$mode: Strict mode flag\n\t\t:rtype:\tvoid\n\n\t\tEnable/disable transaction \"strict\" mode.\n\n\t\tWhen strict mode is enabled, if you are running multiple\n\t\tgroups of transactions and one group fails, all subsequent\n\t\tgroups will be rolled back.\n\n\t\tIf strict mode is disabled, each group is treated\n\t\tautonomously, meaning a failure of one group will not\n\t\taffect any others.\n\n\t.. php:method:: trans_off()\n\n\t\t:rtype:\tvoid\n\n\t\tDisables transactions at run-time.\n\n\t.. php:method:: trans_start([$test_mode = FALSE])\n\n\t\t:param\tbool\t$test_mode: Test mode flag\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tStart a transaction.\n\n\t.. php:method:: trans_complete()\n\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tComplete Transaction.\n\n\t.. php:method:: trans_status()\n\n\t\t:returns:\tTRUE if the transaction succeeded, FALSE if it failed\n\t\t:rtype:\tbool\n\n\t\tLets you retrieve the transaction status flag to\n\t\tdetermine if it has failed.\n\t\t\n\t.. php:method:: trans_active()\n\n\t\t:returns:\tTRUE if a transaction is active, FALSE if not\n\t\t:rtype:\tbool\n\n\t\tDetermines if a transaction is currently active.\n\n\t.. php:method:: compile_binds($sql, $binds)\n\n\t\t:param\tstring\t$sql: The SQL statement \n\t\t:param\tarray\t$binds: An array of binding data\n\t\t:returns:\tThe updated SQL statement\n\t\t:rtype:\tstring\n\n\t\tCompiles an SQL query with the bind values passed for it.\n\n\t.. php:method:: is_write_type($sql)\n\n\t\t:param\tstring\t$sql: The SQL statement \n\t\t:returns:\tTRUE if the SQL statement is of \"write type\", FALSE if not\n\t\t:rtype:\tbool\n\n\t\tDetermines if a query is of a \"write\" type (such as\n\t\tINSERT, UPDATE, DELETE) or \"read\" type (i.e. SELECT).\n\n\t.. php:method:: elapsed_time([$decimals = 6])\n\n\t\t:param\tint\t$decimals: The number of decimal places\n\t\t:returns:\tThe aggregate query elapsed time, in microseconds\n\t\t:rtype:\tstring\n\n\t\tCalculate the aggregate query elapsed time.\n\n\t.. php:method:: total_queries()\n\n\t\t:returns:\tThe total number of queries executed\n\t\t:rtype:\tint\n\n\t\tReturns the total number of queries that have been\n\t\texecuted so far.\n\n\t.. php:method:: last_query()\n\n\t\t:returns:\tThe last query executed\n\t\t:rtype:\tstring\n\n\t\tReturns the last query that was executed.\n\n\t.. php:method:: escape($str)\n\n\t\t:param\tmixed\t$str: The value to escape, or an array of multiple ones\n\t\t:returns:\tThe escaped value(s)\n\t\t:rtype:\tmixed\n\n\t\tEscapes input data based on type, including boolean and\n\t\tNULLs.\n\n\t.. php:method:: escape_str($str[, $like = FALSE])\n\n\t\t:param\tmixed\t$str: A string value or array of multiple ones\n\t\t:param\tbool\t$like: Whether or not the string will be used in a LIKE condition\n\t\t:returns:\tThe escaped string(s)\n\t\t:rtype:\tmixed\n\n\t\tEscapes string values.\n\n\t\t.. warning:: The returned strings do NOT include quotes\n\t\t\taround them.\n\n\t.. php:method:: escape_like_str($str)\n\n\t\t:param\tmixed\t$str: A string value or array of multiple ones\n\t\t:returns:\tThe escaped string(s)\n\t\t:rtype:\tmixed\n\n\t\tEscape LIKE strings.\n\n\t\tSimilar to ``escape_str()``, but will also escape the ``%``\n\t\tand ``_`` wildcard characters, so that they don't cause\n\t\tfalse-positives in LIKE conditions.\n\n\t\t.. important:: The ``escape_like_str()`` method uses '!' (exclamation mark)\n\t\t\tto escape special characters for *LIKE* conditions. Because this\n\t\t\tmethod escapes partial strings that you would wrap in quotes\n\t\t\tyourself, it cannot automatically add the ``ESCAPE '!'``\n\t\t\tcondition for you, and so you'll have to manually do that.\n\n\n\t.. php:method:: primary($table)\n\n\t\t:param\tstring\t$table: Table name\n\t\t:returns:\tThe primary key name, FALSE if none\n\t\t:rtype:\tstring\n\n\t\tRetrieves the primary key of a table.\n\n\t\t.. note:: If the database platform does not support primary\n\t\t\tkey detection, the first column name may be assumed\n\t\t\tas the primary key.\n\n\t.. php:method:: count_all([$table = ''])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:returns:\tRow count for the specified table\n\t\t:rtype:\tint\n\n\t\tReturns the total number of rows in a table, or 0 if no\n\t\ttable was provided.\n\n\t.. php:method:: list_tables([$constrain_by_prefix = FALSE])\n\n\t\t:param\tbool\t$constrain_by_prefix: TRUE to match table names by the configured dbprefix\n\t\t:returns:\tArray of table names or FALSE on failure\n\t\t:rtype:\tarray\n\n\t\tGets a list of the tables in the current database.\n\n\t.. php:method:: table_exists($table_name)\n\n\t\t:param\tstring\t$table_name: The table name\n\t\t:returns:\tTRUE if that table exists, FALSE if not\n\t\t:rtype:\tbool\n\n\t\tDetermine if a particular table exists.\n\n\t.. php:method:: list_fields($table)\n\n\t\t:param\tstring\t$table: The table name\n\t\t:returns:\tArray of field names or FALSE on failure\n\t\t:rtype:\tarray\n\n\t\tGets a list of the field names in a table.\n\n\t.. php:method:: field_exists($field_name, $table_name)\n\n\t\t:param\tstring\t$table_name: The table name\n\t\t:param\tstring\t$field_name: The field name\n\t\t:returns:\tTRUE if that field exists in that table, FALSE if not\n\t\t:rtype:\tbool\n\n\t\tDetermine if a particular field exists.\n\n\t.. php:method:: field_data($table)\n\n\t\t:param\tstring\t$table: The table name\n\t\t:returns:\tArray of field data items or FALSE on failure\n\t\t:rtype:\tarray\n\n\t\tGets a list containing field data about a table.\n\n\t.. php:method:: escape_identifiers($item, $split = TRUE)\n\n\t\t:param\tmixed\t$item: The item or array of items to escape\n\t\t:param\tbool\t$split: Whether to split identifiers when a dot is encountered\n\t\t:returns:\tThe input item(s), escaped\n\t\t:rtype:\tmixed\n\n\t\tEscape SQL identifiers, such as column, table and names.\n\n\t.. php:method:: insert_string($table, $data)\n\n\t\t:param\tstring\t$table: The target table\n\t\t:param\tarray\t$data: An associative array of key/value pairs\n\t\t:returns:\tThe SQL INSERT statement, as a string\n\t\t:rtype:\tstring\n\n\t\tGenerate an INSERT statement string.\n\n\t.. php:method:: update_string($table, $data, $where)\n\n\t\t:param\tstring\t$table: The target table\n\t\t:param\tarray\t$data: An associative array of key/value pairs\n\t\t:param\tmixed\t$where: The WHERE statement conditions\n\t\t:returns:\tThe SQL UPDATE statement, as a string\n\t\t:rtype:\tstring\n\n\t\tGenerate an UPDATE statement string.\n\n\t.. php:method:: call_function($function)\n\n\t\t:param\tstring\t$function: Function name\n\t\t:returns:\tThe function result\n\t\t:rtype:\tstring\n\n\t\tRuns a native PHP function , using a platform agnostic\n\t\twrapper.\n\n\t.. php:method:: cache_set_path([$path = ''])\n\n\t\t:param\tstring\t$path: Path to the cache directory\n\t\t:rtype:\tvoid\n\n\t\tSets the directory path to use for caching storage.\n\n\t.. php:method:: cache_on()\n\n\t\t:returns:\tTRUE if caching is on, FALSE if not\n\t\t:rtype:\tbool\n\n\t\tEnable database results caching.\n\n\t.. php:method:: cache_off()\n\n\t\t:returns:\tTRUE if caching is on, FALSE if not\n\t\t:rtype:\tbool\n\n\t\tDisable database results caching.\n\n\t.. php:method:: cache_delete([$segment_one = ''[, $segment_two = '']])\n\n\t\t:param\tstring\t$segment_one: First URI segment\n\t\t:param\tstring\t$segment_two: Second URI segment\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tDelete the cache files associated with a particular URI.\n\n\t.. php:method:: cache_delete_all()\n\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tDelete all cache files.\n\n\t.. php:method:: close()\n\n\t\t:rtype:\tvoid\n\n\t\tClose the DB Connection.\n\n\t.. php:method:: display_error([$error = ''[, $swap = ''[, $native = FALSE]]])\n\n\t\t:param\tstring\t$error: The error message\n\t\t:param\tstring\t$swap: Any \"swap\" values\n\t\t:param\tbool\t$native: Whether to localize the message\n\t\t:rtype:\tvoid\n\n\t\t:returns:\tDisplays the DB error screensends the application/views/errors/error_db.php template\n                :rtype:\tstring\n\n\t\tDisplay an error message and stop script execution.\n\n\t\tThe message is displayed using the\n\t\t*application/views/errors/error_db.php* template.\n\n\t.. php:method:: protect_identifiers($item[, $prefix_single = FALSE[, $protect_identifiers = NULL[, $field_exists = TRUE]]])\n\n\t\t:param\tstring\t$item: The item to work with\n\t\t:param\tbool\t$prefix_single: Whether to apply the dbprefix even if the input item is a single identifier\n\t\t:param\tbool\t$protect_identifiers: Whether to quote identifiers\n\t\t:param\tbool\t$field_exists: Whether the supplied item contains a field name or not\n\t\t:returns:\tThe modified item\n\t\t:rtype:\tstring\n\n\t\tTakes a column or table name (optionally with an alias)\n\t\tand applies the configured *dbprefix* to it.\n\n\t\tSome logic is necessary in order to deal with\n\t\tcolumn names that include the path. \n\n\t\tConsider a query like this::\n\n\t\t\tSELECT * FROM hostname.database.table.column AS c FROM hostname.database.table\n\n\t\tOr a query with aliasing::\n\n\t\t\tSELECT m.member_id, m.member_name FROM members AS m\n\n\t\tSince the column name can include up to four segments\n\t\t(host, DB, table, column) or also have an alias prefix,\n\t\twe need to do a bit of work to figure this out and\n\t\tinsert the table prefix (if it exists) in the proper\n\t\tposition, and escape only the correct identifiers.\n\n\t\tThis method is used extensively by the Query Builder class.\n"
  },
  {
    "path": "user_guide_src/source/database/examples.rst",
    "content": "##################################\nDatabase Quick Start: Example Code\n##################################\n\nThe following page contains example code showing how the database class\nis used. For complete details please read the individual pages\ndescribing each function.\n\nInitializing the Database Class\n===============================\n\nThe following code loads and initializes the database class based on\nyour :doc:`configuration ` settings::\n\n\t$this->load->database();\n\nOnce loaded the class is ready to be used as described below.\n\nNote: If all your pages require database access you can connect\nautomatically. See the :doc:`connecting ` page for details.\n\nStandard Query With Multiple Results (Object Version)\n=====================================================\n\n::\n\n\t$query = $this->db->query('SELECT name, title, email FROM my_table');\n\t\n\tforeach ($query->result() as $row)\n\t{\n\t\techo $row->title;\n\t\techo $row->name;\n\t\techo $row->email;\n\t}\n\t\n\techo 'Total Results: ' . $query->num_rows();\n\nThe above result() function returns an array of **objects**. Example:\n$row->title\n\nStandard Query With Multiple Results (Array Version)\n====================================================\n\n::\n\n\t$query = $this->db->query('SELECT name, title, email FROM my_table');\n\t\n\tforeach ($query->result_array() as $row)\n\t{\n\t\techo $row['title'];\n\t\techo $row['name'];\n\t\techo $row['email'];\n\t}\n\nThe above result_array() function returns an array of standard array\nindexes. Example: $row['title']\n\nStandard Query With Single Result\n=================================\n\n::\n\n\t$query = $this->db->query('SELECT name FROM my_table LIMIT 1'); \n\t$row = $query->row();\n\techo $row->name;\n\nThe above row() function returns an **object**. Example: $row->name\n\nStandard Query With Single Result (Array version)\n=================================================\n\n::\n\n\t$query = $this->db->query('SELECT name FROM my_table LIMIT 1');\n\t$row = $query->row_array();\n\techo $row['name'];\n\nThe above row_array() function returns an **array**. Example:\n$row['name']\n\nStandard Insert\n===============\n\n::\n\n\t$sql = \"INSERT INTO mytable (title, name) VALUES (\".$this->db->escape($title).\", \".$this->db->escape($name).\")\";\n\t$this->db->query($sql);\n\techo $this->db->affected_rows();\n\nQuery Builder Query\n===================\n\nThe :doc:`Query Builder Pattern ` gives you a simplified\nmeans of retrieving data::\n\n\t$query = $this->db->get('table_name');\n\t\n\tforeach ($query->result() as $row)\n\t{\n\t\techo $row->title;\n\t}\n\nThe above get() function retrieves all the results from the supplied\ntable. The :doc:`Query Builder ` class contains a full\ncompliment of functions for working with data.\n\nQuery Builder Insert\n====================\n\n::\n\n\t$data = array(\n\t\t'title' => $title,\n\t\t'name' => $name,\n\t\t'date' => $date\n\t);\n\t\n\t$this->db->insert('mytable', $data);  // Produces: INSERT INTO mytable (title, name, date) VALUES ('{$title}', '{$name}', '{$date}')\n\n"
  },
  {
    "path": "user_guide_src/source/database/forge.rst",
    "content": "####################\nDatabase Forge Class\n####################\n\nThe Database Forge Class contains methods that help you manage your\ndatabase.\n\n.. contents:: Table of Contents\n    :depth: 3\n\n****************************\nInitializing the Forge Class\n****************************\n\n.. important:: In order to initialize the Forge class, your database\n\tdriver must already be running, since the forge class relies on it.\n\nLoad the Forge Class as follows::\n\n\t$this->load->dbforge()\n\nYou can also pass another database object to the DB Forge loader, in case\nthe database you want to manage isn't the default one::\n\n\t$this->myforge = $this->load->dbforge($this->other_db, TRUE);\n\nIn the above example, we're passing a custom database object as the first\nparameter and then tell it to return the dbforge object, instead of\nassigning it directly to ``$this->dbforge``.\n\n.. note:: Both of the parameters can be used individually, just pass an empty\n\tvalue as the first one if you wish to skip it.\n\nOnce initialized you will access the methods using the ``$this->dbforge``\nobject::\n\n\t$this->dbforge->some_method();\n\n*******************************\nCreating and Dropping Databases\n*******************************\n\n**$this->dbforge->create_database('db_name')**\n\nPermits you to create the database specified in the first parameter.\nReturns TRUE/FALSE based on success or failure::\n\n\tif ($this->dbforge->create_database('my_db'))\n\t{\n\t\techo 'Database created!';\n\t}\n\n**$this->dbforge->drop_database('db_name')**\n\nPermits you to drop the database specified in the first parameter.\nReturns TRUE/FALSE based on success or failure::\n\n\tif ($this->dbforge->drop_database('my_db'))\n\t{\n\t\techo 'Database deleted!';\n\t}\n\n\n****************************\nCreating and Dropping Tables\n****************************\n\nThere are several things you may wish to do when creating tables. Add\nfields, add keys to the table, alter columns. CodeIgniter provides a\nmechanism for this.\n\nAdding fields\n=============\n\nFields are created via an associative array. Within the array you must\ninclude a 'type' key that relates to the datatype of the field. For\nexample, INT, VARCHAR, TEXT, etc. Many datatypes (for example VARCHAR)\nalso require a 'constraint' key.\n\n::\n\n\t$fields = array(\n\t\t'users' => array(\n\t\t\t'type' => 'VARCHAR',\n\t\t\t'constraint' => '100',\n\t\t),\n\t);\n\t// will translate to \"users VARCHAR(100)\" when the field is added.\n\n\nAdditionally, the following key/values can be used:\n\n-  unsigned/true : to generate \"UNSIGNED\" in the field definition.\n-  default/value : to generate a default value in the field definition.\n-  null/true : to generate \"NULL\" in the field definition. Without this,\n   the field will default to \"NOT NULL\".\n-  auto_increment/true : generates an auto_increment flag on the\n   field. Note that the field type must be a type that supports this,\n   such as integer.\n-  unique/true : to generate a unique key for the field definition.\n\n::\n\n\t$fields = array(\n\t\t'blog_id' => array(\n\t\t\t'type' => 'INT',\n\t\t\t'constraint' => 5,\n\t\t\t'unsigned' => TRUE,\n\t\t\t'auto_increment' => TRUE\n\t\t),\n\t\t'blog_title' => array(\n\t\t\t'type' => 'VARCHAR',\n\t\t\t'constraint' => '100',\n\t\t\t'unique' => TRUE,\n\t\t),\n\t\t'blog_author' => array(\n\t\t\t'type' =>'VARCHAR',\n\t\t\t'constraint' => '100',\n\t\t\t'default' => 'King of Town',\n\t\t),\n\t\t'blog_description' => array(\n\t\t\t'type' => 'TEXT',\n\t\t\t'null' => TRUE,\n\t\t),\n\t);\n\n\nAfter the fields have been defined, they can be added using\n``$this->dbforge->add_field($fields);`` followed by a call to the\n``create_table()`` method.\n\n**$this->dbforge->add_field()**\n\nThe add fields method will accept the above array.\n\n\nPassing strings as fields\n-------------------------\n\nIf you know exactly how you want a field to be created, you can pass the\nstring into the field definitions with add_field()\n\n::\n\n\t$this->dbforge->add_field(\"label varchar(100) NOT NULL DEFAULT 'default label'\");\n\n\n.. note:: Passing raw strings as fields cannot be followed by ``add_key()`` calls on those fields.\n\n.. note:: Multiple calls to add_field() are cumulative.\n\nCreating an id field\n--------------------\n\nThere is a special exception for creating id fields. A field with type\nid will automatically be assigned as an INT(9) auto_incrementing\nPrimary Key.\n\n::\n\n\t$this->dbforge->add_field('id');\n\t// gives id INT(9) NOT NULL AUTO_INCREMENT\n\n\nAdding Keys\n===========\n\nGenerally speaking, you'll want your table to have Keys. This is\naccomplished with $this->dbforge->add_key('field'). An optional second\nparameter set to TRUE will make it a primary key. Note that add_key()\nmust be followed by a call to create_table().\n\nMultiple column non-primary keys must be sent as an array. Sample output\nbelow is for MySQL.\n\n::\n\n\t$this->dbforge->add_key('blog_id', TRUE);\n\t// gives PRIMARY KEY `blog_id` (`blog_id`)\n\n\t$this->dbforge->add_key('blog_id', TRUE);\n\t$this->dbforge->add_key('site_id', TRUE);\n\t// gives PRIMARY KEY `blog_id_site_id` (`blog_id`, `site_id`)\n\n\t$this->dbforge->add_key('blog_name');\n\t// gives KEY `blog_name` (`blog_name`)\n\n\t$this->dbforge->add_key(array('blog_name', 'blog_label'));\n\t// gives KEY `blog_name_blog_label` (`blog_name`, `blog_label`)\n\n\nCreating a table\n================\n\nAfter fields and keys have been declared, you can create a new table\nwith\n\n::\n\n\t$this->dbforge->create_table('table_name');\n\t// gives CREATE TABLE table_name\n\n\nAn optional second parameter set to TRUE adds an \"IF NOT EXISTS\" clause\ninto the definition\n\n::\n\n\t$this->dbforge->create_table('table_name', TRUE);\n\t// gives CREATE TABLE IF NOT EXISTS table_name\n\nYou could also pass optional table attributes, such as MySQL's ``ENGINE``::\n\n\t$attributes = array('ENGINE' => 'InnoDB');\n\t$this->dbforge->create_table('table_name', FALSE, $attributes);\n\t// produces: CREATE TABLE `table_name` (...) ENGINE = InnoDB DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci\n\n.. note:: Unless you specify the ``CHARACTER SET`` and/or ``COLLATE`` attributes,\n\t``create_table()`` will always add them with your configured *char_set*\n\tand *dbcollat* values, as long as they are not empty (MySQL only).\n\n\nDropping a table\n================\n\nExecute a DROP TABLE statement and optionally add an IF EXISTS clause.\n\n::\n\n\t// Produces: DROP TABLE table_name\n\t$this->dbforge->drop_table('table_name');\n\n\t// Produces: DROP TABLE IF EXISTS table_name\n\t$this->dbforge->drop_table('table_name',TRUE);\n\n\nRenaming a table\n================\n\nExecutes a TABLE rename\n\n::\n\n\t$this->dbforge->rename_table('old_table_name', 'new_table_name');\n\t// gives ALTER TABLE old_table_name RENAME TO new_table_name\n\n\n****************\nModifying Tables\n****************\n\nAdding a Column to a Table\n==========================\n\n**$this->dbforge->add_column()**\n\nThe ``add_column()`` method is used to modify an existing table. It\naccepts the same field array as above, and can be used for an unlimited\nnumber of additional fields.\n\n::\n\n\t$fields = array(\n\t\t'preferences' => array('type' => 'TEXT')\n\t);\n\t$this->dbforge->add_column('table_name', $fields);\n\t// Executes: ALTER TABLE table_name ADD preferences TEXT\n\nIf you are using MySQL or CUBIRD, then you can take advantage of their\nAFTER and FIRST clauses to position the new column.\n\nExamples::\n\n\t// Will place the new column after the `another_field` column:\n\t$fields = array(\n\t\t'preferences' => array('type' => 'TEXT', 'after' => 'another_field')\n\t);\n\n\t// Will place the new column at the start of the table definition:\n\t$fields = array(\n\t\t'preferences' => array('type' => 'TEXT', 'first' => TRUE)\n\t);\n\n\nDropping a Column From a Table\n==============================\n\n**$this->dbforge->drop_column()**\n\nUsed to remove a column from a table.\n\n::\n\n\t$this->dbforge->drop_column('table_name', 'column_to_drop');\n\n\n\nModifying a Column in a Table\n=============================\n\n**$this->dbforge->modify_column()**\n\nThe usage of this method is identical to ``add_column()``, except it\nalters an existing column rather than adding a new one. In order to\nchange the name you can add a \"name\" key into the field defining array.\n\n::\n\n\t$fields = array(\n\t\t'old_name' => array(\n\t\t\t'name' => 'new_name',\n\t\t\t'type' => 'TEXT',\n\t\t),\n\t);\n\t$this->dbforge->modify_column('table_name', $fields);\n\t// gives ALTER TABLE table_name CHANGE old_name new_name TEXT\n\n\n***************\nClass Reference\n***************\n\n.. php:class:: CI_DB_forge\n\n\t.. php:method:: add_column($table[, $field = array()])\n\n\t\t:param\tstring\t$table: Table name to add the column to\n\t\t:param\tarray\t$field: Column definition(s)\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tAdds a column to a table. Usage:  See `Adding a Column to a Table`_.\n\n\t.. php:method:: add_field($field)\n\n\t\t:param\tarray\t$field: Field definition to add\n\t\t:returns:\tCI_DB_forge instance (method chaining)\n\t\t:rtype:\tCI_DB_forge\n\n                Adds a field to the set that will be used to create a table. Usage:  See `Adding fields`_.\n\n\t.. php:method:: add_key($key[, $primary = FALSE])\n\n\t\t:param\tarray\t$key: Name of a key field\n\t\t:param\tbool\t$primary: Set to TRUE if it should be a primary key or a regular one\n\t\t:returns:\tCI_DB_forge instance (method chaining)\n\t\t:rtype:\tCI_DB_forge\n\n\t\tAdds a key to the set that will be used to create a table. Usage:  See `Adding Keys`_.\n\n\t.. php:method:: create_database($db_name)\n\n\t\t:param\tstring\t$db_name: Name of the database to create\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tCreates a new database. Usage:  See `Creating and Dropping Databases`_.\n\n\t.. php:method:: create_table($table[, $if_not_exists = FALSE[, array $attributes = array()]])\n\n\t\t:param\tstring\t$table: Name of the table to create\n\t\t:param\tstring\t$if_not_exists: Set to TRUE to add an 'IF NOT EXISTS' clause\n\t\t:param\tstring\t$attributes: An associative array of table attributes\n\t\t:returns:  TRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tCreates a new table. Usage:  See `Creating a table`_.\n\n\t.. php:method:: drop_column($table, $column_name)\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tstring\t$column_name: The column name to drop\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tDrops a column from a table. Usage:  See `Dropping a Column From a Table`_.\n\n\t.. php:method:: drop_database($db_name)\n\n\t\t:param\tstring\t$db_name: Name of the database to drop\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tDrops a database. Usage:  See `Creating and Dropping Databases`_.\n\n\t.. php:method:: drop_table($table_name[, $if_exists = FALSE])\n\n\t\t:param\tstring\t$table: Name of the table to drop\n\t\t:param\tstring\t$if_exists: Set to TRUE to add an 'IF EXISTS' clause\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tDrops a table. Usage:  See `Dropping a table`_.\n\n\t.. php:method:: modify_column($table, $field)\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tarray\t$field: Column definition(s)\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tModifies a table column. Usage:  See `Modifying a Column in a Table`_.\n\n\t.. php:method:: rename_table($table_name, $new_table_name)\n\n\t\t:param\tstring\t$table: Current of the table\n\t\t:param\tstring\t$new_table_name: New name of the table\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tRenames a table. Usage:  See `Renaming a table`_.\n"
  },
  {
    "path": "user_guide_src/source/database/helpers.rst",
    "content": "####################\nQuery Helper Methods\n####################\n\nInformation From Executing a Query\n==================================\n\n**$this->db->insert_id()**\n\nThe insert ID number when performing database inserts.\n\n.. note:: If using the PDO driver with PostgreSQL, or using the Interbase\n\tdriver, this function requires a $name parameter, which specifies the \n\tappropriate sequence to check for the insert id.\n\n**$this->db->affected_rows()**\n\nDisplays the number of affected rows, when doing \"write\" type queries\n(insert, update, etc.).\n\n.. note:: In MySQL \"DELETE FROM TABLE\" returns 0 affected rows. The database\n\tclass has a small hack that allows it to return the correct number of\n\taffected rows. By default this hack is enabled but it can be turned off\n\tin the database driver file.\n\n**$this->db->last_query()**\n\nReturns the last query that was run (the query string, not the result).\nExample::\n\n\t$str = $this->db->last_query();\n\t\n\t// Produces:  SELECT * FROM sometable....\n\n\n.. note:: Disabling the **save_queries** setting in your database\n\tconfiguration will render this function useless.\n\nInformation About Your Database\n===============================\n\n**$this->db->count_all()**\n\nPermits you to determine the number of rows in a particular table.\nSubmit the table name in the first parameter. Example::\n\n\techo $this->db->count_all('my_table');\n\t\n\t// Produces an integer, like 25\n\n**$this->db->platform()**\n\nOutputs the database platform you are running (MySQL, MS SQL, Postgres,\netc...)::\n\n\techo $this->db->platform();\n\n**$this->db->version()**\n\nOutputs the database version you are running::\n\n\techo $this->db->version();\n\nMaking Your Queries Easier\n==========================\n\n**$this->db->insert_string()**\n\nThis function simplifies the process of writing database inserts. It\nreturns a correctly formatted SQL insert string. Example::\n\n\t$data = array('name' => $name, 'email' => $email, 'url' => $url);\n\t\n\t$str = $this->db->insert_string('table_name', $data);\n\nThe first parameter is the table name, the second is an associative\narray with the data to be inserted. The above example produces::\n\n\tINSERT INTO table_name (name, email, url) VALUES ('Rick', 'rick@example.com', 'example.com')\n\n.. note:: Values are automatically escaped, producing safer queries.\n\n**$this->db->update_string()**\n\nThis function simplifies the process of writing database updates. It\nreturns a correctly formatted SQL update string. Example::\n\n\t$data = array('name' => $name, 'email' => $email, 'url' => $url);\n\t\n\t$where = \"author_id = 1 AND status = 'active'\";\n\t\n\t$str = $this->db->update_string('table_name', $data, $where);\n\nThe first parameter is the table name, the second is an associative\narray with the data to be updated, and the third parameter is the\n\"where\" clause. The above example produces::\n\n\t UPDATE table_name SET name = 'Rick', email = 'rick@example.com', url = 'example.com' WHERE author_id = 1 AND status = 'active'\n\n.. note:: Values are automatically escaped, producing safer queries."
  },
  {
    "path": "user_guide_src/source/database/index.rst",
    "content": "##################\nDatabase Reference\n##################\n\nCodeIgniter comes with a full-featured and very fast abstracted database\nclass that supports both traditional structures and Query Builder\npatterns. The database functions offer clear, simple syntax.\n\n.. toctree::\n\t:titlesonly:\n\t\n\tQuick Start: Usage Examples \n\tDatabase Configuration \n\tConnecting to a Database \n\tRunning Queries \n\tGenerating Query Results \n\tQuery Helper Functions \n\tQuery Builder Class \n\tTransactions \n\tGetting MetaData \n\tCustom Function Calls \n\tQuery Caching \n\tDatabase Manipulation with Database Forge \n\tDatabase Utilities Class \n\tDatabase Driver Reference "
  },
  {
    "path": "user_guide_src/source/database/metadata.rst",
    "content": "#################\nDatabase Metadata\n#################\n\n**************\nTable MetaData\n**************\n\nThese functions let you fetch table information.\n\nList the Tables in Your Database\n================================\n\n**$this->db->list_tables();**\n\nReturns an array containing the names of all the tables in the database\nyou are currently connected to. Example::\n\n\t$tables = $this->db->list_tables();\n\t\n\tforeach ($tables as $table)\n\t{\n\t\techo $table;\n\t}\n\n\nDetermine If a Table Exists\n===========================\n\n**$this->db->table_exists();**\n\nSometimes it's helpful to know whether a particular table exists before\nrunning an operation on it. Returns a boolean TRUE/FALSE. Usage example::\n\n\tif ($this->db->table_exists('table_name'))\n\t{\n\t\t// some code...\n\t}\n\n.. note:: Replace *table_name* with the name of the table you are looking for.\n\n\n**************\nField MetaData\n**************\n\nList the Fields in a Table\n==========================\n\n**$this->db->list_fields()**\n\nReturns an array containing the field names. This query can be called\ntwo ways:\n\n1. You can supply the table name and call it from the $this->db->\nobject::\n\n\t$fields = $this->db->list_fields('table_name');\n\t\n\tforeach ($fields as $field)\n\t{\n\t\techo $field;\n\t}\n\n2. You can gather the field names associated with any query you run by\ncalling the function from your query result object::\n\n\t$query = $this->db->query('SELECT * FROM some_table');\n\t\n\tforeach ($query->list_fields() as $field)\n\t{\n\t\techo $field;\n\t}\n\n\nDetermine If a Field is Present in a Table\n==========================================\n\n**$this->db->field_exists()**\n\nSometimes it's helpful to know whether a particular field exists before\nperforming an action. Returns a boolean TRUE/FALSE. Usage example::\n\n\tif ($this->db->field_exists('field_name', 'table_name'))\n\t{\n\t\t// some code...\n\t}\n\n.. note:: Replace *field_name* with the name of the column you are looking\n\tfor, and replace *table_name* with the name of the table you are\n\tlooking for.\n\n\nRetrieve Field Metadata\n=======================\n\n**$this->db->field_data()**\n\nReturns an array of objects containing field information.\n\nSometimes it's helpful to gather the field names or other metadata, like\nthe column type, max length, etc.\n\n.. note:: Not all databases provide meta-data.\n\nUsage example::\n\n\t$fields = $this->db->field_data('table_name');\n\t\n\tforeach ($fields as $field)\n\t{\n\t\techo $field->name;\n\t\techo $field->type;\n\t\techo $field->max_length;\n\t\techo $field->primary_key;\n\t}\n\nIf you have run a query already you can use the result object instead of\nsupplying the table name::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\t$fields = $query->field_data();\n\nThe following data is available from this function if supported by your\ndatabase:\n\n-  name - column name\n-  max_length - maximum length of the column\n-  primary_key - 1 if the column is a primary key\n-  type - the type of the column\n"
  },
  {
    "path": "user_guide_src/source/database/queries.rst",
    "content": "#######\nQueries\n#######\n\n************\nQuery Basics\n************\n\nRegular Queries\n===============\n\nTo submit a query, use the **query** function::\n\n\t$this->db->query('YOUR QUERY HERE');\n\nThe query() function returns a database result **object** when \"read\"\ntype queries are run, which you can use to :doc:`show your\nresults `. When \"write\" type queries are run it simply\nreturns TRUE or FALSE depending on success or failure. When retrieving\ndata you will typically assign the query to your own variable, like\nthis::\n\n\t$query = $this->db->query('YOUR QUERY HERE');\n\nSimplified Queries\n==================\n\nThe **simple_query** method is a simplified version of the \n$this->db->query() method. It DOES\nNOT return a database result set, nor does it set the query timer, or\ncompile bind data, or store your query for debugging. It simply lets you\nsubmit a query. Most users will rarely use this function.\n\nIt returns whatever the database drivers' \"execute\" function returns.\nThat typically is TRUE/FALSE on success or failure for write type queries\nsuch as INSERT, DELETE or UPDATE statements (which is what it really\nshould be used for) and a resource/object on success for queries with\nfetchable results.\n\n::\n\n\tif ($this->db->simple_query('YOUR QUERY'))\n\t{\n\t\techo \"Success!\";\n\t}\n\telse\n\t{\n\t\techo \"Query failed!\";\n\t}\n\n.. note:: PostgreSQL's ``pg_exec()`` function (for example) always\n\treturns a resource on success, even for write type queries.\n\tSo take that in mind if you're looking for a boolean value.\n\n***************************************\nWorking with Database prefixes manually\n***************************************\n\nIf you have configured a database prefix and would like to prepend it to\na table name for use in a native SQL query for example, then you can use\nthe following::\n\n\t$this->db->dbprefix('tablename'); // outputs prefix_tablename\n\n\nIf for any reason you would like to change the prefix programatically\nwithout needing to create a new connection, you can use this method::\n\n\t$this->db->set_dbprefix('newprefix_');\n\t$this->db->dbprefix('tablename'); // outputs newprefix_tablename\n\n\n**********************\nProtecting identifiers\n**********************\n\nIn many databases it is advisable to protect table and field names - for\nexample with backticks in MySQL. **Query Builder queries are\nautomatically protected**, however if you need to manually protect an\nidentifier you can use::\n\n\t$this->db->protect_identifiers('table_name');\n\n.. important:: Although the Query Builder will try its best to properly\n\tquote any field and table names that you feed it, note that it\n\tis NOT designed to work with arbitrary user input. DO NOT feed it\n\twith unsanitized user data.\n\nThis function will also add a table prefix to your table, assuming you\nhave a prefix specified in your database config file. To enable the\nprefixing set TRUE (boolean) via the second parameter::\n\n\t$this->db->protect_identifiers('table_name', TRUE);\n\n\n****************\nEscaping Queries\n****************\n\nIt's a very good security practice to escape your data before submitting\nit into your database. CodeIgniter has three methods that help you do\nthis:\n\n#. **$this->db->escape()** This function determines the data type so\n   that it can escape only string data. It also automatically adds\n   single quotes around the data so you don't have to:\n   ::\n\n\t$sql = \"INSERT INTO table (title) VALUES(\".$this->db->escape($title).\")\";\n\n#. **$this->db->escape_str()** This function escapes the data passed to\n   it, regardless of type. Most of the time you'll use the above\n   function rather than this one. Use the function like this:\n   ::\n\n\t$sql = \"INSERT INTO table (title) VALUES('\".$this->db->escape_str($title).\"')\";\n\n#. **$this->db->escape_like_str()** This method should be used when\n   strings are to be used in LIKE conditions so that LIKE wildcards\n   ('%', '\\_') in the string are also properly escaped.\n\n::\n\n        $search = '20% raise'; \n        $sql = \"SELECT id FROM table WHERE column LIKE '%\" .\n            $this->db->escape_like_str($search).\"%' ESCAPE '!'\";\n\n.. important:: The ``escape_like_str()`` method uses '!' (exclamation mark)\n\tto escape special characters for *LIKE* conditions. Because this\n\tmethod escapes partial strings that you would wrap in quotes\n\tyourself, it cannot automatically add the ``ESCAPE '!'``\n\tcondition for you, and so you'll have to manually do that.\n\n\n**************\nQuery Bindings\n**************\n\nBindings enable you to simplify your query syntax by letting the system\nput the queries together for you. Consider the following example::\n\n\t$sql = \"SELECT * FROM some_table WHERE id = ? AND status = ? AND author = ?\";\n\t$this->db->query($sql, array(3, 'live', 'Rick'));\n\nThe question marks in the query are automatically replaced with the\nvalues in the array in the second parameter of the query function.\n\nBinding also work with arrays, which will be transformed to IN sets::\n\n\t$sql = \"SELECT * FROM some_table WHERE id IN ? AND status = ? AND author = ?\";\n\t$this->db->query($sql, array(array(3, 6), 'live', 'Rick'));\n\nThe resulting query will be::\n\n\tSELECT * FROM some_table WHERE id IN (3,6) AND status = 'live' AND author = 'Rick'\n\nThe secondary benefit of using binds is that the values are\nautomatically escaped, producing safer queries. You don't have to\nremember to manually escape data; the engine does it automatically for\nyou.\n\n***************\nHandling Errors\n***************\n\n**$this->db->error();**\n\nIf you need to get the last error that has occurred, the error() method\nwill return an array containing its code and message. Here's a quick\nexample::\n\n\tif ( ! $this->db->simple_query('SELECT `example_field` FROM `example_table`'))\n\t{\n\t\t$error = $this->db->error(); // Has keys 'code' and 'message'\n\t}\n\n"
  },
  {
    "path": "user_guide_src/source/database/query_builder.rst",
    "content": "###################\nQuery Builder Class\n###################\n\nCodeIgniter gives you access to a Query Builder class. This pattern\nallows information to be retrieved, inserted, and updated in your\ndatabase with minimal scripting. In some cases only one or two lines\nof code are necessary to perform a database action.\nCodeIgniter does not require that each database table be its own class\nfile. It instead provides a more simplified interface.\n\nBeyond simplicity, a major benefit to using the Query Builder features\nis that it allows you to create database independent applications, since\nthe query syntax is generated by each database adapter. It also allows\nfor safer queries, since the values are escaped automatically by the\nsystem.\n\n.. note:: If you intend to write your own queries you can disable this\n\tclass in your database config file, allowing the core database library\n\tand adapter to utilize fewer resources.\n\n.. contents::\n    :local:\n    :depth: 1\n\n**************\nSelecting Data\n**************\n\nThe following functions allow you to build SQL **SELECT** statements.\n\n**$this->db->get()**\n\nRuns the selection query and returns the result. Can be used by itself\nto retrieve all records from a table::\n\n\t$query = $this->db->get('mytable');  // Produces: SELECT * FROM mytable\n\nThe second and third parameters enable you to set a limit and offset\nclause::\n\n\t$query = $this->db->get('mytable', 10, 20);\n\n\t// Executes: SELECT * FROM mytable LIMIT 20, 10\n\t// (in MySQL. Other databases have slightly different syntax)\n\nYou'll notice that the above function is assigned to a variable named\n$query, which can be used to show the results::\n\n\t$query = $this->db->get('mytable');\n\n\tforeach ($query->result() as $row)\n\t{\n\t\techo $row->title;\n\t}\n\nPlease visit the :doc:`result functions ` page for a full\ndiscussion regarding result generation.\n\n**$this->db->get_compiled_select()**\n\nCompiles the selection query just like **$this->db->get()** but does not *run*\nthe query. This method simply returns the SQL query as a string.\n\nExample::\n\n\t$sql = $this->db->get_compiled_select('mytable');\n\techo $sql;\n\n\t// Prints string: SELECT * FROM mytable\n\nThe second parameter enables you to set whether or not the query builder query\nwill be reset (by default it will be reset, just like when using `$this->db->get()`)::\n\n\techo $this->db->limit(10,20)->get_compiled_select('mytable', FALSE);\n\n\t// Prints string: SELECT * FROM mytable LIMIT 20, 10\n\t// (in MySQL. Other databases have slightly different syntax)\n\n\techo $this->db->select('title, content, date')->get_compiled_select();\n\n\t// Prints string: SELECT title, content, date FROM mytable LIMIT 20, 10\n\nThe key thing to notice in the above example is that the second query did not\nutilize **$this->db->from()** and did not pass a table name into the first\nparameter. The reason for this outcome is because the query has not been\nexecuted using **$this->db->get()** which resets values or reset directly\nusing **$this->db->reset_query()**.\n\n**$this->db->get_where()**\n\nIdentical to the above function except that it permits you to add a\n\"where\" clause in the second parameter, instead of using the db->where()\nfunction::\n\n\t$query = $this->db->get_where('mytable', array('id' => $id), $limit, $offset);\n\nPlease read the about the where function below for more information.\n\n.. note:: get_where() was formerly known as getwhere(), which has been removed\n\n**$this->db->select()**\n\nPermits you to write the SELECT portion of your query::\n\n\t$this->db->select('title, content, date');\n\t$query = $this->db->get('mytable');\n\n\t// Executes: SELECT title, content, date FROM mytable\n\n.. note:: If you are selecting all (\\*) from a table you do not need to\n\tuse this function. When omitted, CodeIgniter assumes that you wish\n\tto select all fields and automatically adds 'SELECT \\*'.\n\n``$this->db->select()`` accepts an optional second parameter. If you set it\nto FALSE, CodeIgniter will not try to protect your field or table names.\nThis is useful if you need a compound select statement where automatic\nescaping of fields may break them.\n\n::\n\n\t$this->db->select('(SELECT SUM(payments.amount) FROM payments WHERE payments.invoice_id=4) AS amount_paid', FALSE);\n\t$query = $this->db->get('mytable');\n\n**$this->db->select_max()**\n\nWrites a ``SELECT MAX(field)`` portion for your query. You can optionally\ninclude a second parameter to rename the resulting field.\n\n::\n\n\t$this->db->select_max('age');\n\t$query = $this->db->get('members');  // Produces: SELECT MAX(age) as age FROM members\n\n\t$this->db->select_max('age', 'member_age');\n\t$query = $this->db->get('members'); // Produces: SELECT MAX(age) as member_age FROM members\n\n\n**$this->db->select_min()**\n\nWrites a \"SELECT MIN(field)\" portion for your query. As with\nselect_max(), You can optionally include a second parameter to rename\nthe resulting field.\n\n::\n\n\t$this->db->select_min('age');\n\t$query = $this->db->get('members'); // Produces: SELECT MIN(age) as age FROM members\n\n\n**$this->db->select_avg()**\n\nWrites a \"SELECT AVG(field)\" portion for your query. As with\nselect_max(), You can optionally include a second parameter to rename\nthe resulting field.\n\n::\n\n\t$this->db->select_avg('age');\n\t$query = $this->db->get('members'); // Produces: SELECT AVG(age) as age FROM members\n\n\n**$this->db->select_sum()**\n\nWrites a \"SELECT SUM(field)\" portion for your query. As with\nselect_max(), You can optionally include a second parameter to rename\nthe resulting field.\n\n::\n\n\t$this->db->select_sum('age');\n\t$query = $this->db->get('members'); // Produces: SELECT SUM(age) as age FROM members\n\n**$this->db->from()**\n\nPermits you to write the FROM portion of your query::\n\n\t$this->db->select('title, content, date');\n\t$this->db->from('mytable');\n\t$query = $this->db->get();  // Produces: SELECT title, content, date FROM mytable\n\n.. note:: As shown earlier, the FROM portion of your query can be specified\n\tin the $this->db->get() function, so use whichever method you prefer.\n\n**$this->db->join()**\n\nPermits you to write the JOIN portion of your query::\n\n\t$this->db->select('*');\n\t$this->db->from('blogs');\n\t$this->db->join('comments', 'comments.id = blogs.id');\n\t$query = $this->db->get();\n\n\t// Produces:\n\t// SELECT * FROM blogs JOIN comments ON comments.id = blogs.id\n\nMultiple function calls can be made if you need several joins in one\nquery.\n\nIf you need a specific type of JOIN you can specify it via the third\nparameter of the function. Options are: left, right, outer, inner, left\nouter, right outer and full outer.\n\n::\n\n\t$this->db->join('comments', 'comments.id = blogs.id', 'left');\n\t// Produces: LEFT JOIN comments ON comments.id = blogs.id\n\n*************************\nLooking for Specific Data\n*************************\n\n**$this->db->where()**\n\nThis function enables you to set **WHERE** clauses using one of four\nmethods:\n\n.. note:: All values passed to this function are escaped automatically,\n\tproducing safer queries.\n\n#. **Simple key/value method:**\n\n\t::\n\n\t\t$this->db->where('name', $name); // Produces: WHERE name = 'Joe'\n\n\tNotice that the equal sign is added for you.\n\n\tIf you use multiple function calls they will be chained together with\n\tAND between them:\n\n\t::\n\n\t\t$this->db->where('name', $name);\n\t\t$this->db->where('title', $title);\n\t\t$this->db->where('status', $status);\n\t\t// WHERE name = 'Joe' AND title = 'boss' AND status = 'active'\n\n#. **Custom key/value method:**\n\n\tYou can include an operator in the first parameter in order to\n\tcontrol the comparison:\n\n\t::\n\n\t\t$this->db->where('name !=', $name);\n\t\t$this->db->where('id <', $id); // Produces: WHERE name != 'Joe' AND id < 45\n\n#. **Associative array method:**\n\n\t::\n\n\t\t$array = array('name' => $name, 'title' => $title, 'status' => $status);\n\t\t$this->db->where($array);\n\t\t// Produces: WHERE name = 'Joe' AND title = 'boss' AND status = 'active'\n\n\tYou can include your own operators using this method as well:\n\n\t::\n\n\t\t$array = array('name !=' => $name, 'id <' => $id, 'date >' => $date);\n\t\t$this->db->where($array);\n\n#. **Custom string:**\n\tYou can write your own clauses manually::\n\n\t\t$where = \"name='Joe' AND status='boss' OR status='active'\";\n\t\t$this->db->where($where);\n\n\n``$this->db->where()`` accepts an optional third parameter. If you set it to\nFALSE, CodeIgniter will not try to protect your field or table names.\n\n::\n\n\t$this->db->where('MATCH (field) AGAINST (\"value\")', NULL, FALSE);\n\n**$this->db->or_where()**\n\nThis function is identical to the one above, except that multiple\ninstances are joined by OR::\n\n\t$this->db->where('name !=', $name);\n\t$this->db->or_where('id >', $id);  // Produces: WHERE name != 'Joe' OR id > 50\n\n.. note:: or_where() was formerly known as orwhere(), which has been\n\tremoved.\n\n**$this->db->where_in()**\n\nGenerates a WHERE field IN ('item', 'item') SQL query joined with AND if\nappropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->where_in('username', $names);\n\t// Produces: WHERE username IN ('Frank', 'Todd', 'James')\n\n\n**$this->db->or_where_in()**\n\nGenerates a WHERE field IN ('item', 'item') SQL query joined with OR if\nappropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->or_where_in('username', $names);\n\t// Produces: OR username IN ('Frank', 'Todd', 'James')\n\n**$this->db->where_not_in()**\n\nGenerates a WHERE field NOT IN ('item', 'item') SQL query joined with\nAND if appropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->where_not_in('username', $names);\n\t// Produces: WHERE username NOT IN ('Frank', 'Todd', 'James')\n\n\n**$this->db->or_where_not_in()**\n\nGenerates a WHERE field NOT IN ('item', 'item') SQL query joined with OR\nif appropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->or_where_not_in('username', $names);\n\t// Produces: OR username NOT IN ('Frank', 'Todd', 'James')\n\n************************\nLooking for Similar Data\n************************\n\n**$this->db->like()**\n\nThis method enables you to generate **LIKE** clauses, useful for doing\nsearches.\n\n.. note:: All values passed to this method are escaped automatically.\n\n#. **Simple key/value method:**\n\n\t::\n\n\t\t$this->db->like('title', 'match');\n\t\t// Produces: WHERE `title` LIKE '%match%' ESCAPE '!'\n\n\tIf you use multiple method calls they will be chained together with\n\tAND between them::\n\n\t\t$this->db->like('title', 'match');\n\t\t$this->db->like('body', 'match');\n\t\t// WHERE `title` LIKE '%match%' ESCAPE '!' AND  `body` LIKE '%match% ESCAPE '!'\n\n\tIf you want to control where the wildcard (%) is placed, you can use\n\tan optional third argument. Your options are 'before', 'after', 'none' and\n\t'both' (which is the default).\n\n\t::\n\n\t\t$this->db->like('title', 'match', 'before');\t// Produces: WHERE `title` LIKE '%match' ESCAPE '!'\n\t\t$this->db->like('title', 'match', 'after');\t// Produces: WHERE `title` LIKE 'match%' ESCAPE '!'\n\t\t$this->db->like('title', 'match', 'none');\t// Produces: WHERE `title` LIKE 'match' ESCAPE '!'\n\t\t$this->db->like('title', 'match', 'both');\t// Produces: WHERE `title` LIKE '%match%' ESCAPE '!'\n\n#. **Associative array method:**\n\n\t::\n\n\t\t$array = array('title' => $match, 'page1' => $match, 'page2' => $match);\n\t\t$this->db->like($array);\n\t\t// WHERE `title` LIKE '%match%' ESCAPE '!' AND  `page1` LIKE '%match%' ESCAPE '!' AND  `page2` LIKE '%match%' ESCAPE '!'\n\n\n**$this->db->or_like()**\n\nThis method is identical to the one above, except that multiple\ninstances are joined by OR::\n\n\t$this->db->like('title', 'match'); $this->db->or_like('body', $match);\n\t// WHERE `title` LIKE '%match%' ESCAPE '!' OR  `body` LIKE '%match%' ESCAPE '!'\n\n.. note:: ``or_like()`` was formerly known as ``orlike()``, which has been removed.\n\n**$this->db->not_like()**\n\nThis method is identical to ``like()``, except that it generates\nNOT LIKE statements::\n\n\t$this->db->not_like('title', 'match');\t// WHERE `title` NOT LIKE '%match% ESCAPE '!'\n\n**$this->db->or_not_like()**\n\nThis method is identical to ``not_like()``, except that multiple\ninstances are joined by OR::\n\n\t$this->db->like('title', 'match');\n\t$this->db->or_not_like('body', 'match');\n\t// WHERE `title` LIKE '%match% OR  `body` NOT LIKE '%match%' ESCAPE '!'\n\n**$this->db->group_by()**\n\nPermits you to write the GROUP BY portion of your query::\n\n\t$this->db->group_by(\"title\"); // Produces: GROUP BY title\n\nYou can also pass an array of multiple values as well::\n\n\t$this->db->group_by(array(\"title\", \"date\"));  // Produces: GROUP BY title, date\n\n.. note:: group_by() was formerly known as groupby(), which has been\n\tremoved.\n\n**$this->db->distinct()**\n\nAdds the \"DISTINCT\" keyword to a query\n\n::\n\n\t$this->db->distinct();\n\t$this->db->get('table'); // Produces: SELECT DISTINCT * FROM table\n\n**$this->db->having()**\n\nPermits you to write the HAVING portion of your query. There are 2\npossible syntaxes, 1 argument or 2::\n\n\t$this->db->having('user_id = 45');  // Produces: HAVING user_id = 45\n\t$this->db->having('user_id',  45);  // Produces: HAVING user_id = 45\n\nYou can also pass an array of multiple values as well::\n\n\t$this->db->having(array('title =' => 'My Title', 'id <' => $id));\n\t// Produces: HAVING title = 'My Title', id < 45\n\n\nIf you are using a database that CodeIgniter escapes queries for, you\ncan prevent escaping content by passing an optional third argument, and\nsetting it to FALSE.\n\n::\n\n\t$this->db->having('user_id',  45);  // Produces: HAVING `user_id` = 45 in some databases such as MySQL\n\t$this->db->having('user_id',  45, FALSE);  // Produces: HAVING user_id = 45\n\n\n**$this->db->or_having()**\n\nIdentical to having(), only separates multiple clauses with \"OR\".\n\n**$this->db->having_in()**\n\nGenerates a HAVING field IN ('item', 'item') SQL query joined with AND if\nappropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->having_in('username', $names);\n\t// Produces: HAVING username IN ('Frank', 'Todd', 'James')\n\n\n**$this->db->or_having_in()**\n\nGenerates a HAVING field IN ('item', 'item') SQL query joined with OR if\nappropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->or_having_in('username', $names);\n\t// Produces: OR username IN ('Frank', 'Todd', 'James')\n\n**$this->db->having_not_in()**\n\nGenerates a HAVING field NOT IN ('item', 'item') SQL query joined with\nAND if appropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->having_not_in('username', $names);\n\t// Produces: HAVING username NOT IN ('Frank', 'Todd', 'James')\n\n\n**$this->db->or_having_not_in()**\n\nGenerates a HAVING field NOT IN ('item', 'item') SQL query joined with OR\nif appropriate\n\n::\n\n\t$names = array('Frank', 'Todd', 'James');\n\t$this->db->or_having_not_in('username', $names);\n\t// Produces: OR username NOT IN ('Frank', 'Todd', 'James')\n\n****************\nOrdering results\n****************\n\n**$this->db->order_by()**\n\nLets you set an ORDER BY clause.\n\nThe first parameter contains the name of the column you would like to order by.\n\nThe second parameter lets you set the direction of the result.\nOptions are **ASC**, **DESC** AND **RANDOM**.\n\n::\n\n\t$this->db->order_by('title', 'DESC');\n\t// Produces: ORDER BY `title` DESC\n\nYou can also pass your own string in the first parameter::\n\n\t$this->db->order_by('title DESC, name ASC');\n\t// Produces: ORDER BY `title` DESC, `name` ASC\n\nOr multiple function calls can be made if you need multiple fields.\n\n::\n\n\t$this->db->order_by('title', 'DESC');\n\t$this->db->order_by('name', 'ASC');\n\t// Produces: ORDER BY `title` DESC, `name` ASC\n\nIf you choose the **RANDOM** direction option, then the first parameters will\nbe ignored, unless you specify a numeric seed value.\n\n::\n\n\t$this->db->order_by('title', 'RANDOM');\n\t// Produces: ORDER BY RAND()\n\n\t$this->db->order_by(42, 'RANDOM');\n\t// Produces: ORDER BY RAND(42)\n\n.. note:: order_by() was formerly known as orderby(), which has been\n\tremoved.\n\n.. note:: Random ordering is not currently supported in Oracle and\n\twill default to ASC instead.\n\n****************************\nLimiting or Counting Results\n****************************\n\n**$this->db->limit()**\n\nLets you limit the number of rows you would like returned by the query::\n\n\t$this->db->limit(10);  // Produces: LIMIT 10\n\nThe second parameter lets you set a result offset.\n\n::\n\n\t$this->db->limit(10, 20);  // Produces: LIMIT 20, 10 (in MySQL.  Other databases have slightly different syntax)\n\n**$this->db->count_all_results()**\n\nPermits you to determine the number of rows in a particular Active\nRecord query. Queries will accept Query Builder restrictors such as\n``where()``, ``or_where()``, ``like()``, ``or_like()``, etc. Example::\n\n\techo $this->db->count_all_results('my_table');  // Produces an integer, like 25\n\t$this->db->like('title', 'match');\n\t$this->db->from('my_table');\n\techo $this->db->count_all_results(); // Produces an integer, like 17\n\nHowever, this method also resets any field values that you may have passed\nto ``select()``. If you need to keep them, you can pass ``FALSE`` as the\nsecond parameter::\n\n\techo $this->db->count_all_results('my_table', FALSE);\n\n**$this->db->count_all()**\n\nPermits you to determine the number of rows in a particular table.\nSubmit the table name in the first parameter. Example::\n\n\techo $this->db->count_all('my_table');  // Produces an integer, like 25\n\n**************\nQuery grouping\n**************\n\nQuery grouping allows you to create groups of WHERE clauses by enclosing them in parentheses. This will allow\nyou to create queries with complex WHERE clauses. Nested groups are supported. Example::\n\n\t$this->db->select('*')->from('my_table')\n\t\t->group_start()\n\t\t\t->where('a', 'a')\n\t\t\t->or_group_start()\n\t\t\t\t->where('b', 'b')\n\t\t\t\t->where('c', 'c')\n\t\t\t->group_end()\n\t\t->group_end()\n\t\t->where('d', 'd')\n\t->get();\n\n\t// Generates:\n\t// SELECT * FROM (`my_table`) WHERE ( `a` = 'a' OR ( `b` = 'b' AND `c` = 'c' ) ) AND `d` = 'd'\n\n.. note:: groups need to be balanced, make sure every group_start() is matched by a group_end().\n\n**$this->db->group_start()**\n\nStarts a new group by adding an opening parenthesis to the WHERE clause of the query.\n\n**$this->db->or_group_start()**\n\nStarts a new group by adding an opening parenthesis to the WHERE clause of the query, prefixing it with 'OR'.\n\n**$this->db->not_group_start()**\n\nStarts a new group by adding an opening parenthesis to the WHERE clause of the query, prefixing it with 'NOT'.\n\n**$this->db->or_not_group_start()**\n\nStarts a new group by adding an opening parenthesis to the WHERE clause of the query, prefixing it with 'OR NOT'.\n\n**$this->db->group_end()**\n\nEnds the current group by adding an closing parenthesis to the WHERE clause of the query.\n\n**************\nInserting Data\n**************\n\n**$this->db->insert()**\n\nGenerates an insert string based on the data you supply, and runs the\nquery. You can either pass an **array** or an **object** to the\nfunction. Here is an example using an array::\n\n\t$data = array(\n\t\t'title' => 'My title',\n\t\t'name' => 'My Name',\n\t\t'date' => 'My date'\n\t);\n\n\t$this->db->insert('mytable', $data);\n\t// Produces: INSERT INTO mytable (title, name, date) VALUES ('My title', 'My name', 'My date')\n\nThe first parameter will contain the table name, the second is an\nassociative array of values.\n\nHere is an example using an object::\n\n\t/*\n\tclass Myclass {\n\t\tpublic $title = 'My Title';\n\t\tpublic $content = 'My Content';\n\t\tpublic $date = 'My Date';\n\t}\n\t*/\n\n\t$object = new Myclass;\n\t$this->db->insert('mytable', $object);\n\t// Produces: INSERT INTO mytable (title, content, date) VALUES ('My Title', 'My Content', 'My Date')\n\nThe first parameter will contain the table name, the second is an\nobject.\n\n.. note:: All values are escaped automatically producing safer queries.\n\n**$this->db->get_compiled_insert()**\n\nCompiles the insertion query just like $this->db->insert() but does not\n*run* the query. This method simply returns the SQL query as a string.\n\nExample::\n\n\t$data = array(\n\t\t'title' => 'My title',\n\t\t'name'  => 'My Name',\n\t\t'date'  => 'My date'\n\t);\n\n\t$sql = $this->db->set($data)->get_compiled_insert('mytable');\n\techo $sql;\n\n\t// Produces string: INSERT INTO mytable (`title`, `name`, `date`) VALUES ('My title', 'My name', 'My date')\n\nThe second parameter enables you to set whether or not the query builder query\nwill be reset (by default it will be--just like $this->db->insert())::\n\n\techo $this->db->set('title', 'My Title')->get_compiled_insert('mytable', FALSE);\n\n\t// Produces string: INSERT INTO mytable (`title`) VALUES ('My Title')\n\n\techo $this->db->set('content', 'My Content')->get_compiled_insert();\n\n\t// Produces string: INSERT INTO mytable (`title`, `content`) VALUES ('My Title', 'My Content')\n\nThe key thing to notice in the above example is that the second query did not\nutilize `$this->db->from()` nor did it pass a table name into the first\nparameter. The reason this worked is because the query has not been executed\nusing `$this->db->insert()` which resets values or reset directly using\n`$this->db->reset_query()`.\n\n.. note:: This method doesn't work for batched inserts.\n\n**$this->db->insert_batch()**\n\nGenerates an insert string based on the data you supply, and runs the\nquery. You can either pass an **array** or an **object** to the\nfunction. Here is an example using an array::\n\n\t$data = array(\n\t\tarray(\n\t\t\t'title' => 'My title',\n\t\t\t'name' => 'My Name',\n\t\t\t'date' => 'My date'\n\t\t),\n\t\tarray(\n\t\t\t'title' => 'Another title',\n\t\t\t'name' => 'Another Name',\n\t\t\t'date' => 'Another date'\n\t\t)\n\t);\n\n\t$this->db->insert_batch('mytable', $data);\n\t// Produces: INSERT INTO mytable (title, name, date) VALUES ('My title', 'My name', 'My date'),  ('Another title', 'Another name', 'Another date')\n\nThe first parameter will contain the table name, the second is an\nassociative array of values.\n\n.. note:: All values are escaped automatically producing safer queries.\n\n*************\nUpdating Data\n*************\n\n**$this->db->replace()**\n\nThis method executes a REPLACE statement, which is basically the SQL\nstandard for (optional) DELETE + INSERT, using *PRIMARY* and *UNIQUE*\nkeys as the determining factor.\nIn our case, it will save you from the need to implement complex\nlogics with different combinations of  ``select()``, ``update()``,\n``delete()`` and ``insert()`` calls.\n\nExample::\n\n\t$data = array(\n\t\t'title' => 'My title',\n\t\t'name'  => 'My Name',\n\t\t'date'  => 'My date'\n\t);\n\n\t$this->db->replace('table', $data);\n\n\t// Executes: REPLACE INTO mytable (title, name, date) VALUES ('My title', 'My name', 'My date')\n\nIn the above example, if we assume that the *title* field is our primary\nkey, then if a row containing 'My title' as the *title* value, that row\nwill be deleted with our new row data replacing it.\n\nUsage of the ``set()`` method is also allowed and all fields are\nautomatically escaped, just like with ``insert()``.\n\n**$this->db->set()**\n\nThis function enables you to set values for inserts or updates.\n\n**It can be used instead of passing a data array directly to the insert\nor update functions:**\n\n::\n\n\t$this->db->set('name', $name);\n\t$this->db->insert('mytable');  // Produces: INSERT INTO mytable (`name`) VALUES ('{$name}')\n\nIf you use multiple function called they will be assembled properly\nbased on whether you are doing an insert or an update::\n\n\t$this->db->set('name', $name);\n\t$this->db->set('title', $title);\n\t$this->db->set('status', $status);\n\t$this->db->insert('mytable');\n\n**set()** will also accept an optional third parameter (``$escape``), that\nwill prevent data from being escaped if set to FALSE. To illustrate the\ndifference, here is ``set()`` used both with and without the escape\nparameter.\n\n::\n\n\t$this->db->set('field', 'field+1', FALSE);\n\t$this->db->where('id', 2);\n\t$this->db->update('mytable'); // gives UPDATE mytable SET field = field+1 WHERE id = 2\n\n\t$this->db->set('field', 'field+1');\n\t$this->db->where('id', 2);\n\t$this->db->update('mytable'); // gives UPDATE `mytable` SET `field` = 'field+1' WHERE `id` = 2\n\nYou can also pass an associative array to this function::\n\n\t$array = array(\n\t\t'name' => $name,\n\t\t'title' => $title,\n\t\t'status' => $status\n\t);\n\n\t$this->db->set($array);\n\t$this->db->insert('mytable');\n\nOr an object::\n\n\t/*\n\tclass Myclass {\n\t\tpublic $title = 'My Title';\n\t\tpublic $content = 'My Content';\n\t\tpublic $date = 'My Date';\n\t}\n\t*/\n\n\t$object = new Myclass;\n\t$this->db->set($object);\n\t$this->db->insert('mytable');\n\n**$this->db->update()**\n\nGenerates an update string and runs the query based on the data you\nsupply. You can pass an **array** or an **object** to the function. Here\nis an example using an array::\n\n\t$data = array(\n\t\t'title' => $title,\n\t\t'name' => $name,\n\t\t'date' => $date\n\t);\n\n\t$this->db->where('id', $id);\n\t$this->db->update('mytable', $data);\n\t// Produces:\n\t//\n\t//\tUPDATE mytable\n\t//\tSET title = '{$title}', name = '{$name}', date = '{$date}'\n\t//\tWHERE id = $id\n\nOr you can supply an object::\n\n\t/*\n\tclass Myclass {\n\t\tpublic $title = 'My Title';\n\t\tpublic $content = 'My Content';\n\t\tpublic $date = 'My Date';\n\t}\n\t*/\n\n\t$object = new Myclass;\n\t$this->db->where('id', $id);\n\t$this->db->update('mytable', $object);\n\t// Produces:\n\t//\n\t// UPDATE `mytable`\n\t// SET `title` = '{$title}', `name` = '{$name}', `date` = '{$date}'\n\t// WHERE id = `$id`\n\n.. note:: All values are escaped automatically producing safer queries.\n\nYou'll notice the use of the $this->db->where() function, enabling you\nto set the WHERE clause. You can optionally pass this information\ndirectly into the update function as a string::\n\n\t$this->db->update('mytable', $data, \"id = 4\");\n\nOr as an array::\n\n\t$this->db->update('mytable', $data, array('id' => $id));\n\nYou may also use the $this->db->set() function described above when\nperforming updates.\n\n**$this->db->update_batch()**\n\nGenerates an update string based on the data you supply, and runs the query.\nYou can either pass an **array** or an **object** to the function.\nHere is an example using an array::\n\n\t$data = array(\n\t   array(\n\t      'title' => 'My title' ,\n\t      'name' => 'My Name 2' ,\n\t      'date' => 'My date 2'\n\t   ),\n\t   array(\n\t      'title' => 'Another title' ,\n\t      'name' => 'Another Name 2' ,\n\t      'date' => 'Another date 2'\n\t   )\n\t);\n\n\t$this->db->update_batch('mytable', $data, 'title');\n\n\t// Produces:\n\t// UPDATE `mytable` SET `name` = CASE\n\t// WHEN `title` = 'My title' THEN 'My Name 2'\n\t// WHEN `title` = 'Another title' THEN 'Another Name 2'\n\t// ELSE `name` END,\n\t// `date` = CASE\n\t// WHEN `title` = 'My title' THEN 'My date 2'\n\t// WHEN `title` = 'Another title' THEN 'Another date 2'\n\t// ELSE `date` END\n\t// WHERE `title` IN ('My title','Another title')\n\nThe first parameter will contain the table name, the second is an associative\narray of values, the third parameter is the where key.\n\n.. note:: All values are escaped automatically producing safer queries.\n\n.. note:: ``affected_rows()`` won't give you proper results with this method,\n\tdue to the very nature of how it works. Instead, ``update_batch()``\n\treturns the number of rows affected.\n\n**$this->db->get_compiled_update()**\n\nThis works exactly the same way as ``$this->db->get_compiled_insert()`` except\nthat it produces an UPDATE SQL string instead of an INSERT SQL string.\n\nFor more information view documentation for `$this->db->get_compiled_insert()`.\n\n.. note:: This method doesn't work for batched updates.\n\n*************\nDeleting Data\n*************\n\n**$this->db->delete()**\n\nGenerates a delete SQL string and runs the query.\n\n::\n\n\t$this->db->delete('mytable', array('id' => $id));  // Produces: // DELETE FROM mytable  // WHERE id = $id\n\nThe first parameter is the table name, the second is the where clause.\nYou can also use the where() or or_where() functions instead of passing\nthe data to the second parameter of the function::\n\n\t$this->db->where('id', $id);\n\t$this->db->delete('mytable');\n\n\t// Produces:\n\t// DELETE FROM mytable\n\t// WHERE id = $id\n\n\nAn array of table names can be passed into delete() if you would like to\ndelete data from more than 1 table.\n\n::\n\n\t$tables = array('table1', 'table2', 'table3');\n\t$this->db->where('id', '5');\n\t$this->db->delete($tables);\n\n\nIf you want to delete all data from a table, you can use the truncate()\nfunction, or empty_table().\n\n**$this->db->empty_table()**\n\nGenerates a delete SQL string and runs the\nquery.::\n\n\t  $this->db->empty_table('mytable'); // Produces: DELETE FROM mytable\n\n**$this->db->truncate()**\n\nGenerates a truncate SQL string and runs the query.\n\n::\n\n\t$this->db->from('mytable');\n\t$this->db->truncate();\n\n\t// or\n\n\t$this->db->truncate('mytable');\n\n\t// Produce:\n\t// TRUNCATE mytable\n\n.. note:: If the TRUNCATE command isn't available, truncate() will\n\texecute as \"DELETE FROM table\".\n\n**$this->db->get_compiled_delete()**\n\nThis works exactly the same way as ``$this->db->get_compiled_insert()`` except\nthat it produces a DELETE SQL string instead of an INSERT SQL string.\n\nFor more information view documentation for $this->db->get_compiled_insert().\n\n***************\nMethod Chaining\n***************\n\nMethod chaining allows you to simplify your syntax by connecting\nmultiple functions. Consider this example::\n\n\t$query = $this->db->select('title')\n\t\t\t->where('id', $id)\n\t\t\t->limit(10, 20)\n\t\t\t->get('mytable');\n\n.. _ar-caching:\n\n*********************\nQuery Builder Caching\n*********************\n\nWhile not \"true\" caching, Query Builder enables you to save (or \"cache\")\ncertain parts of your queries for reuse at a later point in your\nscript's execution. Normally, when an Query Builder call is completed,\nall stored information is reset for the next call. With caching, you can\nprevent this reset, and reuse information easily.\n\nCached calls are cumulative. If you make 2 cached select() calls, and\nthen 2 uncached select() calls, this will result in 4 select() calls.\nThere are three Caching functions available:\n\n**$this->db->start_cache()**\n\nThis function must be called to begin caching. All Query Builder queries\nof the correct type (see below for supported queries) are stored for\nlater use.\n\n**$this->db->stop_cache()**\n\nThis function can be called to stop caching.\n\n**$this->db->flush_cache()**\n\nThis function deletes all items from the Query Builder cache.\n\nAn example of caching\n---------------------\n\nHere's a usage example::\n\n\t$this->db->start_cache();\n\t$this->db->select('field1');\n\t$this->db->stop_cache();\n\t$this->db->get('tablename');\n\t//Generates: SELECT `field1` FROM (`tablename`)\n\n\t$this->db->select('field2');\n\t$this->db->get('tablename');\n\t//Generates:  SELECT `field1`, `field2` FROM (`tablename`)\n\n\t$this->db->flush_cache();\n\t$this->db->select('field2');\n\t$this->db->get('tablename');\n\t//Generates:  SELECT `field2` FROM (`tablename`)\n\n\n.. note:: The following statements can be cached: select, from, join,\n\twhere, like, group_by, having, order_by\n\n\n***********************\nResetting Query Builder\n***********************\n\n**$this->db->reset_query()**\n\nResetting Query Builder allows you to start fresh with your query without\nexecuting it first using a method like $this->db->get() or $this->db->insert().\nJust like the methods that execute a query, this will *not* reset items you've\ncached using `Query Builder Caching`_.\n\nThis is useful in situations where you are using Query Builder to generate SQL\n(ex. ``$this->db->get_compiled_select()``) but then choose to, for instance,\nrun the query::\n\n\t// Note that the second parameter of the get_compiled_select method is FALSE\n\t$sql = $this->db->select(array('field1','field2'))\n\t\t\t\t\t->where('field3',5)\n\t\t\t\t\t->get_compiled_select('mytable', FALSE);\n\n\t// ...\n\t// Do something crazy with the SQL code... like add it to a cron script for\n\t// later execution or something...\n\t// ...\n\n\t$data = $this->db->get()->result_array();\n\n\t// Would execute and return an array of results of the following query:\n\t// SELECT field1, field1 from mytable where field3 = 5;\n\n.. note:: Double calls to ``get_compiled_select()`` while you're using the\n\tQuery Builder Caching functionality and NOT resetting your queries\n\twill results in the cache being merged twice. That in turn will\n\ti.e. if you're caching a ``select()`` - select the same field twice.\n\n***************\nClass Reference\n***************\n\n.. php:class:: CI_DB_query_builder\n\n\t.. php:method:: reset_query()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tResets the current Query Builder state.  Useful when you want\n\t\tto build a query that can be cancelled under certain conditions.\n\n\t.. php:method:: start_cache()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tStarts the Query Builder cache.\n\n\t.. php:method:: stop_cache()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tStops the Query Builder cache.\n\n\t.. php:method:: flush_cache()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tEmpties the Query Builder cache.\n\n\t.. php:method:: set_dbprefix([$prefix = ''])\n\n\t\t:param\tstring\t$prefix: The new prefix to use\n\t\t:returns:\tThe DB prefix in use\n\t\t:rtype:\tstring\n\n\t\tSets the database prefix, without having to reconnect.\n\n\t.. php:method:: dbprefix([$table = ''])\n\n\t\t:param\tstring\t$table: The table name to prefix\n\t\t:returns:\tThe prefixed table name\n\t\t:rtype:\tstring\n\n\t\tPrepends a database prefix, if one exists in configuration.\n\n\t.. php:method:: count_all_results([$table = '', [$reset = TRUE]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tbool\t$reset: Whether to reset values for SELECTs\n\t\t:returns:\tNumber of rows in the query result\n\t\t:rtype:\tint\n\n\t\tGenerates a platform-specific query string that counts\n\t\tall records returned by an Query Builder query.\n\n\t.. php:method:: get([$table = ''[, $limit = NULL[, $offset = NULL]]])\n\n\t\t:param\tstring\t$table: The table to query\n\t\t:param\tint\t$limit: The LIMIT clause\n\t\t:param\tint\t$offset: The OFFSET clause\n\t\t:returns:\tCI_DB_result instance (method chaining)\n\t\t:rtype:\tCI_DB_result\n\n\t\tCompiles and runs SELECT statement based on the already\n\t\tcalled Query Builder methods.\n\n\t.. php:method:: get_where([$table = ''[, $where = NULL[, $limit = NULL[, $offset = NULL]]]])\n\n\t\t:param\tmixed\t$table: The table(s) to fetch data from; string or array\n\t\t:param\tstring\t$where: The WHERE clause\n\t\t:param\tint\t$limit: The LIMIT clause\n\t\t:param\tint\t$offset: The OFFSET clause\n\t\t:returns:\tCI_DB_result instance (method chaining)\n\t\t:rtype:\tCI_DB_result\n\n\t\tSame as ``get()``, but also allows the WHERE to be added directly.\n\n\t.. php:method:: select([$select = '*'[, $escape = NULL]])\n\n\t\t:param\tstring\t$select: The SELECT portion of a query\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a SELECT clause to a query.\n\n\t.. php:method:: select_avg([$select = ''[, $alias = '']])\n\n\t\t:param\tstring\t$select: Field to compute the average of\n\t\t:param\tstring\t$alias: Alias for the resulting value name\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a SELECT AVG(field) clause to a query.\n\n\t.. php:method:: select_max([$select = ''[, $alias = '']])\n\n\t\t:param\tstring\t$select: Field to compute the maximum of\n\t\t:param\tstring\t$alias: Alias for the resulting value name\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a SELECT MAX(field) clause to a query.\n\n\t.. php:method:: select_min([$select = ''[, $alias = '']])\n\n\t\t:param\tstring\t$select: Field to compute the minimum of\n\t\t:param\tstring\t$alias: Alias for the resulting value name\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a SELECT MIN(field) clause to a query.\n\n\t.. php:method:: select_sum([$select = ''[, $alias = '']])\n\n\t\t:param\tstring\t$select: Field to compute the sum of\n\t\t:param\tstring\t$alias: Alias for the resulting value name\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a SELECT SUM(field) clause to a query.\n\n\t.. php:method:: distinct([$val = TRUE])\n\n\t\t:param\tbool\t$val: Desired value of the \"distinct\" flag\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tSets a flag which tells the query builder to add\n\t\ta DISTINCT clause to the SELECT portion of the query.\n\n\t.. php:method:: from($from)\n\n\t\t:param\tmixed\t$from: Table name(s); string or array\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tSpecifies the FROM clause of a query.\n\n\t.. php:method:: join($table, $cond[, $type = ''[, $escape = NULL]])\n\n\t\t:param\tstring\t$table: Table name to join\n\t\t:param\tstring\t$cond: The JOIN ON condition\n\t\t:param\tstring\t$type: The JOIN type\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a JOIN clause to a query.\n\n\t.. php:method:: where($key[, $value = NULL[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Name of field to compare, or associative array\n\t\t:param\tmixed\t$value: If a single key, compared to this value\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates the WHERE portion of the query.\n                Separates multiple calls with 'AND'.\n\n\t.. php:method:: or_where($key[, $value = NULL[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Name of field to compare, or associative array\n\t\t:param\tmixed\t$value: If a single key, compared to this value\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates the WHERE portion of the query.\n                Separates multiple calls with 'OR'.\n\n\t.. php:method:: or_where_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: The field to search\n\t\t:param\tarray\t$values: The values searched on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a WHERE field IN('item', 'item') SQL query,\n                joined with 'OR' if appropriate.\n\n\t.. php:method:: or_where_not_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: The field to search\n\t\t:param\tarray\t$values: The values searched on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a WHERE field NOT IN('item', 'item') SQL query,\n                joined with 'OR' if appropriate.\n\n\t.. php:method:: where_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: Name of field to examine\n\t\t:param\tarray\t$values: Array of target values\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a WHERE field IN('item', 'item') SQL query,\n                joined with 'AND' if appropriate.\n\n\t.. php:method:: where_not_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: Name of field to examine\n\t\t:param\tarray\t$values: Array of target values\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a WHERE field NOT IN('item', 'item') SQL query,\n                joined with 'AND' if appropriate.\n\n\t.. php:method:: group_start()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tStarts a group expression, using ANDs for the conditions inside it.\n\n\t.. php:method:: or_group_start()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tStarts a group expression, using ORs for the conditions inside it.\n\n\t.. php:method:: not_group_start()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tStarts a group expression, using AND NOTs for the conditions inside it.\n\n\t.. php:method:: or_not_group_start()\n\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tStarts a group expression, using OR NOTs for the conditions inside it.\n\n\t.. php:method:: group_end()\n\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tEnds a group expression.\n\n\t.. php:method:: like($field[, $match = ''[, $side = 'both'[, $escape = NULL]]])\n\n\t\t:param\tstring\t$field: Field name\n\t\t:param\tstring\t$match: Text portion to match\n\t\t:param\tstring\t$side: Which side of the expression to put the '%' wildcard on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a LIKE clause to a query, separating multiple calls with AND.\n\n\t.. php:method:: or_like($field[, $match = ''[, $side = 'both'[, $escape = NULL]]])\n\n\t\t:param\tstring\t$field: Field name\n\t\t:param\tstring\t$match: Text portion to match\n\t\t:param\tstring\t$side: Which side of the expression to put the '%' wildcard on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a LIKE clause to a query, separating multiple class with OR.\n\n\t.. php:method:: not_like($field[, $match = ''[, $side = 'both'[, $escape = NULL]]])\n\n\t\t:param\tstring\t$field: Field name\n\t\t:param\tstring\t$match: Text portion to match\n\t\t:param\tstring\t$side: Which side of the expression to put the '%' wildcard on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a NOT LIKE clause to a query, separating multiple calls with AND.\n\n\t.. php:method:: or_not_like($field[, $match = ''[, $side = 'both'[, $escape = NULL]]])\n\n\t\t:param\tstring\t$field: Field name\n\t\t:param\tstring\t$match: Text portion to match\n\t\t:param\tstring\t$side: Which side of the expression to put the '%' wildcard on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a NOT LIKE clause to a query, separating multiple calls with OR.\n\n\t.. php:method:: having($key[, $value = NULL[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Identifier (string) or associative array of field/value pairs\n\t\t:param\tstring\t$value: Value sought if $key is an identifier\n\t\t:param\tstring\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a HAVING clause to a query, separating multiple calls with AND.\n\n\t.. php:method:: or_having($key[, $value = NULL[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Identifier (string) or associative array of field/value pairs\n\t\t:param\tstring\t$value: Value sought if $key is an identifier\n\t\t:param\tstring\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a HAVING clause to a query, separating multiple calls with OR.\n\n\t.. php:method:: or_having_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: The field to search\n\t\t:param\tarray\t$values: The values searched on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a HAVING field IN('item', 'item') SQL query,\n                joined with 'OR' if appropriate.\n\n\t.. php:method:: or_having_not_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: The field to search\n\t\t:param\tarray\t$values: The values searched on\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a HAVING field NOT IN('item', 'item') SQL query,\n                joined with 'OR' if appropriate.\n\n\t.. php:method:: having_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: Name of field to examine\n\t\t:param\tarray\t$values: Array of target values\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a HAVING field IN('item', 'item') SQL query,\n                joined with 'AND' if appropriate.\n\n\t.. php:method:: having_not_in([$key[, array $values[, $escape = NULL]]])\n\n\t\t:param\tstring\t$key: Name of field to examine\n\t\t:param\tarray\t$values: Array of target values\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tDB_query_builder instance\n\t\t:rtype:\tobject\n\n\t\tGenerates a HAVING field NOT IN('item', 'item') SQL query,\n                joined with 'AND' if appropriate.\n\n\t.. php:method:: group_by($by[, $escape = NULL])\n\n\t\t:param\tmixed\t$by: Field(s) to group by; string or array\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds a GROUP BY clause to a query.\n\n\t.. php:method:: order_by($orderby[, $direction = ''[, $escape = NULL]])\n\n\t\t:param\tstring\t$orderby: Field to order by\n\t\t:param\tstring\t$direction: The order requested - ASC, DESC or random\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds an ORDER BY clause to a query.\n\n\t.. php:method:: limit($value[, $offset = 0])\n\n\t\t:param\tint\t$value: Number of rows to limit the results to\n\t\t:param\tint\t$offset: Number of rows to skip\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds LIMIT and OFFSET clauses to a query.\n\n\t.. php:method:: offset($offset)\n\n\t\t:param\tint\t$offset: Number of rows to skip\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds an OFFSET clause to a query.\n\n\t.. php:method:: set($key[, $value = ''[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Field name, or an array of field/value pairs\n\t\t:param\tstring\t$value: Field value, if $key is a single field\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds field/value pairs to be passed later to ``insert()``,\n\t\t``update()`` or ``replace()``.\n\n\t.. php:method:: insert([$table = ''[, $set = NULL[, $escape = NULL]]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tarray\t$set: An associative array of field/value pairs\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tCompiles and executes an INSERT statement.\n\n\t.. php:method:: insert_batch($table[, $set = NULL[, $escape = NULL[, $batch_size = 100]]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tarray\t$set: Data to insert\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:param\tint\t$batch_size: Count of rows to insert at once\n\t\t:returns:\tNumber of rows inserted or FALSE on failure\n\t\t:rtype:\tmixed\n\n\t\tCompiles and executes batch ``INSERT`` statements.\n\n\t\t.. note:: When more than ``$batch_size`` rows are provided, multiple\n\t\t\t``INSERT`` queries will be executed, each trying to insert\n\t\t\tup to ``$batch_size`` rows.\n\n\t.. php:method:: set_insert_batch($key[, $value = ''[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Field name or an array of field/value pairs\n\t\t:param\tstring\t$value: Field value, if $key is a single field\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds field/value pairs to be inserted in a table later via ``insert_batch()``.\n\n\t.. php:method:: update([$table = ''[, $set = NULL[, $where = NULL[, $limit = NULL]]]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tarray\t$set: An associative array of field/value pairs\n\t\t:param\tstring\t$where: The WHERE clause\n\t\t:param\tint\t$limit: The LIMIT clause\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tCompiles and executes an UPDATE statement.\n\n\t.. php:method:: update_batch($table[, $set = NULL[, $value = NULL[, $batch_size = 100]]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tarray\t$set: Field name, or an associative array of field/value pairs\n\t\t:param\tstring\t$value: Field value, if $set is a single field\n\t\t:param\tint\t$batch_size: Count of conditions to group in a single query\n\t\t:returns:\tNumber of rows updated or FALSE on failure\n\t\t:rtype:\tmixed\n\n\t\tCompiles and executes batch ``UPDATE`` statements.\n\n\t\t.. note:: When more than ``$batch_size`` field/value pairs are provided,\n\t\t\tmultiple queries will be executed, each handling up to\n\t\t\t``$batch_size`` field/value pairs.\n\n\t.. php:method:: set_update_batch($key[, $value = ''[, $escape = NULL]])\n\n\t\t:param\tmixed\t$key: Field name or an array of field/value pairs\n\t\t:param\tstring\t$value: Field value, if $key is a single field\n\t\t:param\tbool\t$escape: Whether to escape values and identifiers\n\t\t:returns:\tCI_DB_query_builder instance (method chaining)\n\t\t:rtype:\tCI_DB_query_builder\n\n\t\tAdds field/value pairs to be updated in a table later via ``update_batch()``.\n\n\t.. php:method:: replace([$table = ''[, $set = NULL]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tarray\t$set: An associative array of field/value pairs\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tCompiles and executes a REPLACE statement.\n\n\t.. php:method:: delete([$table = ''[, $where = ''[, $limit = NULL[, $reset_data = TRUE]]]])\n\n\t\t:param\tmixed\t$table: The table(s) to delete from; string or array\n\t\t:param\tstring\t$where: The WHERE clause\n\t\t:param\tint\t$limit: The LIMIT clause\n\t\t:param\tbool\t$reset_data: TRUE to reset the query \"write\" clause\n\t\t:returns:\tCI_DB_query_builder instance (method chaining) or FALSE on failure\n\t\t:rtype:\tmixed\n\n\t\tCompiles and executes a DELETE query.\n\n\t.. php:method:: truncate([$table = ''])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tExecutes a TRUNCATE statement on a table.\n\n\t\t.. note:: If the database platform in use doesn't support TRUNCATE,\n\t\t\ta DELETE statement will be used instead.\n\n\t.. php:method:: empty_table([$table = ''])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tDeletes all records from a table via a DELETE statement.\n\n\t.. php:method:: get_compiled_select([$table = ''[, $reset = TRUE]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tbool\t$reset: Whether to reset the current QB values or not\n\t\t:returns:\tThe compiled SQL statement as a string\n\t\t:rtype:\tstring\n\n\t\tCompiles a SELECT statement and returns it as a string.\n\n\t.. php:method:: get_compiled_insert([$table = ''[, $reset = TRUE]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tbool\t$reset: Whether to reset the current QB values or not\n\t\t:returns:\tThe compiled SQL statement as a string\n\t\t:rtype:\tstring\n\n\t\tCompiles an INSERT statement and returns it as a string.\n\n\t.. php:method:: get_compiled_update([$table = ''[, $reset = TRUE]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tbool\t$reset: Whether to reset the current QB values or not\n\t\t:returns:\tThe compiled SQL statement as a string\n\t\t:rtype:\tstring\n\n\t\tCompiles an UPDATE statement and returns it as a string.\n\n\t.. php:method:: get_compiled_delete([$table = ''[, $reset = TRUE]])\n\n\t\t:param\tstring\t$table: Table name\n\t\t:param\tbool\t$reset: Whether to reset the current QB values or not\n\t\t:returns:\tThe compiled SQL statement as a string\n\t\t:rtype:\tstring\n\n\t\tCompiles a DELETE statement and returns it as a string.\n"
  },
  {
    "path": "user_guide_src/source/database/results.rst",
    "content": "########################\nGenerating Query Results\n########################\n\nThere are several ways to generate query results:\n\n.. contents::\n    :local:\n    :depth: 2\n\n*************\nResult Arrays\n*************\n\n**result()**\n\nThis method returns the query result as an array of **objects**, or\n**an empty array** on failure. Typically you'll use this in a foreach\nloop, like this::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\tforeach ($query->result() as $row)\n\t{\n\t\techo $row->title;\n\t\techo $row->name;\n\t\techo $row->body;\n\t}\n\nThe above method is an alias of ``result_object()``.\n\nYou can also pass a string to ``result()`` which represents a class to\ninstantiate for each result object (note: this class must be loaded)\n\n::\n\n\t$query = $this->db->query(\"SELECT * FROM users;\");\n\n\tforeach ($query->result('User') as $user)\n\t{\n\t\techo $user->name; // access attributes\n\t\techo $user->reverse_name(); // or methods defined on the 'User' class\n\t}\n\n**result_array()**\n\nThis method returns the query result as a pure array, or an empty\narray when no result is produced. Typically you'll use this in a foreach\nloop, like this::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\tforeach ($query->result_array() as $row)\n\t{\n\t\techo $row['title'];\n\t\techo $row['name'];\n\t\techo $row['body'];\n\t}\n\n***********\nResult Rows\n***********\n\n**row()**\n\nThis method returns a single result row. If your query has more than\none row, it returns only the first row. The result is returned as an\n**object**. Here's a usage example::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\t$row = $query->row();\n\n\tif (isset($row))\n\t{\n\t\techo $row->title;\n\t\techo $row->name;\n\t\techo $row->body;\n\t}\n\nIf you want a specific row returned you can submit the row number as a\ndigit in the first parameter::\n\n\t$row = $query->row(5);\n\nYou can also add a second String parameter, which is the name of a class\nto instantiate the row with::\n\n\t$query = $this->db->query(\"SELECT * FROM users LIMIT 1;\");\n\t$row = $query->row(0, 'User');\n\t\n\techo $row->name; // access attributes\n\techo $row->reverse_name(); // or methods defined on the 'User' class\n\n**row_array()**\n\nIdentical to the above ``row()`` method, except it returns an array.\nExample::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\t$row = $query->row_array();\n\n\tif (isset($row))\n\t{\n\t\techo $row['title'];\n\t\techo $row['name'];\n\t\techo $row['body'];\n\t}\n\nIf you want a specific row returned you can submit the row number as a\ndigit in the first parameter::\n\n\t$row = $query->row_array(5);\n\nIn addition, you can walk forward/backwards/first/last through your\nresults using these variations:\n\n\t| **$row = $query->first_row()**\n\t| **$row = $query->last_row()**\n\t| **$row = $query->next_row()**\n\t| **$row = $query->previous_row()**\n\nBy default they return an object unless you put the word \"array\" in the\nparameter:\n\n\t| **$row = $query->first_row('array')**\n\t| **$row = $query->last_row('array')**\n\t| **$row = $query->next_row('array')**\n\t| **$row = $query->previous_row('array')**\n\n.. note:: All the methods above will load the whole result into memory\n\t(prefetching). Use ``unbuffered_row()`` for processing large\n\tresult sets.\n\n**unbuffered_row()**\n\nThis method returns a single result row without prefetching the whole\nresult in memory as ``row()`` does. If your query has more than one row,\nit returns the current row and moves the internal data pointer ahead. \n\n::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\twhile ($row = $query->unbuffered_row())\n\t{\t\n\t\techo $row->title;\n\t\techo $row->name;\n\t\techo $row->body;\n\t}\n\nYou can optionally pass 'object' (default) or 'array' in order to specify\nthe returned value's type::\n\n\t$query->unbuffered_row();\t\t// object\n\t$query->unbuffered_row('object');\t// object\n\t$query->unbuffered_row('array');\t// associative array\n\n*********************\nCustom Result Objects\n*********************\n\nYou can have the results returned as an instance of a custom class instead\nof a ``stdClass`` or array, as the ``result()`` and ``result_array()``\nmethods allow. This requires that the class is already loaded into memory.\nThe object will have all values returned from the database set as properties.\nIf these have been declared and are non-public then you should provide a\n``__set()`` method to allow them to be set.\n\nExample::\n\n\tclass User {\n\n\t\tpublic $id;\n\t\tpublic $email;\n\t\tpublic $username;\n\n\t\tprotected $last_login;\n\n\t\tpublic function last_login($format)\n\t\t{\n\t\t\treturn $this->last_login->format($format);\n\t\t}\n\n\t\tpublic function __set($name, $value)\n\t\t{\n\t\t\tif ($name === 'last_login')\n\t\t\t{\n\t\t\t\t$this->last_login = DateTime::createFromFormat('U', $value);\n\t\t\t}\n\t\t}\n\n\t\tpublic function __get($name)\n\t\t{\n\t\t\tif (isset($this->$name))\n\t\t\t{\n\t\t\t\treturn $this->$name;\n\t\t\t}\n\t\t}\n\t}\n\nIn addition to the two methods listed below, the following methods also can\ntake a class name to return the results as: ``first_row()``, ``last_row()``,\n``next_row()``, and ``previous_row()``.\n\n**custom_result_object()**\n\nReturns the entire result set as an array of instances of the class requested.\nThe only parameter is the name of the class to instantiate.\n\nExample::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\t$rows = $query->custom_result_object('User');\n\n\tforeach ($rows as $row)\n\t{\n\t\techo $row->id;\n\t\techo $row->email;\n\t\techo $row->last_login('Y-m-d');\n\t}\n\n**custom_row_object()**\n\nReturns a single row from your query results. The first parameter is the row\nnumber of the results. The second parameter is the class name to instantiate.\n\nExample::\n\n\t$query = $this->db->query(\"YOUR QUERY\");\n\n\t$row = $query->custom_row_object(0, 'User');\n\n\tif (isset($row))\n\t{\n\t\techo $row->email;   // access attributes\n\t\techo $row->last_login('Y-m-d');   // access class methods\n\t}\n\nYou can also use the ``row()`` method in exactly the same way.\n\nExample::\n\n\t$row = $query->custom_row_object(0, 'User');\n\n*********************\nResult Helper Methods\n*********************\n\n**num_rows()**\n\nThe number of rows returned by the query. Note: In this example, $query\nis the variable that the query result object is assigned to::\n\n\t$query = $this->db->query('SELECT * FROM my_table');\n\n\techo $query->num_rows();\n\n.. note:: Not all database drivers have a native way of getting the total\n\tnumber of rows for a result set. When this is the case, all of\n\tthe data is prefetched and ``count()`` is manually called on the\n\tresulting array in order to achieve the same result.\n\t\n**num_fields()**\n\nThe number of FIELDS (columns) returned by the query. Make sure to call\nthe method using your query result object::\n\n\t$query = $this->db->query('SELECT * FROM my_table');\n\n\techo $query->num_fields();\n\n**free_result()**\n\nIt frees the memory associated with the result and deletes the result\nresource ID. Normally PHP frees its memory automatically at the end of\nscript execution. However, if you are running a lot of queries in a\nparticular script you might want to free the result after each query\nresult has been generated in order to cut down on memory consumption.\n\nExample::\n\n\t$query = $this->db->query('SELECT title FROM my_table');\n\n\tforeach ($query->result() as $row)\n\t{\n\t\techo $row->title;\n\t}\n\n\t$query->free_result();  // The $query result object will no longer be available\n\n\t$query2 = $this->db->query('SELECT name FROM some_table');\n\n\t$row = $query2->row();\n\techo $row->name;\n\t$query2->free_result(); // The $query2 result object will no longer be available\n\n**data_seek()**\n\nThis method sets the internal pointer for the next result row to be\nfetched. It is only useful in combination with ``unbuffered_row()``.\n\nIt accepts a positive integer value, which defaults to 0 and returns\nTRUE on success or FALSE on failure.\n\n::\n\n\t$query = $this->db->query('SELECT `field_name` FROM `table_name`');\n\t$query->data_seek(5); // Skip the first 5 rows\n\t$row = $query->unbuffered_row();\n\n.. note:: Not all database drivers support this feature and will return FALSE.\n\tMost notably - you won't be able to use it with PDO.\n\n***************\nClass Reference\n***************\n\n.. php:class:: CI_DB_result\n\n\t.. php:method:: result([$type = 'object'])\n\n\t\t:param\tstring\t$type: Type of requested results - array, object, or class name\n\t\t:returns:\tArray containing the fetched rows\n\t\t:rtype:\tarray\n\n\t\tA wrapper for the ``result_array()``, ``result_object()``\n\t\tand ``custom_result_object()`` methods.\n\n\t\tUsage: see `Result Arrays`_.\n\n\t.. php:method:: result_array()\n\n\t\t:returns:\tArray containing the fetched rows\n\t\t:rtype:\tarray\n\n\t\tReturns the query results as an array of rows, where each\n\t\trow is itself an associative array.\n\n\t\tUsage: see `Result Arrays`_.\n\n\t.. php:method:: result_object()\n\n\t\t:returns:\tArray containing the fetched rows\n\t\t:rtype:\tarray\n\n\t\tReturns the query results as an array of rows, where each\n\t\trow is an object of type ``stdClass``.\n\n\t\tUsage: see `Result Arrays`_.\n\n\t.. php:method:: custom_result_object($class_name)\n\n\t\t:param\tstring\t$class_name: Class name for the resulting rows\n\t\t:returns:\tArray containing the fetched rows\n\t\t:rtype:\tarray\n\n\t\tReturns the query results as an array of rows, where each\n\t\trow is an instance of the specified class.\n\n\t.. php:method:: row([$n = 0[, $type = 'object']])\n\n\t\t:param\tint\t$n: Index of the query results row to be returned\n\t\t:param\tstring\t$type: Type of the requested result - array, object, or class name\n\t\t:returns:\tThe requested row or NULL if it doesn't exist\n\t\t:rtype:\tmixed\n\n\t\tA wrapper for the ``row_array()``, ``row_object() and \n\t\t``custom_row_object()`` methods.\n\n\t\tUsage: see `Result Rows`_.\n\n\t.. php:method:: unbuffered_row([$type = 'object'])\n\n\t\t:param\tstring\t$type: Type of the requested result - array, object, or class name\n\t\t:returns:\tNext row from the result set or NULL if it doesn't exist\n\t\t:rtype:\tmixed\n\n\t\tFetches the next result row and returns it in the\n\t\trequested form.\n\n\t\tUsage: see `Result Rows`_.\n\n\t.. php:method:: row_array([$n = 0])\n\n\t\t:param\tint\t$n: Index of the query results row to be returned\n\t\t:returns:\tThe requested row or NULL if it doesn't exist\n\t\t:rtype:\tarray\n\n\t\tReturns the requested result row as an associative array.\n\n\t\tUsage: see `Result Rows`_.\n\n\t.. php:method:: row_object([$n = 0])\n\n\t\t:param\tint\t$n: Index of the query results row to be returned\n                :returns:\tThe requested row or NULL if it doesn't exist\n\t\t:rtype:\tstdClass\n\n\t\tReturns the requested result row as an object of type\n\t\t``stdClass``.\n\n\t\tUsage: see `Result Rows`_.\n\n\t.. php:method:: custom_row_object($n, $type)\n\n\t\t:param\tint\t$n: Index of the results row to return\n\t\t:param\tstring\t$class_name: Class name for the resulting row\n\t\t:returns:\tThe requested row or NULL if it doesn't exist\n\t\t:rtype:\t$type\n\n\t\tReturns the requested result row as an instance of the\n\t\trequested class.\n\n\t.. php:method:: data_seek([$n = 0])\n\n\t\t:param\tint\t$n: Index of the results row to be returned next\n\t\t:returns:\tTRUE on success, FALSE on failure\n\t\t:rtype:\tbool\n\n\t\tMoves the internal results row pointer to the desired offset.\n\n\t\tUsage: see `Result Helper Methods`_.\n\n\t.. php:method:: set_row($key[, $value = NULL])\n\n\t\t:param\tmixed\t$key: Column name or array of key/value pairs\n\t\t:param\tmixed\t$value: Value to assign to the column, $key is a single field name\n\t\t:rtype:\tvoid\n\n\t\tAssigns a value to a particular column.\n\n\t.. php:method:: next_row([$type = 'object'])\n\n\t\t:param\tstring\t$type: Type of the requested result - array, object, or class name\n\t\t:returns:\tNext row of result set, or NULL if it doesn't exist\n\t\t:rtype:\tmixed\n\n\t\tReturns the next row from the result set.\n\n\t.. php:method:: previous_row([$type = 'object'])\n\n\t\t:param\tstring\t$type: Type of the requested result - array, object, or class name\n\t\t:returns:\tPrevious row of result set, or NULL if it doesn't exist\n\t\t:rtype:\tmixed\n\n\t\tReturns the previous row from the result set.\n\n\t.. php:method:: first_row([$type = 'object'])\n\n\t\t:param\tstring\t$type: Type of the requested result - array, object, or class name\n\t\t:returns:\tFirst row of result set, or NULL if it doesn't exist\n\t\t:rtype:\tmixed\n\n\t\tReturns the first row from the result set.\n\n\t.. php:method:: last_row([$type = 'object'])\n\n\t\t:param\tstring\t$type: Type of the requested result - array, object, or class name\n\t\t:returns:\tLast row of result set, or NULL if it doesn't exist\n\t\t:rtype:\tmixed\n\n\t\tReturns the last row from the result set.\n\n\t.. php:method:: num_rows()\n\n\t\t:returns:\tNumber of rows in the result set\n\t\t:rtype:\tint\n\n\t\tReturns the number of rows in the result set.\n\n\t\tUsage: see `Result Helper Methods`_.\n\n\t.. php:method:: num_fields()\n\n\t\t:returns:\tNumber of fields in the result set\n\t\t:rtype:\tint\n\n\t\tReturns the number of fields in the result set.\n\n\t\tUsage: see `Result Helper Methods`_.\n\n\t.. php:method:: field_data()\n\n\t\t:returns:\tArray containing field meta-data\n\t\t:rtype:\tarray\n\n\t\tGenerates an array of ``stdClass`` objects containing\n\t\tfield meta-data.\n\n\t.. php:method:: free_result()\n\n\t\t:rtype:\tvoid\n\n\t\tFrees a result set.\n\n\t\tUsage: see `Result Helper Methods`_.\n\n\t.. php:method:: list_fields()\n\n\t\t:returns:\tArray of column names\n\t\t:rtype:\tarray\n\n\t\tReturns an array containing the field names in the\n\t\tresult set.\n"
  },
  {
    "path": "user_guide_src/source/database/transactions.rst",
    "content": "############\nTransactions\n############\n\nCodeIgniter's database abstraction allows you to use transactions with\ndatabases that support transaction-safe table types. In MySQL, you'll\nneed to be running InnoDB or BDB table types rather than the more common\nMyISAM. Most other database platforms support transactions natively.\n\nIf you are not familiar with transactions we recommend you find a good\nonline resource to learn about them for your particular database. The\ninformation below assumes you have a basic understanding of\ntransactions.\n\nCodeIgniter's Approach to Transactions\n======================================\n\nCodeIgniter utilizes an approach to transactions that is very similar to\nthe process used by the popular database class ADODB. We've chosen that\napproach because it greatly simplifies the process of running\ntransactions. In most cases all that is required are two lines of code.\n\nTraditionally, transactions have required a fair amount of work to\nimplement since they demand that you keep track of your queries and\ndetermine whether to commit or rollback based on the success or failure\nof your queries. This is particularly cumbersome with nested queries. In\ncontrast, we've implemented a smart transaction system that does all\nthis for you automatically (you can also manage your transactions\nmanually if you choose to, but there's really no benefit).\n\nRunning Transactions\n====================\n\nTo run your queries using transactions you will use the\n$this->db->trans_start() and $this->db->trans_complete() functions as\nfollows::\n\n\t$this->db->trans_start();\n\t$this->db->query('AN SQL QUERY...');\n\t$this->db->query('ANOTHER QUERY...');\n\t$this->db->query('AND YET ANOTHER QUERY...');\n\t$this->db->trans_complete();\n\nYou can run as many queries as you want between the start/complete\nfunctions and they will all be committed or rolled back based on success\nor failure of any given query.\n\nStrict Mode\n===========\n\nBy default CodeIgniter runs all transactions in Strict Mode. When strict\nmode is enabled, if you are running multiple groups of transactions, if\none group fails all groups will be rolled back. If strict mode is\ndisabled, each group is treated independently, meaning a failure of one\ngroup will not affect any others.\n\nStrict Mode can be disabled as follows::\n\n\t$this->db->trans_strict(FALSE);\n\nManaging Errors\n===============\n\nIf you have error reporting enabled in your config/database.php file\nyou'll see a standard error message if the commit was unsuccessful. If\ndebugging is turned off, you can manage your own errors like this::\n\n\t$this->db->trans_start();\n\t$this->db->query('AN SQL QUERY...');\n\t$this->db->query('ANOTHER QUERY...');\n\t$this->db->trans_complete();\n\t\n\tif ($this->db->trans_status() === FALSE)\n\t{\n\t\t// generate an error... or use the log_message() function to log your error\n\t}\n\nDisabling Transactions\n======================\n\nIf you would like to disable transactions you can do so using\n``$this->db->trans_off()``::\n\n\t$this->db->trans_off();\n\t\n\t$this->db->trans_start();\n\t$this->db->query('AN SQL QUERY...');\n\t$this->db->trans_complete();\n\nWhen transactions are disabled, your queries will be auto-committed, just as\nthey are when running queries without transactions, practically ignoring\nany calls to ``trans_start()``, ``trans_complete()``, etc.\n\nTest Mode\n=========\n\nYou can optionally put the transaction system into \"test mode\", which\nwill cause your queries to be rolled back -- even if the queries produce\na valid result. To use test mode simply set the first parameter in the\n$this->db->trans_start() function to TRUE::\n\n\t$this->db->trans_start(TRUE); // Query will be rolled back\n\t$this->db->query('AN SQL QUERY...');\n\t$this->db->trans_complete();\n\nRunning Transactions Manually\n=============================\n\nIf you would like to run transactions manually you can do so as follows::\n\n\t$this->db->trans_begin();\n\t\n\t$this->db->query('AN SQL QUERY...');\n\t$this->db->query('ANOTHER QUERY...');\n\t$this->db->query('AND YET ANOTHER QUERY...');\n\t\n\tif ($this->db->trans_status() === FALSE)\n\t{\n\t\t$this->db->trans_rollback();\n\t}\n\telse\n\t{\n\t\t$this->db->trans_commit();\n\t}\n\n.. note:: Make sure to use $this->db->trans_begin() when running manual\n\ttransactions, **NOT** $this->db->trans_start().\n"
  },
  {
    "path": "user_guide_src/source/database/utilities.rst",
    "content": "######################\nDatabase Utility Class\n######################\n\nThe Database Utility Class contains methods that help you manage your\ndatabase.\n\n.. contents::\n    :local:\n    :depth: 2\n\n******************************\nInitializing the Utility Class\n******************************\n\n.. important:: In order to initialize the Utility class, your database\n\tdriver must already be running, since the utilities class relies on it.\n\nLoad the Utility Class as follows::\n\n\t$this->load->dbutil();\n\nYou can also pass another database object to the DB Utility loader, in case\nthe database you want to manage isn't the default one::\n\n\t$this->myutil = $this->load->dbutil($this->other_db, TRUE);\n\nIn the above example, we're passing a custom database object as the first\nparameter and then tell it to return the dbutil object, instead of\nassigning it directly to ``$this->dbutil``.\n\n.. note:: Both of the parameters can be used individually, just pass an empty\n\tvalue as the first one if you wish to skip it.\n\nOnce initialized you will access the methods using the ``$this->dbutil``\nobject::\n\n\t$this->dbutil->some_method();\n\n****************************\nUsing the Database Utilities\n****************************\n\nRetrieve list of database names\n================================\n\nReturns an array of database names::\n\n\t$dbs = $this->dbutil->list_databases();\n\n\tforeach ($dbs as $db)\n\t{\n \t\techo $db;\n\t}\n\n\nDetermine If a Database Exists\n==============================\n\nSometimes it's helpful to know whether a particular database exists.\nReturns a boolean TRUE/FALSE. Usage example::\n\n\tif ($this->dbutil->database_exists('database_name'))\n\t{\n\t\t// some code...\n\t}\n\n.. note:: Replace *database_name* with the name of the database you are\n\tlooking for. This method is case sensitive.\n\nOptimize a Table\n================\n\nPermits you to optimize a table using the table name specified in the\nfirst parameter. Returns TRUE/FALSE based on success or failure::\n\n\tif ($this->dbutil->optimize_table('table_name'))\n\t{\n\t\techo 'Success!';\n\t}\n\n.. note:: Not all database platforms support table optimization. It is\n\tmostly for use with MySQL.\n\nRepair a Table\n==============\n\nPermits you to repair a table using the table name specified in the\nfirst parameter. Returns TRUE/FALSE based on success or failure::\n\n\tif ($this->dbutil->repair_table('table_name'))\n\t{\n\t\techo 'Success!';\n\t}\n\n.. note:: Not all database platforms support table repairs.\n\nOptimize a Database\n===================\n\nPermits you to optimize the database your DB class is currently\nconnected to. Returns an array containing the DB status messages or\nFALSE on failure.\n\n::\n\n\t$result = $this->dbutil->optimize_database();\n\n\tif ($result !== FALSE)\n\t{\n\t\tprint_r($result);\n\t}\n\n.. note:: Not all database platforms support database optimization. It\n\tit is mostly for use with MySQL.\n\nExport a Query Result as a CSV File\n===================================\n\nPermits you to generate a CSV file from a query result. The first\nparameter of the method must contain the result object from your\nquery. Example::\n\n\t$this->load->dbutil();\n\n\t$query = $this->db->query(\"SELECT * FROM mytable\");\n\n\techo $this->dbutil->csv_from_result($query);\n\nThe second, third, and fourth parameters allow you to set the delimiter\nnewline, and enclosure characters respectively. By default commas are\nused as the delimiter, \"\\n\" is used as a new line, and a double-quote\nis used as the enclosure. Example::\n\n\t$delimiter = \",\";\n\t$newline = \"\\r\\n\";\n\t$enclosure = '\"';\n\n\techo $this->dbutil->csv_from_result($query, $delimiter, $newline, $enclosure);\n\n.. important:: This method will NOT write the CSV file for you. It\n\tsimply creates the CSV layout. If you need to write the file\n\tuse the :doc:`File Helper <../helpers/file_helper>`.\n\nExport a Query Result as an XML Document\n========================================\n\nPermits you to generate an XML file from a query result. The first\nparameter expects a query result object, the second may contain an\noptional array of config parameters. Example::\n\n\t$this->load->dbutil();\n\n\t$query = $this->db->query(\"SELECT * FROM mytable\");\n\n\t$config = array (\n\t\t'root'\t\t=> 'root',\n\t\t'element'\t=> 'element',\n\t\t'newline'\t=> \"\\n\",\n\t\t'tab'\t\t=> \"\\t\"\n\t);\n\n\techo $this->dbutil->xml_from_result($query, $config);\n\n.. important:: This method will NOT write the XML file for you. It\n\tsimply creates the XML layout. If you need to write the file\n\tuse the :doc:`File Helper <../helpers/file_helper>`.\n\n********************\nBackup Your Database\n********************\n\nDatabase Backup Notes\n=====================\n\nPermits you to backup your full database or individual tables. The\nbackup data can be compressed in either Zip or Gzip format.\n\n.. note:: This feature is only available for MySQL and Interbase/Firebird databases.\n\n.. note:: For Interbase/Firebird databases, the backup file name is the only parameter.\n\n\t\t$this->dbutil->backup('db_backup_filename');\n\n.. note:: Due to the limited execution time and memory available to PHP,\n\tbacking up very large databases may not be possible. If your database is\n\tvery large you might need to backup directly from your SQL server via\n\tthe command line, or have your server admin do it for you if you do not\n\thave root privileges.\n\nUsage Example\n=============\n\n::\n\n\t// Load the DB utility class\n\t$this->load->dbutil();\n\n\t// Backup your entire database and assign it to a variable\n\t$backup = $this->dbutil->backup();\n\n\t// Load the file helper and write the file to your server\n\t$this->load->helper('file');\n\twrite_file('/path/to/mybackup.gz', $backup);\n\n\t// Load the download helper and send the file to your desktop\n\t$this->load->helper('download');\n\tforce_download('mybackup.gz', $backup);\n\nSetting Backup Preferences\n==========================\n\nBackup preferences are set by submitting an array of values to the first\nparameter of the ``backup()`` method. Example::\n\n\t$prefs = array(\n\t\t'tables'\t=> array('table1', 'table2'),\t// Array of tables to backup.\n\t\t'ignore'\t=> array(),\t\t\t// List of tables to omit from the backup\n\t\t'format'\t=> 'txt',\t\t\t// gzip, zip, txt\n\t\t'filename'\t=> 'mybackup.sql',\t\t// File name - NEEDED ONLY WITH ZIP FILES\n\t\t'add_drop'\t=> TRUE,\t\t\t// Whether to add DROP TABLE statements to backup file\n\t\t'add_insert'\t=> TRUE,\t\t\t// Whether to add INSERT data to backup file\n\t\t'newline'\t=> \"\\n\"\t\t\t\t// Newline character used in backup file\n\t);\n\n\t$this->dbutil->backup($prefs);\n\nDescription of Backup Preferences\n=================================\n\n======================= ======================= ======================= ========================================================================\nPreference              Default Value           Options                 Description\n======================= ======================= ======================= ========================================================================\n**tables**               empty array             None                    An array of tables you want backed up. If left blank all tables will be\n                                                                         exported.\n**ignore**               empty array             None                    An array of tables you want the backup routine to ignore.\n**format**               gzip                    gzip, zip, txt          The file format of the export file.\n**filename**             the current date/time   None                    The name of the backed-up file. The name is needed only if you are using\n                                                                         zip compression.\n**add_drop**             TRUE                    TRUE/FALSE              Whether to include DROP TABLE statements in your SQL export file.\n**add_insert**           TRUE                    TRUE/FALSE              Whether to include INSERT statements in your SQL export file.\n**newline**              \"\\\\n\"                   \"\\\\n\", \"\\\\r\", \"\\\\r\\\\n\"  Type of newline to use in your SQL export file.\n**foreign_key_checks**   TRUE                    TRUE/FALSE              Whether output should keep foreign key checks enabled.\n======================= ======================= ======================= ========================================================================\n\n***************\nClass Reference\n***************\n\n.. php:class:: CI_DB_utility\n\n\t.. php:method:: backup([$params = array()])\n\n\t\t:param\tarray\t$params: An associative array of options\n\t\t:returns:\traw/(g)zipped SQL query string\n\t\t:rtype:\tstring\n\n\t\tPerform a database backup, per user preferences.\n\n\t.. php:method:: database_exists($database_name)\n\n\t\t:param\tstring\t$database_name: Database name\n\t\t:returns:\tTRUE if the database exists, FALSE otherwise\n\t\t:rtype:\tbool\n\n\t\tCheck for the existence of a database.\n\n\t.. php:method:: list_databases()\n\n\t\t:returns:\tArray of database names found\n\t\t:rtype:\tarray\n\n\t\tRetrieve a list of all the database names.\n\n\t.. php:method:: optimize_database()\n\n\t\t:returns:\tArray of optimization messages or FALSE on failure\n\t\t:rtype:\tarray\n\n\t\tOptimizes the database.\n\n\t.. php:method:: optimize_table($table_name)\n\n\t\t:param\tstring\t$table_name:\tName of the table to optimize\n\t\t:returns:\tArray of optimization messages or FALSE on failure\n\t\t:rtype:\tarray\n\n\t\tOptimizes a database table.\n\n\t.. php:method:: repair_table($table_name)\n\n\t\t:param\tstring\t$table_name:\tName of the table to repair\n\t\t:returns:\tArray of repair messages or FALSE on failure\n\t\t:rtype:\tarray\n\n\t\tRepairs a database table.\n\n\t.. php:method:: csv_from_result($query[, $delim = ','[, $newline = \"\\n\"[, $enclosure = '\"']]])\n\n\t\t:param\tobject\t$query:\tA database result object\n\t\t:param\tstring\t$delim: The CSV field delimiter to use\n\t\t:param\tstring\t$newline: The newline character to use\n\t\t:param\tstring\t$enclosure: The enclosure delimiter to use\n\t\t:returns:\tThe generated CSV file as a string\n\t\t:rtype:\tstring\n\n\t\tTranslates a database result object into a CSV document.\n\n\t.. php:method:: xml_from_result($query[, $params = array()])\n\n\t\t:param\tobject\t$query: A database result object\n\t\t:param\tarray\t$params: An associative array of preferences\n\t\t:returns:\tThe generated XML document as a string\n\t\t:rtype:\tstring\n\n\t\tTranslates a database result object into an XML document.\n"
  },
  {
    "path": "user_guide_src/source/documentation/index.rst",
    "content": "#################################\nWriting CodeIgniter Documentation\n#################################\n\nCodeIgniter uses Sphinx to generate its documentation in a variety of formats,\nusing reStructuredText to handle the formatting.  If you are familiar with\nMarkdown or Textile, you will quickly grasp reStructuredText.  The focus is\non readability and user friendliness.\nWhile they can be quite technical, we always write for humans!\n\nA local table of contents should always be included, like the one below.\nIt is created automatically by inserting the following:\n\n::\n\n\t.. contents::\n\t\t:local:\n\n\t.. raw:: html\n\n\t
        \n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nThe 
         that is inserted as raw HTML is a hook for the documentation's\nJavaScript to dynamically add links to any function and method definitions\ncontained in the current page.\n\n**************\nTools Required\n**************\n\nTo see the rendered HTML, ePub, PDF, etc., you will need to install Sphinx\nalong with the PHP domain extension for Sphinx.  The underlying requirement\nis to have Python installed.  Lastly, you will install the CI Lexer for\nPygments, so that code blocks can be properly highlighted.\n\n.. code-block:: bash\n\n\teasy_install \"sphinx==1.2.3\"\n\teasy_install \"sphinxcontrib-phpdomain==0.1.3.post1\"\n\nThen follow the directions in the README file in the :samp:`cilexer` folder\ninside the documentation repository to install the CI Lexer.\n\n\n\n*****************************************\nPage and Section Headings and Subheadings\n*****************************************\n\nHeadings not only provide order and sections within a page, but they also\nare used to automatically build both the page and document table of contents.\nHeadings are formed by using certain characters as underlines for a bit of\ntext.  Major headings, like page titles and section headings also use\noverlines.  Other headings just use underlines, with the following hierarchy::\n\n\t# with overline for page titles\n\t* with overline for major sections\n\t= for subsections\n\t- for subsubsections\n\t^ for subsubsubsections\n\t\" for subsubsubsubsections (!)\n\nThe :download:`TextMate ELDocs Bundle <./ELDocs.tmbundle.zip>` can help you\ncreate these with the following tab triggers::\n\n\ttitle->\n\n\t\t##########\n\t\tPage Title\n\t\t##########\n\n\tsec->\n\n\t\t*************\n\t\tMajor Section\n\t\t*************\n\n\tsub->\n\n\t\tSubsection\n\t\t==========\n\n\tsss->\n\n\t\tSubSubSection\n\t\t-------------\n\n\tssss->\n\n\t\tSubSubSubSection\n\t\t^^^^^^^^^^^^^^^^\n\n\tsssss->\n\n\t\tSubSubSubSubSection (!)\n\t\t\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\n\n\n\n********************\nMethod Documentation\n********************\n\nWhen documenting class methods for third party developers, Sphinx provides\ndirectives to assist and keep things simple.  \nFor example, consider the following ReST:\n\n.. code-block:: rst\n\n\t.. php:class:: Some_class\n\n\t\t.. php:method:: some_method ( $foo [, $bar [, $bat]])\n\n\t\t\tThis function will perform some action. The ``$bar`` array must contain\n\t\t\ta something and something else, and along with ``$bat`` is an optional\n\t\t\tparameter.\n\n\t\t\t:param int $foo: the foo id to do something in\n\t\t\t:param mixed $bar: A data array that must contain a something and something else\n\t\t\t:param bool $bat: whether or not to do something\n\t\t\t:returns: FALSE on failure, TRUE if successful\n\t\t\t:rtype: bool\n\n\t\t\t::\n\n\t\t\t\t$this->load->library('some_class');\n\n\t\t\t\t$bar = array(\n\t\t\t\t\t'something'\t\t=> 'Here is this parameter!',\n\t\t\t\t\t'something_else'\t=> 42\n\t\t\t\t);\n\n\t\t\t\t$bat = $this->some_class->should_do_something();\n\n\t\t\t\tif ($this->some_class->some_method(4, $bar, $bat) === FALSE)\n\t\t\t\t{\n\t\t\t\t\tshow_error('An Error Occurred Doing Some Method');\n\t\t\t\t}\n\n\t\t\t.. note:: Here is something that you should be aware of when using some_method().\n\t\t\t\t\tFor real.\n\n\t\t\tSee also :meth:`Some_class::should_do_something`\n\n\n\t\t.. php:method:: should_do_something()\n\n\t\t\t:returns: Whether or not something should be done\n\t\t\t:rtype: bool\n\n\nIt creates the following display:\n\n.. php:class:: Some_class\n\n\n\t.. php:method:: some_method ( $foo [, $bar [, $bat]])\n\n\t\tThis function will perform some action. The ``$bar`` array must contain\n\t\ta something and something else, and along with ``$bat`` is an optional\n\t\tparameter.\n\n\t\t:param int $foo: the foo id to do something in\n\t\t:param mixed $bar: A data array that must contain a something and something else\n\t\t:param bool $bat: whether or not to do something\n\t\t:returns: FALSE on failure, TRUE if successful\n\t\t:rtype: bool\n\n\t\t::\n\n\t\t\t$this->load->library('some_class');\n\n\t\t\t$bar = array(\n\t\t\t\t'something'\t\t=> 'Here is this parameter!',\n\t\t\t\t'something_else'\t=> 42\n\t\t\t);\n\n\t\t\t$bat = $this->some_class->should_do_something();\n\n\t\t\tif ($this->some_class->some_method(4, $bar, $bat) === FALSE)\n\t\t\t{\n\t\t\t\tshow_error('An Error Occurred Doing Some Method');\n\t\t\t}\n\n\t\t.. note:: Here is something that you should be aware of when using some_method().\n\t\t\t\tFor real.\n\n\t\tSee also :meth:`Some_class::should_do_something`\n\n\n\t.. php:method:: should_do_something()\n\n\t\t:returns: Whether or not something should be done\n\t\t:rtype: bool\n"
  },
  {
    "path": "user_guide_src/source/general/alternative_php.rst",
    "content": "###################################\nAlternate PHP Syntax for View Files\n###################################\n\nIf you do not utilize CodeIgniter's :doc:`template\nengine <../libraries/parser>`, you'll be using pure PHP in your\nView files. To minimize the PHP code in these files, and to make it\neasier to identify the code blocks it is recommended that you use PHPs\nalternative syntax for control structures and short tag echo statements.\nIf you are not familiar with this syntax, it allows you to eliminate the\nbraces from your code, and eliminate \"echo\" statements.\n\nAlternative Echos\n=================\n\nNormally to echo, or print out a variable you would do this::\n\n\t\n\nWith the alternative syntax you can instead do it this way::\n\n\t\n\nAlternative Control Structures\n==============================\n\nControls structures, like if, for, foreach, and while can be written in\na simplified format as well. Here is an example using ``foreach``::\n\n\t
          \n\n\t\n\n\t\t
          • \n\n\t\n\n\t
        \n\nNotice that there are no braces. Instead, the end brace is replaced with\n``endforeach``. Each of the control structures listed above has a similar\nclosing syntax: ``endif``, ``endfor``, ``endforeach``, and ``endwhile``\n\nAlso notice that instead of using a semicolon after each structure\n(except the last one), there is a colon. This is important!\n\nHere is another example, using ``if``/``elseif``/``else``. Notice the colons::\n\n\t\n\n\t\t
        Hi Sally
        \n\n\t\n\n\t\t
        Hi Joe
        \n\n\t\n\n\t\t
        Hi unknown user
        \n\n\t\n"
  },
  {
    "path": "user_guide_src/source/general/ancillary_classes.rst",
    "content": "##########################\nCreating Ancillary Classes\n##########################\n\nIn some cases you may want to develop classes that exist apart from your\ncontrollers but have the ability to utilize all of CodeIgniter's\nresources. This is easily possible as you'll see.\n\nget_instance()\n==============\n\n.. php:function:: get_instance()\n\n\t:returns:\tReference to your controller's instance\n\t:rtype:\tCI_Controller\n\n**Any class that you instantiate within your controller methods can\naccess CodeIgniter's native resources** simply by using the\n``get_instance()`` function. This function returns the main\nCodeIgniter object.\n\nNormally, to call any of the available methods, CodeIgniter requires\nyou to use the ``$this`` construct::\n\n\t$this->load->helper('url');\n\t$this->load->library('session');\n\t$this->config->item('base_url');\n\t// etc.\n\n``$this``, however, only works within your controllers, your models,\nor your views. If you would like to use CodeIgniter's classes from\nwithin your own custom classes you can do so as follows:\n\nFirst, assign the CodeIgniter object to a variable::\n\n\t$CI =& get_instance();\n\nOnce you've assigned the object to a variable, you'll use that variable\n*instead* of ``$this``::\n\n\t$CI =& get_instance();\n\n\t$CI->load->helper('url');\n\t$CI->load->library('session');\n\t$CI->config->item('base_url');\n\t// etc.\n\nIf you'll be using ``get_instance()`` inside another class, then it would\nbe better if you assign it to a property. This way, you won't need to call\n``get_instance()`` in every single method.\n\nExample::\n\n\tclass Example {\n\n\t\tprotected $CI;\n\n\t\t// We'll use a constructor, as you can't directly call a function\n\t\t// from a property definition.\n\t\tpublic function __construct()\n\t\t{\n\t\t\t// Assign the CodeIgniter super-object\n\t\t\t$this->CI =& get_instance();\n\t\t}\n\n\t\tpublic function foo()\n\t\t{\n\t\t\t$this->CI->load->helper('url');\n\t\t\tredirect();\n\t\t}\n\n\t\tpublic function bar()\n\t\t{\n\t\t\t$this->CI->config->item('base_url');\n\t\t}\n\t}\n\nIn the above example, both methods ``foo()`` and ``bar()`` will work\nafter you instantiate the Example class, without the need to call\n``get_instance()`` in each of them.\n"
  },
  {
    "path": "user_guide_src/source/general/autoloader.rst",
    "content": "######################\nAuto-loading Resources\n######################\n\nCodeIgniter comes with an \"Auto-load\" feature that permits libraries,\nhelpers, and models to be initialized automatically every time the\nsystem runs. If you need certain resources globally throughout your\napplication you should consider auto-loading them for convenience.\n\nThe following items can be loaded automatically:\n\n-  Classes found in the *libraries/* directory\n-  Helper files found in the *helpers/* directory\n-  Custom config files found in the *config/* directory\n-  Language files found in the *system/language/* directory\n-  Models found in the *models/* folder\n\nTo autoload resources, open the **application/config/autoload.php**\nfile and add the item you want loaded to the autoload array. You'll\nfind instructions in that file corresponding to each type of item.\n\n.. note:: Do not include the file extension (.php) when adding items to\n\tthe autoload array.\n\nAdditionally, if you want CodeIgniter to use a `Composer `_\nauto-loader, just set ``$config['composer_autoload']`` to ``TRUE`` or\na custom path in **application/config/config.php**."
  },
  {
    "path": "user_guide_src/source/general/caching.rst",
    "content": "################\nWeb Page Caching\n################\n\nCodeIgniter lets you cache your pages in order to achieve maximum\nperformance.\n\nAlthough CodeIgniter is quite fast, the amount of dynamic information\nyou display in your pages will correlate directly to the server\nresources, memory, and processing cycles utilized, which affect your\npage load speeds. By caching your pages, since they are saved in their\nfully rendered state, you can achieve performance that nears that of\nstatic web pages.\n\nHow Does Caching Work?\n======================\n\nCaching can be enabled on a per-page basis, and you can set the length\nof time that a page should remain cached before being refreshed. When a\npage is loaded for the first time, the cache file will be written to\nyour application/cache folder. On subsequent page loads the cache file\nwill be retrieved and sent to the requesting user's browser. If it has\nexpired, it will be deleted and refreshed before being sent to the\nbrowser.\n\n.. note: The Benchmark tag is not cached so you can still view your page\n\tload speed when caching is enabled.\n\nEnabling Caching\n================\n\nTo enable caching, put the following tag in any of your controller\nmethods::\n\n\t$this->output->cache($n);\n\nWhere ``$n`` is the number of **minutes** you wish the page to remain\ncached between refreshes.\n\nThe above tag can go anywhere within a method. It is not affected by\nthe order that it appears, so place it wherever it seems most logical to\nyou. Once the tag is in place, your pages will begin being cached.\n\n.. important:: Because of the way CodeIgniter stores content for output,\n\tcaching will only work if you are generating display for your\n\tcontroller with a :doc:`view <./views>`.\n\n.. important:: If you change configuration options that might affect\n\tyour output, you have to manually delete your cache files.\n\n.. note:: Before the cache files can be written you must set the file\n\tpermissions on your *application/cache/* directory such that\n\tit is writable.\n\nDeleting Caches\n===============\n\nIf you no longer wish to cache a file you can remove the caching tag and\nit will no longer be refreshed when it expires.\n\n.. note:: Removing the tag will not delete the cache immediately. It will\n\thave to expire normally.\n\nIf you need to manually delete the cache, you can use the ``delete_cache()``\nmethod::\n\n\t// Deletes cache for the currently requested URI\n\t$this->output->delete_cache();\n\n\t// Deletes cache for /foo/bar\n\t$this->output->delete_cache('/foo/bar');"
  },
  {
    "path": "user_guide_src/source/general/cli.rst",
    "content": "###################\nRunning via the CLI\n###################\n\nAs well as calling an applications :doc:`Controllers <./controllers>`\nvia the URL in a browser they can also be loaded via the command-line\ninterface (CLI).\n\n.. contents:: Page Contents\n\nWhat is the CLI?\n================\n\nThe command-line interface is a text-based method of interacting with\ncomputers. For more information, check the `Wikipedia\narticle `_.\n\nWhy run via the command-line?\n=============================\n\nThere are many reasons for running CodeIgniter from the command-line,\nbut they are not always obvious.\n\n-  Run your cron-jobs without needing to use *wget* or *curl*\n-  Make your cron-jobs inaccessible from being loaded in the URL by\n   checking the return value of :php:func:`is_cli()`.\n-  Make interactive \"tasks\" that can do things like set permissions,\n   prune cache folders, run backups, etc.\n-  Integrate with other applications in other languages. For example, a\n   random C++ script could call one command and run code in your models!\n\nLet's try it: Hello World!\n==========================\n\nLet's create a simple controller so you can see it in action. Using your\ntext editor, create a file called Tools.php, and put the following code\nin it::\n\n\t \"cmd\"\nin Windows and navigate to our CodeIgniter project.\n\n.. code-block:: bash\n\n\t$ cd /path/to/project;\n\t$ php index.php tools message\n\nIf you did it right, you should see *Hello World!* printed.\n\n.. code-block:: bash\n\n\t$ php index.php tools message \"John Smith\"\n\nHere we are passing it an argument in the same way that URL parameters\nwork. \"John Smith\" is passed as an argument and the output is::\n\n\tHello John Smith!\n\nThat's it!\n==========\n\nThat, in a nutshell, is all there is to know about controllers on the\ncommand line. Remember that this is just a normal controller, so routing\nand ``_remap()`` works fine.\n"
  },
  {
    "path": "user_guide_src/source/general/common_functions.rst",
    "content": "################\nCommon Functions\n################\n\nCodeIgniter uses a few functions for its operation that are globally\ndefined, and are available to you at any point. These do not require\nloading any libraries or helpers.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\n.. php:function:: is_php($version)\n\n\t:param\tstring\t$version: Version number\n\t:returns:\tTRUE if the running PHP version is at least the one specified or FALSE if not\n\t:rtype:\tbool\n\n\tDetermines if the PHP version being used is greater than the\n\tsupplied version number.\n\n\tExample::\n\n\t\tif (is_php('5.5'))\n\t\t{\n\t\t\techo json_last_error_msg();\n\t\t}\n\n\tReturns boolean TRUE if the installed version of PHP is equal to or\n\tgreater than the supplied version number. Returns FALSE if the installed\n\tversion of PHP is lower than the supplied version number.\n\n.. php:function:: is_really_writable($file)\n\n\t:param\tstring\t$file: File path\n\t:returns:\tTRUE if the path is writable, FALSE if not\n\t:rtype:\tbool\n\n\t``is_writable()`` returns TRUE on Windows servers when you really can't\n\twrite to the file as the OS reports to PHP as FALSE only if the\n\tread-only attribute is marked.\n\n\tThis function determines if a file is actually writable by attempting\n\tto write to it first. Generally only recommended on platforms where\n\tthis information may be unreliable.\n\n\tExample::\n\n\t\tif (is_really_writable('file.txt'))\n\t\t{\n\t\t\techo \"I could write to this if I wanted to\";\n\t\t}\n\t\telse\n\t\t{\n\t\t\techo \"File is not writable\";\n\t\t}\n\n\t.. note:: See also `PHP bug #54709 `_ for more info.\n\n.. php:function:: config_item($key)\n\n\t:param\tstring\t$key: Config item key\n\t:returns:\tConfiguration key value or NULL if not found\n\t:rtype:\tmixed\n\n\tThe :doc:`Config Library <../libraries/config>` is the preferred way of\n\taccessing configuration information, however ``config_item()`` can be used\n\tto retrieve single keys. See :doc:`Config Library <../libraries/config>`\n\tdocumentation for more information.\n\n.. :noindex: function:: show_error($message, $status_code[, $heading = 'An Error Was Encountered'])\n\n\t:param\tmixed\t$message: Error message\n\t:param\tint\t$status_code: HTTP Response status code\n\t:param\tstring\t$heading: Error page heading\n\t:rtype:\tvoid\n\n\tThis function calls ``CI_Exception::show_error()``. For more info,\n\tplease see the :doc:`Error Handling ` documentation.\n\n.. :noindex: function:: show_404([$page = ''[, $log_error = TRUE]])\n\n\t:param\tstring\t$page: URI string\n\t:param\tbool\t$log_error: Whether to log the error\n\t:rtype:\tvoid\n\n\tThis function calls ``CI_Exception::show_404()``. For more info,\n\tplease see the :doc:`Error Handling ` documentation.\n\n.. :noindex: function:: log_message($level, $message)\n\n\t:param\tstring\t$level: Log level: 'error', 'debug' or 'info'\n\t:param\tstring\t$message: Message to log\n\t:rtype:\tvoid\n\n\tThis function is an alias for ``CI_Log::write_log()``. For more info,\n\tplease see the :doc:`Error Handling ` documentation.\n\n.. php:function:: set_status_header($code[, $text = ''])\n\n\t:param\tint\t$code: HTTP Response status code\n\t:param\tstring\t$text: A custom message to set with the status code\n\t:rtype:\tvoid\n\n\tPermits you to manually set a server status header. Example::\n\n\t\tset_status_header(401);\n\t\t// Sets the header as:  Unauthorized\n\n\t`See here `_ for\n\ta full list of headers.\n\n.. php:function:: remove_invisible_characters($str[, $url_encoded = TRUE])\n\n\t:param\tstring\t$str: Input string\n\t:param\tbool\t$url_encoded: Whether to remove URL-encoded characters as well\n\t:returns:\tSanitized string\n\t:rtype:\tstring\n\n\tThis function prevents inserting NULL characters between ASCII\n\tcharacters, like Java\\\\0script.\n\n\tExample::\n\n\t\tremove_invisible_characters('Java\\\\0script');\n\t\t// Returns: 'Javascript'\n\n.. php:function:: html_escape($var)\n\n\t:param\tmixed\t$var: Variable to escape (string or array)\n\t:returns:\tHTML escaped string(s)\n\t:rtype:\tmixed\n\n\tThis function acts as an alias for PHP's native ``htmlspecialchars()``\n\tfunction, with the advantage of being able to accept an array of strings.\n\n\tIt is useful in preventing Cross Site Scripting (XSS).\n\n.. php:function:: get_mimes()\n\n\t:returns:\tAn associative array of file types\n\t:rtype:\tarray\n\n\tThis function returns a *reference* to the MIMEs array from\n\t*application/config/mimes.php*.\n\n.. php:function:: is_https()\n\n\t:returns:\tTRUE if currently using HTTP-over-SSL, FALSE if not\n\t:rtype:\tbool\n\n\tReturns TRUE if a secure (HTTPS) connection is used and FALSE\n\tin any other case (including non-HTTP requests).\n\n.. php:function:: is_cli()\n\n\t:returns:\tTRUE if currently running under CLI, FALSE otherwise\n\t:rtype:\tbool\n\n\tReturns TRUE if the application is run through the command line\n\tand FALSE if not.\n\n\t.. note:: This function checks both if the ``PHP_SAPI`` value is 'cli'\n\t\tor if the ``STDIN`` constant is defined.\n\n.. php:function:: function_usable($function_name)\n\n\t:param\tstring\t$function_name: Function name\n\t:returns:\tTRUE if the function can be used, FALSE if not\n\t:rtype:\tbool\n\n\tReturns TRUE if a function exists and is usable, FALSE otherwise.\n\n\tThis function runs a ``function_exists()`` check and if the\n\t`Suhosin extension ` is loaded,\n\tchecks if it doesn't disable the function being checked.\n\n\tIt is useful if you want to check for the availability of functions\n\tsuch as ``eval()`` and ``exec()``, which are dangerous and might be\n\tdisabled on servers with highly restrictive security policies.\n\n\t.. note:: This function was introduced because Suhosin terminated\n\t\tscript execution, but this turned out to be a bug. A fix\n\t\thas been available for some time (version 0.9.34), but is\n\t\tunfortunately not released yet.\n"
  },
  {
    "path": "user_guide_src/source/general/compatibility_functions.rst",
    "content": "#######################\nCompatibility Functions\n#######################\n\nCodeIgniter provides a set of compatibility functions that enable\nyou to use functions what are otherwise natively available in PHP,\nbut only in higher versions or depending on a certain extension.\n\nBeing custom implementations, these functions will also have some\nset of dependencies on their own, but are still useful if your\nPHP setup doesn't offer them natively.\n\n.. note:: Much like the :doc:`common functions `, the\n\tcompatibility functions are always available, as long as\n\ttheir dependencies are met.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\n****************\nPassword Hashing\n****************\n\nThis set of compatibility functions offers a \"backport\" of PHP's\nstandard `Password Hashing extension `_\nthat is otherwise available only since PHP 5.5.\n\nDependencies\n============\n\n- ``CRYPT_BLOWFISH`` support for ``crypt()``\n\nConstants\n=========\n\n- ``PASSWORD_BCRYPT``\n- ``PASSWORD_DEFAULT``\n\nFunction reference\n==================\n\n.. php:function:: password_get_info($hash)\n\n\t:param\tstring\t$hash: Password hash\n\t:returns:\tInformation about the hashed password\n\t:rtype:\tarray\n\n\tFor more information, please refer to the `PHP manual for\n\tpassword_get_info() `_.\n\n.. php:function:: password_hash($password, $algo[, $options = array()])\n\n\t:param\tstring\t$password: Plain-text password\n\t:param\tint\t$algo: Hashing algorithm\n\t:param\tarray\t$options: Hashing options\n\t:returns:\tHashed password or FALSE on failure\n\t:rtype:\tstring\n\n\tFor more information, please refer to the `PHP manual for\n\tpassword_hash() `_.\n\n\t.. note:: Unless you provide your own (and valid) salt, this function\n\t\thas a further dependency on an available CSPRNG source. Each\n\t\tof the following would satisfy that:\n\t\t- ``mcrypt_create_iv()`` with ``MCRYPT_DEV_URANDOM``\n\t\t- ``openssl_random_pseudo_bytes()``\n\t\t- /dev/arandom\n\t\t- /dev/urandom\n\n.. php:function:: password_needs_rehash()\n\n\t:param\tstring\t$hash: Password hash\n\t:param\tint\t$algo: Hashing algorithm\n\t:param\tarray\t$options: Hashing options\n\t:returns:\tTRUE if the hash should be rehashed to match the given algorithm and options, FALSE otherwise\n\t:rtype:\tbool\n\n\tFor more information, please refer to the `PHP manual for\n\tpassword_needs_rehash() `_.\n\n.. php:function:: password_verify($password, $hash)\n\n\t:param\tstring\t$password: Plain-text password\n\t:param\tstring\t$hash: Password hash\n\t:returns:\tTRUE if the password matches the hash, FALSE if not\n\t:rtype:\tbool\n\n\tFor more information, please refer to the `PHP manual for\n\tpassword_verify() `_.\n\n*********************\nHash (Message Digest)\n*********************\n\nThis compatibility layer contains backports for the ``hash_equals()``\nand ``hash_pbkdf2()`` functions, which otherwise require PHP 5.6 and/or\nPHP 5.5 respectively.\n\nDependencies\n============\n\n- None\n\nFunction reference\n==================\n\n.. php:function:: hash_equals($known_string, $user_string)\n\n\t:param\tstring\t$known_string: Known string\n\t:param\tstring\t$user_string: User-supplied string\n\t:returns:\tTRUE if the strings match, FALSE otherwise\n\t:rtype:\tstring\n\n\tFor more information, please refer to the `PHP manual for\n\thash_equals() `_.\n\n.. php:function:: hash_pbkdf2($algo, $password, $salt, $iterations[, $length = 0[, $raw_output = FALSE]])\n\n\t:param\tstring\t$algo: Hashing algorithm\n\t:param\tstring\t$password: Password\n\t:param\tstring\t$salt: Hash salt\n\t:param\tint\t$iterations: Number of iterations to perform during derivation\n\t:param\tint\t$length: Output string length\n\t:param\tbool\t$raw_output: Whether to return raw binary data\n\t:returns:\tPassword-derived key or FALSE on failure\n\t:rtype:\tstring\n\n\tFor more information, please refer to the `PHP manual for\n\thash_pbkdf2() `_.\n\n****************\nMultibyte String\n****************\n\nThis set of compatibility functions offers limited support for PHP's\n`Multibyte String extension `_. Because of\nthe limited alternative solutions, only a few functions are available.\n\n.. note:: When a character set parameter is ommited,\n\t``$config['charset']`` will be used.\n\nDependencies\n============\n\n- `iconv `_ extension\n\n.. important:: This dependency is optional and these functions will\n\talways be declared. If iconv is not available, they WILL\n\tfall-back to their non-mbstring versions.\n\n.. important:: Where a character set is supplied, it must be\n\tsupported by iconv and in a format that it recognizes.\n\n.. note:: For you own dependency check on the actual mbstring\n\textension, use the ``MB_ENABLED`` constant.\n\nFunction reference\n==================\n\n.. php:function:: mb_strlen($str[, $encoding = NULL])\n\n\t:param\tstring\t$str: Input string\n\t:param\tstring\t$encoding: Character set\n\t:returns:\tNumber of characters in the input string or FALSE on failure\n\t:rtype:\tstring\n\n\tFor more information, please refer to the `PHP manual for\n\tmb_strlen() `_.\n\n.. php:function:: mb_strpos($haystack, $needle[, $offset = 0[, $encoding = NULL]])\n\n\t:param\tstring\t$haystack: String to search in\n\t:param\tstring\t$needle: Part of string to search for\n\t:param\tint\t$offset: Search offset\n\t:param\tstring\t$encoding: Character set\n\t:returns:\tNumeric character position of where $needle was found or FALSE if not found\n\t:rtype:\tmixed\n\n\tFor more information, please refer to the `PHP manual for\n\tmb_strpos() `_.\n\n.. php:function:: mb_substr($str, $start[, $length = NULL[, $encoding = NULL]])\n\n\t:param\tstring\t$str: Input string\n\t:param\tint\t$start: Position of first character\n\t:param\tint\t$length: Maximum number of characters\n\t:param\tstring\t$encoding: Character set\n\t:returns:\tPortion of $str specified by $start and $length or FALSE on failure\n\t:rtype:\tstring\n\n\tFor more information, please refer to the `PHP manual for\n\tmb_substr() `_.\n\n******************\nStandard Functions\n******************\n\nThis set of compatibility functions offers support for a few\nstandard functions in PHP that otherwise require a newer PHP version.\n\nDependencies\n============\n\n- None\n\nFunction reference\n==================\n\n.. php:function:: array_column(array $array, $column_key[, $index_key = NULL])\n\n\t:param\tarray\t$array: Array to fetch results from\n\t:param\tmixed\t$column_key: Key of the column to return values from\n\t:param\tmixed\t$index_key: Key to use for the returned values\n\t:returns:\tAn array of values representing a single column from the input array\n\t:rtype:\tarray\n\n\tFor more information, please refer to the `PHP manual for\n\tarray_column() `_.\n"
  },
  {
    "path": "user_guide_src/source/general/controllers.rst",
    "content": "###########\nControllers\n###########\n\nControllers are the heart of your application, as they determine how\nHTTP requests should be handled.\n\n.. contents:: Page Contents\n\nWhat is a Controller?\n=====================\n\n**A Controller is simply a class file that is named in a way that can be\nassociated with a URI.**\n\nConsider this URI::\n\n\texample.com/index.php/blog/\n\nIn the above example, CodeIgniter would attempt to find a controller\nnamed Blog.php and load it.\n\n**When a controller's name matches the first segment of a URI, it will\nbe loaded.**\n\nLet's try it: Hello World!\n==========================\n\nLet's create a simple controller so you can see it in action. Using your\ntext editor, create a file called Blog.php, and put the following code\nin it::\n\n\t`\n\tfeature, the segments passed to your method will be the re-routed\n\tones.\n\nDefining a Default Controller\n=============================\n\nCodeIgniter can be told to load a default controller when a URI is not\npresent, as will be the case when only your site root URL is requested.\nTo specify a default controller, open your **application/config/routes.php**\nfile and set this variable::\n\n\t$route['default_controller'] = 'blog';\n\nWhere 'blog' is the name of the controller class you want used. If you now\nload your main index.php file without specifying any URI segments you'll\nsee your \"Hello World\" message by default.\n\nFor more information, please refer to the \"Reserved Routes\" section of the\n:doc:`URI Routing ` documentation.\n\nRemapping Method Calls\n======================\n\nAs noted above, the second segment of the URI typically determines which\nmethod in the controller gets called. CodeIgniter permits you to override\nthis behavior through the use of the ``_remap()`` method::\n\n\tpublic function _remap()\n\t{\n\t\t// Some code here...\n\t}\n\n.. important:: If your controller contains a method named _remap(),\n\tit will **always** get called regardless of what your URI contains. It\n\toverrides the normal behavior in which the URI determines which method\n\tis called, allowing you to define your own method routing rules.\n\nThe overridden method call (typically the second segment of the URI) will\nbe passed as a parameter to the ``_remap()`` method::\n\n\tpublic function _remap($method)\n\t{\n\t\tif ($method === 'some_method')\n\t\t{\n\t\t\t$this->$method();\n\t\t}\n\t\telse\n\t\t{\n\t\t\t$this->default_method();\n\t\t}\n\t}\n\nAny extra segments after the method name are passed into ``_remap()`` as an\noptional second parameter. This array can be used in combination with\nPHP's `call_user_func_array() `_\nto emulate CodeIgniter's default behavior.\n\nExample::\n\n\tpublic function _remap($method, $params = array())\n\t{\n\t\t$method = 'process_'.$method;\n\t\tif (method_exists($this, $method))\n\t\t{\n\t\t\treturn call_user_func_array(array($this, $method), $params);\n\t\t}\n\t\tshow_404();\n\t}\n\nProcessing Output\n=================\n\nCodeIgniter has an output class that takes care of sending your final\nrendered data to the web browser automatically. More information on this\ncan be found in the :doc:`Views ` and :doc:`Output Class\n<../libraries/output>` pages. In some cases, however, you might want to\npost-process the finalized data in some way and send it to the browser\nyourself. CodeIgniter permits you to add a method named ``_output()``\nto your controller that will receive the finalized output data.\n\n.. important:: If your controller contains a method named ``_output()``,\n\tit will **always** be called by the output class instead of\n\techoing the finalized data directly. The first parameter of the\n\tmethod will contain the finalized output.\n\nHere is an example::\n\n\tpublic function _output($output)\n\t{\n\t\techo $output;\n\t}\n\n.. note::\n\n\tPlease note that your ``_output()`` method will receive the\n\tdata in its finalized state. Benchmark and memory usage data\n\twill be rendered, cache files written (if you have caching\n\tenabled), and headers will be sent (if you use that\n\t:doc:`feature <../libraries/output>`) before it is handed off\n\tto the ``_output()`` method.\n\tTo have your controller's output cached properly, its\n\t``_output()`` method can use::\n\n\t\tif ($this->output->cache_expiration > 0)\n\t\t{\n\t\t\t$this->output->_write_cache($output);\n\t\t}\n\n\tIf you are using this feature the page execution timer and\n\tmemory usage stats might not be perfectly accurate since they\n\twill not take into account any further processing you do.\n\tFor an alternate way to control output *before* any of the\n\tfinal processing is done, please see the available methods\n\tin the :doc:`Output Library <../libraries/output>`.\n\nPrivate methods\n===============\n\nIn some cases you may want certain methods hidden from public access.\nIn order to achieve this, simply declare the method as being private\nor protected and it will not be served via a URL request. For example,\nif you were to have a method like this::\n\n\tprivate function _utility()\n\t{\n\t\t// some code\n\t}\n\nTrying to access it via the URL, like this, will not work::\n\n\texample.com/index.php/blog/_utility/\n\n.. note:: Prefixing method names with an underscore will also prevent\n\tthem from being called. This is a legacy feature that is left\n\tfor backwards-compatibility.\n\nOrganizing Your Controllers into Sub-directories\n================================================\n\nIf you are building a large application you might want to hierarchically\norganize or structure your controllers into sub-directories. CodeIgniter\npermits you to do this.\n\nSimply create sub-directories under the main *application/controllers/*\none and place your controller classes within them.\n\n.. note:: When using this feature the first segment of your URI must\n\tspecify the folder. For example, let's say you have a controller located\n\there::\n\n\t\tapplication/controllers/products/Shoes.php\n\n\tTo call the above controller your URI will look something like this::\n\n\t\texample.com/index.php/products/shoes/show/123\n\nEach of your sub-directories may contain a default controller which will be\ncalled if the URL contains *only* the sub-directory. Simply put a controller\nin there that matches the name of your 'default_controller' as specified in\nyour *application/config/routes.php* file.\n\nCodeIgniter also permits you to remap your URIs using its :doc:`URI\nRouting ` feature.\n\nClass Constructors\n==================\n\nIf you intend to use a constructor in any of your Controllers, you\n**MUST** place the following line of code in it::\n\n\tparent::__construct();\n\nThe reason this line is necessary is because your local constructor will\nbe overriding the one in the parent controller class so we need to\nmanually call it.\n\nExample::\n\n\t` for a full\nlist.\n\n.. important:: You should also never have a method named identically\n\tto its class name. If you do, and there is no ``__construct()``\n\tmethod in the same class, then your e.g. ``Index::index()``\n\tmethod will be executed as a class constructor! This is a PHP4\n\tbackwards-compatibility feature.\n\nThat's it!\n==========\n\nThat, in a nutshell, is all there is to know about controllers.\n"
  },
  {
    "path": "user_guide_src/source/general/core_classes.rst",
    "content": "############################\nCreating Core System Classes\n############################\n\nEvery time CodeIgniter runs there are several base classes that are\ninitialized automatically as part of the core framework. It is possible,\nhowever, to swap any of the core system classes with your own versions\nor even extend the core versions.\n\n**Most users will never have any need to do this, but the option to\nreplace or extend them does exist for those who would like to\nsignificantly alter the CodeIgniter core.**\n\n.. note:: Messing with a core system class has a lot of implications, so\n\tmake sure you know what you are doing before attempting it.\n\nSystem Class List\n=================\n\nThe following is a list of the core system files that are invoked every\ntime CodeIgniter runs:\n\n-  Benchmark\n-  Config\n-  Controller\n-  Exceptions\n-  Hooks\n-  Input\n-  Language\n-  Loader\n-  Log\n-  Output\n-  Router\n-  Security\n-  URI\n-  Utf8\n\nReplacing Core Classes\n======================\n\nTo use one of your own system classes instead of a default one simply\nplace your version inside your local *application/core/* directory::\n\n\tapplication/core/some_class.php\n\nIf this directory does not exist you can create it.\n\nAny file named identically to one from the list above will be used\ninstead of the one normally used.\n\nPlease note that your class must use CI as a prefix. For example, if\nyour file is named Input.php the class will be named::\n\n\tclass CI_Input {\n\n\t}\n\nExtending Core Class\n====================\n\nIf all you need to do is add some functionality to an existing library -\nperhaps add a method or two - then it's overkill to replace the entire\nlibrary with your version. In this case it's better to simply extend the\nclass. Extending a class is nearly identical to replacing a class with a\ncouple exceptions:\n\n-  The class declaration must extend the parent class.\n-  Your new class name and filename must be prefixed with MY\\_ (this\n   item is configurable. See below.).\n\nFor example, to extend the native Input class you'll create a file named\napplication/core/MY_Input.php, and declare your class with::\n\n\tclass MY_Input extends CI_Input {\n\n\t}\n\n.. note:: If you need to use a constructor in your class make sure you\n\textend the parent constructor::\n\n\t\tclass MY_Input extends CI_Input {\n\n\t\t\tpublic function __construct()\n\t\t\t{\n\t\t\t\tparent::__construct();\n\t\t\t\t// Your own constructor code\n\t\t\t}\n\t\t}\n\n**Tip:** Any functions in your class that are named identically to the\nmethods in the parent class will be used instead of the native ones\n(this is known as \"method overriding\"). This allows you to substantially\nalter the CodeIgniter core.\n\nIf you are extending the Controller core class, then be sure to extend\nyour new class in your application controller's constructors.\n\n::\n\n\tclass Welcome extends MY_Controller {\n\n\t\tpublic function index()\n\t\t{\n\t\t\t$this->load->view('welcome_message');\n\t\t}\n\t}\n\nSetting Your Own Prefix\n-----------------------\n\nTo set your own sub-class prefix, open your\n*application/config/config.php* file and look for this item::\n\n\t$config['subclass_prefix'] = 'MY_';\n\nPlease note that all native CodeIgniter libraries are prefixed\nwith CI\\_ so DO NOT use that as your prefix.\n"
  },
  {
    "path": "user_guide_src/source/general/creating_drivers.rst",
    "content": "################\nCreating Drivers\n################\n\nDriver Directory and File Structure\n===================================\n\nSample driver directory and file structure layout:\n\n-  /application/libraries/Driver_name\n\n   -  Driver_name.php\n   -  drivers\n\n      -  Driver_name_subclass_1.php\n      -  Driver_name_subclass_2.php\n      -  Driver_name_subclass_3.php\n\n.. note:: In order to maintain compatibility on case-sensitive\n\tfile systems, the Driver_name directory must be\n\tnamed in the format returned by ``ucfirst()``.\n\n.. note:: The Driver library's architecture is such that\n\tthe subclasses don't extend and therefore don't inherit\n\tproperties or methods of the main driver."
  },
  {
    "path": "user_guide_src/source/general/creating_libraries.rst",
    "content": "##################\nCreating Libraries\n##################\n\nWhen we use the term \"Libraries\" we are normally referring to the\nclasses that are located in the libraries directory and described in the\nClass Reference of this user guide. In this case, however, we will\ninstead describe how you can create your own libraries within your\napplication/libraries directory in order to maintain separation between\nyour local resources and the global framework resources.\n\nAs an added bonus, CodeIgniter permits your libraries to extend native\nclasses if you simply need to add some functionality to an existing\nlibrary. Or you can even replace native libraries just by placing\nidentically named versions in your *application/libraries* directory.\n\nIn summary:\n\n-  You can create entirely new libraries.\n-  You can extend native libraries.\n-  You can replace native libraries.\n\nThe page below explains these three concepts in detail.\n\n.. note:: The Database classes can not be extended or replaced with your\n\town classes. All other classes are able to be replaced/extended.\n\nStorage\n=======\n\nYour library classes should be placed within your *application/libraries*\ndirectory, as this is where CodeIgniter will look for them when they are\ninitialized.\n\nNaming Conventions\n==================\n\n-  File names must be capitalized. For example: Myclass.php\n-  Class declarations must be capitalized. For example: class Myclass\n-  Class names and file names must match.\n\nThe Class File\n==============\n\nClasses should have this basic prototype::\n\n\t` methods you\ncan initialize your class using the standard::\n\n\t$this->load->library('someclass');\n\nWhere *someclass* is the file name, without the \".php\" file extension.\nYou can submit the file name capitalized or lower case. CodeIgniter\ndoesn't care.\n\nOnce loaded you can access your class using the lower case version::\n\n\t$this->someclass->some_method();  // Object instances will always be lower case\n\nPassing Parameters When Initializing Your Class\n===============================================\n\nIn the library loading method you can dynamically pass data as an\narray via the second parameter and it will be passed to your class\nconstructor::\n\n\t$params = array('type' => 'large', 'color' => 'red');\n\n\t$this->load->library('someclass', $params);\n\nIf you use this feature you must set up your class constructor to expect\ndata::\n\n\tload->helper('url');\n\t$this->load->library('session');\n\t$this->config->item('base_url');\n\t// etc.\n\n``$this``, however, only works directly within your controllers, your\nmodels, or your views. If you would like to use CodeIgniter's classes\nfrom within your own custom classes you can do so as follows:\n\nFirst, assign the CodeIgniter object to a variable::\n\n\t$CI =& get_instance();\n\nOnce you've assigned the object to a variable, you'll use that variable\n*instead* of ``$this``::\n\n\t$CI =& get_instance();\n\n\t$CI->load->helper('url');\n\t$CI->load->library('session');\n\t$CI->config->item('base_url');\n\t// etc.\n\n.. note:: You'll notice that the above ``get_instance()`` function is being\n\tpassed by reference::\n\t\n\t\t$CI =& get_instance();\n\n\tThis is very important. Assigning by reference allows you to use the\n\toriginal CodeIgniter object rather than creating a copy of it.\n\nHowever, since a library is a class, it would be better if you\ntake full advantage of the OOP principles. So, in order to\nbe able to use the CodeIgniter super-object in all of the class\nmethods, you're encouraged to assign it to a property instead::\n\n\tclass Example_library {\n\n\t\tprotected $CI;\n\n\t\t// We'll use a constructor, as you can't directly call a function\n\t\t// from a property definition.\n\t\tpublic function __construct()\n\t\t{\n\t\t\t// Assign the CodeIgniter super-object\n\t\t\t$this->CI =& get_instance();\n\t\t}\n\n\t\tpublic function foo()\n\t\t{\n\t\t\t$this->CI->load->helper('url');\n\t\t\tredirect();\n\t\t}\n\n\t\tpublic function bar()\n\t\t{\n\t\t\techo $this->CI->config->item('base_url');\n\t\t}\n\n\t}\n\nReplacing Native Libraries with Your Versions\n=============================================\n\nSimply by naming your class files identically to a native library will\ncause CodeIgniter to use it instead of the native one. To use this\nfeature you must name the file and the class declaration exactly the\nsame as the native library. For example, to replace the native Email\nlibrary you'll create a file named *application/libraries/Email.php*,\nand declare your class with::\n\n\tclass CI_Email {\n\t\n\t}\n\nNote that most native classes are prefixed with CI\\_.\n\nTo load your library you'll see the standard loading method::\n\n\t$this->load->library('email');\n\n.. note:: At this time the Database classes can not be replaced with\n\tyour own versions.\n\nExtending Native Libraries\n==========================\n\nIf all you need to do is add some functionality to an existing library -\nperhaps add a method or two - then it's overkill to replace the entire\nlibrary with your version. In this case it's better to simply extend the\nclass. Extending a class is nearly identical to replacing a class with a\ncouple exceptions:\n\n-  The class declaration must extend the parent class.\n-  Your new class name and filename must be prefixed with MY\\_ (this\n   item is configurable. See below.).\n\nFor example, to extend the native Email class you'll create a file named\n*application/libraries/MY_Email.php*, and declare your class with::\n\n\tclass MY_Email extends CI_Email {\n\n\t}\n\nIf you need to use a constructor in your class make sure you\nextend the parent constructor::\n\n\tclass MY_Email extends CI_Email {\n\n\t\tpublic function __construct($config = array())\n\t\t{\n\t\t\tparent::__construct($config);\n\t\t\t// Your own constructor code\n\t\t}\n\n\t}\n\n.. note:: Not all of the libraries have the same (or any) parameters\n\tin their constructor. Take a look at the library that you're\n\textending first to see how it should be implemented.\n\nLoading Your Sub-class\n----------------------\n\nTo load your sub-class you'll use the standard syntax normally used. DO\nNOT include your prefix. For example, to load the example above, which\nextends the Email class, you will use::\n\n\t$this->load->library('email');\n\nOnce loaded you will use the class variable as you normally would for\nthe class you are extending. In the case of the email class all calls\nwill use::\n\n\t$this->email->some_method();\n\nSetting Your Own Prefix\n-----------------------\n\nTo set your own sub-class prefix, open your\n*application/config/config.php* file and look for this item::\n\n\t$config['subclass_prefix'] = 'MY_';\n\nPlease note that all native CodeIgniter libraries are prefixed with CI\\_\nso DO NOT use that as your prefix.\n"
  },
  {
    "path": "user_guide_src/source/general/credits.rst",
    "content": "#######\nCredits\n#######\n\nCodeIgniter was originally developed by `Rick Ellis `_\n(CEO of `EllisLab, Inc. `_). The framework was written for\nperformance in the real world, with many of the class libraries, helpers, and\nsub-systems borrowed from the code-base of `ExpressionEngine\n`_.\n\nIt was, for years, developed and maintained by EllisLab, the ExpressionEngine\nDevelopment Team and a group of community members called the Reactor Team.\n\nIn 2014, CodeIgniter was acquired by the `British Columbia Institute of Technology\n`_ and was then officially announced as a community-maintained\nproject.\n\nBleeding edge development is spearheaded by the handpicked contributors\nof the Reactor Team.\n\nA hat tip goes to Ruby on Rails for inspiring us to create a PHP framework, and\nfor bringing frameworks into the general consciousness of the web community."
  },
  {
    "path": "user_guide_src/source/general/drivers.rst",
    "content": "#########################\nUsing CodeIgniter Drivers\n#########################\n\nDrivers are a special type of Library that has a parent class and any\nnumber of potential child classes. Child classes have access to the\nparent class, but not their siblings. Drivers provide an elegant syntax\nin your :doc:`controllers ` for libraries that benefit\nfrom or require being broken down into discrete classes.\n\nDrivers are found in the *system/libraries/* directory, in their own\nsub-directory which is identically named to the parent library class.\nAlso inside that directory is a subdirectory named drivers, which\ncontains all of the possible child class files.\n\nTo use a driver you will initialize it within a controller using the\nfollowing initialization method::\n\n\t$this->load->driver('class_name');\n\nWhere class name is the name of the driver class you want to invoke. For\nexample, to load a driver named \"Some_parent\" you would do this::\n\n\t$this->load->driver('some_parent');\n\nMethods of that class can then be invoked with::\n\n\t$this->some_parent->some_method();\n\nThe child classes, the drivers themselves, can then be called directly\nthrough the parent class, without initializing them::\n\n\t$this->some_parent->child_one->some_method();\n\t$this->some_parent->child_two->another_method();\n\nCreating Your Own Drivers\n=========================\n\nPlease read the section of the user guide that discusses how to :doc:`create\nyour own drivers `."
  },
  {
    "path": "user_guide_src/source/general/environments.rst",
    "content": "##############################\nHandling Multiple Environments\n##############################\n\nDevelopers often desire different system behavior depending on whether\nan application is running in a development or production environment.\nFor example, verbose error output is something that would be useful\nwhile developing an application, but it may also pose a security issue\nwhen \"live\".\n\nThe ENVIRONMENT Constant\n========================\n\nBy default, CodeIgniter comes with the environment constant set to use\nthe value provided in ``$_SERVER['CI_ENV']``, otherwise defaults to\n'development'. At the top of index.php, you will see::\n\n\tdefine('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'development');\n\nThis server variable can be set in your .htaccess file, or Apache \nconfig using `SetEnv `_. \nAlternative methods are available for nginx and other servers, or you can \nremove this logic entirely and set the constant based on the server's IP address.\n\nIn addition to affecting some basic framework behavior (see the next\nsection), you may use this constant in your own development to\ndifferentiate between which environment you are running in.\n\nEffects On Default Framework Behavior\n=====================================\n\nThere are some places in the CodeIgniter system where the ENVIRONMENT\nconstant is used. This section describes how default framework behavior\nis affected.\n\nError Reporting\n---------------\n\nSetting the ENVIRONMENT constant to a value of 'development' will cause\nall PHP errors to be rendered to the browser when they occur.\nConversely, setting the constant to 'production' will disable all error\noutput. Disabling error reporting in production is a :doc:`good security\npractice `.\n\nConfiguration Files\n-------------------\n\nOptionally, you can have CodeIgniter load environment-specific\nconfiguration files. This may be useful for managing things like\ndiffering API keys across multiple environments. This is described in\nmore detail in the environment section of the :doc:`Config Class\n<../libraries/config>` documentation."
  },
  {
    "path": "user_guide_src/source/general/errors.rst",
    "content": "##############\nError Handling\n##############\n\nCodeIgniter lets you build error reporting into your applications using\nthe functions described below. In addition, it has an error logging\nclass that permits error and debugging messages to be saved as text\nfiles.\n\n.. note:: By default, CodeIgniter displays all PHP errors. You might\n\twish to change this behavior once your development is complete. You'll\n\tfind the error_reporting() function located at the top of your main\n\tindex.php file. Disabling error reporting will NOT prevent log files\n\tfrom being written if there are errors.\n\nUnlike most systems in CodeIgniter, the error functions are simple\nprocedural interfaces that are available globally throughout the\napplication. This approach permits error messages to get triggered\nwithout having to worry about class/function scoping.\n\nCodeIgniter also returns a status code whenever a portion of the core\ncalls ``exit()``. This exit status code is separate from the HTTP status\ncode, and serves as a notice to other processes that may be watching of\nwhether the script completed successfully, or if not, what kind of\nproblem it encountered that caused it to abort. These values are\ndefined in *application/config/constants.php*. While exit status codes\nare most useful in CLI settings, returning the proper code helps server\nsoftware keep track of your scripts and the health of your application.\n\nThe following functions let you generate errors:\n\n.. php:function:: show_error($message, $status_code, $heading = 'An Error Was Encountered')\n\n\t:param\tmixed\t$message: Error message\n\t:param\tint\t$status_code: HTTP Response status code\n\t:param\tstring\t$heading: Error page heading\n\t:rtype:\tvoid\n\n\tThis function will display the error message supplied to it using\n\tthe error template appropriate to your execution::\n\n\t\tapplication/views/errors/html/error_general.php\n\n\tor:\n\n\t\tapplication/views/errors/cli/error_general.php\n\n\tThe optional parameter ``$status_code`` determines what HTTP status\n\tcode should be sent with the error. If ``$status_code`` is less\n\tthan 100, the HTTP status code will be set to 500, and the exit\n\tstatus code will be set to ``$status_code + EXIT__AUTO_MIN``.\n\tIf that value is larger than ``EXIT__AUTO_MAX``, or if\n\t``$status_code`` is 100 or higher, the exit status code will be set\n\tto ``EXIT_ERROR``.\n\tYou can check in *application/config/constants.php* for more detail.\n\n.. php:function:: show_404($page = '', $log_error = TRUE)\n\n\t:param\tstring\t$page: URI string\n\t:param\tbool\t$log_error: Whether to log the error\n\t:rtype:\tvoid\n\n\tThis function will display the 404 error message supplied to it\n\tusing the error template appropriate to your execution::\n\n\t\tapplication/views/errors/html/error_404.php\n\n\tor:\n\n\t\tapplication/views/errors/cli/error_404.php\n\n\tThe function expects the string passed to it to be the file path to\n\tthe page that isn't found. The exit status code will be set to\n\t``EXIT_UNKNOWN_FILE``.\n\tNote that CodeIgniter automatically shows 404 messages if\n\tcontrollers are not found.\n\n\tCodeIgniter automatically logs any ``show_404()`` calls. Setting the\n\toptional second parameter to FALSE will skip logging.\n\n.. php:function:: log_message($level, $message)\n\n\t:param\tstring\t$level: Log level: 'error', 'debug' or 'info'\n\t:param\tstring\t$message: Message to log\n\t:rtype:\tvoid\n\n\tThis function lets you write messages to your log files. You must\n\tsupply one of three \"levels\" in the first parameter, indicating what\n\ttype of message it is (debug, error, info), with the message itself\n\tin the second parameter.\n\n\tExample::\n\n\t\tif ($some_var == '')\n\t\t{\n\t\t\tlog_message('error', 'Some variable did not contain a value.');\n\t\t}\n\t\telse\n\t\t{\n\t\t\tlog_message('debug', 'Some variable was correctly set');\n\t\t}\n\n\t\tlog_message('info', 'The purpose of some variable is to provide some value.');\n\n\tThere are three message types:\n\n\t#. Error Messages. These are actual errors, such as PHP errors or\n\t   user errors.\n\t#. Debug Messages. These are messages that assist in debugging. For\n\t   example, if a class has been initialized, you could log this as\n\t   debugging info.\n\t#. Informational Messages. These are the lowest priority messages,\n\t   simply giving information regarding some process.\n\n\t.. note:: In order for the log file to actually be written, the\n\t\t*logs/* directory must be writable. In addition, you must\n\t\tset the \"threshold\" for logging in\n\t\t*application/config/config.php*. You might, for example,\n\t\tonly want error messages to be logged, and not the other\n\t\ttwo types. If you set it to zero logging will be disabled.\n"
  },
  {
    "path": "user_guide_src/source/general/helpers.rst",
    "content": "################\nHelper Functions\n################\n\nHelpers, as the name suggests, help you with tasks. Each helper file is\nsimply a collection of functions in a particular category. There are **URL\nHelpers**, that assist in creating links, there are Form Helpers that help\nyou create form elements, **Text Helpers** perform various text formatting\nroutines, **Cookie Helpers** set and read cookies, File Helpers help you\ndeal with files, etc.\n\nUnlike most other systems in CodeIgniter, Helpers are not written in an\nObject Oriented format. They are simple, procedural functions. Each\nhelper function performs one specific task, with no dependence on other\nfunctions.\n\nCodeIgniter does not load Helper Files by default, so the first step in\nusing a Helper is to load it. Once loaded, it becomes globally available\nin your :doc:`controller <../general/controllers>` and\n:doc:`views <../general/views>`.\n\nHelpers are typically stored in your **system/helpers**, or\n**application/helpers directory**. CodeIgniter will look first in your\n**application/helpers directory**. If the directory does not exist or the\nspecified helper is not located there CI will instead look in your\nglobal *system/helpers/* directory.\n\nLoading a Helper\n================\n\nLoading a helper file is quite simple using the following method::\n\n\t$this->load->helper('name');\n\nWhere **name** is the file name of the helper, without the .php file\nextension or the \"helper\" part.\n\nFor example, to load the **URL Helper** file, which is named\n**url_helper.php**, you would do this::\n\n\t$this->load->helper('url');\n\nA helper can be loaded anywhere within your controller methods (or\neven within your View files, although that's not a good practice), as\nlong as you load it before you use it. You can load your helpers in your\ncontroller constructor so that they become available automatically in\nany function, or you can load a helper in a specific function that needs\nit.\n\n.. note:: The Helper loading method above does not return a value, so\n\tdon't try to assign it to a variable. Just use it as shown.\n\nLoading Multiple Helpers\n========================\n\nIf you need to load more than one helper you can specify them in an\narray, like this::\n\n\t$this->load->helper(\n\t\tarray('helper1', 'helper2', 'helper3')\n\t);\n\nAuto-loading Helpers\n====================\n\nIf you find that you need a particular helper globally throughout your\napplication, you can tell CodeIgniter to auto-load it during system\ninitialization. This is done by opening the **application/config/autoload.php**\nfile and adding the helper to the autoload array.\n\nUsing a Helper\n==============\n\nOnce you've loaded the Helper File containing the function you intend to\nuse, you'll call it the way you would a standard PHP function.\n\nFor example, to create a link using the ``anchor()`` function in one of\nyour view files you would do this::\n\n\t\n\nWhere \"Click Here\" is the name of the link, and \"blog/comments\" is the\nURI to the controller/method you wish to link to.\n\n\"Extending\" Helpers\n===================\n\nTo \"extend\" Helpers, create a file in your **application/helpers/** folder\nwith an identical name to the existing Helper, but prefixed with **MY\\_**\n(this item is configurable. See below.).\n\nIf all you need to do is add some functionality to an existing helper -\nperhaps add a function or two, or change how a particular helper\nfunction operates - then it's overkill to replace the entire helper with\nyour version. In this case it's better to simply \"extend\" the Helper.\n\n.. note:: The term \"extend\" is used loosely since Helper functions are\n\tprocedural and discrete and cannot be extended in the traditional\n\tprogrammatic sense. Under the hood, this gives you the ability to\n\tadd to or or to replace the functions a Helper provides.\n\nFor example, to extend the native **Array Helper** you'll create a file\nnamed **application/helpers/MY_array_helper.php**, and add or override\nfunctions::\n\n\t// any_in_array() is not in the Array Helper, so it defines a new function\n\tfunction any_in_array($needle, $haystack)\n\t{\n\t\t$needle = is_array($needle) ? $needle : array($needle);\n\n\t\tforeach ($needle as $item)\n\t\t{\n\t\t\tif (in_array($item, $haystack))\n\t\t\t{\n\t\t\t\treturn TRUE;\n\t\t\t}\n\t        }\n\n\t\treturn FALSE;\n\t}\n\n\t// random_element() is included in Array Helper, so it overrides the native function\n\tfunction random_element($array)\n\t{\n\t\tshuffle($array);\n\t\treturn array_pop($array);\n\t}\n\nSetting Your Own Prefix\n-----------------------\n\nThe filename prefix for \"extending\" Helpers is the same used to extend\nlibraries and core classes. To set your own prefix, open your\n**application/config/config.php** file and look for this item::\n\n\t$config['subclass_prefix'] = 'MY_';\n\nPlease note that all native CodeIgniter libraries are prefixed with **CI\\_**\nso DO NOT use that as your prefix.\n\nNow What?\n=========\n\nIn the Table of Contents you'll find a list of all the available Helper\nFiles. Browse each one to see what they do."
  },
  {
    "path": "user_guide_src/source/general/hooks.rst",
    "content": "####################################\nHooks - Extending the Framework Core\n####################################\n\nCodeIgniter's Hooks feature provides a means to tap into and modify the\ninner workings of the framework without hacking the core files. When\nCodeIgniter runs it follows a specific execution process, diagramed in\nthe :doc:`Application Flow <../overview/appflow>` page. There may be\ninstances, however, where you'd like to cause some action to take place\nat a particular stage in the execution process. For example, you might\nwant to run a script right before your controllers get loaded, or right\nafter, or you might want to trigger one of your own scripts in some\nother location.\n\nEnabling Hooks\n==============\n\nThe hooks feature can be globally enabled/disabled by setting the\nfollowing item in the **application/config/config.php** file::\n\n\t$config['enable_hooks'] = TRUE;\n\nDefining a Hook\n===============\n\nHooks are defined in the **application/config/hooks.php** file.\nEach hook is specified as an array with this prototype::\n\n\t$hook['pre_controller'] = array(\n\t\t'class'    => 'MyClass',\n\t\t'function' => 'Myfunction',\n\t\t'filename' => 'Myclass.php',\n\t\t'filepath' => 'hooks',\n\t\t'params'   => array('beer', 'wine', 'snacks')\n\t);\n\n**Notes:**\n\nThe array index correlates to the name of the particular hook point you\nwant to use. In the above example the hook point is pre_controller. A\nlist of hook points is found below. The following items should be\ndefined in your associative hook array:\n\n-  **class** The name of the class you wish to invoke. If you prefer to\n   use a procedural function instead of a class, leave this item blank.\n-  **function** The function (or method) name you wish to call.\n-  **filename** The file name containing your class/function.\n-  **filepath** The name of the directory containing your script.\n   Note:\n   Your script must be located in a directory INSIDE your *application/*\n   directory, so the file path is relative to that directory. For example,\n   if your script is located in *application/hooks/*, you will simply use\n   'hooks' as your filepath. If your script is located in\n   *application/hooks/utilities/* you will use 'hooks/utilities' as your\n   filepath. No trailing slash.\n-  **params** Any parameters you wish to pass to your script. This item\n   is optional.\n\nYou can also use lambda/anoymous functions (or closures) as hooks, with\na simpler syntax::\n\n\t$hook['post_controller'] = function()\n\t{\n\t\t/* do something here */\n\t};\n\nMultiple Calls to the Same Hook\n===============================\n\nIf want to use the same hook point with more than one script, simply\nmake your array declaration multi-dimensional, like this::\n\n\t$hook['pre_controller'][] = array(\n\t\t'class'    => 'MyClass',\n\t\t'function' => 'MyMethod',\n\t\t'filename' => 'Myclass.php',\n\t\t'filepath' => 'hooks',\n\t\t'params'   => array('beer', 'wine', 'snacks')\n\t);\n\n\t$hook['pre_controller'][] = array(\n\t\t'class'    => 'MyOtherClass',\n\t\t'function' => 'MyOtherMethod',\n\t\t'filename' => 'Myotherclass.php',\n\t\t'filepath' => 'hooks',\n\t\t'params'   => array('red', 'yellow', 'blue')\n\t);\n\nNotice the brackets after each array index::\n\n\t$hook['pre_controller'][]\n\nThis permits you to have the same hook point with multiple scripts. The\norder you define your array will be the execution order.\n\nHook Points\n===========\n\nThe following is a list of available hook points.\n\n-  **pre_system**\n   Called very early during system execution. Only the benchmark and\n   hooks class have been loaded at this point. No routing or other\n   processes have happened.\n-  **pre_controller**\n   Called immediately prior to any of your controllers being called.\n   All base classes, routing, and security checks have been done.\n-  **post_controller_constructor**\n   Called immediately after your controller is instantiated, but prior\n   to any method calls happening.\n-  **post_controller**\n   Called immediately after your controller is fully executed.\n-  **display_override**\n   Overrides the ``_display()`` method, used to send the finalized page\n   to the web browser at the end of system execution. This permits you\n   to use your own display methodology. Note that you will need to\n   reference the CI superobject with ``$this->CI =& get_instance()`` and\n   then the finalized data will be available by calling\n   ``$this->CI->output->get_output()``.\n-  **cache_override**\n   Enables you to call your own method instead of the ``_display_cache()``\n   method in the :doc:`Output Library <../libraries/output>`. This permits\n   you to use your own cache display mechanism.\n-  **post_system**\n   Called after the final rendered page is sent to the browser, at the\n   end of system execution after the finalized data is sent to the\n   browser."
  },
  {
    "path": "user_guide_src/source/general/index.rst",
    "content": "##############\nGeneral Topics\n##############\n\n.. toctree::\n\t:titlesonly:\n\t\n\turls\n\tcontrollers\n\treserved_names\n\tviews\n\tmodels\n\tHelpers \n\tlibraries\n\tcreating_libraries\n\tdrivers\n\tcreating_drivers\n\tcore_classes\n\tancillary_classes\n\thooks\n\tautoloader\n\tcommon_functions\n\tcompatibility_functions\n\trouting\n\terrors\n\tCaching \n\tprofiling\n\tcli\n\tmanaging_apps\n\tenvironments\n\talternative_php\n\tsecurity\n\tPHP Style Guide "
  },
  {
    "path": "user_guide_src/source/general/libraries.rst",
    "content": "###########################\nUsing CodeIgniter Libraries\n###########################\n\nAll of the available libraries are located in your *system/libraries/*\ndirectory. In most cases, to use one of these classes involves initializing\nit within a :doc:`controller ` using the following\ninitialization method::\n\n\t$this->load->library('class_name');\n\nWhere 'class_name' is the name of the class you want to invoke. For\nexample, to load the :doc:`Form Validation Library\n<../libraries/form_validation>` you would do this::\n\n\t$this->load->library('form_validation');\n\nOnce initialized you can use it as indicated in the user guide page\ncorresponding to that class.\n\nAdditionally, multiple libraries can be loaded at the same time by\npassing an array of libraries to the load method.\n\nExample::\n\n\t$this->load->library(array('email', 'table'));\n\nCreating Your Own Libraries\n===========================\n\nPlease read the section of the user guide that discusses how to\n:doc:`create your own libraries `."
  },
  {
    "path": "user_guide_src/source/general/managing_apps.rst",
    "content": "##########################\nManaging your Applications\n##########################\n\nBy default it is assumed that you only intend to use CodeIgniter to\nmanage one application, which you will build in your *application/*\ndirectory. It is possible, however, to have multiple sets of\napplications that share a single CodeIgniter installation, or even to\nrename or relocate your application directory.\n\nRenaming the Application Directory\n==================================\n\nIf you would like to rename your application directory you may do so\nas long as you open your main index.php file and set its name using\nthe ``$application_folder`` variable::\n\n\t$application_folder = 'application';\n\nRelocating your Application Directory\n=====================================\n\nIt is possible to move your application directory to a different\nlocation on your server than your web root. To do so open\nyour main index.php and set a *full server path* in the\n``$application_folder`` variable::\n\n\t$application_folder = '/path/to/your/application';\n\nRunning Multiple Applications with one CodeIgniter Installation\n===============================================================\n\nIf you would like to share a common CodeIgniter installation to manage\nseveral different applications simply put all of the directories located\ninside your application directory into their own sub-directory.\n\nFor example, let's say you want to create two applications, named \"foo\"\nand \"bar\". You could structure your application directories like this::\n\n\tapplications/foo/\n\tapplications/foo/config/\n\tapplications/foo/controllers/\n\tapplications/foo/libraries/\n\tapplications/foo/models/\n\tapplications/foo/views/\n\tapplications/bar/\n\tapplications/bar/config/\n\tapplications/bar/controllers/\n\tapplications/bar/libraries/\n\tapplications/bar/models/\n\tapplications/bar/views/\n\nTo select a particular application for use requires that you open your\nmain index.php file and set the ``$application_folder`` variable. For\nexample, to select the \"foo\" application for use you would do this::\n\n\t$application_folder = 'applications/foo';\n\n.. note:: Each of your applications will need its own index.php file\n\twhich calls the desired application. The index.php file can be named\n\tanything you want."
  },
  {
    "path": "user_guide_src/source/general/models.rst",
    "content": "######\nModels\n######\n\nModels are **optionally** available for those who want to use a more\ntraditional MVC approach.\n\n.. contents:: Page Contents\n\nWhat is a Model?\n================\n\nModels are PHP classes that are designed to work with information in\nyour database. For example, let's say you use CodeIgniter to manage a\nblog. You might have a model class that contains functions to insert,\nupdate, and retrieve your blog data. Here is an example of what such a\nmodel class might look like::\n\n\tclass Blog_model extends CI_Model {\n\n\t\tpublic $title;\n\t\tpublic $content;\n\t\tpublic $date;\n\n\t\tpublic function get_last_ten_entries()\n\t\t{\n\t\t\t$query = $this->db->get('entries', 10);\n\t\t\treturn $query->result();\n\t\t}\n\n\t\tpublic function insert_entry()\n\t\t{\n\t\t\t$this->title\t= $_POST['title']; // please read the below note\n\t\t\t$this->content\t= $_POST['content'];\n\t\t\t$this->date\t= time();\n\n\t\t\t$this->db->insert('entries', $this);\n\t\t}\n\n\t\tpublic function update_entry()\n\t\t{\n\t\t\t$this->title\t= $_POST['title'];\n\t\t\t$this->content\t= $_POST['content'];\n\t\t\t$this->date\t= time();\n\n\t\t\t$this->db->update('entries', $this, array('id' => $_POST['id']));\n\t\t}\n\n\t}\n\n.. note:: The methods in the above example use the :doc:`Query Builder\n\t<../database/query_builder>` database methods.\n\n.. note:: For the sake of simplicity in this example we're using ``$_POST``\n\tdirectly. This is generally bad practice, and a more common approach\n\twould be to use the :doc:`Input Library <../libraries/input>`\n\t``$this->input->post('title')``.\n\nAnatomy of a Model\n==================\n\nModel classes are stored in your **application/models/** directory.\nThey can be nested within sub-directories if you want this type of\norganization.\n\nThe basic prototype for a model class is this::\n\n\tclass Model_name extends CI_Model {\n\n\t}\n\nWhere **Model_name** is the name of your class. Class names **must** have\nthe first letter capitalized with the rest of the name lowercase. Make\nsure your class extends the base Model class.\n\nThe file name must match the class name. For example, if this is your class::\n\n\tclass User_model extends CI_Model {\n\n\t}\n\nYour file will be this::\n\n\tapplication/models/User_model.php\n\nLoading a Model\n===============\n\nYour models will typically be loaded and called from within your\n:doc:`controller ` methods. To load a model you will use\nthe following method::\n\n\t$this->load->model('model_name');\n\nIf your model is located in a sub-directory, include the relative path\nfrom your models directory. For example, if you have a model located at\n*application/models/blog/Queries.php* you'll load it using::\n\n\t$this->load->model('blog/queries');\n\nOnce loaded, you will access your model methods using an object with the\nsame name as your class::\n\n\t$this->load->model('model_name');\n\n\t$this->model_name->method();\n\nIf you would like your model assigned to a different object name you can\nspecify it via the second parameter of the loading method::\n\n\t$this->load->model('model_name', 'foobar');\n\n\t$this->foobar->method();\n\nHere is an example of a controller, that loads a model, then serves a\nview::\n\n\tclass Blog_controller extends CI_Controller {\n\n\t\tpublic function blog()\n\t\t{\n\t\t\t$this->load->model('blog');\n\n\t\t\t$data['query'] = $this->blog->get_last_ten_entries();\n\n\t\t\t$this->load->view('blog', $data);\n\t\t}\n\t}\n\t\n\nAuto-loading Models\n===================\n\nIf you find that you need a particular model globally throughout your\napplication, you can tell CodeIgniter to auto-load it during system\ninitialization. This is done by opening the\n**application/config/autoload.php** file and adding the model to the\nautoload array.\n\nConnecting to your Database\n===========================\n\nWhen a model is loaded it does **NOT** connect automatically to your\ndatabase. The following options for connecting are available to you:\n\n-  You can connect using the standard database methods :doc:`described\n   here <../database/connecting>`, either from within your\n   Controller class or your Model class.\n-  You can tell the model loading method to auto-connect by passing\n   TRUE (boolean) via the third parameter, and connectivity settings,\n   as defined in your database config file will be used::\n\n\t$this->load->model('model_name', '', TRUE);\n\n-  You can manually pass database connectivity settings via the third\n   parameter::\n\n\t$config['hostname'] = 'localhost';\n\t$config['username'] = 'myusername';\n\t$config['password'] = 'mypassword';\n\t$config['database'] = 'mydatabase';\n\t$config['dbdriver'] = 'mysqli';\n\t$config['dbprefix'] = '';\n\t$config['pconnect'] = FALSE;\n\t$config['db_debug'] = TRUE;\n\n\t$this->load->model('model_name', '', $config);\n"
  },
  {
    "path": "user_guide_src/source/general/profiling.rst",
    "content": "##########################\nProfiling Your Application\n##########################\n\nThe Profiler Class will display benchmark results, queries you have run,\nand ``$_POST`` data at the bottom of your pages. This information can be\nuseful during development in order to help with debugging and\noptimization.\n\nInitializing the Class\n======================\n\n.. important:: This class does NOT need to be initialized. It is loaded\n\tautomatically by the :doc:`Output Library <../libraries/output>`\n\tif profiling is enabled as shown below.\n\nEnabling the Profiler\n=====================\n\nTo enable the profiler place the following line anywhere within your\n:doc:`Controller ` methods::\n\n\t$this->output->enable_profiler(TRUE);\n\nWhen enabled a report will be generated and inserted at the bottom of\nyour pages.\n\nTo disable the profiler you will use::\n\n\t$this->output->enable_profiler(FALSE);\n\nSetting Benchmark Points\n========================\n\nIn order for the Profiler to compile and display your benchmark data you\nmust name your mark points using specific syntax.\n\nPlease read the information on setting Benchmark points in the\n:doc:`Benchmark Library <../libraries/benchmark>` page.\n\nEnabling and Disabling Profiler Sections\n========================================\n\nEach section of Profiler data can be enabled or disabled by setting a\ncorresponding config variable to TRUE or FALSE. This can be done one of\ntwo ways. First, you can set application wide defaults with the\n*application/config/profiler.php* config file.\n\nExample::\n\n\t$config['config']          = FALSE;\n\t$config['queries']         = FALSE;\n\nIn your controllers, you can override the defaults and config file\nvalues by calling the ``set_profiler_sections()`` method of the\n:doc:`Output Library <../libraries/output>`::\n\n\t$sections = array(\n\t\t'config'  => TRUE,\n\t\t'queries' => TRUE\n\t);\n\n\t$this->output->set_profiler_sections($sections);\n\nAvailable sections and the array key used to access them are described\nin the table below.\n\n======================= =================================================================== ========\nKey                     Description                                                         Default\n======================= =================================================================== ========\n**benchmarks**          Elapsed time of Benchmark points and total execution time           TRUE\n**config**              CodeIgniter Config variables                                        TRUE\n**controller_info**     The Controller class and method requested                           TRUE\n**get**                 Any GET data passed in the request                                  TRUE\n**http_headers**        The HTTP headers for the current request                            TRUE\n**memory_usage**        Amount of memory consumed by the current request, in bytes          TRUE\n**post**                Any POST data passed in the request                                 TRUE\n**queries**             Listing of all database queries executed, including execution time  TRUE\n**uri_string**          The URI of the current request                                      TRUE\n**session_data**        Data stored in the current session                                  TRUE\n**query_toggle_count**  The number of queries after which the query block will default to   25\n                        hidden.\n======================= =================================================================== ========\n\n.. note:: Disabling the :doc:`save_queries ` setting in\n\tyour database configuration will also effectively disable profiling for\n\tdatabase queries and render the 'queries' setting above useless. You can\n\toptionally override this setting with ``$this->db->save_queries = TRUE;``.\n\tWithout this setting you won't be able to view the queries or the\n\t`last_query `."
  },
  {
    "path": "user_guide_src/source/general/requirements.rst",
    "content": "###################\nServer Requirements\n###################\n\n`PHP `_ version 5.6 or newer is recommended.\n\nIt should work on 5.4.8 as well, but we strongly advise you NOT to run\nsuch old versions of PHP, because of potential security and performance\nissues, as well as missing features.\n\nA database is required for most web application programming.\nCurrently supported databases are:\n\n  - MySQL (5.1+) via the *mysql* (deprecated), *mysqli* and *pdo* drivers\n  - Oracle via the *oci8* and *pdo* drivers\n  - PostgreSQL via the *postgre* and *pdo* drivers\n  - MS SQL via the *mssql*, *sqlsrv* (version 2005 and above only) and *pdo* drivers\n  - SQLite via the *sqlite3* and *pdo* drivers\n  - CUBRID via the *cubrid* and *pdo* drivers\n  - Interbase/Firebird via the *ibase* and *pdo* drivers\n  - ODBC via the *odbc* and *pdo* drivers (you should know that ODBC is actually an abstraction layer)\n"
  },
  {
    "path": "user_guide_src/source/general/reserved_names.rst",
    "content": "##############\nReserved Names\n##############\n\nIn order to help out, CodeIgniter uses a series of function, method,\nclass and variable names in its operation. Because of this, some names\ncannot be used by a developer. Following is a list of reserved names\nthat cannot be used.\n\nController names\n----------------\n\nSince your controller classes will extend the main application\ncontroller you must be careful not to name your methods identically to\nthe ones used by that class, otherwise your local methods will\noverride them. The following is a list of reserved names. Do not name\nyour controller any of these:\n\n-  CI_Controller\n-  Default\n-  index\n\nFunctions\n---------\n\n-  :php:func:`is_php()`\n-  :php:func:`is_really_writable()`\n-  ``load_class()``\n-  ``is_loaded()``\n-  ``get_config()``\n-  :php:func:`config_item()`\n-  :php:func:`show_error()`\n-  :php:func:`show_404()`\n-  :php:func:`log_message()`\n-  :php:func:`set_status_header()`\n-  :php:func:`get_mimes()`\n-  :php:func:`html_escape()`\n-  :php:func:`remove_invisible_characters()`\n-  :php:func:`is_https()`\n-  :php:func:`function_usable()`\n-  :php:func:`get_instance()`\n-  ``_error_handler()``\n-  ``_exception_handler()``\n-  ``_stringify_attributes()``\n\nVariables\n---------\n\n-  ``$config``\n-  ``$db``\n-  ``$lang``\n\nConstants\n---------\n\n-  ENVIRONMENT\n-  FCPATH\n-  SELF\n-  BASEPATH\n-  APPPATH\n-  VIEWPATH\n-  CI_VERSION\n-  MB_ENABLED\n-  ICONV_ENABLED\n-  UTF8_ENABLED\n-  FILE_READ_MODE\n-  FILE_WRITE_MODE\n-  DIR_READ_MODE\n-  DIR_WRITE_MODE\n-  FOPEN_READ\n-  FOPEN_READ_WRITE\n-  FOPEN_WRITE_CREATE_DESTRUCTIVE\n-  FOPEN_READ_WRITE_CREATE_DESTRUCTIVE\n-  FOPEN_WRITE_CREATE\n-  FOPEN_READ_WRITE_CREATE\n-  FOPEN_WRITE_CREATE_STRICT\n-  FOPEN_READ_WRITE_CREATE_STRICT\n-  SHOW_DEBUG_BACKTRACE\n-  EXIT_SUCCESS\n-  EXIT_ERROR\n-  EXIT_CONFIG\n-  EXIT_UNKNOWN_FILE\n-  EXIT_UNKNOWN_CLASS\n-  EXIT_UNKNOWN_METHOD\n-  EXIT_USER_INPUT\n-  EXIT_DATABASE\n-  EXIT__AUTO_MIN\n-  EXIT__AUTO_MAX"
  },
  {
    "path": "user_guide_src/source/general/routing.rst",
    "content": "###########\nURI Routing\n###########\n\nTypically there is a one-to-one relationship between a URL string and\nits corresponding controller class/method. The segments in a URI\nnormally follow this pattern::\n\n\texample.com/class/function/id/\n\nIn some instances, however, you may want to remap this relationship so\nthat a different class/method can be called instead of the one\ncorresponding to the URL.\n\nFor example, let's say you want your URLs to have this prototype::\n\n\texample.com/product/1/\n\texample.com/product/2/\n\texample.com/product/3/\n\texample.com/product/4/\n\nNormally the second segment of the URL is reserved for the method\nname, but in the example above it instead has a product ID. To\novercome this, CodeIgniter allows you to remap the URI handler.\n\nSetting your own routing rules\n==============================\n\nRouting rules are defined in your *application/config/routes.php* file.\nIn it you'll see an array called ``$route`` that permits you to specify\nyour own routing criteria. Routes can either be specified using wildcards\nor Regular Expressions.\n\nWildcards\n=========\n\nA typical wildcard route might look something like this::\n\n\t$route['product/:num'] = 'catalog/product_lookup';\n\nIn a route, the array key contains the URI to be matched, while the\narray value contains the destination it should be re-routed to. In the\nabove example, if the literal word \"product\" is found in the first\nsegment of the URL, and a number is found in the second segment, the\n\"catalog\" class and the \"product_lookup\" method are instead used.\n\nYou can match literal values or you can use two wildcard types:\n\n**(:num)** will match a segment containing only numbers.\n**(:any)** will match a segment containing any character (except for '/', which is the segment delimiter).\n\n.. note:: Wildcards are actually aliases for regular expressions, with\n\t**:any** being translated to **[^/]+** and **:num** to **[0-9]+**,\n\trespectively.\n\n.. note:: Routes will run in the order they are defined. Higher routes\n\twill always take precedence over lower ones.\n\n.. note:: Route rules are not filters! Setting a rule of e.g.\n\t'foo/bar/(:num)' will not prevent controller *Foo* and method\n\t*bar* to be called with a non-numeric value if that is a valid\n\troute.\n\nExamples\n========\n\nHere are a few routing examples::\n\n\t$route['journals'] = 'blogs';\n\nA URL containing the word \"journals\" in the first segment will be\nremapped to the \"blogs\" class.\n\n::\n\n\t$route['blog/joe'] = 'blogs/users/34';\n\nA URL containing the segments blog/joe will be remapped to the \"blogs\"\nclass and the \"users\" method. The ID will be set to \"34\".\n\n::\n\n\t$route['product/(:any)'] = 'catalog/product_lookup';\n\nA URL with \"product\" as the first segment, and anything in the second\nwill be remapped to the \"catalog\" class and the \"product_lookup\"\nmethod.\n\n::\n\n\t$route['product/(:num)'] = 'catalog/product_lookup_by_id/$1';\n\nA URL with \"product\" as the first segment, and a number in the second\nwill be remapped to the \"catalog\" class and the\n\"product_lookup_by_id\" method passing in the match as a variable to\nthe method.\n\n.. important:: Do not use leading/trailing slashes.\n\nRegular Expressions\n===================\n\nIf you prefer you can use regular expressions to define your routing\nrules. Any valid regular expression is allowed, as are back-references.\n\n.. note:: If you use back-references you must use the dollar syntax\n\trather than the double backslash syntax.\n\nA typical RegEx route might look something like this::\n\n\t$route['products/([a-z]+)/(\\d+)'] = '$1/id_$2';\n\nIn the above example, a URI similar to products/shirts/123 would instead\ncall the \"shirts\" controller class and the \"id_123\" method.\n\nWith regular expressions, you can also catch multiple segments at once.\nFor example, if a user accesses a password protected area of your web\napplication and you wish to be able to redirect them back to the same\npage after they log in, you may find this example useful::\n\n\t$route['login/(.+)'] = 'auth/login/$1';\n\n.. note:: In the above example, if the ``$1`` placeholder contains a\n\tslash, it will still be split into multiple parameters when\n\tpassed to ``Auth::login()``.\n\nFor those of you who don't know regular expressions and want to learn\nmore about them, `regular-expressions.info `_\nmight be a good starting point.\n\n.. note:: You can also mix and match wildcards with regular expressions.\n\nCallbacks\n=========\n\nYou can also use callbacks in place of the normal routing rules to process\nthe back-references. Example::\n\n\t$route['products/([a-zA-Z]+)/edit/(\\d+)'] = function ($product_type, $id)\n\t{\n\t\treturn 'catalog/product_edit/' . strtolower($product_type) . '/' . $id;\n\t};\n\nUsing HTTP verbs in routes\n==========================\n\nIt is possible to use HTTP verbs (request method) to define your routing rules.\nThis is particularly useful when building RESTful applications. You can use standard HTTP\nverbs (GET, PUT, POST, DELETE, PATCH) or a custom one such (e.g. PURGE). HTTP verb rules\nare case-insensitive. All you need to do is to add the verb as an array key to your route.\nExample::\n\n\t$route['products']['put'] = 'product/insert';\n\nIn the above example, a PUT request to URI \"products\" would call the ``Product::insert()``\ncontroller method.\n\n::\n\n\t$route['products/(:num)']['DELETE'] = 'product/delete/$1';\n\nA DELETE request to URL with \"products\" as first the segment and a number in the second will be\nmapped to the ``Product::delete()`` method, passing the numeric value as the first parameter.\n\nUsing HTTP verbs is of course, optional.\n\nReserved Routes\n===============\n\nThere are three reserved routes::\n\n\t$route['default_controller'] = 'welcome';\n\nThis route points to the action that should be executed if the URI contains\nno data, which will be the case when people load your root URL.\nThe setting accepts a **controller/method** value and ``index()`` would be\nthe default method if you don't specify one. In the above example, it is\n``Welcome::index()`` that would be called.\n\n.. note:: You can NOT use a directory as a part of this setting!\n\nYou are encouraged to always have a default route as otherwise a 404 page\nwill appear by default.\n\n::\n\n\t$route['404_override'] = '';\n\nThis route indicates which controller class should be loaded if the\nrequested controller is not found. It will override the default 404\nerror page. Same per-directory rules as with 'default_controller'\napply here as well.\n\nIt won't affect to the ``show_404()`` function, which will\ncontinue loading the default *error_404.php* file at\n*application/views/errors/error_404.php*.\n\n::\n\n\t$route['translate_uri_dashes'] = FALSE;\n\nAs evident by the boolean value, this is not exactly a route. This\noption enables you to automatically replace dashes ('-') with\nunderscores in the controller and method URI segments, thus saving you\nadditional route entries if you need to do that.\nThis is required, because the dash isn't a valid class or method name\ncharacter and would cause a fatal error if you try to use it.\n"
  },
  {
    "path": "user_guide_src/source/general/security.rst",
    "content": "########\nSecurity\n########\n\nThis page describes some \"best practices\" regarding web security, and\ndetails CodeIgniter's internal security features.\n\n.. note:: If you came here looking for a security contact, please refer to\n\tour `Contribution Guide <../contributing/index>`.\n\nURI Security\n============\n\nCodeIgniter is fairly restrictive regarding which characters it allows\nin your URI strings in order to help minimize the possibility that\nmalicious data can be passed to your application. URIs may only contain\nthe following:\n\n-  Alpha-numeric text (latin characters only)\n-  Tilde: ~\n-  Percent sign: %\n-  Period: .\n-  Colon: :\n-  Underscore: \\_\n-  Dash: -\n-  Space\n\nRegister_globals\n================\n\nDuring system initialization all global variables that are found to exist\nin the ``$_GET``, ``$_POST``, ``$_REQUEST`` and ``$_COOKIE`` are unset.\n\nThe unsetting routine is effectively the same as *register_globals = off*.\n\ndisplay_errors\n==============\n\nIn production environments, it is typically desirable to \"disable\" PHP's\nerror reporting by setting the internal *display_errors* flag to a value\nof 0. This disables native PHP errors from being rendered as output,\nwhich may potentially contain sensitive information.\n\nSetting CodeIgniter's **ENVIRONMENT** constant in index.php to a value of\n**\\'production\\'** will turn off these errors. In development mode, it is\nrecommended that a value of 'development' is used. More information\nabout differentiating between environments can be found on the\n:doc:`Handling Environments ` page.\n\nmagic_quotes_runtime\n====================\n\nThe *magic_quotes_runtime* directive is turned off during system\ninitialization so that you don't have to remove slashes when retrieving\ndata from your database.\n\n**************\nBest Practices\n**************\n\nBefore accepting any data into your application, whether it be POST data\nfrom a form submission, COOKIE data, URI data, XML-RPC data, or even\ndata from the SERVER array, you are encouraged to practice this three\nstep approach:\n\n#. Validate the data to ensure it conforms to the correct type, length,\n   size, etc.\n#. Filter the data as if it were tainted.\n#. Escape the data before submitting it into your database or outputting\n   it to a browser.\n\nCodeIgniter provides the following functions and tips to assist you\nin this process:\n\nXSS Filtering\n=============\n\nCodeIgniter comes with a Cross Site Scripting filter. This filter\nlooks for commonly used techniques to embed malicious JavaScript into\nyour data, or other types of code that attempt to hijack cookies or\ndo other malicious things. The XSS Filter is described\n:doc:`here <../libraries/security>`.\n\n.. note:: XSS filtering should *only be performed on output*. Filtering\n\tinput data may modify the data in undesirable ways, including\n\tstripping special characters from passwords, which reduces\n\tsecurity instead of improving it.\n\nCSRF protection\n===============\n\nCSRF stands for Cross-Site Request Forgery, which is the process of an\nattacker tricking their victim into unknowingly submitting a request.\n\nCodeIgniter provides CSRF protection out of the box, which will get\nautomatically triggered for every non-GET HTTP request, but also needs\nyou to create your submit forms in a certain way. This is explained in\nthe :doc:`Security Library <../libraries/security>` documentation.\n\nPassword handling\n=================\n\nIt is *critical* that you handle passwords in your application properly.\n\nUnfortunately, many developers don't know how to do that, and the web is\nfull of outdated or otherwise wrongful advices, which doesn't help.\n\nWe would like to give you a list of combined do's and don'ts to help you\nwith that. Please read below.\n\n-  DO NOT store passwords in plain-text format.\n\n   Always **hash** your passwords.\n\n-  DO NOT use Base64 or similar encoding for storing passwords.\n\n   This is as good as storing them in plain-text. Really. Do **hashing**,\n   not *encoding*.\n\n   Encoding, and encryption too, are two-way processes. Passwords are\n   secrets that must only be known to their owner, and thus must work\n   only in one direction. Hashing does that - there's *no* un-hashing or\n   de-hashing, but there is decoding and decryption.\n\n-  DO NOT use weak or broken hashing algorithms like MD5 or SHA1.\n\n   These algorithms are old, proven to be flawed, and not designed for\n   password hashing in the first place.\n\n   Also, DON'T invent your own algorithms.\n\n   Only use strong password hashing algorithms like BCrypt, which is used\n   in PHP's own `Password Hashing `_ functions.\n\n   Please use them, even if you're not running PHP 5.5+, CodeIgniter\n   provides them for you.\n\n-  DO NOT ever display or send a password in plain-text format!\n\n   Even to the password's owner, if you need a \"Forgotten password\"\n   feature, just randomly generate a new, one-time (this is also important)\n   password and send that instead.\n\n-  DO NOT put unnecessary limits on your users' passwords.\n\n   If you're using a hashing algorithm other than BCrypt (which has a limit\n   of 72 characters), you should set a relatively high limit on password\n   lengths in order to mitigate DoS attacks - say, 1024 characters.\n\n   Other than that however, there's no point in forcing a rule that a\n   password can only be up to a number of characters, or that it can't\n   contain a certain set of special characters.\n\n   Not only does this **reduce** security instead of improving it, but\n   there's literally no reason to do it. No technical limitations and\n   no (practical) storage constraints apply once you've hashed them, none!\n\nValidate input data\n===================\n\nCodeIgniter has a :doc:`Form Validation Library\n<../libraries/form_validation>` that assists you in\nvalidating, filtering, and prepping your data.\n\nEven if that doesn't work for your use case however, be sure to always\nvalidate and sanitize all input data. For example, if you expect a numeric\nstring for an input variable, you can check for that with ``is_numeric()``\nor ``ctype_digit()``. Always try to narrow down your checks to a certain\npattern.\n\nHave it in mind that this includes not only ``$_POST`` and ``$_GET``\nvariables, but also cookies, the user-agent string and basically\n*all data that is not created directly by your own code*.\n\n\nEscape all data before database insertion\n=========================================\n\nNever insert information into your database without escaping it.\nPlease see the section that discusses :doc:`database queries\n<../database/queries>` for more information.\n\nHide your files\n===============\n\nAnother good security practice is to only leave your *index.php*\nand \"assets\" (e.g. .js, css and image files) under your server's\n*webroot* directory (most commonly named \"htdocs/\"). These are\nthe only files that you would need to be accessible from the web.\n\nAllowing your visitors to see anything else would potentially\nallow them to access sensitive data, execute scripts, etc.\n\nIf you're not allowed to do that, you can try using a .htaccess\nfile to restrict access to those resources.\n\nCodeIgniter will have an index.html file in all of its\ndirectories in an attempt to hide some of this data, but have\nit in mind that this is not enough to prevent a serious\nattacker.\n"
  },
  {
    "path": "user_guide_src/source/general/styleguide.rst",
    "content": "###############\nPHP Style Guide\n###############\n\n\nThe following page describes the coding styles adhered to when\ncontributing to the development of CodeIgniter. There is no requirement\nto use these styles in your own CodeIgniter application, though they\nare recommended.\n\n.. contents:: Table of Contents\n\nFile Format\n===========\n\nFiles should be saved with Unicode (UTF-8) encoding. The BOM should\n*not* be used. Unlike UTF-16 and UTF-32, there's no byte order to\nindicate in a UTF-8 encoded file, and the BOM can have a negative side\neffect in PHP of sending output, preventing the application from being\nable to set its own headers. Unix line endings should be used (LF).\n\nHere is how to apply these settings in some of the more common text\neditors. Instructions for your text editor may vary; check your text\neditor's documentation.\n\nTextMate\n''''''''\n\n#. Open the Application Preferences\n#. Click Advanced, and then the \"Saving\" tab\n#. In \"File Encoding\", select \"UTF-8 (recommended)\"\n#. In \"Line Endings\", select \"LF (recommended)\"\n#. *Optional:* Check \"Use for existing files as well\" if you wish to\n   modify the line endings of files you open to your new preference.\n\nBBEdit\n''''''\n\n#. Open the Application Preferences\n#. Select \"Text Encodings\" on the left.\n#. In \"Default text encoding for new documents\", select \"Unicode (UTF-8,\n   no BOM)\"\n#. *Optional:* In \"If file's encoding can't be guessed, use\", select\n   \"Unicode (UTF-8, no BOM)\"\n#. Select \"Text Files\" on the left.\n#. In \"Default line breaks\", select \"Mac OS X and Unix (LF)\"\n\nPHP Closing Tag\n===============\n\nThe PHP closing tag on a PHP document **?>** is optional to the PHP\nparser. However, if used, any whitespace following the closing tag,\nwhether introduced by the developer, user, or an FTP application, can\ncause unwanted output, PHP errors, or if the latter are suppressed,\nblank pages. For this reason, all PHP files MUST OMIT the PHP closing\ntag and end with a single empty line instead.\n\nFile Naming\n===========\n\nClass files must be named in a Ucfirst-like manner, while any other file name\n(configurations, views, generic scripts, etc.) should be in all lowercase.\n\n**INCORRECT**::\n\n\tsomelibrary.php\n\tsomeLibrary.php\n\tSOMELIBRARY.php\n\tSome_Library.php\n\n\tApplication_config.php\n\tApplication_Config.php\n\tapplicationConfig.php\n\n**CORRECT**::\n\n\tSomelibrary.php\n\tSome_library.php\n\n\tapplicationconfig.php\n\tapplication_config.php\n\nFurthermore, class file names should match the name of the class itself.\nFor example, if you have a class named `Myclass`, then its filename must\nbe **Myclass.php**.\n\nClass and Method Naming\n=======================\n\nClass names should always start with an uppercase letter. Multiple words\nshould be separated with an underscore, and not CamelCased.\n\n**INCORRECT**::\n\n\tclass superclass\n\tclass SuperClass\n\n**CORRECT**::\n\n\tclass Super_class\n\n::\n\n\tclass Super_class {\n\n\t\tpublic function __construct()\n\t\t{\n\n\t\t}\n\t}\n\nClass methods should be entirely lowercased and named to clearly\nindicate their function, preferably including a verb. Try to avoid\noverly long and verbose names. Multiple words should be separated\nwith an underscore.\n\n**INCORRECT**::\n\n\tfunction fileproperties()\t\t// not descriptive and needs underscore separator\n\tfunction fileProperties()\t\t// not descriptive and uses CamelCase\n\tfunction getfileproperties()\t\t// Better!  But still missing underscore separator\n\tfunction getFileProperties()\t\t// uses CamelCase\n\tfunction get_the_file_properties_from_the_file()\t// wordy\n\n**CORRECT**::\n\n\tfunction get_file_properties()\t// descriptive, underscore separator, and all lowercase letters\n\nVariable Names\n==============\n\nThe guidelines for variable naming are very similar to those used for\nclass methods. Variables should contain only lowercase letters,\nuse underscore separators, and be reasonably named to indicate their\npurpose and contents. Very short, non-word variables should only be used\nas iterators in for() loops.\n\n**INCORRECT**::\n\n\t$j = 'foo';\t\t// single letter variables should only be used in for() loops\n\t$Str\t\t\t// contains uppercase letters\n\t$bufferedText\t\t// uses CamelCasing, and could be shortened without losing semantic meaning\n\t$groupid\t\t// multiple words, needs underscore separator\n\t$name_of_last_city_used\t// too long\n\n**CORRECT**::\n\n\tfor ($j = 0; $j < 10; $j++)\n\t$str\n\t$buffer\n\t$group_id\n\t$last_city\n\nCommenting\n==========\n\nIn general, code should be commented prolifically. It not only helps\ndescribe the flow and intent of the code for less experienced\nprogrammers, but can prove invaluable when returning to your own code\nmonths down the line. There is not a required format for comments, but\nthe following are recommended.\n\n`DocBlock `_\nstyle comments preceding class, method, and property declarations so they can be\npicked up by IDEs::\n\n\t/**\n\t * Super Class\n\t *\n\t * @package\tPackage Name\n\t * @subpackage\tSubpackage\n\t * @category\tCategory\n\t * @author\tAuthor Name\n\t * @link\thttp://example.com\n\t */\n\tclass Super_class {\n\n::\n\n\t/**\n\t * Encodes string for use in XML\n\t *\n\t * @param\tstring\t$str\tInput string\n\t * @return\tstring\n\t */\n\tfunction xml_encode($str)\n\n::\n\n\t/**\n\t * Data for class manipulation\n\t *\n\t * @var\tarray\n\t */\n\tpublic $data = array();\n\nUse single line comments within code, leaving a blank line between large\ncomment blocks and code.\n\n::\n\n\t// break up the string by newlines\n\t$parts = explode(\"\\n\", $str);\n\n\t// A longer comment that needs to give greater detail on what is\n\t// occurring and why can use multiple single-line comments.  Try to\n\t// keep the width reasonable, around 70 characters is the easiest to\n\t// read.  Don't hesitate to link to permanent external resources\n\t// that may provide greater detail:\n\t//\n\t// http://example.com/information_about_something/in_particular/\n\n\t$parts = $this->foo($parts);\n\nConstants\n=========\n\nConstants follow the same guidelines as do variables, except constants\nshould always be fully uppercase. *Always use CodeIgniter constants when\nappropriate, i.e. SLASH, LD, RD, PATH_CACHE, etc.*\n\n**INCORRECT**::\n\n\tmyConstant\t// missing underscore separator and not fully uppercase\n\tN\t\t// no single-letter constants\n\tS_C_VER\t\t// not descriptive\n\t$str = str_replace('{foo}', 'bar', $str);\t// should use LD and RD constants\n\n**CORRECT**::\n\n\tMY_CONSTANT\n\tNEWLINE\n\tSUPER_CLASS_VERSION\n\t$str = str_replace(LD.'foo'.RD, 'bar', $str);\n\nTRUE, FALSE, and NULL\n=====================\n\n**TRUE**, **FALSE**, and **NULL** keywords should always be fully\nuppercase.\n\n**INCORRECT**::\n\n\tif ($foo == true)\n\t$bar = false;\n\tfunction foo($bar = null)\n\n**CORRECT**::\n\n\tif ($foo == TRUE)\n\t$bar = FALSE;\n\tfunction foo($bar = NULL)\n\nLogical Operators\n=================\n\nUse of the ``||`` \"or\" comparison operator is discouraged, as its clarity\non some output devices is low (looking like the number 11, for instance).\n``&&`` is preferred over ``AND`` but either are acceptable, and a space should\nalways precede and follow ``!``.\n\n**INCORRECT**::\n\n\tif ($foo || $bar)\n\tif ($foo AND $bar)  // okay but not recommended for common syntax highlighting applications\n\tif (!$foo)\n\tif (! is_array($foo))\n\n**CORRECT**::\n\n\tif ($foo OR $bar)\n\tif ($foo && $bar) // recommended\n\tif ( ! $foo)\n\tif ( ! is_array($foo))\n\t\n\nComparing Return Values and Typecasting\n=======================================\n\nSome PHP functions return FALSE on failure, but may also have a valid\nreturn value of \"\" or 0, which would evaluate to FALSE in loose\ncomparisons. Be explicit by comparing the variable type when using these\nreturn values in conditionals to ensure the return value is indeed what\nyou expect, and not a value that has an equivalent loose-type\nevaluation.\n\nUse the same stringency in returning and checking your own variables.\nUse **===** and **!==** as necessary.\n\n**INCORRECT**::\n\n\t// If 'foo' is at the beginning of the string, strpos will return a 0,\n\t// resulting in this conditional evaluating as TRUE\n\tif (strpos($str, 'foo') == FALSE)\n\n**CORRECT**::\n\n\tif (strpos($str, 'foo') === FALSE)\n\n**INCORRECT**::\n\n\tfunction build_string($str = \"\")\n\t{\n\t\tif ($str == \"\")\t// uh-oh!  What if FALSE or the integer 0 is passed as an argument?\n\t\t{\n\n\t\t}\n\t}\n\n**CORRECT**::\n\n\tfunction build_string($str = \"\")\n\t{\n\t\tif ($str === \"\")\n\t\t{\n\n\t\t}\n\t}\n\n\nSee also information regarding `typecasting\n`_,\nwhich can be quite useful. Typecasting has a slightly different effect\nwhich may be desirable. When casting a variable as a string, for\ninstance, NULL and boolean FALSE variables become empty strings, 0 (and\nother numbers) become strings of digits, and boolean TRUE becomes \"1\"::\n\n\t$str = (string) $str; // cast $str as a string\n\nDebugging Code\n==============\n\nDo not leave debugging code in your submissions, even when commented out.\nThings such as ``var_dump()``, ``print_r()``, ``die()``/``exit()`` should not be included\nin your code unless it serves a specific purpose other than debugging.\n\nWhitespace in Files\n===================\n\nNo whitespace can precede the opening PHP tag or follow the closing PHP\ntag. Output is buffered, so whitespace in your files can cause output to\nbegin before CodeIgniter outputs its content, leading to errors and an\ninability for CodeIgniter to send proper headers.\n\nCompatibility\n=============\n\nCodeIgniter recommends PHP 5.6 or newer to be used, but it should be\ncompatible with PHP 5.4.8. Your code must either be compatible with this\nrequirement, provide a suitable fallback, or be an optional feature that\ndies quietly without affecting a user's application.\n\nAdditionally, do not use PHP functions that require non-default libraries\nto be installed unless your code contains an alternative method when the\nfunction is not available.\n\nOne File per Class\n==================\n\nUse separate files for each class, unless the classes are *closely related*.\nAn example of a CodeIgniter file that contains multiple classes is the \nXmlrpc library file.\n\nWhitespace\n==========\n\nUse tabs for whitespace in your code, not spaces. This may seem like a\nsmall thing, but using tabs instead of whitespace allows the developer\nlooking at your code to have indentation at levels that they prefer and\ncustomize in whatever application they use. And as a side benefit, it\nresults in (slightly) more compact files, storing one tab character\nversus, say, four space characters.\n\nLine Breaks\n===========\n\nFiles must be saved with Unix line breaks. This is more of an issue for\ndevelopers who work in Windows, but in any case ensure that your text\neditor is setup to save files with Unix line breaks.\n\nCode Indenting\n==============\n\nUse Allman style indenting. With the exception of Class declarations,\nbraces are always placed on a line by themselves, and indented at the\nsame level as the control statement that \"owns\" them.\n\n**INCORRECT**::\n\n\tfunction foo($bar) {\n\t\t// ...\n\t}\n\n\tforeach ($arr as $key => $val) {\n\t\t// ...\n\t}\n\n\tif ($foo == $bar) {\n\t\t// ...\n\t} else {\n\t\t// ...\n\t}\n\n\tfor ($i = 0; $i < 10; $i++)\n\t\t{\n\t\tfor ($j = 0; $j < 10; $j++)\n\t\t\t{\n\t\t\t// ...\n\t\t\t}\n\t\t}\n\t\t\n\ttry {\n\t\t// ...\n\t}\n\tcatch() {\n\t\t// ...\n\t}\n\n**CORRECT**::\n\n\tfunction foo($bar)\n\t{\n\t\t// ...\n\t}\n\n\tforeach ($arr as $key => $val)\n\t{\n\t\t// ...\n\t}\n\n\tif ($foo == $bar)\n\t{\n\t\t// ...\n\t}\n\telse\n\t{\n\t\t// ...\n\t}\n\n\tfor ($i = 0; $i < 10; $i++)\n\t{\n\t\tfor ($j = 0; $j < 10; $j++)\n\t\t{\n\t\t\t// ...\n\t\t}\n\t}\n\t\n\ttry \n\t{\n\t\t// ...\n\t}\n\tcatch()\n\t{\n\t\t// ...\n\t}\n\nBracket and Parenthetic Spacing\n===============================\n\nIn general, parenthesis and brackets should not use any additional\nspaces. The exception is that a space should always follow PHP control\nstructures that accept arguments with parenthesis (declare, do-while,\nelseif, for, foreach, if, switch, while), to help distinguish them from\nfunctions and increase readability.\n\n**INCORRECT**::\n\n\t$arr[ $foo ] = 'foo';\n\n**CORRECT**::\n\n\t$arr[$foo] = 'foo'; // no spaces around array keys\n\n**INCORRECT**::\n\n\tfunction foo ( $bar )\n\t{\n\n\t}\n\n**CORRECT**::\n\n\tfunction foo($bar) // no spaces around parenthesis in function declarations\n\t{\n\n\t}\n\n**INCORRECT**::\n\n\tforeach( $query->result() as $row )\n\n**CORRECT**::\n\n\tforeach ($query->result() as $row) // single space following PHP control structures, but not in interior parenthesis\n\nLocalized Text\n==============\n\nCodeIgniter libraries should take advantage of corresponding language files\nwhenever possible.\n\n**INCORRECT**::\n\n\treturn \"Invalid Selection\";\n\n**CORRECT**::\n\n\treturn $this->lang->line('invalid_selection');\n\nPrivate Methods and Variables\n=============================\n\nMethods and variables that are only accessed internally,\nsuch as utility and helper functions that your public methods use for\ncode abstraction, should be prefixed with an underscore.\n\n::\n\n\tpublic function convert_text()\n\tprivate function _convert_text()\n\nPHP Errors\n==========\n\nCode must run error free and not rely on warnings and notices to be\nhidden to meet this requirement. For instance, never access a variable\nthat you did not set yourself (such as ``$_POST`` array keys) without first\nchecking to see that it ``isset()``.\n\nMake sure that your dev environment has error reporting enabled\nfor ALL users, and that display_errors is enabled in the PHP\nenvironment. You can check this setting with::\n\n\tif (ini_get('display_errors') == 1)\n\t{\n\t\texit \"Enabled\";\n\t}\n\nOn some servers where *display_errors* is disabled, and you do not have\nthe ability to change this in the php.ini, you can often enable it with::\n\n\tini_set('display_errors', 1);\n\n.. note:: Setting the `display_errors\n\t`_\n\tsetting with ``ini_set()`` at runtime is not identical to having\n\tit enabled in the PHP environment. Namely, it will not have any\n\teffect if the script has fatal errors.\n\nShort Open Tags\n===============\n\nAlways use full PHP opening tags, in case a server does not have\n*short_open_tag* enabled.\n\n**INCORRECT**::\n\n\t\n\n\t\n\n**CORRECT**::\n\n\t\n\n.. note:: PHP 5.4 will always have the **db->query(\"select foo, bar, baz, foofoo, foobar as raboof, foobaz from exp_pre_email_addresses\n\t...where foo != 'oof' and baz != 'zab' order by foobaz limit 5, 100\");\n\n**CORRECT**::\n\n\t$query = $this->db->query(\"SELECT foo, bar, baz, foofoo, foobar AS raboof, foobaz\n\t\t\t\t\tFROM exp_pre_email_addresses\n\t\t\t\t\tWHERE foo != 'oof'\n\t\t\t\t\tAND baz != 'zab'\n\t\t\t\t\tORDER BY foobaz\n\t\t\t\t\tLIMIT 5, 100\");\n\nDefault Function Arguments\n==========================\n\nWhenever appropriate, provide function argument defaults, which helps\nprevent PHP errors with mistaken calls and provides common fallback\nvalues which can save a few lines of code. Example::\n\n\tfunction foo($bar = '', $baz = FALSE)\n"
  },
  {
    "path": "user_guide_src/source/general/urls.rst",
    "content": "################\nCodeIgniter URLs\n################\n\nBy default, URLs in CodeIgniter are designed to be search-engine and\nhuman friendly. Rather than using the standard \"query string\" approach\nto URLs that is synonymous with dynamic systems, CodeIgniter uses a\n**segment-based** approach::\n\n\texample.com/news/article/my_article\n\n.. note:: Query string URLs can be optionally enabled, as described\n\tbelow.\n\nURI Segments\n============\n\nThe segments in the URL, in following with the Model-View-Controller\napproach, usually represent::\n\n\texample.com/class/function/ID\n\n#. The first segment represents the controller **class** that should be\n   invoked.\n#. The second segment represents the class **function**, or method, that\n   should be called.\n#. The third, and any additional segments, represent the ID and any\n   variables that will be passed to the controller.\n\nThe :doc:`URI Library <../libraries/uri>` and the :doc:`URL Helper\n<../helpers/url_helper>` contain functions that make it easy to work\nwith your URI data. In addition, your URLs can be remapped using the\n:doc:`URI Routing ` feature for more flexibility.\n\nRemoving the index.php file\n===========================\n\nBy default, the **index.php** file will be included in your URLs::\n\n\texample.com/index.php/news/article/my_article\n\nIf your Apache server has *mod_rewrite* enabled, you can easily remove this\nfile by using a .htaccess file with some simple rules. Here is an example\nof such a file, using the \"negative\" method in which everything is redirected\nexcept the specified items:\n\t\n.. code-block:: apache\n\n\tRewriteEngine On\n\tRewriteCond %{REQUEST_FILENAME} !-f\n\tRewriteCond %{REQUEST_FILENAME} !-d\n\tRewriteRule ^(.*)$ index.php/$1 [L]\n\nIn the above example, any HTTP request other than those for existing\ndirectories and existing files is treated as a request for your index.php file.\n\n.. note:: These specific rules might not work for all server configurations.\n\n.. note:: Make sure to also exclude from the above rule any assets that you\n\tmight need to be accessible from the outside world.\n\nAdding a URL Suffix\n===================\n\nIn your **config/config.php** file you can specify a suffix that will be\nadded to all URLs generated by CodeIgniter. For example, if a URL is\nthis::\n\n\texample.com/index.php/products/view/shoes\n\nYou can optionally add a suffix, like **.html,** making the page appear to\nbe of a certain type::\n\n\texample.com/index.php/products/view/shoes.html\n\nEnabling Query Strings\n======================\n\nIn some cases you might prefer to use query strings URLs::\n\n\tindex.php?c=products&m=view&id=345\n\nCodeIgniter optionally supports this capability, which can be enabled in\nyour **application/config.php** file. If you open your config file you'll\nsee these items::\n\n\t$config['enable_query_strings'] = FALSE;\n\t$config['controller_trigger'] = 'c';\n\t$config['function_trigger'] = 'm';\n\nIf you change \"enable_query_strings\" to TRUE this feature will become\nactive. Your controllers and functions will then be accessible using the\n\"trigger\" words you've set to invoke your controllers and methods::\n\n\tindex.php?c=controller&m=method\n\n.. note:: If you are using query strings you will have to build your own\n\tURLs, rather than utilizing the URL helpers (and other helpers\n\tthat generate URLs, like some of the form helpers) as these are\n\tdesigned to work with segment based URLs."
  },
  {
    "path": "user_guide_src/source/general/views.rst",
    "content": "#####\nViews\n#####\n\nA view is simply a web page, or a page fragment, like a header, footer,\nsidebar, etc. In fact, views can flexibly be embedded within other views\n(within other views, etc., etc.) if you need this type of hierarchy.\n\nViews are never called directly, they must be loaded by a\n:doc:`controller `. Remember that in an MVC framework, the\nController acts as the traffic cop, so it is responsible for fetching a\nparticular view. If you have not read the\n:doc:`Controllers ` page you should do so before\ncontinuing.\n\nUsing the example controller you created in the\n:doc:`controller ` page, let's add a view to it.\n\nCreating a View\n===============\n\nUsing your text editor, create a file called blogview.php, and put this\nin it::\n\n\t\n\t\n\t\tMy Blog\n\t\n\t\n\t\t
        Welcome to my Blog!
        \n\t\n\t\n\t\nThen save the file in your *application/views/* directory.\n\nLoading a View\n==============\n\nTo load a particular view file you will use the following method::\n\n\t$this->load->view('name');\n\nWhere name is the name of your view file.\n\n.. note:: The .php file extension does not need to be specified\n\tunless you use something other than .php.\n\nNow, open the controller file you made earlier called Blog.php, and\nreplace the echo statement with the view loading method::\n\n\tload->view('blogview');\n\t\t}\n\t}\n\nIf you visit your site using the URL you did earlier you should see your\nnew view. The URL was similar to this::\n\n\texample.com/index.php/blog/\n\nLoading multiple views\n======================\n\nCodeIgniter will intelligently handle multiple calls to\n``$this->load->view()`` from within a controller. If more than one call\nhappens they will be appended together. For example, you may wish to\nhave a header view, a menu view, a content view, and a footer view. That\nmight look something like this::\n\n\tload->view('header');\n\t\t\t$this->load->view('menu');\n\t\t\t$this->load->view('content', $data);\n\t\t\t$this->load->view('footer');\n\t\t}\n\n\t}\n\nIn the example above, we are using \"dynamically added data\", which you\nwill see below.\n\nStoring Views within Sub-directories\n====================================\n\nYour view files can also be stored within sub-directories if you prefer\nthat type of organization. When doing so you will need to include the\ndirectory name loading the view. Example::\n\n\t$this->load->view('directory_name/file_name');\n\nAdding Dynamic Data to the View\n===============================\n\nData is passed from the controller to the view by way of an **array** or\nan **object** in the second parameter of the view loading method. Here\nis an example using an array::\n\n\t$data = array(\n\t\t'title' => 'My Title',\n\t\t'heading' => 'My Heading',\n\t\t'message' => 'My Message'\n\t);\n\n\t$this->load->view('blogview', $data);\n\nAnd here's an example using an object::\n\n\t$data = new Someclass();\n\t$this->load->view('blogview', $data);\n\n.. note:: If you use an object, the class variables will be turned\n\tinto array elements.\n\nLet's try it with your controller file. Open it add this code::\n\n\tload->view('blogview', $data);\n\t\t}\n\t}\n\nNow open your view file and change the text to variables that correspond\nto the array keys in your data::\n\n\t\n\t\n\t\t<?php echo $title;?>\n\t\n\t\n\t\t
        \n\t\n\t\n\nThen load the page at the URL you've been using and you should see the\nvariables replaced.\n\nCreating Loops\n==============\n\nThe data array you pass to your view files is not limited to simple\nvariables. You can pass multi dimensional arrays, which can be looped to\ngenerate multiple rows. For example, if you pull data from your database\nit will typically be in the form of a multi-dimensional array.\n\nHere's a simple example. Add this to your controller::\n\n\tload->view('blogview', $data);\n\t\t}\n\t}\n\nNow open your view file and create a loop::\n\n\t\n\t\n\t\t<?php echo $title;?>\n\t\n\t\n\t\t
        \n\t\n\t\t
        My Todo List
        \n\n\t\t
          \n\t\t\n\t\n\t\t\t
          • \n\t\n\t\t\n\t\t
        \n\n\t\n\t\n\n.. note:: You'll notice that in the example above we are using PHP's\n\talternative syntax. If you are not familiar with it you can read about\n\tit :doc:`here `.\n\nReturning views as data\n=======================\n\nThere is a third **optional** parameter lets you change the behavior of\nthe method so that it returns data as a string rather than sending it\nto your browser. This can be useful if you want to process the data in\nsome way. If you set the parameter to TRUE (boolean) it will return\ndata. The default behavior is false, which sends it to your browser.\nRemember to assign it to a variable if you want the data returned::\n\n\t$string = $this->load->view('myfile', '', TRUE);\n"
  },
  {
    "path": "user_guide_src/source/general/welcome.rst",
    "content": "######################\nWelcome to CodeIgniter\n######################\n\nCodeIgniter is an Application Development Framework - a toolkit - for\npeople who build web sites using PHP. Its goal is to enable you to\ndevelop projects much faster than you could if you were writing code\nfrom scratch, by providing a rich set of libraries for commonly needed\ntasks, as well as a simple interface and logical structure to access\nthese libraries. CodeIgniter lets you creatively focus on your project\nby minimizing the amount of code needed for a given task.\n\n***********************\nWho is CodeIgniter For?\n***********************\n\nCodeIgniter is right for you if:\n\n-  You want a framework with a small footprint.\n-  You need exceptional performance.\n-  You need broad compatibility with standard hosting accounts that run\n   a variety of PHP versions and configurations.\n-  You want a framework that requires nearly zero configuration.\n-  You want a framework that does not require you to use the command\n   line.\n-  You want a framework that does not require you to adhere to\n   restrictive coding rules.\n-  You are not interested in large-scale monolithic libraries like PEAR.\n-  You do not want to be forced to learn a templating language (although\n   a template parser is optionally available if you desire one).\n-  You eschew complexity, favoring simple solutions.\n-  You need clear, thorough documentation."
  },
  {
    "path": "user_guide_src/source/helpers/array_helper.rst",
    "content": "############\nArray Helper\n############\n\nThe Array Helper file contains functions that assist in working with\narrays.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('array');\n\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: element($item, $array[, $default = NULL])\n\n\t:param\tstring\t$item: Item to fetch from the array\n\t:param\tarray\t$array: Input array\n\t:param\tbool\t$default: What to return if the array isn't valid\n\t:returns:\tNULL on failure or the array item.\n\t:rtype:\tmixed\n\n\tLets you fetch an item from an array. The function tests whether the\n\tarray index is set and whether it has a value. If a value exists it is\n\treturned. If a value does not exist it returns NULL, or whatever you've\n\tspecified as the default value via the third parameter.\n\n\tExample::\n\n\t\t$array = array(\n\t\t\t'color'\t=> 'red',\n\t\t\t'shape'\t=> 'round',\n\t\t\t'size'\t=> ''\n\t\t);\n\n\t\techo element('color', $array); // returns \"red\"\n\t\techo element('size', $array, 'foobar'); // returns \"foobar\"\n\n\n.. php:function:: elements($items, $array[, $default = NULL])\n\n\t:param\tstring\t$item: Item to fetch from the array\n\t:param\tarray\t$array: Input array\n\t:param\tbool\t$default: What to return if the array isn't valid\n\t:returns:\tNULL on failure or the array item.\n\t:rtype:\tmixed\n\n\tLets you fetch a number of items from an array. The function tests\n\twhether each of the array indices is set. If an index does not exist it\n\tis set to NULL, or whatever you've specified as the default value via\n\tthe third parameter.\n\n\tExample::\n\n\t\t$array = array(\n\t\t\t'color' => 'red',\n\t\t\t'shape' => 'round',\n\t\t\t'radius' => '10',\n\t\t\t'diameter' => '20'\n\t\t);\n\n\t\t$my_shape = elements(array('color', 'shape', 'height'), $array);\n\n\tThe above will return the following array::\n\n\t\tarray(\n\t\t\t'color' => 'red',\n\t\t\t'shape' => 'round',\n\t\t\t'height' => NULL\n\t\t);\n\n\tYou can set the third parameter to any default value you like.\n\t::\n\n\t\t $my_shape = elements(array('color', 'shape', 'height'), $array, 'foobar');\n\n\tThe above will return the following array::\n\n\t\tarray(     \n\t\t\t'color' \t=> 'red',\n\t\t\t'shape' \t=> 'round',\n\t\t\t'height'\t=> 'foobar'\n\t\t);\n\n\tThis is useful when sending the ``$_POST`` array to one of your Models.\n\tThis prevents users from sending additional POST data to be entered into\n\tyour tables.\n\n\t::\n\n\t\t$this->load->model('post_model');\n\t\t$this->post_model->update(\n\t\t\telements(array('id', 'title', 'content'), $_POST)\n\t\t);\n\n\tThis ensures that only the id, title and content fields are sent to be\n\tupdated.\n\n\n.. php:function:: random_element($array)\n\n\t:param\tarray\t$array: Input array\n\t:returns:\tA random element from the array\n\t:rtype:\tmixed\n\n\tTakes an array as input and returns a random element from it.\n\n\tUsage example::\n\n\t\t$quotes = array(\n\t\t\t\"I find that the harder I work, the more luck I seem to have. - Thomas Jefferson\",\n\t\t\t\"Don't stay in bed, unless you can make money in bed. - George Burns\",\n\t\t\t\"We didn't lose the game; we just ran out of time. - Vince Lombardi\",\n\t\t\t\"If everything seems under control, you're not going fast enough. - Mario Andretti\",\n\t\t\t\"Reality is merely an illusion, albeit a very persistent one. - Albert Einstein\",\n\t\t\t\"Chance favors the prepared mind - Louis Pasteur\"\n\t\t);\n\n\t\techo random_element($quotes);"
  },
  {
    "path": "user_guide_src/source/helpers/captcha_helper.rst",
    "content": "##############\nCAPTCHA Helper\n##############\n\nThe CAPTCHA Helper file contains functions that assist in creating\nCAPTCHA images.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('captcha');\n\nUsing the CAPTCHA helper\n========================\n\nOnce loaded you can generate a CAPTCHA like this::\n\n\t$vals = array(\n\t\t'word'\t\t=> 'Random word',\n\t\t'img_path'\t=> './captcha/',\n\t\t'img_url'\t=> 'http://example.com/captcha/',\n\t\t'font_path'\t=> './path/to/fonts/texb.ttf',\n\t\t'img_width'\t=> '150',\n\t\t'img_height'\t=> 30,\n\t\t'expiration'\t=> 7200,\n\t\t'word_length'\t=> 8,\n\t\t'font_size'\t=> 16,\n\t\t'img_id'\t=> 'Imageid',\n\t\t'pool'\t\t=> '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ',\n\n\t\t// White background and border, black text and red grid\n\t\t'colors'\t=> array(\n\t\t\t'background' => array(255, 255, 255),\n\t\t\t'border' => array(255, 255, 255),\n\t\t\t'text' => array(0, 0, 0),\n\t\t\t'grid' => array(255, 40, 40)\n\t\t)\n\t);\n\n\t$cap = create_captcha($vals);\n\techo $cap['image'];\n\n-  The captcha function requires the GD image library.\n-  The **img_path** and **img_url** are both required if you want to write images to disk.\n   To create ``data:image/png;base64`` images, simply omit these options.\n-  If a **word** is not supplied, the function will generate a random\n   ASCII string. You might put together your own word library that you\n   can draw randomly from.\n-  If you do not specify a path to a TRUE TYPE font, the native ugly GD\n   font will be used.\n-  The \"captcha\" directory must be writable\n-  The **expiration** (in seconds) signifies how long an image will remain\n   in the captcha folder before it will be deleted. The default is two\n   hours.\n-  **word_length** defaults to 8, **pool** defaults to '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'\n-  **font_size** defaults to 16, the native GD font has a size limit. Specify a \"true type\" font for bigger sizes.\n-  The **img_id** will be set as the \"id\" of the captcha image.\n-  If any of the **colors** values is missing, it will be replaced by the default.\n\nAdding a Database\n-----------------\n\nIn order for the captcha function to prevent someone from submitting,\nyou will need to add the information returned from ``create_captcha()``\nto your database. Then, when the data from the form is submitted by\nthe user you will need to verify that the data exists in the database\nand has not expired.\n\nHere is a table prototype::\n\n\tCREATE TABLE captcha (  \n\t\tcaptcha_id bigint(13) unsigned NOT NULL auto_increment,  \n\t\tcaptcha_time int(10) unsigned NOT NULL,  \n\t\tip_address varchar(45) NOT NULL,  \n\t\tword varchar(20) NOT NULL,  \n\t\tPRIMARY KEY `captcha_id` (`captcha_id`),  \n\t\tKEY `word` (`word`)\n\t);\n\nHere is an example of usage with a database. On the page where the\nCAPTCHA will be shown you'll have something like this::\n\n\t$this->load->helper('captcha');\n\n\t$cap = create_captcha($vals);\n\t$data = array(     \n\t\t'captcha_time'\t=> $cap['time'],     \n\t\t'ip_address'\t=> $this->input->ip_address(),     \n\t\t'word'\t\t=> $cap['word']     \n\t);\n\n\t$query = $this->db->insert_string('captcha', $data);\n\t$this->db->query($query);\n\n\techo 'Submit the word you see below:';\n\techo $cap['image'];\n\techo '';\n\nThen, on the page that accepts the submission you'll have something like\nthis::\n\n\t// First, delete old captchas\n\t$expiration = time() - 7200; // Two hour limit\n\t$this->db->where('captcha_time < ', $expiration)\n\t\t->delete('captcha');\n\n\t// Then see if a captcha exists:\n\t$sql = 'SELECT COUNT(*) AS count FROM captcha WHERE word = ? AND ip_address = ? AND captcha_time > ?';\n\t$binds = array($_POST['captcha'], $this->input->ip_address(), $expiration);\n\t$query = $this->db->query($sql, $binds);\n\t$row = $query->row();\n\n\tif ($row->count == 0)\n\t{     \n\t\techo 'You must submit the word that appears in the image.';\n\t}\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n.. php:function:: create_captcha($data)\n\n\t:param\tarray\t$data: Array of data for the CAPTCHA\n\t:returns:\tarray('word' => $word, 'time' => $now, 'image' => $img)\n\t:rtype:\tarray\n\n\tTakes an array of information to generate the CAPTCHA as input and\n\tcreates the image to your specifications, returning an array of\n\tassociative data about the image.\n\n\t::\n\n\t\tarray(\n\t\t\t'image'\t=> IMAGE TAG\n\t\t\t'time'\t=> TIMESTAMP (in microtime)\n\t\t\t'word'\t=> CAPTCHA WORD\n\t\t)\n\n\tThe **image** is the actual image tag::\n\n\t\t\n\n\tThe **time** is the micro timestamp used as the image name without the\n\tfile extension. It will be a number like this: 1139612155.3422\n\n\tThe **word** is the word that appears in the captcha image, which if not\n\tsupplied to the function, will be a random string.\n"
  },
  {
    "path": "user_guide_src/source/helpers/cookie_helper.rst",
    "content": "#############\nCookie Helper\n#############\n\nThe Cookie Helper file contains functions that assist in working with\ncookies.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('cookie');\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: set_cookie($name[, $value = ''[, $expire = 0[, $domain = ''[, $path = '/'[, $prefix = ''[, $secure = NULL[, $httponly = NULL[, $samesite = NULL]]]]]]]])\n\n\t:param\tmixed\t$name: Cookie name *or* associative array of all of the parameters available to this function\n\t:param\tstring\t$value: Cookie value\n\t:param\tint\t$expire: Number of seconds until expiration\n\t:param\tstring\t$domain: Cookie domain (usually: .yourdomain.com)\n\t:param\tstring\t$path: Cookie path\n\t:param\tstring\t$prefix: Cookie name prefix\n\t:param\tbool\t$secure: Whether to only send the cookie through HTTPS\n\t:param\tbool\t$httponly: Whether to hide the cookie from JavaScript\n\t:param\tstring\t$samesite: SameSite attribute ('Lax', 'Strict', 'None')\n\t:rtype:\tvoid\n\n\tThis helper function gives you friendlier syntax to set browser\n\tcookies. Refer to the :doc:`Input Library <../libraries/input>` for\n\ta description of its use, as this function is an alias for\n\t``CI_Input::set_cookie()``.\n\n.. php:function:: get_cookie($index[, $xss_clean = FALSE])\n\n\t:param\tstring\t$index: Cookie name\n\t:param\tbool\t$xss_clean: Whether to apply XSS filtering to the returned value\n\t:returns:\tThe cookie value or NULL if not found\n\t:rtype:\tmixed\n\n\tThis helper function gives you friendlier syntax to get browser\n\tcookies. Refer to the :doc:`Input Library <../libraries/input>` for\n\tdetailed description of its use, as this function acts very\n\tsimilarly to ``CI_Input::cookie()``, except it will also prepend\n\tthe ``$config['cookie_prefix']`` that you might've set in your\n\t*application/config/config.php* file.\n\n.. php:function:: delete_cookie($name[, $domain = ''[, $path = '/'[, $prefix = '']]])\n\n\t:param\tstring\t$name: Cookie name\n\t:param\tstring\t$domain: Cookie domain (usually: .yourdomain.com)\n\t:param\tstring\t$path: Cookie path\n\t:param\tstring\t$prefix: Cookie name prefix\n\t:rtype:\tvoid\n\n\tLets you delete a cookie. Unless you've set a custom path or other\n\tvalues, only the name of the cookie is needed.\n\t::\n\n\t\tdelete_cookie('name');\n\n\tThis function is otherwise identical to ``set_cookie()``, except that it\n\tdoes not have the value and expiration parameters. You can submit an\n\tarray of values in the first parameter or you can set discrete\n\tparameters.\n\t::\n\n\t\tdelete_cookie($name, $domain, $path, $prefix);\n"
  },
  {
    "path": "user_guide_src/source/helpers/date_helper.rst",
    "content": "###########\nDate Helper\n###########\n\nThe Date Helper file contains functions that help you work with dates.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('date');\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: now([$timezone = NULL])\n\n\t:param\tstring\t$timezone: Timezone\n\t:returns:\tUNIX timestamp\n\t:rtype:\tint\n\n\tReturns the current time as a UNIX timestamp, referenced either to your server's\n\tlocal time or any PHP supported timezone, based on the \"time reference\" setting\n\tin your config file. If you do not intend to set your master time reference to\n\tany other PHP supported timezone (which you'll typically do if you run a site\n\tthat lets each user set their own timezone settings) there is no benefit to using\n\tthis function over PHP's ``time()`` function.\n\t::\n\n\t\techo now('Australia/Victoria');\n\n\tIf a timezone is not provided, it will return ``time()`` based on the\n\t**time_reference** setting.\n\n.. php:function:: mdate([$datestr = ''[, $time = '']])\n\n\t:param\tstring\t$datestr: Date string\n\t:param\tint\t$time: UNIX timestamp\n\t:returns:\tMySQL-formatted date\n\t:rtype:\tstring\n\n\tThis function is identical to PHP's `date() `_\n\tfunction, except that it lets you use MySQL style date codes, where each\n\tcode letter is preceded with a percent sign, e.g. `%Y %m %d`\n\n\tThe benefit of doing dates this way is that you don't have to worry\n\tabout escaping any characters that are not date codes, as you would\n\tnormally have to do with the ``date()`` function.\n\n\tExample::\n\n\t\t$datestring = 'Year: %Y Month: %m Day: %d - %h:%i %a';\n\t\t$time = time();\n\t\techo mdate($datestring, $time);\n\n\tIf a timestamp is not included in the second parameter the current time\n\twill be used.\n\n.. php:function:: local_to_gmt([$time = ''])\n\n\t:param\tint\t$time: UNIX timestamp\n\t:returns:\tUNIX timestamp\n\t:rtype:\tint\n\n\tTakes a UNIX timestamp as input and returns it as GMT.\n\n\tExample::\n\n\t\t$gmt = local_to_gmt(time());\n\n.. php:function:: gmt_to_local([$time = ''[, $timezone = 'UTC'[, $dst = FALSE]]])\n\n\t:param\tint\t$time: UNIX timestamp\n\t:param\tstring\t$timezone: Timezone\n\t:param\tbool\t$dst: Whether DST is active\n\t:returns:\tUNIX timestamp\n\t:rtype:\tint\n\n\tTakes a UNIX timestamp (referenced to GMT) as input, and converts it to\n\ta localized timestamp based on the timezone and Daylight Saving Time\n\tsubmitted.\n\n\tExample::\n\n\t\t$timestamp = 1140153693;\n\t\t$timezone  = 'UM8';\n\t\t$daylight_saving = TRUE;\n\t\techo gmt_to_local($timestamp, $timezone, $daylight_saving);\n\n\n\t.. note:: For a list of timezones see the reference at the bottom of this page.\n\n.. php:function:: mysql_to_unix([$time = ''])\n\n\t:param\tstring\t$time: MySQL timestamp\n\t:returns:\tUNIX timestamp\n\t:rtype:\tint\n\n\tTakes a MySQL Timestamp as input and returns it as a UNIX timestamp.\n\n\tExample::\n\n\t\t$unix = mysql_to_unix('20061124092345');\n\n.. php:function:: unix_to_human([$time = ''[, $seconds = FALSE[, $fmt = 'us']]])\n\n\t:param\tint\t$time: UNIX timestamp\n\t:param\tbool\t$seconds: Whether to show seconds\n\t:param\tstring\t$fmt: format (us or euro)\n\t:returns:\tFormatted date\n\t:rtype:\tstring\n\n\tTakes a UNIX timestamp as input and returns it in a human readable\n\tformat with this prototype::\n\n\t\tYYYY-MM-DD HH:MM:SS AM/PM\n\n\tThis can be useful if you need to display a date in a form field for\n\tsubmission.\n\n\tThe time can be formatted with or without seconds, and it can be set to\n\tEuropean or US format. If only the timestamp is submitted it will return\n\tthe time without seconds formatted for the U.S.\n\n\tExamples::\n\n\t\t$now = time();\n\t\techo unix_to_human($now); // U.S. time, no seconds\n\t\techo unix_to_human($now, TRUE, 'us'); // U.S. time with seconds\n\t\techo unix_to_human($now, TRUE, 'eu'); // Euro time with seconds\n\n.. php:function:: human_to_unix([$datestr = ''])\n\n\t:param\tint\t$datestr: Date string\n\t:returns:\tUNIX timestamp or FALSE on failure\n\t:rtype:\tint\n\n\tThe opposite of the :php:func:`unix_to_time()` function. Takes a \"human\"\n\ttime as input and returns it as a UNIX timestamp. This is useful if you\n\taccept \"human\" formatted dates submitted via a form. Returns boolean FALSE\n\tdate string passed to it is not formatted as indicated above.\n\n\tExample::\n\n\t\t$now = time();\n\t\t$human = unix_to_human($now);\n\t\t$unix = human_to_unix($human);\n\n.. php:function:: timespan([$seconds = 1[, $time = ''[, $units = '']]])\n\n\t:param\tint\t$seconds: Number of seconds\n\t:param\tstring\t$time: UNIX timestamp\n\t:param\tint\t$units: Number of time units to display\n\t:returns:\tFormatted time difference\n\t:rtype:\tstring\n\n\tFormats a UNIX timestamp so that is appears similar to this::\n\n\t\t1 Year, 10 Months, 2 Weeks, 5 Days, 10 Hours, 16 Minutes\n\n\tThe first parameter must contain a UNIX timestamp.\n\tThe second parameter must contain a timestamp that is greater that the\n\tfirst timestamp.\n\tThe thirdparameter is optional and limits the number of time units to display.\n\n\tIf the second parameter empty, the current time will be used.\n\n\tThe most common purpose for this function is to show how much time has\n\telapsed from some point in time in the past to now.\n\n\tExample::\n\n\t\t$post_date = '1079621429';\n\t\t$now = time();\n\t\t$units = 2;\n\t\techo timespan($post_date, $now, $units);\n\n\t.. note:: The text generated by this function is found in the following language\n\t\tfile: `language//date_lang.php`\n\n.. php:function:: days_in_month([$month = 0[, $year = '']])\n\n\t:param\tint\t$month: a numeric month\n\t:param\tint\t$year: a numeric year\n\t:returns:\tCount of days in the specified month\n\t:rtype:\tint\n\n\tReturns the number of days in a given month/year. Takes leap years into\n\taccount.\n\n\tExample::\n\n\t\techo days_in_month(06, 2005);\n\n\tIf the second parameter is empty, the current year will be used.\n\n\t.. note:: This function will alias the native ``cal_days_in_month()``, if\n\t\tit is available.\n\n.. php:function:: date_range([$unix_start = ''[, $mixed = ''[, $is_unix = TRUE[, $format = 'Y-m-d']]]])\n\n\t:param\tint\t$unix_start: UNIX timestamp of the range start date\n\t:param\tint\t$mixed: UNIX timestamp of the range end date or interval in days\n\t:param\tbool\t$is_unix: set to FALSE if $mixed is not a timestamp\n\t:param\tstring\t$format: Output date format, same as in ``date()``\n\t:returns:\tAn array of dates\n\t:rtype:\tarray\n\n\tReturns a list of dates within a specified period.\n\n\tExample::\n\n\t\t$range = date_range('2012-01-01', '2012-01-15');\n\t\techo \"First 15 days of 2012:\";\n\t\tforeach ($range as $date)\n\t\t{\n\t\t\techo $date.\"\\n\";\n\t\t}\n\n.. php:function:: timezones([$tz = ''])\n\n\t:param\tstring\t$tz: A numeric timezone\n\t:returns:\tHour difference from UTC\n\t:rtype:\tint\n\n\tTakes a timezone reference (for a list of valid timezones, see the\n\t\"Timezone Reference\" below) and returns the number of hours offset from\n\tUTC.\n\n\tExample::\n\n\t\techo timezones('UM5');\n\n\n\tThis function is useful when used with :php:func:`timezone_menu()`.\n\n.. php:function:: timezone_menu([$default = 'UTC'[, $class = ''[, $name = 'timezones'[, $attributes = '']]]])\n\n\t:param\tstring\t$default: Timezone\n\t:param\tstring\t$class: Class name\n\t:param\tstring\t$name: Menu name\n\t:param\tmixed\t$attributes: HTML attributes\n\t:returns:\tHTML drop down menu with time zones\n\t:rtype:\tstring\n\n\tGenerates a pull-down menu of timezones, like this one:\n\n\t.. raw:: html\n\n\t\t
        \n\t\t\t\n\t\t
        \n\n\n\tThis menu is useful if you run a membership site in which your users are\n\tallowed to set their local timezone value.\n\n\tThe first parameter lets you set the \"selected\" state of the menu. For\n\texample, to set Pacific time as the default you will do this::\n\n\t\techo timezone_menu('UM8');\n\n\tPlease see the timezone reference below to see the values of this menu.\n\n\tThe second parameter lets you set a CSS class name for the menu.\n\n\tThe fourth parameter lets you set one or more attributes on the generated select tag.\n\n\t.. note:: The text contained in the menu is found in the following\n\t\tlanguage file: `language//date_lang.php`\n\nTimezone Reference\n==================\n\nThe following table indicates each timezone and its location.\n\nNote some of the location lists have been abridged for clarity and formatting.\n\n===========     =====================================================================\nTime Zone       Location\n===========     =====================================================================\nUM12            (UTC - 12:00) Baker/Howland Island\nUM11            (UTC - 11:00) Samoa Time Zone, Niue\nUM10            (UTC - 10:00) Hawaii-Aleutian Standard Time, Cook Islands\nUM95            (UTC - 09:30) Marquesas Islands\nUM9             (UTC - 09:00) Alaska Standard Time, Gambier Islands\nUM8             (UTC - 08:00) Pacific Standard Time, Clipperton Island\nUM7             (UTC - 07:00) Mountain Standard Time\nUM6             (UTC - 06:00) Central Standard Time\nUM5             (UTC - 05:00) Eastern Standard Time, Western Caribbean\nUM45            (UTC - 04:30) Venezuelan Standard Time\nUM4             (UTC - 04:00) Atlantic Standard Time, Eastern Caribbean\nUM35            (UTC - 03:30) Newfoundland Standard Time\nUM3             (UTC - 03:00) Argentina, Brazil, French Guiana, Uruguay\nUM2             (UTC - 02:00) South Georgia/South Sandwich Islands\nUM1             (UTC -1:00) Azores, Cape Verde Islands\nUTC             (UTC) Greenwich Mean Time, Western European Time\nUP1             (UTC +1:00) Central European Time, West Africa Time\nUP2             (UTC +2:00) Central Africa Time, Eastern European Time\nUP3             (UTC +3:00) Moscow Time, East Africa Time\nUP35            (UTC +3:30) Iran Standard Time\nUP4             (UTC +4:00) Azerbaijan Standard Time, Samara Time\nUP45            (UTC +4:30) Afghanistan\nUP5             (UTC +5:00) Pakistan Standard Time, Yekaterinburg Time\nUP55            (UTC +5:30) Indian Standard Time, Sri Lanka Time\nUP575           (UTC +5:45) Nepal Time\nUP6             (UTC +6:00) Bangladesh Standard Time, Bhutan Time, Omsk Time\nUP65            (UTC +6:30) Cocos Islands, Myanmar\nUP7             (UTC +7:00) Krasnoyarsk Time, Cambodia, Laos, Thailand, Vietnam\nUP8             (UTC +8:00) Australian Western Standard Time, Beijing Time\nUP875           (UTC +8:45) Australian Central Western Standard Time\nUP9             (UTC +9:00) Japan Standard Time, Korea Standard Time, Yakutsk\nUP95            (UTC +9:30) Australian Central Standard Time\nUP10            (UTC +10:00) Australian Eastern Standard Time, Vladivostok Time\nUP105           (UTC +10:30) Lord Howe Island\nUP11            (UTC +11:00) Srednekolymsk Time, Solomon Islands, Vanuatu\nUP115           (UTC +11:30) Norfolk Island\nUP12            (UTC +12:00) Fiji, Gilbert Islands, Kamchatka, New Zealand\nUP1275          (UTC +12:45) Chatham Islands Standard Time\nUP13            (UTC +13:00) Phoenix Islands Time, Tonga\nUP14            (UTC +14:00) Line Islands\n===========\t=====================================================================\n"
  },
  {
    "path": "user_guide_src/source/helpers/directory_helper.rst",
    "content": "################\nDirectory Helper\n################\n\nThe Directory Helper file contains functions that assist in working with\ndirectories.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code:\n\n::\n\n\t$this->load->helper('directory');\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: directory_map($source_dir[, $directory_depth = 0[, $hidden = FALSE]])\n\n\t:param\tstring\t$source_dir: Path to the source directory\n\t:param\tint\t$directory_depth: Depth of directories to traverse (0 = fully recursive, 1 = current dir, etc)\n\t:param\tbool\t$hidden: Whether to include hidden directories\n\t:returns:\tAn array of files\n\t:rtype:\tarray\n\n\tExamples::\n\n\t\t$map = directory_map('./mydirectory/');\n\n\t.. note:: Paths are almost always relative to your main index.php file.\n\n\n\tSub-folders contained within the directory will be mapped as well. If\n\tyou wish to control the recursion depth, you can do so using the second\n\tparameter (integer). A depth of 1 will only map the top level directory::\n\n\t\t$map = directory_map('./mydirectory/', 1);\n\n\tBy default, hidden files will not be included in the returned array. To\n\toverride this behavior, you may set a third parameter to true (boolean)::\n\n\t\t$map = directory_map('./mydirectory/', FALSE, TRUE);\n\n\tEach folder name will be an array index, while its contained files will\n\tbe numerically indexed. Here is an example of a typical array::\n\n\t\tArray (\n\t\t\t[libraries] => Array\n\t\t\t\t(\n\t\t\t\t\t[0] => benchmark.html\n\t\t\t\t\t[1] => config.html\n\t\t\t\t\t[\"database/\"] => Array\n\t\t\t\t\t\t(\n\t\t\t\t\t\t\t[0] => query_builder.html\n\t\t\t\t\t\t\t[1] => binds.html\n\t\t\t\t\t\t\t[2] => configuration.html\n\t\t\t\t\t\t\t[3] => connecting.html\n\t\t\t\t\t\t\t[4] => examples.html\n\t\t\t\t\t\t\t[5] => fields.html\n\t\t\t\t\t\t\t[6] => index.html\n\t\t\t\t\t\t\t[7] => queries.html\n\t\t\t\t\t\t)\n\t\t\t\t\t[2] => email.html\n\t\t\t\t\t[3] => file_uploading.html\n\t\t\t\t\t[4] => image_lib.html\n\t\t\t\t\t[5] => input.html\n\t\t\t\t\t[6] => language.html\n\t\t\t\t\t[7] => loader.html\n\t\t\t\t\t[8] => pagination.html\n\t\t\t\t\t[9] => uri.html\n\t\t\t\t)"
  },
  {
    "path": "user_guide_src/source/helpers/download_helper.rst",
    "content": "###############\nDownload Helper\n###############\n\nThe Download Helper lets you download data to your desktop.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('download');\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: force_download([$filename = ''[, $data = ''[, $set_mime = FALSE]]])\n\n\t:param\tmixed\t$filename: Filename\n\t:param\tmixed\t$data: File contents\n\t:param\tbool\t$set_mime: Whether to try to send the actual MIME type\n\t:rtype:\tvoid\n\n\tGenerates server headers which force data to be downloaded to your\n\tdesktop. Useful with file downloads. The first parameter is the **name\n\tyou want the downloaded file to be named**, the second parameter is the\n\tfile data.\n\n\tIf you set the second parameter to NULL and ``$filename`` is an existing, readable\n\tfile path, then its content will be read instead. You may also set ``$filename``\n\tas an associative array with a single element, where the key of that element would be \n\tthe local file you are trying to read and where the value is the name of the downloadable\n\tfile that will be sent to browser. An example of this is provided below.\n\t\n\tIf you set the third parameter to boolean TRUE, then the actual file MIME type\n\t(based on the filename extension) will be sent, so that if your browser has a\n\thandler for that type - it can use it.\n\n\tExample::\n\n\t\t$data = 'Here is some text!';\n\t\t$name = 'mytext.txt';\n\t\tforce_download($name, $data);\n\n\tIf you want to download an existing file from your server you'll need to\n\tdo the following::\n\n\t\t// Contents of photo.jpg will be automatically read\n\t\tforce_download('/path/to/photo.jpg', NULL);\n\n\tIf you want to download an existing file from your server, but change the name\n\tof the actual file sent to browser, you will need this::\n\n\t\t// Contents of photo.jpg will be automatically read and sent as my-photo.jpg\n\t\tforce_download(array('/path/to/photo.jpg' => 'my-photo.jpg'), NULL);"
  },
  {
    "path": "user_guide_src/source/helpers/file_helper.rst",
    "content": "###########\nFile Helper\n###########\n\nThe File Helper file contains functions that assist in working with files.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('file');\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n.. php:function:: write_file($path, $data[, $mode = 'wb'])\n\n\t:param\tstring\t$path: File path\n\t:param\tstring\t$data: Data to write to file\n\t:param\tstring\t$mode: ``fopen()`` mode\n\t:returns:\tTRUE if the write was successful, FALSE in case of an error\n\t:rtype:\tbool\n\n\tWrites data to the file specified in the path. If the file does not exist then the\n\tfunction will create it.\n\n\tExample::\n\n\t\t$data = 'Some file data';\n\t\tif ( ! write_file('./path/to/file.php', $data))\n\t\t{     \n\t\t\techo 'Unable to write the file';\n\t\t}\n\t\telse\n\t\t{     \n\t\t\techo 'File written!';\n\t\t}\n\n\tYou can optionally set the write mode via the third parameter::\n\n\t\twrite_file('./path/to/file.php', $data, 'r+');\n\n\tThe default mode is 'wb'. Please see the `PHP user guide `_\n\tfor mode options.\n\n\t.. note: In order for this function to write data to a file, its permissions must\n\t\tbe set such that it is writable. If the file does not already exist,\n\t\tthen the directory containing it must be writable.\n\n\t.. note:: The path is relative to your main site index.php file, NOT your\n\t\tcontroller or view files. CodeIgniter uses a front controller so paths\n\t\tare always relative to the main site index.\n\n\t.. note:: This function acquires an exclusive lock on the file while writing to it.\n\n.. php:function:: delete_files($path[, $del_dir = FALSE[, $htdocs = FALSE]])\n\n\t:param\tstring\t$path: Directory path\n\t:param\tbool\t$del_dir: Whether to also delete directories\n\t:param\tbool\t$htdocs: Whether to skip deleting .htaccess and index page files\n\t:returns:\tTRUE on success, FALSE in case of an error\n\t:rtype:\tbool\n\n\tDeletes ALL files contained in the supplied path.\n\n\tExample::\n\n\t\tdelete_files('./path/to/directory/');\n\n\tIf the second parameter is set to TRUE, any directories contained within the supplied\n\troot path will be deleted as well.\n\n\tExample::\n\n\t\tdelete_files('./path/to/directory/', TRUE);\n\n\t.. note:: The files must be writable or owned by the system in order to be deleted.\n\n.. php:function:: get_filenames($source_dir[, $include_path = FALSE])\n\n\t:param\tstring\t$source_dir: Directory path\n\t:param\tbool\t$include_path: Whether to include the path as part of the filenames\n\t:returns:\tAn array of file names\n\t:rtype:\tarray\n\n\tTakes a server path as input and returns an array containing the names of all files\n\tcontained within it. The file path can optionally be added to the file names by setting\n\tthe second parameter to TRUE.\n\n\tExample::\n\n\t\t$controllers = get_filenames(APPPATH.'controllers/');\n\n.. php:function:: get_dir_file_info($source_dir, $top_level_only)\n\n\t:param\tstring\t$source_dir: Directory path\n\t:param\tbool\t$top_level_only: Whether to look only at the specified directory (excluding sub-directories)\n\t:returns:\tAn array containing info on the supplied directory's contents\n\t:rtype:\tarray\n\n\tReads the specified directory and builds an array containing the filenames, filesize,\n\tdates, and permissions. Sub-folders contained within the specified path are only read\n\tif forced by sending the second parameter to FALSE, as this can be an intensive\n\toperation.\n\n\tExample::\n\n\t\t$models_info = get_dir_file_info(APPPATH.'models/');\n\n.. php:function:: get_file_info($file[, $returned_values = array('name', 'server_path', 'size', 'date')])\n\n\t:param\tstring\t$file: File path\n\t:param\tarray\t$returned_values: What type of info to return\n\t:returns:\tAn array containing info on the specified file or FALSE on failure\n\t:rtype:\tarray\n\n\tGiven a file and path, returns (optionally) the *name*, *path*, *size* and *date modified*\n\tinformation attributes for a file. Second parameter allows you to explicitly declare what\n\tinformation you want returned.\n\n\tValid ``$returned_values`` options are: `name`, `size`, `date`, `readable`, `writeable`,\n\t`executable` and `fileperms`.\n\n.. php:function:: get_mime_by_extension($filename)\n\n\t:param\tstring\t$filename: File name\n\t:returns:\tMIME type string or FALSE on failure\n\t:rtype:\tstring\n\n\tTranslates a filename extension into a MIME type based on *config/mimes.php*.\n\tReturns FALSE if it can't determine the type, or read the MIME config file.\n\n\t::\n\n\t\t$file = 'somefile.png';\n\t\techo $file.' is has a mime type of '.get_mime_by_extension($file);\n\n\t.. note:: This is not an accurate way of determining file MIME types, and\n\t\tis here strictly for convenience. It should not be used for security\n\t\tpurposes.\n\n.. php:function:: symbolic_permissions($perms)\n\n\t:param\tint\t$perms: Permissions\n\t:returns:\tSymbolic permissions string\n\t:rtype:\tstring\n\n\tTakes numeric permissions (such as is returned by ``fileperms()``) and returns\n\tstandard symbolic notation of file permissions.\n\n\t::\n\n\t\techo symbolic_permissions(fileperms('./index.php'));  // -rw-r--r--\n\n.. php:function:: octal_permissions($perms)\n\n\t:param\tint\t$perms: Permissions\n\t:returns:\tOctal permissions string\n\t:rtype:\tstring\n\n\tTakes numeric permissions (such as is returned by ``fileperms()``) and returns\n\ta three character octal notation of file permissions.\n\n\t::\n\n\t\techo octal_permissions(fileperms('./index.php')); // 644\n"
  },
  {
    "path": "user_guide_src/source/helpers/form_helper.rst",
    "content": "###########\nForm Helper\n###########\n\nThe Form Helper file contains functions that assist in working with\nforms.\n\n.. contents::\n  :local:\n\n.. raw:: html\n\n  
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('form');\n\nEscaping field values\n=====================\n\nYou may need to use HTML and characters such as quotes within your form\nelements. In order to do that safely, you'll need to use\n:doc:`common function <../general/common_functions>`\n:func:`html_escape()`.\n\nConsider the following example::\n\n\t$string = 'Here is a string containing \"quoted\" text.';\n\n\t\" />\n\nSince the above string contains a set of quotes, it will cause the form\nto break. The :php:func:`html_escape()` function converts HTML special\ncharacters so that it can be used safely::\n\n\t\" />\n\n.. note:: If you use any of the form helper functions listed on this page,\n\tthe form values will be automatically escaped, so there is no need\n\tto call this function. Use it only if you are creating your own\n\tform elements.\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: form_open([$action = ''[, $attributes = ''[, $hidden = array()]]])\n\n\t:param\tstring\t$action: Form action/target URI string\n\t:param\tarray\t$attributes: HTML attributes\n\t:param\tarray\t$hidden: An array of hidden fields' definitions\n\t:returns:\tAn HTML form opening tag\n\t:rtype:\tstring\n\n\tCreates an opening form tag with a base URL **built from your config preferences**.\n\tIt will optionally let you add form attributes and hidden input fields, and\n\twill always add the `accept-charset` attribute based on the charset value in your\n\tconfig file.\n\n\tThe main benefit of using this tag rather than hard coding your own HTML is that\n\tit permits your site to be more portable in the event your URLs ever change.\n\n\tHere's a simple example::\n\n\t\techo form_open('email/send');\n\n\tThe above example would create a form that points to your base URL plus the\n\t\"email/send\" URI segments, like this::\n\n\t\t
        \n\n\t**Adding Attributes**\n\n\t\tAttributes can be added by passing an associative array to the second\n\t\tparameter, like this::\n\n\t\t\t$attributes = array('class' => 'email', 'id' => 'myform');\n\t\t\techo form_open('email/send', $attributes);\n\n\t\tAlternatively, you can specify the second parameter as a string::\n\n\t\t\techo form_open('email/send', 'class=\"email\" id=\"myform\"');\n\n\t\tThe above examples would create a form similar to this::\n\n\t\t\t\n\n\t**Adding Hidden Input Fields**\n\n\t\tHidden fields can be added by passing an associative array to the\n\t\tthird parameter, like this::\n\n\t\t\t$hidden = array('username' => 'Joe', 'member_id' => '234');\n\t\t\techo form_open('email/send', '', $hidden);\n\n\t\tYou can skip the second parameter by passing any falsy value to it.\n\n\t\tThe above example would create a form similar to this::\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\n\n\n.. php:function:: form_open_multipart([$action = ''[, $attributes = array()[, $hidden = array()]]])\n\n\t:param\tstring\t$action: Form action/target URI string\n\t:param\tarray\t$attributes: HTML attributes\n\t:param\tarray\t$hidden: An array of hidden fields' definitions\n\t:returns:\tAn HTML multipart form opening tag\n\t:rtype:\tstring\n\n\tThis function is absolutely identical to :php:func:`form_open()` above,\n\texcept that it adds a *multipart* attribute, which is necessary if you\n\twould like to use the form to upload files with.\n\n\n.. php:function:: form_hidden($name[, $value = ''])\n\n\t:param\tstring\t$name: Field name\n\t:param\tstring\t$value: Field value\n\t:returns:\tAn HTML hidden input field tag\n\t:rtype:\tstring\n\n\tLets you generate hidden input fields. You can either submit a\n\tname/value string to create one field::\n\n\t\tform_hidden('username', 'johndoe');\n\t\t// Would produce: \n\n\t... or you can submit an associative array to create multiple fields::\n\n\t\t$data = array(\n\t\t\t'name'\t=> 'John Doe',\n\t\t\t'email'\t=> 'john@example.com',\n\t\t\t'url'\t=> 'http://example.com'\n\t\t);\n\n\t\techo form_hidden($data);\n\n\t\t/*\n\t\t\tWould produce:\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t*/\n\n\tYou can also pass an associative array to the value field::\n\n\t\t$data = array(\n\t\t\t'name'\t=> 'John Doe',\n\t\t\t'email'\t=> 'john@example.com',\n\t\t\t'url'\t=> 'http://example.com'\n\t\t);\n\n\t\techo form_hidden('my_array', $data);\n\n\t\t/*\n\t\t\tWould produce:\n\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t*/\n\n\tIf you want to create hidden input fields with extra attributes::\n\n\t\t$data = array(\n\t\t\t'type'\t=> 'hidden',\n\t\t\t'name'\t=> 'email',\n\t\t\t'id'\t=> 'hiddenemail',\n\t\t\t'value'\t=> 'john@example.com',\n\t\t\t'class'\t=> 'hiddenemail'\n\t\t);\n\n\t\techo form_input($data);\n\n\t\t/*\n\t\t\tWould produce:\n\n\t\t\t\n\t\t*/\n\n.. php:function:: form_input([$data = ''[, $value = ''[, $extra = '']]])\n\n\t:param\tarray\t$data: Field attributes data\n\t:param\tstring\t$value: Field value\n\t:param\tmixed\t$extra: Extra attributes to be added to the tag either as an array or a literal string\n\t:returns:\tAn HTML text input field tag\n\t:rtype:\tstring\n\n\tLets you generate a standard text input field. You can minimally pass\n\tthe field name and value in the first and second parameter::\n\n\t\techo form_input('username', 'johndoe');\n\n\tOr you can pass an associative array containing any data you wish your\n\tform to contain::\n\n\t\t$data = array(\n\t\t\t'name'\t\t=> 'username',\n\t\t\t'id'\t\t=> 'username',\n\t\t\t'value'\t\t=> 'johndoe',\n\t\t\t'maxlength'\t=> '100',\n\t\t\t'size'\t\t=> '50',\n\t\t\t'style'\t\t=> 'width:50%'\n\t\t);\n\n\t\techo form_input($data);\n\n\t\t/*\n\t\t\tWould produce:\n\n\t\t\t\n\t\t*/\n\n\tIf you would like your form to contain some additional data, like\n\tJavaScript, you can pass it as a string in the third parameter::\n\n\t\t$js = 'onClick=\"some_function()\"';\n\t\techo form_input('username', 'johndoe', $js);\n\n\tOr you can pass it as an array::\n\n\t\t$js = array('onClick' => 'some_function();');\n\t\techo form_input('username', 'johndoe', $js);\n\n.. php:function:: form_password([$data = ''[, $value = ''[, $extra = '']]])\n\n\t:param\tarray\t$data: Field attributes data\n\t:param\tstring\t$value: Field value\n\t:param\tmixed\t$extra: Extra attributes to be added to the tag either as an array or a literal string\n\t:returns:\tAn HTML password input field tag\n\t:rtype:\tstring\n\n\tThis function is identical in all respects to the :php:func:`form_input()`\n\tfunction above except that it uses the \"password\" input type.\n\n\n.. php:function:: form_upload([$data = '', $extra = '']])\n\n\t:param\tarray\t$data: Field attributes data\n\t:param\tmixed\t$extra: Extra attributes to be added to the tag either as an array or a literal string\n\t:returns:\tAn HTML file upload input field tag\n\t:rtype:\tstring\n\n\tThis function is identical in all respects to the :php:func:`form_input()`\n\tfunction above except that it uses the \"file\" input type, allowing it to\n\tbe used to upload files.\n\n\n.. php:function:: form_textarea([$data = ''[, $value = ''[, $extra = '']]])\n\n\t:param\tarray\t$data: Field attributes data\n\t:param\tstring\t$value: Field value\n\t:param\tmixed\t$extra: Extra attributes to be added to the tag either as an array or a literal string\n\t:returns:\tAn HTML textarea tag\n\t:rtype:\tstring\n\n\tThis function is identical in all respects to the :php:func:`form_input()`\n\tfunction above except that it generates a \"textarea\" type.\n\n\t.. note:: Instead of the *maxlength* and *size* attributes in the above example,\n\t\tyou will instead specify *rows* and *cols*.\n\n.. php:function:: form_dropdown([$name = ''[, $options = array()[, $selected = array()[, $extra = '']]]])\n\n\t:param\tstring\t$name: Field name\n\t:param\tarray\t$options: An associative array of options to be listed\n\t:param\tarray\t$selected: List of fields to mark with the *selected* attribute\n\t:param\tmixed\t$extra: Extra attributes to be added to the tag either as an array or a literal string\n\t:returns:\tAn HTML dropdown select field tag\n\t:rtype:\tstring\n\n\tLets you create a standard drop-down field. The first parameter will\n\tcontain the name of the field, the second parameter will contain an\n\tassociative array of options, and the third parameter will contain the\n\tvalue you wish to be selected. You can also pass an array of multiple\n\titems through the third parameter, and CodeIgniter will create a\n\tmultiple select for you.\n\n\tExample::\n\n\t\t$options = array(\n\t\t\t'small'\t\t=> 'Small Shirt',\n\t\t\t'med'\t\t=> 'Medium Shirt',\n\t\t\t'large'\t\t=> 'Large Shirt',\n\t\t\t'xlarge'\t=> 'Extra Large Shirt',\n\t\t);\n\n\t\t$shirts_on_sale = array('small', 'large');\n\t\techo form_dropdown('shirts', $options, 'large');\n\n\t\t/*\n\t\t\tWould produce:\n\n\t\t\t\n\t\t*/\n\n\t\techo form_dropdown('shirts', $options, $shirts_on_sale);\n\n\t\t/*\n\t\t\tWould produce:\n\n\t\t\t\n\t\t*/\n\n\tIf you would like the opening \n\n\tThe third parameter contains a boolean TRUE/FALSE to determine whether\n\tthe box should be checked or not.\n\n\tSimilar to the other form functions in this helper, you can also pass an\n\tarray of attributes to the function::\n\n\t\t$data = array(\n\t\t\t'name'\t\t=> 'newsletter',\n\t\t\t'id'\t\t=> 'newsletter',\n\t\t\t'value'\t\t=> 'accept',\n\t\t\t'checked'\t=> TRUE,\n\t\t\t'style'\t\t=> 'margin:10px'\n\t\t);\n\n\t\techo form_checkbox($data);\n\t\t// Would produce: \n\n\tAlso as with other functions, if you would like the tag to contain\n\tadditional data like JavaScript, you can pass it as a string in the\n\tfourth parameter::\n\n\t\t$js = 'onClick=\"some_function()\"';\n\t\techo form_checkbox('newsletter', 'accept', TRUE, $js);\n\n\tOr you can pass it as an array::\n\n\t\t$js = array('onClick' => 'some_function();');\n\t\techo form_checkbox('newsletter', 'accept', TRUE, $js);\n\n\n.. php:function:: form_radio([$data = ''[, $value = ''[, $checked = FALSE[, $extra = '']]]])\n\n\t:param\tarray\t$data: Field attributes data\n\t:param\tstring\t$value: Field value\n\t:param\tbool\t$checked: Whether to mark the radio button as being *checked*\n\t:param\tmixed\t$extra: Extra attributes to be added to the tag either as an array or a literal string\n\t:returns:\tAn HTML radio input tag\n\t:rtype:\tstring\n\n\tThis function is identical in all respects to the :php:func:`form_checkbox()`\n\tfunction above except that it uses the \"radio\" input type.\n\n\n.. php:function:: form_label([$label_text = ''[, $id = ''[, $attributes = array()]]])\n\n\t:param\tstring\t$label_text: Text to put in the 
        ';\n\t\techo form_close($string);\n\t\t// Would produce:   \n\n\n.. php:function:: set_value($field[, $default = ''[, $html_escape = TRUE]])\n\n\t:param\tstring\t$field: Field name\n\t:param\tstring\t$default: Default value\n\t:param  bool\t$html_escape: Whether to turn off HTML escaping of the value\n\t:returns:\tField value\n\t:rtype:\tstring\n\n\tPermits you to set the value of an input form or textarea. You must\n\tsupply the field name via the first parameter of the function. The\n\tsecond (optional) parameter allows you to set a default value for the\n\tform. The third (optional) parameter allows you to turn off HTML escaping\n\tof the value, in case you need to use this function in combination with\n\ti.e. :php:func:`form_input()` and avoid double-escaping.\n\n\tExample::\n\n\t\t\" size=\"50\" />\n\n\tThe above form will show \"0\" when loaded for the first time.\n\n\t.. note:: If you've loaded the :doc:`Form Validation Library <../libraries/form_validation>` and\n\t\thave set a validation rule for the field name in use with this helper, then it will\n\t\tforward the call to the :doc:`Form Validation Library <../libraries/form_validation>`'s\n\t\town ``set_value()`` method. Otherwise, this function looks in ``$_POST`` for the\n\t\tfield value.\n\n.. php:function:: set_select($field[, $value = ''[, $default = FALSE]])\n\n\t:param\tstring\t$field: Field name\n\t:param\tstring\t$value: Value to check for\n\t:param\tstring\t$default: Whether the value is also a default one\n\t:returns:\t'selected' attribute or an empty string\n\t:rtype:\tstring\n\n\tIf you use a \n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\n.. php:function:: set_checkbox($field[, $value = ''[, $default = FALSE]])\n\n\t:param\tstring\t$field: Field name\n\t:param\tstring\t$value: Value to check for\n\t:param\tstring\t$default: Whether the value is also a default one\n\t:returns:\t'checked' attribute or an empty string\n\t:rtype:\tstring\n\n\tPermits you to display a checkbox in the state it was submitted.\n\n\tThe first parameter must contain the name of the checkbox, the second\n\tparameter must contain its value, and the third (optional) parameter\n\tlets you set an item as the default (use boolean TRUE/FALSE).\n\n\tExample::\n\n\t\t />\n\t\t />\n\n.. php:function:: set_radio($field[, $value = ''[, $default = FALSE]])\n\n\t:param\tstring\t$field: Field name\n\t:param\tstring\t$value: Value to check for\n\t:param\tstring\t$default: Whether the value is also a default one\n\t:returns:\t'checked' attribute or an empty string\n\t:rtype:\tstring\n\n\tPermits you to display radio buttons in the state they were submitted.\n\tThis function is identical to the :php:func:`set_checkbox()` function above.\n\n\tExample::\n\n\t\t />\n\t\t />\n\n\t.. note:: If you are using the Form Validation class, you must always specify\n\t\ta rule for your field, even if empty, in order for the ``set_*()``\n\t\tfunctions to work. This is because if a Form Validation object is\n\t\tdefined, the control for ``set_*()`` is handed over to a method of the\n\t\tclass instead of the generic helper function.\n\n.. php:function:: form_error([$field = ''[, $prefix = ''[, $suffix = '']]])\n\n\t:param\tstring\t$field:\tField name\n\t:param\tstring\t$prefix: Error opening tag\n\t:param\tstring\t$suffix: Error closing tag\n\t:returns:\tHTML-formatted form validation error message(s)\n\t:rtype:\tstring\n\n\tReturns a validation error message from the :doc:`Form Validation Library\n\t<../libraries/form_validation>`, associated with the specified field name.\n\tYou can optionally specify opening and closing tag(s) to put around the error\n\tmessage.\n\n\tExample::\n\n\t\t// Assuming that the 'username' field value was incorrect:\n\t\techo form_error('myfield', '
        ', '
        ');\n\n\t\t// Would produce: 
        Error message associated with the \"username\" field.
        \n\n\n.. php:function:: validation_errors([$prefix = ''[, $suffix = '']])\n\n\t:param\tstring\t$prefix: Error opening tag\n\t:param\tstring\t$suffix: Error closing tag\n\t:returns:\tHTML-formatted form validation error message(s)\n\t:rtype:\tstring\n\n\tSimilarly to the :php:func:`form_error()` function, returns all validation\n\terror messages produced by the :doc:`Form Validation Library\n\t<../libraries/form_validation>`, with optional opening and closing tags\n\taround each of the messages.\n\n\tExample::\n\n\t\techo validation_errors('', '');\n\n\t\t/*\n\t\t\tWould produce, e.g.:\n\n\t\t\tThe \"email\" field doesn't contain a valid e-mail address!\n\t\t\tThe \"password\" field doesn't match the \"repeat_password\" field!\n\n\t\t */\n"
  },
  {
    "path": "user_guide_src/source/helpers/html_helper.rst",
    "content": "###########\nHTML Helper\n###########\n\nThe HTML Helper file contains functions that assist in working with\nHTML.\n\n.. contents::\n\t:local:\n\n.. raw:: html\n\n\t
        \n\nLoading this Helper\n===================\n\nThis helper is loaded using the following code::\n\n\t$this->load->helper('html');\n\nAvailable Functions\n===================\n\nThe following functions are available:\n\n\n.. php:function:: heading([$data = ''[, $h = '1'[, $attributes = '']]])\n\n\t:param\tstring\t$data: Content\n\t:param\tstring\t$h: Heading level\n\t:param\tmixed\t$attributes: HTML attributes\n\t:returns:\tHTML heading tag\n\t:rtype:\tstring\n\n\tLets you create HTML heading tags. The first parameter will contain the\n\tdata, the second the size of the heading. Example::\n\n\t\techo heading('Welcome!', 3);\n\n\tThe above would produce: 
        Welcome!
        \n\n\tAdditionally, in order to add attributes to the heading tag such as HTML\n\tclasses, ids or inline styles, a third parameter accepts either a string\n\tor an array::\n\n\t\techo heading('Welcome!', 3, 'class=\"pink\"');\n\t\techo heading('How are you?', 4, array('id' => 'question', 'class' => 'green'));\n\n\tThe above code produces:\n\n\t.. code-block:: html\n\n\t\t
        Welcome!
        \n\t\t
        How are you?
        \n\n.. php:function:: img([$src = ''[, $index_page = FALSE[, $attributes = '']]])\n\n\t:param\tstring\t$src: Image source data\n\t:param\tbool\t$index_page: Whether to treat $src as a routed URI string\n\t:param\tarray\t$attributes: HTML attributes\n\t:returns:\tHTML image tag\n\t:rtype:\tstring\n\n\tLets you create HTML  tags. The first parameter contains the\n\timage source. Example::\n\n\t\techo img('images/picture.jpg'); // gives \n\n\tThere is an optional second parameter that is a TRUE/FALSE value that\n\tspecifics if the *src* should have the page specified by\n\t``$config['index_page']`` added to the address it creates.\n\tPresumably, this would be if you were using a media controller::\n\n\t\techo img('images/picture.jpg', TRUE); // gives \"\"\n\n\tAdditionally, an associative array can be passed to the ``img()`` function\n\tfor complete control over all attributes and values. If an *alt* attribute\n\tis not provided, CodeIgniter will generate an empty string.\n\n\tExample::\n\n\t\t$image_properties = array(\n\t\t\t'src' \t=> 'images/picture.jpg',\n\t\t\t'alt' \t=> 'Me, demonstrating how to eat 4 slices of pizza at one time',\n\t\t\t'class' => 'post_images',\n\t\t\t'width' => '200',\n\t\t\t'height'=> '200',\n\t\t\t'title' => 'That was quite a night',\n\t\t\t'rel' \t=> 'lightbox'\n\t\t);\n\n\t\timg($image_properties);\n\t\t// \"Me,\n\n.. php:function:: link_tag([$href = ''[, $rel = 'stylesheet'[, $type = 'text/css'[, $title = ''[, $media = ''[, $index_page = FALSE]]]]]])\n\n\t:param\tstring\t$href: What are we linking to\n\t:param\tstring\t$rel: Relation type\n\t:param\tstring\t$type: Type of the related document\n\t:param\tstring\t$title: Link title\n\t:param\tstring\t$media: Media type\n\t:param\tbool\t$index_page: Whether to treat $src as a routed URI string\n\t:returns:\tHTML link tag\n\t:rtype:\tstring\n\n\tLets you create HTML  tags. This is useful for stylesheet links,\n\tas well as other links. The parameters are *href*, with optional *rel*,\n\t*type*, *title*, *media* and *index_page*.\n\n\t*index_page* is a boolean value that specifies if the *href* should have\n\tthe page specified by ``$config['index_page']`` added to the address it creates.\n\n\tExample::\n\n\t\techo link_tag('css/mystyles.css');\n\t\t// gives \n\n\tFurther examples::\n\n\t\techo link_tag('favicon.ico', 'shortcut icon', 'image/ico');\n\t\t// \n\n\t\techo link_tag('feed', 'alternate', 'application/rss+xml', 'My RSS Feed');\n\t\t// \n\n\tAdditionally, an associative array can be passed to the ``link()`` function\n\tfor complete control over all attributes and values::\n\n\t\t$link = array(\n\t\t\t'href'\t=> 'css/printer.css',\n\t\t\t'rel'\t=> 'stylesheet',\n\t\t\t'type'\t=> 'text/css',\n\t\t\t'media'\t=> 'print'\n\t\t);\n\n\t\techo link_tag($link);\n\t\t// \n\n\n.. php:function:: ul($list[, $attributes = ''])\n\n\t:param\tarray\t$list: List entries\n\t:param\tarray\t$attributes: HTML attributes\n\t:returns:\tHTML-formatted unordered list\n\t:rtype:\tstring\n\n\tPermits you to generate unordered HTML lists from simple or\n\tmulti-dimensional arrays. Example::\n\n\t\t$list = array(\n\t\t\t'red',\n\t\t\t'blue',\n\t\t\t'green',\n\t\t\t'yellow'\n\t\t);\n\n\t\t$attributes = array(\n\t\t\t'class'\t=> 'boldlist',\n\t\t\t'id'\t=> 'mylist'\n\t\t);\n\n\t\techo ul($list, $attributes);\n\n\tThe above code will produce this:\n\n\t.. code-block:: html\n\n\t\t
          \n\t\t\t
        • red
          • \n\t\t\t
        • blue
          • \n\t\t\t
        • green
          • \n\t\t\t
        • yellow
          • \n\t\t
        \n\n\tHere is a more complex example, using a multi-dimensional array::\n\n\t\t$attributes = array(\n\t\t\t'class'\t=> 'boldlist',\n\t\t\t'id'\t=> 'mylist'\n\t\t);\n\n\t\t$list = array(\n\t\t\t'colors'  => array(\n\t\t\t\t'red',\n\t\t\t\t'blue',\n\t\t\t\t'green'\n\t\t\t),\n\t\t\t'shapes'  => array(\n\t\t\t\t'round',\n\t\t\t\t'square',\n\t\t\t\t'circles' => array(\n\t\t\t\t\t'ellipse',\n\t\t\t\t\t'oval',\n\t\t\t\t\t'sphere'\n\t\t\t\t)\n\t\t\t),\n\t\t\t'moods'  => array(\n\t\t\t\t'happy',\n\t\t\t\t'upset' => array(\n\t\t\t\t\t'defeated' => array(\n\t\t\t\t\t\t'dejected',\n\t\t\t\t\t\t'disheartened',\n\t\t\t\t\t\t'depressed'\n\t\t\t\t\t),\n\t\t\t\t\t'annoyed',\n\t\t\t\t\t'cross',\n\t\t\t\t\t'angry'\n\t\t\t\t)\n\t\t\t)\n\t\t);\n\n\t\techo ul($list, $attributes);\n\n\tThe above code will produce this:\n\n\t.. code-block:: html\n\n\t\t
          \n\t\t\t
        • colors\n\t\t\t\t
            \n\t\t\t\t\t
          • red
            • \n\t\t\t\t\t
          • blue
            • \n\t\t\t\t\t
          • green
            • \n\t\t\t\t
          \n\t\t\t
          • \n\t\t\t
        • shapes\n\t\t\t\t
            \n\t\t\t\t\t
          • round
            • \n\t\t\t\t\t
          • suare
            • \n\t\t\t\t\t
          • circles\n\t\t\t\t\t\t
              \n\t\t\t\t\t\t\t
            • elipse
              • \n\t\t\t\t\t\t\t
            • oval
              • \n\t\t\t\t\t\t\t
            • sphere
              • \n\t\t\t\t\t\t
            \n\t\t\t\t\t
            • \n\t\t\t\t
          \n\t\t\t
          • \n\t\t\t
        • moods\n\t\t\t\t
            \n\t\t\t\t\t
          • happy
            • \n\t\t\t\t\t
          • upset\n\t\t\t\t\t\t
              \n\t\t\t\t\t\t\t
            • defeated\n\t\t\t\t\t\t\t\t
                \n\t\t\t\t\t\t\t\t\t
              • dejected
                • \n\t\t\t\t\t\t\t\t\t
              • disheartened
                • \n\t\t\t\t\t\t\t\t\t
              • depressed
                • \n\t\t\t\t\t\t\t\t
              \n\t\t\t\t\t\t\t
              • \n\t\t\t\t\t\t\t
            • annoyed
              • \n\t\t\t\t\t\t\t
            • cross
              • \n\t\t\t\t\t\t\t
            • angry
              • \n\t\t\t\t\t\t
            \n\t\t\t\t\t
            • \n\t\t\t\t
          \n\t\t\t
          • \n\t\t
        \n\n.. php:function:: ol($list, $attributes = '')\n\n\t:param\tarray\t$list: List entries\n\t:param\tarray\t$attributes: HTML attributes\n\t:returns:\tHTML-formatted ordered list\n\t:rtype:\tstring\n\n\tIdentical to :php:func:`ul()`, only it produces the 
           tag for\n\tordered lists instead of