php-zendserver

Estimated reading time: 7 minutes

Zend Server - the integrated PHP application platform for mobile and web apps.

GitHub repo: https://github.com/zendtech/php-zendserver-docker

Library reference

This content is imported from the official Docker Library docs, and is provided by the original uploader. You can view the Docker Store page for this image at https://store.docker.com/images/php-zendserver

Supported tags and respective Dockerfile links

Quick reference

What is Zend Server?

Zend Server is the integrated application platform for PHP mobile and web apps. Zend Server provides you with a highly available PHP production environment which includes, amongst other features, a highly reliable PHP stack, application monitoring, troubleshooting, and the all-new Z-Ray.

Boost your Development with Z-Ray

Using Zend Server Z-Ray is akin to wearing X-Ray goggles, effortlessly giving developers deep insight into how their code is running as they are developing it – all without having to change any of their habits or workflow. With Z-Ray, developers can immediately understand the impact of their code changes, enabling them to both improve quality and solve issues long before their code reaches production. In addition to the obvious benefits of this ‘Left Shifting’ – better performance, fewer production issues and faster recovery times – using Z-Ray is also downright fun!

Powering Continuous Delivery

Zend Server is the platform that enables Continuous Delivery, which provides consistency, automation and collaboration capabilities throughout the application delivery cycle. Patterns are available to integrate Zend Server with: Chef, Jenkins, Nagios, Vmware, Puppet.

Additional Resources

PHP-ZendServer

This is a cluster-enabled version of a Dockerized Zend Server 8.0 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 trial license that is valid until July-31st-2016. 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.

Single instance

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. 

    for example: 
$docker run php-zendserver:8.0-php5.6

Availible versions:

  • Zend Server 7
  • Zend Server 8
  • Zend Server 9 (With PHP 7 GA)(Default version)
Cluster

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

Bring your own license

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 .
Single instance from custom image

To start a single Zend Server instance, execute:

    $ docker run <image-id>

Cluster from custom image

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>

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.

Port forwarding (For remote access)

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:

To start a Zend Server cluster you must provide a Mysql compatible database:

    $ 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, 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:

  • ZS_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.

License

Zend Technologies Ltd.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in the repo-info repository’s php-zendserver/ directory.

As for any pre-built image usage, it is the image user’s responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.

library, sample, php-zendserver