aboutsummaryrefslogtreecommitdiffstats
path: root/roles/php/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'roles/php/README.md')
-rw-r--r--roles/php/README.md52
1 files changed, 52 insertions, 0 deletions
diff --git a/roles/php/README.md b/roles/php/README.md
new file mode 100644
index 0000000..b109a58
--- /dev/null
+++ b/roles/php/README.md
@@ -0,0 +1,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
+````