Installation Using Composer¶
If you don't have it already, install Composer, the command-line package manager for PHP. You'll have to have a copy of Git installed on your machine. The following command uses PHP to download and run the Composer installer, and should be entered on your terminal and executed by pressing Return or Enter:
php -r "readfile('https://getcomposer.org/installer');" | php
For further information about Composer usage see Using Composer.
eZ Platform Installation¶
The commands below assume you have Composer installed globally, a copy of git on your system, and your MySQL/MariaDB server already set up with a database. Once you've got all the required PHP extensions installed, you can get eZ Platform up and running with the following commands:
composer create-project --no-dev --keep-vcs ezsystems/ezplatform ezplatform cd ezplatform #at the end of the install process, you will be told to perform the following commands: export SYMFONY_ENV="prod" php app/console ezplatform:install clean php app/console assetic:dump
For more information about the availables options with Composer commands, see the Composer documentation.
Installing another distribution¶
eZ Platform exists in several distributions, listed in Installation eZ Platform, some with their own installer as shown in the example below. To install the Enterprise Edition you need an eZ Enterprise subscription and have to set up Composer for that.
eZ Platform Enterprise Edition
composer create-project --no-dev --keep-vcs ezsystems/ezplatform-ee cd ezplatform-ee # Options are listed on php app/console ezplatform:install -h php app/console ezplatform:install studio-clean
Installing another version¶
The instructions above show how to install the latest stable version, however with Composer you can specify the version and stability as well if you want to install something else. Using
composer create-project -h you can see how you can specify another version:
create-project [options] [--] [<package>] [<directory>] [<version>]
<package> Package name to be installed
<directory> Directory where the files should be created
<version> Version, will default to latest
Versions can be expressed in many ways in Composer, but the ones we recommend are:
- Exact git tag:
- Tilde for locking down the minor version:
- Equals: 1.3.*
- Caret for allowing all versions within a major:
- Equals: 1.* <= 1.3.0
What was described above concerns stable releases, however Composer lets you specify stability in many ways, mainly:
- Exact git tag:
- Stability flag on a given version:
- Equals: versions of 1.4.0 in stability order of: beta, rc, stable
- This can also be combined with tilde and caret to match ranges of unstable releases
- Stability flag while omitting version: '
@alphaequals latest available alpha release
composer create-project --no-dev --keep-vcs ezsystems/ezplatform-demo ezplatform @beta cd ezplatform php app/console ezplatform:install demo