How to enable extensions?

[lsolesen]

I have an app, that I want to run on fly.io which requires a certain php extension. Is there a way to add this when using a buildpack?

Your lock file does not contain a compatible set of packages. Please run composer update.
    
      Problem 1
        - kigkonsult/icalcreator is locked to version v2.41.71 and an update of this package was not requested.
        - kigkonsult/icalcreator v2.41.71 requires ext-zlib * -> it is missing from your system. Install or enable PHP's zlib extension.
    
    To enable extensions, verify that they are enabled in your .ini files:
        - /layers/paketo-buildpacks_composer-install/composer-php-ini/composer-php.ini
        - /layers/paketo-buildpacks_php-dist/php/etc/buildpack.ini
        - /layers/paketo-buildpacks_php-dist/php/etc/php.ini
        - /layers/paketo-buildpacks_php-dist/php/etc/buildpack.ini
        - /layers/paketo-buildpacks_php-dist/php/etc/php.ini
    You can also run `php --ini` in a terminal to see which files are used by PHP in CLI mode.
    Alternatively, you can run Composer with `--ignore-platform-req=ext-zlib` to temporarily ignore these required extensions.
exit status 2

I am using this repository --- https://github.com/vih/vih-viggo-standalone

[dmikusa]

You can easily enable any PHP extension that is bundled with the PHP versions Paketo ships using these instructions. It should also pick them up automatically from Composer (it's a little odd that it's not doing that).

