🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語(現在)
点検と診断のコマンド
はじめに
このページでは、サイトがどんな状態かを教えてくれるコマンドを説明します。gp247:doctor はサーバー、インストール状態、
セキュリティ設定を点検し、gp247:info と gp247:core-info はバージョンを表示し、gp247:cache-rebuild はキャッシュを
再構築します。いずれも(キャッシュの再構築を除き)読み取りのみなので、販売中のサイトでもいつでも実行できます。対象は、
サイトオーナーとサーバーを運用する方です。読み終えると、gp247:doctor が報告する各行の意味と直し方が分かります。
ひと目でわかる
gp247:doctor は次の 3 つのタイミングで使います。
flowchart LR
A["インストール前<br/>サーバーの<br/>準備はOK?"] --> B["インストール<br/>・更新後<br/>片付けは?"]
B --> C["定期的に<br/>設定は<br/>安全?"]
- 3 つの状態:PASS 問題なし · WARN 片付けたほうがよいが止めない · FAIL 直す必要あり。
- FAIL が 1 つでもあると、コマンドは 0 以外で終了します — CI やインストール前の関門として使えます。WARN は終了コードを変えません。
- インストール済みのサイトでは、セキュリティ設定も点検します — 「システムアラート」画面が管理者に表示する項目と同じです。
- 不具合の報告や修正の確認にバージョンが必要なとき →
gp247:info。
gp247:doctor — サイトの健全性チェック
-
サイトのフォルダーで、次のように入力します。
php artisan gp247:doctor -
結果の表を読みます。各行にはチェック名、状態、メモ(パス、件数、修正用のコマンド)があります。
-
まず FAIL の行をすべて直し、次に WARN の行を直します。FAIL がなくなるまで再実行します。
doctor は設定とデータベースを読むだけで、ネットワーク経由でサイトを開くことはありません(--probe-headers を付けた場合を除く —
ブラウザに実際に届くセキュリティヘッダーを確認するを参照)。http:// が https:// に
転送されるか、.env が外部からダウンロードできないかは、自分で確認する必要があります — セキュリティ
の 安全な本番環境の設定 を参照してください。
サーバーとインストール
| チェック | 確認内容 | 不合格のとき |
|---|---|---|
php_version |
PHP 8.3 以上 | FAIL — PHP を上げる |
ext_pdo、ext_mbstring、ext_openssl、ext_tokenizer、ext_ctype、ext_json |
必須の PHP 拡張 | FAIL — 拡張を有効にする |
ext_zip、ext_curl、ext_gd、ext_fileinfo |
推奨の PHP 拡張 | WARN — 一部の機能(.zip のインストール、画像)が動かない |
env_file |
.env ファイルがある |
FAIL |
writable_storage、writable_bootstrap_cache |
storage/、bootstrap/cache/ に書き込める |
FAIL — フォルダーの権限を直す |
writable_app_gp247、writable_public_gp247 |
app/GP247、public/GP247 に書き込める |
WARN — 拡張機能をインストール/更新できない |
db_connection |
データベースに接続できる | FAIL — .env の DB_* を確認する |
installed |
サイトがインストール済みか | 未インストールのとき WARN(初回インストール前は正常) |
暗号鍵と機密情報
| チェック | 確認内容 |
|---|---|
encryption_key_dedicated |
機密情報用に専用の GP247_ENCRYPTION_KEY を設定しているか(APP_KEY と共用していないか) — 機密データの暗号化 を参照 |
secret_decryptable |
設定内の暗号化された機密情報をまだ復号できるか(できない場合:古い鍵を残さずに鍵を変えた兆候) |
backup_post_incident_pending |
「セキュリティ事故の後」の復元のあと、まだ終わっていない作業(鍵の変更、コードの再インストール、データベース/ホスティングのパスワード変更)がある |
拡張機能と見た目
| チェック | 確認内容 | 修正コマンド |
|---|---|---|
extension_assets |
インストール済みの拡張機能の CSS/JS/画像が public/GP247/... にない、または(core 3.14.3 以降)app/ の版より古いファイルがある |
gp247:ext-publish |
extension_data_pending |
GP247 が記録したバージョンより新しいファイルを持つ拡張機能(git pull や上書きコピーの直後)で、データ更新が未実行 |
gp247:ext-update --local --all |
template_source |
パッケージと同一の、公開済みテンプレートファイルの数 — 修正を受け取れない | gp247:template-prune |
file_bom |
UTF-8 の BOM で始まる .php/.blade.php ファイル |
BOM なしの UTF-8 で保存し直す |
raw_output_scan |
(WARN、core 3.12.0 から)サイトのテンプレート/プラグイン(app/GP247/Templates、app/GP247/Plugins)が、安全な形以外で {!! … !!} を使って変数を出力しており、入力された文字が HTML のまま表示される。--json には ファイル:行 の一覧が入る |
{{ }} に置き換える |
REST API
| チェック | 確認内容 |
|---|---|
api_config_legacy_names |
.env に、名前が変わった古い API 変数名が残っている(設定がキャッシュされている間は省略) |
api_route_gate |
ルートがキャッシュされているとき:すべての REST API ルートが API 共通の保護を通っている |
api_event_retention |
API 同期イベントのテーブルに保存期間を過ぎたイベントがある(API リクエスト時に自動で削除。必要なら GP247_API_EVENT_DAYS を小さくする) |
セキュリティ設定(インストール済みのサイト)
これらのチェックは PASS か WARN だけです(管理画面で重大と表示される場合でも)。そのため終了コードは変わりません。
| チェック | WARN になる条件 |
|---|---|
app_debug |
APP_DEBUG が有効 |
https |
APP_URL が https:// で始まらない、または SESSION_SECURE_COOKIE が無効(APP_ENV=production のときだけ WARN) |
trusted_proxies |
TRUSTED_PROXIES がすべての接続元を信頼している(*、REMOTE_ADDR など) — 誰でも自分の IP を偽れるので、ログイン制限と IP ルールが効かなくなる |
default_admin_password |
有効な admin アカウントが既定のパスワードのまま |
password_policy |
管理者パスワードの最小文字数が 12 未満 |
mfa_enabled |
二要素認証プラグイン MFA が未インストールまたは無効 |
api_exposure |
(情報のみ、PASS)REST API/MCP が有効 |
support_line |
使用中のバージョン系列のセキュリティサポートが残り 6 か月未満、または終了 |
security_headers |
(core 3.16.0 から)緊急スイッチ GP247_SECURITY_HEADERS=0 ですべてのセキュリティヘッダーが止まっている、HTTPS でないサイトで HSTS が有効、またはヘッダーが無効になっている |
login_failures |
(core 3.11.0 から)過去 24 時間に管理者パスワードを推測しようとした形跡がある、または管理者のログイン失敗が記録されていない |
backup_vault_exposed |
(core 3.11.0 から)バックアップを保存するフォルダが Web からダウンロードできる |
gp247/front のチェック(front があるサイト)
パッケージやプラグインは同じシステムアラートの一覧にチェックを追加します。doctor はそれらも表示し、こちらも PASS か WARN だけです。
| チェック | WARN になる条件 |
|---|---|
seo_audit |
(front 3.11.0 から)ストアの直近の SEOチェックに、まだ修正が必要な問題がある — doctor は保存済みの結果を読むだけで、再スキャンはしない |
tracking_consent |
(front 3.12.0 から)Cookie バナーが無効なのにトラッキングコードが動いている、またはストアのテンプレートが meta-head を呼んでおらずトラッキングコードが動かない |
ブラウザに実際に届くセキュリティヘッダーを確認する
--probe-headers を付けると、doctor はトップページ(APP_URL)を1 回だけ開き、ブラウザが実際に受け取るセキュリティ
ヘッダーを セキュリティヘッダー 画面の設定と比べます。
php artisan gp247:doctor --probe-headers
security_headers_live の行は、ヘッダーが足りない、2 回送られている(Web サーバーと GP247 の両方が送っている)、または無効に
したのに届いている場合に WARN になります。ページを開けない場合(ドメインがまだない、ネットワークで遮断)は、注記
could not check 付きで PASS になります。詳しくは セキュリティヘッダー。
ℹ️ 対応バージョン: gp247/core 3.16.0
file_bom を確認する理由
BOM とは、Windows の多くのエディターが「UTF-8」で保存するときにファイルの先頭へ付け加える目に見えない 3 バイトです。
PHP はこれをほかの何よりも先に出力するため、「headers already sent」エラー、先頭の文字から壊れた JSON/XML/CSV、
不明な文字で始まる HTML などの原因になります。ファイルを開いてもまったく普通に見えるので、機械でしか見つけられません。
doctor は app/GP247/** と gp247/* パッケージのソースを調べます。
直し方: エディターでファイルを開き、BOM なしの UTF-8(UTF-8 without BOM)で保存し直します(VS Code:右下のステータス
バーの UTF-8 with BOM をクリック → Save with Encoding → UTF-8)。gp247:doctor を再実行し、PASS に戻ったことを確認します。
gp247:info と gp247:core-info — バージョンの確認
| コマンド | 表示内容 |
|---|---|
gp247:info |
インストール済みの各パッケージ(core、front、shop、mcp)のバージョン、インストール済みか、プラグイン/テンプレートの数、拡張機能ライブラリのアドレス |
gp247:core-info |
名前、core のバージョンとサブバージョン、ホームページ、ソースリポジトリ |
php artisan gp247:info
💡 ヒント: サイトにセキュリティ修正が入っているかを知るには、
gp247:infoが表示するパッケージのバージョンを リリースとセキュリティ の表と比べてください。管理画面のフッターに表示される S-Cart のバージョンは、 最初のcomposer updateの後は当てになりません。必ずパッケージのバージョンで判断してください。
gp247:cache-rebuild — キャッシュの再構築
ルートと設定のキャッシュを消して再構築します。GP247 は、拡張機能のインストール、有効化、更新の後と、gp247:update の最後に
自動でこのコマンドを呼び出します。.env やルートを変えたのにサイトに反映されないときに、手動で実行します。
php artisan gp247:cache-rebuild
よくある質問(Q&A)
Q1: doctor に WARN の行があります。サイトは動きますか?
→ はい。WARN は片付けたほうがよい項目(セキュリティ、不要なファイル)で、サイトを止めません。すぐに直す必要があるのは FAIL だけです。
Q2: インストール前に doctor を実行する意味はありますか?
→ あります。それが主な用途の 1 つです。doctor は composer require の直後から、インストール前でも使えます。インストール済みの
データベースが必要なチェックは省略されます。
Q3: doctor が secret_decryptable を不合格と報告します。
→ 暗号鍵が変わり、古い鍵が失われています。古い鍵を GP247_ENCRYPTION_PREVIOUS_KEYS に入れて gp247:encryption-key-rotate を
実行してください — 機密データの暗号化 を参照してください。
Q4: 開発用マシンで https が WARN になります。
→ WARN になるのは APP_ENV=production のときだけで、ほかの環境ではメモつきの PASS です。WARN が出る場合は APP_ENV を
確認してください。
Q5: CI で doctor を使うには?
→ php artisan gp247:doctor --json を使います。FAIL があると 0 以外で終了するので、CI のステップが自動で止まります。
スクリプト・CI・Docker を参照してください。
Q6: doctor のセキュリティチェックで、セキュリティの見直しは不要になりますか?
→ いいえ。doctor は設定を読むだけです。セキュリティチェックリスト で全体を確認してください。
変更履歴
| 日付 | GP247 バージョン | 変更内容 |
|---|---|---|
| 2026-11-22 | gp247/core 3.11.0–3.16.0、gp247/front 3.11.0–3.12.0 | システムアラートから doctor が表示するその他の行を追加しました:security_headers、login_failures、backup_vault_exposed、raw_output_scan、seo_audit、tracking_consent。--probe-headers(security_headers_live の行)を追加しました |
| 2026-11-17 | gp247/core 3.14.3 | extension_assets は不足しているファイルだけでなく、古い静的ファイル(app/ の版と内容が異なる)も報告 |
📅 最終更新: 2026-11-22 · ✍️ 作成者 (Author): GP247