Serverless App Engine:コードパッケージを使用してアプリケーションをデプロイする

オンラインアプリケーション: NGINX with PHP-FPM

アプリケーションモニタリング: ARMS

PHP バージョン 5.4 から 7.3 の SAE アプリケーションでは、アプリケーションモニタリングを有効にして、ApsaraDB RDS MySQL および Tair (Redis OSS 互換) のアプリケーション呼び出しチェーントレーシングやリソースアクセスレイテンシなどのより詳細なモニタリング情報を取得できます。詳細については、「ARMS アプリケーションモニタリングの概要」をご参照ください。

ソフトウェアバージョン

次の表は、使用可能な PHP ランタイム環境について説明しています。より高いバージョンの PHP 環境が必要な場合は、DingTalk グループ (グループ番号: 32874633) に参加して、製品の技術専門家に相談してください。

システムディレクトリ

SAE PHP 環境では、アプリケーションパッケージのデプロイにデフォルトで次のディレクトリを使用します。

次の表は、PHP-FPM のデフォルト構成について説明しています。

次の表は、NGINX のデフォルト構成について説明しています。

組み込み拡張機能

関連する権限

デフォルトでは、PHP-FPM と NGINX は www-data ユーザーを使用してアプリケーションを実行します。次の表は、権限について説明しています。

www-data www-data

www-data www-data

root root

drwxrwxrwx 2 root root 4096 May 13  2021 nginx
drwxrwxrwx 1 root root 4096 Apr  8 11:45 php

デフォルトおよび PECL 拡張機能

アプリケーションをデプロイするときに、php.ini ファイルを構成して組み込み拡張機能を指定できます。これには、デフォルトの PHP 拡張機能と PECL 拡張機能が含まれます。詳細については、「PHP アプリケーション構成ファイルの構成」をご参照ください。

php -m

さまざまなランタイム環境でサポートされている組み込み拡張機能の例:

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
mcrypt
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
Zend OPcache
zip
zlib

/*[Zend モジュール]*/
Xdebug
Zend OPcache

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
mcrypt
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
Zend OPcache
zip
zlib

/*[Zend モジュール]*/
Xdebug
Zend OPcache

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
mcrypt
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
Zend OPcache
zip
zlib

/*[Zend モジュール]*/
Xdebug
Zend OPcache

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
Zend OPcache
zip
zlib

/*[Zend モジュール]*/
Xdebug
Zend OPcache

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
Zend OPcache
zip
zlib

/*[Zend モジュール]*/
Xdebug
Zend OPcache

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
Zend OPcache
zip
zlib

/*[Zend モジュール]*/
Xdebug
Zend OPcache

/*[PHP モジュール]*/
amqp
ARMS
bcmath
bz2
calendar
Core
ctype
curl
date
dom
ereg
exif
fileinfo
filter
ftp
gettext
gmp
hash
iconv
igbinary
imagick
json
libxml
mbstring
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
recode
redis
Reflection
session
shmop
SimpleXML
soap
sockets
SPL
sqlite3
standard
swoole
sysvmsg
sysvsem
sysvshm
timezonedb
tokenizer
xdebug
xml
xmlreader
xmlrpc
xmlwriter
yaml
zip
zlib

/*[Zend モジュール]*/
Xdebug

コンソールと API を介した拡張機能のインストール

SAE コンソールまたは API を使用して、デフォルトの PHP 拡張機能を有効にしたり、特定のバージョンの PECL 拡張機能をインストールしたりできます。詳細については、「PHP アプリケーションのデプロイ」をご参照ください。

サードパーティ製拡張機能のインストール

このセクションでは、PHP-FPM 7.3 でソースコードを含む YAML ファイルをコンパイルして、サードパーティ製拡張機能をインストールする方法について説明します。

1. ランタイム環境として PHP 7.3 を使用して SAE アプリケーションを作成します。

2. インターネットアクセスを有効にします。

3. webshell を使用してインスタンスにログオンし、次のコマンドを実行して拡張機能をコンパイルおよびインストールします。

   /*# ソースコードを取得する*/
   wget https://pecl.php.net/get/yaml-2.2.2.tgz
   tar -zxvf yaml-2.2.2.tgz
   /*# 拡張機能をコンパイルしてインストールする*/
   cd yaml-2.2.2 && \
   phpize && \
   ./configure && \
   make && make install

4. 拡張機能をオンプレミスマシンにダウンロードします。詳細については、「ログを通じてアプリケーションを診断するためにファイルをアップロードおよびダウンロードする」をご参照ください。

   拡張機能のディレクトリ:

   /home/admin/yaml-2.2.2/modules/yaml.so

5. 拡張機能をアプリケーションの ZIP パッケージに含めます。ZIP パッケージの構造:

   .
   ├── nginx
   │ ├── default.conf
   │ ├── fastcgi_params
   │ ├── global  // グローバル
   │ └── root.dir // ルートディレクトリ
   ├── php
   │ ├── index.php // インデックスファイル
   └── extensions
    └── yaml.so

