Home/ Manual/ phar / Phar/ Phar::addFile

Phar::addFile

PHP function Edit on GitHub ✎

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Add a file from the filesystem to the phar archive

Description

Phar::addFile(string $filename, string|null $localName = null): void

Write

With this method, any file or URL can be added to the phar archive. If the optional second parameter localName is a String, the file will be stored in the archive with that name, otherwise the file parameter is used as the path to store within the archive. URLs must have a localname or an exception is thrown. This method is similar to ZipArchive::addFile().

Parameters

filename: Full or relative path to a file on disk to be added to the phar archive.
localName: Path that the file will be stored in the archive.

Return Values

no return value, exception is thrown on failure.

Changelog

Version	Description
8.0.0	`localName` is now nullable.

Examples

A Phar::addFile() example

php

<?php
try {
    $a = new Phar('/path/to/phar.phar');

    $a->addFile('/full/path/to/file');
    // demonstrates how this file is stored
    $b = $a['full/path/to/file']->getContent();

    $a->addFile('/full/path/to/file', 'my/file.txt');
    $c = $a['my/file.txt']->getContent();

    // demonstrate URL usage
    $a->addFile('http://www.example.com', 'example.html');
} catch (Exception $e) {
    // handle errors here
}
?>