如何在数据库中使用 PHP

数据库支持中的 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.4.8-win32\\php.exe';

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

ALTER EXTERNAL ENVIRONMENT PHP
  LOCATION 'php';

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

请确保 php-5.x.y_sqlanywhere 和 php-5.x.y_sqlanywhere_extenv16 模块都位于 php.ini 文件内 extension_dir 指示的目录中。检查前一节中介绍的安装步骤。
确保 php-5.x.y_sqlanywhere 和 php-5.x.y_sqlanywhere_extenv16 模块都列在 php.ini 文件的动态扩展部分。检查前一节中介绍的安装步骤。
请确保可以找到 phpenv.php。检查以确定 SQL Anywhere bin32 文件夹在 PATH 中。
对于 Windows，请确保可以找到 32 位 DLL（dbcapi.dll、dblib16.dll、dbicu16.dll、dbicudt16.dll、dblgen16.dll 和 dbextenv16.dll）。检查以确定 SQL Anywhere bin32 文件夹在 PATH 中。
对于 Linux、Unix 和 Mac OS X，请确保可以找到 32 位共享对象（libdbcapi_r、libdblib11_r16、libdbicu16_r、libdbicudt16、dblgen16.res 和 libdbextenv16_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 '<?php 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 '<?php 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 '<?php 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 的详细信息和示例，请参见位于 %SQLANYSAMP16%\SQLAnywhere\ExternalEnvironments\PHP 目录下的示例。

使用DocCommentXchange讨论此页。