Over a million developers have joined DZone.

Using Composer in an Existing Project

DZone's Guide to

Using Composer in an Existing Project

· Web Dev Zone
Free Resource

Learn how to build modern digital experience apps with Crafter CMS. Download this eBook now. Brought to you in partnership with Crafter Software

I've got an application (OK, scratty PHP script) that glues together some API things and shows them onto a dashboard for me. Recently, I updated it to use Guzzle as the consuming client, since Twitter now needs me to authenticate (I wrote about that if you're interested), and I used Composer to bring the new library in. It was very simple, so I thought I'd share it since it's quite a minimal example, and those are my favorite kind.

Getting Started with Composer

First of all, you'll need to either install composer, or at least get the .phar -- these examples use the composer.phar file from under the "Manual Download" section.

Composer comes with instructions, for a list of command types:

php composer.phar list

Once you've got Composer ready to go, we can move on and configure it.

State Your Dependencies

All you need to do to use Composer is to create its configuration file and then tell it to do its magic. :) All I want here is the Guzzle library, so my config file is rather simple:

    "require": {
        "guzzle/guzzle": "3.7"

Get the Libraries

From this point, Composer can do the rest by itself. It will fetch all the libraries you set in the config file, but will also get any dependencies of those libraries. To ask it to do this, just type:

php composer.phar install

This will download all the libraries you need and place them in a vendor directory. In the case of Guzzle, it depends on other libraries (from the Symfony project), so my vendor directory now contains:

├── autoload.php
├── composer
├── guzzle
└── symfony

And there you have it: all the libraries you need are in place.

Tell Your Application About Its Dependencies

One more step: just add the following line into your application to make those new libraries available to it.

require 'vendor/autoload.php';

There you go. :) Enjoy using Composer even in existing/legacy applications, projects that aren't built in "the one true way" or really anywhere else you don't want to have to include libraries in your repositories.

Oh, and one more tip if you're just getting started: Add the vendor folder to your source control "ignore" file.

Further Reading

Nice post from Cal about including non-composer libs in your autoloader: http://blog.calevans.com/2013/07/21/using-3rd-party-libraries-in-composer-projects/

Composer documentation: http:// http://getcomposer.org/doc/

Crafter is a modern CMS platform for building modern websites and content-rich digital experiences. Download this eBook now. Brought to you in partnership with Crafter Software.


Published at DZone with permission of Lorna Mitchell, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}