From 2c34b32cbb23e9860905519f3d1d3e589a9d1a75 Mon Sep 17 00:00:00 2001 From: EDVStuttgart <107702691+EDVStuttgart@users.noreply.github.com> Date: Fri, 20 Dec 2024 01:49:27 +0100 Subject: [PATCH 1/2] Update guide_shopware-6.rst Adapted to the official installation scrypt and Uberspace 7 --- source/guide_shopware-6.rst | 136 ++++++++++++++++++++++++------------ 1 file changed, 90 insertions(+), 46 deletions(-) diff --git a/source/guide_shopware-6.rst b/source/guide_shopware-6.rst index 05dd45113..598f90861 100644 --- a/source/guide_shopware-6.rst +++ b/source/guide_shopware-6.rst @@ -1,6 +1,7 @@ .. highlight:: console -.. author:: Yannick Ihmels +.. author:: Dominik Kustermann + Translated with ChatGPT .. tag:: lang-php .. tag:: web @@ -18,7 +19,7 @@ Shopware 6 .. tag_list:: -Shopware_ is a open source e-commerce software powered by Symfony_ and Vue.js_. The community +Shopware_ is an open-source e-commerce software powered by Symfony_ and Vue.js_. The community edition is distributed under the MIT license. It's the successor of Shopware 5. ---- @@ -49,80 +50,123 @@ We're using PHP in the stable version 8.1: .. include:: includes/my-print-defaults.rst -Your shop URL needs to be setup: +Your shop URL needs to be set up: .. include:: includes/web-domain-list.rst +Configuration +============= + +To configure PHP according to the `Shopware system requirements`_, go to +``$HOME/etc/php.d/``, create ``shopware.ini`` and add the following lines: + +:: + + memory_limit = 512M + apc.enable_cli = 1 + opcache.memory_consumption = 256 + +After setting these PHP parameters, restart PHP to activate the changes + +.. code-block:: console + + [isabell@stardust ~]$ uberspace tools restart php + Your PHP configuration has been loaded. + [isabell@stardust ~]$ + Installation ============ -Download --------- +Setup the Environment +---------------------- -Check the `Shopware website`_ for the latest release and copy the URL to the ZIP file. Replace the -URL with the one you just copied. +Switch to your user directory and create a folder for Shopware: .. code-block:: console - :emphasize-lines: 2 [isabell@stardust ~]$ cd /var/www/virtual/$USER/ - [isabell@stardust isabell]$ curl -o shopware.zip https://releases.shopware.com/sw6/install_v6.4.17.2_4d2c85fb448571fa4f30edce635f33a67dda1d76.zip - [isabell@stardust isabell]$ unzip -d shopware shopware.zip - [isabell@stardust isabell]$ rm shopware.zip - [isabell@stardust isabell]$ + [isabell@stardust $USER]$ mkdir shopware + [isabell@stardust $USER]$ cd shopware + +Download the Installer +---------------------- -Since Shopware uses the sub directory public/ as the :manual:`DocumentRoot `, -you need to remove your DocumentRoot and create a symlink to the shopware/public/ directory: +Download the Shopware installer script: .. code-block:: console + :emphasize-lines: 2 - [isabell@stardust isabell]$ rm -f html/nocontent.html; rmdir html - [isabell@stardust isabell]$ ln -s /var/www/virtual/$USER/shopware/public html - [isabell@stardust isabell]$ + [isabell@stardust shopware]$ wget https://github.com/shopware/web-recovery/releases/latest/download/shopware-installer.phar.php -Setup ------- +Adjust DocumentRoot +------------------- -Point your browser to your domain, e.g. ``https://isabell.uber.space`` and follow the instructions -to set up Shopware. We suggest you use an -:manual_anchor:`additional database `. For example: -isabell_shopware. +Move one level up, remove the default ``html`` symlink, and point it to the Shopware installation: -Configuration -============= +.. code-block:: console -To configure PHP according to the `Shopware system requirements`_, go to -``$HOME/etc/php.d/``, create ``shopware.ini`` and add the following lines: + [isabell@stardust shopware]$ cd .. + [isabell@stardust $USER]$ rm -f html + [isabell@stardust $USER]$ ln -s /var/www/virtual/$USER/shopware html -:: +Complete the Installation +------------------------- - memory_limit = 512M - apc.enable_cli = 1 - opcache.memory_consumption = 256 +Open your browser and navigate to your domain, e.g., ``https://isabell.uber.space``, and follow the installation steps. -.. note:: After setting these PHP parameters, restart PHP to activate the changes +.. warning:: When attempting to install the latest version of Shopware directly, I encountered an issue where Shopware requires MariaDB version 10.11. However, Uberspace currently provides only version 10.6.19 on Uberspace 7. According to Uberspace support, this limitation may be resolved with Uberspace 8. Until then, it is mandatory to install Shopware version 6.6.8, as any newer versions will cause issues. -.. code-block:: console + If errors occur during the process, refer to the :ref:`Troubleshooting ` section below. - [isabell@stardust ~]$ uberspace tools restart php - Your php configuration has been loaded. - [isabell@stardust ~]$ +Post-Installation Configuration +=============================== -Updates -======= +After installation, follow these steps for further configuration: + +1. Perform all available updates via `Shopware > Settings > System > Shopware Updates`. +2. Update the DocumentRoot symlink to the ``public`` directory: + + .. code-block:: console + + [isabell@stardust ~]$ cd /var/www/virtual/$USER/ + [isabell@stardust $USER]$ rm html + [isabell@stardust $USER]$ ln -s /var/www/virtual/$USER/shopware/public html + +3. Adjust the API URL: + + .. code-block:: console + + [isabell@stardust $USER]$ cd /var/www/virtual/$USER/shopware + [isabell@stardust shopware]$ nano .env.local + + Remove the ``/public`` part from ``APP_URL=[...]``. + +4. Upgrade plugins in the Shopware admin. +5. Update the domain under "Sales Channels". -.. note:: Check the update feed_ regularly to stay informed about the newest version. +Domain Adjustment +================= +If switching to a custom domain, repeat the steps above to update the symlink and API URL. + +.. _troubleshooting: + +Troubleshooting +=============== + +If issues occur during installation, delete the Shopware folder and database to start over: + +Follow the steps outlined in the `Download the Installer`_ section to restart the process. + +.. code-block:: console + + [isabell@stardust ~]$ rm -rf /var/www/virtual/$USER/shopware + [isabell@stardust ~]$ mysql -e "DROP DATABASE isabell_shopware" + +---- .. _Shopware: https://www.shopware.com .. _Shopware website: https://www.shopware.com/en/download/ .. _Shopware system requirements: https://docs.shopware.com/en/shopware-6-en/first-steps/system-requirements .. _Symfony: https://symfony.com .. _Vue.js: https://vuejs.org -.. _feed: https://github.com/shopware/platform/releases.atom - ----- - -Tested with Shopware 6.4.17.2, PHP 8.1 and Uberspace 7.13.0 - -.. author_list:: From b2197a563428a0cc66c21e829ab77d1260721515 Mon Sep 17 00:00:00 2001 From: EDVStuttgart <107702691+EDVStuttgart@users.noreply.github.com> Date: Wed, 19 Feb 2025 23:13:15 +0100 Subject: [PATCH 2/2] Update guide_shopware-6.rst --- source/guide_shopware-6.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/source/guide_shopware-6.rst b/source/guide_shopware-6.rst index 598f90861..997803a41 100644 --- a/source/guide_shopware-6.rst +++ b/source/guide_shopware-6.rst @@ -1,7 +1,7 @@ .. highlight:: console +.. author:: Yannick Ihmels .. author:: Dominik Kustermann - Translated with ChatGPT .. tag:: lang-php .. tag:: web @@ -80,7 +80,7 @@ Installation Setup the Environment ---------------------- -Switch to your user directory and create a folder for Shopware: +Switch to your DocumentRoot and create a folder for Shopware: .. code-block:: console @@ -149,6 +149,11 @@ Domain Adjustment If switching to a custom domain, repeat the steps above to update the symlink and API URL. +Versions +================= + +Tested with Shopware 6.6.10.0 (initial installation required: 6.6.8), PHP 8.1, and Uberspace 7.16.5. + .. _troubleshooting: Troubleshooting