upgrade

概要

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

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

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

構文

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

リファレンス

使い方

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 (base) のようなバージョン先頭の行で示し、最後に「最新: 10」などの件数を表示します。複数の更新内容を一目で比較できます。

インストールと管理

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

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

例

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

更新可能: 4 / 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
最新: 9
リポジトリより先行: 1

4 / 14 件を更新
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
最新: 9
リポジトリより先行: 1

更新可能: 4 / 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
最新: 9
リポジトリより先行: 1

更新可能: 1 / 1
                v1.30	>	v1.33	help (base)

1 / 1 件を更新
                v1.30	>	v1.33	help (base)

4 / 14 件を更新
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
最新: 9
リポジトリより先行: 1

Automatic upgrade  Check only
Session command    upgrade -c
Script             autoload.lil

Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil

Automatic upgrade  Update automatically
Session command    upgrade
Script             autoload.lil

Automatic upgrade  Off
Script             autoload.lil

missing_module: インストールされていません

関連コマンド

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

関連ドキュメント