Using Composer With Codeigniter

For all web app developers, who have started using modern frameworks like Symfony, Silex, Laravel etc. and have wished for composer support inside their CodeIgniter application, I will try to show you the most efficient and standardized way to achieve this goal. I have also added this feature on my own codeigniterplus project, and if you are familiar with that project, you can check it out as well. If you are concerned to get support for Composer with CodeIgniter in an existing application, you can totally do that without much worry as well.

Why You Should Consider Composer Support?

Composer is the ultimate solution for PHP developers to manage application dependencies easily and efficiently. Here, with dependencies, I mean various third-party open-source libraries/plugins, PSR standards etc.

Currently, to add a third-party library, you will have to download it, add the library source to ‘application/third_party’ directory, create a mapper library(if needed) inside ‘application/libraries’ directories and load it manually(or automatically via autoload.php). What about if all of this has been done in a very simple way?

Also, as for now, you will have to add all library codes into your source code repository and make the repo size huge unnecessarily. On the other hand, with the help of the composer, you can ignore that part and only add a dependency list on the repo, which in turn can be loaded on the server dynamically without affecting the repository size at all.

Though you should easily follow this tutorial with the least knowledge of Composer, it will be better and easier for you, if you are familiar with composer.

Get Your Composer Platform Ready:

If you haven’t yet, install composer on your system first. You can get detailed instructions on official composer getting started documentation. After that, on your project root directory, add a file named ‘composer.json’ and add at least one of the dependencies (I used monolog as an example) you want to install:

{
	"require": {
                "monolog/monolog": "*"
	},
	"minimum-stability": "dev"
}
Code language: JSON / JSON with Comments (json)

Then being on that directory, run ‘composer update’ command on your command line tool. If all goes OK, you should notice a vendor directory and a composer.lock files are created there. Congratulation, you successfully finished this part!

 

Read The Complete CodeIgniter Tutorials Series By CodeSamplez.com

 

Dirty/Easy Way To Integrate Composer With Codeigniter:

The easiest and dirtiest way to add all dependencies is to add a line like the following on your CodeIgniter’s index.php file:

include "./vendor/autoload.php";
Code language: PHP (php)

And you should be done!

It’s super easy, isn’t it? Now, you can start defining and using all classes which are inside vendor directory. Composer handles all the dependencies by dynamically creating a single ‘autoload.php’ which loads all those libraries.

The Alternative Recommended Way:

Though the previous way was easy and simple enough, personally, I wouldn’t say I like such hacks. As an alternative better way, you can create a simple class that in turn, loads the required autoload.php file and load it with the help of CodeIgniter’s “application/config/autoload.php” file.

The custom class inside ‘application/libraries’ directory:

<?php
/**
 * Description of MY_Composer
 *
 * @author Rana
 */
class MY_Composer
{
    function __construct()
    {
        include("./vendor/autoload.php");
    }
}
Code language: PHP (php)

Now simply add this class in the auto-load array as the very first elements:

$autoload['libraries'] = array('MY_Composer','database','session');
Code language: PHP (php)

And here we are done as well. Great!

Final Words:

If you are already in touch with official codeigniter site news, you might be aware that, codeigniter’s updates/releases are very slow, and there is the possibility of a death of it as well( though I appreciate the development of codeigniter community, which is still active, but no stable release yet). In between, PHP is already updating with many features of modern web application development.

So, to get a taste of the modern era of PHP development, such a hack like this could be very much helpful to developers who are working/maintaining CodeIgniter applications developed years earlier(Moreover, Codeigniter can still be considered as a least learning curve framework also). Happy coding 🙂