phar打包

phar是PHP裡類似於JAR的一種打包檔案,你可以利用phar將你的webman專案打包成單個phar檔案,方便部署。

這裡非常感謝 fuzqing 的PR.

注意
需要關閉php.ini的phar配置選項,即設置 phar.readonly = 0

安裝命令行工具

composer require webman/console

打包

在webman專案根目錄執行命令 php webman build:phar
會在bulid目錄生成一個webman.phar檔案。

打包相關配置在 config/plugin/webman/console/app.php

啟動停止相關命令

啟動
php webman.phar startphp webman.phar start -d

停止
php webman.phar stop

查看狀態
php webman.phar status

查看連接狀態
php webman.phar connections

重啟
php webman.phar restartphp webman.phar restart -d

說明

  • 打包後的專案不支持reload,更新代碼需要restart重啟

  • 為了避免打包檔案尺寸過大佔用過多記憶體,可以設置 config/plugin/webman/console/app.php裡的exclude_pattern exclude_files選項將排除不必要的檔案。

  • 執行webman.phar後會在webman.phar所在目錄生成runtime目錄,用於存放日誌等臨時檔案。

  • 如果你的專案裡使用了.env檔案,需要將.env檔案放在webman.phar所在目錄。

  • 切勿將用戶上傳的檔案存儲在phar包中,因為以phar://協定操作用戶上傳的檔案是非常危險的(phar反序列化漏洞)。用戶上傳的檔案必須單獨存儲在phar包之外的磁碟中,參見下面。

  • 如果你的業務需要上傳檔案到public目錄,需要將public目錄獨立出來放在webman.phar所在目錄,這時候需要配置config/app.php

    'public_path' => base_path(false) . DIRECTORY_SEPARATOR . 'public',

    業務可以使用助手函數public_path($檔案相對位置)找到實際的public目錄位置。

  • 注意webman.phar不支持在windows下開啟自定義進程