Global navigation

   Documentation Center
   eZ Studio & eZ Platform
     User Manual
     Technical Manual
     Glossary
   eZ Publish 4.x / legacy

 
eZ Publish (5.x)

eZ Publish 5.x | For eZ Platform & eZ Studio topics see Technical manual and User manual, for eZ Publish 4.x and Legacy topics see eZ Publish legacy

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: reorder chapters so they follow natural user workflow

...

Keeping your system up-to-date is important, to make sure your it is running optimally and securely. The update mechanism in eZ Publish Platform is using the de facto standard PHP packaging system called Composer. This makes it easy to adapt package installs and updates to your workflow, allowing you to test new/updated packages in a development environment, put the changes in your version control system (git, Subversion, Mercurial, etc.), pull in those changes on a staging environment and, when approved, put it in production.

 

Table of Contents

Installing Composer

This step is only needed once per machine (per project by default, but installing globally on the machine is also possible. For alternatives see: https://getcomposer.org/download/).
Composer is a command line tool, so the main way to install it is via command-line, example:

Code Block
languagebash
titlecomposer download in current folder:
php -r "readfile('https://getcomposer.org/installer');" | php

Prerequisite to using composer

...

as Password: the token password you retrieved in step 3. 

Optional: Save authentication

...

information in auth.json to avoid repeatedly typing it

To avoid having to always fill your credentials, add an auth.json file at your project root, next composer.json, or in your COMPOSER_HOME directory for machine-wide use. The file looks like the following:

Code Block
languagejs
titleauth.json
{
    "config": {
        "basic-auth": {
            "updates.ez.no": {
                "username": "<installation-key>",
                "password": "<password><token password>"
            }
        }
    }
}

The fine print: bundled with eZ Publish Platform is a Composer extension which makes it possible to store authentication information in that file.

Installing Composer

This step is only needed once per machine (per project by default, but installing globally on the machine is also possible. For alternatives see: https://getcomposer.org/download/).
Composer is a command line tool, so the main way to install it is via command-line, example:

Code Block
languagebash
titlecomposer download in current folder:
php -r "readfile('https://getcomposer.org/installer');" | php

Using composer

# Running composer update and version changes

...