Skip to content

Latest commit

 

History

History
93 lines (62 loc) · 4.69 KB

README.md

File metadata and controls

93 lines (62 loc) · 4.69 KB

PHP-ZendServer

This is a cluster-enabled version of a Dockerized Zend Server container. With Zend Server on Docker, you'll get your PHP applications up and running on a highly available PHP production environment which includes, amongst other features, a highly reliable PHP stack, application monitoring, troubleshooting, and the new and innovative new technology - Z-Ray. Z-Ray gives developers unprecedented visibility into their code by tracking and displaying in a toolbar live and detailed info on how the various elements constructing their page are performing.

For development purposes we provide you with a time limited trial license. For production use you must provide a valid Zend Server license using the instructions below in the Usage section.

Usage

Launching the Container from Docker-Hub

Zend Server is shared on Docker-Hub as php-zendserver.

  • To start a single Zend Server instance, execute:

      $ docker run php-zendserver
    
  • You can specify the PHP and Zend Server version by adding ':' or ':<ZS-version>-php<version>' to the 'docker run' command. Availible PHP version are 5.6 & 7.1 (7.1 is the default) and Zend Server versions 9 or8 (for example: php-zendserver:8.5-php5.6).

  • To start a Zend Server cluster, execute the following command for each cluster node:

      $ docker run -e MYSQL_HOSTNAME=<db-ip> -e MYSQL_PORT=3306 -e MYSQL_USERNAME=<username> -e MYSQL_PASSWORD=<password> -e MYSQL_DBNAME=zend php-zendserver
    
  • To use your own Zend Server license $ docker run php-zendserver -e ZEND_LICENSE_KEY= -e ZEND_LICENSE_ORDER=

Launching the Container from Dockerfile

  • From a local folder containing this repo's clone, execute the following command to generate the image. The image-id will be outputted:

      $ docker build .
    
  • To start a single Zend Server instance, execute:

      $ docker run <image-id>
    
  • To start a Zend Server cluster, execute the following command on each cluster node:

      $ docker run -e MYSQL_HOSTNAME=<db-ip> -e MYSQL_PORT=3306 -e MYSQL_USERNAME=<username> -e MYSQL_PASSWORD=<password> -e MYSQL_DBNAME=zend <image-id>
    

Specifying License details

If you wish to bring your own license you can do so by setting the following environment variables:

Accessing Zend server

Once started, the container will output the information required to access the PHP application and the Zend Server UI, including an automatically generated admin password.

To access the container remotely, port forwarding must be configured, either manually or using docker. For example, this command redirects port 80 to port 88, and port 10081 (Zend Server UI port) to port 10088:

    $ docker run -p 88:80 -p 10088:10081 php-zendserver

For clustered instances:

    $ docker run -p 88:80 -p 10088:10081 -e MYSQL_HOSTNAME=<db-ip> -e MYSQL_PORT=3306 -e MYSQL_USERNAME=<username> -e MYSQL_PASSWORD=<password> -e MYSQL_DBNAME=zend <image-id>

Please note, that when running multiple instances only one instance can be bound to a port. If you are running a cluster, either assign a port redirect to one node only, or assign a different port to each container.

Adding application files

Application files can be automatically pulled from a Git repo by setting the GIT_URL env var to the repo's URL. Alternatively, if building an image from Dockerfile, place the app files in the "app/" folder.

The files will be copied to the containers /var/www/html folder and defined in Zend Server as the default app. An example index.html file is included. this feature is available in Zend Server 8 and above.

Env variables

Env variables are passed in the run command with the "-e" switch.

Optional env-variables:

To specify a pre-defined admin password for Zend Server use:

  • ZEND_ADMIN_PASSWORD

Automatically Deploy an app from Git URL:

  • GIT_URL

MySQL vars for clustered ops. ALL are required for the node to properly join a cluster:

  • MYSQL_HOSTNAME - ip or hostname of MySQL database
  • MYSQL_PORT - MySQL listening port
  • MYSQL_USERNAME
  • MYSQL_PASSWORD
  • MYSQL_DBNAME - Name of the database Zend Server will use for cluster ops (created automatically if it does not exist).

To specify a pre-purchased license use the following env vars:

  • ZEND_LICENSE_KEY
  • ZEND_LICENSE_ORDER

Set Zend Server to production mode by setting the following env var to "true". By default Zend Server is set to "development mode" with Z-Ray enabled:

  • ZS_PRODUCTION

Minimal Requirements

  • Each Zend Server Docker container requires 1GB of availible memory.