Overview

Welcome to the Zend Server PHP buildpack! This buildpack allows you to deploy your PHP apps on Cloud Foundry using Zend Server 6.2. Zend Server's integration with Cloud Foundry allows you to quickly 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 more.

Buildpack Components

Zend Server 6.3 Free edition
Zend Server 6.3 configuration files
PHP 5.4
Apache web server

Usage

Download and install Cloud Foundry's 'cf v6' CLI. For installation instructions, see http://docs.run.pivotal.io/devguide/installcf/install-go-cli.html.
Create a new folder on your workstation, and access it.
If you have an application package (.zpk) ready for deployment, place it anywhere in your application. If not, create a new 'index.php' file in the root folder of your application, and paste the following code:

<?php
echo "Hello world!;
?>

Enter the following command: cf push <application name> -m 512M -b https://github.com/zendtech/zend-server-php-buildpack.git Your application is deployed using the Zend Server buildpack. This may take a few minutes.
Once successfully initialized and deployed, a success message with the URL at which your application is available at is displayed.
To access the application, enter the supplied URL in your Web browser. Deployed .zpks can be accessed at: http://.pivotal.io/<.zpk name>
To access Zend Server, add 'ZendServer' to the supplied URL. For example:http://<application URL>/ZendServer The Zend Server Login page is displayed.
Log in using the following credentials: Username - admin, Password - enter the following command in your CLI to retrieve an initial password: cf file <application name> /app/zend-password
To change the Zend Server UI password, or in case you misplace your password, enter the following command: cf set-env <application name> ZS_ADMIN_PASSWORD <new password>

Automatically Importing PHP Configurations

The Zend Server buildpack can optionally import PHP configurations from backup files. This allows you to easily deploy applications which require a change of directives. It also allows you to retain changes you made using the Zend Server GUI. To do so, follow these instructions:

In your application's code (on your workstation) create a folder named .zend_config .
Browse to: http://<application URL>/ZendServer/ImportExport/ .
Click on the "Export Configuration" button.
Move the saved file to the .zend_config folder in your app.
Change directory into your app source code directory: cd <app_source_directory_on_your_workstation>
Enter the following command to apply the changes: cf push

Tip: you can reuse this backup files for other applications that might require similar settings.

Known Issues

Zend Server Code Tracing may not work properly in this version.
Several issues might be encountered if you do not bind MySQL providing service to the app (mysql/MaraiaDB):
You can change settings using the Zend Server UI and apply them - but they will not survive application pushes and restarts, nor will they be propagated to new application instances.
Application packages deployed using Zend Server's deployment mechanism (.zpk packages) will not be propagated to new app instances.
Zend Server will not operate in cluster mode.
Application generated data is not persistent (this is a limitation of Cloud Foundry) unless saved to a third party storage provider (like S3).
MySQL is not used automatically - If you require MySQL then you will have to setup your own server and configure your app to use it.
If the application does not contain an 'index.php' file you will most likely encounter a "403 permission denied error".

Additional Resources

The following resources will help you understand Cloud Foundry concepts and workflows:

For more info on getting started with Cloud Foundry: http://docs.cloudfoundry.com/docs/dotcom/getting-started.html
How to add a service in Cloud Foundry: http://docs.cloudfoundry.com/docs/dotcom/adding-a-service.html
How to design apps for the cloud: http://docs.cloudfoundry.com/docs/using/app-arch/index.html
Cloud Foundry documentation: http://docs.cloudfoundry.com/
Read more about Zend Server Free Edition: http://www.zend.com/en/products/server/free-edition
Zend Server edition comparison: http://www.zend.com/en/products/server/editions.
Local installation instructions for cloud providers: localinstallation.md
Cloud foundry environment variables that affect the buildpack: environment.md

davidl-zend/zend-server-php-buildpack

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages