asdf-php

PHP plugin for asdf version manager

Original version of this plugin created by @Stratus3D

Build History

Prerequirements

Check the .github/workflows/workflow.yml for dependencies, paths, and environment variables needed to install the latest PHP version. To be honest, supporting a major version other than the latest without any extra work from the user is an endless endeavor that won't ever really work too well. It's not that we don't support them at all, but it's almost impossible for us to support them.

Installation

asdf plugin-add php https://github.com/asdf-community/asdf-php.git

Configuration

Environment Variables

ASDF_PHP_INCLUDE_DEPS - when set to 1, this plugin will consider the executables of the dependencies of the installed package as well. For example, when installing ansible, the ansible command actually comes from its depency, ansible-core. This is the same as Pipx's --include-deps flag.
ASDF_PHP_DEFAULT_SSL_PATH - Path to a ssl/openssl binary this plugin should use. Default is unset. See SSL Resolution section for more details.
ASDF_SSL_VENV_COPY_MODE:
- 0: (default) Add --copies flag to venvs created with a specific Python version. Symlinks otherwise.
- 1: Prefer --copies whenever possible (--copies does not work with /usr/bin/python3 on macOS).
ASDF_PHP_DEBUG - Set to 1 for additional logging

Note

Composer is installed globally alongside PHP by default. If your application requires additional php extensions, you may need to install them via pecl. For example:

pecl install redis
pecl install imagick

echo "extension=redis.so
extension=imagick.so" > $(asdf where php)/conf.d/php.ini

macOS

To install PHP on macOS, you'll need a set of packages installed via homebrew.

There's also a set of optional packages which enable additional extensions to be enabled:

brew install gmp libsodium imagemagick

Note that the supported extension are not exhaustive, so you may need edit the bin/install script to support additional extension. Feel free to submit a PR for any missing extensions.

PHP-PEAR

If PHP PEAR is down you can install PHP without PEAR. Specify PHP_WITHOUT_PEAR variable with any value (except no), eg:

PHP_WITHOUT_PEAR=yes asdf install php <version>

Usage

Check asdf readme for instructions on how to install & manage versions.

Global Composer Dependencies

Composer is installed globally by default. To use it, you'll need to reshim:

composer global require friendsofphp/php-cs-fixer
asdf reshim
php-cs-fixer --version

License

Licensed under the Apache License, Version 2.0.

VadimDor/asdf-php