Класс Phar

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

    Введение

    Класс Phar предоставляет высокоуровневый интерфейс создания phar-архивов и доступа к ним.

    Обзор класса

    class Phar extends RecursiveDirectoryIterator implements Countable, ArrayAccess {
    /* Наследуемые константы */
    public const int FilesystemIterator::CURRENT_MODE_MASK;
    public const int FilesystemIterator::CURRENT_AS_PATHNAME;
    public const int FilesystemIterator::CURRENT_AS_FILEINFO;
    public const int FilesystemIterator::CURRENT_AS_SELF;
    public const int FilesystemIterator::KEY_MODE_MASK;
    public const int FilesystemIterator::KEY_AS_PATHNAME;
    public const int FilesystemIterator::FOLLOW_SYMLINKS;
    public const int FilesystemIterator::KEY_AS_FILENAME;
    public const int FilesystemIterator::NEW_CURRENT_AND_KEY;
    public const int FilesystemIterator::OTHER_MODE_MASK;
    public const int FilesystemIterator::SKIP_DOTS;
    public const int FilesystemIterator::UNIX_PATHS;
    /* Константы */
    const int BZ2;
    const int GZ;
    const int NONE;
    const int PHAR;
    const int TAR;
    const int ZIP;
    const int COMPRESSED;
    const int PHP;
    const int PHPS;
    const int MD5;
    const int OPENSSL;
    const int OPENSSL_SHA256;
    const int OPENSSL_SHA512;
    const int SHA1;
    const int SHA256;
    const int SHA512;
    /* Методы */
    public __construct(string $filename, int $flags = FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS, ?string $alias = null)
    public addEmptyDir(string $directory): void
    public addFile(string $filename, ?string $localName = null): void
    public addFromString(string $localName, string $contents): void
    final public static apiVersion(): string
    public buildFromDirectory(string $directory, string $pattern = ""): array
    public buildFromIterator(Traversable $iterator, ?string $baseDirectory = null): array
    final public static canCompress(int $compression = 0): bool
    final public static canWrite(): bool
    public compress(int $compression, ?string $extension = null): ?Phar
    public compressFiles(int $compression): void
    public convertToData(?int $format = null, ?int $compression = null, ?string $extension = null): ?PharData
    public convertToExecutable(?int $format = null, ?int $compression = null, ?string $extension = null): ?Phar
    public copy(string $from, string $to): true
    public count(int $mode = COUNT_NORMAL): int
    final public static createDefaultStub(?string $index = null, ?string $webIndex = null): string
    public decompress(?string $extension = null): ?Phar
    public decompressFiles(): true
    public delMetadata(): true
    public delete(string $localName): true
    public extractTo(string $directory, array|string|null $files = null, bool $overwrite = false): bool
    public getAlias(): ?string
    public getMetadata(array $unserializeOptions = []): mixed
    public getModified(): bool
    public getPath(): string
    public getSignature(): array|false
    public getStub(): string
    final public static getSupportedCompression(): array
    final public static getSupportedSignatures(): array
    public getVersion(): string
    public hasMetadata(): bool
    final public static interceptFileFuncs(): void
    public isBuffering(): bool
    public isCompressed(): int|false
    public isFileFormat(int $format): bool
    final public static isValidPharFilename(string $filename, bool $executable = true): bool
    public isWritable(): bool
    final public static loadPhar(string $filename, ?string $alias = null): bool
    final public static mapPhar(?string $alias = null, int $offset = 0): bool
    final public static mount(string $pharPath, string $externalPath): void
    final public static mungServer(array $variables): void
    public offsetExists(string $localName): bool
    public offsetGet(string $localName): SplFileInfo
    public offsetSet(string $localName, resource|string $value): void
    public offsetUnset(string $localName): void
    final public static running(bool $returnPhar = true): string
    public setAlias(string $alias): true
    public setDefaultStub(?string $index = null, ?string $webIndex = null): true
    public setMetadata(mixed $metadata): void
    public setSignatureAlgorithm(int $algo, ?string $privateKey = null): void
    public setStub(resource|string $stub, int $length = -1): bool
    public startBuffering(): void
    public stopBuffering(): void
    final public static unlinkArchive(string $filename): true
    final public static webPhar(
        ?string $alias = null,
        ?string $index = null,
        ?string $fileNotFoundScript = null,
        array $mimeTypes = [],
        ?callable $rewrite = null
    ): void
    public __destruct()
    /* Наследуемые методы */
    public RecursiveDirectoryIterator::getChildren(): RecursiveDirectoryIterator
    public RecursiveDirectoryIterator::getSubPath(): string
    public RecursiveDirectoryIterator::getSubPathname(): string
    public RecursiveDirectoryIterator::hasChildren(bool $allowLinks = false): bool
    public RecursiveDirectoryIterator::key(): string
    public RecursiveDirectoryIterator::next(): void
    public RecursiveDirectoryIterator::rewind(): void
    public FilesystemIterator::current(): string|SplFileInfo|FilesystemIterator
    public FilesystemIterator::getFlags(): int
    public FilesystemIterator::key(): string
    public FilesystemIterator::next(): void
    public FilesystemIterator::rewind(): void
    public FilesystemIterator::setFlags(int $flags): void
    public DirectoryIterator::current(): mixed
    public DirectoryIterator::getBasename(string $suffix = ""): string
    public DirectoryIterator::getExtension(): string
    public DirectoryIterator::getFilename(): string
    public DirectoryIterator::isDot(): bool
    public DirectoryIterator::key(): mixed
    public DirectoryIterator::next(): void
    public DirectoryIterator::rewind(): void
    public DirectoryIterator::seek(int $offset): void
    public DirectoryIterator::__toString(): string
    public DirectoryIterator::valid(): bool
    public SplFileInfo::getATime(): int|false
    public SplFileInfo::getBasename(string $suffix = ""): string
    public SplFileInfo::getCTime(): int|false
    public SplFileInfo::getExtension(): string
    public SplFileInfo::getFileInfo(?string $class = null): SplFileInfo
    public SplFileInfo::getFilename(): string
    public SplFileInfo::getGroup(): int|false
    public SplFileInfo::getInode(): int|false
    public SplFileInfo::getLinkTarget(): string|false
    public SplFileInfo::getMTime(): int|false
    public SplFileInfo::getOwner(): int|false
    public SplFileInfo::getPath(): string
    public SplFileInfo::getPathInfo(?string $class = null): ?SplFileInfo
    public SplFileInfo::getPathname(): string
    public SplFileInfo::getPerms(): int|false
    public SplFileInfo::getRealPath(): string|false
    public SplFileInfo::getSize(): int|false
    public SplFileInfo::getType(): string|false
    public SplFileInfo::isDir(): bool
    public SplFileInfo::isExecutable(): bool
    public SplFileInfo::isFile(): bool
    public SplFileInfo::isLink(): bool
    public SplFileInfo::isReadable(): bool
    public SplFileInfo::isWritable(): bool
    public SplFileInfo::openFile(string $mode = "r", bool $useIncludePath = false, ?resource $context = null): SplFileObject
    public SplFileInfo::setFileClass(string $class = SplFileObject::class): void
    public SplFileInfo::setInfoClass(string $class = SplFileInfo::class): void
    public SplFileInfo::__toString(): string
    }

    Список изменений

    Версия Описание
    8.4.0 Добавлена поддержка модуля меток времени эпохи Unix для архивов на основе Zip.
    8.0.0 Метаданные больше не десериализуются при открытии архива, а откладываются до вызова метода Phar::getMetadata().

    Примечания

    Предостережение

    До PHP 8.0.0 метаданные десериализовались при открытии архива, что могло привести к уязвимостям в безопасности. Начиная с PHP 8.0.0, метаданные десериализуются только при вызове метода Phar::getMetadata(), у которого есть опции для ограничения десериализации из соображений безопасности.

    Содержание

    • Phar::addEmptyDir — Добавляет в phar-архив пустую директорию
    • Phar::addFile — Добавляет в phar-архив файл из файловой системы
    • Phar::addFromString — Добавляет в phar-архив файл из строки
    • Phar::apiVersion — Возвращает версию API
    • Phar::buildFromDirectory — Создаёт phar-архив из файлов, расположенных внутри директории
    • Phar::buildFromIterator — Создаёт phar-архив из итератора
    • Phar::canCompress — Проверяет, поддерживает ли модуль phar сжатие с использованием zlib или bzip2
    • Phar::canWrite — Проверяет, поддерживает ли модуль phar сохранение и создание phar-архивов
    • Phar::compress — Сжимает весь Phar-архив с помощью Gzip- или Bzip2-сжатия
    • Phar::compressFiles — Сжимает все файлы в текущем Phar-архиве
    • Phar::__construct — Создаёт объект Phar-архива
    • Phar::convertToData — Конвертирует phar-архив в неисполняемый tar- или zip-файл
    • Phar::convertToExecutable — Конвертирует phar-архив в другой исполняемый формат файла
    • Phar::copy — Копирует файл внутри phar-архива в новый файл внутри phar-архива
    • Phar::count — Возвращает количество записей (файлов) в Phar-архиве
    • Phar::createDefaultStub — Создать заглушку в формате phar-архива
    • Phar::decompress — Распаковывает весь Phar-архив
    • Phar::decompressFiles — Распаковывает все файлы в текущем Phar-архиве
    • Phar::delMetadata — Удаляет глобальные метаданные в phar-архиве
    • Phar::delete — Удаляет файл в phar-архиве
    • Phar::__destruct — Уничтожает объект архива Phar
    • Phar::extractTo — Извлечь содержимое phar-архива в директорию
    • Phar::getAlias — Получить псевдоним для Phar
    • Phar::getMetadata — Извлечь метаданные phar-архива
    • Phar::getModified — Определить, изменялся phar-архив
    • Phar::getPath — Получить реальный путь к Phar-архиву на диске
    • Phar::getSignature — Получить MD5/SHA1/SHA256/SHA512/OpenSSL подпись Phar-архива
    • Phar::getStub — Получить загрузчик PHP или загрузчик заглушки Phar-архива
    • Phar::getSupportedCompression — Возвращает массив поддерживаемых алгоритмов сжатия
    • Phar::getSupportedSignatures — Получить массив поддерживаемых алгоритмов подписи архива
    • Phar::getVersion — Получить версию Phar-архива
    • Phar::hasMetadata — Проверить, содержит ли phar-архив глобальные метаданные
    • Phar::interceptFileFuncs — Указывает phar перехватывать fopen, file_get_contents, opendir и все stat-функции
    • Phar::isBuffering — Проверить, будут ли операции с Phar-архивом буферизованы или записаны напрямую на диск
    • Phar::isCompressed — Возвращает Phar::GZ или PHAR::BZ2, если phar-архив сжат целиком (.tar.gz/tar.bz и так далее)
    • Phar::isFileFormat — Проверить, что phar-архив имеет заданный формат (tar/phar/zip)
    • Phar::isValidPharFilename — Проверяет, что заданное имя файла является корректным именем phar-архива
    • Phar::isWritable — Проверяет, можно ли модифицировать phar-архив
    • Phar::loadPhar — Загрузить phar-архив с псевдонимом
    • Phar::mapPhar — Прочитать текущий запущенный phar-архив и зарегистрировать его манифест
    • Phar::mount — Монтирование внешнего путь или файла к виртуальному пути в phar-архиве
    • Phar::mungServer — Определить список до четырёх $_SERVER-переменных, которые должны быть изменены для запуска
    • Phar::offsetExists — Определить, есть ли файл в архиве
    • Phar::offsetGet — Получить объект PharFileInfo для конкретного файла
    • Phar::offsetSet — Изменение содержимого файла
    • Phar::offsetUnset — Удалить файл из phar-архива
    • Phar::running — Получить полный путь на диске, либо полный URL запущенного Phar-архива
    • Phar::setAlias — Установить псевдоним для Phar-архива
    • Phar::setDefaultStub — Установить загрузчик PHP или начальную заглушку Phar-архива в загрузчик по умолчанию
    • Phar::setMetadata — Установить метаданные phar-архива
    • Phar::setSignatureAlgorithm — Установить алгоритм подписания phar-архива и применение его
    • Phar::setStub — Установить загрузчик или загрузочную заглушку в Phar-архив
    • Phar::startBuffering — Запускает буферизацию операций записи, отключая запись изменений Phar-архива на диск
    • Phar::stopBuffering — Останавливает буферизацию и записывает все изменения на диск
    • Phar::unlinkArchive — Удаляет архив из памяти и с диска
    • Phar::webPhar — Направляет запрос из браузера во внутренний файл в phar-архиве

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей

    Пользователи ещё не добавляли примечания для страницы
    To Top