Shopware 5 installation steps

Content

This document contains shopware 5 preparation and plugin installation steps:

Dockerized
Manual installation

Dockerized

Content

Docker container start

Docker container start

Run in bash
```
docker-compose up
```

INFO In case of manual access will be needed to MySQL or SSH/SFTP in docker-compose.yml expose their ports

ports:
	MYSQL_PORT:3306
	SSH_PORT:22

Shopware admin credentials

Login: demo
Password: demo

MySQL credentials

User: shopware
Password: shopware
Port: 3306

SSH/SFTP credentials

User: dockware
Password: dockware
Port: 22

Manual Installation

Content:

Mysql installation
PHP installation
Nginx installation
Mysql, PHP, Nginx Configuration
Shopware5 installation
Plugin installation
Plugin configuration

Mysql Installation

Mac mysql installation

Install Mysql via brew
```
brew install mysql
```
To start mysql server in Daemon mode
```
brew services start mysql
```
- To stop server from Daemon mode
```
brew services stop mysql
```
To add root password
```
mysql_secure_installation
```
Go by steps, add root password, you can keep anonymous users for later testing purposes
Free mode start/stop (Life cycle until reboot)
```
mysql.server start
mysql.server stop
```

PHP installation

Mac PHP installation

Install Mysql via brew
```
brew install php
```
To start php-fpm in Daemon mode
```
brew services start php
```
- To stop nginx from Daemon mode
```
brew services stop php
```

Nginx installation

Mac Nginx installation

Install Mysql via brew
```
brew install nginx
```
To start nginx in Daemon mode
```
brew services start nginx
```
- To stop nginx from Daemon mode
```
brew services stop nginx
```

Configuration

Mac configuration

Mysql Login into mysql
```
mysql -u root -p
```
Create database for shopware5
```
CREATE DATABASE shopware5
```
PHP In file /opt/homebrew/etc/php/8.2/php-fpm.d/www.conf (in place of 8.2 put your version) File location may differ depending on your configurations Change
```
user = _www
group = _www
listen = 127.0.0.1:9000
```
to (I will use 82 (version) in port, so will be able to use differenc version without interfering)
```
user = <your_username>
group = staff
listen = 127.0.0.1:9082
```
Restart php-fpm
```
brew services restart php
```

Nginx In file /opt/homebrew/etc/nginx/nginx.conf File location may differ depending on your configurations

Uncomment first line and change to
```
user <your_username> staff;
```

In block server, change this (You can change value of listen to change nginx port)

listen 80;
server_name  localhost;
index index.html;

to

server_name  localhost test.x;
index shopware.php index.html index.htm index.php;

Change location from

location / {
    root   html;
    index  index.html index.htm index.php;
}

to

location / {
    try_files $uri $uri/ /shopware.php$is_args$args;
}

Add php-fpm location below location / block

# Needed for Shopware install / update
location /recovery/install {
    index index.php;
    try_files $uri /recovery/install/index.php$is_args$args;
}

location /recovery/update/ {
    if (!-e $request_filename){
        rewrite . /recovery/update/index.php last;
    }
}

location ~* ^.+\.(?:css|cur|js|jpe?g|gif|ico|png|svg|webp|html|woff|woff2|xml)$ {
    expires 1y;
    add_header Cache-Control "public, must-revalidate, proxy-revalidate";

    access_log off;

    # The directive enables or disables messages in error_log about files not found on disk.
    log_not_found off;

    tcp_nodelay off;

    ## Set the OS file cache.
    open_file_cache max=3000 inactive=120s;
    open_file_cache_valid 45s;
    open_file_cache_min_uses 2;
    open_file_cache_errors off;
}

location ~* ^.+\.svg$ {
    add_header Content-Security-Policy "script-src 'none'";
}

location ~ \.php$ {
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include  fastcgi_params;
    fastcgi_index shopware.php;

    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    #include fastcgi.conf;
    fastcgi_buffers 8 16k;
    fastcgi_buffer_size 32k;
    client_max_body_size 24M;
    client_body_buffer_size 128k;
    fastcgi_pass 127.0.0.1:9082;
    #fastcgi_pass unix:/run/php/php7.2-fpm.sock;
    #http2_push_preload on;
}

Restart nginx
```
brew services restart nginx
```
Test nginx and php run
```
mv /opt/homebrew/var/www/index.html /opt/homebrew/var/www/index.php
```
Change /opt/homebrew/var/www/index.php file content to
```
<?php
phpinfo();
?>
```
Visit nginx localhost it should open php version and info page