Installing an SDK

The preferred tooling for managing your App Engine applications in PHP 5 is Google Cloud SDK. Cloud SDK includes a local development server as well as the gcloudcommand-line tooling for deploying and managing your apps.

By downloading, you agree to be bound by the Terms that govern use of all SDKs for App Engine.

Installing Cloud SDK for PHP 5

Install Google Cloud SDK along with the corresponding gcloud component and other related tools and dependencies.

Install and initialize Google Cloud SDK:
Download and install
Note: Avoid using a package manager such as apt or yum to install Cloud SDK.
Run the following command in your terminal to install the gcloud component that includes the App Engine extension for PHP 5:
```
gcloud components install app-engine-php
```
Download and install Git for access to code, samples, libraries, and tools in GitHub:
Download and Install Git
For Linux, install PHP version 5.5.34:
Download and install

Updating Cloud SDK for PHP 5

If you already have the Google Cloud SDK installed, you can run the gcloud components update command to update the SDK to the latest version.

Review the release notes to see what updates are available:
- Google Cloud SDK
- PHP 5 runtime in App Engine
Run the following command to update all the installed Google Cloud SDK components, including the App Engine extension for PHP 5:
```
gcloud components update
```

If you have previously used the original App Engine SDK and need to continue to use the appcfg command, you can instead download and install the original App Engine SDK by following the instructions below. Cloud SDK does not include the appcfg command.

Download and install the original App Engine SDK for PHP 5.

Warning: The App Engine SDK, including the appcfg command, is now deprecated and you should move to Cloud SDK tooling, such as the gcloud command line.

To install the original local development server and the appcfg tooling, you can install the original App Engine SDK for PHP 5.

Optional: Download and install the original App Engine SDK for PHP

Linux

Download the App Engine SDK for PHP:

file_download Download
Version:
1.9.88 - 2020-01-02

Size:
53.9 MB
SHA1 Checksum:
```
35c6857852f787ab777824ceaf645964cff696bc
```
To install the SDK on Linux:
1. Unzip the google_appengine_1.9.88.zip file that you downloaded to a directory of your choice. For example:
```
unzip google_appengine_1.9.88.zip
```
  There is no App Engine installation script that you need to run after unzipping the files.
2. Add the google_appengine directory to your PATH:
```
export PATH="$PATH:DIRECTORY_PATH/google_appengine/"
```
3. Make sure Python 2.7 is installed on your machine using the following command:
```
/usr/bin/env python -V
```
  The output should look like this: Python 2.7.[NUMBER]. If Python 2.7 isn't installed, install it now using the installation instructions for your Linux distribution.
4. Build and install the PHP interpreter. On Debian-based Linux systems, you can use the following command:
```
sudo apt-get install php5-cgi
```
  Or, alternatively, if you're using Redhat, use the following command:
```
sudo yum -y install php5-cgi
```
5. Build and install the Google App Engine PHP Runtime Extension.
6. Specify the path to php-cgi and gae_runtime_module.so when running the development server.
7. Install MySQL on your local machine. You will need this to test your app locally. On Debian-based Linux systems, you can use the following command:
```
sudo apt-get install mysql-server-5.5
```
  You will be prompted to enter a password for the MySQL root user; make sure that you remember it.

macOS

Download the App Engine SDK for PHP:

file_download Download
Version:
1.9.88 - 2020-01-02

Size:
70.7 MB
SHA1 Checksum:
```
4846f70c818787e06964ac993bc2551dc81b8ca2
```
To install the SDK on macOS:
1. In the Finder, click Go > Applications to open the Applications folder.
2. Double click the GoogleAppEngineLauncher-1.9.88.dmg file that you downloaded to open it, then drag the GoogleAppEngineLauncher icon over to the Applications folder.
3. Double-click GoogleAppEngineLauncher in the Application folder.
4. When prompted to Make command symlinks, click OK. The symlinks allow you to run important SDK command-line tools in any terminal window.
  Important: The GoogleAppEngineLauncher is a convenient UI-based tool for running and deploying App Engine apps, but it does not provide all the features you'll need. You can use the equivalent gcloud command-line tool, for many of the tasks that you'll want to perform.
5. Notice that the installation process above unpacks the contents of the App Engine SDK at the location:
```
/usr/local/google_appengine
```
6. The App Engine PHP SDK requires Python 2.7, which is installed by default on Mac OS X 10.6 (Snow Leopard) or later. Verify your Mac's Python installation using the following command:
```
/usr/bin/env python -V
```
  If the output looks like Python 2.7.[NUMBER], then you already have the correct Python version installed. Otherwise you can install Python 2.7 from the Python web site.
7. Most PHP apps use a MySQL backend, which is not packaged with the App Engine SDK. To setup MySQL, visit the MySQL Downloads page ; the "Community Server" edition will suffice for your local development.

Windows

Download the App Engine SDK for PHP:

file_download Download
Version:
1.9.88 - 2020-01-02

Size:
53.6 MB
SHA1 Checksum:
```
046ff2208b90a3a3a8113f8389a776c3306faa69
```
To install the SDK on Windows:
1. Double-click the GoogleAppEngine-1.9.88.msi and follow the prompts to install the SDK.
2. The Local Development Server of the App Engine PHP SDK is a Python application and requires a Python 2.7.x version, but nothing higher. See the Python web site for download information: Python 2.7.5.
  Note: The PHP SDK includes binaries for the PHP 5.5 runtime, including all enabled extensions, so there is no need to download PHP separately for the purposes of developing with App Engine -- you just need Python.
3. Most PHP apps use a MySQL backend, which is not packaged with the App Engine SDK. To set up MySQL, see the MySQL Downloads page ; the "Community Server" edition will suffice for your local development.