Detaillierte Erläuterung des Konzepts und der Verwendung der Phar-Datei im Archivformat für die PHP-Entwicklung-PHP-Tutorial-php.cn

Eine PHP-Anwendung besteht oft aus mehreren Dateien, um sie zu verteilen und auszuführen. Es gibt viele solcher Beispiele, wie zum Beispiel die Installation auf einem Windows-Betriebssystem. eine JQuery-Bibliothek usw. Um dies zu erreichen, verwendet PHP das Phar-Dokumentdateiformat. Dieses Konzept ist vom JAR von Java abgeleitet, wurde aber hauptsächlich für entwickelt Die Webumgebung von PHP kann im Gegensatz zu JAR-Archiven Phar-Archive sein Wird nativ gehandhabt, sodass zum Erstellen oder Verwenden keine zusätzlichen Tools erforderlich sind. Verwenden Sie einfach ein PHP-Skript zum Erstellen oder Extrahieren. phar ist ein zusammengesetztes Wort aus PHP und Archivzusammensetzung, Sie können sehen, dass es sich um eine PHP-Archivdatei handelt.

Die offizielle Website-Dokumentation von phar finden Sie unter http://php.net/manual/zh/book.phar.php. Dieses Dokument kann als Ergänzung zur offiziellen Website-Dokumentation angesehen werden

Es gibt drei Formate von Phar-Archivdateien: TAR-Archiv, Zip-Archiv und Phar-Archiv. Die ersten beiden Ausführungsarten erfordern die Installation der Phar-Erweiterungsunterstützung und werden hier hauptsächlich verwendet Phar-Archivformat.

Die Archivdatei im Phar-Format kann direkt ausgeführt werden. Ihre Generierung hängt von der Phar-Erweiterung ab und wird von einem von Ihnen selbst geschriebenen PHP-Skript generiert.

Die Phar-Erweiterung ist kein neues Konzept für PHP. Sie wurde ursprünglich in PHP 5.3 geschrieben und benannt PHP_Archive wurde dann 2005 zur PEAR-Bibliothek hinzugefügt. Da reine PHP-Lösungen für dieses Problem in der Praxis sehr langsam sind, 2007 Als reine C-Spracherweiterung neu geschrieben und ArrayAccess-Objektdurchquerung mit SPL Phar hinzugefügt Archivierungsunterstützung. Seitdem wurde viel daran gearbeitet, die Leistung der Phar-Archive zu verbessern.

Die Phar-Erweiterung hängt vom PHP-Stream-Wrapper ab. Weitere Informationen finden Sie im vorherigen Artikel „PHP-Streams und Wrapper-Wrapper-Konzepte und Anwendungsbeispiele“

Viele PHP-Anwendungen werden im Phar-Format verteilt und ausgeführt. Zu den bekanntesten gehören das Abhängigkeitsmanagement: Composer und Unit Testing: PHPUnit.

Phar-Dateierstellung:

Ändern Sie zunächst die Option phar.readonly in php.ini, entfernen Sie das vorangehende Semikolon und ändern Sie den Wert auf „off“. Aus Sicherheitsgründen ist diese Option standardmäßig auf „on“ gesetzt (der Wert ist 0 oder off). ), dann kann es im Benutzerskript aktiviert oder deaktiviert werden. Wenn es in php.ini aktiviert ist, kann das Benutzerskript nicht deaktiviert werden, daher ist es hier auf „Aus“ gesetzt, um das Beispiel zu zeigen.

Erstellen wir ein Projekt. Erstellen Sie einen Projektordner im Stammverzeichnis des Servers als Projekt. Die Struktur im Verzeichnis ist wie folgt:

file
  -yunek.js
  -yunke.css
lib
  -lib_a.php
template
  -msg.html
index.php
Lib.php

Nach dem Login kopieren

Der Dateiordner enthält zwei JS- und CSS-Dateien mit leerem Inhalt. Dies zeigt nur, dass Phar mehrere Dateiformate enthalten kann

Der Inhalt von lib_a.php lautet wie folgt:

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/10
 * Time: 9:23
 */
function show(){
  echo "l am show()";
}

Nach dem Login kopieren

Der Inhalt von msg.html lautet wie folgt:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>phar</title>
</head>
<body>
<?=$str; ?>
</body>
</html>

Nach dem Login kopieren

Der Inhalt von index.php lautet wie folgt:

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/10
 * Time: 9:17
 */
require "lib/lib_a.php";
show();
$str = isset($_GET["str"]) ? $_GET["str"] : "hello world";
include "template/msg.html";

Nach dem Login kopieren

Der Inhalt von Lib.php lautet wie folgt:

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/10
 * Time: 9:20
 */
function yunke()
{
  echo "l am yunke()";
}

Nach dem Login kopieren

Die Projektdatei ist fertig. Erstellen Sie nun eine yunkeBuild.php im selben Verzeichnis wie der Projektordner, der zum Generieren von Dateien im Phar-Format verwendet wird:

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/10
 * Time: 9:36
 */
