Serverless App Engine:Deploy an application using a code package

Aplicativos online: NGINX com PHP-FPM

Monitoramento de aplicativos: ARMS

Para aplicativos do SAE com versões do PHP de 5.4 a 7.3, ative o monitoramento de aplicativos para obter informações mais detalhadas, como o rastreamento da cadeia de chamadas do aplicativo e a latência de acesso a recursos para o ApsaraDB RDS MySQL e Tair (compatível com Redis OSS-compatible).Para obter mais informações, consulte {{XREF_4}}.

Versões de software

A tabela a seguir descreve os ambientes de execução PHP disponíveis. Se você precisar de uma versão superior do ambiente PHP, entre no grupo do DingTalk (Número do grupo: 32874633) para consultar os especialistas técnicos do product.

Diretórios do sistema

O ambiente PHP do SAE usa os seguintes diretórios por padrão para a implantação do pacote de aplicativos:

A tabela a seguir descreve as configurações padrão do PHP-FPM:

A tabela a seguir descreve as configurações padrão do NGINX:

Extensões integradas

Permissões relacionadas

Por padrão, o PHP-FPM e o NGINX usam o usuário www-data para executar aplicativos. A tabela a seguir descreve as permissões.

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

Extensões padrão e PECL

Ao implantar um aplicativo, configure o arquivo php.ini para especificar as extensões integradas, incluindo as extensões padrão do PHP e as extensões PECL.

php -m

Exemplos de extensões integradas com suporte em diferentes ambientes de execução:

[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

Instalar extensões pelo console e API

Ative as extensões padrão do PHP ou instale versões específicas de extensões PECL pelo console do SAE ou pela API. Para obter mais informações, consulte {{XREF_10}}.

Instalar extensões de terceiros

Esta seção descreve como instalar uma extensão de terceiros compilando o código-fonte da extensão YAML no PHP-FPM 7.3.

1. Crie um aplicativo do SAE com o PHP 7.3 como ambiente de execução.

2. Ative o acesso à Internet.

3. Acesse a instância usando o webshell e execute os seguintes comandos para compilar e instalar a extensão:

   # 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. Baixe a extensão para a sua máquina local. Para obter mais informações, consulte {{XREF_12}}.

   Diretório da extensão:

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

5. Inclua a extensão no pacote ZIP do aplicativo. Estrutura do pacote ZIP:

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

6. Implante o aplicativo, faça o upload do pacote ZIP que contém a extensão e adicione a configuração da extensão ao arquivo php.ini para ativá-la.

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

7. Acesse a instância usando o webshell e verifique se a extensão foi carregada.

   # php -m | grep yaml
   yaml

Portas de service padrão

A tabela a seguir descreve as portas de service padrão do NGINX e do PHP-FPM configuradas pelo SAE:

Logs do PHP-FPM: saída padrão

• Os logs do PHP-FPM estão contidos nos logs em tempo real. O código de exemplo a seguir mostra a configuração de log no arquivo /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

• Os logs de erro do PHP que não são exibidos. O código de exemplo a seguir mostra a configuração de log no arquivo php.ini.

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

• Para incluir os logs de erro nos logs em tempo real, configure o arquivo php.ini ao criar ou implantar um aplicativo. Especifique o seguinte diretório para armazenar os logs de erro:

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

Logs do NGINX: saída padrão

• Os logs do NGINX estão contidos nos logs em tempo real. O código de exemplo a seguir mostra a configuração de log no arquivo ./nginx/default.conf:

  #access_log /dev/stdout;
  error_log stderr;

• Ative o access_log. Por padrão, os logs estão contidos nos logs em tempo real.

Cache de arquivos: arquivos estáticos, imagens e mídias

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

Cache de arquivos: código PHP

Ative ou desative o cache no NGINX para vários arquivos estáticos, como imagens, vídeos, arquivos CSS (Cascading Style Sheets) e arquivos JavaScript. Para obter mais informações sobre a configuração, consulte Módulo ngx_http_headers_module.

• Ativar o cache de recursos estáticos: adequado para services e sites online que carregam muitos arquivos de mídia. Melhora o throughput de tráfego e reduz as operações de leitura de entrada/saída por segundo (IOPS).

• Desativar o cache de recursos estáticos: adequado para depuração remota, upload e download, e outros cenários de uso. Permite o acesso aos arquivos em tempo 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;
    }

Reinicialização a quente de services

• O ConfigMap permite modificar as configurações sem interromper os services.

• O Webshell permite reiniciar os services sem interrupções.

  • Reinicialização a quente do NGINX

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

  • Reinicialização a quente do PHP-FPM (Há uma certa probabilidade de interrupção do fluxo. Verifique a configuração do php.ini.)

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

Upload e download

O SAE oferece vários métodos para upload e download de arquivos. Selecione um dos seguintes métodos de acordo com os requisitos do seu negócio:

• Console do SAE: faça o upload e o download de arquivos para depuração. O tamanho do arquivo não pode exceder 10 MB. Para obter mais informações, consulte {{XREF_13}}.

• Console do SAE: realize a depuração remota.

• Armazenamento persistente: Apsara File Storage NAS ou Object Storage Service (OSS).

  • Ao implantar um aplicativo, monte o NAS ou o OSS e compartilhe diretórios de arquivos.

  • Upload e download no NAS: ferramenta Serverless Devs.

  • Upload e download no OSS: console do OSS.

  • Upload e download no OSS: {{XREF_14}}.