下载 Oracle 数据库特别版 Zend Core for Oracle

关键词 php, 开放源代码, 特别版, 全部

PHP 大会教程：Oracle 数据库 10g 特别版和 Zend Core for Oracle

一个介绍如何安装 Oracle 数据库特别版和 Zend Core for Oracle 以及如何使用 PHP OCI8 扩展的分步指南

2006 年 3 月发布

安装 Oracle 数据库特别版和 Zend Core for Oracle

本部分介绍了如何安装：

• Oracle 数据库特别版
• Zend Core for Oracle

• 512MB 内存
• 5GB 硬盘空间
• Red Hat Enterprise Linux (RHEL) 3
• RHEL 4
• Novell SUSE Linux Enterprise Server (SLES) 9

Oracle 数据库特别版

• 致力于 PHP、Java、.NET 以及其他需要数据库的应用程序的开发人员
• 需要免费入门级数据库来进行培训和部署的 DBA
• 需要在其应用程序或产品中嵌入 Oracle 数据库的独立软件供应商 (ISV)
• 需要免费的入门级数据库的教育机构和学生

• SQL、PL/SQL
• Java、C 和 PHP
• Windows .NET
• Oracle Application Express
• C++、ODBC、OLE DB

• 用户数据最大为 4GB
• 单数据库实例
• 使用一个 CPU
• 使用 1GB 内存

安装 Oracle 数据库特别版

1. 以 root 用户身份登录或执行 su 命令

   su
   Password:
   

2. 将 oracle-xe-10.2.0.1-1.0.i386.rpm 复制到 /tmp，然后将目录更改为 /tmp。

   cp oracle-xe-10.2.0.1-1.0.i386.rpm /tmp
   cd /tmp
   

3. 安装 RPM

   rpm -ivh oracle-xe-10.2.0.1-1.0.i386.rpm
   

   安装了 Oracle 数据库特别版。
   
   
4. 配置数据库。

   /etc/init.d/oracle-xe configure
   

5. 对 Application Express 使用默认端口 8080，并对数据库监听器使用 1521。
   
   
6. 输入并确认默认用户的密码。
   
   
7. 输入 Y 或 N，指定是否希望数据库在系统重新启动时自动启动。
至此，已经配置并启动了数据库和数据库监听器。

测试 Oracle 数据库特别版安装

1. 打开 web 浏览器并输入：

   http://127.0.0.1:8080/apex
   

2. 以用户 system 的身份使用安装过程中输入的密码登录。

Zend Core for Oracle

安装 Zend Core for Oracle

1. 以 root 用户身份登录或执行 su 命令（如果您尚未执行该操作）。

   su
   Password:
   

2. 将 ZendCoreForOracle-v1.3.1-Linux-x86.tar.gz 复制到 /tmp，然后将目录更改为 /tmp。

   cp ZendCoreForOracle-v1.3.1-Linux-x86.tar.gz /tmp
   cd /tmp
   

3. 解压缩已下载的 Zend Core for Oracle 软件：

   tar -zxf ZendCoreForOracle-v1.3.1-Linux-x86.tar.gz
   

   文件解压缩到一个名为 ZendCoreForOracle-v1.3.1-Linux-x86 的子目录。
   
   
4. 将目录更改为 ZendCoreForOracle-v1.3.1-Linux-x8，然后启动 Zend Core for Oracle 安装：

   cd ZendCoreForOracle-v1.3.1-Linux-x86
   ./install
   

5. 在最初的 Zend Core for Oracle Installation 页面中，单击 OK。
   
