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 start 或 php webman.phar start -d

停止
php webman.phar stop

查看状态
php webman.phar status

查看连接状态
php webman.phar connections

重启
php webman.phar restart 或 php 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 下开启自定义进程