SQL Anywhere 支持 PHP 存储过程和函数。PHP 存储过程或函数的行为与 SQL 存储过程或函数基本相同，只是过程或函数的代码以 PHP 编写并且在数据库服务器外（即在 PHP 可执行实例内）执行。对于使用 PHP 存储过程和函数的每个连接，会有一个单独的 PHP 可执行文件实例。这一点与 Java 存储过程和函数有很大不同。如果是 Java，针对每个数据库有一个 Java VM 实例，而不是每个连接一个实例。PHP 和 Java 间的另一个主要差异是 PHP 存储过程不返回结果集，而 Java 存储过程可以返回结果集。PHP 仅返回 LONG VARCHAR 类型的对象，它是 PHP 脚本的输出。

在数据库支持中使用 PHP 有两个前提条件：

除了以上两个前提条件外，数据库管理员还必须安装 SQL Anywhere PHP External Environment 模块。有些 PHP 版本的预建模块随 SQL Anywhere 发行包一起提供。要安装预建模块，将相应的驱动程序复制模块到 PHP 扩展目录中（可以在 php.ini 中找到）。在 Unix 中，还可以使用符号链接。

♦  安装外部环境模块 (Windows)

1. 找到 PHP 安装目录中的 php.ini 文件，并在文本编辑器中将其打开。找到指定 extension_dir 目录位置的行。如果未将 extension_dir 设置到任何特定目录，则为获得更好的系统安全，最好将其设置为指向一个单独的目录。

2. 将所需的外部环境 PHP 模块从 SQL Anywhere 安装目录复制到 PHP 扩展目录。以下是一个可使用的模型：

   copy install-dir\Bin32\php-5.2.6_sqlanywhere_extenv11.dll php-dir\ext

3. 请确保您同时还将 SQL Anywhere PHP 驱动程序从 SQL Anywhere 安装目录安装到了 PHP 扩展目录。此文件名遵循模式 php-5.x.y_sqlanywhere.dll，其中 x 和 y 为版本号。它们应该与在步骤 2 中所复制的文件的版本号相匹配。

♦  安装外部环境模块 (Unix)

1. 找到 PHP 安装目录中的 php.ini 文件，并在文本编辑器中将其打开。找到指定 extension_dir 目录位置的行。如果未将 extension_dir 设置到任何特定目录，则为获得更好的系统安全，最好将其设置为指向一个单独的目录。

2. 将所需的外部环境 PHP 模块从 SQL Anywhere 安装目录复制到 PHP 安装目录。以下是一个可使用的模型：

   cp install-dir/bin32/php-5.2.6_sqlanywhere_extenv11.so php-dir/ext

3. 请确保您同时还将 SQL Anywhere PHP 驱动程序从 SQL Anywhere 安装目录安装到了 PHP 扩展目录。此文件名遵循模式 php-5.x.y_sqlanywhere.so，其中 x 和 y 为版本号。它们应该与在步骤 2 中所复制的文件的版本号相匹配。

数据库支持中的 PHP 仅适用于 SQL Anywhere 版本 11 或更高版本数据库。如果装载 SQL Anywhere 10 数据库，则在数据库支持中尝试使用 PHP 时会返回指示不支持外部环境的错误消息。

要在数据库中使用 PHP，数据库服务器必须能够找到并启动 PHP 可执行文件。通过执行以下语句可以验证数据库服务器是否能够找到并启动 PHP 可执行文件：

START EXTERNAL ENVIRONMENT PHP;

如果消息指示找不到 "外部可执行文件"，则该问题的原因是数据库服务器无法找到 PHP 可执行文件。这种情况下，应执行 ALTER EXTERNAL ENVIRONMENT 语句来显式设置 PHP 可执行文件的位置（包括可执行文件名），或者确保具有 PHP 可执行文件的目录包含在 PATH 环境变量中。

ALTER EXTERNAL ENVIRONMENT PHP 
  LOCATION 'php-path';

例如：

ALTER EXTERNAL ENVIRONMENT PHP
  LOCATION 'c:\\php\\php-5.2.6-win32\\php.exe';