6. 在 Zend Core for Oracle V.1 页面中，单击 Exit。
7. 当系统提示您接受许可条款时，单击 Yes。
8. 如果已经安装了 PHP，则系统提示您备份并覆盖现有的 php.ini 文件。单击 Yes。
9. 当系统提示您指定 Zend Core for Oracle 的安装位置时，接受默认位置（或输入您想要的位置），然后单击 OK。安装程序开始解压缩安装所需的文件。
10. 当进度窗口指示已安装所有软件时，系统将提示您“Please enter the GUI password”。在 Password 域中，输入要在访问 Zend Core Console 时使用的密码，然后单击 OK。
11. 当系统提示您“Verify the password”时，输入上一步中指定的密码，然后单击 OK。
12. 在 Zend Core 支持页面中，您可以有选择地输入 Zend 网络用户 ID 和密码，以便能够使用 Zend Core Console 跟踪对 Zend Core 和 PHP 组件的更新何时可用。如果您尚未注册，或不希望跟踪更新，则单击 No。
13. 下一页提示您为 Zend Core 安装选择 Web 服务器。选择与 Linux 一起安装的默认的 Apache。单击 OK。
14. 在确认 Web 服务器选择页面中，在“Do you wish to proceed?”的提示下，单击 Yes。
15. 在下一个安装页面中，系统将提示您“Please select an installation method for Apache 2.0.52”。选择 Apache 模块作为方法，然后单击 OK。
16. 在下一个安装页面中，当系统提示您“Please select a virtual server for the Zend Core GUI”时，选择 Main Server，然后单击 OK。
17. 在下一个安装页面中，在“Would you like to restart the Web Server”提示下，单击 Yes。
18. 在下一个安装页面中，将显示一个指示 apachectl 脚本已更新的通知。单击 OK。
19. 下一个安装页面（包含“Thank you for installing Zend Core for Oracle”）列出了有用的配置命令和一个 Zend Core 引擎管理网页。记下此信息，然后单击 Exit。
20. 将显示一个最后确认页面。单击 OK 完成安装。

配置 Zend Core for Oracle

1. 在 Web 浏览器中输入以下 URL，访问 Zend Core Administration 页面： http://127.0.0.1/ZendCore
2. 输入您在 Zend Core for Oracle 安装过程中提供的 GUI 密码。单击 login >>> 图标。
3. 单击 Configuration 选项卡显示配置选项。
4. 单击 + 图标展开 Error Handling 和 Logging 配置条目。
5. 将 display_errors 指令设置为 On，以便开发过程中在 HTML 脚本输出中显示错误。
6. 由于有未保存的更改，因此页面标题下将显示“Unsaved configuration”消息。单击 Save Settings 保存配置更改。
7. 由于您已经进行了配置更改，因此必须重新启动 Apache Web 服务器。在页面标题下，注意提示您执行该操作的“Please Restart Apache”消息。单击 Restart Server 重新启动 Apache 服务器。
8. 单击 Logout 退出 Zend Core for Oracle Administration 页面。

测试 Zend Core for Oracle 安装

1. 创建一个公共虚拟目录 public_html。编辑 APACHE_HOME/conf/httpd.conf，删除以下行中的“#”：

   #UserDir public_html
   

2. 以普通用户（非 root 用户）的身份在 home 目录中创建一个名为 public_html 的目录，将目录更改为这个新创建的目录，在命令窗口中输入下列命令：

   cd $HOME
   mkdir public_html
   cd public_html
   

3. 创建一个名为 hello.php 的文件，在其中添加以下 PHP 代码：

   <?php 
   echo "Hello world!";
   ?>
   

4. 打开 Web 浏览器，输入以下 URL：

   http://127.0.0.1/~<username>/hello.php
   

   浏览器中将显示行“Hello world!”。

PHP OCI8 扩展

<?php 
$conn = oci_connect('hr', 'hrpw', '//localhost/XE');

$stid = oci_parse($conn, 'select city from locations');
oci_execute($stid);
oci_fetch_all($stid, $res);
oci_close($conn);

print '<table border="1">';
while ($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) {
print '<tr>';
foreach ($row as $item) {
print '<td>'.($item?htmlentities($item):'').'</td>';
    }
print '</tr>';
  }
print '</table>';
?>

连接到 Oracle

$c = oci_connect($username, $password, $dbname)

$c = oci_new_connect($username, $password, $dbname)

$c = oci_pconnect($username, $password, $dbname)

