blocs/blocs: 定数・環境設定リファレンス
blocs/blocs: 定数・環境設定リファレンス
BLOCS が参照する定数・グローバル設定の一覧です。各所のナレッジに分散している設定をまとめた参照用記事です。
blocs/blocs コア定数（Consts.php）
| 定数 | 既定の設定元 | 説明 |
|---|---|---|
BLOCS_CACHE_DIR |
config('view.compiled') |
コンパイル済み PHP / JSON キャッシュの保存先。書き込み不可だと B001（No.2.14） |
BLOCS_ROOT_DIR |
config('view.paths')[0] |
テンプレートのルートディレクトリ |
BLOCS_OPTION_SEPARATOR |
', ' |
複数選択 menu の表示区切り文字 |
BLOCS_INCLUDE_MAX |
50 |
data-include の入れ子上限。超えると B004 |
BLOCS_NO_LARAVEL |
— | true で Laravel 非依存モード（No.2.18） |
BLOCS_CLASS_UPLOAD |
'ai-upload' |
アップロード input のクラス名 |
未定義の場合、blocs/src/Consts.php 読み込み時に上記既定で define されます（BLOCS_NO_LARAVEL を除く）。
blocs/admin 初期化（app/Consts/Blocs.php）
blocs:install 後に App\Consts\Blocs::define() が呼ばれ、以下を上書き・追加します。
| 定数 / 設定 | 既定値 | 説明 |
|---|---|---|
BLOCS_CACHE_DIR |
config('view.compiled') |
テンプレートキャッシュ |
BLOCS_ROOT_DIR |
config('view.paths')[0] |
ビュールート |
BLOCS_OPTION_SEPARATOR |
', ' |
menu 表示の区切り |
BLOCS_INCLUDE_MAX |
50 |
include 上限 |
ADMIN_IMAGE_JPEG_QUALITY |
-1 |
JPEG サムネイル品質（No.5.5） |
ADMIN_IMAGE_PNG_QUALITY |
-1 |
PNG サムネイル品質（No.5.5） |
$GLOBALS['BLOCS_AUTOINCLUDE_DIR'] |
resource_path('views/admin/autoinclude') |
Auto Include ディレクトリ（No.2.12） |
config(['app.locale' => 'ja']) 等のロケール・タイムゾーン設定もここで行われます。
手動で上書きする例
Consts.php 読み込み前、または App\Consts\Blocs::define() の前に定義します。
defined('BLOCS_CACHE_DIR') || define('BLOCS_CACHE_DIR', storage_path('framework/views'));
defined('BLOCS_INCLUDE_MAX') || define('BLOCS_INCLUDE_MAX', 100);
$GLOBALS['BLOCS_AUTOINCLUDE_DIR'] = resource_path('views/custom/autoinclude');
テンプレート JSON キャッシュのキー
storage/framework/views/{md5}.json に保存される主なキー:
| キー | 内容 |
|---|---|
include |
依存テンプレート一覧 |
filter |
data-filter 定義 |
validate |
data-validate 定義 |
message |
data-lang エラーメッセージ |
upload |
ai-upload 用バリデーション（No.2.13） |
option / menu |
選択肢・ラベル定義（No.2.2 / 2.16） |
テンプレート変更後に挙動がおかしい場合は BLOCS_CACHE_DIR 内のキャッシュ削除を検討してください（No.7.2）。
AI 連携（config/qdrant.php）
blocs/admin の VectorStore が参照する設定は No.5.10 を参照してください。