To install the PHP module on Linux/Solaris

1. Locate the php.ini file of your PHP installation, and open it in a text editor. Locate the line that specifies the location of the extension_dir directory. If extension_dir is not set to any specific directory, it is a good idea to set it to point to an isolated directory for better system security.

2. Copy the shared object from the lib32 or lib64 subdirectory of your SQL Anywhere installation to the directory specified by the extension_dir entry in the php.ini file. Your choice of shared object will depend on the version of PHP that you have installed and whether it is a 32-bit or a 64-bit version.

   Note

   If your version of PHP is more recent than the shared object provided by SQL Anywhere, try using the most recent shared object provided. For example, if you installed PHP 5.2.7, and the most recent shared object is php-5.2.6_sqlanywhere_r.so, use php-5.2.6_sqlanywhere_r.so.

   For information about which version of the shared object to use, see Choosing which PHP module to use.

3. Optionally, add the following line to the php.ini file to load the SQL Anywhere PHP driver automatically. Alternatively, you can load it manually with a few extra lines of code at the start of each script that requires it. The entry must identify the shared object you copied, which is either

   extension=php-5.x.y_sqlanywhere.so

   or, for the thread-safe shared object,

   extension=php-5.x.y_sqlanywhere_r.so

   where 5.x.y is the version number of the PHP shared object copied in the previous step.

4. Before attempting to use the PHP module, verify that your environment is set up for SQL Anywhere. Depending on which shell you are using, enter the appropriate command to source the SQL Anywhere configuration script from the SQL Anywhere installation directory:

   In this shell ...	... use this command
   sh, ksh, or bash	. /bin32/sa_config.sh
   csh or tcsh	source /bin32/sa_config.csh

   The 32-bit version of the SQL Anywhere PHP extension DLL requires the bin32 directory to be in your path. The 64-bit version of the SQL Anywhere PHP extension DLL requires the bin64 directory to be in your path.

5. At a command prompt, enter the following command to start the SQL Anywhere sample database:

   dbeng11 samples-dir/demo.db

6. At a command prompt, change to the sdk/php/examples subdirectory of your SQL Anywhere installation. Enter the following command:

   php test.php

   Messages similar to the following should appear. If the php command is not recognized, verify that php is in your path.

   Installation successful Using php-5.2.6_sqlanywhere.so Connected successfully

7. When you are done, stop the database server.