Troubleshooting

I am asked for a github token

By default github has API access limits set for anonymous access. In order to overcome these limits one has to create a github token, which could be done as described in: https://help.github.com/articles/creating-an-access-token-for-command-line-use/

I get a Composer\Downloader\TransportException

During the installation of OXID eShop Professional or Enterprise Edition you get the following error:

[Composer\Downloader\TransportException]
Invalid credentials for 'https://enterprise-edition.packages.oxid-esales.com/packages.json', aborting.

You may have stored some outdated or wrong credentials. Please review <your home directory>/.composer/auth.json and delete the section, which begins with “professional-edition.packages.oxid-esales.com” resp. “enterprise-edition.packages.oxid-esales.com”

I am asked “Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]”

In general you can say “Yes”. It is not normally important to keep VCS history locally. You can always look it up on github.

There was an error during the execution of the unified namespace generator

If the generation of the unified namespace classes fails, OXID eShop will not run properly. In this case you should look here for possible fixes.

PHP8 requests result in empty index.php sent to user

If Apache incorrectly responds to certain requests with

- Content-Length = 0
- HTTP response status code = "200 OK"

but works normally for other pages - please make sure the following does not apply to your setup:

  • Apache2
  • mod_proxy_fcgi
  • PHP8
  • PHP-FPM

Otherwise you may try to resolve the issue by letting PHP-FPM manage PHP error logs instead of sending them to Apache. e.g. by setting:

/usr/local/etc/php-fpm.d/www.conf

php_admin_value[error_log] = /var/log/fpm-php.www.log
php_admin_flag[log_errors] = on