Serverless App Engine:Déployer une application à l'aide d'un package de code

Applications en ligne : NGINX avec PHP-FPM

Surveillance des applications : ARMS

Pour les applications SAE utilisant des versions PHP comprises entre 5,4 et 7,3, activez la surveillance applicative afin d'obtenir des informations détaillées, telles que le traçage de la chaîne d'appels et la latence d'accès aux ressources pour ApsaraDB RDS MySQL et Tair (compatible Redis OSS).Pour plus d'informations, consultez Présentation de la surveillance des applications ARMS.

Versions logicielles

Le tableau suivant détaille les environnements d'exécution PHP disponibles. Si vous avez besoin d'une version supérieure de PHP, rejoignez le groupe DingTalk (numéro de groupe : 32874633) pour consulter les experts techniques du produit.

Répertoires système

L'environnement PHP de SAE utilise par défaut les répertoires suivants pour le déploiement des packages d'application :

Le tableau suivant décrit les configurations par défaut de PHP-FPM :

Le tableau suivant présente les configurations par défaut de NGINX :

Extensions intégrées

Permissions associées

Par défaut, PHP-FPM et NGINX utilisent l'utilisateur www-data pour exécuter les applications. Le tableau suivant détaille les 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

Extensions par défaut et PECL

Lors du déploiement d'une application, configurez le fichier php.ini pour spécifier les extensions intégrées, y compris les extensions PHP par défaut et les extensions PECL.

php -m

Exemples d'extensions intégrées prises en charge par les différents environnements d'exécution :

[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

Installer des extensions via la console et l'API

Activez les extensions PHP par défaut ou installez des versions spécifiques d'extensions PECL via la console SAE ou l'API. Pour plus d'informations, consultez Déployer une application PHP.

Installer des extensions tierces

Cette section explique comment installer une extension tierce en compilant le fichier YAML contenant le code source dans PHP-FPM 7.3.

1. Créez une application SAE avec PHP 7.3 comme environnement d'exécution.

2. Activez l'accès Internet.

3. Connectez-vous à l'instance via le webshell, puis exécutez les commandes suivantes pour compiler et installer l'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. Téléchargez l'extension sur votre machine locale. Pour plus d'informations, consultez Charger et télécharger des fichiers pour diagnostiquer les applications via les journaux.

   Répertoire de l'extension :

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

5. Incluez l'extension dans le package ZIP de l'application. Structure du package ZIP :

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

6. Déployez l'application, chargez le package ZIP contenant l'extension, puis ajoutez la configuration de l'extension au fichier php.ini pour l'activer.

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

7. Connectez-vous à l'instance via le webshell et vérifiez si l'extension est chargée.

   # php -m | grep yaml
   yaml

Ports de service par défaut

Le tableau suivant indique les ports de service par défaut de NGINX et PHP-FPM configurés par SAE :

Journaux PHP-FPM : sortie standard

• Les journaux PHP-FPM sont inclus dans les journaux en temps réel. L'exemple de code suivant illustre la configuration des journaux dans le fichier /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

• Les journaux d'erreurs PHP non affichés. L'exemple de code suivant montre la configuration des journaux dans le fichier php.ini.

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

• Pour inclure les journaux d'erreurs dans les journaux en temps réel, configurez le fichier php.ini lors de la création ou du déploiement de l'application. Spécifiez le répertoire suivant pour stocker les journaux d'erreurs :

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

Journaux NGINX : sortie standard

• Les journaux NGINX sont inclus dans les journaux en temps réel. L'exemple de code suivant présente la configuration des journaux dans le fichier ./nginx/default.conf :

  #access_log /dev/stdout;
  error_log stderr;

• Activez access_log. Par défaut, les journaux sont inclus dans les journaux en temps réel.

Mise en cache de fichiers : fichiers statiques, images et médias

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

Mise en cache de fichiers : code PHP

Activez ou désactivez la mise en cache dans NGINX pour divers fichiers statiques, tels que les images, vidéos, fichiers CSS (Cascading Style Sheets) et fichiers JavaScript. Pour plus d'informations sur la configuration, consultez Module ngx_http_headers_module.

• Activer la mise en cache des ressources statiques : recommandée pour les services en ligne et les sites web chargeant de nombreux fichiers multimédias. Cela améliore le débit du trafic et réduit les opérations d'entrée/sortie de lecture par seconde (IOPS).

• Désactiver la mise en cache des ressources statiques : utile pour le débogage à distance, les chargements et téléchargements, ainsi que d'autres cas d'usage. Permet d'accéder aux fichiers en temps réel.

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

Redémarrage à chaud des services

• ConfigMap permet de modifier les configurations sans interrompre les services.

• Webshell permet de redémarrer les services sans interruption.

  • Redémarrage à chaud de NGINX

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

  • Redémarrage à chaud de PHP-FPM (risque d'interruption de flux ; il est nécessaire de vérifier la configuration php.ini.)

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

Chargement et téléchargement

SAE offre plusieurs méthodes pour charger et télécharger des fichiers. Choisissez celle qui correspond le mieux à vos besoins métier :

• Via la console SAE : chargez et téléchargez des fichiers pour le débogage. La taille maximale du fichier est de 10 Mo. Pour plus d'informations, consultez Charger et télécharger des fichiers via le webshell.

• Via la console SAE : effectuez un débogage à distance.

• Via le stockage persistant : Apsara File Storage NAS ou Object Storage Service (OSS).

  • Lors du déploiement d'une application, montez NAS ou OSS et partagez des répertoires de fichiers.

  • Chargement et téléchargement NAS : Outil Serverless Devs.

  • Chargement et téléchargement OSS : Console OSS.

  • Chargement et téléchargement OSS : Outil ossutil.