Edit Report a Bug

Функции IBM DB2

Содержание

db2_autocommit — Возвращает или устанавливает режим автоподтверждения транзакций для соединения
db2_bind_param — Связывает переменную PHP с параметром SQL-выражения
db2_client_info — Возвращает объект со свойствами, описывающими клиента DB2
db2_close — Закрывает соединение с базой данных
db2_column_privileges — Возвращает результирующий набор, перечисляющий столбцы и связанные с ним привилегии для таблицы
db2_columns — Возвращает результирующий набор, перечисляющий столбцы и связанные с ними метаданные для таблицы
db2_commit — Подтверждает транзакцию
db2_conn_error — Возвращает строку, содержащую значение SQLSTATE, возвращённое последней попыткой подключения
db2_conn_errormsg — Возвращает последнее сообщение об ошибке подключения и значение SQLCODE
db2_connect — Возвращает соединение с базой данных
db2_cursor_type — Возвращает тип курсора, который используется в ресурсе оператора
db2_escape_string — Используется для экранирования некоторых символов
db2_exec — Выполняет SQL-запрос напрямую
db2_execute — Выполняет подготовленный SQL-запрос
db2_fetch_array — Возвращает массив, индексированный по положению столбца, представляющий строку в наборе результатов
db2_fetch_assoc — Возвращает массив, индексированный по имени столбца, представляющий строку в наборе результатов
db2_fetch_both — Возвращает массив, индексированный как по имени столбца, так и по позиции, представляющий строку в наборе результатов
db2_fetch_object — Возвращает объект со свойствами, представляющими столбцы в выбранной строке
db2_fetch_row — Устанавливает указатель набора результатов на следующую строку или запрошенную строку
db2_field_display_size — Возвращает максимальное количество байтов, необходимое для отображения столбца
db2_field_name — Возвращает имя столбца в наборе результатов
db2_field_num — Возвращает позицию указанного столбца в наборе результатов
db2_field_precision — Возвращает точность указанного столбца в наборе результатов
db2_field_scale — Возвращает масштаб указанного столбца в наборе результатов
db2_field_type — Возвращает тип данных указанного столбца в наборе результатов
db2_field_width — Возвращает ширину текущего значения указанного столбца в наборе результатов
db2_foreign_keys — Возвращает набор результатов, в котором перечислены внешние ключи таблицы
db2_free_result — Освобождает ресурсы, связанные с набором результатов
db2_free_stmt — Освобождает ресурсы, связанные с указанным ресурсом выражения
db2_get_option — Извлекает значение параметра для ресурса оператора или ресурса соединения
db2_last_insert_id — Возвращает автоматически сгенерированный идентификатор последнего запроса на добавление, успешно выполненного в этом соединении
db2_lob_read — Получает определённый пользователем размер LOB-файлов при каждом вызове
db2_next_result — Запрашивает следующий набор результатов из хранимой процедуры
db2_num_fields — Возвращает количество полей в результирующем наборе
db2_num_rows — Возвращает количество строк, затронутых SQL-запросом
db2_pclose — Закрывает постоянное соединение с базой данных
db2_pconnect — Возвращает постоянное соединение с базой данных
db2_prepare — Подготавливает SQL-запрос к выполнению
db2_primary_keys — Возвращает набор результатов, содержащий первичные ключи таблицы
db2_procedure_columns — Возвращает набор результатов со списком параметров хранимой процедуры
db2_procedures — Возвращает набор результатов, в котором перечислены хранимые процедуры, зарегистрированные в базе данных
db2_result — Возвращает один столбец из строки в наборе результатов
db2_rollback — Откатывает транзакцию
db2_server_info — Возвращает объект со свойствами, описывающими сервер базы данных DB2
db2_set_option — Установка опции для соединения или ресурса оператора
db2_special_columns — Возвращает набор результатов, в котором перечислены столбцы с уникальным идентификатором строки таблицы
db2_statistics — Возвращает набор результатов, содержащий индекс и статистику таблицы
db2_stmt_error — Возвращает строку, содержащую SQLSTATE, возвращённую SQL-оператором
db2_stmt_errormsg — Возвращает строку, содержащую последнее сообщение об ошибке SQL-выражения
db2_table_privileges — Возвращает набор результатов, в котором перечислены таблицы и связанные с ними права доступа к базе данных
db2_tables — Возвращает набор результатов, в котором перечислены таблицы и связанные метаданные в базе данных

add a note

User Contributed Notes 5 notes

down

Richard dot Ablewhite at gmail dot com ¶

16 years ago


There seems to be a lot of good documentation
for Linux users compiling PHP with DB2 support,
but decent Windows notes are minimal.

You do not need to install full DB2 clients to get DB2
working with DB2, all you need is the IBM Data
Server Driver for ODBC, CLI, and .NET which is only
16.1 meg.

You can download the driver from here:

Direct Link:
ftp://ftp.software.ibm.com/ps/products/db2/fixes2/englsh-us/
db2_v95/dsdriver/fp2/v9.5fp2_nt32_dsdriver_EN.exe

Home Page:
http://www-01.ibm.com/support/docview.wss?rs=71&uid=swg21287889

This includes both the drivers required and the PHP
dll php_ibm_db2_5.2.2.dll

Once installed the drivers do not setup the correct
path environmental variable,
so add the following to your path:

C:\Program Files\IBM\IBM DATA SERVER DRIVER\bin

Once thats done all should work! No massive
400meg client downloads required.

Whats even better about these drivers is that you
dont need to install them,
you can simply copy the bin directory to any server,
add it to your path and it will just work. 
This is great for anyone developing PHP-GTK applications,
I copy the bin directory into my php-gkt2 directory
and execute using the following batch script:

