Luxeritas PHP8.3 調査まとめ（2026-05）

5月 11, 2026

調査目的

Luxeritas fork を:

• PHP 8.3
• WordPress latest
• wp-env + Docker
• WSL2

環境で動作確認し、

• fatal
• warning
• deprecated
• WP-CLI compatibility

を調査する。

---

構築環境

sandbox 環境

場所:

~/Claude/private/luxeritas/wp-sandbox

構成:

項目	内容
OS	WSL2 Ubuntu
Runtime	Docker Desktop
Tool	wp-env
PHP	8.3
WordPress	latest
Theme	Luxeritas fork mount
DB	clean install
Plugins	未投入

---

wp-env 構成

.wp-env.json

主構成:

{
  "phpVersion": "8.3",
  "testsEnvironment": false,

  "themes": [
    "../themes/luxeritas",
    "../themes/luxech"
  ],

  "mappings": {
    "wp-content/themes/luxeritas": "../themes/luxeritas",
    "wp-content/themes/luxech": "../themes/luxech",
    "wp-content/imports": "./imports"
  },

  "config": {
    "WP_DEBUG": true,
    "WP_DEBUG_LOG": true,
    "WP_DEBUG_DISPLAY": false,
    "SCRIPT_DEBUG": true
  }
}

---

初期トラブル

Docker WSL Integration

問題:

/var/run/docker.sock 不可

原因:

Docker Desktop の WSL Integration 無効。

対応:

Docker Desktop
→ Settings
→ Resources
→ WSL Integration
→ Ubuntu ON

---

wp-env 起動問題

“core": “latest"

問題:

Invalid or unrecognized source: "latest"

原因:

現行 wp-env 仕様非対応。

対応:

core 行削除

---

.wp-env.json 編集ミス

問題:

luxeritas/.wp-env.json

を編集していた。

実際に使用されていたのは:

luxeritas/wp-sandbox/.wp-env.json

wp-env は:

カレントディレクトリ

の .wp-env.json を使用。

---

wp-env 起動成功

最終構成:

Container	役割
wordpress	開発用 WordPress
mysql	MariaDB
cli	wp-cli

testsEnvironment: false
により tests-* container は無効化。

---

PHP8.3 Warning 調査

発生 warning

PHP Warning:
Trying to access array offset on null

発生箇所:

File	Line
functions.php	53
functions.php	67
functions.php	85
functions.php	92
functions.php	226
functions.php	245
inc/const.php	17
inc/widget.php	1803
inc/widget.php	2245

---

root cause 分析

結論

原因は:

WP-CLI bootstrap 時の scope 問題

---

詳細

WP-CLI は:

WP_CLI\Runner::load_wordpress()

内部から:

require 'wp-settings.php'

を実行。

PHP の include/require は:

呼び出し元 scope を継承

する。

そのため:

$_is['ssl'] = is_ssl();

等が:

$GLOBALS['_is']

ではなく、

load_wordpress() local scope

へ格納される。

後続 callback 側では:

global $_is;

により $GLOBALS['_is'] を参照。

しかし:

$GLOBALS['_is'] 未初期化

のため:

Trying to access array offset on null

warning 発生。

---

重要な切り分け

項目	結論
clean install 特有か	NO
DB import で直るか	NO
browser access で発生するか	基本 NO
PHP8.3 固有か	NO
PHP7系では	Notice 相当で潜伏

---

評価

良い点

Luxeritas は:

PHP8.3 で fatal 崩壊していない

確認できた。

問題は:

bootstrap scope warning

中心。

---

修正案比較

Option A（推奨）

inc/global-const.php

へ:

global $luxe, $_is, $fchk, $default_set, $widget_concat, $awesome;

追加。

---

理由

• root cause 修正
• 変更量最小
• wp-cli 対応
• future PHP 対応
• CI/automation 対応
• AI tooling 対応

---

Option B

各箇所を:

$_is['admin'] ?? false

化。

---

非推奨理由

• warning suppress に近い
• 根本原因未修正
• 修正箇所増大
• 他 global state 問題が残る

---

AIレビュー結果

Claude系

強み:

• root cause 収束
• phase 分離
• minimal fix

---

Gemini

強み:

• 設計レビュー
• global state 管理視点
• 長期保守観点

提案:

$_is だけでなく他 global variable も global 宣言

---

OpenClaw + Codex/gpt-5.5

強み:

• call stack 分析
• scope behavior 分析
• $luxe 等への波及分析

結論:

global state 全体を global 化

推奨。

---

最終結論

今回の問題は:

PHP8.3 incompatibility

というより、

Luxeritas の
「WordPress browser bootstrap 前提」

が、

WP-CLI / modern tooling

環境で可視化されたもの。

---

今後の意味

今回の対応は:

• PHP8.4
• wp-cli
• CI
• Docker
• wp-env
• AI automation

への適応の第一歩となる。