Skip to content

options.md

Latest commit

 

History

History
188 lines (132 loc) · 4.02 KB

options.md

File metadata and controls

188 lines (132 loc) · 4.02 KB
Raw

预处理参数

  • + 开启扩展
  • - 关闭扩展
  • @ 设置操作系统
  • -- 参数设置

示例：

./prepare.php --without-docker -mongodb --with-brotli=yes @linux

参数设置也可以使用环境变量来代替，格式为 SWOOLE_CLI_{$option} ，需要将参数的中横线-替换为下划线_，例如：

./prepare.php --without-docker --skip-download=1

也可以写作：

SWOOLE_CLI_SKIP_DOWNLOAD=yes ./prepare.php --without-docker

参数设置优先于环境变量，当同时使用相同名称的参数设置和环境变量时，环境变量将被忽略，仅参数设置生效，例如： SWOOLE_CLI_SKIP_DOWNLOAD=yes ./prepare.php --skip-download=no ，有效的值为：--skip-download=no，环境变量 SWOOLE_CLI_SKIP_DOWNLOAD=yes 无效

skip-download

跳过下载依赖库

会自动生成，待下载链接地址

链接地址文件位于 项目根目录下的 var/download-box/ 目录

依赖 aria2

./prepare.php --skip-download=yes --without-docker

# 构建依赖库之前，批量下载依赖库和扩展的脚本
sh sapi/scripts/download-dependencies-use-aria2.sh

with-download-mirror-url

使用镜像地址下载依赖库源码

使用镜像地址下载前，需要准备镜像服务

例如：sh sapi/scripts/download-box/web-server-nginx.sh

# 演示例子
./prepare.php --without-docker --with-download-mirror-url=http://127.0.0.1:9503

#  下载方式一 （逐个下载源码包）
./prepare.php --without-docker --with-download-mirror-url=https://swoole-cli.jingjingxyk.com/


#  下载方式二 （多个源码包整合为一个压缩文件）
sh  sapi/download-box/download-box-get-archive-from-server.sh

#  下载方式三 （使用容器分发）
sh  sapi/download-box/download-box-get-archive-from-container.sh

conf-path

指定额外的扩展定义文件目录（目录内为返回 SwooleCli\Preprocessor 回调的 PHP 文件）。 默认加载内置目录 sapi/src/builder/extension/ 下的扩展定义；如需追加自定义扩展，可设置此参数。 多个目录使用:冒号分割。

./prepare.php --conf-path="/tmp/swoole-cli/conf1:/tmp/swoole-cli/conf2"

without-docker

直接在宿主机中构建，不使用 docker

在 macOS 系统无法使用 docker，需指定此参数

with-global-prefix

设置依赖库安装目录前缀 默认安装目录前缀： /usr/local/swoole-cli/

./prepare.php --with-global-prefix=/usr/local/swoole-cli/

with-dependency-graph

生成扩展依赖图

依赖 graphviz

# macos
brew install graphviz
# debian
apt install -y graphviz
# alpine
apk add graphviz

生成扩展依赖库 图 步骤

# 生成扩展依赖图模板
php ./prepare.php --without-docker --with-dependency-graph=1

# 生成扩展依赖图
sh sapi/scripts/generate-dependency-graph.sh

with-dependency-json

导出当前构建配置的依赖关系为 JSON，供 sapi/deps-viewer 生成交互式依赖图网页

导出内容包含库与扩展的依赖关系、版本、开源许可证。

php ./prepare.php --with-dependency-json=1

# 产物
#   bin/dependency-graph.json

生成网页见 构建依赖可视化工具教程

with-downloader

指定 wget 作为下载器 （默认使用curl 作为依赖库和扩展的下载器）

php ./prepare.php --with-downloader=wget

with-swoole-pgsql

swoole 启用 --enable-swoole-pgsql

php ./prepare.php --with-swoole-pgsql=1

with-parallel-jobs

构建时最大并发进程数； 默认值是 CPU 逻辑处理器数

php ./prepare.php --with-parallel-jobs=8

with-build-type

构建类型，默认是 release 可选项： release debug dev

show-tarball-hash

计算并显示已下载的源码包 HASH 值

with-libavif

GD库支持 AVIF图片格式

with-iouring

swoole 启用支持 iouring 特性

with-static-pie

linux 环境下启用 static-pie