Use these instructions to install the PHP Agent using the Agent Download Wizard in the Controller.

If you downloaded the agent from the AppDynamics download zone, see Install the PHP Agent.

Before You Begin

Confirm you have access to a controller, the web application where you monitor your application performance:
- If you use a SaaS controller, AppDynamics sent you the controller host in your Welcome Email.
- If you use the on-premise controller, you supplied the host and port at install time.
Verify you have root access to run the install.
Verify support for your environment at Supported Environments and Versions for PHP.

Instrumenting Your PHP Application with the App Agent for PHP

There are four steps to instrument your PHP application and begin monitoring:

1. Download: Use the Agent Download Wizard to configure and download the agent.
2. Install: Unzip the agent on your server and run the install script.
3. Apply Load: Restart your web server and application and apply load to activate instrumentation.
4. View Your Application: Log on to the Controller to monitor application performance.

Download the PHP Agent

The Agent Download Wizard walks you through configuration steps and helps you download the agent.

Show me the Download Agent Wizard steps...

1. Log on to the Controller and click the Agent Download Wizard tab.

The download wizard configures the agent with information to connect to the Controller.

2. Click PHP, then click Next.

3. Click to Select Operating System and 32-bit or 64-bit bit System, then click Next.

4. The Controller Location URL window displays the connection info for the Controller. Click Next.

Click SSL to enable SSL encryption between the agent and the Controller. Enter the SSL port. For AppDynamics SaaS, the SSL port is 443.

5. Enter an application name or, click an existing application name if one exists. Then click Next.

For new users, it is OK to use the default "MyApp". You can change it later when know more about how you want to organize your applications in AppDynamics.

6. Enter a tier name. Then click Next.

For new users, it is OK to use the default "MyTier". You can change it later when know more about how you want to organize your applications in AppDynamics.

7. Click Click here to Download to download the App Agent for PHP.

Now you're ready to install the agent on your app server.

Install the agent on your app server

After you download the agent, install it to your app server. The final window of the Agent Download Wizard includes brief instructions for installing the agent.

Log on as an administrator to the machine running your PHP application. Unzip the agent zip file into a directory that can be accessed the same user that runs Apache or php-fpm.
For example, for a 64 bit agent on Linux:
```
unzip appdynamics-php-agent-x64-linux-tar-self-service.zip -d /opt/appdynamics/appagent
```
Run the installer script.
```
sudo bash runme.sh
```
By default the PHP agent installer uses the PHP directory specified in your environment's PATH variable to determine where to install the agent. If you are using a different PHP installation not specified in the PATH environment variable, follow the instructions below to run the installer with custom options instead of using the installer script.
- Install the PHP Agent using a Shell Script
- Install the PHP Agent using RPM

Now you're ready to restart your application and put some load on it.

Apply load to your application

Restart your web server.
Apply load to your application.

The agent instruments the application code and reports metrics back to the Controller. You're ready to begin monitoring.

View your application

Log on to the Controller to see your application in action.

From here, you can install more agents or you can begin monitoring your application. The links below will help you get started:

Learn More

Quick Install for the PHP Agent