static-php-cli/ext-support.md

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, untested	yes, untested
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
imagick		yes
inotify	yes	yes
mbstring	yes	yes
mbregex	yes	yes
mcrypt		no
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
ssh2		yes, untested
swow	yes	yes
swoole	partial	yes
tokenizer	yes	yes
xml	yes	yes
xmlreader	yes, untested	yes, untested
xmlwriter	yes, untested	yes, untested
zip	yes, untested	yes, untested
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):

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:

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.