https://github.com/bodgit/puppet-php
Puppet Module for managing PHP
https://github.com/bodgit/puppet-php
php php-fpm puppet
Last synced: about 1 month ago
JSON representation
Puppet Module for managing PHP
- Host: GitHub
- URL: https://github.com/bodgit/puppet-php
- Owner: bodgit
- License: apache-2.0
- Created: 2018-08-22T07:28:21.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-08-24T16:28:41.000Z (over 6 years ago)
- Last Synced: 2025-03-24T22:51:21.400Z (about 2 months ago)
- Topics: php, php-fpm, puppet
- Language: Ruby
- Homepage: https://forge.puppet.com/bodgit/php
- Size: 93.8 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# php
Tested with Travis CI
[](https://travis-ci.com/bodgit/puppet-php)
[](https://coveralls.io/github/bodgit/puppet-php?branch=master)
[](https://forge.puppetlabs.com/bodgit/php)
#### Table of Contents
1. [Description](#description)
2. [Setup - The basics of getting started with php](#setup)
* [Setup requirements](#setup-requirements)
* [Beginning with php](#beginning-with-php)
3. [Usage - Configuration options and additional functionality](#usage)
4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
5. [Limitations - OS compatibility, etc.](#limitations)
6. [Development - Guide for contributing to the module](#development)
## Description
This module manages PHP and the FastCGI Process Manager.
CentOS, RHEL, Scientific and Oracle Enterprise Linux is supported using Puppet
4.9.0 or later.
## Setup
### Setup Requirements
On RHEL/CentOS platforms you may need to have access to the EPEL repository
for some of the additional PHP extensions by using
[stahnma/epel](https://forge.puppet.com/stahnma/epel) or by other means.
If you wish to use a version of PHP shipped in a Software Collection then you
will need access to the SCL repository using
[bodgit/scl](https://forge.puppet.com/bodgit/scl) or similar.
### Beginning with php
In the very simplest case, you can just include the following which mimics the
default installation and extensions:
```puppet
include ::php
```
## Usage
Additional extensions are available, so if you need MySQL support:
```puppet
include ::php
include ::php::extension::mysql
```
The FastCGI Process Manager can be installed and multiple pools can be
configured:
```puppet
include ::php
include ::php::fpm
::php::fpm::pool { 'www':
listen => '/var/run/php-fpm/www.sock',
pm => 'static',
pm_max_children => 10,
user => 'apache',
}
```
## Reference
The reference documentation is generated with
[puppet-strings](https://github.com/puppetlabs/puppet-strings) and the latest
version of the documentation is hosted at
[https://bodgit.github.io/puppet-php/](https://bodgit.github.io/puppet-php/).
## Limitations
This module has been built on and tested against Puppet 4.9.0 and higher.
The module has been tested on:
* CentOS Enterprise Linux 6/7
This module doesn't install or configure `mod_php` for Apache however the
`apache::mod::php` class should work in combination with this module.
## Development
The module has both [rspec-puppet](http://rspec-puppet.com) and
[beaker-rspec](https://github.com/puppetlabs/beaker-rspec) tests. Run them
with:
```
$ bundle exec rake test
$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:
```
Please log issues or pull requests at
[github](https://github.com/bodgit/puppet-php).