upgrade

概要

upgrade はモジュール保守を予測しやすい手順にまとめます。まず計画を確認し、1つのモジュールまたは全体を更新し、互換依存関係を修復できます。run があれば、認証済みセッション開始時に一度だけ確認または更新を行う設定も選べます。

コードを置き換える前に計画を確認する

upgrade -c はモジュールソースを書き込まずにバージョン、パッケージ、依存関係を解析します。実更新は導入済みパッケージとリポジトリを維持して原子的に置換し、必須依存が完全に欠ける場合だけ install を使います。

構文

upgrade [module ...] [-c] · upgrade -auto <check|update|off> · upgrade -info

リファレンス

upgrade ガイド

Minimum では全モジュールまたは指定した一つだけを更新できます。-c の検査、複数指定、自動モードには Base が必要です。

稼働中のサイトを更新する前に upgrade -c で確認しましょう。バージョンと依存関係を調べますが、PHP コードは書き換えません。upgrade hash -c なら対象を一つに絞れます。

upgrade hash は導入済みモジュールを更新または修復し、Base/Minimum の種類と取得元を引き継ぎます。引数のない upgrade は導入済みの全モジュールを対象にします。新規導入は install を使います。

upgrade -auto check は run と autoload.lil を使って認証済みセッション開始時の確認を設定します。-auto update は PHP コードを自動変更できるため、初期状態では無効です。状態は upgrade -info、停止は -auto off。cd など Core 内蔵コマンドは lil.php の交換が必要です。

使い方

upgrade [module ...] [-c]

upgrade -auto <check|update|off>

upgrade -info

計画

各インストールマーカーには、リポジトリ、バージョン、Base または Minimum パッケージ、lil.core 世代が記録されています。upgrade は同じリポジトリから最新の互換 Public 版を選び、既存パッケージを維持し、互換性メタデータを確認します。ローカル版が先行している場合は自動的にダウングレードしません。

更新と修復

既存モジュールはダウンロード、正規化、解析、メソッド競合の確認を経て原子的に置換されます。依存関係もリポジトリ、パッケージ、バージョン、コア世代で検証されます。すでに存在する依存関係は upgrade 自身が更新し、完全に欠けている場合だけ install に渡します。

確認モード

-c は同じバージョン・パッケージ・依存関係の解析を行いますが、モジュールソースをダウンロードせず、拡張ファイルにも書き込みません。重要な環境では、手動または自動更新の前にまず実行することを推奨します。

自動モード

任意の自動モードは run の既存スタートアップ機構と autoload.lil を利用します。upgrade が編集するのは自身の # <upgrade:auto> マーク付きブロックだけで、それ以外の行は保持されます。check は upgrade -c、update は upgrade を登録し、off はその管理ブロックだけを削除します。check と update は同時には有効になりません。

autoload.lil は認証済みセッションごとに一度実行されるため、選択した処理はログイン後に動作し、コマンドごとには実行されません。自動モードには run が必要です。upgrade -info は書き込みを行わず現在のモードを表示します。

安全性

自動更新は初期状態では無効です。update は実行可能な PHP モジュールコードをダウンロードして置換するため、信頼できるリポジトリだけを使用してください。変更を常に明示的に管理したい場合は check を選びます。upgrade -auto off で管理処理をいつでも解除できます。

サマリーの表示形式

インストール全体の確認や更新は簡潔な総数から始まり、変更対象を v1.30 > v1.33 help ⌘ のようなバージョン先頭の行で示し、最後に「最新: 10」などの件数を表示します。複数の更新内容を一目で比較できます。

組み込みの cd と core は Core 本体に含まれます。upgrade は状態を表示しますが、更新するには lil.php の置き換えが必要です。

Base パッケージは ⌘、Minimum パッケージは (minimum) と表示します。

単一モジュールの結果

単一モジュールの確認・更新では、v1.1.5 ⌘ や v1.1.4 > v1.1.5 ⌘ のように、バージョンとパッケージ記号だけを表示します。モジュール名や Current/Available は繰り返しません。ソースを取得できない場合は、同じバージョンを一度だけ再取得します。

upgrade は -c による確認を含め、複数のモジュール名を一度に受け付けます。指定モジュールと必要な依存関係だけを処理します。

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

例

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

用意された学習用の結果です。Play は実際の環境を変更しません。
Status  All 3 modules are current
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
All installed extension modules are current
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
v1.1.4
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
v1.1.4
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
v1.1.5
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
All 3 selected modules are current
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Built-in  core · Core v1.5.x
Update    replace lil.php to update
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Automatic upgrade  Off
Script             autoload.lil
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
missing_module: not installed

用意された学習用の結果です。Play は実際の環境を変更しません。
?

用意された学習用の結果です。Play は実際の環境を変更しません。
?

用意された学習用の結果です。Play は実際の環境を変更しません。
?

用意された学習用の結果です。Play は実際の環境を変更しません。
v1.4.8
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
v1.3.6
結果は導入済みパッケージやリポジトリの状態によって異なります。

用意された学習用の結果です。Play は実際の環境を変更しません。
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
結果は導入済みパッケージやリポジトリの状態によって異なります。

関連コマンド

紫のコマンドリンクは、その機能が別のモジュールを使うことを示します。リンク先のコマンドを開くと、役割とインストール方法を確認できます。

関連ドキュメント