From e64fd9ac81e7fa9852221276335578487f1e4813 Mon Sep 17 00:00:00 2001
From: Jeff Geerling <geerlingguy@mac.com>
Date: Fri, 28 Feb 2014 20:39:10 -0600
Subject: [PATCH] Added README.md.

---
 README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d0b7045
--- /dev/null
+++ b/README.md
@@ -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/.