diff --git a/README-en.md b/README-en.md index 10ac539a..19768529 100755 --- a/README-en.md +++ b/README-en.md @@ -3,7 +3,7 @@ Compile A Statically Linked PHP With Swoole and other Extensions. BTW, It's only for CLI mode. -[![version](https://img.shields.io/badge/version-1.5.1-green.svg)]() +[![version](https://img.shields.io/badge/version-1.6.0-green.svg)]() ![Build Actions](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build-php.yml/badge.svg) ## Compilation Requirements @@ -55,18 +55,21 @@ Here's help command to compile it yourself: ```bash git clone https://github.com/crazywhalecc/static-php-cli.git cd static-php-cli/docker -docker build -t static-php . --build-arg USE_BACKUP_ADDRESS=yes --build-arg COMPILE_PHP_VERSION=7.4.29 +docker build -t static-php . --build-arg USE_BACKUP_ADDRESS=yes +# Making a directory to put binary files +mkdir dist +# It will ask you for PHP version, extensions, and compile static binaries +docker run --rm -v $(pwd)/dist:/dist/ -it static-php build-php ``` -After compilation you can use command to get static php binary file: +After compilation you can use command to get static php binary file. + ```bash -mkdir dist -docker run --rm -v $(pwd)/dist:/dist/ -it static-php cp php-dist/bin/php /dist/ cd dist file ./php ``` -If you don't want to use docker, a single script for compiling: +If you don't want to use docker, a single script for compiling in **Alpine Linux**: ```bash cd docker @@ -126,8 +129,18 @@ To customize PHP extensions, edit `docker/extensions.txt` file, and rules below: | yes | zlib | * | | ## Customization -- `docker/Dockerfile` edit `VER_PHP=x.x.x` to switch PHP version. -- `docker/Dockerfile` edit `USE_BACKUP=yes` to use backup download address (download faster if you are not in mainland China). +- If you are going to run without prompt, Just add it to the end of `docker run xxx` cmd according to the parameters given below. + +> 1st parameter `original` represents that you are using global original download address to fetch dependencies, if you are in mainland China, use `mirror`. +> +> 2nd parameter `8.1.7` is your PHP version you are compiling. +> +> 3rd parameter `all` represents that you will compile all supported extensions. +> +> 4th parameter `/dist/` is your binary output directory. +> +> For example, `docker run --rm -v $(pwd)/dist:/dist/ -it static-php build-php original 8.1.7 all /dist/` + - `docker/extensions.txt` edit extensions. - `docker/compile-php.sh` file `php_compile_args` function to adjust PHP configure arguments. - `docker/check-extensions.sh` file `check_in_configure` function to adjust extensions' configure arguments. @@ -139,7 +152,7 @@ To customize PHP extensions, edit `docker/extensions.txt` file, and rules below: - [ ] Not support readline, maybe caused by ncurses library. - [X] Not support curl (solved) - [X] Customize extensions to compile -- [ ] php.ini integration +- [X] php.ini integration - [X] i18n (including README and scripts) ## Running preview diff --git a/README.md b/README.md index 35d7afbe..40566218 100755 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Compile A Statically Linked PHP With Swoole and other Extensions. [English READM 注:只能编译 CLI 模式,暂不支持 CGI 和 FPM 模式 -[![版本](https://img.shields.io/badge/script--version-1.5.1-green.svg)]() +[![版本](https://img.shields.io/badge/script--version-1.6.0-green.svg)]() [![License](https://img.shields.io/badge/License-MIT-blue.svg)]() ![Build Actions](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build-php.yml/badge.svg) @@ -61,16 +61,20 @@ cat micro.sfx code.php > single-app && chmod +x single-app ```bash git clone https://github.com/crazywhalecc/static-php-cli.git cd static-php-cli/docker -docker build -t static-php . --build-arg USE_BACKUP_ADDRESS=no --build-arg COMPILE_PHP_VERSION=7.4.28 +docker build -t static-php . --build-arg USE_BACKUP_ADDRESS=no +# 新建一个用于放置构建好的二进制的文件夹 +mkdir dist +# 终端会引导你进行编译安装,可选择 PHP 版本、要编译的扩展 +docker run --rm -v $(pwd)/dist:/dist/ -it static-php build-php ``` 编译之后可以使用下方命令将二进制 PHP 提取出来,用以下方式: ```bash -mkdir dist -docker run --rm -v $(pwd)/dist:/dist/ -it static-php cp php-dist/bin/php /dist/ cd dist file ./php +# 如果是 PHP 8.0 以上,同时会输出 micro 构建版本 +file ./micro.sfx ``` 如果你不想使用 Docker,想从Alpine环境直接编译,可以使用预置相同编译配置的脚本 `fast-compiler.sh`: @@ -131,14 +135,24 @@ export VER_PHP="8.1.7" | yes, enabled | zlib | * | | ## 自定义 -- `docker/Dockerfile` 中修改 `VER_PHP=x.x.x` 来更换 PHP 版本。 -- `docker/Dockerfile` 中修改 `USE_BACKUP=yes` 使用备用下载源码地址(建议**不在中国大陆的用户**使用备用地址)。 +- 从 Docker 运行编译,会依次询问下载地址、PHP 版本、要编译的扩展、编译输出文件夹。 +- 如果不想弹出终端交互框,只需按照下方给出的参数加到字符串的后面。 + +> `参数1`: `original` 代表使用原始地址,如果你位于中国大陆,可使用 `mirror` 加快下载。 +> +> `参数2`: `8.1.7` 是你要编译的 PHP 版本。 +> +> `参数3`: `all` 代表你要编译所有支持的扩展,不询问。 +> +> `参数4`: `/dist/` 是你编译后输出二进制 PHP 和 micro 的文件夹 +> +> 基本例子: `docker run --rm -v $(pwd)/dist:/dist/ -it static-php build-php original 8.1.7 all /dist/` + - `docker/extensions.txt` 指定要编译安装的扩展。 - `docker/compile-php.sh` 中的 `php_compile_args` 函数来调整 PHP 编译参数。 -- `docker/check-extensions.sh` 中的 `check_in_configure` 函数可调整 PHP 扩展编译的参数 。 +- `docker/check-extensions.sh` 中的 `check_in_configure` 函数可调整 PHP 扩展编译的参数。 - `docker/config.json` 可调整要下载的扩展和依赖库版本和链接。 - `docker/fast-compiler.sh` 可以在 Alpine Linux 系统下直接运行。 -- `docker/multi-version-compiler.sh` 可以同时编译多个版本的 PHP。 ## 目前的问题(对勾为已解决) - [X] 不支持 event(libevent) 扩展,event 扩展的 sockets 支持不能在静态编译中使用,因为静态内嵌编译暂时没办法调整扩展编译顺序,同时其本身也不支持静态编译。 @@ -146,9 +160,8 @@ export VER_PHP="8.1.7" - [ ] 不支持 readline 扩展,readline 扩展安装后无法正常使用 `php -a`,原因还没有弄清楚,可能是静态编译造成的 ncurses 库出现了问题。 - [X] curl/libcurl 扩展静态编译 - [X] 可自行选择不需要编译进入的扩展 -- [ ] php.ini 内嵌或分发 +- [X] php.ini 内嵌或分发 - [X] i18n(国际化脚本本身和 README) -- [ ] 在阿里云的部分阉割系统上可能缺少 openssl 配置,可能会导致 PHP 自身的 openssl 无法正常使用 如果你对以上问题有解决方案,请提出 Issue 或 PR!