aboutsummaryrefslogtreecommitdiffstats
path: root/roles/php/README.md
blob: b109a58f905f3cddb85fc16f8d929bb7466218a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
PHP
===

Description
-----------

The `php` role installs PHP and configures the PHP-FPM daemon for use with the
Apache webserver.

This role currently limited to a single PHP-FPM pool.

Variables
---------

This role **accepts** the following variables:

Variable                    | Default          | Description
----------------------------|------------------|------------
`php_post_max_size`         | `8M`             | Maximum HTTP POST size
`php_upload_max_filesize`   | `25M`            | Maximum upload filesize
`php_max_file_uploads`      | 20               | Maximum simultaneous uploads
`php_timezone`              | `{{ timezone }}` | PHP timezone
`php_fpm_user`              | `apache`         | Unix user for FPM process
`php_fpm_group`             | `apache`         | Unix group for FPM process
`php_fpm_max_children`      | 50               | Maximum number of concurrent PHP requests
`php_fpm_start_servers`     | 5                | Initial number of FPM threads
`php_fpm_min_spare_servers` | 5                | Minimum number of idle FPM threads
`php_fpm_max_spare_servers` | 35               | Maximum number of idle FPM threads
`php_fpm_flags`             | `{}`             | Dictionary of boolean PHP configuration directives
`php_fpm_admin_flags`       | `{}`             | Dictionary of boolean PHP configuration directives (non-overridable)
`php_fpm_values`            | `{}`             | Dictionary of PHP configuration directives
`php_fpm_admin_values`      | `{}`             | Dictionary of PHP configuration directives (non-overridable)
`php_fpm_environment`       | `{}`             | Dictionary of environment variables for PHP process

Usage
-----

Example playbook:

````yaml
- name: configure php
  hosts: webservers
  roles:
    - role: php
      vars:
        php_fpm_environment:
          GSS_USE_PROXY: 'yes'
        php_fpm_admin_flags:
          output_buffering: no
          always_populate_raw_post_data: no
          mbstring.func_overload: no
````