ansible-role-php/README.md

PHP
===

Diese Rolle installiert PHP und PHP-FPM mit einigen grundlegenden Anpassungen der Konfiguration.
Für PHP-FPM werden systemd-Templates installiert. In Zusammenhang mit eigenen (beschränkten) Linux-Nutzerkonten
lassen sich daraus Services für verschiedene Anwendungen erstellen.

## Verfügbare Variablen

Für die PHP-Konfiguration sind verschiedene defaults gesetzt. Über die jeweilige `host_vars` lassen sich im Dictionary `php`
die defaults überschreiben.

| Varible | Wert |
|--|--|
| date_timezone | string |
| default_charset | string |
| max_execution_time | int |
| memory_limit | string |
| post_max_size | string |
| upload_max_filesize | string |

Beispiel:
```YAML
php:
  memory_limit: 256M
  post_max_size: 30M
```

## Nutzerkonto und PHP-FPM-Service anlegen

Per Ansible Tag kann ein Systemkonto und ein PHP-FPM-Socket und Service angelegt werden. Am Beispiel des playbooks `php.yml`:
```Shell
ansible-playbook playbooks/php.yml --tags never,user -e "php_user=foobar create_home=true"
```

Systemd-Socket und Service sind anschließend als `php-fpm@{{ php_user }}.[socket|service]` verfügbar.

### Varibablen

| Variable | default | Bedeutung |
|--|--|--|
| php_user | |Erforderlich, Nutzername des neuen Systemkontos |
| create_home | false | Optional, Anlegen des Homedirs unter `/home/{{ php_user }}` |