PHP 5런타임 환경

App Engine에서는 PHP 프로그래밍 언어를 사용하여 웹 애플리케이션을 빌드할 수 있습니다. PHP 애플리케이션은 Google의 확장 가능한 인프라에서 실행되며, 대규모 영구 저장소 및 서비스를 사용합니다.

PHP 런타임 선택

App Engine에서는 PHP 버전 5.5.34 인터프리터를 사용하여 PHP 웹 응용 프로그램을 실행합니다. 참고: Linux에서는 로컬 위치에도 PHP를 설치해야 PHP 애플리케이션을 실행할 수 있습니다.

앱이 PHP 런타임을 사용하도록 설정하려면 app.yaml 파일에 다음을 추가합니다.

runtime: php55
api_version: 1
...

첫 번째 요소인 runtime은 PHP 런타임 환경을 선택합니다.

두 번째 요소인 api_version은 사용할 PHP 런타임 환경 버전을 선택합니다. 문서 작성 시점을 기준으로, App Engine에는 한 가지 버전의 PHP 환경, 즉 버전 1만 있습니다. 향후 이전 버전과 호환되지 않을 수 있는 변경사항이 발생하면 App Engine팀은 새 버전 식별자를 사용할 것입니다. 사용자가 api_version 설정을 변경하고 앱을 업로드하기 전까지 앱에서는 계속해서 선택된 버전을 사용합니다.

app.yaml 파일에 대한 자세한 내용과 앱을 App Engine에 배포하는 방법은app.yaml 참조 및 PHP 앱 배포 항목을 참조하세요.

샌드박스

App Engine이 애플리케이션에 대한 요청을 여러 웹 서버에 배포할 수 있고 한 애플리케이션이 다른 애플리케이션을 방해하지 못하도록 하기 위해 애플리케이션은 제한된 '샌드박스' 환경에서 실행됩니다. 이 환경에서 애플리케이션은 코드를 실행하고, App Engine 메일, URL 가져오기, 사용자 서비스를 사용하고, 사용자의 웹 요청을 검사하여 응답을 준비할 수 있습니다.

App Engine 애플리케이션은 다음을 수행할 수 없습니다.

  • 파일 시스템에 쓰기. PHP 애플리케이션은 영구 파일을 저장하는 데 Google Cloud Storage를 사용할 수 있습니다. 파일 시스템에서 읽는 것은 허용되며 애플리케이션과 함께 업로드된 모든 애플리케이션 파일을 사용할 수 있습니다.

  • 늦은 응답. 애플리케이션에 대한 웹 요청은 몇 초 이내에 처리되어야 합니다. 응답에 매우 오랜 시간이 걸리는 프로세스는 웹 서버의 과부하를 방지하기 위해 종료됩니다.

  • 기타 유형의 시스템 호출

자동 클래스 로드

표준 PHP 라이브러리(SPL) 클래스와 App Engine용 SDK에 포함된 모든 클래스는 필요할 때 자동으로 로드됩니다. 따라서 PHP 스크립트의 맨 위에 include 또는 require 문을 사용할 필요가 없습니다.

기본적으로 App Engine용 SDK의 루트 디렉터리(--php_executable_path로 지정된 경우에는 로컬 PHP 설치 디렉터리)에 있는 파일에 정의된 클래스에 대해서만 자동 클래스 로드가 수행됩니다.

자동 클래스 로드를 위해 검색할 경로를 더 추가하려면 PHP 스크립트에서 set_include_path를 사용합니다.

set_include_path('my_additional_path' . PATH_SEPARATOR . get_include_path());

사용 설정된 확장 프로그램

App Engine용 PHP 런타임에는 다음과 같은 확장 프로그램이 사용 설정되어 있습니다.

  • apc
  • bcmath
  • calendar
  • Core
  • ctype
  • date
  • dom
  • ereg
  • exif
  • filter
  • ftp
  • gd
  • hash
  • iconv
  • json
  • libxml
  • mailparse
  • mbstring
  • mcrypt
  • memcache
  • memcached
  • mysql
  • mysqli
  • mysqlnd
  • OAuth
  • openssl
  • pcre
  • PDO
  • pdo_mysql
  • Reflection
  • session
  • shmop
  • SimpleXML
  • soap
  • sockets(결제가 사용 설정된 앱용)
  • SPL
  • standard
  • tokenizer
  • xml
  • xmlreader
  • xmlwriter
  • xsl
  • zip
  • zlib

동적으로 로드 가능한 확장 프로그램

