Adding Extensions

To add Zend extensions:

1. Download the extension.
   Note:Zend Server for IBMi for IBM i - AIX Unix/Linux extensions end with the .so suffix.

2. Place the extension in your extensions directory.
   To locate the extensions directory,go to Configurations | PHP, and check the value for the extension_dir directive.
   By default, your extensions directory is located in:
   <install_path>/zend/lib/php_extensions

3. Add the following line to your php.ini:
   zend_extension=<full_path_to_extension_so_file>

4. Restart your server by clicking in the toolbar.

5. Ensure that the extension is properly loaded by checking the output of PHPInfo in the User Interface.

Note:

If you try to load a PHP extension as a Zend extension in Linux, you may receive the following error message in your server's error log: "<extension_name> doesn't appear to be a valid Zend extension." If this occurs, remove it and add it as a PHP extension, following the instructions under To Add PHP Extensions, below.

To add PHP extensions

1. Download the third party extension. Many third party extensions can be found at http://pecl.php.net.
   Extensions are obtained directly from external web repositories.

2. Place the PHP extension in your extensions directory.
   To locate the extensions directory,go to Configurations | PHP, and check the value for the extension_dir directive.
   By default, your extensions directory is located in:
   <install_path>/lib/php_extensions

3. Add the following line to your php.ini:
   extension=<my_extension_name>.so
   Ensure that you replace <my_extension_name> with your extension's name.

4. Restart your Web server.
   Ensure that the extension is properly loaded by checking the User Interface: See Monitor | PHP Info for the output of PHP Info.

The extensions appear in your User Interface under the Extensions tab and you can use the User Interface to load and unload the extension.

To compile extensions from source:

1. Download and extract the extension's source.

2. Switch to the extension source directory (by default located in <install_path>/Zend/ZendServer/lib/phpext) and run the following commands:

cd <your_extension_directory>

<install_path>/bin/phpize

Ensure that you replace <your_extension_directory> with your extension directory's name.

3. Run the ./configure command to prepare the source for compilation. You will need to include the "php-config" and "enable-shared" flags as follows:

./configure --with-php-config=<install_path>/bin/php-config\

            --enable-shared

Note:

Some extensions will need additional configuration flags. It is therefore advised to run "./configure --help" and review the possible flags before compiling.

4. Compile and install the extension binaries by running the following commands:

make

make install

Make install should install the new .so extension binary in Zend Server for IBMi's extension directory.

5. Add the following line to your php.ini to load your new extension:  

extension=<my_extension_name>.so

Replace <my_extension_name> with your extension's binary name.

6. Restart your Web server.

7. Ensure that the extension is properly loaded by checking the output of PHP Info. This can be viewed in the Zend Server for IBMi PHP Info page.

The extension appears in your User Interface under the Extensions page and you can use the User Interface to load and unload the extension.