tar

tar 完全用 PHP 创建、列出、测试和解压未压缩 TAR,并拒绝路径穿越、链接和其他不安全的归档条目。

归档版本 1.1.5稳定
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>

打包但不压缩

tar 将文件和目录合并为一个 .tar,但不压缩内容。适合备份和迁移;如需缩小体积,请用 zip。

解包前检查

-l 列出条目,-t 检查路径和文件数据且不会写入磁盘。tar tmp/data.tar tmp/restored 解包到目标文件夹。

覆盖与删除源文件

-f 明确允许替换现有文件。-d 只有在打包成功后才调用独立的 del 模块。

安全边界

绝对路径、..、链接和不支持的条目会被拒绝。需要 PHP PharData。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示;服务器不会执行任何终端命令。

创建未压缩 TAR 归档

安装与管理

安装当前兼容版本。完整功能请选择 Base,精简包请选择 Minimum;已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install tar
Minimum 包

安装精简包。该包不包含本地参考;help <cmd> -i 会打开当前服务器参考。

install tar -m
精确公开版本

安装这个确切的已发布版本。

install tar -v 1.1.5
检查或升级

让 upgrade 检查兼容性,仅在需要时替换已安装块。

upgrade tar
删除模块

删除扩展块,不影响核心和其他模块。

install tar -u

示例

示例可复制,但网站不会执行。请先检查路径、权限和破坏性选项。

创建未压缩 TAR 归档
cd \sandbox | tar data tmp/data.tar
sandbox

README.txt
current.txt
data.tar
data.zip
draft.txt
new.txt
Tar · list
tar tmp/data.tar -l
D  -      data/
F  59 B   data/sample.csv
F  100 B  data/sample.txt
F  102 B  data/users.json
Tar · test
tar tmp/data.tar -t
Status   Archive OK
Entries  4
Files    3
Size     261 B
解压到当前目录或 <dst>
tar tmp/data.tar tmp/restored
restored/
  data/
    sample.csv
    sample.txt
    users.json
创建未压缩 TAR 归档
tar data tmp/data.tar
Archive already exists
Tar · data
tar data tmp/data.tar -f
README.txt
current.txt
data.tar
data.zip
draft.txt
new.txt
Tar · txt
tar tmp/draft.txt tmp/draft.tar -d
README.txt
current.txt
data.tar
data.zip
draft.tar
new.txt
(source draft.txt removed only after successful creation)
Tar · tar
tar tmp/data.tar -l -t
?
创建未压缩 TAR 归档
tar missing tmp/missing.tar
Source not found

本示例使用的文件: sandbox/data/sample.txt

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

lil-terminal sandbox text file

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

相关文档

当前公开版本

v1.1.52026-10-31

替换 TAR 文件时,旧文件会保留到新文件准备就绪。

替换 TAR 文件时,旧文件会保留到新文件准备就绪。