php.ini를 구성하여 다음 확장 프로그램을 동적으로 로드할 수 있습니다.

  • cURL -이 확장 프로그램은 소켓 서비스를 사용하며 요청을 실행하며, 해당 서비스의 할당량 및 제한이 적용됩니다. 자세한 내용은 발신 요청을 참조하세요.
  • MongoDB - 이 확장 프로그램은 개발자가 기존 MongoDB 인스턴스에 연결할 수 있게 해줍니다. 소켓 서비스를 사용하여 요청을 실행하며, 해당 서비스의 할당량 및 제한이 적용됩니다.
  • ImageMagick
  • intl
  • fileinfo

이러한 확장 프로그램을 사용 설정하려면 다음과 같이 extension 아래의 php.ini 파일에 확장 프로그램에 대한 지시문을 추가합니다.

extension = "curl.so"
extension = "mongo.so"
extension = "imagick.so"
extension = "intl.so"
extension = "fileinfo.so"

세션

대부분의 웹 애플리케이션에는 요청 간에 사용자 상태 정보를 보존하기 위한 방법이 필요합니다. PHP는 편리한 세션 관리 계층을 제공합니다. App Engine의 세션은 다른 모든 PHP 애플리케이션의 세션과 매우 유사하게 작동합니다.

사용자 세션에서 변수 설정:

session_start();
$_SESSION['Foo'] = 'Bar';

동일한 사용자가 실행하는 이후 요청의 경우:

session_start();
print $_SESSION['Foo']; // prints Bar

기본적으로 App Engine 런타임은 Memcache를 통해 MemcacheSessionHandler 클래스를 사용하여 세션 정보를 저장합니다. PHP의 session_set_save_handler() 메서드를 사용하여 사용자 고유의 세션 핸들러를 지정하면 이 동작을 조정할 수 있습니다. memcache를 사용하면 세션 데이터를 빠르게 저장하고 검색할 수 있으므로 요청 오버헤드가 최소화됩니다. 하지만 App Engine memcache의 데이터는 주기적으로 플러시될 수 있으며 이 경우 세션 정보가 손실됩니다. 따라서 수명이 긴 세션의 경우에는 Cloud SQL과 같은 대체 스토리지 서비스를 사용하는 것이 좋습니다.

특수 $_SERVER 키

PHP는 요청 범위에서 특수한 $_SERVER[] 배열을 사용할 수 있도록 지원합니다. App Engine은 표준 CGI 매개변수 외에도 몇 가지 유용한 키를 추가합니다.

  • APPLICATION_ID - 애플리케이션 생성 시 설정된 애플리케이션의 app_id(예: my-wordpress)입니다.
  • AUTH_DOMAIN: Users API로 사용자를 인증하는 데 사용되는 도메인입니다. appspot.com에 호스팅되는 앱은 gmail.com의 AUTH_DOMAIN이 있으며 모든 Google 계정을 허용합니다. Google Workspace를 사용하여 커스텀 도메인에서 호스팅된 앱에는 커스텀 도메인과 동일한 AUTH_DOMAIN이 있습니다.
  • CURRENT_VERSION_ID - 현재 실행 중인 애플리케이션의 주 버전 및 부 버전(예: 'X.Y')입니다. 주 버전 번호('X')는 앱의 app.yaml 파일에서 지정됩니다. 부 버전 번호('Y')는 앱의 각 버전이 App Engine에 업로드될 때 자동으로 설정됩니다. 개발용 웹 서버에서 부 버전은 항상 '1'입니다.
  • DEFAULT_VERSION_HOSTNAME - 이 애플리케이션의 기본 버전 호스트 이름(예: my-php-app.uc.r.appspot.com)입니다.
  • HTTP_X_APPENGINE_CITY - 요청이 시작된 도시 이름입니다. 예를 들어 Mountain View 도시에서 시작된 요청에는 헤더 값 mountain view가 포함될 수 있습니다.
  • HTTP_X_APPENGINE_CITYLATLONG - 요청이 시작된 도시의 위도 및 경도입니다. Mountain View에서 시작된 요청의 경우 이 문자열은 '37.386051,-122.083851'과 같이 표시될 수 있습니다.
  • HTTP_X_APPENGINE_COUNTRY - 요청이 시작된 국가로, ISO 3166-1 alpha-2 국가 코드 형식입니다. App Engine은 클라이언트의 IP 주소로부터 이 코드를 확인합니다.
  • HTTP_X_APPENGINE_REGION - 요청이 시작된 지역의 이름입니다. 이 값은 X-Appengine-Country에 지정된 국가를 기준으로 적용됩니다. 예를 들어 국가가 'US'이고 지역이 'ca'일 때, 'ca'는 캐나다가 아닌 '캘리포니아'를 의미합니다.
  • USER_EMAIL - 사용자가 Users API를 사용하여 인증된 경우 사용자의 이메일 주소를 반환합니다. 애플리케이션에서는 표시 가능한 이름에 닉네임을 사용해야 합니다.
  • USER_ID - 이메일 주소가 Google 계정과 연결된 경우 user_id는 사용자의 고유 영구 ID를 문자열 형식으로 반환합니다. Users API를 사용하여 인증된 경우 이 ID는 사용자가 자신의 이메일 주소를 변경하더라도 이에 상관없이 항상 해당 사용자에게 고유하게 적용됩니다.
  • USER_IS_ADMIN - 로그인한 사용자가 Users API를 사용하여 인증된 경우 이 사용자가 애플리케이션의 관리자이기도 하면 1이고, 그렇지 않으면 0입니다.
  • USER_NICKNAME - Google 계정 사용자의 경우 사용자의 이메일 주소가 애플리케이션과 동일한 도메인에 있으면 해당 주소의 '이름' 부분이 닉네임이 되고, 그렇지 않으면 사용자의 전체 이메일 주소가 닉네임이 됩니다.
  • USER_ORGANIZATION - Google 계정 설정을 사용하는 애플리케이션은 현재 로그인한 사용자가 개인 Google 계정이나 Google Workspace 도메인에서 관리되는 계정을 사용하고 있는지 확인할 수 있습니다.

