ブラウザーでもサイト内でも使える lil-terminal
lil-terminal は通常のブラウザーページとして使うことも、作業中のページのすぐ横で使えるよう同じターミナルをサイトに組み込むこともできます。連携で変わるのは開き方だけで、コマンドや権限は変わりません。
通常のブラウザーターミナルとして開く
最も簡単な使い方には連携が不要です。生成された lil.php をアップロードし、その URL をブラウザーで開けばすぐに作業できます。独立したターミナルページで十分なら、追加の接続は必要ありません。
https://example.com/lil.php埋め込みで権限は増えません
単独モード、JavaScript 連携、保護された PHP 連携はいずれも同じ PHP アカウントで同じ lil-terminal を実行します。ファイルやデータベースへのアクセスは、引き続きホスティングの権限、HTTPS、ターミナル認証によって決まります。
サイトの上に開くターミナル
組み込みモードでは、lil-terminal がページ上にフローティングウィンドウとして開きます。通常時の位置とサイズ、最小化バーの左右位置、拡張表示の幅はこのインストールごとにブラウザーへ保存されます。
- 赤いボタンはターミナルを閉じます。Ctrl/Command+Shift+L で再度開けます。
- 黄色いボタンはターミナルを画面下部の小さなバーへ最小化します。この状態はページ移動や再読み込み後も保持され、ドラッグすると左右どちらかに吸着します。
- 緑のボタンはターミナルを画面左半分で全高表示します。幅は横方向に変更でき、もう一度押すと標準サイズのウィンドウへ戻ります。
CtrlCommand+Shift+L Windows/Linux の Ctrl+Shift+L、macOS の Command+Shift+L で、閉じたターミナルを開くか、最小化したターミナルを復元できます。
JavaScript 連携
ダウンロードページで JavaScript 連携を選びます。1 ファイルのインストーラーを展開すると、lil.php の隣に lil.js が作成されます。このスクリプトを共通レイアウトに一度だけ読み込めば、同一オリジンの frame で隣接するターミナルを開けます。
<script src="/lil.js" defer></script>保護された PHP 連携
訪問者がアクセスできるサイトにターミナルを組み込む場合に使う方式です。インストーラーは実際のターミナルを固有の保護ディレクトリへ移動するため、元の公開インストール URL から直接開けなくなります。
インストール後、セットアップページに保護ディレクトリ用の正確な PHP
同じセットアップページに固有の有効化 URL も表示されます。自分のブラウザーで一度開くと、現在のセッションで loader が利用可能になり、token は表示中の URL から取り除かれます。
https://example.com/?lil=<generated-token>有効化 token はターミナルのパスワードではありません。保護された loader を見つけにくくするためのもので、コマンド実行は通常の lil-terminal 認証で引き続き保護されます。
永続履歴は必要なときだけ
フローティングウィンドウを隠すだけなら現在の状態は保持されます。ページ遷移、再読み込み、新しいターミナルウィンドウでもコマンドと安全なテキスト出力を復元したい場合は、
install history
history -l on永続記録は既定で無効です。ログは .lil.log.php に保存され、プロジェクトのパス、データベース行、その他の出力を含む場合があります。サーバーに保存してよい場合にだけ有効にしてください。
Content Security Policy（CSP）
組み込みターミナルはサイトと同じオリジンで動作します。CSP を使用している場合は、選択した連携方式に必要なローカルスクリプトと同一オリジン frame を許可してください。保護された連携は第三者 JavaScript を読み込みません。