Documentação Commerce Guia de configuração

Definir valores de configuração

Last update: Tue Oct 10 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

undefined
undefined
undefined

WARNING

Todos os comandos da CLI do Magento devem ser executados pelo proprietário do sistema de arquivos.

Este tópico discute comandos de configuração avançados que podem ser usados para:

Definir qualquer opção de configuração na linha de comando
Opcionalmente, bloqueie qualquer opção de configuração para que seu valor não possa ser alterado no Administrador
Alterar uma opção de configuração que esteja bloqueada no Administrador

Você pode usar esses comandos para definir a configuração do Commerce manualmente ou usando scripts. Defina as opções de configuração usando um caminho de configuração, que é uma /-uma string delimitada que identifica exclusivamente essa opção de configuração. Você pode encontrar caminhos de configuração nas seguintes referências:

Você pode definir valores nos seguintes horários:

Antes de instalar o Commerce, você pode definir valores de configuração somente para o escopo padrão, pois ele é o único escopo válido.
Depois de instalar o Commerce, você pode definir os valores de configuração para qualquer escopo de exibição de site ou loja.

Use os seguintes comandos:

bin/magento config:set define qualquer valor de configuração não confidencial por seu caminho de configuração
bin/magento config:sensitive:set define qualquer valor de configuração confidencial por seu caminho de configuração
bin/magento config:show mostra os valores de configuração salvos; os valores das configurações criptografadas são exibidos como asteriscos

Pré-requisitos

Para definir um valor de configuração, você deve saber pelo menos um dos seguintes itens:

O caminho de configuração
Para definir um valor de configuração para um escopo específico, você deve saber o código do escopo.

Para definir um valor de configuração para o escopo padrão, não é necessário fazer nada.

Encontrar o caminho de configuração

Consulte as seguintes referências:

Localizar o código do escopo

Você pode encontrar o código do escopo no banco de dados do Commerce ou no Administrador do Commerce.

Para encontrar o código do escopo no Administrador:

Faça logon no Administrador como um usuário que pode exibir sites e armazenar visualizações.
Clique em Stores > Configurações > All Stores.
No painel direito, clique no nome do site ou na exibição de loja para ver o código.

A figura a seguir mostra um exemplo de código de site.
Continuar com Definir valores.

Para encontrar o código do escopo no banco de dados:

Os códigos de escopo para sites e exibições de loja são armazenados no banco de dados do Commerce na store_website e store tabelas, respectivamente.

Conecte-se ao banco de dados do Commerce.

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

Digite os seguintes comandos:

code language-shell
`use <Commerce database name>;`

code language-shell
`SELECT * FROM store;`

code language-shell
`SELECT * FROM store_website;`

Um exemplo de resultado é o seguinte:

code language-terminal

code language-terminal
`[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 |
+------------+-------+--------------+------------+------------------+------------+

Use o valor na variável code coluna.

Prossiga para a próxima seção.

Definir valores

Para definir valores de configuração específicos do sistema:

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

Para definir valores de configuração confidenciais:

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

A tabela a seguir descreve as set parâmetros de comando:

Parâmetro

Descrição

--scope

O escopo da configuração. Os valores possíveis são default, websiteou store. O padrão é default.

--scope-code

O código de escopo da configuração (código de site ou código de exibição de loja)

-e or --lock-env

-c or --lock-config

O bloqueia o valor para que ele não possa ser editado no Administrador ou altera uma configuração que já está bloqueada no Administrador. O comando grava o valor na variável <Commerce base dir>/app/etc/config.php arquivo. A variável --lock-config a opção substitui --lock-env se você especificar ambas as opções.

path

Obrigatório. O caminho de configuração

value

Obrigatório. O valor da configuração

INFO

A partir do Commerce 2.2.4, o --lock-env e --lock-config as opções substituem o --lock opção.

Se você usar o --lock-env ou --lock-config para definir ou alterar um valor, você deve usar a opção bin/magento app:config:import comando para importar a configuração antes de acessar o Admin ou a loja.

Se você inserir um caminho de configuração incorreto, esse comando retornará um erro

The "wrong/config/path" does not exist

Consulte uma das seguintes seções para obter mais informações:

Defina os valores de configuração que podem ser editados no painel
Definir valores de configuração que não podem ser editados no Administrador

Defina os valores de configuração que podem ser editados no painel

Uso bin/magento config:set sem --lock-env ou --lock-config para gravar o valor no banco de dados. Os valores definidos dessa maneira podem ser editados no Administrador.

A seguir, alguns exemplos para definir um URL de base de armazenamento:

Defina o URL base para o escopo padrão:

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

Defina o URL de base para a variável base site:

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

Defina o URL de base para a variável test exibição de loja:

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

Definir valores de configuração que não podem ser editados no Administrador

Se você usar o --lock-env da seguinte maneira, o comando salva o valor de configuração em <Commerce base dir>/app/etc/env.php e desativa o campo para editar esse valor no campo Admin.

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

Você pode usar o --lock-env opção para definir valores de configuração se o Commerce não estiver instalado. No entanto, é possível definir valores somente para o escopo padrão.

INFO

A variável env.php O arquivo é específico do sistema. Você não deve transferi-lo para outro sistema. Você pode usá-lo para substituir valores de configuração do banco de dados. Por exemplo, você pode pegar um dump de banco de dados de outro sistema e substituir o base_url e outros valores para que você não precise modificar o banco de dados.

Se você usar o --lock-config da seguinte maneira, o valor de configuração é salvo em <Commerce base dir>/app/etc/config.php. O campo para editar esse valor no Admin está desativado.

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

Você pode usar --lock-config para definir os valores de configuração se o Commerce não estiver instalado. No entanto, é possível definir valores somente para o escopo padrão.

INFO

Você pode transferir config.php para outro sistema para usar os mesmos valores de configuração. Por exemplo, se você tiver um sistema de teste, usando o mesmo config.php significa que não é necessário definir os mesmos valores de configuração novamente.

Exibir o valor das definições de configuração

Opções de comando:

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

onde

--scope é o escopo da configuração (padrão, site, loja). O valor padrão é default
--scope-code é o código de escopo da configuração (código de site ou código de exibição de loja)
path é o caminho de configuração no formato primeira_parte/segunda_parte/terceira_parte/etc (obrigatório)

INFO

A variável bin/magento config:show exibe os valores de qualquer valores codificados como uma série de asteriscos: ******.

Exemplos

Para mostrar todas as configurações salvas:

bin/magento config:show

Resultado:

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

Para mostrar todas as configurações salvas para o base site:

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

Resultado:

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

Para mostrar o URL base do escopo padrão:

bin/magento config:show web/unsecure/base_url

Resultado:

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

Para mostrar o URL base da variável base site:

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

Resultado:

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

Para mostrar o URL base da variável default loja:

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

Resultado:

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

INFO

O código do escopo pode incluir somente letras (a-z ou A-Z), números (0-9) e sublinhados (_). Além disso, o primeiro caractere deve ser uma letra. Se forem usadas maiúsculas ou minúsculas como camelo ao criar uma visualização de site ou loja, internamente, a correspondência não diferencia maiúsculas de minúsculas para acomodar a substituição das definições de configuração por meio de variáveis de ambiente. Consulte Usar variáveis de ambiente para substituir as definições de configuração.

recommendation-more-help

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