Dependency Management: Composer

[igorw]

I'm happy announce that we are now using composer to manage the development dependencies of phpBB.

What's composer?

Composer is a dependency manager for PHP. It allows PHP projects to depend on other PHP projects, such as libraries. Composer manages and installs these dependencies.

What are phpBB's dependencies?

Composer was added as part of the EventDispatcher pull request (aka "Hooks System"). We are using the Symfony2 event dispatcher in phpBB now, and you should install it through composer. Right now that is the only dependency, but if we add any other ones, they will also use composer.

What does this mean for me?

This is only significant for people working on the phpBB core. They will need to run the composer install command to get the dependencies. We have added instructions for that to the README:

To be able to run an installation from the repo (and not from a pre-built package) you need to run the following commands to install phpBB's dependencies.

Code: Select all

cd phpBB
php ../composer.phar install

[Michaelo]

As no default composer.json exists I built using...

Code: Select all

php composer.phra init

Added: symfony/event-dispatcher": "2.0.* as I don't see any reference to required dependencies...
I'm not even sure if this is required in order to install and test, don't remember it being required previously...
Then...

Code: Select all

php composer.phra install

[bantu]

As no default composer.json exists [...]

It's right there.

Code: Select all

afischer@leonard:/var/www/projects/phpbb3/phpBB $ cat composer.json 
{
    "require": {
        "symfony/event-dispatcher": "2.0.*"
    }
}

[Michaelo]

Somehow I managed to loose it but of course I see it now... apologies...
Not a wasted exercise, at least I know how to create it now...

[-=ET=-]

To be able to run an installation from the repo (and not from a pre-built package) you need to run the following commands to install phpBB's dependencies.

Code: Select all

cd phpBB
curl -s http://getcomposer.org/installer | php
php composer.phar install

Where do we need to run this?
Thanks!

[imkingdavid]

To be able to run an installation from the repo (and not from a pre-built package) you need to run the following commands to install phpBB's dependencies.

Code: Select all

cd phpBB
curl -s http://getcomposer.org/installer | php
php composer.phar install

Where do we need to run this?
Thanks!

Depending on your OS, open cmd.exe or terminal or whatever console you use and copy/paste the commands in one by one. The first line is just to navigate to the phpBB directory within the phpbb3 repository. If you start console outside of the repository, you will need to provide a full path from your current location; the above code simply assumes you start console on the repository. You will need to have PHP properly set up on the PATH or else put the full path to it in place of "php".

[-=ET=-]

Depending on your OS

XP

open cmd.exe

Yup

The first line is just to navigate to the phpBB directory within the phpbb3 repository. If you start console outside of the repository, you will need to provide a full path from your current location; the above code simply assumes you start console on the repository. You will need to have PHP properly set up on the PATH or else put the full path to it in place of "php".

Easy

I've added the php path to XP and went to the phpBB 3.1 dir.
But "curl -s http://getcomposer.org/installer | php" ends up with an error saying "curl" is an unknown command

[Vinny]

I've added the php path to XP and went to the phpBB 3.1 dir.
But "curl -s http://getcomposer.org/installer | php" ends up with an error saying "curl" is an unknown command

Try this.

[-=ET=-]

Try this.

Thanks! It works

[brandsrus]

It is too difficult to install it in with Xampp on the Windows machine.

My directory is located on L:\xampp\htdocs\phpBB3.1 and with commandline in Windows is not possible to install symphony.

I don't understand how it works, so I can't test the new development version local.