//产生一个yunke.phar文件
$phar = new Phar(&#39;yunke.phar&#39;, 0, &#39;yunke.phar&#39;);
// 添加project里面的所有文件到yunke.phar归档文件
$phar->buildFromDirectory(dirname(__FILE__) . &#39;/project&#39;);
//设置执行时的入口文件，第一个用于命令行，第二个用于浏览器访问，这里都设置为index.php
$phar->setDefaultStub(&#39;index.php&#39;, &#39;index.php&#39;);

Nach dem Login kopieren

Greifen Sie dann im Browser auf diese yunkeBuild.php-Datei zu. Zu diesem Zeitpunkt lautet die Server-Stammverzeichnisstruktur wie folgt:

project
yunkeBuild.php
yunke.phar

Nach dem Login kopieren

Dies ist der einfachste Prozess zum Generieren einer Phar-Archivdatei. Weitere Informationen finden Sie auf der offiziellen Website. Bitte beachten Sie, dass die Verwendung der Phar-Archivdatei < nicht sinnvoll ist 🎜>

Verwendung von Phar-Archivdateien:

Wir erstellen eine index.php-Datei im Stammverzeichnis des Servers, um zu demonstrieren, wie die oben erstellte Phar-Datei verwendet wird. Der Inhalt lautet wie folgt:

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/8
 * Time: 9:33
 */
require "yunke.phar";
require "phar://yunke.phar/Lib.php";
yunke();

Nach dem Login kopieren

Wenn in der Datei index.php nur die erste Zeile vorhanden ist, fügen Sie den folgenden Code genau so hinzu, wie wenn Sie keine Archivdatei verwenden:

require "project/index.php";

Nach dem Login kopieren

Wenn keine zweite Zeile vorhanden ist, zeigt yunke() in der dritten Zeile an, dass sie nicht definiert ist, sodass ersichtlich ist, dass bei der Anforderung einer Phar-Datei nicht alle darin enthaltenen Dateien importiert werden, sondern nur die Eintragsausführungsdatei In tatsächlichen Projekten müssen jedoch häufig andere Dateien in dieser Eintragsdatei verwendet werden. In diesem Beispiel lautet die Eintragsausführungsdatei project/index.php

Extrahierung und Wiederherstellung von Phar-Dateien:

Manchmal sind wir neugierig auf den Quellcode der in der Phar-Datei enthaltenen Dateien. Wenn wir nur einen Blick darauf werfen, können wir einige IDE-Tools wie PHPstorm verwenden 10, Sie können es direkt öffnen, indem Sie es zur Demonstration extrahieren. Laden Sie es in das Serververzeichnis herunter und erstellen Sie eine get.php-Datei im Stammverzeichnis folgender Inhalt:

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/9
 * Time: 19:02
 */
$phar = new Phar(&#39;composer.phar&#39;);
$phar->extractTo(&#39;composer&#39;); //提取一份原项目文件
$phar->convertToData(Phar::ZIP); //另外再提取一份，和上行二选一即可

Nach dem Login kopieren

用浏览器访问这个文件，即可提取出来，以上列子展示了两种提取方式：第二行将建立一个composer目录，并将提取出来的内容放入，第三行将产生一个composer.zip文件，解压即可得到提取还原的项目文件。

补充：

1、在部署phar文件到生产服务器时需要调整服务器的配置，避免当访问时浏览器直接下载phar文件

2、可以为归档设置别名，别名保存在归档文件中永久保存，它可以用一个简短的名字引用归档，而不管归档文件在文件系统中存储在那里，设置别名：

$phar = new Phar(&#39;lib/yunke.phar&#39;, 0);
$phar->setAlias ( "yun.phar");

Nach dem Login kopieren

设置别名后可以如下使用：

<?php
require "lib/yunke.phar";
require "phar://yun.phar/Lib.php"; //使用别名访问归档文件
require "phar://lib/yunke.phar/Lib.php"; //当然仍然可以使用这样的方式去引用

Nach dem Login kopieren

如果在制作phar文件时没有指定别名，也可以在存根文件里面使用Phar::mapPhar('yunke.phar');指定

3、归档文件中有一个存根文件，其实就是一段php执行代码，在制作归档时可以设置，直接执行归档文件时，其实就是执行它，所以它是启动文件；在脚本中包含归档文件时就像包含普通php文件一样包含它并运行，但直接以phar://的方式包含归档中某一个文件时不会执行存根代码，往往在存根文件里面require包含要运行的其他文件，对存根文件的限制仅为以__HALT_COMPILER();结束，默认的存根设计是为在没有phar扩展时能够运行，它提取phar文件内容到一个临时目录再执行，不过从php5.3开始该扩展默认内置启用了

4、制作的phar文件不能被改动，因此配置文件之类的文件需要另外放置在归档文件外面

5、mapPhar函数：这个函数只应该在stub存根代码中调用，在没有设置归档别名的时候可以用来设置别名，打开一个引用映射到phar流。

大家学会了吗？