Ioncube PHP Installation Guide

### Steps to Install IonCube Loader

1. **Download IonCube Loader**:
– Visit the [IonCube website](https://www.ioncube.com/loaders.php) and download the version compatible with your server’s PHP version and operating system.
– Alternatively, you can use `wget` or `curl` on Linux systems to download the file directly.

2. **Extract the Loader**:
– Use `tar` to extract the downloaded archive:

tar -xvf ioncube_loaders.tar.gz

– Navigate into the extracted `ioncube` directory.

3. **Determine the PHP Extension Directory**:
– Run the following command to find the PHP extension directory:

php -i | grep extension_dir

– Note the path as you’ll need to place the IonCube Loader file in this directory.

4. **Copy the IonCube Loader File**:
– Move the appropriate loader file for your PHP version to the PHP extension directory.

cp ioncube/ioncube_loader_lin_7.4.so /path/to/php/extension_dir/

– Replace `7.4` with your PHP version.

5. **Edit the PHP Configuration File (php.ini)**:
– Open `php.ini` for editing:

sudo nano /etc/php/7.4/cli/php.ini

– Add the following line at the end of the file:

zend_extension = /path/to/php/extension_dir/ioncube_loader_lin_7.4.so

6. **Restart the Web Server**:
– Restart your web server to apply the changes:

sudo systemctl restart apache2

– Or, if you’re using Nginx with PHP-FPM:

sudo systemctl restart php7.4-fpm

7. **Verify Installation**:
– Run `php -v` to verify if IonCube Loader is enabled. You should see a message indicating that IonCube Loader is active.

### Additional Notes

– Make sure to use the correct version of IonCube Loader that matches your PHP version.
– If you are using Docker, you can add these commands to your Dockerfile to install IonCube Loader during the build process.

This should enable IonCube Loader in your PHP environment.

### Step 1: SSH into your AWS Instance

Use your SSH client to connect to the AWS instance:

ssh -i /path/to/your-key.pem ec2-user@your-aws-instance-ip

Replace `/path/to/your-key.pem` with your actual key file and `your-aws-instance-ip` with the IP address of your instance.

### Step 2: Update the System

Make sure your system's package index is up to date:

sudo yum update -y

### Step 3: Install PHP and `bcmath` Extension

If you're using PHP 7.4, the following steps will install the `bcmath` extension. If you're using a different PHP version, adjust the version number accordingly.

#### For Amazon Linux 2 (and CentOS/RHEL-based systems):

1. Install the `bcmath` extension with the following command:

sudo yum install php-bcmath -y

2. If you are using a custom PHP version (e.g., PHP 7.4 or 8.x), you might need to enable a third-party repository like `remi` and install the corresponding PHP version:

– Install `remi` repository:

sudo amazon-linux-extras install epel -y
     sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
     sudo yum install -y yum-utils
     sudo yum-config-manager --enable remi-php74  # For PHP 7.4, change the version as needed

– Install PHP and `bcmath`:

sudo yum install php php-bcmath -y

### Step 4: Restart Web Server (if applicable)

If you're running a web server like Apache or Nginx, restart it to apply the changes.

For Apache:

sudo systemctl restart httpd

For PHP-FPM (if using Nginx):

sudo systemctl restart php-fpm

### Step 5: Verify Installation

Check if the `bcmath` extension is installed and enabled by running:

php -m | grep bcmath

If `bcmath` appears in the output, it means the extension was successfully installed.

### Alternative: Installing via `pecl` (if required)

If you can't find `php-bcmath` via `yum`, you can install it using `pecl`:

1. Install `pecl` if it's not already installed:

sudo yum install php-pear php-devel -y

2. Install the `bcmath` extension via `pecl`:

sudo pecl install BCMath

3. Enable the extension by adding it to your `php.ini` file:

echo "extension=bcmath.so" | sudo tee -a /etc/php.ini

4. Restart the server (as in Step 4) and verify the extension.

This will enable `ext-bcmath` on your AWS instance.

### Step 1: SSH into Your Ubuntu Server

Use your SSH client to connect to your Ubuntu server:

ssh user@your-ubuntu-server-ip

Replace `user` with your actual username (e.g., `ubuntu`) and `your-ubuntu-server-ip` with the IP address of your server.

### Step 2: Update Your System

Make sure your system's package list is up-to-date:

sudo apt update

### Step 3: Install PHP and the `bcmath` Extension

#### For PHP 7.x or PHP 8.x

1. Install the `php-bcmath` extension for the version of PHP you are using. If you're unsure which version you are using, you can check with `php -v`.

– For PHP 7.x:

sudo apt install php7.x-bcmath

– For PHP 8.x:

sudo apt install php8.x-bcmath

Replace `7.x` or `8.x` with the correct version number you're using.

2. To check if PHP is installed, use:

php -v

If PHP is not installed, you can install PHP along with common extensions:

sudo apt install php php-bcmath

### Step 4: Restart Apache or PHP-FPM (If Applicable)

If you’re using Apache or PHP-FPM with Nginx, you need to restart the web server for the changes to take effect.

– For Apache:

sudo systemctl restart apache2

– For PHP-FPM (if using Nginx):

sudo systemctl restart php7.x-fpm  # Replace with your PHP version

### Step 5: Verify the Installation

To confirm that the `bcmath` extension is installed and enabled, run:

php -m | grep bcmath

If the `bcmath` extension appears in the output, it has been successfully installed.

### Troubleshooting

If the `php-bcmath` package is not available or if you're using a custom PHP version, you may need to install the required packages from a third-party repository (like `ondrej/php`), especially for newer PHP versions.

1. Add the `ondrej/php` repository (if necessary):

sudo add-apt-repository ppa:ondrej/php
   sudo apt update

2. Install the appropriate version of PHP and the `bcmath` extension:

sudo apt install php7.4 php7.4-bcmath  # For PHP 7.4, adjust as necessary

This will enable the `bcmath` extension for your PHP installation on Ubuntu.