[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."}

Configuratiewaarden instellen

Last update: Fri Nov 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:
Configuratie

Gemaakt voor:

Ervaren
Beheerder
Ontwikkelaar

WARNING

Alle bevelen van Magento CLI moeten door de eigenaar van het dossiersysteem worden 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:

Meld u aan bij de beheerder als een gebruiker die websites kan bekijken en weergaven kan opslaan.
Klik op Stores > Instellingen > All Stores .
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.
Ga met Vastgestelde waarden verder.

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 .

Maak verbinding met de Commerce-database.

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

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

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 \| +------------+-------+--------------+------------+------------------+------------+`

[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 .

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

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

path

Vereiste. Het configuratiepad

value

Vereiste. De waarde van de configuratie. Hoewel het als afzonderlijk argument in een CLI bevel kan worden overgegaan, adviseert Adobe dat u het niet in het originele bevel specificeert. Voer in plaats daarvan de opdracht uit zonder de waarde en voer vervolgens de waarde in wanneer hierom wordt gevraagd. Het gebruiken van deze methode verhindert het schrijven van gevoelige toegangswaarden aan bash_history, die de veiligste manier is om config te plaatsen.

INFO

Vanaf Commerce 2.2.4 vervangen de opties --lock-env en --lock-config de optie --lock . Als u een van deze opties gebruikt, wordt de waarde rechtstreeks naar het bestand app/etc/env.php of app/etc/config.php geschreven en wordt deze in de beheerfunctie alleen-lezen. Als u configuratiewijzigingen uit deze bestanden wilt importeren in de database, voert u de opdracht bin/magento app:config:import uit, bijvoorbeeld na het handmatig bewerken of opnieuw implementeren van de bestanden.

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
Configuratiewaarden instellen die niet kunnen worden bewerkt in de beheerder

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 waarden als 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 configuratiemontages met voeten te treden.

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c