PHP 8.5.0 Alpha 1 available for testing

Phar::__construct

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

Phar::__constructConstruye un objeto de archivo Phar

Descripción

public Phar::__construct(string $filename, int $flags = FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS, ?string $alias = null)

Parámetros

filename

La ruta hacia un archivo Phar existente o a crear. El nombre del fichero debe contener la extensión .phar.

flags

Los flags a pasar a la clase padre RecursiveDirectoryIterator.

alias

Alias con el cual se debe hacer referencia al archivo al llamar a las funcionalidades de flujo.

Errores/Excepciones

Levanta una excepción BadMethodCallException si el método es llamado dos veces, o UnexpectedValueException si el archivo no puede ser abierto.

Ejemplos

Ejemplo #1 Un ejemplo con Phar::__construct()

<?php
try {
$p = new Phar('/path/to/my.phar', FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::KEY_AS_FILENAME,
'mon.phar');
} catch (
UnexpectedValueException $e) {
die(
'No puede abrir mon.phar');
} catch (
BadMethodCallException $e) {
echo
'técnicamente, esto no puede ocurrir';
}
// ahora funciona
echo file_get_contents('phar://mon.phar/ejemplo.txt');
// y funciona como si hubiéramos escrito
echo file_get_contents('phar:///ruta/al/mon.phar/ejemplo.txt');
?>

add a note

User Contributed Notes 2 notes

up
1
myselfasunder at findmenow dot gmail dot com
14 years ago
Zip support seems to be shaky, in that just attempting to open a Zip file (created by 7-Zip) with both the 'zlib' and 'zip' extensions enabled renders the following error:

Error: Cannot convert phar archive "C:/Development/webdir/public_html/TestPhar.zip", unable to open entry "TestPhar/" contents: phar error: internal corruption of zip-based phar "C:/Development/webdir/public_html/TestPhar.zip" (local header of file "TestPhar/" does not match central directory)

Stick to GZ's and BZ2's (but don't forget to enable the BZ2 extension if necessary).

Phar can ONLY open executable Phar's and PharData can ONLY open non-executable Phar's. Both have the ability to convert between the two formats.

However, you can reference a file within a Phar regardless of whether it's executable using the Phar stream wrapper (file_get_contents('phar://<Phar file>/subdirectory/subdirectory/somefile.txt')).

Dustin Oprea
up
0
Christian
15 years ago
It's not possible to create a new archive when safe_mode is enabled! You simply return a 'Phar creation or opening failed' error.
This applies to Phar and PharData in PHP 5.3.2.
To Top