Skip to content
PHP plugin for asdf version manager
Branch: master
Clone or download
Latest commit 9329073 Feb 16, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Merge pull request #13 from salzig/feat/detect_iconv Jan 30, 2019
.travis.yml Use curl from brew on MacOS Jun 6, 2018
CHANGELOG First commit of the asdf-php plugin. Feb 15, 2016
LICENSE First commit of the asdf-php plugin. Feb 15, 2016 Updates README Feb 5, 2019


Build Status

PHP plugin for asdf version manager.

Original version of this plugin created by @Stratus3D


PHP Pear is down without ETA for when the server will be back. To install PHP without Pear you can specify a PHP_WITHOUT_PEAR variable with any value (except no), eg:

PHP_WITHOUT_PEAR=yes asdf install php 7.2.14

Why using this plug-in?

Original plug-in appears to be unmaintained and it doesn't work anymore (at least on OSX), so I fixed it to provide compatibility and improve it's documentation.


asdf plugin-add php

Please, remember installing the common required libraries that can be found on the asdf README. They are necessary to build PHP versions too!


You may need this libraries and packages to be able to compile PHP compiler versions:

sudo apt-get install curl build-essential autoconf libjpeg-dev libpng12-dev openssl libssl-dev libcurl4-openssl-dev pkg-config libsslcommon2-dev libreadline-dev libedit-dev zlib1g-dev libicu-dev libxml2-dev gettext bison libmysqlclient-dev libpq-dev

Ubuntu 18.04

sudo apt install curl build-essential libjpeg-dev libpng-dev openssl libcurl4-openssl-dev pkg-config libedit-dev zlib1g-dev libicu-dev libxml2-dev gettext bison libmysqlclient-dev libpq-dev


In order to compile PHP on macOS machines, you must install some brew packages first:

brew install freetype bison bison27 gettext icu4c jpeg libiconv libpng openssl readline zlib

Use environment variables to instruct autoconf on where to find the libraries you installed using homebrew. Note that:

  • for PHP 5.6, you must use brew --prefix bison@2.7 in your PATH
  • for PHP 7.x, you must use brew --prefix bison in your PATH

So replace if necessary:

PATH="$(brew --prefix bison)/bin:$(brew --prefix icu4c)/bin:$(brew --prefix icu4c)/sbin:$PATH" PHP_CONFIGURE_OPTIONS="--with-iconv=$(brew --prefix libiconv) --with-openssl=$(brew --prefix openssl)" asdf install php <version>

Important note: There seems to be a bug with PHP configure file on recent versions (> 7.1.4) when using on OSX environments. As can be seen in this PR, it's needed to disable gettext at build time to work, and later on impate the module manually.

To disable it, just execute this before run the asdf install command:

$ export PHP_CONFIGURE_OPTIONS='--disable-gettext'


To modify this plugin into your asdf installation and see changes live, just create a symlink:

ln -s . ~/.asdf/plugins/php


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


Feel free to create an issue or pull request if you find a bug.

Note that the Travis builds for your PR will fail:


No available versions shown

This could be due to GitHub API quota limits. To solve it, you just need to specify GITHUB_API_USER and GITHUB_API_KEY with your username and a Personal Access Token, so the list-all command can use it to fetch available versions.


MIT License

You can’t perform that action at this time.