oci_fetch_all クエリからの複数の行を二次元配列に取得する &reftitle.description; intoci_fetch_all resourcestatement arrayoutput intoffset0 intlimit-1 intflagsOCI_FETCHSTATEMENT_BY_COLUMN | OCI_ASSOC クエリからの複数の行を二次元配列に取得します。 デフォルトでは、すべての行を返します。 この関数は、クエリを oci_execute で実行した後でのみコールすることができます。 &reftitle.parameters; statement &oci.arg.statement.id; output 返された行を格納する変数。 LOB 列は文字列として返されます。 Oracle は変換をサポートしています。 データや型の取得についての詳細な情報は oci_fetch_array を参照ください。 offset 結果を取得する際に無視する行数 (デフォルトの値は 0 で、最初の行から開始されます)。 limit 読み込む行数。デフォルトは -1 で、これは offset + 1 番目の行以降のすべての行を意味します。 flags パラメータ flags は、 配列の構造をあらわし、また連想配列を使うかどうかもあらわします。 定数 説明 OCI_FETCHSTATEMENT_BY_ROW 配列の配列で、内側の配列はクエリの行単位となります。 OCI_FETCHSTATEMENT_BY_COLUMN 配列の配列で、内側の配列はクエリの列単位となります。 これがデフォルトです。 配列のインデックスには、カラム名あるいは数値を使うことができます。 結果は、どれか一つのモードでだけ返されます。 定数 説明 OCI_NUM 各列の配列に数値添字を使います。 OCI_ASSOC 各カラムを連想配列にします。 これがデフォルトです。 加算演算子 "+" を使って、 配列の構造とインデックス形式の組み合わせを選択します。 Oracle のデフォルトである大文字小文字を区別しないカラム名の場合は、 配列のキーは大文字となります。大文字小文字を区別するカラム名の場合は、 配列のキーの大文字小文字は実際のカラム名と同じになります。 var_dump で output を確認し、大文字小文字を適切に指定するようにしましょう。 同じ名前のカラムが複数あるクエリでは、カラムの別名を使わなければなりません。 そうしないと、連想配列にあらわれるのはその中の一つのカラムだけとなってしまいます。 &reftitle.returnvalues; output の行数を返します。 これは 0 以上の値となります。 &reftitle.examples; \n"; var_dump($res); // var_dump 出力は // 2 rows fetched // array(2) { // ["POSTAL_CODE"]=> // array(2) { // [0]=> // string(6) "00989x" // [1]=> // string(6) "10934x" // } // ["CITY"]=> // array(2) { // [0]=> // string(4) "Roma" // [1]=> // string(6) "Venice" // } // } // 結果を見やすく表示します echo "\n"; foreach ($res as $col) { echo "\n"; foreach ($col as $item) { echo " \n"; } echo "\n"; } echo "

".($item !== null ? htmlentities($item, ENT_QUOTES) : "")."

\n"; oci_free_statement($stid); oci_close($conn); ?> ]]> \n"; var_dump($res); // 出力は // 2 rows fetched // array(2) { // [0]=> // array(2) { // ["POSTAL_CODE"]=> // string(6) "00989x" // ["CITY"]=> // string(4) "Roma" // } // [1]=> // array(2) { // ["POSTAL_CODE"]=> // string(6) "10934x" // ["CITY"]=> // string(6) "Venice" // } // } oci_free_statement($stid); oci_close($conn); ?> ]]> \n"; var_dump($res); // 出力は // 2 rows fetched // array(2) { // [0]=> // array(2) { // [0]=> // string(6) "00989x" // [1]=> // string(4) "Roma" // } // [1]=> // array(2) { // [0]=> // string(6) "10934x" // [1]=> // string(6) "Venice" // } // } oci_free_statement($stid); oci_close($conn); ?> ]]> &reftitle.notes; offset を使うのは、非常に非効率的です。 読み飛ばす行もすべて PHP がデータベースから受け取る結果セットに含まれ、 そのあとで読み飛ばす部分が捨てられます。 それよりは、SQL を使って取得開始位置と取得範囲をはじめから指定した方がより効率的です。 oci_fetch_array の例を参照ください。 大量の行を返すクエリでは、oci_fetch_array のような単一行の取得関数を使ったほうがメモリを浪費せずに済みます。 &oci.use.setprefetch; Oracle Database 12c の暗黙の結果セットからの行は返しません。 代わりに oci_fetch_array を使いましょう。 &reftitle.seealso; oci_fetch oci_fetch_array oci_fetch_assoc oci_fetch_object oci_fetch_row oci_set_prefetch