DocumentatieCommerceConfiguratiegids

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Voorbeeld met een gedeelde configuratie

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

In dit voorbeeld wordt getoond hoe u de volgende instellingen in uw ontwikkelingssysteem kunt wijzigen, het gedeelde configuratiebestand config.php in uw constructiesysteem kunt bijwerken en dezelfde instellingen in uw productiesysteem kunt implementeren:

  • Tijdzone
  • Gewichtseenheid

Deze montages zijn beschikbaar in Admin in Slaat > Montages > Configuratie > Algemeen > Algemeen.

U kunt de zelfde procedure gebruiken om het even welke niet gevoelige, niet systeem-specifieke montages in de volgende verwijzingen te vormen:

Voordat u begint

Alvorens u begint, de toestemmingen en de eigendom van het opstellingssysteem zoals besproken in ​ Vereisten voor ontwikkeling, bouwt, en productiesystemen ​.

Veronderstellingen

Dit onderwerp verstrekt een voorbeeld om de configuratie van het productiesysteem te wijzigen. U kunt desgewenst verschillende configuratieopties kiezen.

In dit voorbeeld gaan we uit van het volgende:

  • U gebruikt Git-bronbesturingselement
  • Het ontwikkelingssysteem is beschikbaar in een Git-opslagplaats op afstand met de naam mconfig
  • Uw Git-werkvertakking krijgt de naam m2.2_deploy

Stap 1: Plaats de configuratie in het ontwikkelingssysteem

U kunt als volgt de tijdzone- en gewichtseenheden in uw ontwikkelingssysteem instellen:

  1. Meld u aan bij de beheerder.

  2. Klik Slaat op > Montages > Configuratie > Algemeen > Algemeen.

  3. In de juiste ruit, breid Opties van de Landinstelling uit.

    In de volgende afbeelding ziet u een voorbeeld.

    plaats scèneopties in het ontwikkelingssysteem

  4. Van de lijst van de Tijdzone, klik GMT+00 :00 (UTC).

  5. Ontruim het checkbox van de systeemwaarde van het Gebruik naast het 3} gebied van de Eenheid van de Gewicht.

  6. Van de lijst van de Eenheid van 0} Gewicht, klik kgs .

  7. Klik sparen Config.

  8. Maak de cache leeg als daarom wordt gevraagd.

Stap 2: Werk de gedeelde configuratie bij

Genereer het gedeelde configuratiedossier, app/etc/config.php, in uw ontwikkelingssysteem en breng het over gebruikend broncontrole aan uw bouwstijlsysteem zoals die in deze sectie wordt besproken.

om de configuratie bij te werken:

  1. Meld u aan bij uw ontwikkelsysteem als of schakel over naar de eigenaar van het bestandssysteem.

  2. Verandering in de toepassingswortel en stel het dumpbevel in werking.

    code language-bash 
    cd <Magento root dir>
php bin/magento app:config:dump

    Als Commerce bijvoorbeeld is geïnstalleerd in /var/www/html/magento2 , voert u het volgende in:

    code language-bash 
    cd /var/www/html/magento2
php bin/magento app:config:dump

  3. Controleer of app/etc/config.php is bijgewerkt.

    code language-bash 
    git status

    Monsterrespons:

    code language-none 
    On branch m2.2_deploy
Changed but not updated:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
       modified:   app/etc/config.php
    note warning
    WARNING
    Verzend __ geen veranderingen in generated, pub/media, of pub/static folders aan broncontrole. U genereert deze bestanden op uw buildsysteem. Het ontwikkelingssysteem heeft waarschijnlijk code, thema's, enzovoort, die niet klaar zijn voor gebruik op het productiesysteem.

  4. Controleer uw wijzigingen in app/etc/config.php alleen om broncontrole te verkrijgen.

    code language-bash 
    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy

Stap 3: Werk uw bouwstijlsysteem bij en produceer dossiers

Nu u uw veranderingen in de gedeelde configuratie aan broncontrole hebt geëngageerd, kunt u die veranderingen in uw bouwstijlsysteem trekken, code compileren, en statische dossiers produceren. De laatste stap is om die veranderingen in uw productiesysteem te trekken. Dientengevolge, zal de configuratie van uw productiesysteem uw ontwikkelingssysteem aanpassen.

om het bouwstijlsysteem bij te werken:

  1. Meld u aan bij het constructiesysteem als de eigenaar van het bestandssysteem.

  2. Wijzig de hoofdmap van de toepassing.

    code language-bash 
    cd <Magento root dir>

  3. Trek de wijzigingen in app/etc/config.php van het bronbesturingselement.

    code language-bash 
    git pull mconfig m2.2_deploy

  4. Compileer code.

    code language-bash 
    bin/magento setup:di:compile

  5. Nadat de code is gecompileerd, produceer statische meningsdossiers.

    code language-bash 
    bin/magento setup:static-content:deploy -f

  6. Controleer de veranderingen in broncontrole.

    code language-bash 
    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy

Stap 4: Productiesysteem bijwerken

De laatste stap in het proces is uw productiesysteem van broncontrole bij te werken. Dit trekt alle veranderingen aan u op uw ontwikkeling en bouwsystemen aanbracht, wat uw productiesysteem volledig bijgewerkt betekent.

om het productiesysteem bij te werken:

  1. Meld u als eigenaar van het bestandssysteem aan bij het productiesysteem.

  2. Schakel over naar de hoofdmap van de toepassing en schakel de onderhoudsmodus in.

    code language-bash 
    cd <Magento root dir>
    code language-bash 
    bin/magento maintenance:enable

    Zie magento maintenance:enable voor extra opties, zoals de mogelijkheid om een IP-adreslijst in te stellen.

  3. Stop alle actieve workers in de wachtrij door cron_run als volgt in te stellen op false in app/etc/env.php :

    code language-php?start_inline=1 
    'cron_consumers_runner' => [
        'cron_run' => false
    ]

  4. Werk de configuratie bij.

    code language-bash 
    bin/magento app:config:import

  5. Tot slot kill alle actieve consumentenprocessen.

    code language-bash 
    kill <PID>

    Waar PID de proces-id is die moet worden gedood, bijvoorbeeld:

    code language-bash 
    kill 1234

  6. Trek code van broncontrole.

    code language-bash 
    git pull mconfig m2.2_deploy

  7. Werk de configuratie bij.

    code language-bash 
    bin/magento app:config:import

  8. Maak de cache leeg.

    code language-bash 
    bin/magento cache:clean

  9. Eindonderhoudsmodus.

    code language-bash 
    bin/magento maintenance:disable

Wijzigingen in Admin controleren

om deze montages te verifiëren zijn niet editable in Admin:

  1. Meld u aan bij de beheerder.

  2. Klik Slaat op > Montages > Configuratie > Algemeen > Algemeen.

  3. In de juiste ruit, breid Opties van de Landinstelling uit.

    De opties die u zojuist hebt ingesteld, worden als volgt weergegeven:

    de opties van de Configuratie niet editable in Admin

INFO
Als u een instelling wilt wijzigen die is vergrendeld in Beheer, gebruikt u de opdracht magento config:set --lock ​ .
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c