1.9.0에서 업데이트된 PHP_SELF 및 SCRIPT_NAME 동작

1.9.0 이후부터는 $_SERVER['SCRIPT_NAME'] 및 $_SERVER['PHP_SELF'] 구현이 1.9.0 이전 버전과 크게 달라져서 PHP 애플리케이션에서 일반적으로 예상하는 Apache 구현과 일관되게 변경되었습니다.

다음 예에서는 이러한 차이점을 보여줍니다.

1.9.0 이전1.9.0 이후

app.yaml:

- url: /.*
  script: index.php
 

REQUEST_URI: /
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /
      PHP_SELF: /
 

REQUEST_URI: /
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /index.php
PHP_SELF: /index.php
 

REQUEST_URI: /bar
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /bar
PHP_SELF: /bar
 

REQUEST_URI: /bar
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /index.php
PHP_SELF: /index.php
 

REQUEST_URI: /index.php/foo/bar
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /index.php/foo/bar
PHP_SELF: /index.php/foo/bar
 

REQUEST_URI: /index.php/foo/bar
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /index.php
PHP_SELF: /index.php/foo/bar
 

REQUEST_URI: /test.php/foo/bar
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /test.php/foo/bar
PHP_SELF: /test.php/foo/bar
 

REQUEST_URI: /test.php/foo/bar
SCRIPT_FILENAME: /path/to/index.php
SCRIPT_NAME: /index.php
PHP_SELF: /index.php

app.yaml:

- url: /.*
  script: foo/index.php
 

REQUEST_URI: /bar
SCRIPT_FILENAME: /path/to/foo/index.php
SCRIPT_NAME: /bar
PHP_SELF: /bar
 

REQUEST_URI: /bar
SCRIPT_FILENAME: /path/to/foo/index.php
SCRIPT_NAME: /foo/index.php
PHP_SELF: /foo/index.php

새 초기화 기본값이 있는 지시문

다음 표에는 초기화 기본값이 php.net에서 제공되는 표준 PHP 인터프리터의 기본값과 다른 지시문이 나와 있습니다. 애플리케이션의 php.ini 파일에 지시문을 포함하는 방법으로 이러한 기본 지시문을 재정의할 수 있습니다.

지시문 App Engine의 기본값
detect_unicode false
session.gc_maxlifetime 600
session.cookie_secure 600
session.cookie_httponly 1
session.use_only_cookies 1
display_errors 0
display_startup_errors 0
html_errors 0
log_errors 1
file_uploads 0
upload_max_filesize 262144
max_file_uploads 0
date.timezone UTC
sendmail_path null
allow_url_fopen 1
allow_url_include 0
enable_dl 0
expose_php Off
register_globals Off
magic_quotes_gpc 0
mysqlnd.collect_statistics 0
mysql.allow_local_infile 0
mysqli.allow_local_infile 0

사용 중지된 함수

