#!/usr/bin/env bash

## Download Drupal, CiviCRM, dependencies, and useful development tools.
## Setup basic symlinks.
##
## Maybe, when drush or composer is more mature, we can eliminate this.

{ # https://stackoverflow.com/a/21100710

## Determine the absolute path of the directory with the file
## absdirname <file-path>
function absdirname() {
  pushd $(dirname $0) >> /dev/null
    pwd
  popd >> /dev/null
}

BINDIR=$(absdirname "$0")
PRJDIR=$(dirname "$BINDIR")
[ -z "$CIVIBUILD_HOME" ] && TMPDIR="$PRJDIR/app/tmp" || TMPDIR="$CIVIBUILD_HOME/.civibuild/tmp"
LOCKFILE="$TMPDIR/civi-download-tools.lock"
LOCKTIMEOUT=90
HUB_VERSION="2.14.2"
JOOMLATOOLS_CONSOLE_VERSION="v1.5.9"
COMPOSER_VERSION="2.3.10"
COMPOSER_URL="https://github.com/composer/composer/releases/download/${COMPOSER_VERSION}/composer.phar"
IS_QUIET=
IS_FORCE=
IS_FULL=

##################################################
## Parse arguments
while [ -n "$1" ] ; do
  OPTION="$1"
  shift

  case "$OPTION" in
    -q|--quiet)
      ## Don't display advisory comments
      ## Only display messages if we're actually making changes
      IS_QUIET=1
      ;;

    -f|--force)
      ## (Re)-download everything
      IS_FORCE=1
      ;;

    --full)
      ## Heuristically identify/download system packages.
      IS_FULL=1
      ;;

    --dir)
      set -e
        [ ! -d "$1" ] && mkdir "$1"
        pushd "$1" >> /dev/null
          PRJDIR=$(pwd)
        popd >> /dev/null
        BINDIR="$PRJDIR/bin"
        [ -z "$CIVIBUILD_HOME" ] && TMPDIR="$PRJDIR/app/tmp" || TMPDIR="$CIVIBUILD_HOME/.civibuild/tmp"
        LOCKFILE="$TMPDIR/civi-download-tools.lock"
      set +e
      shift
      ;;

    *)
      echo "Unrecognized option: $OPTION"
      echo "Usage: $0 [-q|--quiet] [-f|--force] [--full] [--dir <path>]"
      ;;
  esac
done

###############################################################################
## usage: download_url <url> <out-file>
function download_url() {
  #php -r "echo file_get_contents('$1');" > $2
  if which wget >> /dev/null ; then
    wget -O "$2" "$1"
  elif which curl >> /dev/null ; then
    curl -L -o "$2" "$1"
  else
    echo "error: failed to locate curl or wget"
  fi
}


###############################################################################
## usage: echo_comment <message>
function echo_comment() {
  if [ -z "$IS_QUIET" ]; then
    echo "$@"
  fi
}

###############################################################################
## usage: do_php_mysql_warning
function do_php_mysql_warning() {
  echo "Warning: This system will not support the php-mysql extension."
  echo ""
  echo "This means you will be unable to install CiviCRM version 4.7.11 or earlier (including any 4.6.x version)."
  echo "For further details see: https://civicrm.org/blog/totten/psa-please-verify-php-extension-mysqli and https://issues.civicrm.org/jira/browse/CRM-17789"
}

###############################################################################
## Make a symlink... gently.
## usage: make_link <workdir> <from> <to>
function make_link() {
  local workdir="$1"
  local from="$2"
  local to="$3"
  pushd "$workdir" >> /dev/null
    if [ -L "$to" ]; then
      local oldLink=$(readlink "$to")
      if [ -n "$oldLink" -a "$oldLink" != "$from" ]; then
        rm -f "$to"
      fi
    fi
    if [ ! -e "$to" ]; then
      echo_comment "[[Create symlink $to in $workdir]]"
      ln -s "$from" "$to"
    fi
    ## FIXME: ideally, provide a notice if the file-exists and is *not* the expected link
  popd >> /dev/null
}

###############################################################################
## Ensure that the current user has permission to write to a given folder.
##
## This addresses the issue where somone has erroneously executed `composer`
## or `npm` or `bower` or somesuch as `root`.
## usage: check_path_ownership <dir>
function check_datafile_ownership() {
  local tgtdir="$1"
  if [ ! -e "$tgtdir" ]; then
    return
  fi

  local tgtuser=$(whoami)
  local files=$( find "$tgtdir" ! -user $tgtuser 2>&1 )
  if [ -n "$files" ]; then
    echo "WARNING: The following data-files are not owned by your user, which may lead to permission issues. You may need to delete or chown them." >&2
    echo "$ find "$tgtdir" ! -user $tgtuser"
    echo "$files"
    echo ""
  fi
}

