Merge pull request #1 from Dropelikeit/feature/add-phpflex

Add installation and uninstallation script for PHPFlex

Author: Dropelikeit

README.md

@@ -0,0 +1,60 @@
+# PHPFlex
+
+PHPFlex is a powerful command-line tool that allows developers to seamlessly switch between multiple PHP versions on their local environment. It provides a simple way to specify the desired PHP version for running commands or scripts, making it ideal for testing, development, and debugging across various PHP environments.
+
+# _Features_:
+
+- Version Switching: Instantly switch to any installed PHP version (e.g., 8.1, 8.2, 8.3) without changing system settings.
+- Command Execution: Run any PHP command or script with the specified version directly from the terminal.
+- User-friendly: Single function for all versions, simplifying multi-version management.
+- Error Handling: Clear error messages if the specified PHP version is not found.
+
+```bash
+# Check the PHP version for 8.1
+phpFlex 8.1 -v
+
+# Run a PHP script with version 8.2
+phpFlex 8.2 myscript.php
+
+# Execute an inline PHP command with version 8.3
+phpFlex 8.3 -r 'echo "Hello, PHP 8.3!";'
+```
+
+# Installation
+
+---
+To start using PHPFlex, execute the script `install.sh`. It checks whether you are using bash or zsh and installs PHPFlex to your configuration file.
+
+*Hint:* It is important that you reload your configuration after installation to use PHPFlex.
+
+Sometimes it is necessary to set the correct permission to run the script
+```bash
+chmod -x install.sh && \
+./install.sh \
+source ~/<.zshrc | .bashrc>
+```
+
+# Uninstall
+
+---
+
+To stop using PHPFlex, run the script `uninstall.sh`. It create a backup file of your configuration before PHPFlex is removed.
+
+*Hint:* It is important to reload your configuration to remove PHPFlex from your current commandline session.
+
+Sometimes it is necessary to set the correct permission to run the script
+```bash
+chmod -x uninstall.sh && \
+./uninstall.sh \
+source ~/<.zshrc | .bashrc>
+```
+
+# Contributions
+
+---
+
+Help us to improve this project by reporting bugs, enhancement requests or other suggestions via the issue tracker.
+
+After creating the issue tracker, it is also possible to create a PR with reference to the issue.
+
+Thank you very much for your support!

install.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+
+# declaration
+GREEN="\033[32m"
+RED="\033[31m"
+
+# PHPFlex function
+php_flex_function='
+phpFlex() {
+  local version=$1
+  if [[ -z $version ]]; then
+    echo "Please specify a PHP version, e.g., phpFlex 8.1 -v"
+    return 1
+  fi
+
+  # ignore parameter one because it is not necessary for the php command
+  shift
+
+  local php_path=$(find /usr/local/Cellar/php@${version} -name "php" 2>/dev/null | head -n 1)
+  if [[ -z $php_path ]]; then
+    php_path=$(find /usr/local/Cellar/php/${version} -name "php" 2>/dev/null | head -n 1)
+  fi
+  if [[ -n $php_path ]]; then
+    "$php_path" "$@"
+  else
+    echo "PHP $version not found."
+    return 1
+  fi
+}
+'
+
+# Check, which shell is currently being used to find the correct configuration file
+if [[ $SHELL == *"zsh"* ]]; then
+  shell_config="$HOME/.zshrc"
+elif [[ $SHELL == *"bash"* ]]; then
+  shell_config="$HOME/.bashrc"
+else
+  echo "Unsupported shell. Only zsh and bash are supported."
+  exit 1
+fi
+
+# Add the function if it does not yet exist.
+if grep -q "phpFlex()" "$shell_config"; then
+  echo -e "${RED}The phpFlex function is already defined in $shell_config."
+else
+  echo "$php_flex_function" >> "$shell_config"
+  echo "phpFlex function added to $shell_config."
+  echo "Please run 'source $shell_config' or restart your terminal to apply the changes. You can use \"source "
+  echo -e "${GREEN}You can use following command to reload your configuration file:"
+
+  COMMAND=source $shell_config
+  LINK_TEXT="source $shell_config"
+
+  CLICKABLE_LINK="\033]8;;${COMMAND}\033\\${LINK_TEXT}\033]8;;\033\\"
+
+  echo -e "${GREEN}${CLICKABLE_LINK}"
+fi

uninstall.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+# declaration
+GREEN="\033[32m"
+
+if [[ $SHELL == *"zsh"* ]]; then
+  shell_config="$HOME/.zshrc"
+elif [[ $SHELL == *"bash"* ]]; then
+  shell_config="$HOME/.bashrc"
+else
+  echo "Unsupported shell. Only zsh and bash are supported."
+  exit 1
+fi
+
+echo "A backup of your original configuration file is saved as ${shell_config}.bak."
+cp "$shell_config" "${shell_config}.bak"
+
+sed -i.bak '/phpFlex()/,/^}/d' "$shell_config"
+echo "phpFlex function has been removed from $shell_config."
+
+echo "Please run 'source $shell_config' or restart your terminal to apply the changes."
+echo -e "${GREEN}You can use following command to reload your configuration file:"
+
+COMMAND=source $shell_config
+LINK_TEXT="source $shell_config"
+
+CLICKABLE_LINK="\033]8;;${COMMAND}\033\\${LINK_TEXT}\033]8;;\033\\"
+
+echo -e "${GREEN}${CLICKABLE_LINK}${RESET}"