• oci8.max_persistent：该参数限制高速缓存的持久连接数。达到该限制时，所有 oci_pconnect() 调用均被视为 oci_connect() 调用。将该参数设置为 -1（默认值）表示没有限制。
• oci8.persistent_timeout：Apache 进程保持空闲持久连接的时间（以秒为单位）。每当 PHP 脚本完成时，无论脚本是否调用 oci8 函数，都将执行到期检查。将该参数设置为 -1（默认值）表示没有超时。如果连接已过期，oci_pconnect() 将创建一个新连接。
• oci8.ping_interval：oci8 在执行 oci_pconnect() 过程中执行 ping 操作之前经过的秒数。如果该参数设置为 0，则 PHP 将在每次调用 oci_pconnect() 时对数据库执行 ping 操作。要禁用 ping，将该值设置为 -1。默认值为 60 秒。如果 ping 确定连接不可用，则将创建一个新连接。

连接字符串

1. 简单连接字符串
2. 完整连接字符串
3. tnsnames.ora 别名

//hostname:port/service_name

$c = oci_connect('hr', 'hrpw', '//localhost/XE');

$db = MYDB2 = (DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)
(HOST = mymachine.mydomain)(PORT = 1521))
(CONNECT_DATA=
(SERVER = DEDICATED)
(SERVICE_NAME = MYDB.AU.ORACLE.COM)))';

$c = oci_connect($un, $pw, $db);

# tnsnames.ora
MYDB2 = (DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)
(HOST = mymachine.mydomain)(PORT = 1521))
(CONNECT_DATA=
(SERVER = DEDICATED)
(SERVICE_NAME = MYDB.AU.ORACLE.COM)))

$c = oci_connect($un, $pw, 'MYDB2');

$ORACLE_HOME/network/admin/tnsnames.ora

/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/network/admin/tnsnames.ora

Oracle 环境变量

#!/bin/sh

TNS_ADMIN=/usr/local/apache/conf
export TNS_ADMIN
echo Starting Apache 
#export > /tmp/envvars
/usr/local/apache/bin/apachectl start

关闭连接

oci_close($c);

$c1 = oci_connect('hr', 'hrpw', '//localhost/XE');
$c2 = oci_connect('hr', 'hrpw', '//localhost/XE');

do_query($c1, 'select user from dual');
oci_close($c1);
do_query($c1, 'select user from dual');
do_query($c2, 'select user from dual');
oci_close($c2);

执行语句

1. 分析 - 准备一个要执行的语句
2. 绑定 - 可以有选择地让您绑定数据值（例如，在 WHERE 子句中）以便提高性能和安全性
3. 定义 - 一个可选步骤，使您可以指定哪些 PHP 变量将保存结果。（不常见？）
4. 执行 - 数据库处理该命令并缓冲结果。
5. 获取 - 从数据库中取回查询结果。Oci8 提供了一些可供选择的获取语句。

查询

$stid = oci_parse($c, 'select * from locations');
oci_execute($stid, OCI_DEFAULT);
oci_fetch_all($stid, $res);

$stid = oci_parse($c, "select * from locations where city = 'Sydney'");

• oci_fetch_all()：一次性获取所有结果
• oci_fetch_array()：以您选择的数组形式获取下一行
• oci_fetch_assoc()：以关联数组的形式获取下一行
• oci_fetch_object()：以对象形式获取新行
• oci_fetch_row()：以整数索引的数组形式获取下一行
• oci_fetch()：与 oci_result()（返回给定字段的结果）一起使用

$stid = oci_parse($c, "select city from locations");
oci_execute($stid, OCI_DEFAULT);
while ($res = oci_fetch_row($stid)) {
echo $res[0] ."<br>\n";
}

• oci8.default_prefetch：当执行每个数据库获取操作时 Oracle 返回的记录数。默认值为 10。调整该设置可以显著提高返回大量行的查询的性能。它每次返回尽可能多的数据，从而最大限度地降低了数据库服务器的“往返”次数。Oracle 将数据高速缓冲在它的客户端缓冲区中，并只向 PHP 提供 PHP 本身请求的行。
• oci8.statement_cache_size：支持 OCI 客户端语句高速缓存。默认值为 20 个语句。可以通过将该值设置为 0 来禁用高速缓存。客户端语句高速缓存意味着甚至不需要将语句文本传输给数据库，从而进一步减少了网络通信量和服务器负载。高速缓存是一个纯 Oracle 会话，因此当使用持久连接时，该特性通常很有用。

Insert/Update/Delete/Create/Drop

$s = oci_parse($c1, "create table i1test (col1 number)");
$r = oci_execute($s, OCI_DEFAULT);