###############################################################################
## Ensure that a command is on the PATH. If missing, then give
## advice on possible resolutions and exit.
## usage: check_command <command-name> <required|recommended> [<msg>]
function check_command() {
  local cmd="$1"
  local requirement="$2"
  local msg="$3"
  [ -z "$msg" ] && msg="Failed to locate command \"$cmd\". Please install it (and set the PATH appropriately)."

  cmdpath=$(which $cmd)
  if [ -z "$cmdpath" ]; then
    echo "$msg"
    show_command "$cmd" "It is possible that you have already installed \"$cmd\" in a non-standard location. If so, please update the PATH appropriately. Possible matches were found in:"
    if [ "$requirement" = "required" ]; then
      exit 3
    fi
  fi
}

###############################################################################
## Show a list of possible locations where the command can be found
## usage: show_command <command-name> [<msg>]
function show_command() {
    local cmd="$1"
    local msg="$2"
    local is_first=1
    for altdir in \
      /Applications/MAMP/Library/bin \
      /Applications/MAMP/bin/php/php*/bin \
      /{usr,opt}{,/local}/bin \
      /{usr,opt}{,/local}/*/bin \
      /{usr,opt}{,/local}/lib/*/bin
    do
      if [ -f "$altdir/$cmd" ]; then
        if [ -n "$is_first" ]; then
          echo $msg
          is_first=
        fi
        echo " * $altdir"
      fi
    done
}

###############################################################################
## Debian.org's NodeJS package uses a non-standard name for the node binary.
## If necessary, setup an alias for the standard name.
function nodejs_debian_workaround() {
  if which nodejs &> /dev/null ; then
    if ! which node &> /dev/null ; then
      echo "[[NodeJS binary appears to be misnamed. Creating 'node' alias.]]"
      ln -s "$(which nodejs)" "$BINDIR/node"
    fi
  fi
}

###############################################################################
## Check if a PHP extension is enabled
## usage: check_php_ext <command-name> <required|recommended> [<msg>]
##
## Note: There's not much harm in calling check_php_ext for more requirements,
## but bear in mind that this only handles requirements for buildkit CLI.
## For civicrm-core runtime, the app should have its own checks.
function check_php_ext() {
  local ext="$1"
  local requirement="$2"
  local msg="$3"

  if [ -z "$msg" -a "$requirement" = "required" ]; then
    msg="ERROR: Failed to find required PHP extension \"$ext\"."
  elif [ -z "$msg" -a "$requirement" = "recommended" ]; then
    msg="WARNING: Failed to find recommended PHP extension \"$ext\"."
  fi

  if php -r 'exit((int)in_array("'$ext'", get_loaded_extensions()));' ; then
    echo "$msg"

    if [ "$requirement" = "required" ]; then
      echo ""
      if [ `uname` = "Darwin" ]; then
        echo "TIP: In OS X, it is common to install an alternative PHP bundle, such as MAMP or XAMPP, which provides more extensions by default."
        show_command php "TIP: You may wish to configure a PATH to choose a different version of PHP. The following versions were found automatically:"
      fi
      if [ `uname` = "Linux" ]; then
        echo "TIP: In some systems, the PHP version used in CLI and web are different. Extensions should be active in both."
      fi
      exit 4
    fi
  fi
}

###############################################################################
## Prompt user for confirmation
## (In automated scripts or blank response, use default)
##
## usage: cvutil_confirm <message> <interactive-default> <script-default>
## example: cvutil_confirm "Are you sure? [Y/n] " y y
function cvutil_confirm() {
  local msg="$1"
  local i_default="$2"
  local s_default="$3"
  if tty -s ; then
    echo -n "$msg"
    read _cvutil_confirm
    if [ "x$_cvutil_confirm" == "x" ]; then
      _cvutil_confirm="$i_default"
    fi
  else
    echo "${msg}${s_default}"
    _cvutil_confirm="$s_default"
  fi
  case "$_cvutil_confirm" in
    y|Y|1)
      return 0
      ;;
    *)
      return 1
      ;;
  esac
}

###############################################################################
## usage: get_hub_url <version>

