Configure PHP and Zend extensions

Procedure

This document uses the SourceGuardian (sg11), ionCube Loader, and libsodium encryption components as examples. You can configure extensions in two ways: by using a user-added extension or one provided by the platform.

Configure a user-added extension

You can provide your own PHP or Zend extensions. First, use an FTP client to upload the extension files to the myfolder directory on your Web Hosting instance. After the upload is complete, you can find and load the extension from the PHP and Zend Extensions page.

1. Use FileZilla to connect to your Linux-based Web Hosting instance.

   For detailed instructions, see Manage website files by using FileZilla.

2. Upload the extension to the myfolder directory of your Web Hosting instance.

   • PHP extension: This example uses the SourceGuardian (sg11) encryption component. The process is similar for other PHP extensions.

     1. On your local host, extract the sg11 encryption component package.

     2. Drag the extracted sg11 folder (for example, named sg11_Linux) to the myfolder directory of your website.

   • Zend extension: This example uses the ionCube Loader encryption component. The process is similar for other Zend extensions.

     1. On your local host, extract the ionCube Loader encryption component package.

        Note

        Ensure that the extracted folder contains the component files directly and is not nested within another folder. If it is, use the inner folder.

     2. Drag the extracted ionCube Loader folder (for example, named ioncube) to the myfolder directory of your website.

3. Log on to the Web Hosting console.

4. Find the Web Hosting instance and click Manage in the Actions column.

5. In the left-side navigation pane, choose Advanced Environment Settings > PHP and Zend Extensions.

6. In the Important dialog box that appears, read the message and click Confirm.

7. On the PHP and Zend Extensions page, in the Extension Directory area, click myfolder directory.

   The Extension Directory area contains the User-added Extensions and Platform-provided Extensions tabs. When configuring a non-open-source extension, keep the default User-added Extensions tab selected.

8. Load the extension file.

   PHP extension

   This example uses the ixed.7.0.lin file from the sg11 component.

   Note

   • Each file can be loaded only once. Compressed files cannot be loaded.

   • Ensure that the PHP version of the Web Hosting instance matches the version of the file that you want to load. For example, if the Web Hosting instance uses PHP 7.0, you must select the ixed.7.0.lin file to load. The 7.0 in ixed.7.0.lin indicates the version number of the file. For more information about how to view or change the PHP version, see Change the PHP version.

   1. In the Extension Directory area, click the sg11 folder name (for example, sg11_Linux).

   2. Find the ixed.7.0.lin file and click Load in the Actions column.

   3. In the dialog box that appears, enter a name for the extension in the input field (for example, sg-php7.0) and click Confirm.

      After the configuration is complete, the Loaded Extensions area displays information about the loaded ixed.7.0.lin file. The extension name is displayed as sg-php7.0, and a Delete button is available in the Actions column.

   Zend extension

   This example uses the ioncube_loader_lin_7.0.so file from the ionCube Loader component.

   Note

   • Each file can be loaded only once. Compressed files cannot be loaded.

   • Ensure that the PHP version of your Web Hosting instance matches the version of the file that you want to load. For example, if your Web Hosting instance uses PHP 7.0, you must select the ioncube_loader_lin_7.0.so file to load. The 7.0 in ioncube_loader_lin_7.0.so indicates the version number of the file. For more information about how to view or change the PHP version, see Change the PHP version.

   1. In the Extension Directory area, click the ionCube Loader folder name (for example, ioncube).

   2. Find the ioncube_loader_lin_7.0.so file and click Load in the Actions column.

   3. In the dialog box that appears, enter a name for the extension (for example, ioncube7.0) and click Confirm.

      After the configuration is complete, the Loaded Extensions area displays information about the loaded ioncube_loader_lin_7.0.so file.

      Note

      The suffix (zend_extension) is automatically added to the name of a Zend extension to identify its type.

      The list shows two loaded extensions: ioncube7.0(zend_extension) and sg-php7.0. A Delete button is available for each extension.

Configure a platform-provided extension

This section uses the libsodium 2.0.23 encryption component as an example. You do not need to prepare or upload platform-provided extensions. The extensions available in the Web Hosting console already match your instance's current PHP version. Simply load them. If you change the PHP version of your instance, any loaded extensions are automatically deleted.

1. Log on to the Web Hosting console.

2. Find the Web Hosting instance and click Manage in the Actions column.

3. In the Important dialog box that appears, read the message and click Confirm.

4. On the PHP and Zend Extensions page, in the Extension Directory area, click the Platform-provided Extensions tab.

5. In the list of extensions, find libsodium and click Load in the Actions column.

   The Platform-provided Extensions list displays the available open-source extensions. A Load button is available for each extension.

   After the extension is successfully loaded, the Loaded Extensions area displays its information. The list shows that libsodium 2.0.23 has been loaded.

   Note

   If the extension fails to load, submit a ticket for assistance.

Delete an extension

If you no longer need a PHP or Zend extension, you can delete it from your Web Hosting instance.

1. In the Loaded Extensions area, find the extension you want to delete and click Delete in the Actions column.

2. In the confirmation dialog box that appears, click Confirm.

Next steps

After loading an extension, use the phpinfo() function to verify the configuration.

1. Use FileZilla to reconnect to your Linux-based Web Hosting instance.

2. In the /htdocs directory, right-click an empty area and select Create new file(T).

3. In the dialog box that appears, enter a filename (for example, test.php) and click OK(O).

4. Select the test.php file, right-click it, and select View/Edit(V). Enter the following code and save the file.

   <?php
   phpinfo();
   ?>

5. In a web browser, navigate to http://your_domain_name/test.php and press Enter.

   Note

   If you cannot use your domain name for reasons such as a pending ICP filing, you can use the temporary domain name provided for your instance.

6. On the page returned by the phpinfo() function, search for the extension's name.

   • PHP extension: To verify that the sg11 extension was configured successfully, search for SourceGuardian. If a module with this name appears, the configuration is successful. The page displays the version number and configuration details for the SourceGuardian module.

     Important

     If you cannot find any information for SourceGuardian, the configuration has failed. submit a ticket for assistance.

   • Zend extension: To verify that the ionCube Loader extension was configured successfully, search for ionCube Loader. If a module with this name appears, the configuration is successful. The page displays the version number and configuration details for the ionCube PHP Loader module.

     Important

     If you cannot find any information for ionCube Loader, the configuration has failed. submit a ticket for assistance.

Related documents

Linux-based Web Hosting instances come with several common extensions configured by default. For more information, see Console FAQs.