產生「Phar」專案
主題
相關文件
| 相關文件 |
|---|
| PHP / Phar |
| PHP / Phar file stub |
| PHP / Phar::mapPhar |
| PHP / Supported Protocols and Wrappers |
| PHP / phar:// |
| PHP / List of php.ini directives |
| PHP / Phar / Runtime Configuration / phar.readonly |
範例
| 範例 |
|---|
| basic / phar-project |
| symfony / phar-project |
概略說明
參考專案
參考下面兩個專案，實作了「產生phar的專案」。
我寫了好幾個範例，可以參考上面的「範例」連結。
編譯成「phar」的實作程式碼，主要放在專案的「sys/src/Maintain/Compiler.php」
關於「phar」進入點
關於「stub」的內容，可以閱讀「PHP / Phar file stub」。
關於「phar」進入點，要觀看在「
stub」那裡的「程式碼片段」如下。
$stub = sprintf(<<<EOF
#!/usr/bin/env php
<?php
Phar::mapPhar('%s');
define('THE_PRJ_ROOT_DIR_PATH', 'phar://%s');
define('THE_BUILD_TIMESTAMP', '%s');
define('THE_APP_FILE_PATH', realpath(__FILE__));
require_once(THE_PRJ_ROOT_DIR_PATH . '/boot/start/main.php');
__HALT_COMPILER(); ?>
EOF, $target_phar_file_name, $target_phar_file_name, time());
上面的片段，最後可以在「demo.phar」檔案開頭看到。
舉例：可以使用「less demo.phar」觀看「phar檔」的內容。
#!/usr/bin/env php
<?php
Phar::mapPhar('demo.phar');
define('THE_PRJ_ROOT_DIR_PATH', 'phar://demo.phar');
define('THE_BUILD_TIMESTAMP', '1721301058');
define('THE_APP_FILE_PATH', realpath(__FILE__));
require_once(THE_PRJ_ROOT_DIR_PATH . '/boot/start/main.php');
__HALT_COMPILER(); ?>
關於「phar」進入點，關鍵的部份，在於下面三行。
Phar::mapPhar('demo.phar');
define('THE_PRJ_ROOT_DIR_PATH', 'phar://demo.phar');
require_once(THE_PRJ_ROOT_DIR_PATH . '/boot/start/main.php');
上面三行，也可以看作是如下的兩行「程式片段」。
Phar::mapPhar('demo.phar');
require_once('phar://demo.phar/boot/start/main.php');
也就是會載入「demo.phar」裡面的「boot/start/main.php」。
對照沒有打包成「phar」的「app.php」。
也是載入專案的「boot/start/main.php」。
注意事項
關於「phar.readonly」
要產生「demo.phar」，需要設定「
phar.readonly = Off」，才能正常運作。
編輯「/etc/php.ini」這個檔案。
[Phar]
; https://php.net/phar.readonly
;phar.readonly = On
phar.readonly = Off
可以閱讀「官方文件」的說明。
在「__HALT_COMPILER();」和「?>」之間，保持「一個空白」
在「PHP / Phar file stub」這篇，有如下的一段注意事項
There are no restrictions on the contents of a Phar stub, except for the requirement that it conclude with __HALT_COMPILER();. The closing PHP tag
?>
may be included or omitted, but there can be no more than 1 space between the ; and the close tag
?>
or the phar extension will be unable to process the Phar archive's manifest.
關於「stub」可以有「?>(PHP Close Tag)」，也可以沒有。
若是要加上「?>」，則是要保持「__HALT_COMPILER();」和「?>」之間有「一個空白」。
我測試的經驗，若是「斷行」，編譯過程會幫我們校正，最後也是保持「一個空白」。
不過為了保險起見，我們還是遵照規範，保持「一個空白」的寫法。