$s = oci_parse($c1, "insert into i1test values (1)");
$r = oci_execute($s, OCI_DEFAULT);

事务

$r = oci_execute($s, OCI_DEFAULT);

$s = oci_parse($c, "insert into i2test values ('row 1')");
$r = oci_execute($s);

$s = oci_parse($c, "insert into i2test values ('row 2')");
$r = oci_execute($s, OCI_DEFAULT);

错误处理

$c = oci_connect("hr", "hr", "//localhost/XE");
if (!$c) {
$e = oci_error();  // no resource passed
var_dump($e);
}

$stid = oci_parse($c, "select city from locations");
if (!$stid) {
$e = oci_error($c);   // connection resource passed
var_dump($e);
}

$rc = oci_execute($stid, OCI_DEFAULT);
if (!$rc) {
$e = oci_error($stid);  // statement resource passed
var_dump($e);
}

$rc = oci_fetch_all($stid, $results);
if (!$rc) {
$e = oci_error($stid);  // statement resource passed
var_dump($e);
}

绑定变量

$stid = oci_parse($c,
"select last_name from employees where employee_id = :eidbv");
$myeid = 101;
oci_bind_by_name($stid, ":EIDBV", $myeid);
oci_execute($stid, OCI_DEFAULT);
oci_fetch_all($stid, $res);
echo "Last name is:". $res['LAST_NAME'][0] ."\n";

// No need to re-parse
$myeid = 102;
oci_execute($stid, OCI_DEFAULT);
oci_fetch_all($stid, $res);
echo "Last name is:". $res['LAST_NAME'][0] ."\n";

在某种情况下，您可能决定不使用绑定变量。当语句包含绑定变量时，优化器不知道您最终要使用的值。如果数据很固定，则您可能要对值进行硬编码。但如果数据是由用户输入，确保对其进行处理。

PL/SQL 存储过程

$stid = oci_parse($c, "begin myproc('mydata', 123); end;");
oci_execute($stid, OCI_DEFAULT);

PL/SQL REF CURSOR

CREATE OR REPLACE PACKAGE cv_types AS
TYPE EmpInfoTyp is REF CURSOR;
PROCEDURE EmpInfoRpt (jid IN VARCHAR, emp_cv IN OUT EmpInfoTyp);
END cv_types;
/

CREATE OR REPLACE PACKAGE BODY cv_types AS
PROCEDURE EmpInfoRpt (jid IN VARCHAR, emp_cv IN OUT EmpInfoTyp) AS
BEGIN
OPEN emp_cv FOR SELECT EMPLOYEE_ID, SALARY
FROM EMP_DETAILS_VIEW WHERE JOB_ID=jid;
END;
END;
/

$job_id = 'SA_MAN';
$stmt = "BEGIN cv_types.EmpInfoRpt(:jid, :rc); END;";

$stid = oci_parse($c, $stmt);
oci_bind_by_name($stid, ':jid', $job_id);

$refcur = oci_new_cursor($c); // pass the connection
oci_bind_by_name($stid, ':rc', $refcur, -1, OCI_B_CURSOR);

// Execute the call to EmpInfoRpt()
oci_execute($stid);

// Execute and fetch from the cursor
oci_execute($refcur);
echo '<table border="1">';
while($row = oci_fetch_assoc($refcur)) {
echo '<tr>';
foreach ($row as $c) {
echo "<td>$c</td>";
  }
echo '</tr>';
}
echo '</table>';

大型对象 (LOB)

$myv = 'a very large amount of binary data';

$lob = oci_new_descriptor($c, OCI_D_LOB);
$stid = oci_parse($c,
'INSERT INTO mybtab (blobid, blobdata) '
. 'VALUES(123, EMPTY_BLOB()) RETURNING blobdata INTO :blobdata');
oci_bind_by_name($stid, ':BLOBDATA', $lob, -1, OCI_B_BLOB);
oci_execute($stid, OCI_DEFAULT);

$lob->save($myv);

$query = 'SELECT blobdata FROM mybtab WHERE blobid = 123';

$stmt = oci_parse ($conn, $query);
oci_execute($stmt, OCI_DEFAULT);
$arr = oci_fetch_assoc($stmt);
$result = $arr['BLOBDATA']->load();