보안상의 이유로 또는 App Engine 실행 환경과의 호환성을 위해 일부 PHP 함수가 사용 중지되었습니다. 이러한 함수 중 일부는 애플리케이션의 php.ini 파일에서 명시적으로 다시 사용 설정할 수 있습니다.

영구적으로 사용 중지된 함수

다음 함수는 App Engine에서 영구적으로 사용 중지되었습니다.

  • disk_free_space()
  • disk_total_space()
  • diskfreespace()
  • escapeshellarg() and escapeshellcmd()
  • exec()
  • highlight_file()
  • lchgrp(), lchown(), link(), and symlink()
  • passthru()
  • pclose() and popen()
  • proc_close(), prog_get_status(), proc_nice(), proc_open(), and proc_terminate()
  • set_time_limit()
  • shell_exec()
  • show_source()
  • system()

App Engine은 pcntl 확장 프로그램이 포함되어 있지 않으므로 App Engine에서 실행되는 PHP 앱은 pcntl에서 제공하는 함수를 사용할 수 없습니다.

tempnam() 및 sys_get_temp_dir() 지원

App Engine 앱은 로컬 파일 시스템에 쓰기를 허용하지 않는 보안 샌드박스에서 실행됩니다. 이러한 이유로 App Engine의 tempnam() 버전은 이후에 Google Cloud Storage 버킷과 같은 영구 스토리지 솔루션에 쓸 수 있는 메모리 내 임시 파일을 반환합니다.

다음 예시에서는 file_put_contents() 및 fwrite()를 사용하여 메모리 내 임시 파일에 쓰는 방법을 보여줍니다.

<?php
$dir = sys_get_temp_dir();
$tmp = tempnam($dir, “foo”);
file_put_contents($tmp, “hello”)
$f = fopen($tmp, “a”);
fwrite($f, “ world”);
fclose($f)
echo file_get_contents($tmp);

이 예시의 예상 결과는 다음과 같습니다.

hello world

부분적으로 제한된 함수

PHP 런타임용 App Engine은 preg_replace() 및 mb_ereg_replace() 함수의 /e 패턴 한정자를 지원하지 않습니다. 지원 중단 알림 및 PREG_REPLACE_EVAL을 대신 사용하도록 코드를 업데이트하는 방법의 예시를 보려면 preg_replace_callback() 문서를 참조하세요.

수동으로 사용 설정할 수 있는 함수

이 목록에는 애플리케이션의 php.ini 파일에서 google_app_engine.enable_functions 지시문을 사용하여 수동으로 사용 설정해야 하는 PHP 함수가 나와 있습니다.

  • gc_collect_cycles(), gc_enable(), gc_disable(), gc_enabled()
  • getmypid()
  • getmyuid(), getmygid()
  • getrusage()
  • getmyinode()
  • get_current_user()
  • libxml_disable_entity_loader()*
  • parse_str()
  • phpinfo()
  • phpversion()
  • php_uname()
  • php_sapi_name()

또한 애플리케이션 php.ini 파일에서 disable_functions 지시문을 사용하여 함수를 수동으로 사용 중지할 수도 있습니다.

결제를 사용 설정해야 사용 가능한 함수

다음 함수는 소켓을 사용하므로 결제가 사용 설정된 앱에서만 사용할 수 있습니다.

스트림 지원

지원되는 PHP I/O 스트림 래퍼

다음과 같은 PHP I/O 스트림 래퍼가 지원됩니다.

  • php://input
  • php://output
  • php://memory
  • php://temp

스트림 래퍼

fopen() 또는 file_get_contents()를 비롯한 많은 PHP 함수는 PHP의 스트림 인터페이스를 사용하여 다양한 프로토콜을 지원합니다.

다음 목록에는 App Engine 런타임에 자동으로 등록되어 사용 가능한 기본 제공 스트림 래퍼가 나와 있습니다.

  • file://
  • glob://
  • http://(PHP의 기본 제공 http 스트림 핸들러처럼 동작하지만 App Engine URLfetch 서비스를 사용합니다.)
  • https://(App Engine URLfetch 서비스를 사용합니다.)
  • ftp://
  • gs://(Google Cloud Storage의 스트림 핸들러입니다.)
  • zlib://

다음 목록에는 App Engine에서 지원되지 않으며 등록되지 않은 기본 제공 스트림 핸들러가 나와 있습니다.

  • data://
  • expect://
  • ogg://
  • phar://
  • rar://
  • ssh2://

사용 중지된 스트림 전송

다음 스트림 전송은 사용 중지되었습니다.

  • ssl
  • sslv2
  • sslv3
  • tcp
  • tls
  • udg
  • udp
  • unix

