mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-18 13:57:03 +08:00
773 lines
67 KiB
HTML
773 lines
67 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
||
<title>Set options for connection or statement resources</title>
|
||
</head>
|
||
<body class="docs"><div id="layout">
|
||
<div id="layout-content"><div id="function.db2-set-option" class="refentry">
|
||
<div class="refnamediv">
|
||
<h1 class="refname">db2_set_option</h1>
|
||
<p class="verinfo">(PECL ibm_db2 >= 1.0.0)</p><p class="refpurpose"><span class="refname">db2_set_option</span> — <span class="dc-title">Set options for connection or statement resources</span></p>
|
||
|
||
</div>
|
||
<div class="refsect1 description" id="refsect1-function.db2-set-option-description">
|
||
<h3 class="title">说明</h3>
|
||
<div class="methodsynopsis dc-description">
|
||
<span class="methodname"><strong>db2_set_option</strong></span>
|
||
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$resource</code></span>
|
||
, <span class="methodparam"><span class="type">array</span> <code class="parameter">$options</code></span>
|
||
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$type</code></span>
|
||
) : <span class="type">bool</span></div>
|
||
|
||
<p class="para rdfs-comment">
|
||
Sets options for a statement resource or a connection resource. You
|
||
cannot set options for result set resources.
|
||
</p>
|
||
</div>
|
||
|
||
<div class="refsect1 parameters" id="refsect1-function.db2-set-option-parameters">
|
||
<h3 class="title">参数</h3>
|
||
<p class="para">
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">resource</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
A valid statement resource as returned from
|
||
<span class="function"><a href="db2_prepare.html" class="function">db2_prepare()</a></span> or a valid connection resource as
|
||
returned from <span class="function"><a href="db2_connect.html" class="function">db2_connect()</a></span> or
|
||
<span class="function"><a href="db2_pconnect.html" class="function">db2_pconnect()</a></span>.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">options</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
An associative array containing valid statement or connection
|
||
options. This parameter can be used to change autocommit values,
|
||
cursor types (scrollable or forward), and to specify the case of
|
||
the column names (lower, upper, or natural) that will appear in a
|
||
result set.
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">autocommit</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
Passing <em>DB2_AUTOCOMMIT_ON</em> turns
|
||
autocommit on for the specified connection resource.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_AUTOCOMMIT_OFF</em> turns
|
||
autocommit off for the specified connection resource.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">cursor</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
Passing <em>DB2_FORWARD_ONLY</em> specifies a
|
||
forward-only cursor for a statement resource. This is the
|
||
default cursor type, and is supported by all database
|
||
servers.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_SCROLLABLE</em> specifies a
|
||
scrollable cursor for a statement resource. Scrollable
|
||
cursors enable result set rows to be accessed in
|
||
non-sequential order, but are only supported by
|
||
IBM DB2 Universal Database databases.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">binmode</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
Passing <em>DB2_BINARY</em> specifies that
|
||
binary data will be returned as is. This is the default
|
||
mode. This is the equivalent of setting
|
||
<em>ibm_db2.binmode=1</em> in <var class="filename">php.ini</var>.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_CONVERT</em> specifies that
|
||
binary data will be converted to hexadecimal encoding,
|
||
and will be returned as such. This is the equivalent of
|
||
setting <em>ibm_db2.binmode=2</em> in <var class="filename">php.ini</var>.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_PASSTHRU</em> specifies that
|
||
binary data will be converted to <strong><code>NULL</code></strong>. This is the
|
||
equivalent of setting <em>ibm_db2.binmode=3</em>
|
||
in <var class="filename">php.ini</var>.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">db2_attr_case</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
Passing <em>DB2_CASE_LOWER</em> specifies that
|
||
column names of the result set are returned in lower case.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_CASE_UPPER</em> specifies that
|
||
column names of the result set are returned in upper case.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_CASE_NATURAL</em> specifies that
|
||
column names of the result set are returned in natural
|
||
case.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">deferred_prepare</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
Passing <em>DB2_DEFERRED_PREPARE_ON</em> turns deferred
|
||
prepare on for the specified statement resource.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>DB2_DEFERRED_PREPARE_OFF</em> turns deferred
|
||
prepare off for the specified statement resource.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
<p class="para">
|
||
The following new i5/OS options are available in ibm_db2 version 1.5.1
|
||
and later. These options apply only when running PHP and ibm_db2 natively on i5 systems.
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">i5_fetch_only</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<em>DB2_I5_FETCH_ON</em> - Cursors are read-only
|
||
and cannot be used for positioned updates or deletes. This
|
||
is the default unless <em>SQL_ATTR_FOR_FETCH_ONLY</em>
|
||
environment has been set to <em>SQL_FALSE</em>.
|
||
</p>
|
||
<p class="para">
|
||
<em>DB2_I5_FETCH_OFF</em> - Cursors can be used
|
||
for positioned updates and deletes.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
<p class="para">
|
||
The following new option is available in ibm_db2 version 1.8.0 and later.
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">rowcount</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<em>DB2_ROWCOUNT_PREFETCH_ON</em> - Client can request
|
||
the full row count prior to fetching, which means that
|
||
<span class="function"><a href="db2_num_rows.html" class="function">db2_num_rows()</a></span> returns the number of rows selected
|
||
even when a <em>ROLLFORWARD_ONLY</em> cursor is used.
|
||
</p>
|
||
<p class="para">
|
||
<em>DB2_ROWCOUNT_PREFETCH_OFF</em> - Client cannot request
|
||
the full row count prior to fetching.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
<p class="para">
|
||
The following new options are available in ibm_db2 version 1.7.0 and later.
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">trusted_user</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
To switch the user to a trusted user, pass the User ID (String)
|
||
of the trusted user as the value of this key. This option can
|
||
be set on a connection resource only. To use this option, trusted
|
||
context must be enabled on the connection resource.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">trusted_password</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
The password (String) that corresponds to the user specified
|
||
by the trusted_user key.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
<p class="para">
|
||
The following new options are available in ibm_db2 version 1.6.0 and later.
|
||
These options provide useful tracking information that can be accessed during
|
||
execution with <span class="function"><a href="db2_get_option.html" class="function">db2_get_option()</a></span>.
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
When the value in each option is being set, some servers might not handle
|
||
the entire length provided and might truncate the value.
|
||
</p>
|
||
<p class="para">
|
||
To ensure that the data specified in each option is converted correctly
|
||
when transmitted to a host system, use only the characters A through Z,
|
||
0 through 9, and the underscore (_) or period (.).
|
||
</p>
|
||
</p></blockquote>
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">userid</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<em>SQL_ATTR_INFO_USERID</em> - A pointer to a null-terminated
|
||
character string used to identify the client user ID sent to the host
|
||
database server when using DB2 Connect.
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
DB2 for z/OS and OS/390 servers support up to a length of 16 characters.
|
||
This user-id is not to be confused with the authentication user-id, it is for
|
||
identification purposes only and is not used for any authorization.
|
||
</p>
|
||
</p></blockquote>
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">acctstr</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<em>SQL_ATTR_INFO_ACCTSTR</em> - A pointer to a null-terminated
|
||
character string used to identify the client accounting string sent to the
|
||
host database server when using DB2 Connect.
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
DB2 for z/OS and OS/390 servers support up to a length of 200 characters.
|
||
</p>
|
||
</p></blockquote>
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">applname</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<em>SQL_ATTR_INFO_APPLNAME</em> - A pointer to a null-terminated
|
||
character string used to identify the client application name sent to the
|
||
host database server when using DB2 Connect.
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
DB2 for z/OS and OS/390 servers support up to a length of 32 characters.
|
||
</p>
|
||
</p></blockquote>
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">wrkstnname</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<em>SQL_ATTR_INFO_WRKSTNNAME</em> - A pointer to a null-terminated
|
||
character string used to identify the client workstation name sent to the
|
||
host database server when using DB2 Connect.
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
DB2 for z/OS and OS/390 servers support up to a length of 18 characters.
|
||
</p>
|
||
</p></blockquote>
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">type</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
An integer value that specifies the type of resource that was
|
||
passed into the function. The type of resource and this value
|
||
must correspond.
|
||
</p>
|
||
<p class="para">
|
||
Passing <em>1</em> as the value specifies that
|
||
a connection resource has been passed into the function.
|
||
</p>
|
||
<p class="para">
|
||
Passing any integer not equal to <em>1</em> as
|
||
the value specifies that a statement resource has been
|
||
passed into the function.
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
<p class="para">
|
||
</p>
|
||
<p class="para">
|
||
The following table specifies which options are compatible with
|
||
the available resource types:
|
||
<table class="doctable table">
|
||
<caption><strong>Resource-Parameter Matrix</strong></caption>
|
||
|
||
<col style="text-align: center;" />
|
||
<col style="text-align: center;" />
|
||
<col style="text-align: center;" />
|
||
<col style="text-align: center;" />
|
||
<col style="text-align: center;" />
|
||
|
||
<thead>
|
||
<tr>
|
||
<th>Key</th>
|
||
<th>Value</th>
|
||
<th colspan="3">Resource Type</th>
|
||
</tr>
|
||
|
||
</thead>
|
||
|
||
|
||
<tbody class="tbody">
|
||
<tr>
|
||
<td class="empty"> </td><td class="empty"> </td><td>Connection</td>
|
||
<td>Statement</td>
|
||
<td>Result Set</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>autocommit</td>
|
||
<td><em>DB2_AUTOCOMMIT_ON</em></td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>autocommit</td>
|
||
<td><em>DB2_AUTOCOMMIT_OFF</em></td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>cursor</td>
|
||
<td><em>DB2_SCROLLABLE</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>cursor</td>
|
||
<td><em>DB2_FORWARD_ONLY</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>binmode</td>
|
||
<td><em>DB2_BINARY</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>binmode</td>
|
||
<td><em>DB2_CONVERT</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>binmode</td>
|
||
<td><em>DB2_PASSTHRU</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>db2_attr_case</td>
|
||
<td><em>DB2_CASE_LOWER</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>db2_attr_case</td>
|
||
<td><em>DB2_CASE_UPPER</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>db2_attr_case</td>
|
||
<td><em>DB2_CASE_NATURAL</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>deferred_prepare</td>
|
||
<td><em>DB2_DEFERRED_PREPARE_ON</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>deferred_prepare</td>
|
||
<td><em>DB2_DEFERRED_PREPARE_OFF</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>i5_fetch_only</td>
|
||
<td><em>DB2_I5_FETCH_ON</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>i5_fetch_only</td>
|
||
<td><em>DB2_I5_FETCH_OFF</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>rowcount</td>
|
||
<td><em>DB2_ROWCOUNT_PREFETCH_ON</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>rowcount</td>
|
||
<td><em>DB2_ROWCOUNT_PREFETCH_OFF</em></td>
|
||
<td>-</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>trusted_user</td>
|
||
<td><em><USER NAME> (String)</em></td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>trusted_password</td>
|
||
<td><em><PASSWORD> (String)</em></td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>userid</td>
|
||
<td><em>SQL_ATTR_INFO_USERID</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>acctstr</td>
|
||
<td><em>SQL_ATTR_INFO_ACCTSTR</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>applname</td>
|
||
<td><em>SQL_ATTR_INFO_APPLNAME</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>wrkstnname</td>
|
||
<td><em>SQL_ATTR_INFO_WRKSTNNAME</em></td>
|
||
<td>X</td>
|
||
<td>X</td>
|
||
<td>-</td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
|
||
</table>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 returnvalues" id="refsect1-function.db2-set-option-returnvalues">
|
||
<h3 class="title">返回值</h3>
|
||
<p class="para">
|
||
成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
|
||
|
||
<div class="refsect1 examples" id="refsect1-function.db2-set-option-examples">
|
||
<h3 class="title">范例</h3>
|
||
<p class="para">
|
||
|
||
<div class="example" id="example-1274">
|
||
<p><strong>Example #1 Setting one parameter with a connection resource</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'autocommit' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_AUTOCOMMIT_ON</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the correct resource, options array, and type values */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Check if all options could be set correctly */<br /></span><span style="color: #007700">if(</span><span style="color: #0000BB">$result</span><span style="color: #007700">)<br />{<br /> echo </span><span style="color: #DD0000">'Options Set Successfully'</span><span style="color: #007700">;<br />}<br />else<br />{<br /> echo </span><span style="color: #DD0000">'Could Not Set Options'</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Options Set Successfully</pre></div></div>
|
||
</div>
|
||
|
||
<div class="example" id="example-1275">
|
||
<p><strong>Example #2 Setting multiple parameters with a connection resource</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'autocommit' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_AUTOCOMMIT_OFF</span><span style="color: #007700">, <br /> </span><span style="color: #DD0000">'binmode' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_PASSTHRU</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'db2_attr_case' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_CASE_UPPER</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'cursor' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_SCROLLABLE</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the correct resource, options array, and type values */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Check if all options could be set correctly */<br /></span><span style="color: #007700">if(</span><span style="color: #0000BB">$result</span><span style="color: #007700">)<br />{<br /> echo </span><span style="color: #DD0000">'Options Set Successfully'</span><span style="color: #007700">;<br />}<br />else<br />{<br /> echo </span><span style="color: #DD0000">'Could Not Set Options'</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Options Set Successfully</pre></div></div>
|
||
</div>
|
||
|
||
|
||
<div class="example" id="db2-last-insert-id.example.basic">
|
||
<p><strong>Example #3 Setting multiple parameters with an invalid key</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'autocommit' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_AUTOCOMMIT_OFF</span><span style="color: #007700">, <br /> </span><span style="color: #DD0000">'MY_INVALID_KEY' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_PASSTHRU</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'db2_attr_case' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_CASE_UPPER</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'cursor' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_SCROLLABLE</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the correct resource, options array, and type values */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Check if all options could be set correctly */<br /></span><span style="color: #007700">if(</span><span style="color: #0000BB">$result</span><span style="color: #007700">)<br />{<br /> echo </span><span style="color: #DD0000">'Options Set Successfully'</span><span style="color: #007700">;<br />}<br />else<br />{<br /> echo </span><span style="color: #DD0000">'Could Not Set Options'</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Could Not Set Options</pre></div></div>
|
||
</div>
|
||
|
||
|
||
<div class="example" id="example-1277">
|
||
<p><strong>Example #4 Setting multiple parameters with an invalid value</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'autocommit' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_AUTOCOMMIT_OFF</span><span style="color: #007700">, <br /> </span><span style="color: #DD0000">'binmode' </span><span style="color: #007700">=> </span><span style="color: #DD0000">'INVALID_VALUE'</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'db2_attr_case' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_CASE_UPPER</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'cursor' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_SCROLLABLE</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the correct resource, options array, and type values */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Check if all options could be set correctly */<br /></span><span style="color: #007700">if(</span><span style="color: #0000BB">$result</span><span style="color: #007700">)<br />{<br /> echo </span><span style="color: #DD0000">'Options Set Successfully'</span><span style="color: #007700">;<br />}<br />else<br />{<br /> echo </span><span style="color: #DD0000">'Could Not Set Options'</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Could Not Set Options</pre></div></div>
|
||
</div>
|
||
|
||
<div class="example" id="example-1278">
|
||
<p><strong>Example #5 Setting multiple parameters with a connection resource and the wrong type</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'autocommit' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_AUTOCOMMIT_OFF</span><span style="color: #007700">, <br /> </span><span style="color: #DD0000">'binmode' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_PASSTHRU</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'db2_attr_case' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_CASE_UPPER</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'cursor' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_SCROLLABLE</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the correct resource, options array, and the wrong type value */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Check if all options could be set correctly */<br /></span><span style="color: #007700">if(</span><span style="color: #0000BB">$result</span><span style="color: #007700">)<br />{<br /> echo </span><span style="color: #DD0000">'Options Set Successfully'</span><span style="color: #007700">;<br />}<br />else<br />{<br /> echo </span><span style="color: #DD0000">'Could Not Set Options'</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Could Not Set Options</pre></div></div>
|
||
</div>
|
||
|
||
<div class="example" id="example-1279">
|
||
<p><strong>Example #6 Setting multiple parameters with the wrong resource</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'autocommit' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_AUTOCOMMIT_OFF</span><span style="color: #007700">, <br /> </span><span style="color: #DD0000">'binmode' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_PASSTHRU</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'db2_attr_case' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_CASE_UPPER</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'cursor' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_SCROLLABLE</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_prepare</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #DD0000">'SELECT * FROM EMPLOYEE'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the wrong resource, and the correct options array, and type values */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Check if all options could be set correctly */<br /></span><span style="color: #007700">if(</span><span style="color: #0000BB">$result</span><span style="color: #007700">)<br />{<br /> echo </span><span style="color: #DD0000">'Options Set Successfully'</span><span style="color: #007700">;<br />}<br />else<br />{<br /> echo </span><span style="color: #DD0000">'Could Not Set Options'</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Could Not Set Options</pre></div></div>
|
||
</div>
|
||
|
||
<div class="example" id="db2-pclose.example.basic">
|
||
<p><strong>Example #7 Putting it all together</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Database Connection Parameters */<br /></span><span style="color: #0000BB">$database </span><span style="color: #007700">= </span><span style="color: #DD0000">'SAMPLE'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$hostname </span><span style="color: #007700">= </span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$port </span><span style="color: #007700">= </span><span style="color: #0000BB">50000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$protocol </span><span style="color: #007700">= </span><span style="color: #DD0000">'TCPIP'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$username </span><span style="color: #007700">= </span><span style="color: #DD0000">'db2inst1'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$password </span><span style="color: #007700">= </span><span style="color: #DD0000">'ibmdb2'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Connection String */<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">= </span><span style="color: #DD0000">"DRIVER={IBM DB2 ODBC DRIVER};DATABASE=</span><span style="color: #0000BB">$database</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"HOSTNAME=</span><span style="color: #0000BB">$hostname</span><span style="color: #DD0000">;PORT=</span><span style="color: #0000BB">$port</span><span style="color: #DD0000">;PROTOCOL=</span><span style="color: #0000BB">$protocol</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$conn_string </span><span style="color: #007700">.= </span><span style="color: #DD0000">"UID=</span><span style="color: #0000BB">$username</span><span style="color: #DD0000">;PWD=</span><span style="color: #0000BB">$password</span><span style="color: #DD0000">;"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* Obtain Connection Resource */<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_string</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">, </span><span style="color: #DD0000">''</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Create the associative options array with valid key-value pairs */<br /></span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'db2_attr_case' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_CASE_LOWER</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'cursor' </span><span style="color: #007700">=> </span><span style="color: #0000BB">DB2_SCROLLABLE</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_prepare</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #DD0000">'SELECT * FROM EMPLOYEE WHERE EMPNO = ? OR EMPNO = ?'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Call the function using the correct resource, options array, and type values */<br /></span><span style="color: #0000BB">$option_result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">$options</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, array(</span><span style="color: #DD0000">'000130'</span><span style="color: #007700">, </span><span style="color: #DD0000">'000140'</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/* Get Row 2 before Row 1 since Scrollable Cursor */<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">db2_fetch_assoc</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">));<br />print </span><span style="color: #DD0000">'<br /><br />'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">db2_fetch_assoc</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">));<br /><br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen"><div class="cdata"><pre>Array
|
||
(
|
||
[empno] => 000140
|
||
[firstnme] => HEATHER
|
||
[midinit] => A
|
||
[lastname] => NICHOLLS
|
||
[workdept] => C01
|
||
[phoneno] => 1793
|
||
[hiredate] => 1976-12-15
|
||
[job] => ANALYST
|
||
[edlevel] => 18
|
||
[sex] => F
|
||
[birthdate] => 1946-01-19
|
||
[salary] => 28420.00
|
||
[bonus] => 600.00
|
||
[comm] => 2274.00
|
||
)
|
||
|
||
Array
|
||
(
|
||
[empno] => 000130
|
||
[firstnme] => DELORES
|
||
[midinit] => M
|
||
[lastname] => QUINTANA
|
||
[workdept] => C01
|
||
[phoneno] => 4578
|
||
[hiredate] => 1971-07-28
|
||
[job] => ANALYST
|
||
[edlevel] => 16
|
||
[sex] => F
|
||
[birthdate] => 1925-09-15
|
||
[salary] => 23800.00
|
||
[bonus] => 500.00
|
||
[comm] => 1904.00
|
||
)</pre></div></div>
|
||
</div>
|
||
<div class="example" id="example-1281">
|
||
<p><strong>Example #8 i5/OS cursors are read-only</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /> $conn </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">""</span><span style="color: #007700">, </span><span style="color: #DD0000">""</span><span style="color: #007700">, </span><span style="color: #DD0000">""</span><span style="color: #007700">, array(</span><span style="color: #DD0000">"i5_lib"</span><span style="color: #007700">=></span><span style="color: #DD0000">"nobody"</span><span style="color: #007700">));<br /> </span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_prepare</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #DD0000">'select * from names where first = ?'</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$name </span><span style="color: #007700">= </span><span style="color: #DD0000">"first2"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">db2_bind_param</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #DD0000">"name"</span><span style="color: #007700">, </span><span style="color: #0000BB">DB2_PARAM_IN</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$options </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"i5_fetch_only"</span><span style="color: #007700">=></span><span style="color: #0000BB">DB2_I5_FETCH_ON</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">db2_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">,</span><span style="color: #0000BB">$options</span><span style="color: #007700">,</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /> if (</span><span style="color: #0000BB">db2_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">)) {<br /> while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">db2_fetch_array</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">"</span><span style="color: #007700">{</span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]}</span><span style="color: #DD0000"> </span><span style="color: #007700">{</span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]}</span><span style="color: #DD0000">"</span><span style="color: #007700">;<br /> }<br /> }<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
<div class="example-contents"><p>以上例程会输出：</p></div>
|
||
<div class="example-contents screen">
|
||
<div class="cdata"><pre>
|
||
first2 last2
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
</p>
|
||
</div>
|
||
|
||
<div class="refsect1 seealso" id="refsect1-function.db2-set-option-seealso">
|
||
<h3 class="title">参见</h3>
|
||
<p class="para">
|
||
<ul class="simplelist">
|
||
<li class="member"><span class="function"><a href="db2_connect.html" class="function" rel="rdfs-seeAlso">db2_connect()</a> - Returns a connection to a database</span></li>
|
||
<li class="member"><span class="function"><a href="db2_pconnect.html" class="function" rel="rdfs-seeAlso">db2_pconnect()</a> - Returns a persistent connection to a database</span></li>
|
||
<li class="member"><span class="function"><a href="db2_exec.html" class="function" rel="rdfs-seeAlso">db2_exec()</a> - Executes an SQL statement directly</span></li>
|
||
<li class="member"><span class="function"><a href="db2_prepare.html" class="function" rel="rdfs-seeAlso">db2_prepare()</a> - Prepares an SQL statement to be executed</span></li>
|
||
<li class="member"><span class="function"><a href="db2_cursor_type.html" class="function" rel="rdfs-seeAlso">db2_cursor_type()</a> - Returns the cursor type used by a statement resource</span></li>
|
||
</ul>
|
||
</p>
|
||
</div>
|
||
|
||
</div></div></div></body></html> |