<!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>Predefined Constants</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ibase.resources.html">Resource Types</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ref.ibase.html">Firebird/InterBase Functions</a></div>
<div class="up"><a href="book.ibase.html">Firebird/InterBase</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="ibase.constants" class="appendix">
<h1>Predefined Constants</h1>
<p class="simpara">
The constants below are defined by this extension, and
will only be available when the extension has either
been compiled into PHP or dynamically loaded at runtime.
</p>
<p class="para">
The following constants can be passed to <span class="function"><a href="function.ibase-trans.html" class="function">ibase_trans()</a></span>
to specify transaction behaviour.
<table class="doctable table">
<caption><strong>Firebird/InterBase transaction flags</strong></caption>
<thead>
<tr>
<th>Constant</th>
<th>Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>IBASE_DEFAULT</td>
<td>
The default transaction settings are to be used. This default is
determined by the client library, which defines it as
IBASE_WRITE|IBASE_CONCURRENCY|IBASE_WAIT in most cases.</td>
</tr>
<tr>
<td>IBASE_READ</td>
<td>Starts a read-only transaction.</td>
</tr>
<tr>
<td>IBASE_WRITE</td>
<td>Starts a read-write transaction.</td>
</tr>
<tr>
<td>IBASE_CONSISTENCY</td>
<td>Starts a transaction with the isolation level set to
'consistency', which means the transaction cannot read from tables
that are being modified by other concurrent transactions.</td>
</tr>
<tr>
<td>IBASE_CONCURRENCY</td>
<td>Starts a transaction with the isolation level set to
'concurrency' (or 'snapshot'), which means the transaction
has access to all tables, but cannot see changes that were committed
by other transactions after the transaction was started.</td>
</tr>
<tr>
<td>IBASE_COMMITTED</td>
<td>Starts a transaction with the isolation level set to
'read committed'. This flag should be combined with either
<strong><code>IBASE_REC_VERSION</code></strong> or
<strong><code>IBASE_REC_NO_VERSION</code></strong>. This isolation level
allows access to changes that were committed after the transaction
was started. If <strong><code>IBASE_REC_NO_VERSION</code></strong> was
specified, only the latest version of a row can be read. If
<strong><code>IBASE_REC_VERSION</code></strong> was specified, a row can
even be read when a modification to it is pending in a concurrent
transaction.
</td>
</tr>
<tr>
<td>IBASE_WAIT</td>
<td>Indicated that a transaction should wait and retry when a
conflict occurs.</td>
</tr>
<tr>
<td>IBASE_NOWAIT</td>
<td>Indicated that a transaction should fail immediately when a
conflict occurs.</td>
</tr>
</tbody>
</table>
</p>
<p class="para">
The following constants can be passed to <span class="function"><a href="function.ibase-fetch-row.html" class="function">ibase_fetch_row()</a></span>,
<span class="function"><a href="function.ibase-fetch-assoc.html" class="function">ibase_fetch_assoc()</a></span> or <span class="function"><a href="function.ibase-fetch-object.html" class="function">ibase_fetch_object()</a></span>
to specify fetch behaviour.
<table class="doctable table">
<caption><strong>Firebird/InterBase fetch flags</strong></caption>
<thead>
<tr>
<th>Constant</th>
<th>Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>IBASE_FETCH_BLOBS</td>
<td>Also available as <strong><code>IBASE_TEXT</code></strong>for backward
compatibility. Causes BLOB contents to be fetched inline, instead of
being fetched as BLOB identifiers.</td>
</tr>
<tr>
<td>IBASE_FETCH_ARRAYS</td>
<td>Causes arrays to be fetched inline. Otherwise, array
identifiers are returned. Array identifiers can only be used as
arguments to INSERT operations, as no functions to handle array
identifiers are currently available.
</td>
</tr>
<tr>
<td>IBASE_UNIXTIME</td>
<td>Causes date and time fields not to be returned as strings,
but as UNIX timestamps (the number of seconds since the epoch, which
is 1-Jan-1970 0:00 UTC). Might be problematic if used with dates
before 1970 on some systems.
</td>
</tr>
</tbody>
</table>
</p>
<p class="para">
The following constants are used to pass requests and options to the service
API functions ( <span class="function"><a href="function.ibase-server-info.html" class="function">ibase_server_info()</a></span>, <span class="function"><a href="function.ibase-db-info.html" class="function">ibase_db_info()</a></span>,
<span class="function"><a href="function.ibase-backup.html" class="function">ibase_backup()</a></span>, <span class="function"><a href="function.ibase-restore.html" class="function">ibase_restore()</a></span>
and <span class="function"><a href="function.ibase-maintain-db.html" class="function">ibase_maintain_db()</a></span>). Please refer to
the Firebird/InterBase manuals for the meaning of these options.
<dl>
<dt id="constant.ibase-bkp-ignore-checksums">
<span class="term">
<strong><code>IBASE_BKP_IGNORE_CHECKSUMS</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-bkp-ignore-limbo">
<span class="term">
<strong><code>IBASE_BKP_IGNORE_LIMBO</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-bkp-metadata-only">
<span class="term">
<strong><code>IBASE_BKP_METADATA_ONLY</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-bkp-no-garbage-collect">
<span class="term">
<strong><code>IBASE_BKP_NO_GARBAGE_COLLECT</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-bkp-old-descriptions">
<span class="term">
<strong><code>IBASE_BKP_OLD_DESCRIPTIONS</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-bkp-non-transportable">
<span class="term">
<strong><code>IBASE_BKP_NON_TRANSPORTABLE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-bkp-convert">
<span class="term">
<strong><code>IBASE_BKP_CONVERT</code></strong>
</span>
<dd>
<span class="simpara">
Options to <span class="function"><a href="function.ibase-backup.html" class="function">ibase_backup()</a></span>
</span>
</dd>
</dt>
<dt id="constant.ibase-res-deactivate-idx">
<span class="term">
<strong><code>IBASE_RES_DEACTIVATE_IDX</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-res-no-shadow">
<span class="term">
<strong><code>IBASE_RES_NO_SHADOW</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-res-no-validity">
<span class="term">
<strong><code>IBASE_RES_NO_VALIDITY</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-res-one-at-a-time">
<span class="term">
<strong><code>IBASE_RES_ONE_AT_A_TIME</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-res-replace">
<span class="term">
<strong><code>IBASE_RES_REPLACE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-res-create">
<span class="term">
<strong><code>IBASE_RES_CREATE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-res-use-all-space">
<span class="term">
<strong><code>IBASE_RES_USE_ALL_SPACE</code></strong>
</span>
<dd>
<span class="simpara">
Options to <span class="function"><a href="function.ibase-restore.html" class="function">ibase_restore()</a></span>
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-page-buffers">
<span class="term">
<strong><code>IBASE_PRP_PAGE_BUFFERS</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-sweep-interval">
<span class="term">
<strong><code>IBASE_PRP_SWEEP_INTERVAL</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-shutdown-db">
<span class="term">
<strong><code>IBASE_PRP_SHUTDOWN_DB</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-deny-new-transactions">
<span class="term">
<strong><code>IBASE_PRP_DENY_NEW_TRANSACTIONS</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-deny-new-attachments">
<span class="term">
<strong><code>IBASE_PRP_DENY_NEW_ATTACHMENTS</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-reserve-space">
<span class="term">
<strong><code>IBASE_PRP_RESERVE_SPACE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-res-use-full">
<span class="term">
<strong><code>IBASE_PRP_RES_USE_FULL</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-res">
<span class="term">
<strong><code>IBASE_PRP_RES</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-write-mode">
<span class="term">
<strong><code>IBASE_PRP_WRITE_MODE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-wm-async">
<span class="term">
<strong><code>IBASE_PRP_WM_ASYNC</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-wm-sync">
<span class="term">
<strong><code>IBASE_PRP_WM_SYNC</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-access-mode">
<span class="term">
<strong><code>IBASE_PRP_ACCESS_MODE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-am-readonly">
<span class="term">
<strong><code>IBASE_PRP_AM_READONLY</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-am-readwrite">
<span class="term">
<strong><code>IBASE_PRP_AM_READWRITE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-set-sql-dialect">
<span class="term">
<strong><code>IBASE_PRP_SET_SQL_DIALECT</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-activate">
<span class="term">
<strong><code>IBASE_PRP_ACTIVATE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-prp-db-online">
<span class="term">
<strong><code>IBASE_PRP_DB_ONLINE</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-check-db">
<span class="term">
<strong><code>IBASE_RPR_CHECK_DB</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-ignore-checksum">
<span class="term">
<strong><code>IBASE_RPR_IGNORE_CHECKSUM</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-kill-shadows">
<span class="term">
<strong><code>IBASE_RPR_KILL_SHADOWS</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-mend-db">
<span class="term">
<strong><code>IBASE_RPR_MEND_DB</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-validate-db">
<span class="term">
<strong><code>IBASE_RPR_VALIDATE_DB</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-full">
<span class="term">
<strong><code>IBASE_RPR_FULL</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-rpr-sweep-db">
<span class="term">
<strong><code>IBASE_RPR_SWEEP_DB</code></strong>
</span>
<dd>
<span class="simpara">
Options to <span class="function"><a href="function.ibase-maintain-db.html" class="function">ibase_maintain_db()</a></span>
</span>
</dd>
</dt>
<dt id="constant.ibase-sts-data-pages">
<span class="term">
<strong><code>IBASE_STS_DATA_PAGES</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-sts-db-log">
<span class="term">
<strong><code>IBASE_STS_DB_LOG</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-sts-hdr-pages">
<span class="term">
<strong><code>IBASE_STS_HDR_PAGES</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-sts-idx-pages">
<span class="term">
<strong><code>IBASE_STS_IDX_PAGES</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-sts-sys-relations">
<span class="term">
<strong><code>IBASE_STS_SYS_RELATIONS</code></strong>
</span>
<dd>
<span class="simpara">
Options to <span class="function"><a href="function.ibase-db-info.html" class="function">ibase_db_info()</a></span>
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-server-version">
<span class="term">
<strong><code>IBASE_SVC_SERVER_VERSION</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-implementation">
<span class="term">
<strong><code>IBASE_SVC_IMPLEMENTATION</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-get-env">
<span class="term">
<strong><code>IBASE_SVC_GET_ENV</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-get-env-lock">
<span class="term">
<strong><code>IBASE_SVC_GET_ENV_LOCK</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-get-env-msg">
<span class="term">
<strong><code>IBASE_SVC_GET_ENV_MSG</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-user-dbpath">
<span class="term">
<strong><code>IBASE_SVC_USER_DBPATH</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-svr-db-info">
<span class="term">
<strong><code>IBASE_SVC_SVR_DB_INFO</code></strong>
</span>
<dd>
<span class="simpara">
</span>
</dd>
</dt>
<dt id="constant.ibase-svc-get-users">
<span class="term">
<strong><code>IBASE_SVC_GET_USERS</code></strong>
</span>
<dd>
<span class="simpara">
Options to <span class="function"><a href="function.ibase-server-info.html" class="function">ibase_server_info()</a></span>
</span>
</dd>
</dt>
</dl>
</p>
</div>
<hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ibase.resources.html">Resource Types</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ref.ibase.html">Firebird/InterBase Functions</a></div>
<div class="up"><a href="book.ibase.html">Firebird/InterBase</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
