# PHP Ansible Role

This Ansible role installs and configures PHP with support for multiple versions, custom modules, and PHP-FPM pool configurations.

## Features

- Install multiple PHP versions simultaneously (e.g., PHP 8.3 and 8.4)
- Install single PHP version (just provide one version in the list)
- Configure different module lists for each PHP version
- Create and manage PHP-FPM pools with custom configurations
- Support for multiple pools across different PHP versions
- Automatic log directory creation with proper ownership
- Support for PHP-FPM
- Automatic repository setup (Sury repository for latest PHP versions)

## Requirements

- Ubuntu/Debian-based systems
- Ansible 2.9+
- sudo/root privileges

## Role Variables

### PHP Installation Configuration

```yaml
php_versions:
  - version: "8.3"
    modules:
      - mysql
      - gd
      - xml
      - mbstring
      - zip
  - version: "8.4"
    modules:
      - mysql
      - gd
      - xml
      - mbstring
      - zip
      - redis
```

### PHP-FPM Pool Configuration

```yaml
php_pools:
  - name: "www"
    user: "www-data"
    group: "www-data"
    php_versions:
      - version: "8.3"
      - version: "8.4"
    # Pool management settings
    pm: "dynamic"
    pm_start_servers: 5
    pm_min_spare_servers: 3
    pm_max_spare_servers: 8
    pm_max_children: 100
    pm_max_requests: 200
    # Timeouts and limits
    request_slowlog_timeout: "30s"
    request_terminate_timeout: "60s"
    rlimit_files: 65536
    catch_workers_output: "yes"
    # PHP settings
    admin_flag_display_errors: "Off"
    admin_flag_log_errors: "On"
    admin_value_error_reporting: "E_ALL & ~E_NOTICE"
    admin_value_memory_limit: "64M"
    admin_value_upload_max_filesize: "16M"
    admin_value_post_max_size: "16M"

# Remove default www pool
php_remove_default_pool: false
```

## Example Playbooks

### Multi-Version Setup with Custom Pools

```yaml
---
- hosts: webservers
  become: yes
  vars:
    php_versions:
      - version: "8.3"
        modules:
          - mysql
          - gd
          - xml
          - mbstring
          - zip
      - version: "8.4"
        modules:
          - mysql
          - gd
          - xml
          - mbstring
          - zip
          - redis
    
    php_pools:
      - name: "app1"
        user: "app1"
        group: "app1"
        php_versions:
          - version: "8.3"
        pm: "static"
        pm_max_children: 50
        admin_value_memory_limit: "128M"
      
      - name: "app2"
        user: "app2"
        group: "app2"
        php_versions:
          - version: "8.4"
        pm: "dynamic"
        pm_max_children: 100
        admin_value_memory_limit: "256M"
    
    php_remove_default_pool: true
  roles:
    - php
```

### Single Version with Simple Pool

```yaml
---
- hosts: webservers
  become: yes
  vars:
    php_versions:
      - version: "8.4"
        modules:
          - mysql
          - gd
    
    php_pools:
      - name: "website"
        user: "www-data"
        group: "www-data"
        php_versions:
          - version: "8.4"
  roles:
    - php
```

## Pool Configuration Details

Each pool configuration creates:

- **Socket file**: `/run/php/php{version}-fpm-{pool_name}.sock`
- **Log directories**: `/var/log/php/{pool_name}/{version}/`
- **Error log**: `/var/log/php/{pool_name}/{version}/php-errors.log`
- **Slow log**: `/var/log/php/{pool_name}/{version}/php-slow.log`

The pool configuration supports all standard PHP-FPM pool directives with sensible defaults.

## Installed Packages

For each PHP version, the following base packages are automatically installed:

- `php{version}-common`
- `php{version}-cli`

Additional modules are installed based on the `modules` list for each version.

## Services

The role will manage PHP-FPM services for each installed version:
- `php8.3-fpm`
- `php8.4-fpm`
- etc.

## Notes

- The role uses the Sury repository to provide the latest PHP versions
- Each PHP version runs its own FPM service
- Module names are simplified (e.g., `mysql` instead of `php8.3-mysql`)
- Log directories are automatically created with proper ownership
- Pool sockets are created with specific naming: `php{version}-fpm-{pool_name}.sock`
- You can create multiple pools for the same PHP version with different configurations

## License

MIT