mirror of
https://github.com/geerlingguy/ansible-role-php.git
synced 2025-01-06 18:57:36 +01:00
Added README.md.
This commit is contained in:
commit
e64fd9ac81
72
README.md
Normal file
72
README.md
Normal file
@ -0,0 +1,72 @@
|
||||
# Ansible Role: PHP
|
||||
|
||||
Installs PHP on RedHat Enterprise Linux or CentOS 6.x servers.
|
||||
|
||||
## Requirements
|
||||
|
||||
None.
|
||||
|
||||
## Role Variables
|
||||
|
||||
Available variables are listed below, along with default values (see `vars/main.yml`):
|
||||
|
||||
php_enablerepo: ""
|
||||
|
||||
If you have enabled any additional repositories (might I suggest geerlingguy.repo-epel or geerlingguy.repo-remi), those repositories can be listed under this variable (e.g. `remi,epel`). This can be handy, as an example, if you want to install the latest version of PHP 5.4, which is in the Remi repository.
|
||||
|
||||
php_memory_limit: "256M"
|
||||
php_max_execution_time: "60"
|
||||
php_upload_max_filesize: "64M"
|
||||
|
||||
Some commonly-adjusted PHP ini directives. Adjust to suit your system.
|
||||
|
||||
php_apc_cache_by_default: "1"
|
||||
php_apc_shm_size: "96M"
|
||||
|
||||
Two APC ini directives that are often customized on a system. Set `php_apc_cache_by_default` to 0 to disable APC by default (so you could enable it on a host-by-host basis). Set the `php_apc_shm_size` so it will hold all your application code in memory with a little overhead (fragmentation or APC running out of memory will slow down PHP dramatically).
|
||||
|
||||
This Ansible role assumes you're including `php-pecl-apc` in the list of `php_packages` below. It's rarely a good idea to run a PHP < 5.5 installation without some kind of opcode cache, and APC works great for PHP 5.3 and 5.4.
|
||||
|
||||
php_date_timezone: "America/Chicago"
|
||||
|
||||
Explicitly set PHP's date timezone system-wide.
|
||||
|
||||
php_packages: []
|
||||
|
||||
A list of the PHP packages to install. You'll likely want to install common packages like `php`, `php-cli`, `php-devel` and `php-pdo`, and you can add in whatever other packages you'd like (for example, `php-gd` for image manipulation, or `php-ldap` if you need to connect to an LDAP server for authentication).
|
||||
|
||||
## Dependencies
|
||||
|
||||
- geerlingguy.apache
|
||||
|
||||
## Example Playbook
|
||||
|
||||
- hosts: webservers
|
||||
vars_files:
|
||||
- vars/main.yml
|
||||
roles:
|
||||
- { role: geerlingguy.php }
|
||||
|
||||
*Inside `vars/main.yml`*:
|
||||
|
||||
php_memory_limit: "128M"
|
||||
php_max_execution_time: "90"
|
||||
php_upload_max_filesize: "256M"
|
||||
php_packages:
|
||||
- php
|
||||
- php-cli
|
||||
- php-common
|
||||
- php-devel
|
||||
- php-gd
|
||||
- php-mbstring
|
||||
- php-pdo
|
||||
- php-pecl-apc
|
||||
- php-xml
|
||||
|
||||
## License
|
||||
|
||||
MIT / BSD
|
||||
|
||||
## Author Information
|
||||
|
||||
This role was created in 2014 by Jeff Geerling (@geerlingguy), author of Ansible for DevOps. You can find out more about the book at http://ansiblefordevops.com/, and learn about the author at http://jeffgeerling.com/.
|
Loading…
Reference in New Issue
Block a user