untarBinaryHandles.php
Table of Contents
Functions
- untarBinaryHandles() : bool
- Whether the system `tar` can extract this archive here.
Functions
untarBinaryHandles()
Whether the system `tar` can extract this archive here.
untarBinaryHandles(string $tarFile) : bool
Two conditions, and the second is the one that is easy to forget: tar does not
decompress anything itself. It pipes through gzip or bzip2, so a host with
ext-zlib and no gzip program has a perfectly good GNU tar that cannot open a
.tar.gz. PharData, which decompresses through the PHP extensions, can — which is
why the fallback exists and why this question is asked before anything is extracted.
The binary itself comes from tarBinary(), which accepts GNU tar only, having
run it to ask. OIHANA_TAR_BINARY declared empty forces false here, which is the
seam the tests use to run the whole extraction suite through PharData on a machine
that has a usable tar.
Parameters
- $tarFile : string
-
Path to the archive.
Tags
Return values
bool —True when untarWithBinary() can be used on it.