path = %PATH%;.\IBM DATA SERVER DRIVER\bin
php-win.exe %*

This lets me role out lightweight DB2 client desktop
apps that dont have to be installed,
can just be coppied from PC to PC or ran over a
network or from USB stick.

As your only installing the client drivers you wont be
able to catalog databases,
so always use the full connection string. Here is a
quick bit of code to get you started:

$database = 'databasename';
$user = 'user';
$password = 'password';
$hostname = '127.0.0.1';
$port = 50000;

$conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;" .
  "HOSTNAME=$hostname;PORT=$port;".
  "PROTOCOL=TCPIP;UID=$user;PWD=$password;";
$conn = db2_connect($conn_string, '', '');

$query = 'SELECT * FROM TABLE';
$res = db2_prepare($conn, $query);
db2_execute($res);

while ($row = db2_fetch_array($res)) {
  print_r($row);
}

down

igtoth at gmail dot com ¶

10 years ago


// IBM DB2 funcitons like MySQL (ODBC based)
// "Ighor Toth" <igtoth@gmail.com>
// Date: 08/05/2014

// usage:
// db2_connect(verbose,instance,username,password); -> also reads config file if nothing declared db2.conf.inc.php
// db2_query(db2_connect_return,sql)
// db2_fetch_array(result);
// db2_fetch_object(result);
// db2_display_table(db2_connect_return,sql); // select only

function db2_connect($verbose = null,$db2name = null,$username = null,$password = null) {
    if(!isset($verbose)){
        $verbose = TRUE; // TRUE or FALSE, if not set TRUE
    }
    if(!isset($db2name)){ // NOT DECLARED 
        include("db2.conf.inc.php"); // CHECK CONFIG FILE
        if(!isset($db2name)){
            if ($verbose == TRUE){
                echo ("DB2 Instance not selected");
                exit();
            } else {
                exit();
            }
        }
    } else if (!isset($username)){
        echo ("DB2 Instance username not specified");
        exit();    
    } 
    $db2conn = odbc_connect($db2name, $username, $password);
    if (($verbose == TRUE) && ($db2conn == 0)) {
        echo("Connection to database failed.");
        $sqlerror = odbc_errormsg($db2conn);
        echo($sqlerror);
    }
    return($db2conn);
}

function db2_query($db2conn,$sql){
    $result = odbc_exec($db2conn, $sql);
    if ($result == 0) {
        echo("QUERY = '$sql' FAILED.<br>\n");
        $sqlerror = odbc_errormsg($db2conn);
        echo($sqlerror);
    } else {
        // odbc_result_all prints all of the rows
        // for a result set ID as an HTML table
        return $result;
    }
}

 function db2_fetch_array($result, $rownumber=null){
    $array = array();
    if (!($cols = odbc_fetch_into($result, $result_array, $rownumber))) {
        return false;
    }
    for ($i = 1; $i <= $cols; $i++) {
        $array[odbc_field_name($result, $i)] = $result_array[$i - 1];
    }
    return $array;
}

function db2_fetch_object($result){
    if(function_exists("db2_fetch_object")) return db2_fetch_object($result);
    $rs = array();
    $rs_obj = false;
    if( odbc_fetch_into($result, $rs) ){
        foreach( $rs as $key=>$value ){
            $fkey = odbc_field_name($result, $key+1);
            $rs_obj->$fkey = trim($value);
        }
    }
    return $rs_obj;
}

function db2_display_table($db2conn,$sql) {
    // select all rows from the table
    if(!isset($db2conn)||!isset($sql)){
        echo("ERROR db2_display_table: Function missing arguments");
        exit();
    }
    $check = explode(" ",$sql);
    if($check[0]!="SELECT"){
        echo("ERROR db2_display_table: Not SELECT SQL query");
    }
    if ($db2conn != 0) {
        // odbc_exec returns 0 if the statement fails;
        // otherwise it returns a result set ID
        $result = odbc_exec($db2conn, $sql);
        if ($result == 0) {
            echo("SELECT statement failed.");
            $sqlerror = odbc_errormsg($db2conn);
            echo($sqlerror);
        } else {
            // odbc_result_all prints all of the rows
            // for a result set ID as an HTML table
            odbc_result_all($result);
        }
    }
}

down

brent dot halsey at gmail dot com ¶

16 years ago


Spent a lot of time trying to get this to work on a 64bit box.  You'll need to make sure you set your db2 client to 64 bit mode!  If you didn't set your instance to 64bit, you can run ./db2iupdt -w64 db2instance as root to set it.  Hope this helps someone!

down

Exi ¶

16 years ago


The DB/2 Run-Time-Client can be found here:
http://www-1.ibm.com/support/docview.wss?rs=71&uid=swg21255394
Select the 'Runtime Client Installable for Windows' further down the page and download it. 
Clients for other platform (incl. 64-Bit Windows) are also available from that page.

down

-1

kfoubert at sitecrafting dot com ¶

16 years ago


If you wish to connect to an iSeries Server, such as an AS/400, there are two options. Installing DB2 Express-C v9.5 and purchasing DB2 Connect Personal Edition for about $500 or getting System I Access for Linux, which is a free download. Please note the server requirements for each of these. For example, we originally went with DB2 Express-C and decided upon Ubuntu 7.10, but learned about System I Access, from an IBM rep, which requires redhat package manager, after the entire server was up and running. 

DB2 Express-C
http://www-306.ibm.com/software/data/db2/express/

DB2 Connect Personal
http://www-306.ibm.com/software/data/db2/db2connect/edition-pe.html

System I Access for Linux
http://www-03.ibm.com/systems/i/software/access/index.html 
NOTE: System I Access requires redhat package manager.

add a note