Getting started with PHP

Compatibility

Php extension : 5.2 up to version 7.2

Php agent : Glibc higher or egal to 2.5

Create workspace
```
mkdir ~/nudge && cd ~/nudge
```
Download Nudge PHP extension and Agent

You can download all components (extension and agent) in the bundle available on the Atakama support.
- Download Nudge-PHP Bundle

Create nudge structure

sudo mkdir -p /etc/nudge  
sudo mkdir -p /var/log/nudge  
sudo mkdir -p /usr/lib64/php/modules    

Move files in the right places

The parent folder of nudge.ini may vary, it depends of your Linux OS:

Distribution	Répertoire
Redhat (or like)	`/etc/php.d`
Ubuntu, Debian (or like)	`/etc/php5/apache2/conf.d/`

sudo mv nudge.ini /etc/php.d
sudo mv config.cfg logger.properties /etc/nudge
sudo mv nudge.so /usr/lib64/php/modules
sudo mv nudge-agent /usr/bin

Set up permissions

sudo chmod +x /usr/bin/nudge-agent
sudo chmod +w /var/log/nudge

Warning : if SELinux is activated, you must authorize the Nudge PHP module :

  sudo chcon system_u:object_r:textrel_shlib_t /usr/lib64/php/modules/nudge.so

Set your nudge app key in the /etc/php.d/nudge.ini file

The key is composed by your application folder path and the Nudge key.
Example:
```
nudge.apps=/var/www/myapp:c5e9230c-3927-4c53-829d-8d87dbeff
```
Continue to the complete PHP documentation :
- Configuration of the extension
- Configuration of the agent

Restart Apache

sudo /etc/init.d/httpd restart

sudo service apache2 restart

In the log folder : /var/log/nudge, you should see this two files :

If you have sudden crashes on your application, it may be because of opcache as it alters the PHP code execution.

In your php.ini or opcache.ini file (use php –ini to find the path of your .ini file), if you have opcache enabled, set opcache.optimization_level = 0x0. This may cause a significant performance drop. For production, don’t disable optimizations.