The 16.02 (v1.2.0) release of eZ Platform is available as of March 3rd, and includes all features and improvements of 15.12.1 from February 5th.
For the release notes of the corresponding eZ Studio release, see eZ Studio 16.02 Release notes
This release contains migrations tools for migrating XmlText to RichText, this is explained in the new 5.4.x/2014.11 upgrade documentation page.
eZ Platform now also comes in a new demo version that better showcases eZ Platform in use with a provided web site and corresponding content:
As of 16.02, eZ Platform now supports being tested using the built in PHP internal server as exposed by Symfony's
Assuming you have composer installed globally, and your MySQL/MariaDB server already setup with a database, you can get eZ Platform demo up and running with just the following commands:
composer create-project --no-dev --keep-vcs ezsystems/ezplatform-demo cd ezplatform-demo php app/console ezplatform:install --env=prod demo php app/console assetic:dump --env=prod web php app/console server:run --env=prod
Note : the
--keep-vcs option allows you to get the git history.
ez_fieldTwig function to get full translated field, and not just value like existing
ez_field_valuedoes contributed by @rihards
..and many other great improvements and fixes to this release that you can see in JIRA:
For known issues head over to our known enablement issues page that covers eZ Platform and eZ Studio.
However here are two issues that were uncovered very late in the release process since they were hidden by other bugs that we would like to make you especially aware of:
Both are currently being worked on and will be fixed in patch version in the next couple of weeks.
Be aware that for Editors to be able to successfully edit content, including content with author fields filled with other users, you'll at the moment need to configure Editor Group via Roles to have access to read user content items using a policy like
This implies they have full read access to other users data, so assign this with caution. We will improve this in an upcoming release, see for further info.
If you are testing a release candidate, replace the tag
This section reflects a proposed git based workflow for handling upgrades, feedback on how this works in practice and input on how to further improve/simplify it is welcome.
Existing 15.12.1 (1.1.0) projects can also easily be updated using Composer. From the project's root, create a new branch from the project's master, or from the branch you're upgrading on:
git checkout -b upgrade-1.2.0
If it's not there, add ezsystems/ezplatform as an upstream remote:
git remote add ezplatform http://github.com/ezsystems/ezplatform.git
Then pull the tag into your branch:
git pull ezplatform v1.2.0
You will get conflicts, and it is perfectly normal. The most common ones will be on
The latter can be ignored, as it will be regenerated when we execute composer update later. The easiest is to checkout the version from the tag, and add it to the changes:
If you get a lot of conflicts (on the
git checkout --theirs composer.lock && git add composer.lock
You may also run
git remove composer.lock if you do not keep a copy of it in the branch.
composer.json need to be fixed manually. If you're not familiar with the diff output, you may checkout the tag's version, and inspect the changes. It should be readable for most:
git checkout --theirs composer.json && git diff composer.json
You should see what was changed, as compared to your own version, in the diff output. The ezplatform update changes the requirements for all of the
ezsystems/ packages. Those changes should be left untouched. All of the other changes will be removals of what you added for your own project. Use
git checkout -p to selectively cancel those changes:
git checkout -p composer.json
no (do not discard) to the requirement changes of
ezsystems dependencies. Answer
yes (discard) to removals of your changes.
Once you are done, inspect the file, either using an editor or by running
git diff composer.json. You may also test the file's sanity with
composer validate, and test the dependencies by running
composer update --dry-run. (will output what it would do to dependencies, without applying the changes.
Once finished, run
git add composer.json.
Depending on the local changes you have done, you may get other conflicts: configuration files, kernel...
There shouldn't be many, and you should be able to figure out which value is the right one for all of them:
git add conflicting-fileto add the changes
At this point, you should have a composer.json file with the correct requirements. Run
composer update to update the dependencies.
composer update --with-dependencies ezsystems/ezpublish-kernel ezsystems/platform-ui-bundle ezsystems/behatbundle
In order to restrict the possibility of unforeseen updates of 3rd party packages, we recommend by default that
Because from this release onwards eZ Platform is compatible only with PHP 5.5 and higher, the update command above will fail if you use an older PHP version. Please update PHP to proceed.
The 16.02 release requires an update to the database. Import
vendor/ezsystems/ezpublish-kernel/data/update/mysql/dbupdate-6.1.0-to-6.2.0.sql into your database:
mysql -u<username> -p<password> <database_name> < vendor/ezsystems/ezpublish-kernel/data/update/mysql/dbupdate-6.1.0-to-6.2.0.sql
The web assets must be dumped again for the prod environment:
php app/console assetic:dump --env=prod web
Once all the conflicts have been resolved, and
composer.lock updated, the merge can be committed. Note that you may or may not keep
composer.lock, depending on your version management workflow. If you do not wish to keep it, run
git reset HEAD <file> to remove it from the changes. Run
git commit, and adapt the message if necessary. You can now test the project, run integration tests... once the upgrade has been approved, go back to
master, and merge the
git checkout master git merge upgrade-1.2.0
You should now have a new route in