https://github.com/zendtech/zend-server-php-buildpack-ibm-demo
Zend Server PHP Buildpack frozen for IBM demo
https://github.com/zendtech/zend-server-php-buildpack-ibm-demo
Last synced: 5 months ago
JSON representation
Zend Server PHP Buildpack frozen for IBM demo
- Host: GitHub
- URL: https://github.com/zendtech/zend-server-php-buildpack-ibm-demo
- Owner: zendtech
- Created: 2014-02-18T15:07:00.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-02-25T07:47:56.000Z (over 12 years ago)
- Last Synced: 2023-04-13T12:57:00.640Z (about 3 years ago)
- Language: Shell
- Size: 11.1 MB
- Stars: 0
- Watchers: 7
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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.2 Free Edition
* Zend Server 6.2 configuration files
* PHP 5.4
* Nginx web server
# Usage
1. Create a folder on your workstation, and "cd" into it.
2. Create an empty file called "zend_server_php_app". If you do not do this, you will have to manually specify which buildpack to use for the app.
3. Make sure your app contains an "index.php" file.
4. Issue the `cf push --buildpack=https://github.com/zendtech/zend-server-php-buildpack-ibm-demo.git` command. Allocate at least 512M of RAM for your app.
5. When prompted, save your manifest.
6. Bind a MySQL service (mysql/MariaDB/user-provided) to the app - this will cause Zend Server to operate in cluster mode (experimental). Operating in cluster mode enables: scaling, persistence of settings changed using the Zend Server UI and persistence of apps deployed using Zend Server's deployment mechanism.
If you bind more than one database service to an app, specify which service Zend Server should use by setting the 'ZS_ DB' env variable to the correct service: `cf set-env ZS_DB `. Otherwise, Zend Server will use the first database available.
7. When prompted, save the manifest.
8. Issue the comand below to change the Zend Server UI password (this can be performed in the future in case you forget your password):
`cf set-env ZS_ADMIN_PASSWORD `
9. The previous steps should generate a YAML file named "manifest.yml" (see example below). Optional - add and push the generated manifest in future applications to facilitate smoother future pushes.
```
---
env:
ZS_ACCEPT_EULA: 'TRUE'
ZS_ADMIN_PASSWORD: ''
applications:
- name:
instances: 1
memory:
host:
domain:
path: .
```
10. Wait for the app to start.
11. Once the app starts, you can access the Zend Server UI at http://url-to-your-app/ZendServer (e.g. http://dave2.vcap.me/ZendServer) using username 'admin' and the password you defined in step 7. If you forgot to perform step 7, then the password is 'changeme'.
12. If you chose to save the manifest in the previous steps, then you can issue the `cf push` command to udpate your application code in the future.
# Using an External Database Service
It is possible to bind an external database to the Zend Server app as a "user-provided" service. Doing so will enable persistence, session clustering, and more.
To bind an external database:
1. Run `cf create-service`.
2. As a service type select "user-provided".
3. Enter a friendly name for the service.
4. Enter service paramaters. The required parameters are `hostname, port, password, name`, where 'name' is the database Zend Server will use for its internal functions.
5. Enter the paramaters of your external database provider in order.
6. Bind the service to your app `cf bind-service [service-name] [app-name]`.
7. The service will be auto-detected upon push. Zend Server will create the schema and enable clustering features.
## 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:
1. In your application's code (on your workstation) create a folder named .zend_config .
2. Browse to: `http:///ZendServer/ImportExport/` .
3. Click on the "Export Configuration" button.
4. Move the saved file to the .zend_config folder in your app.
5. Change directory into your app source code directory: `cd `
6. 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
* cleardb is not yet supported by this buildpack - you will get a "1203 == ER_TOO_MANY_USER_CONNECTIONS" error.
* 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](localinstallation.md)
* Cloud foundry environment variables that affect the buildpack: [environment.md](environment.md)