oci_bind_by_name

(PHP 5)

oci_bind_by_name --  Привязывает переменную PHP к соответствующей метке в SQL-выражении.

Описание

bool oci_bind_by_name ( resource stmt, string ph_name, mixed &variable [, int maxlength [, int type]] )

oci_bind_by_name() привязывает переменную variable к метке ph_name. Будет ли она использоваться для вывода или ввода - выяснится в процессе выполнения и необходимые ресурсы будут выделены по необходимости. Параметр length устанавливает максимальный объем в байтах получаемой переменной. Если параметр length равен -1, то oci_bind_by_name() будет использовать текущую длину variable как максимальную.

Если вы хотите привязать абстрактный тип данных (LOB/ROWID/BFILE), то вам необходимо сначала создать дескриптор с помощью oci_new_descriptor(). Параметр length не используется с абстрактными типами данных и должен быть равен -1. Параметр type говорит Oracle, какой тип дескриптора мы хотим использовать. Возможные значения этого параметра:

  • OCI_B_FILE - для BFILE;

  • OCI_B_CFILE - для CFILE;

  • OCI_B_CLOB - для CLOB;

  • OCI_B_BLOB - для BLOB;

  • OCI_B_ROWID - для ROWID;

  • OCI_B_NTY - для именованных типов данных;

  • OCI_B_CURSOR - для курсоров, созданных ранее с помощью oci_new_cursor().

Пример 1. Пример использования oci_bind_by_name()

<?php
/* oci_bind_by_name example thies at thieso dot net (980221)
  inserts 3 records into emp, and uses the ROWID for updating the
  records just after the insert.
*/

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

$stmt = oci_parse($conn, "
                         INSERT INTO
                                     emp (empno, ename)
                   VALUES
                                     (:empno,:ename)
                           RETURNING
                                     ROWID
                                 INTO
                                     :rid
                                         ");

$data = array(
             1111 => "Larry",
             2222 => "Bill",
             3333 => "Jim"
             );

$rowid = oci_new_descriptor($conn, OCI_D_ROWID);

oci_bind_by_name($stmt, ":empno", $empno, 32);
oci_bind_by_name($stmt, ":ename", $ename, 32);
oci_bind_by_name($stmt, ":rid",  $rowid, -1, OCI_B_ROWID);

$update = oci_parse($conn, "
                           UPDATE
                                 emp
                               SET
                                 sal = :sal
                             WHERE
                                 ROWID = :rid
                             ");
oci_bind_by_name($update, ":rid", $rowid, -1, OCI_B_ROWID);
oci_bind_by_name($update, ":sal", $sal,  32);

$sal = 10000;

while (list($empno, $ename) = each($data)) {
   oci_execute($stmt);
   oci_execute($update);
}

$rowid->free();

oci_free_statement($update);
oci_free_statement($stmt);

$stmt = oci_parse($conn, "
                         SELECT
                               *
                           FROM
                               emp
                           WHERE
                               empno
                             IN
                               (1111,2222,3333)
                             ");
oci_execute($stmt);
                            
while ($row = oci_fetch_assoc($stmt)) {
   var_dump($row);
}

oci_free_statement($stmt);

/* delete our "junk" from the emp table.... */
$stmt = oci_parse($conn, "
                         DELETE FROM
                                     emp
                               WHERE
                                     empno
                                   IN
                                     (1111,2222,3333)
                                   ");
oci_execute($stmt);
oci_free_statement($stmt);

oci_close($conn);
?>

Помните о том, что при использовании этой функции, конечные пробелы у строки будут обрезаны. Смотрите следующий пример:

Пример 2. Пример oci_bind_by_name()

<?php
   $connection = oci_connect('apelsin','kanistra');
   $query = "INSERT INTO test_table VALUES(:id, :text)";

   $statement = oci_parse($query);
   oci_bind_by_name($statement, ":id", 1);
   oci_bind_by_name($statement, ":text", "trailing spaces follow    ");
   oci_execute($statement);
   /*
     Этот код добавит в базу только строку 'trailing spaces follow', без
     пробелов в конце строки
   */
?>

Пример 3. Пример oci_bind_by_name()

<?php
   $connection = oci_connect('apelsin','kanistra');
   $query = "INSERT INTO test_table VALUES(:id, 'trailing spaces follow      ')";

   $statement = oci_parse($query);
   oci_bind_by_name($statement, ":id", 1);
   oci_execute($statement);
   /*
     А этот код добавит в базу строку 'trailing spaces follow      ' вместе с
     пробелами в конце строки
   */
?>

Внимание

Использовать magic_quotes_gpc, magic_quotes_runtime или addslashes() вместе с oci_bind_by_name() - это определенно плохая идея, т.к. в этих случаях кавычки будут записаны в базу вместе с данными. oci_bind_by_name() не может отличить "магические кавычки" от тех, что были добавлены намеренно.

Замечание: В версиях PHP ниже 5.0.0 эта функция называлась ocinewcollection(). В PHP 5.0.0 и выше ocinewcollection() является алиасом oci_new_collection(), поэтому вы можете продолжать использовать это имя, однако это не рекомендуется.

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.



oci_bind_by_name
js at mcs dot be
20-Feb-2006 04:48
Be careful that the variable argument is a reference. So, the following code does not work:
  foreach($some_array as $key => $value)
  {
   OCIBindByName($stmt, $key, $value);
  }

I assume this is because the contents of $value changes, even though the reference remains the same, so all bound variables end up pointing to the last loop iteration's value.

Instead use the following:
  foreach($some_array as $key => $value)
  {
   OCIBindByName($stmt, $key, $some_array[$key]);
  }
ehsmeng
16-Feb-2006 12:43
If you do a wrapper for these functions there is a bug I found on php5.1.1 / oracle 9 / windows xp. see the section with oci_bind_by_name.

function db_layer_insert_1_row ($dbquery, $bindvar = array())
{
   global $_db_layer_database;
   global $_db_layer_lasterror;
  
   if (false === ($stid = oci_parse($_db_layer_database, $dbquery))) {
       db_layer_lasterror ();
       return -1;
   }
  
   // Bind variables. NOTE substituting $bindvar[$bcol] with $bval causes
   // all variables to be set to the last value of $bval?!?!
   foreach ($bindvar as $bcol => $bval) {
       oci_bind_by_name($stid, $bcol, $bindvar[$bcol]); //$bval); <- bug?!
   }
  
   ...
hfuecks at nospam dot org
16-Aug-2005 01:12
Note that there have been some changes on the constant identifiers and the documentation is currently not entirely accurate.

Running the following script;

<?php
foreach (array_keys(get_defined_constants()) as $const) {
   if ( preg_match('/^OCI_B_/', $const) ) {
       print "$const\n";
   }
}
?>

Under PHP 4.4.0 I get;

OCI_B_SQLT_NTY < renamed to OCI_B_NTY with PHP5
OCI_B_BFILE
OCI_B_CFILEE
OCI_B_CLOB
OCI_B_BLOB
OCI_B_ROWID
OCI_B_CURSOR
OCI_B_BIN

Under PHP 5.0.4 I get;

OCI_B_NTY
OCI_B_BFILE < docs are wrong right now
OCI_B_CFILEE < docs are wrong right now
OCI_B_CLOB
OCI_B_BLOB
OCI_B_ROWID
OCI_B_CURSOR
OCI_B_BIN < it's a mystery

<OCI-Lob->writeToFileoci_cancel>
 Last updated: Tue, 15 Nov 2005