# Examples:
# https://github.com/github/hub/releases/download/v2.2.3/hub-darwin-amd64-2.2.3.tgz
# https://github.com/github/hub/releases/download/v2.2.3/hub-linux-386-2.2.3.tgz
# https://github.com/github/hub/releases/download/v2.2.3/hub-linux-amd64-2.2.3.tgz
# https://github.com/github/hub/releases/download/v2.2.3/hub-windows-386-2.2.3.zip
# https://github.com/github/hub/releases/download/v2.2.3/hub-windows-amd64-2.2.3.zip

function get_hub_url() {
  local VERSION="$1"
  local PLATFORM=
  local FORMAT=

  case $(uname -a) in
    *Darwin*x86_64*)
      PLATFORM=darwin-amd64
      FORMAT=tgz
      ;;
    *Linux*x86_64*)
      PLATFORM=linux-amd64
      FORMAT=tgz
      ;;
    *Linux*i386*|*Linux*i686*)
      PLATFORM=linux-386
      FORMAT=tgz
      ;;
    *)
      echo ""
      return
  esac

  echo https://github.com/github/hub/releases/download/v${VERSION}/hub-${PLATFORM}-${VERSION}.${FORMAT}
}

function install_composer() {
  if [ -z "$IS_FORCE" -a -e "$PRJDIR/bin/composer" -a "$(cat $PRJDIR/extern/composer.txt)" == "$COMPOSER_VERSION" ]; then
    echo_comment "[[composer ($PRJDIR/bin/composer) already exists. Skipping.]]"
  else
    if [ -z "$COMPOSER_URL" ]; then
      echo "[[Skip composer. Could not determine binary.]]"
    else
      echo "[[Download composer]]"
      download_url "$COMPOSER_URL" "$PRJDIR/bin/composer"
      chmod ugo+x "$PRJDIR/bin/composer"
      echo "$COMPOSER_VERSION" > "$PRJDIR/extern/composer.txt"
    fi
  fi
}

###############################################################################
## Install the project 'joomlatools/console' in 'extern/joomlatools-console'
## Note that this uses a separate folder becuase:
##  1. Some of the dependencies don't agree with other top-level packages.
##  2. The file structure allows writing data to funny places.
##
## usage: install_joomlatools_console <version-tag-branch>
function install_joomlatools_console() {
  local VERSION="$1"
  local WRAPPER="$PRJDIR/bin/joomla"
  local SRC="$PRJDIR/extern/joomlatools-console"
  local MARKER="$PRJDIR/extern/joomlatools-console.txt"

  ## Create/update wrapper script
  ## Note: joomla was previously downloaded via other means (and gitignored). This "cp" ensures we overwrite without git conflicts.
  if [ ! -f "$WRAPPER" -o "$PRJDIR/src/joomlatools-console.tmpl" -nt  "$WRAPPER" ]; then
    echo "[[joomlatools-console ($WRAPPER): Generate wrapper]]"
    cp "$PRJDIR/src/joomlatools-console.tmpl" "$WRAPPER"
  fi

  ## Do we need to download?
  touch "$MARKER"
  if [ -z "$IS_FORCE" -a -e "$SRC/bin/joomla" -a "$(cat $MARKER)" == "$VERSION" ]; then
    echo_comment "[[joomla ($PRJDIR/extern/joomlatools-console) already exists. Skipping.]]"
    return
  fi
  echo "[[Install joomlatools-console $VERSION]]"

  ## Cleanup any previous downloads
  [ -e "$SRC" ] && rm -rf "$SRC"

  ## Download
  git clone -b "$VERSION" --depth 1 https://github.com/joomlatools/joomlatools-console "$SRC"
  pushd "$SRC" >> /dev/null
    ## In 1.5.9, the lock file is pegged to libraries that aren't compatible with our env. Resolve dependencies anew.
    rm -f composer.lock
    "$PRJDIR/bin/composer" update --prefer-lowest
    "$PRJDIR/bin/composer" install
  popd >> /dev/null

  ## Mark as downloaded
  echo "$VERSION" > "$MARKER"
}

###############################################################################
## Determine the function to handle system package installation
function get_system_installer() {
  if [ -n "$DISTRIB_CODENAME" ]; then
    true
  elif which lsb_release >/dev/null; then
    # Debian doesn't ship with /etc/lsb-release. See
    # https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=444678
    DISTRIB_CODENAME=$(lsb_release -cs)
  elif [ -f "/etc/lsb-release" ]; then
    source /etc/lsb-release
  fi
  case "$DISTRIB_CODENAME" in
    stretch|buster|bullseye|bionic|focal|jammy)
      echo "do_system_$DISTRIB_CODENAME"
      ;;
    *)
      echo do_system_unknown
      ;;
  esac
}

