tar

tar は非圧縮 TAR アーカイブを PHP だけで作成、一覧、テスト、展開し、パストラバーサル、リンク、安全でないエントリを拒否します。

アーカイブバージョン 1.1.4安定版
lil-terminal

概要

圧縮せずにファイルツリーを一つの可搬ファイルへまとめたいときに TAR を使います。デプロイ、バックアップ、受け渡しに向きます。-l で内容を確認し、-t で検証し、既存出力の置換は -f で明示します。

TAR はコンテナであり圧縮ではない

TAR はディレクトリツリーを一つのファイルへ格納しますが、内容そのものは圧縮しません。-d はアーカイブ作成が成功した後だけ元データの削除を del に委ねるため、作成と削除は別の操作のままです。

構文

lil-terminal
tar <src|arc.tar> [dst] [options]

リファレンス

tar <src> [dst]

非圧縮 TAR アーカイブを作成

tar <arc.tar> [dst]

現在のディレクトリまたは <dst> に展開

-l

展開せず内容を一覧表示

-t

パス、ヘッダー、ファイルデータを検証

-f

アーカイブまたは既存の展開先ファイルを置換

-d @del

アーカイブ作成成功後にコピー元を削除

アーカイブの安全性

-l は内容だけを読み、-t は展開せずヘッダー、チェックサム、パス、データを検証します。絶対パス、..、リンクは拒否します。-d は作成成功後にだけ del を使って元を削除します。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

非圧縮 TAR アーカイブを作成

インストールと管理

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

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

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install tar
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install tar -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install tar -v 1.1.4
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade tar
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install tar -u

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

非圧縮 TAR アーカイブを作成
cd \sandbox | tar data tmp/data.tar | tar tmp/data.tar -t
Status   Archive OK
Entries  3
Files    2
Size     7.7 KB
Tar · list
tar tmp/data.tar -l
D  -       data/
F  1.2 KB  data/sample.txt
F  6.5 KB  data/users.json
現在のディレクトリまたは <dst> に展開
tar tmp/data.tar tmp/unpacked
extracted  sandbox/tmp/unpacked/data/
files      2
Tar · force
tar data tmp/data.tar -f
created  sandbox/tmp/data.tar
replace  explicit
Tar · txt
tar tmp/draft.txt tmp/draft.tar -d
created  sandbox/tmp/data.tar
source   deleted after successful archive creation
非圧縮 TAR アーカイブを作成
tar missing tmp/missing.tar
created  sandbox/tmp/data.tar
files    2

この例で使うファイル: sandbox/data/sample.txt

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

lil-terminal sandbox text file

This file is safe to read, copy, rename, replace, hash and archive.

関連ドキュメント

現在の公開版

v1.1.42026-08-13

コンパクトな TAR オプション

主要なアーカイブ操作を上に残し、操作オプションを下にまとめます。