Mirror HanXHX/ansible-php dari GitHub.
 
 
 
Go to file
Emilien Mantel f54176c880 👷 Add Github Action 2023-05-30 12:44:15 +02:00
.github/workflows 👷 Add Github Action 2023-05-30 12:44:15 +02:00
.scripts Support Xdebug extension 2015-07-27 18:09:52 +02:00
defaults Option: autoremove default pool 2019-12-26 16:42:16 +01:00
filter_plugins Remove useless files 2019-12-26 15:38:54 +01:00
handlers 🚨 Fix crashes on latest ansible versions and fixes lint 2023-05-30 10:56:48 +02:00
meta 🚀 Manage Debian 12 2023-05-30 12:33:43 +02:00
molecule Add Ansible molecule 2023-05-30 12:43:45 +02:00
tasks 🚨 Fix crashes on latest ansible versions and fixes lint 2023-05-30 10:56:48 +02:00
templates/etc/__php__ Add env vars on PHP-FPM pool template (#17) 2022-10-06 16:36:02 +02:00
tests Add Ansible molecule 2023-05-30 12:43:45 +02:00
vars 🚀 Manage Debian 12 2023-05-30 12:33:43 +02:00
.ansible-lint New release (#14) 2021-09-01 09:57:23 +02:00
.gitignore 🙈 Ignore pycharm files 2023-05-30 10:50:00 +02:00
.travis.yml Modernize 2022-10-06 14:47:06 +02:00
.yamllint.yml New release (#14) 2021-09-01 09:57:23 +02:00
LICENSE Initial commit 2015-07-23 10:41:27 +02:00
README.md Modernize 2022-10-06 14:47:06 +02:00
Vagrantfile Modernize 2022-10-06 14:47:06 +02:00
requirements.yml Add Ansible molecule 2023-05-30 12:43:45 +02:00

README.md

Ansible PHP (+FPM) role for Debian / Ubuntu / FreeBSD

Ansible Galaxy Build Status

Install PHP on Debian / Ubuntu / FreeBSD. Manage PHP-FPM, APCu, Opcache and Xdebug.

Managed OS / Versions

On all Debian versions, you can install all PHP versions by using Sury's APT repository.

Other cases:

OS PHP 7.0 PHP 7.1 PHP 7.2 PHP 7.3 PHP >= 7.4
Ubuntu Bionic (18.04) ✔️
FreeBSD 11 ✔️ ✔️ ✔️ ✔️ Need tests...
FreeBSD 12 ✔️ ✔️ ✔️ ✔️ Need tests...

Links:

Requirements

  • Ansible >= 2.11
  • Collections: community.general
  • If you need PHP-FPM, you must install a webserver with FastCGI support. You can use my nginx role.

FreeBSD limitations

  • It doesn't split ini file for FPM/CLI. It's hardcoded as /usr/local/etc/php.ini.
  • It can't manage multiple PHP versions at the time (like legacy Debian versions)
  • You must explicitely set xdebug package name (use pkg search xdebug to find the good one)

Role Variables

You should look at default vars.

Writable vars

  • php_version: 7.3, 7.4... depending OS (see above)
  • php_install_fpm: boolean, install and manage php-fpm (default is true)
  • php_install_xdebug: boolean, install Xdebug
  • 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

  • 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

  • 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

  • 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 Bullseye with PHP 8.0 CLI (no FPM)

- hosts: servers
  roles:
     - { role: HanXHX.sury }
     - { role: hanxhx.php, php_version: '8.0', php_install_fpm: false }

License

GPLv2

Donation

If this code helped you, or if youve used them for your projects, feel free to buy me some 🍻

  • Bitcoin: 1BQwhBeszzWbUTyK4aUyq3SRg7rBSHcEQn
  • Ethereum: 0x63abe6b2648fd892816d87a31e3d9d4365a737b5
  • Litecoin: LeNDw34zQLX84VvhCGADNvHMEgb5QyFXyD
  • Monero: 45wbf7VdQAZS5EWUrPhen7Wo4hy7Pa7c7ZBdaWQSRowtd3CZ5vpVw5nTPphTuqVQrnYZC72FXDYyfP31uJmfSQ6qRXFy3bQ

No crypto-currency? the project is also a way of saying thank you! 😎

Author Information