Serverless App Engine:Deploy an application using a code package

Online applications: NGINX with PHP-FPM

Application monitoring: ARMS

For SAE applications with PHP versions 5.4 to 7.3, you can enable application monitoring to obtain more detailed monitoring information such as application call chain tracing and resource access latency for ApsaraDB RDS MySQL and Tair (Redis OSS-compatible).For more information, see ARMS application monitoring overview.

Software versions

The following table describes the available PHP runtime environments. If you need a higher version of PHP environment, please join the DingTalk group (Group number: 32874633) to consult with product technical experts.

System directories

The SAE PHP environment uses the following directories by default for application package deployment:

The following table describes the default configurations of PHP-FPM:

The following table describes the default configurations of NGINX:

Built-in extensions

Related permissions

By default, PHP-FPM and NGINX use the www-data user to run applications. The following table describes the permissions.

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

Default and PECL extensions

You can configure the php.ini file to specify built-in extensions when you deploy an application, including the default PHP extensions and PECL extensions.

php -m

Examples of built-in extensions supported by different runtime environments:

[PHP Modules]
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 Modules]
Xdebug
Zend OPcache

[PHP Modules]
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 Modules]
Xdebug
Zend OPcache

[PHP Modules]
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 Modules]
Xdebug
Zend OPcache

[PHP Modules]
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 Modules]
Xdebug
Zend OPcache

[PHP Modules]
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 Modules]
Xdebug
Zend OPcache

[PHP Modules]
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 Modules]
Xdebug
Zend OPcache

[PHP Modules]
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 Modules]
Xdebug

Install extensions through the console and API

You can enable default PHP extensions or install specific versions of PECL extensions through the SAE console or API. For more information, see Deploy a PHP application.

Install third-party extensions

This section describes how to install a third-party extension by compiling the YAML file that contains the source code in PHP-FPM 7.3.

1. Create a SAE application with PHP 7.3 as the runtime environment.

2. Enable Internet access.

3. Log on to the instance by using the webshell, and run the following commands to compile and install the extension:

   # Get the source code
   wget https://pecl.php.net/get/yaml-2.2.2.tgz
   tar -zxvf yaml-2.2.2.tgz
   # Compile and install the extension
   cd yaml-2.2.2 && \
   phpize && \
   ./configure && \
   make && make install

4. Download the extension to your on-premises machine. For more information, see Upload and download files to diagnose applications through logs.

   The directory of the extension:

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

5. Include the extension in the ZIP package of the application. ZIP package structure:

   .
   ├── nginx
   │ ├── default.conf
   │ ├── fastcgi_params
   │ ├── global
   │ └── root.dir
   ├── php
   │ ├── index.php
   └── extensions
    └── yaml.so

6. Deploy the application, upload the ZIP package that contains the extension, and then add the extension configuration to the php.ini file to enable the extension.

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

7. Log on to the instance by using the webshell and check whether the extension is loaded.

   # php -m | grep yaml
   yaml

Default service ports

The following table describes the default service ports of NGINX and PHP-FPM configured by SAE:

PHP-FPM logs: standard output

• PHP-FPM logs are contained in real-time logs. The following sample code provides an example of the log configuration in the /usr/local/etc/php-fpm.d/docker.conf file:

  [global]
  error_log = /proc/self/fd/2
  log_limit = 8192
  
  [www]
  access.log = /proc/self/fd/2

• The PHP error logs that are not displayed. The following sample code provides an example of the log configuration in the php.ini file.

  error_log => no value => no value
  log_errors => Off => Off
  log_errors_max_len => 1024 => 1024

• If you want to include the error logs in real-time logs, you must configure the php.ini file when you create or deploy an application. You must specify the following directory to store the error logs:

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

NGINX logs: standard output

• NGINX logs are contained in real-time logs. The following sample code provides an example of the log configuration in the ./nginx/default.conf file:

  #access_log /dev/stdout;
  error_log stderr;

• You can enable access_log. By default, the logs are contained in real-time logs.

File caching: static files, images, and media

; Enable OPcache
opcache.enable=1
; Disable OPcache
;opcache.enable=0

File caching: PHP code

You can enable or disable caching in NGINX for many static files, such as images, videos, Cascading Style Sheets (CSS) files, and JavaScript files. For more information about the configuration, see Module ngx_http_headers_module.

• Enable static resource caching: This option is suitable for online services and websites that load many media files. This improves traffic throughput and reduces read input/output operations per second (IOPS).

• Disable static resource caching: This option is suitable for remote debugging, upload and download, and other usage scenarios. You can access the files in real time.

    # Static resource caching
    location ~* \.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|svgz|mp4|ogg|ogv|webm|htc)$ {
        # Disable caching
        #expires off;
        # Enable caching
        expires 1s;
    }

Hot restart services

• ConfigMap allows you to modify the configurations without interrupting services.

• Webshell allows you to restart services without interrupting services.

  • Hot restart of NGINX

    # Test the validity of the configuration file
    nginx -t
    # Restart NGINX without service interruptions
    nginx -s reload

  • Hot restart of PHP-FPM (There is a certain probability of stream interruption. You need to check the php.ini configuration.)

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

Upload and download

SAE provides multiple methods to allow you to upload and download files. You can select one of the following methods based on your business requirements:

• Use the SAE console: You can upload and download files for debugging. The file size cannot exceed 10 MB. For more information, see Use the webshell feature to upload and download files.

• Use the SAE console: You can perform remote debugging.

• Use the persistence storage: Apsara File Storage NAS or Object Storage Service (OSS).

  • When you deploy an application, you can mount NAS or OSS and share file directories.

  • Upload and download NAS: Serverless Devs tool.

  • Upload and download OSS: OSS console.

  • Upload and download OSS: ossutil tool.