6. アプリケーションをデプロイし、拡張機能を含む ZIP パッケージをアップロードしてから、拡張機能の構成を php.ini ファイルに追加して拡張機能を有効にします。

   extension=/home/admin/app/extensions/yaml.so

7. webshell を使用してインスタンスにログオンし、拡張機能がロードされているかどうかを確認します。

   # php -m | grep yaml  // php モジュールを確認し、yaml が存在するかチェック
   yaml

デフォルトのサービスポート

次の表は、SAE によって構成された NGINX および PHP-FPM のデフォルトのサービスポートについて説明しています。

PHP-FPM ログ: 標準出力

• PHP-FPM ログはリアルタイムログに含まれています。次のサンプルコードは、/usr/local/etc/php-fpm.d/docker.conf ファイルのログ構成の例を示しています。

  /*[グローバル]*/
  error_log = /proc/self/fd/2
  log_limit = 8192
  
  /*[www]*/
  access.log = /proc/self/fd/2

• 表示されない PHP エラーログ。次のサンプルコードは、php.ini ファイルのログ構成の例を示しています。

  error_log => no value => no value /*エラーログ => 値なし => 値なし*/
  log_errors => Off => Off /*ログエラー => オフ => オフ*/
  log_errors_max_len => 1024 => 1024 /*ログエラーの最大長 => 1024 => 1024*/

• エラーログをリアルタイムログに含める場合は、アプリケーションの作成時またはデプロイ時に php.ini ファイルを構成する必要があります。エラーログを格納する次のディレクトリを指定する必要があります。

  log_errors = on
  error_log = /proc/self/fd/2

NGINX ログ: 標準出力

• NGINX ログはリアルタイムログに含まれています。次のサンプルコードは、./nginx/default.conf ファイルのログ構成の例を示しています。

  #access_log /dev/stdout;
  error_log stderr;

• access_log を有効にできます。デフォルトでは、ログはリアルタイムログに含まれています。

ファイルキャッシング: 静的ファイル、イメージ、メディア

; OPcache を有効にする
opcache.enable=1
; OPcache を無効にする
;opcache.enable=0

ファイルキャッシング: PHP コード

NGINX で、イメージ、ビデオ、カスケードスタイルシート (CSS) ファイル、JavaScript ファイルなど、多くの静的ファイルのキャッシングを有効または無効にすることができます。構成の詳細については、「モジュール ngx_http_headers_module」をご参照ください。

• 静的リソースのキャッシングを有効にする: このオプションは、多くのメディアファイルをロードするオンラインサービスや Web サイトに適しています。これにより、トラフィックスループットが向上し、1 秒あたりの読み取り入出力操作 (IOPS) が削減されます。

• 静的リソースのキャッシングを無効にする: このオプションは、リモートデバッグ、アップロードとダウンロード、その他の使用シナリオに適しています。ファイルにリアルタイムでアクセスできます。

/* 静的リソースのキャッシング */
    location ~* \.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|svgz|mp4|ogg|ogv|webm|htc)$ {
        /*# キャッシングを無効にする */
        /*#expires off;*/
        /*# キャッシングを有効にする */
        expires 1s;
    }

ホットリスタートサービス

• ConfigMap を使用すると、サービスを中断することなく構成を変更できます。

• Webshell を使用すると、サービスを中断することなくサービスを再起動できます。

  • NGINX のホットリスタート

    /*# 構成ファイルの有効性をテストする*/
    nginx -t
    /*# サービスを中断することなく NGINX を再起動する*/
    nginx -s reload

  • PHP-FPM のホットリスタート (ストリームの中断の可能性があります。php.ini 構成を確認する必要があります。)

    ps uax | grep 'php-fpm: master' | grep -v grep | awk '{print $2}' | xargs kill -USR2

アップロードとダウンロード

SAE は、ファイルをアップロードおよびダウンロードするための複数の方法を提供します。ビジネス要件に基づいて、次のいずれかの方法を選択できます。

• SAE コンソールの使用: デバッグ用にファイルをアップロードおよびダウンロードできます。ファイルサイズは 10 MB を超えることはできません。詳細については、「webshell 機能を使用してファイルをアップロードおよびダウンロードする」をご参照ください。

• SAE コンソールの使用: リモートデバッグを実行できます。

• 永続ストレージの使用: Apsara File Storage NAS または Object Storage Service (OSS)。

  • アプリケーションをデプロイするときに、NAS または OSS をマウントしてファイルディレクトリを共有できます。

  • NAS のアップロードとダウンロード: Serverless Devs ツール。

  • OSS のアップロードとダウンロード: OSS コンソール。

  • OSS のアップロードとダウンロード: ossutil ツール。