Support and Maintenance FAQ¶
This page contains answers to most common questions and tips around support and maintenance, as well as references to important parts of the documentation and tools useful for developers in their daily work.
What information should I specify when creating a Customer Support ticket?¶
When reporting a problem to Customer Support the most important information is the version of eZ Platform which is used in the project. The best way to specify it is to provide the list of currently installed packages by running:
Besides that, all the configuration from the
app/config directory may be helpful.
You should also list the steps to reproduce the issue, or at least provide a clear description of the circumstances under which the problem occurred.
If you stumble upon a database-related problem, providing corresponding logs is also an important step.
Additionally, mention recent changes, performed migrations or external scripts/code customizations related to the code which generates the problem.
What are the recommended ways to increase my project's performance?¶
The most important clues around increasing overall performance of your eZ Platform-based project can be found in the Performance documentation page.
How can I translate my Back Office?¶
The language of the Back Office is based on the browser language. In order to change it you should install the proper package for your language (see language packages list). Once you have language packages installed, you can switch the language of the Back Office in the User Settings menu.
If you do not have a language defined in the browser, it will be selected based on the
parameters.locale_fallback parameter located in
To read more about language managing in eZ Platform, see the following doc pages:
How can I apply patches to the installation?¶
The easiest way to apply a patch to your project is by using the Unix
Remember to clear the cache afterwards.
As an alternative to manually applying the patch, you can use composer-patches.
You can apply patches received from eZ Support, community or the others by using your
For checking the versions you are on, refer to your
All you need is to specify which package will receive patches and give the path/URL to the actual file.
This should be done inside the
extra section. Packages which should receive patches
will be removed during
composer update or
composer require so they can be re-installed and re-patched.
When updating to the release that already contains specified patches,
Composer will throw an error alongside a message that they cannot be applied and will be skipped
(this is configurable).
They can be manually removed from
How to clear the cache properly?¶
Clearing cache is covered by our documentation, it applies to file and content (HTTP/persistence) cache.
- clearing Symfony cache
- clearing Redis cache
- clearing Memcached cache
- clearing the Symfony cache manually
Clearing cache manually
Manual cache clearing should be executed with caution.
rm -rf var/cache/* wipes all the files and unlike
cache:clear doesn't warm up the cache.
It results in a significant performance drop on first request, so it shouldn't be called on a production environment.
Besides, it could lead to issues with file ownership after running
cache:clear as a root.
Where should I place my configuration files?¶
In order to avoid merge conflicts on important configuration settings during upgrades, moving as much as possible of your configuration to your own files can be a good idea.
All project-specific parameters should be kept in separate files.
For example, configuration for Page Blocks could be placed in
You can also place it in
config/landing_page_blocks.yaml, which should be imported in
1 2 3 4
How can I implement authentication in an eZ Platform-based project?¶
The best approach is to use Symfony authentication. Check development security page for more detailed instructions.