A Guided Tour of Zend Application Deployment Support

To create a new project from GitHub in Zend Studio:

1. Go to File | New | PHP Project from GitHub.
   The GitHub Repository dialog appears.
   If the GitHub plugin is not installed, Zend Studio will automatically begin the process for installing the plugin that will include restarting the program. Wait until this installation is complete before continuing. For more information see Customizing and Registering Zend Studio.

2. Enter the following information:

• Project Name: Name your project deployment_tutorial

• User: Zend Studio

3. Click Refresh.
   Your application location will appear in the Location URL field.

4. Click Next to move to the Launch Settings dialog.

5. Select Launch URL,  enter the address of the local host server and click Finish.

6. Run your application by right-clicking the project in the PHP ExplorerThe PHP Explorer is an internal file system browser, allowing you to view all PHP projects and files in your Workspace. and selecting Run As PHP Application.
   Your application opens in the Zend Studio workspace and is running locally.

Note:

It is recommended that you save a copy of your project on your machine before continuing this procedure.

To enable deployment:

Add deployment support to your project by right-clicking your project in the PHP Explorer view and select Configure | Add Application Deployment Support.
Your project will appear in the PHP Explorer view with a deployment.xml file.

Overview Tab

In the Overview tab, enter general information about the project:

• Name: deployment_tutorial

• Version: 1.0

• Application Directory: data

Dependencies Tab

Before deployment, Zend Server checks that the target's settings match the application defined dependencies.

1. Click Add.
   The Add Dependency dialog is displayed.

2. Click PHP Version.
   The Version Dependency dialog appears.

3. Select Matches and enter “5.3.0” in the Minimum field.

4. Click Finish.
   The dependency is displayed in the Dependencies list.

Triggers Tab

The Triggers tab includes the Deployment Scripts area and the Variables and Parameters area.

Deployment Scripts

You will now create new files that include the deployment scripts for this tutorial project.

1. Double-click the postStage and postActivate triggers.

2. When prompted, click Yes to confirm the creation of the trigger scripts.
   The new PHP trigger files are displayed and also appear in the Scripts file in the PHP Explorer view.

3. Copy and paste code into the newly created trigger files:

• postStage – This hook script changes the connection configurations according to the user parameters. The connections.ini file is created.
  You can copy the code from Tutorial Code or download the attached zip file here.

• postActivate - This hook script creates the database table using the scripts to be created in the next section..
  You can copy the code from Tutorial Code or download the attached zip file here.

Parameter Script

This file is used for converting user-entered parameters and built-in environment parameters to local php parameters that can be used by all the script files.

1. In PHP Explorer, expand the project, right-click the Scripts file, and select New | PHP File.
   The New PHP File dialog is displayed.

2. In the File Name field, enter “deployment_params.inc”, and click Finish.
   The new  file is displayed and appears in the Scripts file in the PHP Explorer.

3. Copy the code for the relevant file from Tutorial Example Codes and paste into the new file.

4. Save the file.

Additional Scripts

1. Create two more files, named as follows:

• deployment_demo_table.sql- This file is the SQL database dump file (From Menu-bar, select File | New | File).

Note:

The "TABLE_PLACEHOLDER" string will be used in the subsequent create_table.php file.

• create_table.php- This file creates the table using the SQL file (From Menu-bar, select File | New | PHP File).

2. Repeat steps 3-4 in the previous section for each file.
   Your project now includes five script files that are displayed in the deployment.xml main view and in the PHP Explorer.

Variables and Parameters

Add parameters that are used in the hook scripts. You will enter the value of the parameters during the deployment process.

1. Return to the Triggers tab.

2. Click Add Parameter.
   The new parameter will appear in the Variables and Parameters list.

3. In the Parameter Details area, which can be opened by selecting a parameter, enter the following definitions:

• ID:DB_Host

• Type:  string

• Mark This Parameter is Required.

• Display Text: db host.

• Default Value: localhost.

4. Repeat steps 2-3 with the following definitions:

5. The new parameters are displayed in the Variables and Parameters list:

Package Tab

In the Scripts Directory Content, we define which files to include in the package.

1. Click the Package tab in the deployment.xml file.

2. In the Scripts Directory Content, mark the all the scripts in the scripts file.

3. Save the project.

To launch the application:

1. Click the Overview tab in the deployment.xml file.

2. In the Testing Area, click Launch a PHP Application.
   The Launch PHP Application dialog is displayed, warning that no target has yet been defined for the deployment.

3. Select Add New Target.
   The Add Target dialog is displayed.

4. Select the Detect Local icon and click Test Connection.

5. If no problems arise, click Finish.
   The Launch PHP Application dialog is displayed again. Change the URL to tutorial_deploy to avoid two applications with the same name.

6. Click Finish.
   The Parameters dialog is displayed.

7. Enter the values for the parameters as you defined them.
   The application will open in the internal browser.

To package your application:

1. Click the Overview tab in the deployment.xml file.

2. In the Exporting area, click Export Wizard.
   The Export Deployment Package dialog is displayed.

4. Select the project to be packaged.

5. Select the export destination by clicking Browse.

6. Click Finish.
   Zend Studio creates the ZPK package and exports it to the designated destination folder.