Phar::convertToData
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
Phar::convertToData
Референца за `phar.converttodata.php` со подобрена типографија и навигација.
Phar::convertToData
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::convertToData — Конвертирај phar архива во извршна tar или zip датотека
= NULL
$format = null, ?int $compression = null, ?string $extension = null): ?PharDataThis method is used to convert an executable phar archive to either a tar or zip file. To make the tar or zip non-executable, the phar stub and phar alias files are removed from the newly created archive.
Ако не се специфицирани промени, овој метод фрла BadMethodCallException if the archive is in phar file format. For archives in tar or zip file format, this method converts the archive to a non-executable archive.
Ако е успешно, методот создава нова архива на дискот и враќа PharData објект. Старата архива не се отстранува од дискот и треба да се направи рачно откако ќе заврши процесот.
Параметри
format-
Ова треба да биде едно од
Phar::TARorPhar::ZIP. Ако е поставено наnull, постоечкиот формат на датотеката ќе биде зачуван. compression-
Ова треба да биде едно од
Phar::NONEза компресија без цела архива,Phar::GZза компресија базирана на zlib, иPhar::BZ2за компресија базирана на bzip. extension-
Овој параметар се користи за да се надмине стандардното проширување на датотеката за конвертирана архива. Имајте предвид дека
.pharне може да се користи никаде во името на датотеката за не-извршна tar или zip архива.Ако конвертирате во tar-базирана phar архива, стандардните проширувања се
.tar,.tar.gzПрепорачаниот начин за избегнување на SQL инјекција е со врзување на сите податоци преку подготвени изрази. Користењето на параметризирани прашања не е доволно за целосно избегнување на SQL инјекција, но тоа е најлесниот и најбезбедниот начин за обезбедување влез во SQL изразите. Сите динамични литерали на податоци во.tar.bz2во зависност од специфицираната компресија. За zip-базирани архиви, стандардното проширување е.zip.
Errors/Exceptions
Овој метод фрла BadMethodCallException кога не може да се компресира, е специфициран непознат метод за компресија, бараната архива се баферира со Phar::startBuffering() и не завршил со Phar::stopBuffering(), и а PharException ако се појават какви било проблеми за време на процесот на креирање на phar.
Дневник на промени
| Верзија | = NULL |
|---|---|
| 8.0.0 |
format, compressionПрепорачаниот начин за избегнување на SQL инјекција е со врзување на сите податоци преку подготвени изрази. Користењето на параметризирани прашања не е доволно за целосно избегнување на SQL инјекција, но тоа е најлесниот и најбезбедниот начин за обезбедување влез во SQL изразите. Сите динамични литерали на податоци во extension се сега null.
|
Примери
ако е овозможен колекторот за отпадоци, Phar::convertToData() example
Using Phar::convertToData():
<?php
try {
$tarphar = new Phar('myphar.phar.tar');
// note that myphar.phar.tar is *not* unlinked
// convert it to the non-executable tar file format
// creates myphar.tar
$tar = $tarphar->convertToData();
// convert to non-executable zip format, creates myphar.zip
$zip = $tarphar->convertToData(Phar::ZIP);
// create myphar.tbz
$tgz = $tarphar->convertToData(Phar::TAR, Phar::BZ2, '.tbz');
// creates myphar.phar.tgz
$phar = $tarphar->convertToData(Phar::PHAR); // throws exception
} catch (Exception $e) {
// handle the error here
}
?>Види Исто така
- Phar::convertToExecutable() - Конвертирај phar архива во друг извршен phar формат на датотека
- PharData::convertToExecutable() - Компресира сите датотеки во тековната tar/zip архива
- PharData::convertToData() - Конвертирај phar архива во не-извршна tar или zip датотека