net2grid.php

Rôle Ansible : PHP

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

Exigences

Si vous utilisez une ancienne version LTS d'Ubuntu ou de RHEL, avec une version de PHP obsolète, vous devez utiliser un dépôt ou un PPA contenant 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 de 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), gardez 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 afin 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 du serveur HTTP sont httpd (utilisé par Apache) pour RedHat/CentOS, ou apache2 (également utilisé par Apache) pour Debian/Ubuntu. Si vous utilisez un autre serveur web (par exemple, nginx), changez cette valeur par le nom du démon sous lequel le serveur web s'exécute.

php_enablerepo: ""

(Uniquement pour RedHat/CentOS) Si vous avez activé des dépôts supplémentaires (je vous suggère geerlingguy.repo-epel ou geerlingguy.repo-remi), ces dépôts peuvent être listés sous cette variable (par exemple, remi-php70,epel). Cela peut être utile, par exemple, si vous voulez installer la dernière version de PHP 7.0, qui se trouve dans le dépôt Remi.

php_packages_state: "present"

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

Vous pouvez également utiliser le rôle geerlingguy.php-versions pour changer plus facilement entre les principales versions de PHP (par exemple, 5.6, 7.0, 7.1, 7.2).

php_install_recommends: true

(Uniquement pour Debian/Ubuntu) Indique s'il faut installer les paquets recommandés lors de l'installation de php_packages; vous voudrez peut-être définir cela sur non explicitement si vous installez un PPA qui recommande certains paquets que vous ne voulez pas (par exemple, le PPA php d'Ondrej installera php7.0-cli si vous installez php-pear en même temps que php5.6-cli... ce qui n'est souvent pas souhaité !).

php_executable: "php"

L'exécutable à utiliser lorsqu'on appelle PHP depuis la ligne de commande. Vous ne devriez changer cela que si l'exécution de php sur votre serveur ne cible pas l'exécutable correct, ou si vous utilisez des collections de logiciels 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 grandement faciliter l'évolutivité des applications PHP et est la méthode normale pour exécuter des sites et des applications basés sur PHP lors de l'utilisation d'un serveur web comme Nginx (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'être un processus à l'intérieur d'un serveur web (par exemple, mod_php d'Apache), vous devez définir la variable suivante à true :

php_enable_php_fpm: false

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

php_fpm_listen: "127.0.0.1:9000"
php_fpm_listen_allowed_clients: "127.0.0.1"
php_fpm_pm_max_children: 50
php_fpm_pm_start_servers: 5
php_fpm_pm_min_spare_servers: 5
php_fpm_pm_max_spare_servers: 5

Paramètres spécifiques à l'intérieur de la configuration par défaut du pool PHP-FPM www.conf. Si vous souhaitez gérer d'autres paramètres, vous pouvez le faire soit en remplaçant le fichier par votre propre modèle, soit en utilisant lineinfile comme le fait ce rôle dans tasks/configure-fpm.yml.

Paramètres de php.ini

php_use_managed_ini: true

Par défaut, tous les paramètres supplémentaires 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]" # le défaut varie selon l'OS
php_fpm_pool_group: "[apache|nginx|autre]" # le défaut varie selon l'OS
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: []

Différents paramètres par défaut pour PHP. Utilisés seulement 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 effet que si la version de PHP que vous avez 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 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 indiquer un emplacement personnalisé pour opcache.so, fournissez le chemin complet avec php_opcache_zend_extension.

php_opcache_conf_filename: [spécifique à la plateforme]

Le nom de fichier de configuration opcache spécifique à la plateforme. En général, la valeur par défaut devrait fonctionner, mais dans certains cas, vous pourriez avoir besoin de remplacer le nom de fichier.

Variables liées à APCu

php_enable_apc: true

Indique s'il faut activer APCu. 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 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 de cache en mémoire avec un petit surcoût (la fragmentation ou APC manquant de mémoire ralentira PHP dramatiquement).

php_apc_conf_filename: [spécifique à la plateforme]

Le nom de fichier de configuration APC spécifique à la plateforme. En général, la valeur par défaut devrait fonctionner, mais dans certains cas, vous pourriez avoir besoin de remplacer le nom de fichier.

Assurer que APC est installé

Si vous utilisez APC, vous devrez vous assurer qu'APC est installé (il est installé par défaut, mais si vous personnalisez la liste des 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.

Installation depuis la source

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

Notez que la compilation depuis la source prend beaucoup plus de temps que l'installation depuis des paquets (PHP HEAD prend plus de 5 minutes pour se compiler sur un ordinateur moderne à processeur quadri-cœur, juste pour référence).

php_install_from_source: false

Définissez cela sur true pour installer PHP depuis la source au lieu d'installer depuis des paquets.

php_source_version: "master"

La version de PHP à installer depuis 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, ainsi que 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 compilé. 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. L'utilisation d'un scalaire replié (>) 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) au dossier de configuration des modules Apache avec un contenu 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 devrez é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 que 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
  ...