apham0001.php

Rôle Ansible : PHP

Installe PHP sur les serveurs RedHat/CentOS et Debian/Ubuntu.

Exigences

Si vous utilisez une ancienne version LTS d'Ubuntu ou RHEL, avec une version de PHP obsolète, vous devez utiliser un dépôt ou un PPA avec une version de PHP maintenue, car ce rôle ne fonctionne qu'avec les versions de PHP actuellement prises en charge par la communauté PHP.

Variables du rôle

Les variables disponibles sont listées ci-dessous, avec leurs valeurs par défaut (voir defaults/main.yml):

php_packages: []

Une liste des paquets PHP à installer (spécifique au système d'exploitation par défaut). Vous voudrez probablement installer des paquets courants comme php, php-cli, php-devel et php-pdo, et vous pouvez ajouter d'autres paquets que vous souhaitez (par exemple, php-gd pour la manipulation d'images, ou php-ldap si vous devez vous connecter à un serveur LDAP pour l'authentification).

Remarque : Si vous utilisez Debian/Ubuntu, vous devez également installer libapache2-mod-fastcgi (pour cgi/PHP-FPM) ou libapache2-mod-php7.0 (ou un paquet similaire selon la version de PHP) si vous souhaitez utiliser mod_php avec Apache.

php_packages_extra: []

Une liste de paquets PHP supplémentaires à installer sans remplacer la liste par défaut.

php_enable_webserver: true

Si votre utilisation de PHP est liée à un serveur Web (par exemple, Apache ou Nginx), laissez cette valeur par défaut. Si vous utilisez PHP côté serveur ou pour exécuter une petite application, définissez cette valeur sur false pour que ce rôle n'essaie pas d'interagir avec un serveur Web.

php_webserver_daemon: "httpd"

Les valeurs par défaut pour le démon HTTP sont httpd (utilisé par Apache) pour RedHat/CentOS, ou apache2 (également utilisé par Apache) pour Debian/Ubuntu. Si vous exécutez un autre serveur Web (par exemple, nginx), modifiez cette valeur en fonction du nom du démon sous lequel le serveur Web fonctionne.

php_enablerepo: ""

(RedHat/CentOS uniquement) Si vous avez activé des dépôts supplémentaires (peut-être geerlingguy.repo-epel ou geerlingguy.repo-remi), vous pouvez les lister sous cette variable (par exemple, remi-php70,epel). Cela peut être pratique, par exemple, si vous souhaitez installer la dernière version de PHP 7.0, qui se trouve dans le dépôt Remi.

php_default_version_debian: "7.0"

(Debian/Ubuntu uniquement) La version par défaut de PHP dans les dépôts de la version donnée du système d'exploitation. Par défaut, cela correspond à la dernière version LTS d'Ubuntu. Ubuntu 18.04 doit être défini sur "7.2" car PHP 7.0 n'est pas disponible dans les paquets bionic par défaut.

Si vous souhaitez pouvoir changer facilement de versions PHP, ou utiliser une version qui n'est pas disponible dans les paquets système : Vous pouvez utiliser le rôle geerlingguy.php-versions pour passer plus facilement d'une version majeure de PHP à une autre (par exemple 5.6, 7.1, 7.2).

php_packages_state: "present"

Si vous avez activé des dépôts supplémentaires tels que geerlingguy.repo-epel ou geerlingguy.repo-remi, vous souhaiterez peut-être un moyen simple de changer de version PHP à la volée. Par défaut, cela est défini sur "present". Vous pouvez remplacer cette variable par "latest" pour mettre à jour vers la dernière version disponible. Combiné avec php_enablerepo, un utilisateur n'a plus besoin de désinstaller manuellement les paquets PHP existants avant de les installer depuis un autre dépôt.

php_install_recommends: true

(Debian/Ubuntu uniquement) Si vous devez installer des paquets recommandés lors de l'installation de php_packages; vous voudrez peut-être définir cela sur no explicitement si vous installez un PPA qui recommande certains paquets que vous ne souhaitez pas (par exemple, le PPA d'Ondrej php installera php7.0-cli si vous installez php-pear avec php5.6-cli, ce qui est souvent pas désiré!).

php_executable: "php"

L'exécutable à exécuter lors de l'appel de PHP depuis la ligne de commande. Vous ne devez le modifier que si l'exécution de php sur votre serveur ne cible pas le bon exécutable, ou si vous utilisez des collections logicielles sur RHEL/CentOS et devez cibler une autre version de PHP.

PHP-FPM

