Serverless App Engine:Deploy an application using a code package

Aplicaciones en producción: NGINX con PHP-FPM

Monitoreo de aplicaciones: ARMS

En las aplicaciones de SAE con versiones de PHP de la 5.4 a la 7.3, habilite el monitoreo de aplicaciones para obtener información más detallada. Esto incluye el rastreo de la cadena de llamadas de la aplicación y la latencia de acceso a recursos para ApsaraDB RDS MySQL y Tair (compatible con Redis OSS).Para más información, consulte ARMS application monitoring overview.

Versiones de software

A continuación se describen los entornos de ejecución de PHP disponibles. Si necesita una versión superior del entorno de PHP, únase al grupo de DingTalk (número de grupo: 32874633) para consultar con los expertos técnicos del producto.

Directorios del sistema

El entorno PHP de SAE utiliza de forma predeterminada los siguientes directorios para el despliegue del paquete de la aplicación:

A continuación se describen las configuraciones predeterminadas de PHP-FPM:

A continuación se describen las configuraciones predeterminadas de NGINX:

Extensiones integradas

Permisos relacionados

De forma predeterminada, PHP-FPM y NGINX utilizan el usuario www-data para ejecutar las aplicaciones. En la siguiente tabla se describen los permisos.

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

Extensiones predeterminadas y de PECL

Configure el archivo php.ini para especificar las extensiones integradas cuando despliegue una aplicación. Esto incluye las extensiones predeterminadas de PHP y las de PECL.

php -m

A continuación se muestran ejemplos de las extensiones integradas compatibles con distintos entornos de ejecución:

[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

Instalación de extensiones mediante la consola y la API

Habilite las extensiones predeterminadas de PHP o instale versiones específicas de extensiones de PECL desde la consola de SAE o mediante la API. Para más información, consulte Deploy a PHP application.

Instalación de extensiones de terceros

En esta sección se explica cómo instalar una extensión de terceros mediante la compilación del archivo YAML que contiene el código fuente en PHP-FPM 7.3.

1. Cree una aplicación de SAE con PHP 7.3 como entorno de ejecución.

2. Habilite el acceso a Internet.

3. Inicie sesión en la instancia mediante webshell y ejecute los siguientes comandos para compilar e instalar la extensión:

   # 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. Descargue la extensión a su máquina local. Para más información, consulte Upload and download files to diagnose applications through logs.

   Directorio de la extensión:

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

5. Incluya la extensión en el paquete ZIP de la aplicación. Estructura del paquete ZIP:

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

6. Despliegue la aplicación, cargue el paquete ZIP que contiene la extensión y agregue la configuración de la extensión al archivo php.ini para habilitarla.

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

7. Inicie sesión en la instancia mediante webshell y compruebe si la extensión se cargó correctamente.

   # php -m | grep yaml
   yaml

Puertos de servicio predeterminados

A continuación se describen los puertos de servicio predeterminados de NGINX y PHP-FPM que configura SAE:

Registros de PHP-FPM: salida estándar

• Los registros de PHP-FPM se incluyen en los registros en tiempo real. El siguiente fragmento de código muestra un ejemplo de la configuración de registros en el archivo /usr/local/etc/php-fpm.d/docker.conf:

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

• Los registros de errores de PHP no se muestran. El siguiente fragmento de código muestra un ejemplo de la configuración de registros en el archivo php.ini.

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

• Si desea incluir los registros de errores en los registros en tiempo real, configure el archivo php.ini al crear o desplegar una aplicación. Especifique el siguiente directorio para almacenar los registros de errores:

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

Registros de NGINX: salida estándar

• Los registros de NGINX se incluyen en los registros en tiempo real. El siguiente fragmento de código muestra un ejemplo de la configuración de registros en el archivo ./nginx/default.conf:

  #access_log /dev/stdout;
  error_log stderr;

• Habilite access_log. De forma predeterminada, los registros se incluyen en los registros en tiempo real.

Caché de archivos: archivos estáticos, imágenes y contenido multimedia

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

Caché de archivos: código PHP

Habilite o deshabilite la caché en NGINX para diversos archivos estáticos, como imágenes, videos, archivos CSS (Cascading Style Sheets) y archivos JavaScript. Para más información sobre la configuración, consulte Módulo ngx_http_headers_module.

• Habilitar la caché de recursos estáticos: esta opción es adecuada para servicios y sitios web en producción que cargan muchos archivos multimedia. Mejora el rendimiento del tráfico y reduce las operaciones de lectura de entrada/salida por segundo (IOPS).

• Deshabilitar la caché de recursos estáticos: esta opción es adecuada para depuración remota, carga y descarga de archivos, y otros escenarios de uso. Permite acceder a los archivos en tiempo real.

    # 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;
    }

Reinicio en caliente de servicios

• ConfigMap le permite modificar las configuraciones sin interrumpir los servicios.

• Webshell le permite reiniciar los servicios sin interrumpirlos.

  • Reinicio en caliente de NGINX

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

  • Reinicio en caliente de PHP-FPM (existe cierta probabilidad de interrupción del flujo; debe comprobar la configuración de php.ini).

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

Carga y descarga

SAE ofrece varios métodos para cargar y descargar archivos. Seleccione uno de los siguientes métodos según sus necesidades de negocio:

• Mediante la consola de SAE: cargue y descargue archivos para depuración. El tamaño del archivo no puede superar los 10 MB. Para obtener más información, consulte Upload and download files via webshell.

• Mediante la consola de SAE: ejecute la depuración remota.

• Mediante el almacenamiento persistente: Apsara File Storage NAS u Object Storage Service (OSS).

  • Al desplegar una aplicación, monte NAS u OSS y comparta directorios de archivos.

  • Carga y descarga en NAS: herramienta Serverless Devs.

  • Carga y descarga en OSS: consola de OSS.

  • Carga y descarga en OSS: ossutil tool.