Getting Started with Z-Ray

To download and install Zend Server:

1. Log into your Zend account, at http://www.zend.com
2. Go to the Zend Server Downloads page, at: http://www.zend.com/en/products/server/downloads
3. Select your OS.
4. Click Download button for the PHP stack you wish to install with Zend Server.
   Zend Server downloads to your machine.
5. Once Zend Server has been downloaded, complete the following instructions according to the OS you are using to install Zend Server: DEB / RPM / SLES / Mac OS X / Windows.
   

Linux users:

We highly recommend using the Repository Installer to install Zend Server, as it ensures a correct and healthier installation process. The script ensures that the correct repositories are set, verifies system requirements and issues the correct package management commands to set Zend Server up properly.

To launch Zend Server:

1. Open your browser at:
   • Windows: http://localhost:10081/ZendServer or https://localhost:10082/ZendServer
   • Linux/Mac: http://localhost:10081/ZendServer or https://localhost:10082/ZendServer
   • IBM i: http://IBM_i_hostname:10088/ZendServer

   The Launch Zend Server wizard is opened with the License Agreement dialog displayed.

2. Read and accept the terms in the agreement, and click Next.
   The Profile dialog is displayed.

3. Select the Development launch profile, and click Next.
   The User Passwords dialog is displayed.

4. Configure the passwords for accessing the Zend Server UI. Passwords must be between 4 - 20 characters long and can be changed at a later stage from within the product.
   • Enter and confirm a password for 'admin' user.
   • Enter and confirm a password for 'developer' user (optional).

   Note:

   For information on the differences between these two user roles, see User Management.

5. Click Next.
   The Library Packages dialog is displayed with a list of the library packages deployed on Zend Server.

6. Click Next.
   The Summary dialog is displayed.
   

7. Review the details, and click Launch.
   Zend Server launches with the Getting Started page displayed.

You are automatically using a Zend Server Enterprise edition trial license. This license gives you full access to all Zend Server features for a period of 30 days. If you have purchased a license, register Zend Server. If not, at any point during your trial you can click Contact Zend in the top-right corner of the UI to chat with a Zend representative.

To deploy WordPress:

1. In the Deploy Sample Apps section on the Getting Started page, click the WordPress icon.
   The Deploy Application wizard is displayed, and Zend Server begins downloading the application.

2. After the application finished downloading, click Next.
   The Readme dialog is displayed.

3. Click Next.
   The Application Details dialog is displayed.

4. Enter the following details:
   • Display Name - Enter a name for the application to be displayed in Zend Server (e.g. WordPress).
   • Virtual Host - Leave default settings (default server) or click Add New to add a new virtual host.
   • Path - Enter a path for the app.
5. Click Next.
   The License Agreement dialog is displayed.

6. Accept the license agreement, and click Next.
   The Prerequisites Validation dialog is displayed.

7. This dialog displays the parameters specified as needing validation in the app's descriptor XML file.
   Click Next.
   The User Parameters dialog is displayed.

8. Enter the following information:
   • Database password -1234
   • WordPress admin password - 1234
9. Click Next.
   The Deployment Summary dialog is displayed.

10. Click Deploy.
    The application is deployed on Zend Server, and will be listed on the Manage Apps page.

To create a project in Zend Studio:

1. From the menu-bar, select File | New | PHP Project from Existing Directory.

2. Click the PHP Server drop-down menu, and select Local Zend Server.
3. Click Browse to select the folder containing the WordPress application.
   Your deployed application is located in:
   • Linux, Mac OS Xand IBM i - ‘usr/local/zend/var/apps/http/__default__(or your vhost’s name)/0/<application name>/<version>’
   • Windows - ‘C:\Program Files\Zend\ZendServer\var\ data\http\__default__(or your  vhost’s name)\0\<application name>\<version>’
4. Name the new application, and click Finish.
   Zend Studio creates a new project in your workspace.
5. Open the 'general-template.php' file in your project. It is located in the 'wp-includes' folder of the application.

6. Insert the following changes to lines 1-48 in your code (changes are marked in red). They include a sleep expression for 3 seconds, and a bad function returning null:

/**
* General template tags that can go anywhere in a template.
*
* @package WordPress
* @subpackage Template
*/
function getFilePath() {
	return null;
}
 
/**
* Load header template.
*
* Includes the header template for a theme or if a name is specified then a
* specialised header will be included.
*
* For the parameter, if the file is called "header-special.php" then specify
* "special".
*
* @since 1.5.0
*
* @uses locate_template()
*
* @param string $name The name of the specialised header.
*/
function get_header( $name = null ) {
	/**
	* Fires before the header template file is loaded.
	*
	* The hook allows a specific header template file to be used in place of the
	* default header template file. If your file is called header-new.php,
	* you would specify the filename in the hook as get_header( 'new' ).
	*
	* @since 2.1.0
	* @since 2.8.0 $name parameter added.
	*
	* @param string $name Name of the specific header file to use.
	*/
	do_action( 'get_header', $name );
 
	$templates = array();
	$name = (string) $name;
 
	$filename = getFilePath();
	$file = file_get_contents($filename, true);
	sleep(3);

7. Save the file.

To use Z-Ray:

1. In the Zend Server UI, open the Applications | Manage Apps page (opened after we deployed our application).
2. From the Applications list, select the newly deployed WordPress application.
   The Expanded View is displayed.
3. Click the URL displayed in the Base URL field.
   The WordPress application is opened in your browser.
   As soon as the page loads, Z-Ray is displayed at the bottom.

4. Notice that yellow warning flags are displayed on the Monitor Events and Errors and Warnings panels.

5. Open the Monitor Events panel.
   The PHP Error and Function Error events point to the erroneous function we inserted in the code.

6. Open the Errors and Warnings panel.
   Z-Ray points to the exact line in our code we need to examine.

7. In Zend Studio, insert a breakpoint on line 47 in the 'general-template.php' file.

   Note:

   Although this tutorial demonstrates debugging in Zend Studio, the same workflow can be performed in other IDEs (e.g., PhpStorm). For more information, see Debugging in PhpStorm Using Zend Server.

8. On Z-Ray, click the Debug icon on the right, and select Debug current page.
   A debugging session is initiated in Zend Studio, stopping at the first line of code.

9. Click Resume (1) to continue debugging.
10. Debugging stops at our defined breakpoint (1), and the Variables panel (2) shows us that $filename receives null.
    

11. Continue the debugging process:
    1. Move the breakpoint to the line above (line 46)
    2. Repeat step 8-9
    3. Step into (3) the function, and fix it.
12. Back in Z-Ray, open the Functions panel.

13. Z-Ray shows that the get_header() function took over 3 seconds. It also gives us the location of the problematic function.
14. In Zend Studio, remove the sleep expression from line 48, and save the file.
15. Refresh your browser.
    WordPress loads faster, and Z-Ray no longer displays the Slow Request Execution event.

Well done! 
This is just a taste of how Z-Ray can help you get to those bottlenecks in your code, on time, and without having to change anything in the way you develop PHP. We also think you will enjoy the process!