DocumentatieCommerceConfiguratiegids

Configuratiewaarden instellen

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar
WARNING
Alle bevelen van het Magento CLI moeten door de eigenaar van het dossiersysteemworden in werking gesteld.

Dit onderwerp bespreekt geavanceerde configuratiebevelen die u kunt gebruiken aan:

  • Een configuratieoptie instellen via de opdrachtregel
  • Optioneel elke configuratieoptie vergrendelen zodat de waarde ervan niet kan worden gewijzigd in de beheerfunctie
  • Een configuratieoptie wijzigen die is vergrendeld in Beheer

Met deze opdrachten kunt u de Commerce-configuratie handmatig instellen of scripts gebruiken. U plaatst configuratieopties gebruikend de weg van de a configuratie, die a / - afgebakend koord is dat uniek die configuratieoptie identificeert. U kunt configuratiepaden vinden in de volgende verwijzingen:

U kunt waarden instellen op de volgende tijdstippen:

  • Voordat u Commerce installeert, kunt u configuratiewaarden alleen voor het standaardbereik instellen, omdat dit het enige geldige bereik is.

  • Nadat u Commerce hebt geïnstalleerd, kunt u configuratiewaarden instellen voor elke website of elk weergavebereik van de winkel.

Gebruik de volgende opdrachten:

  • bin/magento config:set stelt elke niet-vertrouwelijke configuratiewaarde in volgens het configuratiepad
  • bin/magento config:sensitive:set stelt elke gevoelige configuratiewaarde in volgens het configuratiepad
  • bin/magento config:show geeft opgeslagen configuratiewaarden weer; waarden van gecodeerde instellingen worden weergegeven als sterretjes

Vereisten

Om een configuratiewaarde te plaatsen, moet u minstens één van het volgende weten:

  • Het configuratiepad

  • Om een configuratiewaarde voor een bepaald werkingsgebied te plaatsen, moet u de werkingsgebiedcode kennen.

    Om een configuratiewaarde voor het standaardwerkingsgebied te plaatsen, te hoeven u om het even wat niet te doen.

Het configuratiepad zoeken

Zie de volgende verwijzingen:

De bereikcode zoeken

U kunt de bereikcode vinden in de Commerce-database of in Commerce Admin.

om de werkingsgebiedcode in Admin te vinden:

  1. Meld u aan bij de beheerder als een gebruiker die websites kan bekijken en weergaven kan opslaan.

  2. Klik op Stores > Instellingen > All Stores .

  3. Klik in het rechterdeelvenster op de naam van de website- of opslagweergave om de bijbehorende code weer te geven.

    In de volgende afbeelding ziet u een voorbeeldcode voor de website.

    krijg een website of opslag meningscode van Admin

  4. Ga met Vastgestelde waardenverder.

om de werkingsgebiedcode in het gegevensbestand te vinden:

Toepassingscodes voor websites en winkelweergaven worden opgeslagen in de Commerce-database in respectievelijk de tabellen store_website en store .

  1. Maak verbinding met de Commerce-database.

    code language-bash 
    mysql -u <Commerce database username> -p

  2. Voer de volgende opdrachten in:

    code language-shell 
    use <Commerce database name>;
    code language-shell 
    SELECT * FROM store;
    code language-shell 
    SELECT * FROM store_website;

    Hieronder volgt een voorbeeldresultaat:

    code language-none 
    [mysql]> SELECT * FROM store_website;
+------------+-------+--------------+------------+------------------+------------+
| website_id | code  | name         | sort_order | default_group_id | is_default |
+------------+-------+--------------+------------+------------------+------------+
|          0 | admin | Admin        |          0 |                0 |          0 |
|          1 | base  | Main Website |          0 |                1 |          1 |
|          2 | test1 | Test Website |          0 |                3 |          0 |
+------------+-------+--------------+------------+------------------+------------+

    Gebruik de waarde in de kolom code .

  3. Ga verder met de volgende sectie.

Waarden instellen

om systeem-specifieke configuratiewaarden te plaatsen:

bin/magento config:set [--scope="..."] [--scope-code="..."] [-le | --lock-env] [-lc | --lock-config] path value

om gevoelige configuratiewaarden te plaatsen:

bin/magento config:sensitive:set [--scope="..."] [--scope-code="..."] path value

In de volgende tabel worden de opdrachtparameters set beschreven:

Parameter
Beschrijving
--scope
Het bereik van de configuratie. De mogelijke waarden zijn default , website of store . De standaardwaarde is default .
--scope-code
De bereikcode van de configuratie (code van de website of van de opslagmening)
-e or --lock-env
Hiermee vergrendelt u de waarde zodat deze niet kan worden bewerkt in de beheerfunctie of wijzigt u een instelling die al is vergrendeld in de beheerfunctie. De opdracht schrijft de waarde naar het <Commerce base dir>/app/etc/env.php -bestand.
-c or --lock-config
Hiermee vergrendelt u de waarde zodat deze niet kan worden bewerkt in de beheerfunctie of wijzigt u een instelling die al is vergrendeld in de beheerfunctie. De opdracht schrijft de waarde naar het <Commerce base dir>/app/etc/config.php -bestand. De optie --lock-config overschrijft --lock-env als u beide opties opgeeft.
path
Vereiste. Het configuratiepad
value
Vereiste. De waarde van de configuratie
INFO
Vanaf Commerce 2.2.4 vervangen de opties --lock-env en --lock-config de optie --lock .
Als u --lock-env of --lock-config optie gebruikt om een waarde te plaatsen of te veranderen, moet u het bin/magento app:config:import bevelgebruiken om het plaatsen in te voeren alvorens u tot Admin of opslag toegang hebt.