순수 PHP

PHP 런타임 환경의 모든 코드는 순수 PHP여야 합니다. 사용자 고유의 C 확장 프로그램은 App Engine으로 업로드할 수 없습니다.

환경에는 PHP 표준 라이브러리가 포함되어 있습니다. 일부 확장 프로그램은 핵심 기능이 네트워킹 및 파일 시스템에 쓰기 같이 App Engine에서 지원되지 않는 기능이어서 사용 중지되었습니다.

다른 순수 PHP 라이브러리는 해당 코드를 애플리케이션의 디렉터리(app.yaml 파일이 포함된 디렉터리와 동일한 디렉터리)에 넣는 방법으로 애플리케이션과 함께 포함할 수 있습니다.

예를 들어 애플리케이션의 디렉터리에 라이브러리의 디렉터리를 가리키는 기호화된 링크를 만들 수 있습니다. 그러면 App Engine에 애플리케이션을 배포할 때 이 링크를 따라 해당 라이브러리를 애플리케이션에 포함할 수 있습니다.

코드에서 php.ini 지시문을 지정하고 PHP include 문을 포함하는 방법으로 PHP 라이브러리를 포함할 수도 있습니다. 하지만 이 방법보다는 Composer 같은 PHP 종속성 관리 도구를 사용하는 것이 더 좋습니다.

예를 들면 다음과 같습니다.

  • 애플리케이션의 루트 디렉터리를 php.ini 파일의 include_path 지시문에 포함하는 경우:

    include_path=".:/[ROOT_DIR]/myapp"

    그러면 include 또는 include_once 문을 사용하여 include_path에 상대적인 경로로 PHP 파일을 포함할 수 있습니다.

    include_once 'myfile.php';

  • Composer를 사용하여 순수 PHP 라이브러리를 포함하려는 경우에는 종속 항목이 설치된 후 단일 파일을 포함하기만 하면 됩니다.

    require_once 'vendor/autoload.php';

    Composer를 사용하여 애플리케이션의 종속 항목을 설치할 때는 모든 패키지가 애플리케이션 디렉터리의 vendor 아래에 추가되며, 이 디렉터리에서 autoload.php 파일도 생성됩니다.

도구

App Engine용 SDK에는 애플리케이션을 테스트하고 애플리케이션 파일을 업로드하기 위한 도구가 포함되어 있습니다.

개발 서버는 로컬 컴퓨터에서 애플리케이션을 실행하여 애플리케이션을 테스트합니다.

gcloud 도구는 App Engine에서 실행되는 애플리케이션과의 모든 명령줄 상호작용을 처리합니다. gcloud app deploy를 사용하면 애플리케이션을 App Engine에 업로드하거나 개별 구성 파일을 업데이트할 수 있습니다. 또한 앱의 로그 데이터를 볼 수 있으므로 원하는 도구를 사용하여 앱의 성능을 분석할 수도 있습니다.

PHP 인터프리터 소스 코드

App Engine의 PHP 인터프리터용 소스 코드는 GitHub의 appengine-php 저장소에서 다운로드할 수 있습니다.

동시성 및 지연 시간

애플리케이션의 지연 시간은 트래픽을 처리하는 데 필요한 인스턴스 수에 가장 큰 영향을 줍니다. 요청을 신속하게 처리하면 단일 인스턴스로 많은 요청을 처리할 수 있습니다.

환경 변수

다음 환경 변수는 런타임에서 설정됩니다.

환경 변수 설명
GAE_APPLICATION App Engine 애플리케이션 ID입니다. 이 ID는 유럽에 배포된 애플리케이션의 'e~'와 같이 'region code~'로 시작됩니다.
GAE_DEPLOYMENT_ID 현재 배포 ID입니다.
GAE_ENV App Engine 환경입니다. standard로 설정합니다.
GAE_INSTANCE 서비스가 현재 실행되고 있는 인스턴스 ID입니다.
GAE_RUNTIME app.yaml 파일에 지정된 런타임입니다.
GAE_SERVICE app.yaml 파일에 지정된 서비스 이름입니다. 서비스 이름을 지정하지 않으면 default로 설정됩니다.
GAE_VERSION 서비스의 현재 버전 라벨입니다.
GOOGLE_CLOUD_PROJECT 애플리케이션과 연결된 Google Cloud 프로젝트 ID입니다.
PORT HTTP 요청을 수신하는 포트입니다.

app.yaml 파일에 추가 환경 변수를 정의할 수 있지만 위의 값을 재정의할 수 없습니다.