#!/bin/bash ynh_php_try_bash_extension() { if [ -x src/configure ]; then src/configure && make -C src || { echo "Optional bash extension failed to build, but things will still work normally." } fi } phpenv_install_dir="/opt/phpenv" php_version_path="$phpenv_install_dir/versions" # PHPENV_ROOT is the directory of phpenv, it needs to be loaded as a environment variable. export PHPENV_ROOT="$phpenv_install_dir" # Required dependencies phpenv_dependencies="autoconf2.13 autoconf2.64 autoconf bash bison build-essential ca-certificates curl findutils git libbz2-dev libcurl4-gnutls-dev libicu-dev libjpeg-dev libmcrypt-dev libonig-dev libpng-dev libreadline-dev libsqlite3-dev libssl-dev libtidy-dev libxml2-dev libxslt1-dev libzip-dev pkg-config re2c zlib1g-dev" # Load the version of PHP for an app, and set variables. # # ynh_use_php has to be used in any app scripts before using PHP for the first time. # This helper will provide alias and variables to use in your scripts. # # To use gem or PHP, use the alias `ynh_gem` and `ynh_php` # Those alias will use the correct version installed for the app # For example: use `ynh_gem install` instead of `gem install` # # With `sudo` or `ynh_exec_as`, use instead the fallback variables `$ynh_gem` and `$ynh_php` # And propagate $PATH to sudo with $ynh_php_load_path # Exemple: `ynh_exec_as $app $ynh_php_load_path $ynh_gem install` # # $PATH contains the path of the requested version of PHP. # However, $PATH is duplicated into $php_path to outlast any manipulation of $PATH # You can use the variable `$ynh_php_load_path` to quickly load your PHP version # in $PATH for an usage into a separate script. # Exemple: $ynh_php_load_path $final_path/script_that_use_gem.sh` # # # Finally, to start a PHP service with the correct version, 2 solutions # Either the app is dependent of PHP or gem, but does not called it directly. # In such situation, you need to load PATH # `Environment="__YNH_PHP_LOAD_ENV_PATH__"` # `ExecStart=__FINALPATH__/my_app` # You will replace __YNH_PHP_LOAD_ENV_PATH__ with $ynh_php_load_path # # Or PHP start the app directly, then you don't need to load the PATH variable # `ExecStart=__YNH_PHP__ my_app run` # You will replace __YNH_PHP__ with $ynh_php # # # one other variable is also available # - $php_path: The absolute path to PHP binaries for the chosen version. # # usage: ynh_use_php # # Requires YunoHost version 2.7.12 or higher. ynh_use_php () { php_version=$(ynh_app_setting_get --app=$app --key=php_version) # Get the absolute path of this version of PHP php_path="$php_version_path/$php_version/bin" # Allow alias to be used into bash script shopt -s expand_aliases # Create an alias for the specific version of PHP and a variable as fallback ynh_php="$php_path/php" alias ynh_php="$ynh_php" ynh_fpm_conf="$php_version_path/$php_version/etc/php-fpm.d/$YNH_APP_INSTANCE_NAME.conf" # Load the path of this version of PHP in $PATH if [[ :$PATH: != *":$php_path"* ]]; then PATH="$php_path:$PATH" fi # Create an alias to easily load the PATH ynh_php_load_path="PATH=$PATH" # Sets the local application-specific PHP version pushd $final_path $phpenv_install_dir/bin/phpenv local $php_version popd } # Install a specific version of PHP # # ynh_install_php will install the version of PHP provided as argument by using phpenv. # # phpenv (PHP Version Management) stores the target PHP version in a .php_version file created in the target folder (using phpenv local ) # It then uses that information for every PHP user that uses phpenv provided PHP command # # This helper creates a /etc/profile.d/phpenv.sh that configures PATH environment for phpenv # for every LOGIN user, hence your user must have a defined shell (as opposed to /usr/sbin/nologin) # # Don't forget to execute PHP-dependent command in a login environment # (e.g. sudo --login option) # When not possible (e.g. in systemd service definition), please use direct path # to phpenv shims (e.g. $PHPENV_ROOT/shims/bundle) # # usage: ynh_install_php --php_version=php_version # | arg: -v, --php_version= - Version of PHP to install. # # Requires YunoHost version 2.7.12 or higher. ynh_install_php () { # Declare an array to define the options of this helper. local legacy_args=v local -A args_array=( [v]=php_version= ) local php_version # Manage arguments with getopts ynh_handle_getopts_args "$@" # Install required dependencies ynh_add_app_dependencies --package="$phpenv_dependencies" # Load phpenv path in PATH local CLEAR_PATH="$phpenv_install_dir/bin:$PATH" # Remove /usr/local/bin in PATH in case of PHP prior installation PATH=$(echo $CLEAR_PATH | sed 's@/usr/local/bin:@@') # Move an existing PHP binary, to avoid to block phpenv # test -x /usr/bin/PHP && mv /usr/bin/PHP /usr/bin/php_phpenv # Instal or update phpenv phpenv="$(command -v phpenv $phpenv_install_dir/bin/phpenv | head -1)" if [ -n "$phpenv" ]; then ynh_print_info --message="phpenv already seems installed in \`$phpenv'." pushd "${phpenv%/*/*}" if git remote -v 2>/dev/null | grep -q phpenv; then echo "Trying to update with git..." git pull -q --tags origin master cd .. ynh_php_try_bash_extension fi popd else ynh_print_info --message="Installing phpenv with git..." mkdir -p $phpenv_install_dir pushd $phpenv_install_dir git init -q git remote add -f -t master origin https://github.com/sptndc/phpenv.git > /dev/null 2>&1 git checkout -q -b master origin/master ynh_php_try_bash_extension phpenv=$phpenv_install_dir/bin/phpenv popd fi php_build="$(command -v "$phpenv_install_dir"/plugins/*/bin/phpenv-install phpenv-install | head -1)" if [ -n "$php_build" ]; then ynh_print_info --message="\`phpenv install' command already available in \`$php_build'." pushd "${php_build%/*/*}" if git remote -v 2>/dev/null | grep -q php-build; then ynh_print_info --message="Trying to update phpenv with git..." git pull -q origin master fi popd else ynh_print_info --message="Installing php-build with git..." mkdir -p "${phpenv_install_dir}/plugins" git clone -q https://github.com/php-build/php-build.git "${phpenv_install_dir}/plugins/php-build" fi php_alias="$(command -v "$phpenv_install_dir"/plugins/*/bin/phpenv-alias phpenv-alias | head -1)" if [ -n "$php_alias" ]; then ynh_print_info --message="\`phpenv alias' command already available in \`$php_alias'." pushd "${php_alias%/*/*}" if git remote -v 2>/dev/null | grep -q phpenv-aliases; then ynh_print_info --message="Trying to update phpenv-aliases with git..." git pull -q origin master fi popd else ynh_print_info --message="Installing phpenv-aliases with git..." mkdir -p "${phpenv_install_dir}/plugins" git clone -q https://github.com/madumlao/phpenv-aliases.git "${phpenv_install_dir}/plugins/phpenv-aliase" fi php_composer="$(command -v "$phpenv_install_dir"/plugins/*/libexec/composer composer | head -1)" if [ -n "$php_composer" ]; then ynh_print_info --message="\`composer' command already available in \`$php_composer'." pushd "${php_composer%/*/*}" if git remote -v 2>/dev/null | grep -q phpenv-composer; then ynh_print_info --message="Trying to update phpenv-composer with git..." git pull -q origin master fi popd else ynh_print_info --message="Installing phpenv-composer with git..." mkdir -p "${phpenv_install_dir}/plugins" git clone -q https://github.com/ngyuki/phpenv-composer.git "${phpenv_install_dir}/plugins/phpenv-composer" fi php_latest="$(command -v "$phpenv_install_dir"/plugins/*/bin/phpenv-latest phpenv-latest | head -1)" if [ -n "$php_latest" ]; then ynh_print_info --message="\`phpenv latest' command already available in \`$php_latest'." pushd "${php_latest%/*/*}" if git remote -v 2>/dev/null | grep -q xxenv-latest; then ynh_print_info --message="Trying to update xxenv-latest with git..." git pull -q origin master fi popd else ynh_print_info --message="Installing xxenv-latest with git..." mkdir -p "${phpenv_install_dir}/plugins" git clone -q https://github.com/momo-lab/xxenv-latest.git "${phpenv_install_dir}/plugins/xxenv-latest" fi # Enable caching mkdir -p "${phpenv_install_dir}/cache" # Create shims directory if needed mkdir -p "${phpenv_install_dir}/shims" # Restore /usr/local/bin in PATH PATH=$CLEAR_PATH # And replace the old PHP binary # test -x /usr/bin/php_phpenv && mv /usr/bin/php_phpenv /usr/bin/PHP # Install the requested version of PHP local final_php_version=$(phpenv latest --print $php_version) ynh_print_info --message="Installing PHP$final_php_version" phpenv install --skip-existing $final_php_version > /dev/null 2>&1 ynh_replace_string --match_string="user = nobody" --replace_string="user = www-data" --target_file="$php_version_path/$final_php_version/etc/php-fpm.d/www.conf" ynh_replace_string --match_string="group = nobody" --replace_string="group = www-data" --target_file="$php_version_path/$final_php_version/etc/php-fpm.d/www.conf" ynh_replace_string --match_string="listen = 127.0.0.1:9000" --replace_string="listen = /run/php/php$final_php_version-fpm.sock" --target_file="$php_version_path/$final_php_version/etc/php-fpm.d/www.conf" # Store php_version into the config of this app ynh_app_setting_set --app=$YNH_APP_INSTANCE_NAME --key=php_version --value=$final_php_version # Remove app virtualenv if `phpenv alias --list | grep --quiet "$YNH_APP_INSTANCE_NAME " 1>/dev/null 2>&1` then phpenv alias $YNH_APP_INSTANCE_NAME --remove fi # Create app virtualenv phpenv alias $YNH_APP_INSTANCE_NAME $final_php_version # Cleanup PHP versions ynh_cleanup_php # Install php-fpm service cp -f "$php_version_path/$final_php_version/etc/systemd/system/php-fpm.service" "/etc/systemd/system/php$final_php_version-fpm.service" ynh_replace_string --match_string="PIDFile=$php_version_path/$final_php_version/var/run/php-fpm.pid" --replace_string="PIDFile=/var/run/php/php$final_php_version-fpm.pid" --target_file="/etc/systemd/system/php$final_php_version-fpm.service" systemctl enable php$final_php_version-fpm --quiet systemctl daemon-reload systemctl start php$final_php_version-fpm # Set environment for PHP users echo "#phpenv export PHPENV_ROOT=$phpenv_install_dir export PATH=\"$phpenv_install_dir/bin:$PATH\" eval \"\$(phpenv init -)\" #phpenv" > /etc/profile.d/phpenv.sh # Load the environment eval "$(phpenv init -)" } # Remove the version of PHP used by the app. # # This helper will also cleanup PHP versions # # usage: ynh_remove_php ynh_remove_php () { local php_version=$(ynh_app_setting_get --app=$YNH_APP_INSTANCE_NAME --key=php_version) # Load phpenv path in PATH local CLEAR_PATH="$phpenv_install_dir/bin:$PATH" # Remove /usr/local/bin in PATH in case of PHP prior installation PATH=$(echo $CLEAR_PATH | sed 's@/usr/local/bin:@@') phpenv alias $YNH_APP_INSTANCE_NAME --remove # Remove the line for this app ynh_app_setting_delete --app=$YNH_APP_INSTANCE_NAME --key=php_version # Cleanup PHP versions ynh_cleanup_php } # Remove no more needed versions of PHP used by the app. # # This helper will check what PHP version are no more required, # and uninstall them # If no app uses PHP, phpenv will be also removed. # # usage: ynh_cleanup_php ynh_cleanup_php () { # List required PHP versions local installed_apps=$(yunohost app list | grep -oP 'id: \K.*$') local required_php_versions="" for installed_app in $installed_apps do local installed_app_php_version=$(yunohost app setting $installed_app php_version) if [[ $installed_app_php_version ]] then required_php_versions="${installed_app_php_version}\n${required_php_versions}" fi done # Remove no more needed PHP versions local installed_php_versions=$(phpenv versions --bare --skip-aliases | grep -Ev '/') for installed_php_version in $installed_php_versions do if ! `echo ${required_php_versions} | grep "${installed_php_version}" 1>/dev/null 2>&1` then ynh_print_info --message="Removing of PHP-$installed_php_version" systemctl stop php$installed_php_version-fpm systemctl disable php$installed_php_version-fpm --quiet ynh_secure_remove --file="/etc/systemd/system/php$installed_php_version-fpm.service" $phpenv_install_dir/bin/phpenv uninstall --force $installed_php_version systemctl daemon-reload fi done # If none PHP version is required if [[ ! $required_php_versions ]] then # Remove phpenv environment configuration ynh_print_info --message="Removing of phpenv" ynh_secure_remove --file="$phpenv_install_dir" rm /etc/profile.d/phpenv.sh fi } # Create a dedicated PHP-FPM config # # usage 1: ynh_add_fpm_config [--phpversion=7.X] [--use_template] [--package=packages] [--dedicated_service] # | arg: -v, --phpversion= - Version of PHP to use. # | arg: -t, --use_template - Use this helper in template mode. # | arg: -p, --package= - Additionnal PHP packages to install # | arg: -d, --dedicated_service - Use a dedicated PHP-FPM service instead of the common one. # # ----------------------------------------------------------------------------- # # usage 2: ynh_add_fpm_config [--phpversion=7.X] --usage=usage --footprint=footprint [--package=packages] [--dedicated_service] # | arg: -v, --phpversion= - Version of PHP to use. # | arg: -f, --footprint= - Memory footprint of the service (low/medium/high). # low - Less than 20 MB of RAM by pool. # medium - Between 20 MB and 40 MB of RAM by pool. # high - More than 40 MB of RAM by pool. # Or specify exactly the footprint, the load of the service as MB by pool instead of having a standard value. # To have this value, use the following command and stress the service. # watch -n0.5 ps -o user,cmd,%cpu,rss -u APP # # | arg: -u, --usage= - Expected usage of the service (low/medium/high). # low - Personal usage, behind the SSO. # medium - Low usage, few people or/and publicly accessible. # high - High usage, frequently visited website. # # | arg: -p, --package= - Additionnal PHP packages to install for a specific version of PHP # | arg: -d, --dedicated_service - Use a dedicated PHP-FPM service instead of the common one. # # ynh_add_fpm_config () { # Declare an array to define the options of this helper. local legacy_args=vtufpd local -A args_array=( [v]=phpversion= [t]=use_template [u]=usage= [f]=footprint= [p]=package= [d]=dedicated_service ) local phpversion local use_template local usage local footprint local package local dedicated_service # Manage arguments with getopts ynh_handle_getopts_args "$@" package=${package:-} # The default behaviour is to use the template. use_template="${use_template:-1}" usage="${usage:-}" footprint="${footprint:-}" if [ -n "$usage" ] || [ -n "$footprint" ]; then use_template=0 fi # Do not use a dedicated service by default dedicated_service=${dedicated_service:-0} phpversion="" local php_version=$(ynh_app_setting_get --app=$YNH_APP_INSTANCE_NAME --key=php_version) if [ $dedicated_service -eq 1 ] then local fpm_service="${app}-phpfpm" local fpm_config_dir="$php_version_path/$php_version/etc/dedicated-fpm" else local fpm_service="php${php_version}-fpm" local fpm_config_dir="$php_version_path/$php_version/etc/php-fpm.d" fi # Create the directory for FPM pools mkdir --parents "$fpm_config_dir" ynh_app_setting_set --app=$app --key=fpm_config_dir --value="$fpm_config_dir" ynh_app_setting_set --app=$app --key=fpm_service --value="$fpm_service" ynh_app_setting_set --app=$app --key=fpm_dedicated_service --value="$dedicated_service" # Migrate from mutual PHP service to dedicated one. if [ $dedicated_service -eq 1 ] then local old_fpm_config_dir="$php_version_path/$php_version/etc/php-fpm.d" # If a config file exist in the common pool, move it. if [ -e "$old_fpm_config_dir/$app.conf" ] then ynh_print_info --message="Migrate to a dedicated php-fpm service for $app." # Create a backup of the old file before migration ynh_backup_if_checksum_is_different --file="$old_fpm_config_dir/$app.conf" # Remove the old PHP config file ynh_secure_remove --file="$old_fpm_config_dir/$app.conf" # Reload PHP to release the socket and allow the dedicated service to use it ynh_systemd_action --service_name=php${php_version}-fpm --action=reload fi fi if [ $use_template -eq 1 ] then # Usage 1, use the template in conf/php-fpm.conf local phpfpm_path="../conf/php-fpm.conf" # Make sure now that the template indeed exists [ -e "$phpfpm_path" ] || ynh_die --message="Unable to find template to configure PHP-FPM." else # Usage 2, generate a PHP-FPM config file with ynh_get_scalable_phpfpm # Store settings ynh_app_setting_set --app=$app --key=fpm_footprint --value=$footprint ynh_app_setting_set --app=$app --key=fpm_usage --value=$usage # Define the values to use for the configuration of PHP. ynh_get_scalable_phpfpm --usage=$usage --footprint=$footprint local phpfpm_path="../conf/php-fpm.conf" echo " [__APP__] user = __APP__ group = __APP__ chdir = __FINALPATH__ listen = /var/run/php/php__PHP_VERSION__-fpm-__APP__.sock listen.owner = www-data listen.group = www-data pm = __PHP_PM__ pm.max_children = __PHP_MAX_CHILDREN__ pm.max_requests = 500 request_terminate_timeout = 1d " > $phpfpm_path if [ "$php_pm" = "dynamic" ] then echo " pm.start_servers = __PHP_START_SERVERS__ pm.min_spare_servers = __PHP_MIN_SPARE_SERVERS__ pm.max_spare_servers = __PHP_MAX_SPARE_SERVERS__ " >> $phpfpm_path elif [ "$php_pm" = "ondemand" ] then echo " pm.process_idle_timeout = 10s " >> $phpfpm_path fi # Concatene the extra config. if [ -e ../conf/extra_php-fpm.conf ]; then cat ../conf/extra_php-fpm.conf >> "$phpfpm_path" fi fi local finalphpconf="$fpm_config_dir/$app.conf" ynh_add_config --template="$phpfpm_path" --destination="$finalphpconf" if [ -e "../conf/php-fpm.ini" ] then ynh_print_warn --message="Packagers ! Please do not use a separate php ini file, merge your directives in the pool file instead." ynh_add_config --template="../conf/php-fpm.ini" --destination="$fpm_config_dir/conf.d/20-$app.ini" fi if [ $dedicated_service -eq 1 ] then # Create a dedicated php-fpm.conf for the service local globalphpconf=$fpm_config_dir/php-fpm-$app.conf echo "[global] pid = /run/php/php__PHP_VERSION__-fpm-__APP__.pid error_log = /var/log/php/fpm-php.__APP__.log syslog.ident = php-fpm-__APP__ include = __FINALPHPCONF__ " > ../conf/php-fpm-$app.conf ynh_add_config --template="../config/php-fpm-$app.conf" --destination="$globalphpconf" # Create a config for a dedicated PHP-FPM service for the app echo "[Unit] Description=PHP __PHP_VERSION__ FastCGI Process Manager for __APP__ After=network.target [Service] Type=notify PIDFile=/run/php/php__PHP_VERSION__-fpm-__APP__.pid ExecStart=__PHP_VERSION_PATH__/__PHP_VERSION__/sbin/php-fpm --nodaemonize --fpm-config __GLOBALPHPCONF__ ExecReload=/bin/kill -USR2 \$MAINPID [Install] WantedBy=multi-user.target " > ../conf/$fpm_service # Create this dedicated PHP-FPM service ynh_add_systemd_config --service=$fpm_service --template=$fpm_service # Integrate the service in YunoHost admin panel yunohost service add $fpm_service --log /var/log/php/fpm-php.$app.log --log_type file --description "Php-fpm dedicated to $app" # Configure log rotate ynh_use_logrotate --logfile=/var/log/php # Restart the service, as this service is either stopped or only for this app ynh_systemd_action --service_name=$fpm_service --action=restart else # Validate that the new php conf doesn't break php-fpm entirely if ! $php_version_path/$php_version/sbin/php-fpm --test 2>/dev/null then $php_version_path/$php_version/sbin/php-fpm --test || true ynh_secure_remove --file="$finalphpconf" ynh_die --message="The new configuration broke php${php_version}-fpm" fi ynh_systemd_action --service_name=$fpm_service --action=reload fi } # Remove the dedicated PHP-FPM config # # usage: ynh_remove_fpm_config # # Requires YunoHost version 2.7.2 or higher. ynh_remove_fpm_config () { local fpm_config_dir=$(ynh_app_setting_get --app=$app --key=fpm_config_dir) local fpm_service=$(ynh_app_setting_get --app=$app --key=fpm_service) local dedicated_service=$(ynh_app_setting_get --app=$app --key=fpm_dedicated_service) dedicated_service=${dedicated_service:-0} # Get the version of PHP used by this app local php_version=$(ynh_app_setting_get --app=$YNH_APP_INSTANCE_NAME --key=php_version) # Assume default PHP files if not set if [ -z "$fpm_config_dir" ] then fpm_config_dir="$php_version_path/$php_version/etc/php-fpm.d" fpm_service="php${php_version}-fpm" fi if [ $dedicated_service -eq 1 ] then # Remove the dedicated service PHP-FPM service for the app ynh_remove_systemd_config --service=$fpm_service # Remove the global PHP-FPM conf ynh_secure_remove --file="$fpm_config_dir/php-fpm-$app.conf" # Remove the service from the list of services known by YunoHost yunohost service remove $fpm_service elif ynh_package_is_installed --package="php${phpversion}-fpm"; then ynh_systemd_action --service_name=$fpm_service --action=reload fi }