PHP 7.4.24 Released!


(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_binmodeУправляет обработкой двоичных данных столбца


odbc_binmode(resource $statement, int $mode): bool

Управляет обработкой двоичных данных столбца. Затрагиваемые типы ODBC SQL: BINARY, VARBINARY и LONGVARBINARY. Режим по умолчанию можно установить с помощью директивы php.ini uodbc.defaultbinmode.

Когда двоичные данные SQL преобразуются в символьные данные C (ODBC_BINMODE_CONVERT), каждый байт (8 бит) исходных данных представляется в виде двух символов ASCII. Эти символы представляют собой символьное представление числа в формате ASCII в его шестнадцатеричной форме. Например, двоичное число 00000001 преобразуется в "01" , а 11111111 - в "FF".

Хотя обработка столбцов BINARY и VARBINARY зависит только от binmode, обработка столбцов LONGVARBINARY также зависит от longreadlen:

binmode longreadlen result
ODBC_BINMODE_RETURN >0 вернуть как есть
ODBC_BINMODE_CONVERT >0 вернуть в виде char

Если используется odbc_fetch_into(), passthru означает, что для этих столбцов возвращается пустая строка. Если используется odbc_result(), passthru означает, что данные отправляются клиенту напрямую (т.е. печатаются).

Список параметров


Идентификатор результата.

Если statement равен 0, настройки применяются по умолчанию для новых результатов.


Возможные значения для mode:

  • ODBC_BINMODE_PASSTHRU: Использовать режим passthru для двоичных данных
  • ODBC_BINMODE_RETURN: Вернуть как есть
  • ODBC_BINMODE_CONVERT: Преобразовать в char и вернуть

Замечание: На обработку двоичных столбцов LONG также влияет функция odbc_longreadlen().

Возвращаемые значения

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

add a note add a note

User Contributed Notes 4 notes

yhalmoe at yahoo dot no
11 years ago
For Sybase users (this probably applies to MS-SQL Server as well) who are using ODBC:

I was using the same code as mizmerize, but I was getting truncated data back from the server (at the 32kb mark) when selecting data with the image datatype. My Sybase server has a @@textsize property of 2Gb, which should be plenty. But apparently, the php ODBC driver resets this to 32Kb when a connection is made, and then sets it back to 2Gb after. The solution is to do a query:

<?php odbc_exec($connH, "set textsize 131072"); ?>

immediately before your main query, in mizmerize's code. That should override the default setting.
mizmerize at yahoo dot com
15 years ago
I am currently using an SQL Server 2000 used as a datasource for ODBC access, Testing PHP scripts from an Apache 2 server running on Windows 2000.

I was trying to get an image from the database using ODBC but the output always flushes automatically while I was just getting the result using odbc_result() function.

With this code, the picture automatically prints to the browser as soon as I hit odbc_result() (probably a bug, but bug reports aren't that easy to do).

=odbc_pconnect("ImageDB","sa","",SQL_CUR_USE_IF_NEEDED) or die(odbc_errormsg());
$result=odbc_exec($connH, "SELECT Emp_Image FROM tblEmployeePics WHERE Emp_Id=547");
    if (
$result) {                           
odbc_longreadlen($result, 131072);       
//upon calling this, the output flushes out to the browser... made me scratch       
$m_FValue=odbc_result($result, 1);

...after 48 hours of scratching I finally made a work around, but by using a function in the bin2hex() function documentation...

function hex2bin($data){
$len = strlen($data);
pack("H" . $len, $data);

$connH=odbc_pconnect("ImageDB","sa","",SQL_CUR_USE_IF_NEEDED) or die(odbc_errormsg());
$result=odbc_exec($connH, "SELECT Emp_Image FROM tblEmployeePics WHERE Emp_Id=547");
    if (
$result) {                           
odbc_longreadlen($result, 131072);       
$m_FValue=odbc_result($result, 1);

The trick was to convert the output into hex by changing odbc_binmode to  ODBC_BINMODE_CONVERT and using a handy function to convert it back to binary in order to facilitate manipulation of its size, depth etc...
andrea dot galli at acotel dot com
18 years ago
Example: retrieve image from database.


= odbc_connect("DSN", "user", "pass");
$Query_ID = odbc_exec($Link_ID, "SELECT picture FROM categories");

// change to ODBC_BINMODE_CONVERT for comparison

odbc_binmode($Query_ID, ODBC_BINMODE_RETURN);

$Images = odbc_result($Query_ID, 1);


12 years ago
I set the odbc_longreadlen() at the beggining of my script so nText field types dont get truncated, like this:

<?php odbc_longreadlen (0, 1000000); ?>
To Top