###############################################################################

function do_system_xenial() { # LTS Removal Oct 2021
  set -e
    PACKAGES="acl git wget unzip zip mysql-server mysql-client php7.3-cli php7.3-imap php7.3-ldap php7.3-curl php7.3-mysql php7.3-intl php7.3-gd php7.3-mcrypt php7.3-bcmath php7.3-mbstring php7.3-soap php7.3-zip php7.3-xml apache2 libapache2-mod-php7.3 nodejs"
    UBUNTU_VERSION=$(lsb_release -ds)
    echo "Detected $UBUNTU_VERSION."
    echo ""
    echo "Task: $PACKAGES"
    echo ""
    do_php_mysql_warning
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo add-apt-repository -y ppa:ondrej/php
      sudo curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - # This runs sudo apt update so there's no point running it twice.
      sudo apt-get update
      sudo apt-get -y install $PACKAGES
      sudo phpenmod bcmath
      sudo phpenmod curl
      sudo phpenmod imap
      sudo phpenmod xml
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_bionic() { # LTS Removal October 2023
  set -e
    PACKAGES="acl git wget unzip zip mysql-server mysql-client php7.4-cli php7.4-imap php7.4-ldap php7.4-curl php7.4-mysql php7.4-intl php7.4-gd php7.4-dev php7.4-bcmath php7.4-mbstring php7.4-soap php7.4-zip php7.4-xml apache2 libapache2-mod-php7.4 nodejs php-pear libmcrypt-dev libreadline-dev curl"
    UBUNTU_VERSION=$(lsb_release -ds)
    echo "Detected $UBUNTU_VERSION."
    echo ""
    echo "Task: $PACKAGES"
    echo ""
    do_php_mysql_warning
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo add-apt-repository -y ppa:ondrej/php
      sudo curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - # This runs sudo apt update so there's no point running it twice.
      sudo apt-get -y install $PACKAGES
      sudo phpenmod bcmath
      sudo phpenmod curl
      sudo phpenmod imap
      sudo phpenmod xml
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_jammy() { # LTS Removal October 2027
  set -e
    PACKAGES="acl git wget unzip zip mysql-server mysql-client php7.4-cli php7.4-imap php7.4-ldap php7.4-curl php7.4-mysql php7.4-intl php7.4-gd php7.4-dev php7.4-bcmath php7.4-mbstring php7.4-soap php7.4-zip php7.4-xml apache2 libapache2-mod-php7.4 nodejs php-pear libreadline-dev curl"
    UBUNTU_VERSION=$(lsb_release -ds)
    echo "Detected $UBUNTU_VERSION."
    echo ""
    echo "Task: $PACKAGES"
    echo ""
    do_php_mysql_warning
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo add-apt-repository -y ppa:ondrej/php
      sudo curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - # This runs sudo apt update so there's no point running it twice.
      sudo apt-get -y install $PACKAGES
      sudo phpenmod bcmath
      sudo phpenmod curl
      sudo phpenmod imap
      sudo phpenmod xml
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_focal() { # LTS Removal October 2025
  set -e
    PACKAGES="acl git wget unzip zip mysql-server mysql-client php7.4-cli php7.4-imap php7.4-ldap php7.4-curl php7.4-mysql php7.4-intl php7.4-gd php7.4-dev php7.4-bcmath php7.4-mbstring php7.4-soap php7.4-zip php7.4-xml apache2 libapache2-mod-php7.4 nodejs php-pear libreadline-dev curl"
    UBUNTU_VERSION=$(lsb_release -ds)
    echo "Detected $UBUNTU_VERSION."
    echo ""
    echo "Task: $PACKAGES"
    echo ""
    do_php_mysql_warning
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo add-apt-repository -y ppa:ondrej/php
      sudo curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - # This runs sudo apt update so there's no point running it twice.
      sudo apt-get -y install $PACKAGES
      sudo phpenmod bcmath
      sudo phpenmod curl
      sudo phpenmod imap
      sudo phpenmod xml
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_stretch() {
  set -e
    PACKAGES="acl git wget unzip zip mysql-server mysql-client php7.3-cli php7.3-imap php7.3-ldap php7.3-curl php7.3-mysql php7.3-intl php7.3-gd php7.3-dev php7.3-bcmath php7.3-mbstring php7.3-soap php7.3-zip php7.3-xml apache2 libapache2-mod-php7.3 nodejs"
    echo "Detected \"Debian Stretch\"."
    echo ""
    echo "Installing nodejs Debian repository."
    echo ""
    echo "Recommended packages: $PACKAGES"
    echo ""
    do_php_mysql_warning
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo apt-get -y install ca-certificates apt-transport-https wget
      wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add -
      sudo echo "deb https://packages.sury.org/php/ stretch main" | tee /etc/apt/sources.list.d/php.list
      wget -O- https://deb.nodesource.com/setup_14.x | sudo -E bash -
      sudo apt-get -y install $PACKAGES
      sudo phpenmod imap
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_buster() {
  set -e
    PACKAGES="acl git wget unzip zip default-mysql-server default-mysql-client php7.4-cli php7.4-imap php7.4-ldap php7.4-curl php7.4-mysql php7.4-intl php7.4-gd php7.4-dev php7.4-bcmath php7.4-mbstring php7.4-soap php7.4-zip php7.4-xml apache2 libapache2-mod-php7.4 nodejs php-pear"
    echo "Detected \"Debian Buster\"."
    echo ""
    echo "Recommended packages: $PACKAGES"
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo apt-get -y install ca-certificates apt-transport-https wget
      wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add -
      sudo echo "deb https://packages.sury.org/php/ buster main" | tee /etc/apt/sources.list.d/php.list
      wget -O- https://deb.nodesource.com/setup_14.x | sudo -E bash -
      sudo apt-get -y install $PACKAGES
      sudo phpenmod imap
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_bullseye() {
  set -e
    PACKAGES="acl git wget unzip zip default-mysql-server default-mysql-client php7.4-cli php7.4-imap php7.4-ldap php7.4-curl php7.4-mysql php7.4-intl php7.4-gd php7.4-dev php7.4-bcmath php7.4-mbstring php7.4-soap php7.4-zip php7.4-xml apache2 libapache2-mod-php7.4 nodejs php-pear"
    echo "Detected \"Debian Bullseye\"."
    echo ""
    echo "Recommended packages: $PACKAGES"
    echo ""
    if cvutil_confirm "Run automated installation? [Y/n] " y y; then
      sudo apt-get -y install ca-certificates apt-transport-https wget
      wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add -
      sudo echo "deb https://packages.sury.org/php/ bullseye main" | sudo tee /etc/apt/sources.list.d/php.list
      wget -O- https://deb.nodesource.com/setup_14.x | sudo -E bash -
      sudo apt-get -y install $PACKAGES
      sudo phpenmod imap
      sudo a2enmod rewrite
      sudo apache2ctl restart
    else
      echo "Aborted" 1>&2
      exit 1
    fi
  set +e
}

###############################################################################

function do_system_unknown() {
  echo "ERROR: Could not identify the required system packages."
  echo ""
  echo "System specific install steps are removed when an OS release is marked as end-of-life. (Ubuntu/Debian)"
  echo ""
  echo "If you want to add support for a new system, update 'get_system_installer()'"
  echo "and add a new 'do_system_*()' function."
  echo ""
  echo "If you are running Debian you may need to install the lsb-release package."
  exit 1
}

##################################################
## Perform system installation (if requested)
if [ -n "$IS_FULL" ]; then
  SYSTEM_FUNC=$(get_system_installer)
  if [[ $SYSTEM_FUNC =~ ^[a-zA-Z0-9_]+$ ]]; then
    $SYSTEM_FUNC
  else
    echo "ERROR: Malformed system function: $SYSTEM_FUNC"
    exit 2
  fi

  if [ ! -f "$PRJDIR/composer.json" ]; then
    set -e
      echo "[[ Clone civicrm-buildkit to $PRJDIR ]]"
      git clone "https://github.com/civicrm/civicrm-buildkit.git" "$PRJDIR"
    set +e
  fi
fi

##################################################
## Validation
check_command php required
check_command mysql required
check_command mysqldump required
check_command git required
check_command tar required
check_command bzip2 required
check_command gzip required
check_command unzip required
check_command zip required

check_php_ext Phar required
check_php_ext SimpleXML required
check_php_ext SPL required
check_php_ext curl required
check_php_ext date required
check_php_ext json required
check_php_ext libxml required
check_php_ext pcre required
check_php_ext pdo_mysql required
check_php_ext xml required

nodejs_debian_workaround

if [ ! -d "$TMPDIR" ]; then
  mkdir -p "$TMPDIR"
fi

##################################################
## Only allow one concurrent process
if php -d xdebug.remote_enable=off $BINDIR/pidlockfile.php "$LOCKFILE" $$ 5 ; then
  ## we acquired lock quickly; no need to bug user with output
  true
else
  OLDPID=$(cat "$LOCKFILE")
  echo "[[civi-download-tools: Already locked by PID $OLDPID; waiting up $LOCKTIMEOUT seconds]]"
  if php $BINDIR/pidlockfile.php "$LOCKFILE" $$ $LOCKTIMEOUT ; then
    echo "[[civi-download-tools: Lock acquired]]"
  else
    exit 1
  fi
fi

##################################################
## Begin execution
set -e
pushd $PRJDIR >> /dev/null

  ## Check that data folders/files are writeable. Since this is expensive, only do it on new systems.
  if [ -z "$IS_QUIET" -o ! -d vendor -o ! -d node_modules ]; then
    [ -n "$COMPOSER_CACHE_DIR" ] && check_datafile_ownership "$COMPOSER_CACHE_DIR"
    [ -z "$COMPOSER_CACHE_DIR" ] && check_datafile_ownership "$HOME/.composer"
    check_datafile_ownership "$HOME/.cache"
    check_datafile_ownership "$HOME/.npm"
    [ -n "$AMPHOME" ] && check_datafile_ownership "$AMPHOME"
    [ -z "$AMPHOME" ] && check_datafile_ownership "$HOME/.amp/apache.d"
  fi

  [ ! -d "$PRJDIR/extern" ] && mkdir "$PRJDIR/extern"

  ## Cleanup previous PHAR downloads before composer-downloads-plugin takes a crack at it.
  [ -f "$PRJDIR/extern/_phpunit4.txt" ] && rm -f "$PRJDIR/extern/phpunit4/phpunit4.phar" "$PRJDIR/extern/_phpunit4.txt"
  [ -f "$PRJDIR/extern/_phpunit5.txt" ] && rm -f "$PRJDIR/extern/phpunit5/phpunit5.phar" "$PRJDIR/extern/_phpunit5.txt"
  [ -f "$PRJDIR/extern/_phpunit6.txt" ] && rm -f "$PRJDIR/extern/phpunit6/phpunit6.phar" "$PRJDIR/extern/_phpunit6.txt"
  [ -f "$PRJDIR/extern/amp.txt" ] && rm -f "$PRJDIR/bin/amp" "$PRJDIR/extern/amp.txt"
  [ -f "$PRJDIR/extern/box.txt" ] && rm -f "$PRJDIR/bin/box" "$PRJDIR/extern/box.txt"
  [ -f "$PRJDIR/extern/civistrings.txt" ] && rm -f "$PRJDIR/bin/civistrings" "$PRJDIR/extern/civistrings.txt"
  [ -f "$PRJDIR/extern/civix.txt" ] && rm -f "$PRJDIR/bin/civix" "$PRJDIR/extern/civix.txt"
  [ -f "$PRJDIR/extern/cv.txt" ] && rm -f "$PRJDIR/bin/cv" "$PRJDIR/extern/cv.txt"
  [ -f "$PRJDIR/extern/drush8.txt" ] && rm -f "$PRJDIR/extern/drush8.phar" "$PRJDIR/extern/drush8.txt"
  [ -f "$PRJDIR/extern/git-scan.txt" ] && rm -f "$PRJDIR/bin/git-scan" "$PRJDIR/extern/git-scan.txt"
  [ -f "$PRJDIR/extern/wp-cli.txt" ] && rm -f "$PRJDIR/bin/wp" "$PRJDIR/extern/wp-cli.txt"
  [ -f "$PRJDIR/extern/civici.txt" ] && rm -f  "$PRJDIR/bin/civici" "$PRJDIR/extern/civici.txt"
  [ -f "$PRJDIR/extern/joomla.txt" ] && rm -f "$PRJDIR/bin/joomla" "$PRJDIR/extern/joomla.txt"
  [ -f "$PRJDIR/extern/codecept-php5.txt" ] && rm -f "$PRJDIR/bin/_codecept-php5.phar" "$PRJDIR/extern/codecept-php5.txt"
  [ -f "$PRJDIR/extern/codecept-php7.txt" ] && rm -f "$PRJDIR/bin/_codecept-php7.phar" "$PRJDIR/extern/codecept-php7.txt"
  [ -f "$PRJDIR/extern/drush-lib-backdrop.txt" ] && rm -rf "$PRJDIR/extern/drush-lib/backdrop" "$PRJDIR/extern/drush-lib-backdrop.txt"
  [ -f "$PRJDIR/bin/_codecept-php5.phar" ] && rm -f "$PRJDIR/bin/_codecept-php5.phar"
  [ -f "$PRJDIR/bin/_codecept-php7.phar" ] && rm -f "$PRJDIR/bin/_codecept-php7.phar"
  [ -L "$PRJDIR/bin/phpunit4" ] && rm -f "$PRJDIR/bin/phpunit4"
  [ -f "$PRJDIR/extern/phpunit4/phpunit4.phar" ] && rm -f "$PRJDIR/extern/phpunit4/phpunit4.phar"

  ## Cleanup misnamed files from past
  [ -f "$PRJDIR/extern/phpunit4/phpunit6.phar" ] && rm -f "$PRJDIR/extern/phpunit4/phpunit6.phar" "$PRJDIR/extern/phpunit4/phpunit6.phar"
  [ -f "$PRJDIR/extern/phpunit5/phpunit6.phar" ] && rm -f "$PRJDIR/extern/phpunit5/phpunit6.phar" "$PRJDIR/extern/phpunit5/phpunit6.phar"

  ## Download "composer"
  install_composer

  ## Download dependencies (via composer)
  COMPOSER_MD5=$(cat composer.json composer.lock phars.json | php -r 'echo md5(file_get_contents("php://stdin"));')
  touch "$TMPDIR/composer-data.md5"
  if [ -z "$IS_FORCE" -a "$(cat $TMPDIR/composer-data.md5)" == "$COMPOSER_MD5" ]; then
    echo_comment "[[composer dependencies already installed. Skipping.]]"
  else
    "$PRJDIR/bin/composer" install
    cat composer.json composer.lock phars.json | php -r 'echo md5(file_get_contents("php://stdin"));' > "$TMPDIR/composer-data.md5"
  fi

  ## Download dependencies (via npm)
  if which npm > /dev/null ; then
    PACKAGE_MD5=$(cat package.json | php -r 'echo md5(file_get_contents("php://stdin"));')
    touch "$TMPDIR/package-data.md5"
    if [ -z "$IS_FORCE" -a "$(cat $TMPDIR/package-data.md5)" == "$PACKAGE_MD5" -a -d "$PRJDIR/node_modules" ]; then
      echo_comment "[[npm dependencies already installed. Skipping.]]"
    else
      npm install
      cat package.json | php -r 'echo md5(file_get_contents("php://stdin"));' > "$TMPDIR/package-data.md5"
    fi
    for f in node_modules/bower/bin/bower node_modules/karma/bin/karma node_modules/jshint/bin/jshint node_modules/karma-phantomjs-launcher/node_modules/phantomjs/bin/phantomjs node_modules/protractor/bin/protractor node_modules/protractor/node_modules/webdriver-manager/bin/webdriver-manager node_modules/grunt-cli/bin/grunt ; do
      pushd "$PRJDIR/bin" >> /dev/null
        toolname=$(basename $f)
        if [ -f "../$f" -a ! -L "$toolname" ]; then
          ln -s ../$f $toolname
        fi
      popd >> /dev/null
    done
  fi

  ## Cleanup old civix tarballs
  [ -d "$PRJDIR/extern/civix" ] && rm -rf "$PRJDIR/extern/civix"

  ## Cleanup old phpunit files
  for OLDFILE in "$PRJDIR/bin/phpunit4" "$PRJDIR/bin/phpunit5" "$PRJDIR/extern/phpunit4.txt" "$PRJDIR/extern/phpunit5.txt"; do
    if [ -f "$OLDFILE" -a ! -L "$OLDFILE" ]; then
      echo_comment "[[Removing old file $OLDFILE]]"
      rm -f "$OLDFILE"
    fi
  done

  if [ ! -f "$PRJDIR/bin/drush8" -o "$PRJDIR/src/drush/drush8.tmpl" -nt  "$PRJDIR/bin/drush8" ]; then
    ## drush8 was previously downloaded directly. This "cp" ensures we overwrite without git conflicts.
    echo "[[drush8 ($PRJDIR/bin/drush8): Generate wrapper]]"
    cp "$PRJDIR/src/drush/drush8.tmpl" "$PRJDIR/bin/drush8"
  fi

  ## Setup aliases for pogo scripts
  POGO_TPL="$PRJDIR/src/pogo/wrapper.sh"
  IS_POGO_PREFETCH=$(php -r 'echo version_compare(PHP_VERSION, "7.3.0", ">=") ? "1" : "";')
  ## A few less-used scripts don't install on php72. For php72, we'll get dependencies lazily.
  ls src/pogo/*.php | while read POGO_PHP ; do
    POGO_BASENAME=$( basename "$POGO_PHP" | sed 's;\.php$;;' )
    POGO_STUB="$PRJDIR/bin/$POGO_BASENAME"
    POGO_DEPS="$PRJDIR/extern/$POGO_BASENAME-php{PHP_XY}"
    if [ ! -e "$POGO_STUB" -o "$POGO_TPL" -nt "$POGO_STUB" ]; then
      echo_comment "[[$POGO_BASENAME updated ($POGO_STUB => $PRJDIR/$POGO_PHP)]]"
      cp "$POGO_TPL" "$POGO_STUB"
    fi
    if [ -n "$IS_POGO_PREFETCH" -a -z "$IS_QUIET" -a ! -d "$POGO_DEPS" ]; then
      env PATH="$PRJDIR/bin:$PATH" \
        "$PRJDIR/bin/pogo" --get --dl="$POGO_DEPS" -- "$PRJDIR/src/pogo/$POGO_BASENAME.php"
      ## TIP: Looking to save a little disk? You could use `--phar` instead of bash stubs. But then it's
      ## more clicks to edit in an IDE, and you lose support for splitting PHP dependencies.
    fi
  done

  ## Setup phpunit aliases for CLI usage
  make_link "$PRJDIR/bin" "drush8" "drush"
  make_link "$PRJDIR/bin" "../extern/phpunit5/phpunit5.phar" "phpunit5"
  make_link "$PRJDIR/bin" "../extern/phpunit6/phpunit6.phar" "phpunit6"
  make_link "$PRJDIR/bin" "../extern/phpunit7/phpunit7.phar" "phpunit7"
  make_link "$PRJDIR/bin" "../extern/phpunit8/phpunit8.phar" "phpunit8"
  make_link "$PRJDIR/bin" "../extern/phpunit9/phpunit9.phar" "phpunit9"

  ## Download joomlatools-console
  install_joomlatools_console "$JOOMLATOOLS_CONSOLE_VERSION"

  ## Download "hub"
  touch "$PRJDIR/extern/hub.txt"
  if [ -z "$IS_FORCE" -a -e "$PRJDIR/extern/hub/bin/hub" -a -e "$PRJDIR/bin/hub" -a "$(cat $PRJDIR/extern/hub.txt)" == "$HUB_VERSION" ]; then
    echo_comment "[[hub ($PRJDIR/extern/hub) already exists. Skipping.]]"
  else
    HUBURL=$(get_hub_url $HUB_VERSION)
    if [ -z "$HUBURL" ]; then
      echo "[[Skip hub. Could not determine binary.]]"
    else
      echo "[[Install hub]]"

      ## Cleanup
      [ -e app/tmp/hub ] && rm -rf app/tmp/hub
      [ -e extern/hub ] && rm -rf extern/hub
      [ -e "$TMPDIR/hub.tgz" ] && rm -f "$TMPDIR/hub.tgz"
      mkdir -p app/tmp extern/hub

      ## Download
      download_url "$HUBURL" "$TMPDIR/hub.tgz"

      ## Build
      pushd extern/hub >> /dev/null
        tar --strip-components=1 -xvzf "$TMPDIR/hub.tgz"
      popd >> /dev/null

      ## Setup a relative symlink
      pushd bin >> /dev/null
        [ -f hub ] && rm -f hub
        ln -s ../extern/hub/bin/hub hub
      popd >> /dev/null

      ## Mark as downloaded
      echo "$HUB_VERSION" > "$PRJDIR/extern/hub.txt"

    fi
  fi

popd >> /dev/null
set +e

##################################################
## Recommendations
##
## Note: Non-fatal recommendations come at the end so that they appear as
## the last output (which is most likely to be read).

check_php_ext bcmath recommended
check_php_ext gd recommended
check_php_ext gettext recommended
check_php_ext hash recommended
check_php_ext imap recommended
check_php_ext intl recommended
check_php_ext mbstring recommended

check_php_ext mysqli recommended   ## >= 4.7.12
check_php_ext openssl recommended
check_php_ext session recommended
check_php_ext zip recommended

check_command node recommended "WARNING: Failed to locate command \"node\". NodeJS (http://nodejs.org/) is required for development of CiviCRM v4.6+."
check_command npm recommended "WARNING: Failed to locate command \"npm\". NodeJS (http://nodejs.org/) is required for development of CiviCRM v4.6+."

##################################################
## Cleanup
rm -f "$LOCKFILE"

exit
}