設定値を設定
このトピックでは、次の目的で使用できる高度な設定コマンドについて説明します。
- コマンドラインからの設定オプションの設定
- オプションで、設定オプションをロックして、管理者でその値を変更できないようにします。
- 管理者でロックされている設定オプションの変更
これらのコマンドを使用して、Commerceの設定を手動で、またはスクリプトを使用して行うことができます。 設定オプションは、その設定オプションを一意に識別する /
区切りの文字列である 設定パス を使用して設定します。 設定パスは、次の参照で確認できます。
次のタイミングで値を設定できます。
-
Commerceは唯一の有効なスコープであるため、インストールする前に、デフォルトスコープの設定値のみを設定することができます。
-
Commerceのインストール後、任意の web サイトやストアビューの範囲に対して設定値を指定できます。
次のコマンドを使用します。
bin/magento config:set
は、設定パスによって、大文字と小文字を区別しない設定値を設定しますbin/magento config:sensitive:set
は、設定パスによって機密設定値を設定しますbin/magento config:show
は保存された設定値を表示します。暗号化された設定値はアスタリスクで表示されます
前提条件
設定値を設定するには、次のうち少なくとも 1 つを知っている必要があります。
-
設定パス
-
特定のスコープの設定値を設定するには、スコープ コードを知っている必要があります。
デフォルトスコープの設定値を設定する場合は、何もする必要はありません。
設定パスの検索
以下のリファレンスを参照してください。
スコープ コードの検索
スコープコードは、Commerce データベースまたはCommerce Admin のいずれかで確認できます。
管理者でスコープコードを検索するには:
-
Web サイトの表示や表示の保存を行えるユーザーとして管理者にログインします。
-
Stores /設定/ All Stores をクリックします。
-
右側のウィンドウで、web サイトまたはストアビューの名前をクリックして、そのコードを表示します。
次の図に、サンプル Web サイトコードを示します。
-
値を設定を続行します。
データベースでスコープ コードを検索するには:
Web サイトおよびストアビューのスコープコードは、それぞれCommerce データベースの store_website
テーブルおよび store
テーブルに格納されます。
-
Commerce データベースに接続します。
code language-bash mysql -u <Commerce database username> -p
-
次のコマンドを入力します。
code language-shell use <Commerce database name>;
code language-shell SELECT * FROM store;
code language-shell SELECT * FROM store_website;
次に結果の例を示します。
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 | +------------+-------+--------------+------------+------------------+------------+
code
列の値を使用します。 -
次の節に進みます。
値を設定
システム固有の設定値を設定するには:
bin/magento config:set [--scope="..."] [--scope-code="..."] [-le | --lock-env] [-lc | --lock-config] path value
機密性の高い設定値を設定するには:
bin/magento config:sensitive:set [--scope="..."] [--scope-code="..."] path value
次の表に、set
のコマンドパラメーターを示します。
--scope
default
、website
、store
です。 デフォルトは default
です。--scope-code
-e or --lock-env
<Commerce base dir>/app/etc/env.php
ファイルに値を書き込みます。-c or --lock-config
<Commerce base dir>/app/etc/config.php
ファイルに値を書き込みます。 両方のオプションを指定した場合、--lock-config
オプションは --lock-env
を上書きします。path
value
--lock-env
」オプションと「--lock-config
」オプションが「--lock
」オプションに置き換わります。--lock-env
または --lock-config
オプションを使用して値を設定または変更する場合は、bin/magento app:config:import
コマンドを使用して設定を読み込んでから管理者またはストアフロントにアクセスする必要があります。間違った設定パスを入力すると、このコマンドはエラーを返します
The "wrong/config/path" does not exist
詳しくは、次のいずれかの節を参照してください。
管理者が編集できる設定値を設定します。
値をデータベースに書き込むには、bin/magento config:set
without --lock-env
または --lock-config
を使用します。 この方法で設定した値は、管理者で編集できます。
ストアベース URL の設定例を次に示します。
デフォルトスコープのベース URL を設定します。
bin/magento config:set web/unsecure/base_url http://example.com/
base
の web サイトのベース URL を設定します。
bin/magento config:set --scope=websites --scope-code=base web/unsecure/base_url http://example2.com/
test
ストア表示のベース URL を設定してください:
bin/magento config:set --scope=stores --scope-code=test web/unsecure/base_url http://example3.com/
管理者が編集できない設定値を設定します。
次のように --lock-env
オプションを使用すると、コマンドは設定値を <Commerce base dir>/app/etc/env.php
に保存し、Admin でこの値を編集するためのフィールドを無効にします。
bin/magento config:set --lock-env --scope=stores --scope-code=default web/unsecure/base_url http://example3.com
Commerceがインストールされていない場合は、--lock-env
オプションを使用して設定値を設定できます。 ただし、デフォルトの範囲の値のみを設定できます。
env.php
のファイルは、システムに固有です。 別のシステムに転送しないでください。 これを使用して、データベースの設定値を上書きできます。 例えば、別のシステムからデータベースダンプを取得し、base_url
と他の値を上書きして、データベースを変更する必要がないようにすることができます。次のように --lock-config
オプションを使用すると、設定値は <Commerce base dir>/app/etc/config.php
に保存されます。 管理者でこの値を編集するフィールドは無効になっています。
bin/magento config:set --lock-config --scope=stores --scope-code=default web/url/use_store 1
Commerceがインストールされていない場合は、--lock-config
を使用して設定値を設定できます。 ただし、デフォルトの範囲の値のみを設定できます。
config.php
を別のシステムに転送して、そこで同じ設定値を使用することができます。 例えば、テストシステムがある場合、同じ config.php
を使用すると、同じ設定値を再度設定する必要がなくなります。構成設定の値を表示
コマンドオプション:
bin/magento config:show [--scope[="..."]] [--scope-code[="..."]] path
ここで、
--scope
は、設定の範囲(デフォルト、web サイト、ストア)です。 デフォルト値はdefault
です--scope-code
は設定のスコープ コードです(web サイト コードまたはストア表示コード)path
は、first_part/second_part/third_part/etc 形式の設定パスです(必須)。
例
保存されているすべての設定を表示するには:
bin/magento config:show
結果:
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
base
の web サイトに保存されているすべての設定を表示するには:
bin/magento config:show --scope=websites --scope-code=base
結果:
web/unsecure/base_url - http://example-for-website.com/
general/region/state_required - AT,BR,CA
デフォルトスコープのベース URL を表示するには:
bin/magento config:show web/unsecure/base_url
結果:
web/unsecure/base_url - http://example.com/
base
Web サイトのベース URL を表示するには:
bin/magento config:show --scope=websites --scope-code=base web/unsecure/base_url
結果:
web/unsecure/base_url - http://example-for-website.com/
default
ストアのベース URL を表示するには:
bin/magento config:show --scope=stores --scope-code=default web/unsecure/base_url
結果:
web/unsecure/base_url - http://example-for-store.com/