Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.0 » SQL Anywhere Server - Programming » SQL Anywhere Data Access APIs » SQL Anywhere PHP API » Installing and configuring SQL Anywhere PHP

 

Installing the PHP module on Linux/Solaris

To use the SQL Anywhere PHP module on Linux or Solaris, you must copy the shared object from the SQL Anywhere installation directory and add it to your PHP installation. Optionally, you can add an entry to your PHP initialization file, php.ini, to load the module, so you do not need to load it manually in each script.

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.

For more information, see Creating PHP test pages.