mirror of
https://github.com/crazywhalecc/static-php-cli.git
synced 2026-03-18 04:44:53 +08:00
105 lines
10 KiB
Markdown
105 lines
10 KiB
Markdown
# Extension List
|
|
|
|
> - yes: supported and tested
|
|
> - untested: supported, but not tested
|
|
> - empty: not supported yet
|
|
> - no with issue link: not supported yet due to issue
|
|
> - partial with issue link: supported but not perfect due to issue
|
|
|
|
| | Linux | macOS | Windows |
|
|
|------------|---------------------------------------------------------------------|----------------------------------------------------------------|---------|
|
|
| apcu | yes | yes | |
|
|
| bcmath | yes | yes | |
|
|
| bz2 | yes | yes | |
|
|
| calendar | yes | yes | |
|
|
| ctype | yes | yes | |
|
|
| curl | yes | yes | |
|
|
| dba | yes | yes | |
|
|
| dom | yes | yes | |
|
|
| enchant | | | |
|
|
| event | yes | yes | |
|
|
| exif | yes | yes | |
|
|
| filter | yes | yes | |
|
|
| fileinfo | yes | yes | |
|
|
| ftp | yes | yes | |
|
|
| gd | yes | yes | |
|
|
| gettext | | | |
|
|
| gmp | yes | yes | |
|
|
| iconv | yes | yes | |
|
|
| inotify | yes | yes | |
|
|
| mbstring | yes | yes | |
|
|
| mbregex | yes | yes | |
|
|
| mcrypt | | [no](https://github.com/crazywhalecc/static-php-cli/issues/32) | |
|
|
| mongodb | yes | yes | |
|
|
| mysqli | yes | yes | |
|
|
| mysqlnd | yes | yes | |
|
|
| openssl | yes | yes | |
|
|
| pcntl | yes | yes | |
|
|
| pdo | yes | yes | |
|
|
| pdo_mysql | yes | yes | |
|
|
| pdo_sqlite | yes | yes | |
|
|
| pdo_pgsql | | | |
|
|
| phar | yes | yes | |
|
|
| posix | yes | yes | |
|
|
| protobuf | yes | yes | |
|
|
| readline | yes, untested | yes, untested | |
|
|
| redis | yes | yes | |
|
|
| session | yes | yes | |
|
|
| shmop | yes | yes | |
|
|
| simplexml | yes | yes | |
|
|
| soap | yes | yes | |
|
|
| sockets | yes | yes | |
|
|
| sqlite3 | yes | yes | |
|
|
| swow | yes | yes | |
|
|
| swoole | [partial](https://github.com/crazywhalecc/static-php-cli/issues/51) | yes | |
|
|
| tokenizer | yes | yes | |
|
|
| xml | yes | yes | |
|
|
| xmlreader | yes, untested | yes, untested | |
|
|
| xmlwriter | yes, untested | yes, untested | |
|
|
| zip | yes, untested | yes | |
|
|
| zlib | yes | yes | |
|
|
| zstd | yes | yes | |
|
|
|
|
## Additional Requirements
|
|
|
|
- phpmicro requires PHP >= 8.0
|
|
- swoole >= 5.0 requires PHP >= 8.0
|
|
- swow requires PHP >= 8.0
|
|
|
|
## Typical Extension List Example
|
|
|
|
Here are some extension list example for different use.
|
|
|
|
- For general use: `"bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,ftp,filter,gd,iconv,xml,mbstring,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip"`
|
|
- For static-php-cli self: `"posix,pcntl,phar,tokenizer,iconv,zlib"`
|
|
- For static-php-cli self (with dev dependencies): `"posix,pcntl,phar,tokenizer,iconv,zlib,xml,dom,xmlwriter,xmlreader,fileinfo"`
|
|
- Minimum, with no extension: `""`
|
|
|
|
Compile with all supported extensions (exclude `swow`, `swoole` due to c++ extension):
|
|
|
|
```bash
|
|
bin/spc build --build-all bcmath,bz2,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,mbregex,mbstring,mongodb,mysqli,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,protobuf,redis,session,shmop,simplexml,soap,sockets,sqlite3,tokenizer,xml,xmlreader,xmlwriter,yaml,zip,zlib,zstd --with-libs=libjpeg,freetype,libwebp,libavif --debug
|
|
```
|
|
|
|
## Additional Libraries
|
|
|
|
Some extensions have soft dependencies, you can enable extra features by adding these libs using `--with-libs`.
|
|
|
|
For example, to compile with gd extension, with `libwebp, libgif, libavif, libjpeg, freetype` extra features:
|
|
|
|
```bash
|
|
bin/spc build gd --with-libs=libjpeg,freetype,libwebp,libavif --build-cli
|
|
```
|
|
|
|
> If you don't add them, your compilation will not enable these features.
|
|
|
|
## Limitations
|
|
|
|
- swow and swoole cannot be compiled at the same time.
|
|
- openssl needs manual configuration for ssl certificate. (TODO: I will write a wiki about it)
|
|
- some extensions need system configuration, e.g. `curl` and `openssl` will search ssl certificate on your system.
|
|
|
|
## Bugs and TODOs
|
|
|
|
See [#32](https://github.com/crazywhalecc/static-php-cli/issues/32).
|