要恢复缺省设置，请执行以下语句：

ALTER EXTERNAL ENVIRONMENT PHP
  LOCATION 'php';

如果一条消息指出找不到 "主线程"，请检查以下各项：

• 请确保 php-5.x.y_sqlanywhere 和 php-5.x.y_sqlanywhere_extenv11 模块都位于 extension_dir 指示的目录中。检查上述安装步骤。
• 请确保可以找到 phpenv.php。检查以确定 SQL Anywhere bin32 文件夹在 PATH 中。
• 对于 Windows，请确保可以找到 32 位 DLL（dbcapi.dll、dblib11.dll、dbicu11.dll、dbicudt11.dll、dblgen11.dll 和 dbextenv11.dll）。检查以确定 SQL Anywhere bin32 文件夹在 PATH 中。
• 对于 Linux、Unix 和 Mac OS X，请确保可以找到 32 位共享对象（libdbcapi_r、libdblib11_r、libdbicu11_r、libdbicudt11、dblgen11.res 和 libdbextenv11_r）。检查以确定 SQL Anywhere bin32 文件夹在 PATH 中。
• 请确保未设置环境变量 PHPRC，或确保它指向要使用的 PHP 版本。

除了验证数据库服务器可以启动 PHP 外，START EXTERNAL ENVIRONMENT PHP 语句并不是必需的。通常，进行 PHP 存储过程或函数的调用会自动启动 PHP。

类似地，停止 PHP 的实例时 STOP EXTERNAL ENVIRONMENT PHP 语句也不是必需的，因为在连接终止时实例会自动消失。然而，如果要彻底离开 PHP 并且想要释放一些资源，则 STOP EXTERNAL ENVIRONMENT PHP 语句则可以为您的连接释放该 PHP 实例。

验证数据库服务器可以启动 PHP 可执行文件后，要做的下一件事就是在数据库中安装所需的 PHP 代码。使用 INSTALL 语句即可完成。例如，可以执行以下语句来将特定 PHP 脚本安装到数据库。

INSTALL EXTERNAL OBJECT 'php-script' 
  NEW 
  FROM FILE 'php-file'
  ENVIRONMENT PHP;

也可以从表达式构建和安装 PHP 代码，如下所示：

INSTALL EXTERNAL OBJECT 'php-script' 
  NEW
  FROM VALUE 'php-statements'
  ENVIRONMENT PHP;

还可以从变量构建和安装 PHP 代码，如下所示：

CREATE VARIABLE PHPVariable LONG VARCHAR;
SET PHPVariable = 'php-statements';
INSTALL EXTERNAL OBJECT 'php-script' 
  NEW 
  FROM VALUE PHPVariable
  ENVIRONMENT PHP;

要从数据库中删除 PHP 代码，请使用 REMOVE 语句，如下所示：

REMOVE EXTERNAL OBJECT 'php-script';

要修改现有 PHP 代码，可以使用 INSTALL 语句的 UPDATE 子句，如下所示：

INSTALL EXTERNAL OBJECT 'php-script' 
  UPDATE 
  FROM FILE 'php-file'
  ENVIRONMENT PHP;

INSTALL EXTERNAL OBJECT 'php-script' 
  UPDATE 
  FROM VALUE 'php-statements'
  ENVIRONMENT PHP;

SET PHPVariable = 'php-statements';
INSTALL EXTERNAL OBJECT 'php-script' 
  UPDATE 
  FROM VALUE PHPVariable
  ENVIRONMENT PHP;

PHP 代码安装在数据库中后，接下来可以继续创建所需的 PHP 存储过程和函数。创建 PHP 存储过程和函数时，LANGUAGE 始终是 PHP，EXTERNAL NAME 字符串包含调用 PHP 子例程和返回 OUT 参数所需的信息。

参数通过 $argv 数组传递给 PHP 脚本，这与 PHP 从命令行获取参数的方式类似（即 $argv[1] 为第一个参数）。要设置输出参数，请将其赋值给相应的 $argv 元素。返回值始终是脚本的输出（LONG VARCHAR 数据类型）。

