PHP: PharData::addFromString - Manual (original) (raw)

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

PharData::addFromString — Add a file from a string to the tar/zip archive

Description

public PharData::addFromString(string $localName, string $contents): void

With this method, any string can be added to the tar/zip archive. The file will be stored in the archive with localname as its path. This method is similar to ZipArchive::addFromString().

Parameters

localName

Path that the file will be stored in the archive.

contents

The file contents to store

Return Values

no return value, exception is thrown on failure.

Examples

Example #1 A PharData::addFromString() example

<?php try { <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>a</mi><mo>=</mo><mi>n</mi><mi>e</mi><mi>w</mi><mi>P</mi><mi>h</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi><msup><mo stretchy="false">(</mo><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><mi mathvariant="normal">/</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>h</mi><mi mathvariant="normal">/</mi><mi>t</mi><mi>o</mi><mi mathvariant="normal">/</mi><mi>m</mi><mi>y</mi><mi mathvariant="normal">.</mi><mi>t</mi><mi>a</mi><msup><mi>r</mi><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><mo stretchy="false">)</mo><mo separator="true">;</mo></mrow><annotation encoding="application/x-tex">a = new PharData('/path/to/my.tar');</annotation></semantics></math>a=newPharData(′/path/to/my.tar′);a->addFromString('path/to/file.txt', 'my simple file'); <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>b</mi><mo>=</mo></mrow><annotation encoding="application/x-tex">b = </annotation></semantics></math>b=a['path/to/file.txt']->getContent();// to add contents from a stream handle for large files, use offsetSet() $c = fopen('/path/to/hugefile.bin'); <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>a</mi><msup><mo stretchy="false">[</mo><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><mi>l</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi mathvariant="normal">.</mi><mi>b</mi><mi>i</mi><msup><mi>n</mi><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><mo stretchy="false">]</mo><mo>=</mo></mrow><annotation encoding="application/x-tex">a['largefile.bin'] = </annotation></semantics></math>a[′largefile.bin′]=c; fclose($c); } catch (Exception $e) { // handle errors here } ?>

Found A Problem?