I don't know if we publish a list of the available extensions, but you can fetch them easily enough. Grab the download URL for the version of PHP you're using (you can get it from buildpack.toml, it's the uri property) and then run this command curl -s <URI> | tar tz | grep 'lib/php/extensions'.

Ex:

> curl -s https://artifacts.paketo.io/php/php_8.1.12_linux_x64_jammy_5f446639.tgz | tar tz | grep 'lib/php/extensions'
./lib/php/extensions/
./lib/php/extensions/no-debug-non-zts-20210902/
./lib/php/extensions/no-debug-non-zts-20210902/curl.so
./lib/php/extensions/no-debug-non-zts-20210902/mbstring.so
./lib/php/extensions/no-debug-non-zts-20210902/tideways_xhprof.so
./lib/php/extensions/no-debug-non-zts-20210902/pdo_mysql.so
./lib/php/extensions/no-debug-non-zts-20210902/oauth.so
./lib/php/extensions/no-debug-non-zts-20210902/ftp.so
./lib/php/extensions/no-debug-non-zts-20210902/pdo_firebird.so
./lib/php/extensions/no-debug-non-zts-20210902/apcu.so
./lib/php/extensions/no-debug-non-zts-20210902/yaf.so
./lib/php/extensions/no-debug-non-zts-20210902/gettext.so
./lib/php/extensions/no-debug-non-zts-20210902/mongodb.so
./lib/php/extensions/no-debug-non-zts-20210902/imagick.so
./lib/php/extensions/no-debug-non-zts-20210902/sockets.so
./lib/php/extensions/no-debug-non-zts-20210902/imap.so
./lib/php/extensions/no-debug-non-zts-20210902/sysvsem.so
./lib/php/extensions/no-debug-non-zts-20210902/amqp.so
./lib/php/extensions/no-debug-non-zts-20210902/sysvmsg.so
./lib/php/extensions/no-debug-non-zts-20210902/pspell.so
./lib/php/extensions/no-debug-non-zts-20210902/lzf.so
./lib/php/extensions/no-debug-non-zts-20210902/solr.so
./lib/php/extensions/no-debug-non-zts-20210902/rdkafka.so
./lib/php/extensions/no-debug-non-zts-20210902/maxminddb.so
./lib/php/extensions/no-debug-non-zts-20210902/gmp.so
./lib/php/extensions/no-debug-non-zts-20210902/mysqli.so
./lib/php/extensions/no-debug-non-zts-20210902/dba.so
./lib/php/extensions/no-debug-non-zts-20210902/shmop.so
./lib/php/extensions/no-debug-non-zts-20210902/pdo_pgsql.so
./lib/php/extensions/no-debug-non-zts-20210902/redis.so
./lib/php/extensions/no-debug-non-zts-20210902/tidy.so
./lib/php/extensions/no-debug-non-zts-20210902/memcached.so
./lib/php/extensions/no-debug-non-zts-20210902/xsl.so
./lib/php/extensions/no-debug-non-zts-20210902/readline.so
./lib/php/extensions/no-debug-non-zts-20210902/pdo.so
./lib/php/extensions/no-debug-non-zts-20210902/sodium.so
./lib/php/extensions/no-debug-non-zts-20210902/ldap.so
./lib/php/extensions/no-debug-non-zts-20210902/zip.so
./lib/php/extensions/no-debug-non-zts-20210902/soap.so
./lib/php/extensions/no-debug-non-zts-20210902/ssh2.so
./lib/php/extensions/no-debug-non-zts-20210902/gnupg.so
./lib/php/extensions/no-debug-non-zts-20210902/pdo_sqlite.so
./lib/php/extensions/no-debug-non-zts-20210902/psr.so
./lib/php/extensions/no-debug-non-zts-20210902/gd.so
./lib/php/extensions/no-debug-non-zts-20210902/igbinary.so
./lib/php/extensions/no-debug-non-zts-20210902/fileinfo.so
./lib/php/extensions/no-debug-non-zts-20210902/exif.so
./lib/php/extensions/no-debug-non-zts-20210902/xdebug.so
./lib/php/extensions/no-debug-non-zts-20210902/mailparse.so
./lib/php/extensions/no-debug-non-zts-20210902/zlib.so
./lib/php/extensions/no-debug-non-zts-20210902/odbc.so
./lib/php/extensions/no-debug-non-zts-20210902/pdo_odbc.so
./lib/php/extensions/no-debug-non-zts-20210902/sysvshm.so
./lib/php/extensions/no-debug-non-zts-20210902/msgpack.so
./lib/php/extensions/no-debug-non-zts-20210902/phpiredis.so
./lib/php/extensions/no-debug-non-zts-20210902/enchant.so
./lib/php/extensions/no-debug-non-zts-20210902/bz2.so
./lib/php/extensions/no-debug-non-zts-20210902/pcntl.so
./lib/php/extensions/no-debug-non-zts-20210902/pgsql.so
./lib/php/extensions/no-debug-non-zts-20210902/snmp.so
./lib/php/extensions/no-debug-non-zts-20210902/openssl.so
./lib/php/extensions/no-debug-non-zts-20210902/yaml.so
./lib/php/extensions/no-debug-non-zts-20210902/opcache.so

[lsolesen]

Thanks for you prompt response.

I keep getting this error, which I suppose is openssl not properly setup.

PHP Warning: file_get_contents(): Unable to find the wrapper "https" - did you forget to enable it when you configured PHP? in /workspace/index.php on line 129

I have a ´require` in my composer set to:

    "require": {
        "php": "~8",
        "ext-openssl": "*"
     }

As here: https://github.com/vih/vih-viggo-standalone/blob/master/composer.json

But maybe there is something that i do not understand properly. Trying to deploy to fly.io.

[sophiewigmore]

@lsolesen sorry you're running into issues. I tried to build your app locally with the pack CLI and was able to build and run it:

pack build vih-viggo-standalone -e BP_COMPOSER_INSTALL_OPTIONS="--ignore-platform-req=ext-zlib" -b paketo-buildpacks/php

docker run -it -p 8080:8080 --env PORT=8080 vih-viggo-standalone

[dmikusa]

Is it necessary/expected to tell Composer to ignore checking for the extensions? i.e. --ignore-platform-req=ext-zlib

Normally, Composer will look and be able to see that the extension is installed & enabled. Assuming that the PHP INI snippets to enable the extensions are also visible to Composer when it runs at build time, it should be able to determine that they are available and one should not need to ignore the checks for them.

Are we passing the PHP INI snippets to Composer when it runs?

[sophiewigmore]

I noticed that setting in the repository fly configuration file. Until I set it at build-time I ran into:

[builder]   Running 'composer install'
[builder]     Installing dependencies from lock file
[builder]     Verifying lock file contents can be installed on current platform.
[builder]     Warning: The lock file is not up to date with the latest changes in composer.json. You may be getting outdated dependencies. It is recommended that
you run `composer update` or `composer update <package name>`.
[builder]     Your lock file does not contain a compatible set of packages. Please run composer update.
[builder]
[builder]       Problem 1
[builder]         - kigkonsult/icalcreator is locked to version v2.41.30 and an update of this package was not requested.
[builder]         - kigkonsult/icalcreator v2.41.30 requires ext-zlib * -> it is missing from your system. Install or enable PHP's zlib extension.
[builder]
[builder]     To enable extensions, verify that they are enabled in your .ini files:
[builder]         - /layers/paketo-buildpacks_composer-install/composer-php-ini/composer-php.ini
[builder]         - /layers/paketo-buildpacks_php-dist/php/etc/buildpack.ini
[builder]         - /layers/paketo-buildpacks_php-dist/php/etc/php.ini
[builder]         - /layers/paketo-buildpacks_php-dist/php/etc/buildpack.ini
[builder]         - /layers/paketo-buildpacks_php-dist/php/etc/php.ini
[builder]         - /workspace/.php.ini.d/extension.ini
[builder]     You can also run `php --ini` in a terminal to see which files are used by PHP in CLI mode.
[builder]     Alternatively, you can run Composer with `--ignore-platform-req=ext-zlib` to temporarily ignore these required extensions.

[sophiewigmore]

@dmikusa however, I just tried to add the extension=zlib.so to the .php.ini.d/extension.ini file, and rebuilt without the -e BP_COMPOSER_INSTALL_OPTIONS="--ignore-platform-req=ext-zlib" and it succeeded 👍

[dmikusa]

Hmm, interesting. At what point does the buildpack look at the composer.json file to implement this? It almost seems like Composer is running before this happens, so the extensions aren't enabled.