(PHP 4)
ocidefinebyname — oci_define_by_name() のエイリアス

説明

この関数は次の関数のエイリアスです。 oci_define_by_name().

(PHP 5)
oci_define_by_name — SELECT 実行中、定義用の PHP 変数を使用する

説明

bool oci_define_by_name ( resource statement, string column_name, mixed &variable [, int type] )
oci_define_by_name() は、SQL カラムをフェッチするための PHP 変数を定義します。 Oracle は、全ての大文字のカラム名を使用しますが、 select の中で小文字も書くことが可能であることを考慮してください。 oci_define_by_name() は、 column_name が大文字であることを仮定します。 select 文にない変数を定義する場合は、エラーは発生しません。
抽象 Datatype (LOB/ROWID/BFILE) を定義する必要がある場合、 まず oci_new_descriptor() 関数を用いてその 領域を確保しなければなりません。 oci_bind_by_name() 関数も参照ください。
例 1529. oci_define_by_name() の例
<?php
/* oci_define_by_name の例 - thies at thieso dot net (980219) */

$conn = oci_connect("scott", "tiger");

$stmt = oci_parse($conn, "SELECT empno, ename FROM emp");

/* 定義は oci_execute の前に行われなければなりません! */

oci_define_by_name($stmt, "EMPNO", $empno);
oci_define_by_name($stmt, "ENAME", $ename);

oci_execute($stmt);

while (oci_fetch($stmt)) {
   echo "empno:" . $empno . "\n";
   echo "ename:" . $ename . "\n";
}

oci_free_statement($stmt);
oci_close($conn);
?>
注意: PHP バージョン 5.0.0 以前では、代わりに ocidefinebyname() を使用しなければなりません。 まだこの名前を使用することができ、下位互換性のため oci_define_by_name() への別名として残されていますが、 推奨されません。