Preparing for installation

Some preparations are necessary for the new installation of OXID eShop 7.3.

schritt Installing Composer

To install OXID eShop, install Composer.

For more information about installing Composer, see the “Getting Started” section of the Composer website: getcomposer.org.

schritt Providing shop files

The shop files are provided by Composer. Depending on the shop edition, different commands have to be run in the shell. The shop files are stored in a subdirectory that is specified with your_project_name in the command. This is based on the directory in which the command is run in the shell.

Optional: If you need the development-related files, omit the --no-dev parameter.

Hint

For the installation of the Professional and Enterprise Edition you need additional credentials, which you have received by email at the time of purchase or when they were changed.

Community Edition

composer create-project --no-dev oxid-esales/oxideshop-project your_project_name dev-b-7.3-ce

Professional Edition

composer create-project --no-dev oxid-esales/oxideshop-project your_project_name dev-b-7.3-pe

Enterprise Edition

composer create-project --no-dev oxid-esales/oxideshop-project your_project_name dev-b-7.3-ee

Once Composer has finished, the new directory named with your_project_name will be available. This is the main (root) directory of the project that contains all the files needed to install OXID eShop.

schritt Configuring Apache

The next step is moving the main directory to a directory that the HTTP server can access. The Apache document root directory must point to the /source directory of the main directory.

schritt Customising file and directory permissions

The HTTP server requires read and write access to the following directories and their subdirectories at runtime:

/source/export
/source/log/
/source/out/pictures/
/source/out/media/
/source/tmp/
/var/

The CLI user (Command Line Interface) additionally requires read and write access for the directory /var/.

For the web-based setup, the HTTP server must have write access to the following directory and files:

/source/Setup
/source/config.inc.php
/source/.htaccess

schritt Creating a database

OXID eShop requires a MySQL database to store all products, categories, customer and order data, and other information. Most web hosts offer database access through a special website, such as phpMyAdmin. If you need further assistance, contact your OXID Hosting Partner or Internet Service Provider (ISP).

You have the following options:

  • Recommended: Create a new MySQL database. You can select any name for the database, for example, oxid_eshop.

Make sure to remember the name of the database and the assigned login data for the database (username and password).

You will need this data when running the setup.

  • Alternatively: Create the database during the setup.