PHP-FPM est un gestionnaire de processus FastCGI simple et robuste pour PHP. Il peut considérablement faciliter la montée en charge des applications PHP et est la manière normale d'exécuter des sites et applications basés sur PHP lorsqu'un serveur Web comme Nginx est utilisé (bien qu'il puisse également être utilisé avec d'autres serveurs Web tout aussi facilement).

Lorsque vous utilisez ce rôle avec PHP exécuté en tant que php-fpm au lieu d'un processus à l'intérieur d'un serveur Web (par exemple, mod_php d'Apache), vous devez définir la variable suivante sur true :

php_enable_php_fpm: false

Si vous utilisez Apache, vous pouvez facilement le configurer pour fonctionner avec PHP-FPM en utilisant le rôle geerlingguy.apache-php-fpm.

php_fpm_pools:
  - php_fpm_pool: www
    php_fpm_user: www
    php_fpm_group: www
    php_fpm_listen: /run/php/php7.3-fpm.sock
    php_fpm_pm_max_children: 5
    php_fpm_pm_start_servers: 2
    php_fpm_pm_min_spare_servers: 1
    php_fpm_pm_max_spare_servers: 3
    php_fpm_pm_process_idle_timeout: 10s
    php_fpm_pm_max_requests: 0
    php_fpm_request_slowlog_timeout: 0
    php_fpm_request_terminate_timeout: 0
    php_fpm_rlimits_files: 1024
    php_fpm_admin_value_sendmail_path: [email protected]
    extra_parameters: |
      php_admin_value[memory_limit] = 128M

Paramètres php.ini

php_use_managed_ini: true

Par défaut, tous les paramètres par défaut ci-dessous sont appliqués via le php.ini inclus avec ce rôle. Vous pouvez gérer vous-même votre fichier php.ini (si vous avez besoin de plus de flexibilité dans sa configuration) en définissant cela sur false (dans ce cas, toutes les variables ci-dessous seront ignorées).

php_fpm_pool_user: "[apache|nginx|autre]" # par défaut varie selon le système d'exploitation
php_fpm_pool_group: "[apache|nginx|autre]" # par défaut varie selon le système d'exploitation
php_memory_limit: "256M"
php_max_execution_time: "60"
php_max_input_time: "60"
php_max_input_vars: "1000"
php_realpath_cache_size: "32K"
php_file_uploads: "On"
php_upload_max_filesize: "64M"
php_max_file_uploads: "20"
php_post_max_size: "32M"
php_date_timezone: "America/Chicago"
php_allow_url_fopen: "On"
php_sendmail_path: "/usr/sbin/sendmail -t -i"
php_output_buffering: "4096"
php_short_open_tag: false
php_error_reporting: "E_ALL & ~E_DEPRECATED & ~E_STRICT"
php_display_errors: "Off"
php_display_startup_errors: "On"
php_expose_php: "On"
php_session_cookie_lifetime: 0
php_session_gc_probability: 1
php_session_gc_divisor: 1000
php_session_gc_maxlifetime: 1440
php_session_save_handler: files
php_session_save_path: ''
php_disable_functions: []

Divers paramètres par défaut pour PHP. Utilisés uniquement si php_use_managed_ini est défini sur true.

Variables liées à OpCache

L'OpCache est inclus dans PHP à partir de la version 5.5, et les variables suivantes n'auront d'effet que si la version de PHP installée est 5.5 ou supérieure.

php_opcache_zend_extension: "opcache.so"
php_opcache_enable: "1"
php_opcache_enable_cli: "0"
php_opcache_memory_consumption: "96"
php_opcache_interned_strings_buffer: "16"
php_opcache_max_accelerated_files: "4096"
php_opcache_max_wasted_percentage: "5"
php_opcache_validate_timestamps: "1"
php_opcache_revalidate_path: "0"
php_opcache_revalidate_freq: "2"
php_opcache_max_file_size: "0"

Directives ini d'OpCache qui sont souvent personnalisées sur un système. Assurez-vous d'avoir suffisamment de mémoire et d'emplacements de fichiers alloués dans l'OpCache (php_opcache_memory_consumption, en Mo, et php_opcache_max_accelerated_files) pour contenir tout le code PHP que vous exécutez. Sinon, vous risquez d'obtenir des performances sous-optimales !

Pour fournir l'emplacement personnalisé de opcache.so, donnez le chemin complet avec php_opcache_zend_extension.

php_opcache_conf_filename: [spécifique à la plateforme]

Le nom du fichier de configuration opcache spécifique à la plateforme. En général, le défaut devrait fonctionner, mais dans certains cas, vous devrez peut-être remplacer le nom du fichier.

Variables liées à APCu

php_enable_apc: true

Si APCu doit être activé. D'autres variables APCu seront inefficaces si cela est défini sur faux.