创建 PHP 存储过程时，其输入和输出参数可以采用任何一组数据类型。但为了在 PHP 脚本内部使用，这些参数会转换为（或者反向转换）布尔值、整数、双精度值或字符串。返回值始终是 LONG VARCHAR 类型的对象。以下是一个简单的 PHP 示例：

INSTALL EXTERNAL OBJECT 'SimplePHPExample' 
  NEW 
  FROM VALUE '<? function SimplePHPFunction(
    $arg1, $arg2, $arg3, $arg4 ) 
    { return ($arg1 * 1000) + 
      ($arg2 * 100) + 
      ($arg3 * 10) + 
      $arg4; 
    } ?>'
  ENVIRONMENT PHP;

CREATE FUNCTION SimplePHPDemo( 
  IN thousands INT, 
  IN hundreds INT, 
  IN tens INT, 
  IN ones INT) 
RETURNS LONG VARCHAR
EXTERNAL NAME '<file=SimplePHPExample> print SimplePHPFunction(
    $argv[1], $argv[2], $argv[3], $argv[4]);' 
LANGUAGE PHP;

// The number 1234 should appear
SELECT SimplePHPDemo(1,2,3,4);

对于 PHP，EXTERNAL NAME 字符串以 SQL 的单独一行指定。

要使用服务器端 PHP，PHP 代码可以使用缺省数据库连接。要获取数据库连接的句柄，请以空字符串参数（'' 或 ""）调用 sasql_pconnect。空字符串参数会指示 SQL Anywhere PHP 驱动程序返回当前外部环境连接，而不是打开一个新连接。下面的示例将创建一个表，然后调用 PHP 存储过程来填充该表。

CREATE TABLE phpTab(c1 int, c2 char(128));

INSTALL EXTERNAL OBJECT 'ServerSidePHPExample' 
  NEW 
  FROM VALUE '<? function ServerSidePHPSub() { 
    $conn = sasql_pconnect( '''' ); 
    sasql_query( $conn,
    "INSERT INTO phpTab 
       SELECT table_id, table_name FROM SYS.SYSTAB" );
    sasql_commit( $conn ); 
  } ?>'
  ENVIRONMENT PHP;

CREATE PROCEDURE PHPPopulateTable() 
EXTERNAL NAME '<file=ServerSidePHPExample> ServerSidePHPSub()'
LANGUAGE PHP;

CALL PHPPopulateTable();

// The following should return 2 identical rows
SELECT count(*) FROM phpTab 
UNION ALL 
SELECT count(*) FROM SYS.SYSTAB;

对于 PHP，EXTERNAL NAME 字符串以 SQL 的单独一行指定。请注意，在上面的示例中，由于引号在 SQL 中的分析方式，单引号都是双写的。如果 PHP 源代码是在文件中，单引号则不用双写。

要将错误返回给数据库服务器，可抛出一个 PHP 异常。下面举例说明如何实现这一目的。

CREATE TABLE phpTab(c1 int, c2 char(128));

INSTALL EXTERNAL OBJECT 'ServerSidePHPExample' 
  NEW 
  FROM VALUE '<? function ServerSidePHPSub() {
    $conn = sasql_pconnect( '''' );
    if( !sasql_query( $conn,
      "INSERT INTO phpTabNoExist
         SELECT table_id, table_name FROM SYS.SYSTAB" )
    ) throw new Exception(
      sasql_error( $conn ),
      sasql_errorcode( $conn )
    );
    sasql_commit( $conn );
  } ?>'
  ENVIRONMENT PHP;

CREATE PROCEDURE PHPPopulateTable()
  EXTERNAL NAME
    '<file=ServerSidePHPExample> ServerSidePHPSub()'
  LANGUAGE PHP;

CALL PHPPopulateTable();

上面的示例将以指示无法找到 phpTabNoExist 表的错误 SQLE_UNHANDLED_EXTENV_EXCEPTION 终止。

有关在数据库支持中使用 PHP 的更详细信息和示例，请参见位于 samples-dir\SQLAnywhere\ExternalEnvironments\PHP 目录中的示例。