static-php-cli/README-en.md

124 lines
6.3 KiB
Markdown
Raw Normal View History

2021-06-06 11:42:21 +08:00
# static-php-cli
2021-06-06 11:41:55 +08:00
Compile A Statically Linked PHP With Swoole and other Extensions.
2021-05-07 09:33:06 +08:00
BTW, It's only for CLI mode.
[![version](https://img.shields.io/badge/version-1.4.2-green.svg)]()
2021-09-01 16:28:14 +08:00
![Build Actions](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build-php.yml/badge.svg)
2021-05-07 09:33:06 +08:00
2021-07-28 14:27:18 +08:00
## Compilation Requirements
2022-04-02 16:50:43 +08:00
- Supporting architecture: `x86_64`, `arm64(aarch64)`, `armv7(armv7l)`
- Docker required (or alpine linux 3.13+)
2022-02-20 17:33:19 +08:00
- Supporting PHP version from 7.2 to 8.1
2021-05-07 09:33:06 +08:00
2021-07-28 14:27:18 +08:00
## Running Requirements
Linux
2021-05-07 09:33:06 +08:00
## Start
2022-04-17 22:19:22 +08:00
1. Directly download static binary from this link.
2021-09-01 16:28:14 +08:00
2022-04-02 16:50:43 +08:00
<https://dl.zhamao.xin/php-bin/file/>
2021-05-07 09:33:06 +08:00
2022-04-17 22:19:22 +08:00
2. Use fast install script `install-runtime.sh` to download static php and composer distribution into `runtime/` directory
But this script has some Chinese comments and prompts, if you cannot understand or have to use it in English, I will make an pure international version! :)
```bash
bash -c "`curl -fsSL https://raw.githubusercontent.com/crazywhalecc/static-php-cli/master/install-runtime.sh`"
```
3. Here's help command to compile it yourself:
2021-05-07 09:33:06 +08:00
```bash
2021-06-06 11:41:55 +08:00
git clone https://github.com/crazywhalecc/static-php-cli.git
cd static-php-cli/docker
2022-04-02 16:50:43 +08:00
docker build -t static-php . --build-arg USE_BACKUP_ADDRESS=yes --build-arg COMPILE_PHP_VERSION=7.4.28
2021-05-07 09:33:06 +08:00
```
2021-06-06 11:41:55 +08:00
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
```
To customize PHP extensions, edit `docker/extensions.txt` file, and rules below:
- Use `#` as comment, to mark not install
- extensions name uses lower case, and default file contains all supported extensions, if u need other extensions, consider write an Issue
2021-05-07 09:33:06 +08:00
2021-06-06 11:41:55 +08:00
## Supported PHP extensions
| Support | PHP Ext Name | Version | Comments |
| ------- | ------------ | ------- | ---------------------------------------- |
| yes | bcmath | * | |
| yes | calendar | * | |
| yes | ctype | * | |
| yes | curl | * | |
| yes | dom | * | |
| | event | | |
| yes | exif | * | |
| yes | filter | * | |
2022-04-11 23:46:00 +08:00
| yes | fileinfo | * | |
| yes | gd | * | |
2021-07-28 14:28:43 +08:00
| yes | hash | * | |
| yes | iconv | * | |
| yes | inotify | 3.0.0 | |
| yes | json | * | |
| yes | libxml | * | |
| yes | mbstring | * | |
| yes | mongodb | >=1.9.1 | not tested |
| | mysqli | | |
| yes | mysqlnd | * | |
| yes | openssl | * | |
| yes | pcntl | * | |
| yes | pdo | * | |
| yes | pdo_mysql | * | |
| yes | pdo_sqlite | * | |
| | pdo_pgsql | * | |
| yes | phar | * | |
| yes | posix | * | |
| yes | redis | * | |
| yes | shmop | * | |
| yes | simplexml | * | |
| yes | soap | * | |
| yes | sockets | * | |
| yes | sqlite3 | * | |
| yes | swoole | >=4.6.6 | support mysqlnd, sockets, openssl, redis |
| yes | tokenizer | * | |
| yes | xml | * | |
| yes | xmlreader | * | |
| yes | xmlwriter | * | |
| | zip | | |
| yes | zlib | * | |
2021-06-06 11:41:55 +08:00
2021-06-06 11:53:16 +08:00
## 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).
- `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.
- `docker/config.json` edit extensions and dependencies version and download links.
2021-06-06 11:41:55 +08:00
## Current Issue
- [ ] Not support event(libevent), because of its `config.m4` and code.
- [ ] Swoole not support `--enable-swoole-curl`.
- [ ] Not support readline, maybe caused by ncurses library.
- [X] Not support curl (solved)
- [X] Customize extensions to compile
- [ ] php.ini integration
- [X] i18n (including README and scripts)
2021-05-07 09:33:06 +08:00
## Running preview
After-compile status
2021-06-06 11:41:55 +08:00
![image](https://user-images.githubusercontent.com/20330940/120911319-219b3000-c6b9-11eb-82d1-b4309cfca8b3.png)
Run Workerman directly
2021-05-07 09:33:06 +08:00
2021-06-06 11:41:55 +08:00
![image](https://user-images.githubusercontent.com/20330940/120911301-f7e20900-c6b8-11eb-99eb-ebc84ab95df0.png)
2021-05-07 09:33:06 +08:00
## References
- <https://blog.terrywh.net/post/2019/php-static-openssl/>
- <https://stackoverflow.com/a/37245653>
- <http://blog.gaoyuan.xyz/2014/04/09/statically-compile-php/>