$arr['BLOBDATA']->seek(10, OCI_SEEK_SET);
$result = $arr['BLOBDATA']->read(50);

Oracle 集合

SQL> drop table emails;

SQL> create table emails (
user_id       varchar2(10),
friend_name   varchar2(20),
email_address varchar2(20));

SQL> create or replace type email_array as
varray(100) of varchar2(20);
     /

SQL> create or replace type friend_array as
varray(100) of varchar2(20);
     /

SQL> create or replace procedure update_address_book(
p_user_id         in varchar2,
p_friend_name        friend_array,
p_email_addresses    email_array)
is
begin
delete from emails where user_id = p_user_id;
for i in 1 .. p_email_addresses.count loop
insert into emails (user_id, friend_name, email_address)
values (p_user_id, p_friend_name(i),
p_email_addresses(i));
end loop;
end update_address_book;
     /

$user_name      = 'cjones';
$friends_names  = array('alison', 'aslam');
$friends_emails = array('alison@example.com', 'aslam@example.com');

$friend_coll = oci_new_collection($c, 'FRIEND_ARRAY');
$email_coll  = oci_new_collection($c, 'EMAIL_ARRAY');

for ($i=0; $i < count($friends_names); $i++) {
$friend_coll->append($friends_names[$i]);
$email_coll->append($friends_emails[$i]);
}

$stid = oci_parse($c,
"begin update_address_book(:name, :friends, :emails); end;");

oci_bind_by_name($stid, ':name',    $user_name);
oci_bind_by_name($stid, ':friends', $friend_coll, -1, OCI_B_NTY);
oci_bind_by_name($stid, ':emails',  $email_coll,  -1, OCI_B_NTY);

oci_execute($stid);

SQL> drop table mytab;
SQL> create table mytab(name varchar2(20));

SQL> create or replace package mypkg as
type arrtype is table of varchar2(20) index by binary_integer;
procedure myproc(p1 in out arrtype);
end mypkg;
     /

SQL> create or replace package body mypkg as
cursor cur is select name from mytab;
procedure myproc(p1 in out arrtype) is
begin
for i in 1 .. p1.count loop
insert into mytab values (p1(i));
end loop;
end myproc;
end mypkg;
     /

$s = "BEGIN mypkg.myproc(:c1); END;";
$stid = oci_parse($c, $s);

$array = array("abc", "def", "ghi", "jkl", "mno");
oci_bind_array_by_name($stid, ":c1", $array, 5, -1, SQLT_CHR);
oci_execute($stid, OCI_DEFAULT);
oci_commit();

SQL> select * from mytab;

NAME
--------------------
abc
def
ghi
jkl
mno

全球化

<language>_<territory>.<character set>

GERMAN_GERMANY.AL32UTF8

$c = oci_connect("hr", "hr", "//localhost/XE", 'ja16euc');

使用 XML

$query =
'SELECT XMLELEMENT("Employees",
XMLELEMENT("Name", employees.last_name), XMLELEMENT("Id", employees.employee_id)) as result
FROM   employees
WHERE employee_id > 200';

$stid = oci_parse($c, $query);
oci_execute($stid, OCI_DEFAULT);
while ($row = oci_fetch_row($stid))
foreach ($row as $item)
echo htmlentities($item)." ";

$query = "select dbms_xmlgen.getxml('
select first_name
from employees
where department_id = 30') xml
from dual";

$stid = oci_parse($c, $query);
oci_execute($stid, OCI_DEFAULT);
$res = oci_fetch_row($stid);
$mylob = $res[0]->load();       // treat result as a LOB descriptor

<?xml version="1.0"?>
<ROWSET>
<ROW>
<FIRST_NAME>Den</FIRST_NAME>
</ROW>
<ROW>
<FIRST_NAME>Alexander</FIRST_NAME>
</ROW>
<ROW>
<FIRST_NAME>Shelli</FIRST_NAME>
</ROW>
<ROW>
<FIRST_NAME>Sigal</FIRST_NAME>
</ROW>
<ROW>
<FIRST_NAME>Guy</FIRST_NAME>
</ROW>
<ROW>
<FIRST_NAME>Karen</FIRST_NAME>
</ROW>
</ROWSET>

精益求精