https://github.com/geerlingguy/ansible-role-apache-php-fpm

Apache FastCGI support for PHP-FPM
https://github.com/geerlingguy/ansible-role-apache-php-fpm

ansible apache php php-fpm role setup

Last synced: 7 days ago
JSON representation

Apache FastCGI support for PHP-FPM

• Host: GitHub
• URL: https://github.com/geerlingguy/ansible-role-apache-php-fpm
• Owner: geerlingguy
• License: mit
• Created: 2016-01-14T03:34:11.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-25T04:11:37.000Z (9 months ago)
• Last Synced: 2024-10-10T04:06:31.406Z (25 days ago)
• Topics: ansible, apache, php, php-fpm, role, setup
• Homepage: https://galaxy.ansible.com/geerlingguy/apache-php-fpm/
• Size: 43.9 KB
• Stars: 42
• Watchers: 8
• Forks: 31
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible Role: Apache PHP-FPM

[![CI](https://github.com/geerlingguy/ansible-role-apache-php-fpm/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-apache-php-fpm/actions?query=workflow%3ACI)

An Ansible Role that configures Apache for PHP-FPM usage on RHEL/CentOS and Debian/Ubuntu.

## Requirements

This role is dependent upon `geerlingguy.apache`, and also requires you have PHP running with PHP-FPM somewhere on the server or elsewhere (I usually configure PHP with the `geerlingguy.php` role).

When configuring your Apache virtual hosts, you can add the following line to any vhost definition to enable passthrough to PHP-FPM:

    # If using a TCP port:

    ProxyPassMatch ^/(.*\.php(/.*)?)$ "fcgi://127.0.0.1:9000/var/www/example"

    

    # If using a Unix socket:

    ProxyPassMatch ^/(.*\.php(/.*)?)$ "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/example"

For a full usage example with the `geerlingguy.apache` role, see the Example Playbook later in this README.

### RedHat 6 and 7

RedHat/CentOS 7 automatically installs and enables mod_proxy_fcgi by default.

RedHat/CentOS 6 installs Apache 2.2, and is much harder to get configured with FastCGI, but here are two guides in case you need to support this use case:

  - [Apache 2.2 + mod_fastcgi](http://stackoverflow.com/a/21409702/100134)

  - [Apache 2.4 + mod_proxy_fcgi](http://unix.stackexchange.com/a/138903/16194)

## Role Variables

None.

## Dependencies

None.

## Example Playbook

    - hosts: webservers

    

      vars:

        php_enable_php_fpm: true

        apache_vhosts:

          - servername: "www.example.com"

            documentroot: "/var/www/example"

            extra_parameters: |

                  ProxyPassMatch ^/(.*\.php(/.*)?)$ "fcgi://127.0.0.1:9000/var/www/example"

    

      roles:

        - geerlingguy.apache

        - geerlingguy.php

        - geerlingguy.apache-php-fpm

## License

MIT / BSD

## Author Information

This role was created in 2016 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](http://www.ansiblefordevops.com/).