pocketarc/codeigniter

The CodeIgniter framework

3.3.0 2024-10-29 12:34 UTC

Requires

• php: >=5.4.8

Requires (Dev)

• mikey179/vfsstream: 1.6.*
• phpunit/phpunit: 4.* || 5.* || 9.*

Suggests

• paragonie/random_compat: Provides better randomness in PHP 5.x

MIT

README

This is a fork of CodeIgniter 3, with the goal of keeping it up to date with modern PHP versions. There is no intention to add new features or change the way CI3 works. This is purely a maintenance fork.

PHP Compatibility:

• ✅ PHP 5.4 - 8.1 (as per original CI3 support)
• ✅ PHP 8.2
• ✅ PHP 8.3
• ✅ PHP 8.4
• ✅ PHP 8.5 (and beyond as they are released)

The original CodeIgniter 3.x branch is no longer maintained, and has not been updated to work with PHP 8.2, or any newer version. This fork is intended to fill that gap.

If the original CodeIgniter 3.x branch is updated to work with PHP 8.2+, and starts to be maintained again, this fork might be retired.

Maintenance Policy

This fork commits to:

• Maintaining compatibility with each new PHP version while still supporting PHP 5.4+
• Applying critical security fixes
• Keeping changes minimal to preserve CI3 behavior
• Reverting unnecessary breaking changes in CodeIgniter 3.2.0-dev
• Running the full CI3 test suite on PHP 8.2+

This fork does NOT:

• Add new features
• Change existing CI3 behavior
• Provide commercial support
• Make migration to CI4 any harder (or easier)

Issues and Pulls

Issues and Pull Requests are welcome, but please note that this is a maintenance fork. New features will not be accepted. If you have a new feature you would like to see in CodeIgniter, please submit it to the original CodeIgniter 3.x branch.

Server Requirements

PHP version 5.4 or newer, same as the original CI3 requirements.

Installation

You can install this fork using Composer:

composer require pocketarc/codeigniter

After installation, you need to point CodeIgniter to the new system directory. In your index.php file, update the $system_path variable:

$system_path = 'vendor/pocketarc/codeigniter/system';

Alternative Installation (Manual)

If you prefer the traditional approach of replacing the system directory:

1. Download this repository
2. Replace your existing system/ directory with the one from this fork
3. No changes to index.php are needed with this method

Note: The Composer method makes future updates easier with composer update, while the manual method requires downloading and replacing the system directory each time.

Upgrading from Original CI3

⚠️ Important: This fork is based on the unreleased CodeIgniter 3.2.0-dev version, not the stable 3.1.13. If you're upgrading from CI 3.1.x, please read the upgrade guide for any changes that may affect your application.

Please review the upgrade guide: upgrade_320.rst

Steps to upgrade:

1. Review the upgrade guide for breaking changes between 3.1.x and 3.2.0
2. Install via Composer as shown above
3. Update the $system_path in your index.php
4. Apply any necessary changes from the upgrade guide to your application
5. Your existing application/ directory remains mostly unchanged (except for items noted in the upgrade guide)
6. Test thoroughly with your PHP version (especially if using PHP 8.2+)