requirements.rst

Server Requirements

• PHP and Required Extensions
• Optional PHP Extensions
• Supported Databases

PHP and Required Extensions

PHP version 8.2 or newer is required, with the following PHP extensions are enabled:

• intl
• mbstring

Warning

• The end of life date for PHP 7.4 was November 28, 2022.
• The end of life date for PHP 8.0 was November 26, 2023.
• The end of life date for PHP 8.1 was December 31, 2025.
• If you are still using below PHP 8.2, you should upgrade immediately.
• The end of life date for PHP 8.2 will be December 31, 2026.

Note

• PHP 8.5 requires CodeIgniter 4.7.0 or later.
• PHP 8.4 requires CodeIgniter 4.6.0 or later.
• PHP 8.3 requires CodeIgniter 4.4.4 or later.
• PHP 8.2 requires CodeIgniter 4.2.11 or later.
• PHP 8.1 requires CodeIgniter 4.1.6 or later.
• Note that we only maintain the latest version.

Optional PHP Extensions

The following PHP extensions should be enabled on your server:

• mysqlnd (if you use MySQL)
• curl (if you use :doc:`CURLRequest </libraries/curlrequest>`)
• imagick (if you use :doc:`Image </libraries/images>` class ImageMagickHandler)
• gd (if you use :doc:`Image </libraries/images>` class GDHandler)
• simplexml (if you format XML)

The following PHP extensions are required when you use a Cache server:

• memcache (if you use :doc:`Cache </libraries/caching>` class MemcachedHandler with Memcache)
• memcached (if you use :doc:`Cache </libraries/caching>` class MemcachedHandler with Memcached)
• redis (if you use :doc:`Cache </libraries/caching>` class RedisHandler)

The following PHP extensions are required when you use PHPUnit:

• dom (if you use :doc:`TestResponse </testing/response>` class)
• libxml (if you use :doc:`TestResponse </testing/response>` class)
• xdebug (if you use CIUnitTestCase::assertHeaderEmitted())

Supported Databases

A database is required for most web application programming. Currently supported databases are:

• MySQL via the MySQLi driver (version 5.1 and above only)
• PostgreSQL via the Postgre driver (version 7.4 and above only)
• SQLite3 via the SQLite3 driver
• Microsoft SQL Server via the SQLSRV driver (version 2012 and above only)
• Oracle Database via the OCI8 driver (version 12.1 and above only)

Not all of the drivers have been converted/rewritten for CodeIgniter4. The list below shows the outstanding ones.

• MySQL (5.1+) via the pdo driver
• Oracle via the pdo drivers
• PostgreSQL via the pdo driver
• MSSQL via the pdo driver
• SQLite via the sqlite (version 2) and pdo drivers
• CUBRID via the cubrid and pdo drivers
• Interbase/Firebird via the ibase and pdo drivers
• ODBC via the odbc and pdo drivers (you should know that ODBC is actually an abstraction layer)