Als u een onjuist configuratiepad invoert, retourneert deze opdracht een fout

The "wrong/config/path" does not exist

Zie een van de volgende secties voor meer informatie:

Configuratiewaarden instellen die kunnen worden bewerkt in de beheerder

Gebruik bin/magento config:set zonder --lock-env of --lock-config om de waarde aan het gegevensbestand te schrijven. Waarden die u op deze manier instelt, kunt u bewerken in de beheerfunctie.

Hier volgen enkele voorbeelden voor het instellen van de basis-URL van de winkel:

Stel de basis-URL in voor het standaardbereik:

bin/magento config:set web/unsecure/base_url http://example.com/

Stel de basis-URL voor de base -website in:

bin/magento config:set --scope=websites --scope-code=base web/unsecure/base_url http://example2.com/

Stel de basis-URL in voor de opslagweergave van test :

bin/magento config:set --scope=stores --scope-code=test web/unsecure/base_url http://example3.com/

Configuratiewaarden instellen die niet kunnen worden bewerkt in de beheerder

Als u de optie --lock-env als volgt gebruikt, slaat de opdracht de configuratiewaarde op in <Commerce base dir>/app/etc/env.php en schakelt het veld voor het bewerken van deze waarde in de beheerfunctie uit.

bin/magento config:set --lock-env --scope=stores --scope-code=default web/unsecure/base_url http://example3.com

Met de optie --lock-env kunt u configuratiewaarden instellen als Commerce niet is geïnstalleerd. U kunt echter alleen waarden instellen voor het standaardbereik.

INFO
Het bestand env.php is systeemspecifiek. Breng het niet over naar een ander systeem. U kunt het gebruiken om configuratiewaarden van het gegevensbestand te beschrijven. Bijvoorbeeld, kunt u een gegevensbestandstortplaats van een ander systeem nemen en base_url en andere waarden beschrijven zodat moet u niet het gegevensbestand wijzigen.

Als u de optie --lock-config als volgt gebruikt, wordt de configuratiewaarde opgeslagen in <Commerce base dir>/app/etc/config.php . Het veld voor het bewerken van deze waarde in Admin is uitgeschakeld.

bin/magento config:set --lock-config --scope=stores --scope-code=default web/url/use_store 1

Met --lock-config kunt u configuratiewaarden instellen als Commerce niet is geïnstalleerd. U kunt echter alleen waarden instellen voor het standaardbereik.

INFO
U kunt config.php naar een ander systeem overbrengen om daar dezelfde configuratiewaarden te gebruiken. Als u bijvoorbeeld een testsysteem hebt en dezelfde methode gebruikt config.php , hoeft u niet opnieuw dezelfde configuratiewaarden in te stellen.

De waarde van configuratie-instellingen weergeven

Opdrachtopties:

bin/magento config:show [--scope[="..."]] [--scope-code[="..."]] path

waar

  • --scope is het bereik van de configuratie (standaard, website, winkel). De standaardwaarde is default
  • --scope-code is de bereikcode van de configuratie (code van de website of van de opslagmening)
  • path is de configuratiepad in formaat first_part/second_part/third_part/etc (vereist)
INFO
Het bin/magento config:show bevel toont de waarden van om het even welke gecodeerde waardenals reeks asterisken: **​**​**.

Voorbeelden

om alle bewaarde configuraties te tonen:

bin/magento config:show

Resultaat

web/unsecure/base_url - http://example.com/
general/region/display_all - 1
general/region/state_required - AT,BR,CA,CH,EE,ES,FI,LT,LV,RO,US
catalog/category/root_id - 2
analytics/subscription/enabled - 1

om alle opgeslagen configuraties voor de base website te tonen:

bin/magento config:show --scope=websites --scope-code=base

Resultaat

web/unsecure/base_url - http://example-for-website.com/
general/region/state_required - AT,BR,CA

om basis URL voor het standaardwerkingsgebied te tonen:

bin/magento config:show web/unsecure/base_url

Resultaat

web/unsecure/base_url - http://example.com/

om basis URL voor de base website te tonen:

bin/magento config:show --scope=websites --scope-code=base web/unsecure/base_url

Resultaat

web/unsecure/base_url - http://example-for-website.com/

om basis URL voor de default opslag te tonen:

bin/magento config:show --scope=stores --scope-code=default web/unsecure/base_url

Resultaat

web/unsecure/base_url - http://example-for-store.com/
INFO
De bereikcode kan alleen letters (a-z of A-Z), getallen (0-9) en onderstrepingstekens (_) bevatten. Het eerste teken moet ook een letter zijn. Als hoofdletters of hoofdletters worden gebruikt bij het maken van een website- of winkelweergave, is de overeenkomst intern niet hoofdlettergevoelig voor overschrijvingen van configuratie-instellingen via omgevingsvariabelen. Zie het omgevingsvariabelen van het Gebruik om configuratiemontagesmet voeten te treden.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c