Extensions - Upsun Developer

You can use the Upsun composable image to install multiple runtimes and tools in your application container. When using the composable image, see how you can:

PHP has a number of extensions developed by members of the community. Some of them are available for Upsun containers. You can define the PHP extensions you want to enable or disable: You can also include configuration options for specific extensions. The following table shows all extensions that are available (●) and on by default (✔). You can turn on the available ones with the extensions key and turn off those on by default with the disabled_extensions key.

✔ Default (enabled)◆ Built-in● Available

Extension	Description	8.5	8.4	8.3	8.2	8.1	8.0	7.4	7.3	7.2	7.1	7.0	5.6	5.5	5.4
`amqp`	RabbitMQ/AMQP messaging client.	●	●	●	●	●	●	●	●	●	●	●
`apc`	Legacy APC opcode/user cache.														●
`apcu`	In-memory user data cache (APCu).	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`apcu_bc`	Backward-compatibility layer for APCu.							●	●	●	●	●
`applepay`	PHP extension for applepay support.							●	●		●	●
`bcmath`	Arbitrary precision mathematics.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`blackfire`	Blackfire profiling probe.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`bz2`	bzip2 compression support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	●
`calendar`	Calendar conversion functions.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`ctype`	Character type checking functions.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`curl`	HTTP and network requests via libcurl.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`datadog-profiling`	Datadog continuous profiler.	●	●	●	●
`dba`	DBA key-value database abstraction.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`dom`	DOM XML document manipulation.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`enchant`	Spell checking via Enchant.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`event`	High-performance event loop bindings.	●	●	●	●	●	●	●	●	●	●
`exif`	Read image EXIF metadata.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`ffi`	Foreign Function Interface (C libraries).	●	●	●	●	●	●	●
`fileinfo`	MIME type and file metadata detection.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`ftp`	FTP client functions.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`gd`	Image creation and manipulation (GD).	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`gearman`	Gearman job queue client/worker.												●	●	●
`geoip`	IP geolocation lookups.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`gettext`	Native gettext i18n support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`gmp`	Big integer arithmetic (GMP).	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`gnupg`	GnuPG encryption/signature support.	●	●	●	●	●	●
`grpc`	gRPC client/server support.	●	●
`http`	PHP extension for http support.	●	●	●	●	●	●	●	●						●
`iconv`	Character set conversion.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`igbinary`	Compact binary serializer.	●	●	●	●	●	●	●	●	●	●	●
`imagick`	Image processing with ImageMagick.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`imap`	IMAP/POP3/NNTP mail access.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`interbase`	Firebird/InterBase database driver.				●	●	●	●	●	●	●	●	●	●	●
`intl`	Internationalization (ICU) features.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`ioncube`	ionCube loader support.	●	●	●	●	●		●	●	●	●	●
`json`	JSON encode/decode functions.	◆	◆	◆	◆	◆	◆	✔	✔	✔	✔	✔	✔	●
`ldap`	LDAP directory access.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`mailparse`	Email/MIME parsing utilities.	●	●	●	●	●	●	●	●	●	●	●
`mbstring`	Multibyte string functions.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`mcrypt`	Legacy mcrypt encryption functions.										●	●	✔	✔	✔
`memcache`	Memcache client extension.												●	●	●
`memcached`	Memcached client extension.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`mongo`	Legacy MongoDB driver.												●	●	●
`mongodb`	MongoDB driver.	●	●	●	●	●	●	●	●	●	●	●
`msgpack`	MessagePack serialization.	●	●	●	●	●	●	●	●	●	●	●	●
`mssql`	Legacy Microsoft SQL Server driver.												●	●	●
`mysql`	Legacy MySQL driver.												✔	✔	✔
`mysqli`	MySQL improved driver.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`mysqlnd`	MySQL native driver.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`newrelic`	New Relic PHP agent.	●	●	●	●	●	●	●	●	●	●	●	●
`oauth`	OAuth client utilities.	●	●	●	●	●	●	●	●	●	●	●
`odbc`	ODBC database connectivity.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`opcache`	Bytecode cache and optimizer.	◆	◆	◆	◆	◆	◆	◆	◆	◆	◆	◆	◆	◆	✔
`openswoole`	OpenSwoole async networking/server.		●	●	●
`opentelemetry`	OpenTelemetry tracing/metrics SDK.	●	●	●	●
`pdo`	PHP Data Objects core.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`pdo_dblib`	PDO driver for FreeTDS/MSSQL/Sybase.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`pdo_firebird`	PDO driver for Firebird.	●	●	●	●						●	●	●	●	●
`pdo_mysql`	PDO driver for MySQL/MariaDB.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`pdo_odbc`	PDO driver for ODBC.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`pdo_pgsql`	PDO driver for PostgreSQL.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`pdo_sqlite`	PDO driver for SQLite.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`pdo_sqlsrv`	PDO driver for SQL Server.	●	●	●	●	●	●	●	●	●	●	●
`pecl-http`	PHP extension for pecl-http support.												●	●
`pgsql`	PostgreSQL driver.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`phar`	PHAR archive support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`pinba`	PHP extension for pinba support.												●	●	●
`posix`	POSIX process and system functions.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`propro`	PHP extension for propro support.							●	●				●
`protobuf`	Protocol Buffers support.	●	●	●	●	●
`pspell`	Spell checking via Pspell/Aspell.			●	●	●	●	●	●	●	●	●	●	●	●
`raphf`	PHP extension for raphf support.	●	●	●	●	●	●	●	●				●
`rdkafka`	Apache Kafka client (librdkafka).	●	●	●	●	●
`readline`	Interactive readline support.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`recode`	PHP extension for recode support.								●	●	●	●	●	●	●
`redis`	Redis client extension.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`shmop`	Shared memory operations.	●	●	●	●	●	●	●	●	●	●	●
`simplexml`	SimpleXML parsing API.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`snmp`	SNMP protocol support.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`soap`	SOAP client/server support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`sockets`	Low-level socket API.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`sodium`	Modern cryptography (libsodium).	●	●	●	●	●	●	●	●	●
`sourceguardian`	PHP extension for sourceguardian support.	●	●	●	●	●	●	●	●	●	●	●
`spplus`	PHP extension for spplus support.													●	●
`sqlite3`	SQLite3 driver.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`sqlsrv`	Microsoft SQL Server driver.			●	●	●	●	●	●	●	●	●
`ssh2`	SSH2 and SFTP support.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`swoole`	Async networking and coroutine server.	●	●	●	●
`sybase`	PHP extension for sybase support.	●	●	●	●	●	●	●	●	●	●	●
`sysvmsg`	System V message queue support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`sysvsem`	System V semaphore support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`sysvshm`	System V shared memory support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`tideways`	PHP extension for tideways support.	●	●	●	●	●	●	●	●	●	●	●
`tideways_xhprof`	PHP extension for tideways_xhprof support.			●	●	●	●	●	●	●	●	●
`tidy`	HTML/XML cleanup and repair.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`tokenizer`	PHP tokenizer functions.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`uuid`	UUID generation and handling.	●	●	●	●	●	●	●	●	●	●
`uv`	libuv event loop bindings.		●	●
`wddx`	WDDX serialization support.								●	●	●	●
`xcache`	Legacy opcode/user cache.													●	●
`xdebug`	Debugging and code coverage tools.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`xhprof`	Function-level profiler.												●	●	●
`xml`	Core XML parser support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`xmlreader`	Streaming XML reader.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`xmlrpc`	XML-RPC protocol support.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`xmlwriter`	Streaming XML writer.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`xsl`	XSLT transformations.	●	●	●	●	●	●	●	●	●	●	●	●	●	●
`yaml`	YAML parsing and emitting.	●	●	●	●	●	●	●	●	●	●
`zbarcode`	PHP extension for zbarcode support.								●	●	●	●
`zip`	ZIP archive support.	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔

Some built-in modules are always on:

date
filter
hash
json (from 8.0)
libxml
openssl
pcntl
pcre
Reflection
session
SPL
standard
Zend OPcache (from 5.5)
zlib

To see a complete list of the compiled PHP extensions, run the following CLI command:

upsun ssh "php -m"

Custom PHP extensions

It’s possible to use an extension not listed here, but it takes slightly more work:

Download the .so file for the extension as part of your build hook using curl or similar. It can also be added to your Git repository if the file isn’t publicly downloadable, but committing large binary blobs to Git is generally not recommended.
Load the extension using an absolute path by customizing the PHP settings For example, if the extension is named spiffy.so and is in your app root, your configuration looks like the following:

​Custom PHP extensions

Custom PHP extensions