diff --git a/README.md b/README.md index 6a0b4e1..8b2dbb3 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ - You are not satisifed with heavy handed *AMP or PPA-based installers. - You [use multiple][homebrew-php] [versions][php-build] of PHP on Linux or Mac. +- You use MacPorts with multiple php ports installed, and you don't want to globally select a version with `port select`. - You download [pre-compiled PHP binaries for Windows][windows-bin]. - You want to run your automated tests against multiple PHP versions. - You are a developer that works on a variety of PHP projects each requiring different versions of PHP. @@ -35,6 +36,7 @@ ## Features - [Homebrew installed PHP versions][homebrew-php] are picked up automatically. +- MacPorts php ports are picked up if installed. - PHP versions installed [into `~/.phps`][build-php-vers] are picked up automatically. - PHP versions listed in the `$PHP_VERSIONS` shell variable are picked up automatically. - **snap versioning**: Use a partial version number (i.e. `php-version 5`) to automatically use the latest 5.x version. @@ -96,7 +98,7 @@ # non-Homebrew source $HOME/local/php-version/php-version.sh && php-version 5 -Type `php-version --help` for more configuration options such as how to add extra PHP installation paths or `php-config --version` to find out which `php` version is active. +Type `php-version --help` for more configuration options such as how to add extra PHP installation paths or `php-config` without parameters to find out which `php` version is active. > If you have PHP versions in multiple directories, you can list them in the environment variable `PHP_VERSIONS` separated by spaces as depicted below: @@ -104,6 +106,52 @@ Type `php-version --help` for more configuration options such as how to add extr **NOTE**: do this before you source `php-version.sh`: +## MacPorts usage + +MacPorts support is a bit trickier. The `php-version` command must always be invoked at the root of the project, where it will create a `.php-bin` directory +containing symlinks to the php port's binaries. + +For example, if the `php56` port is installed, the command `php-version 5.6` will create a `.php-bin` directory containing the following symlinks: + + php -> /opt/local/bin/php56 + php-config -> /opt/local/bin/php-config56 + phpize -> /opt/local/bin/phpize56 + +Then it will prepend the full path of the `.php-bin` directory to the `PATH` environment variable. + +Remember to add the `.php-bin` directory to your `.gitignore` file. + +## Integrate with [direnv](https://github.com/direnv/direnv) + +Append the following functions to your `~/.direnvrc` file: + + _php_version_dir() { + #***TODO: replace this with the actual dirname of the `php-version.sh` file if not using homebrew + $(brew --prefix php-version) + } + + # use php [version] + use_php() { + local ver=$1 + if [[ -z $ver ]] && [[ -f .php-version ]]; then + ver=$(cat .php-version) + fi + if [[ -z $ver ]]; then + echo Unknown php version + exit 1 + fi + + source "$(_php_version_dir)/php-version.sh" && php-version $ver + } + +Then create an `.envrc` file with the following content in your project root: + + set -e + use php + +Where `` is the actual php version you want to autoload. Alternatively, you could create a `.php-version` file containing the php version number, +and omit the `` parameter in the `use php` command. + ## Deactivate / Uninstall 1. Remove [setup](https://github.com/wilmoore/php-version#setup) configuration. diff --git a/php-version.sh b/php-version.sh index 9172bf5..65e561e 100755 --- a/php-version.sh +++ b/php-version.sh @@ -4,7 +4,7 @@ function php-version { local PROGRAM_APPNAME='php-version' - local PROGRAM_VERSION=0.12.0 + local PROGRAM_VERSION=0.13.0 local PROGRAM_DISPLAY_VERSION="$PROGRAM_APPNAME v$PROGRAM_VERSION" # colors @@ -17,9 +17,10 @@ function php-version { # PHP installation paths local _PHP_VERSIONS="" - # use builtin commands for sort and grep + # use builtin commands for sort, grep and sed local grep="command grep -E" local sort="command sort -r -t . -k 1,1n -k 2,2n -k 3,3n" + local sed="command sed -En" # add ~/.phps if it exists (default) if [[ -d $HOME/.phps ]]; then @@ -36,6 +37,20 @@ function php-version { export _PHP_VERSIONS="$_PHP_VERSIONS $PHP_VERSIONS" fi + # add installed PHP ports if MacPorts is installed + if [[ -n $(command -v port) ]]; then + # get the list of installed php* ports + local _PORT_NAMES_="$(echo $(port -q installed | $sed 's;.*(php[0-9]. ).*$;\1;p'))" + _PORT_VERSIONS=() + _PORT_NAMES=() + for _PORT_NAME in $(echo $_PORT_NAMES_ | tr " " "\n"); do + local _PHP_CONFIG=$(port -q contents $_PORT_NAME | $grep "/bin/php-config${_PORT_NAME#php}$" | tr -d '[:blank:]') + _PORT_VERSIONS=("${_PORT_VERSIONS[@]}" "$($_PHP_CONFIG --version 2>/dev/null)") + _PORT_NAMES=("${_PORT_NAMES[@]}" "$_PORT_NAME") + done + _PORT_NAMES_= + fi + # export the space-separated string as array _PHP_REPOSITORIES=() for _PHP_VERSION in $(echo $_PHP_VERSIONS | tr " " "\n"); do @@ -65,6 +80,10 @@ function php-version { $PROGRAM_APPNAME 5.5 Activate the latest available 5.5.x version $PROGRAM_APPNAME 5.5.13 Activate version 5.5.13 specifically + Note: + With MacPorts you should always specify only the . versions, because you cannot + install multiple patch versions for a given release + Configuration Options: https://github.com/wilmoore/php-version#setup @@ -93,11 +112,43 @@ function php-version { "") + if [ "${#_PORT_VERSIONS[@]}" -gt "0" ]; then + _PHP_VERSION= + # check if PATH contains /.php-bin directory + if [[ $PATH =~ "/.php-bin" ]]; then + local _PHP_VERSION=$(php-config --version 2>/dev/null) + fi + + # loop through all macports versions + _N=0 + echo "MacPorts versions" + echo "-----------------" + for version in "${_PORT_VERSIONS[@]}"; do + local selected=" " + local color=$COLOR_NORMAL + + if [[ "$version" == "$_PHP_VERSION" ]]; then + local selected="*" + local color=$COLOR_REVERSE + fi + + printf "${color}%s %s${COLOR_NORMAL} (port name: %s)\n" "$selected" "$version" "${_PORT_NAMES[$_N]}" + + _N=$(expr $_N + 1) + done + echo "" + + [[ $PATH =~ "/.php-bin" ]] && return 0 + fi + # bail-out if _PHP_REPOSITORIES is an empty array if [ ${#_PHP_REPOSITORIES[@]} -eq 0 ]; then - echo 'Sorry, but you do not seem to have any PHP versions installed.' >&2 - echo 'See https://github.com/wilmoore/php-version#install for assistance.' >&2 - return 1 + if [ ${#_PORT_VERSIONS[@]} -eq 0 ]; then + echo 'Sorry, but you do not seem to have any PHP versions installed.' >&2 + echo 'See https://github.com/wilmoore/php-version#install for assistance.' >&2 + return 1 + fi + return 0 fi # Loop through all repositories and get every single php-version @@ -160,6 +211,40 @@ function php-version { # bail-out if we were unable to find a PHP matching given version if [[ -z $_PHP_ROOT ]]; then + if [ "${#_PORT_VERSIONS[@]}" -gt "0" ]; then + _TARGET_VERSION_FUZZY=$(IFS=$'\n'; echo "${_PORT_VERSIONS[*]}" | eval $sort | eval "$grep '^$_TARGET_VERSION' 2>/dev/null" | tail -1) + + if [[ -n "$_TARGET_VERSION_FUZZY" ]]; then + _N=0 + for _PHP_VERSION in "${_PORT_VERSIONS[@]}"; do + if [[ "$_PHP_VERSION" == "$_TARGET_VERSION_FUZZY" ]]; then + local _PHP_BIN="$PWD/.php-bin" + + # create .php-bin directory if not exists, relative to current dir + [[ -d "$_PHP_BIN" ]] || mkdir "$_PHP_BIN" + # delete all symlinks in .php-bin directory starting with php* + find "$_PHP_BIN" -type l -name "php*" -exec rm -f {} \; + # create symlinks in .php-bin, one foreach port's php binary + for _BIN_FILE in $(port -q contents ${_PORT_NAMES[$_N]} | $grep '/bin/php.*$' | tr -d '[:blank:]'); do + ln -s "$_BIN_FILE" "$_PHP_BIN/$(basename "$_BIN_FILE" | $sed 's;([^0-9].)[0-9].$;\1;p')" + done + + # append .php-bin to PATH + export PATH="$_PHP_BIN:$PATH" + # configure MANPATH + local _MANPATH=$($_PHP_BIN/php-config --man-dir) + [[ -d $_MANPATH && ! $MANPATH =~ "$_MANPATH" ]] && export MANPATH="$_MANPATH:$MANPATH" + + hash -r + return 0; + fi + _N=$(expr $_N + 1) + done + fi + + echo "Sorry, but $PROGRAM_APPNAME was unable to find version '$1' in installed ports." >&2 + return 1 + fi echo "Sorry, but $PROGRAM_APPNAME was unable to find version '$1' under '${_PHP_PATHS[@]}'." >&2 return 1 fi