Bekannte Fehler

Manchmal kommt es vor das QUIQQER Fehler besitzt, die bei einem Update auftauchen. Es lässt sich leider nicht immer umsetzen das QUIQQER automatisiert gewisse Fehler ausmerzt. Daher findest du hier eine Liste von Vorgehensweise für bekannte Fehler.

Umstellung von PHP 7 auf PHP 8

Bevor du auf PHP 8 umsteigst, solltest du ein Backup machen.
Bevor du das Update ausführst, musst du in den QUIQQER Einstellungen CLI PHP Command auf PHP 8 umstellen
Das Update solltest du über die CLI ausführen
Wenn du über die ./console gehst, musst du das Update zweimal ausführen, da erster der interne Composer aktualisiert werden muss.
- Alternativ kannst du auch über var/composer/composer.phar ausführen
- Bedenke, composer.phar muss in Version 2 und höher sein var/composer/composer.phar --version
  - Ist composer.phar nicht in Version 2, lade dir bitte die aktuelle composer Version herr unter https://getcomposer.org/download/ (self-update funktioniert nur bedingt, wenn du von composer 1 auf 2 aktualisierst)

Missing quiqqer-asset/ no matching package found

Wenn dein System etwas älter ist und bei deinem Update nun quiqqer-asset Pakete nicht gefunden werden, liegt das höchstwahrscheinlich daran, das dir der neue QUIQQER Asset Server fehlt.

Hierzu füge einfach https://assets.quiqqer.com/ als Composer Server hinzu un führe dein Update danach wie gewohnt aus. Dies kannst du direkt in der etc/source.list.ini.php machen oder in der Serververwaltung von QUIQQER.

Content-Type header missing for WebP images

WebP images served from Apache (and maybe NGINX) on Ubuntu may not have the Content-Type header set.

This is not a QUIQQER issue but a "problem" of the webserver and/or Ubuntu as it does not know the MIME-type for WebP files. Therefore, this information has to be added. This can be done in one of the following ways:

System wide

To add the MIME-type for the entire server/machine the /etc/mime.type file has to be extended. Add the following to the file:

image/webp webp

After that reload your webserver configuration (e.g. sudo service apache2 reload).

If you do not have access to that file and/or the webserver, you can use the method below.

QUIQQER system only (Apache)

To just fix the issue on your QUIQQER system or if you do not have system-wide permissions (e.g. shared hosting) you can add the missing header in the following way (requires Apache mime module):

Create the file etc/htaccess.custom.php (in your QUIQQER folder) if it does not exist yet and add the following lines:

#<?php exit; ?>
# custom htaccess

Add the following lines to the etc/htaccess.custom.php file (in your QUIQQER folder):

# Add mimetype for WebP images
<IfModule mime_module>
    AddType image/webp .webp
</IfModule>

Re-generate the .htaccess file:

./console htaccess

More information about the custom htaccess system can be found on the htaccess wiki page.

known_errors