Upgrade notes

The upgrade notes only describe necessary changes that you might need to make to your setup in order to use a new role release. Refer to the Changelog for more details about what has changed.

From debops.php v0.2.0 to debops.php v0.2.1

  • You might want to update all of the playbooks that use debops.php role to include debops.apt_preferences role dependency (see the example playbook). This is not strictly necessary if you don't use the packages.sury.org repository, but it's recommended for consistency and portability.

From debops.php5 role to debops.php role

  • The debops.php5 role stored the PHP-FPM pool configuration in a custom /etc/php5/fpm/pool-available.d/ directory and symlinked the files to the /etc/php5/fpm/pool.d/ directory used by PHP-FPM daemon. In debops.php this mechanism was dropped and files are generated directly in /etc/php5/fpm/pool.d/. Existing files seem to be unaffected by being symlinked to the old directory therefore you don't need to replace the symlinks with real files manually.

  • The debops.php role has new role dependencies on debops.php/env and debops.logrotate. Refer to the provided playbook for an example usage.

  • The different /etc/php5/*/php.ini configuration files managed by debops.php5 role are not managed by debops.php role anymore and might be incomplete. You can replace them with the pristine versions located in: /usr/share/php5/php.ini-* or /usr/lib/php/7.0/php.ini-*.

  • All of the role variables have been renamed from php5_* to php__*. Some variables have been further renamed, for example from php5_default_* to php__fpm_* or various variables to php__ini_*. You should check the variables used in inventory against the new default variables and update accordingly. Some of the more elaborate variable renames:

    Old variable name New variable name Changed value
    php5_cgi_fix_pathinfo php__ini_cgi_fix_pathinfo Yes, to bool
    php5_file_uploads php__ini_file_uploads Yes, to bool
    php5_allow_url_fopen php__ini_allow_url_fopen Yes, to bool
    php5_memory_limit php__ini_memory_limit No
    php5_max_execution_time php__ini_max_execution_time No
    php5_max_input_time php__ini_max_input_time No
    php5_post_max_size php__ini_post_max_size No
    php5_default_charset php__ini_default_charset No
    php5_upload_max_filesize php__ini_upload_max_filesize No
    php5_max_file_uploads php__ini_max_file_uploads No
    php5_socket_listen_owner php__fpm_listen_owner No
    php5_socket_listen_group php__fpm_listen_group No
    php5_socket_listen_mode php__fpm_listen_mode No
  • Some of the parameter names in FPM pools were renamed:

    Old variable name New variable name Changed value
    item.enabled item.state Yes, present/absent
    item.accesslog item.access_log Yes, to bool
    item.php_flag item.php_flags No
    item.php_value item.php_values No
    item.php_admin_flag item.php_admin_flags No
    item.php_admin_value item.php_admin_values No
  • The package installation changed to not force PHP version in the package name. For example, role can now install MariaDB support by specifying mysql package instead of php5-mysql. The list of packages might need to be updated if you plan to use different PHP versions.

  • The PHP7 version uses different directories than the PHP5 version (/etc/php/7.0/ vs /etc/php5/). This allows for parallel installation of PHP5 and PHP7 on the same host, however the role is designed to only manage one version at a time. You are advised to recreate the host if necessary.