2019-03-07 15:35:54 +00:00
|
|
|
.. include:: /_includes/snippets/__ANNOUNCEMENTS__.rst
|
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
.. _custom_scripts_per_php_version:
|
2018-12-26 16:31:09 +00:00
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
******************************
|
|
|
|
Custom scripts per PHP version
|
|
|
|
******************************
|
2018-12-26 16:31:09 +00:00
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
You can provide custom startup commands via bash scripts to each of the PHP container individually.
|
2018-12-26 16:31:09 +00:00
|
|
|
This may be useful to specify additional software to install or additional settings to apply during
|
|
|
|
the initial startup.
|
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
|
|
|
|
.. seealso::
|
|
|
|
* :ref:`custom_scripts_globally` (equal for all PHP versions)
|
|
|
|
* :ref:`autostarting_nodejs_apps`
|
|
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
Per PHP version scripts are always executed **before** global scripts.
|
|
|
|
|
|
|
|
|
2018-12-26 16:31:09 +00:00
|
|
|
**Table of Contents**
|
|
|
|
|
|
|
|
.. contents:: :local:
|
|
|
|
|
|
|
|
|
|
|
|
General
|
|
|
|
=======
|
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
You can add custom shell scripts for each PHP version separately.
|
|
|
|
|
|
|
|
.. important::
|
|
|
|
Provided scripts must end by the file extension ``.sh`` and should be executable.
|
|
|
|
Anything not ending by ``.sh`` will be ignored.
|
|
|
|
|
|
|
|
.. important::
|
|
|
|
Provided scripts will be executed by the ``root`` user within the PHP container.
|
|
|
|
|
2018-12-26 16:31:09 +00:00
|
|
|
|
|
|
|
Where
|
|
|
|
-----
|
|
|
|
|
|
|
|
Startup scripts can be added to ``cfg/php-startup-X.Y/``.
|
|
|
|
See the directory structure for PHP startup script directories inside ``./cfg/`` directory:
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
host> ls -l path/to/devilbox/cfg/ | grep 'php-startup'
|
|
|
|
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-5.2/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-5.3/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-5.4/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-5.5/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Apr 3 22:04 php-startup-5.6/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-7.0/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-7.1/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-7.2/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-7.3/
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-7.4/
|
2019-02-09 15:51:40 +00:00
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-startup-8.0/
|
2018-12-26 16:31:09 +00:00
|
|
|
|
|
|
|
|
|
|
|
Custom scripts are added by placing a file into ``cfg/php-startup-X.X/`` (where ``X.X`` stands for
|
|
|
|
your PHP version). The file must end by ``.sh`` in order to be executed by the PHP container.
|
|
|
|
|
|
|
|
Some of the PHP startup directories contain a few example files with the file suffix ``-example``.
|
|
|
|
If you want to use them, copy these files to a new name without the ``-example`` suffix and ensure
|
|
|
|
they end by ``.sh``.
|
|
|
|
|
|
|
|
When
|
|
|
|
----
|
|
|
|
|
|
|
|
The scripts will be executed by the PHP container during initial startup. Whenever you change your
|
|
|
|
scripts, ensure to restart the Devilbox.
|
|
|
|
|
|
|
|
How
|
|
|
|
---
|
|
|
|
|
|
|
|
The scripts will always be executed inside the PHP container (Debian Linux) and will be run with
|
2018-12-31 12:14:29 +00:00
|
|
|
``root`` privileges. It is however possible to drop privileges within the script to have them
|
|
|
|
executed as a normal user.
|
2018-12-26 16:31:09 +00:00
|
|
|
|
|
|
|
|
|
|
|
Examples
|
|
|
|
========
|
|
|
|
|
|
|
|
Installing Microsoft ODBC driver
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
This example will add Microsofts ODBC driver to PHP 7.1. These drivers are required in order to
|
|
|
|
make the PHP modules ``pdo_sqlsrv`` and ``sqlsrv`` work. The two mentioned modules are already
|
|
|
|
available in the PHP container, but are explicitly disabled via :ref:`env_file_php_modules_disable`.
|
|
|
|
|
|
|
|
They won't work without the ODBC driver installed, which unfortunately cannot be bundled, as it
|
|
|
|
requires every user to accept a license/EULA by Microsoft.
|
|
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
# Navigate to starup dir of PHP 7.1
|
|
|
|
host> cd path/to/devilbox/cfg/php-startup-7.1
|
|
|
|
|
|
|
|
# Create an .sh file
|
|
|
|
host> touch ms-odbc.sh
|
|
|
|
|
|
|
|
# Open the file in your favourite editor
|
|
|
|
host> vi ms-odbc.sh
|
|
|
|
|
|
|
|
Paste the following into ``ms-obbc.sh`` and **ensure to accept the EULA** by changing
|
|
|
|
``ACCEPT_EULA=N`` to ``ACCEPT_EULA=Y``.
|
|
|
|
|
|
|
|
.. code-block:: bash
|
2018-12-31 12:14:29 +00:00
|
|
|
:caption: cfg/php-startup-7.1/install-ms-odbc.sh
|
2018-12-26 16:31:09 +00:00
|
|
|
:emphasize-lines: 18
|
|
|
|
|
|
|
|
!/bin/bash
|
|
|
|
#
|
|
|
|
# This script will automatically install the Microsoft ODBC driver for MsSQL
|
|
|
|
# support for PHP during startup.
|
|
|
|
#
|
|
|
|
# In order for it to work, you must read and accept their License/EULA:
|
|
|
|
# https://odbceula.blob.core.windows.net/eula17/LICENSE172.TXT
|
|
|
|
#
|
|
|
|
|
|
|
|
|
|
|
|
# ------------------------------------------------------------------------------------------------
|
|
|
|
# EDIT THE VARIABLE BELOW TO ACCEPT THE EULA (If you agree to their terms)
|
|
|
|
# ------------------------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
###
|
|
|
|
### Set this to "Y" (capital 'Y') if you accept the EULA.
|
|
|
|
###
|
|
|
|
ACCEPT_EULA=N
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# ------------------------------------------------------------------------------------------------
|
|
|
|
# DO NOT EDIT BELOW THIS LINE
|
|
|
|
# ------------------------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
###
|
|
|
|
### Where to retrieve the deb package
|
|
|
|
###
|
|
|
|
MSODBC_URL="https://packages.microsoft.com/debian/8/prod/pool/main/m/msodbcsql17/"
|
|
|
|
|
|
|
|
|
|
|
|
###
|
|
|
|
### Pre-flight check
|
|
|
|
###
|
|
|
|
if [ "${ACCEPT_EULA}" != "Y" ]; then
|
|
|
|
echo "MS ODBC EULA not accepted. Aborting installation."
|
|
|
|
exit 0
|
|
|
|
fi
|
|
|
|
|
|
|
|
|
|
|
|
###
|
|
|
|
### EULA accepted, so we can proceed
|
|
|
|
###
|
|
|
|
|
|
|
|
# Extract latest *.deb packate
|
|
|
|
MSODBC_DEB="$( curl -k -sS "${MSODBC_URL}" | grep -Eo 'msodbcsql[-._0-9]+?_amd64\.deb' | tail -1 )"
|
|
|
|
|
|
|
|
# Download to temporary location
|
|
|
|
curl -k -sS "${MSODBC_URL}${MSODBC_DEB}" > "/tmp/${MSODBC_DEB}"
|
|
|
|
|
|
|
|
# Install
|
|
|
|
ACCEPT_EULA="${ACCEPT_EULA}" dpkg -i "/tmp/${MSODBC_DEB}"
|
|
|
|
|
|
|
|
# Remove artifacts
|
|
|
|
rm -f "/tmp/${MSODBC_DEB}"
|
|
|
|
|
|
|
|
|
|
|
|
.. important::
|
|
|
|
The script will not work, if you have not accepted the EULA.
|
|
|
|
|
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
Running commands as devilbox user
|
|
|
|
---------------------------------
|
2018-12-26 16:31:09 +00:00
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
As mentioned above, all scripts are run by the ``root`` user.
|
|
|
|
If you do need something to be executed as the normal user: ``devilbox``, you can simply ``su``
|
|
|
|
inside the shell script.
|
2018-12-26 16:31:09 +00:00
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
The following example will install ``grunt`` and start a NodeJS application as the devilbox user
|
|
|
|
for the PHP 7.1 Docker container only.
|
2018-12-26 16:31:09 +00:00
|
|
|
|
|
|
|
.. code-block:: bash
|
2018-12-31 12:14:29 +00:00
|
|
|
:caption: cfg/php-startup-7.1/myscript.sh
|
2018-12-26 16:31:09 +00:00
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
# Install grunt as devilbox user
|
|
|
|
su -c "npm install grunt" -l devilbox
|
2018-12-26 16:31:09 +00:00
|
|
|
|
2018-12-31 12:14:29 +00:00
|
|
|
# Start a NodeJS application with pm2 as devilbox user
|
|
|
|
su -c "cd /shared/httpd/my-node/src/; pm2 start index.js" -l devilbox
|