Skip to main content
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. 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:
  1. 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.
  2. 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:
Last modified on March 11, 2026