162 lines
4.5 KiB
Markdown
162 lines
4.5 KiB
Markdown
Ansible PHP (+FPM) role for Debian
|
|
==================================
|
|
|
|
[](https://galaxy.ansible.com/list#/roles/4472) [](https://travis-ci.org/HanXHX/ansible-php)
|
|
|
|
Install PHP (php-fpm optional) on Debian Jessie/Stretch. Manage APCu, Opcache, Xdebug.
|
|
|
|
Managed versions: 5.6 and 7.0
|
|
|
|
Requirements
|
|
------------
|
|
|
|
If you need PHP-FPM, you must install a webserver with FastCGI support. You can use my [nginx role](https://github.com/HanXHX/ansible-nginx).
|
|
On Debian Jessie, if you want PHP7.0, you must use [Dotdeb](https://www.dotdeb.org). You can use my [dotdeb role](https://github.com/HanXHX/ansible-debian-dotdeb).
|
|
|
|
Role Variables
|
|
--------------
|
|
|
|
You should look at [default vars](defaults/main.yml).
|
|
|
|
### Writable vars
|
|
|
|
- `php_version`: 5.6 (default) or 7.0
|
|
- `php_install_fpm`: boolean, install and manage php-fpm (default is true)
|
|
- `php_install_xdebug`: boolean, install [Xdebug](http://xdebug.org)
|
|
- `php_extra_packages`: additional php packages to install (default is an empty list).
|
|
|
|
#### php.ini
|
|
|
|
- `php_ini`: global configuration shared beween FPM/CLI
|
|
- `php_ini_fpm`: manage FPM php.ini (php-fpm)
|
|
- `php_ini_cli`: manage CLI php.ini (php-fpm)
|
|
|
|
Note:
|
|
|
|
- If you want exactly same configuration for CLI/FPM. You can put all your data in `php_ini`.
|
|
- Put specific configuration in `php_ini_fpm`/`php_ini_cli`.
|
|
- You can override with `php_ini_fpm`/`php_ini_cli`, but it breaks idempotence.
|
|
|
|
|
|
#### OpCache settings
|
|
|
|
See [Opcache doc](https://secure.php.net/manual/en/opcache.configuration.php)
|
|
|
|
- `php_opcache_enable`
|
|
- `php_opcache_enable_cli`
|
|
- `php_opcache_memory_consumption`
|
|
- `php_opcache_interned_strings_buffer`
|
|
- `php_opcache_max_accelerated_files`
|
|
- `php_opcache_max_wasted_percentage`
|
|
- `php_opcache_validate_timestamps`
|
|
- `php_opcache_revalidate_freq`
|
|
- `php_opcache_max_file_size`
|
|
|
|
|
|
#### APC/APCu settings
|
|
|
|
See [apc doc](https://secure.php.net/manual/en/apc.configuration.php)
|
|
|
|
- `php_apc_enable`
|
|
- `php_apc_enable_cli`
|
|
- `php_apc_shm_size`
|
|
- `php_apc_num_files_hint`
|
|
- `php_apc_user_entries_hint`
|
|
- `php_apc_user_ttl`
|
|
- `php_apc_ttl`
|
|
- `php_apc_file_update_protection`
|
|
- `php_apc_slam_defense`
|
|
- `php_apc_stat_ctime`
|
|
|
|
# Xdebug settings
|
|
|
|
See [Xdebug doc](http://xdebug.org/docs/all_settings)
|
|
|
|
- `php_xdebug_auto_trace`
|
|
- `php_xdebug_cli_color`
|
|
- `php_xdebug_collect_assignments`
|
|
- `php_xdebug_collect_includes`
|
|
- `php_xdebug_collect_params`
|
|
- `php_xdebug_collect_return`
|
|
- `php_xdebug_collect_vars`
|
|
- `php_xdebug_coverage_enable`
|
|
- `php_xdebug_default_enable`
|
|
- `php_xdebug_dump_globals`
|
|
- `php_xdebug_dump_once`
|
|
- `php_xdebug_dump_undefined`
|
|
- `php_xdebug_extended_info`
|
|
- `php_xdebug_file_link_format`
|
|
- `php_xdebug_force_display_errors`
|
|
- `php_xdebug_force_error_reporting`
|
|
- `php_xdebug_halt_level`
|
|
- `php_xdebug_idekey`
|
|
- `php_xdebug_manual_url`
|
|
- `php_xdebug_max_nesting_level`
|
|
- `php_xdebug_overload_var_dump`
|
|
- `php_xdebug_profiler_append`
|
|
- `php_xdebug_profiler_enable`
|
|
- `php_xdebug_profiler_enable_trigger`
|
|
- `php_xdebug_profiler_enable_trigger_value`
|
|
- `php_xdebug_profiler_output_dir`
|
|
- `php_xdebug_profiler_output_name`
|
|
- `php_xdebug_remote_autostart`
|
|
- `php_xdebug_remote_connect_back`
|
|
- `php_xdebug_remote_cookie_expire_time`
|
|
- `php_xdebug_remote_enable`
|
|
- `php_xdebug_remote_handler`
|
|
- `php_xdebug_remote_host`
|
|
- `php_xdebug_remote_log`
|
|
- `php_xdebug_remote_mode`
|
|
- `php_xdebug_remote_port`
|
|
- `php_xdebug_scream`
|
|
- `php_xdebug_show_exception_trace`
|
|
- `php_xdebug_show_local_vars`
|
|
- `php_xdebug_show_mem_delta`
|
|
- `php_xdebug_trace_enable_trigger`
|
|
- `php_xdebug_trace_enable_trigger_value`
|
|
- `php_xdebug_trace_format`
|
|
- `php_xdebug_trace_options`
|
|
- `php_xdebug_trace_output_dir`
|
|
- `php_xdebug_trace_output_name`
|
|
- `php_xdebug_var_display_max_children`
|
|
- `php_xdebug_var_display_max_data`
|
|
- `php_xdebug_var_display_max_depth`
|
|
|
|
### Read only vars
|
|
|
|
- `php_packages`: minimal package list to install
|
|
- `php_extension_dir.stdout`: get php extension dir (from task)
|
|
- `php_version.stdout`: get php version (from task)
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
None.
|
|
|
|
Example Playbook
|
|
----------------
|
|
|
|
### Simple Playbook
|
|
|
|
- hosts: servers
|
|
roles:
|
|
- { role: HanXHX.php }
|
|
|
|
### Debian Jessie with PHP 7.0 CLI (no FPM)
|
|
|
|
- hosts: jessie-servers
|
|
roles:
|
|
- { role: HanXHX.dotdeb }
|
|
- { role: HanXHX.php, php_version: '7.0', php_install_fpm: false }
|
|
|
|
License
|
|
-------
|
|
|
|
GPLv2
|
|
|
|
Author Information
|
|
------------------
|
|
|
|
- Twitter: [@hanxhx_](https://twitter.com/hanxhx_)
|
|
- All issues, pull-requests are welcome :)
|