php_apc_shm_size: "96M"
php_apc_enable_cli: "0"

Directives ini d'APCu qui sont souvent personnalisées sur un système. Définissez php_apc_shm_size afin qu'il puisse contenir toutes les entrées du cache en mémoire avec un peu de surcharge (la fragmentation ou l'épuisement de mémoire d'APC ralentiront PHP drastiquement).

php_apc_conf_filename: [spécifique à la plateforme]

Le nom du fichier de configuration APC spécifique à la plateforme. En général, le défaut devrait fonctionner, mais dans certains cas, vous devrez peut-être remplacer le nom du fichier.

Assurer l'installation de l'APC

Si vous utilisez APC, vous devez vous assurer qu'APC est installé (il est installé par défaut, mais si vous personnalisez la liste php_packages, vous devez inclure APC dans la liste) :

Sur les systèmes RHEL/CentOS : Assurez-vous que php-pecl-apcu est dans la liste des php_packages.
Sur les systèmes Debian/Ubuntu : Assurez-vous que php-apcu est dans la liste des php_packages.

Installer à partir du source

Si vous avez besoin d'une version spécifique de PHP, ou souhaitez tester la dernière version (par exemple, master) de PHP, il y a de fortes chances qu'il n'existe pas de paquet approprié déjà disponible dans le gestionnaire de paquets de votre plateforme. Dans ces cas, vous pouvez choisir d'installer PHP à partir de la source en le compilant directement.

Notez que la compilation à partir de la source prend beaucoup plus de temps que l'installation à partir de paquets (PHP HEAD prend plus de 5 minutes à compiler sur un ordinateur moderne à quatre cœurs, juste à titre de référence).

php_install_from_source: false

Définissez ceci sur true pour installer PHP à partir de la source au lieu d'installer à partir de paquets.

php_source_version: "master"

La version de PHP à installer à partir de la source (une branche git, un tag ou un hash de commit).

php_source_clone_dir: "~/php-src"
php_source_clone_depth: 1
php_source_install_path: "/opt/php"
php_source_install_gmp_path: "/usr/include/x86_64-linux-gnu/gmp.h"

Emplacement où la source sera clonée et installée, et l'emplacement du fichier d'en-tête GMP (qui peut être spécifique à la plateforme/distribution).

php_source_make_command: "make"

Définissez la commande make sur make --jobs=X où X est le nombre de cœurs présents sur le serveur où PHP est en cours de compilation. Cela accélérera considérablement les temps de compilation si vous avez plusieurs cœurs.

php_source_configure_command: >
  [...]

La commande ./configure qui construira le Makefile à utiliser pour la compilation de PHP. Ajoutez toutes les options dont vous avez besoin pour votre environnement particulier. Utiliser un scalaire plié (>) vous permet de définir la variable sur plusieurs lignes, ce qui est extrêmement utile pour la lisibilité et le contrôle de version !

Quelques autres notes/caveats pour des configurations spécifiques :

Apache avec mpm_prefork : Si vous utilisez Apache avec prefork comme serveur Web pour PHP, vous devez vous assurer que apxs2 est disponible sur votre système (par exemple, en installant apache2-prefork-dev sous Ubuntu), et vous devez vous assurer que l'option --with-apxs2 est définie dans php_source_configure_command. Enfin, vous devrez vous assurer que le module mpm_prefork est chargé au lieu de mpm_worker ou mpm_event, et probablement ajouter un fichier de configuration phpX.conf (où X est la version majeure de PHP) dans le dossier de configuration des modules d'Apache avec des contenus comme php7.conf.
Apache avec mpm_event ou mpm_worker : Si vous utilisez Apache avec event ou worker comme serveur Web pour PHP, vous devrez compiler PHP avec FPM. Assurez-vous que l'option --enable-fpm est définie dans php_source_configure_command. Vous devez également vous assurer que le support d'Apache pour CGI et event est installé (par exemple, en installant apache2-mpm-event et libapache2-mod-fastcgi) et le module mpm_event est chargé.
Nginx : Si vous utilisez Nginx comme serveur Web pour PHP, vous devrez compiler PHP avec FPM. Assurez-vous que l'option --enable-fpm est définie dans php_source_configure_command.

Dépendances

Aucune.

Exemple de Playbook

- hosts: webservers
  vars_files:
    - vars/main.yml
  roles:
    - { role: geerlingguy.php }

Dans vars/main.yml :

php_memory_limit: "128M"
php_max_execution_time: "90"
php_upload_max_filesize: "256M"
php_packages:
  - php
  - php-cli
  - php-common
  - php-devel
  - php-gd
  - php-mbstring
  - php-pdo
  - php-pecl-apcu
  - php-xml
  ...