From 62bdaaf4087cdb2cac3292131438cb80edd79db2 Mon Sep 17 00:00:00 2001 From: Benjamin Eberlei Date: Sun, 19 Feb 2012 12:31:58 +0100 Subject: [PATCH] Add docs --- doc/create-projects.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 doc/create-projects.md diff --git a/doc/create-projects.md b/doc/create-projects.md new file mode 100644 index 000000000..4a373dbac --- /dev/null +++ b/doc/create-projects.md @@ -0,0 +1,16 @@ +# Create Projects + +You can use Composer to create new projects from existing packages. There are several applications for this: + +1. You can deploy application packages. +2. You can check out any package and start developing on patches for example. +3. Projects with multiple developers can use this feature to bootstrap the initial application for development. + +To create a new project using composer you can use the "install-project", pass it a package name + version and a directory to create the project in. The directory is not allowed to exist, it will be created during installation. + + php composer.phar install-project doctrine/orm 2.2.0 /path/to/new-project + +By default the command checks for the packages on packagist.org. To change this behavior you can use the --repository-url parameter and either point it to an HTTP url for your own packagist repository or to a packages.json file. + +If you want to get a development version of the code directly checked out from version control you have to add the --prefer-source parameter. +