Google App Engine SDK for PHP

Note: The App Engine SDK is under active development; please keep this in mind as you explore its capabilities. See the SDK Release Notes for information on the most recent changes to the App Engine SDK. If you discover any issues, feel free to notify us via our Issue Tracker.

To install on Linux:

1. Unzip the App Engine PHP file you downloaded (google_appengine_1.9.22.zip). For example:

   unzip google_appengine_1.9.22.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:/path/to/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. Install version 5.4 of the php-cgi binary. PHP 5.4 is not packaged on most Linux distributions so it may be easiest to install it from source. On Debian-based Linux systems, you can use the following commands to install PHP 5.4 in such a way that it won't affect any other versions of PHP that you may have installed:

   sudo apt-get install gcc libmysqlclient-dev libxml2-dev
   wget --trust-server-names http://us2.php.net/get/php-5.4.25.tar.bz2/from/us1.php.net/mirror
   tar -xvf php-5.4.25.tar.bz2
   cd php-5.4.25
   ./configure --prefix=$PWD/installdir --enable-bcmath --with-mysql --with-pdo-mysql
   make install
   cd -

   Note: At the time of writing, php-cgi (the binary used by the PHP SDK) can be found in php-5.4.25/installdir/bin/php-cgi.

5. 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.

To install the SDK on Mac OS X:

1. In the Finder, click Go > Applications to open the Applications folder.
2. Double click the App Engine SDK file you downloaded (GoogleAppEngineLauncher-1.9.22.dmg) 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 will need to use the command-line equivalent, appcfg.py, for many of the features you'll want to use.

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 (Lion) 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 download and 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.

To install the SDK on Windows:

1. Double-click the SDK file you downloaded (GoogleAppEngine-1.9.22.msi) and follow the prompts to install the SDK.
2. You will need Python 2.7 to use the App Engine PHP SDK, because the Development Server is a Python application. Download Python 2.7.X (don't use a higher version) from the Python web site.

   Note: The PHP SDK includes binaries for the PHP 5.4 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, visit the MySQL Downloads page; the "Community Server" edition will suffice for your local development.

For more information on the SDK for PHP:

• PHP Runtime Environment
• Getting Started Guide