PHP Conference Nagoya 2025

odbc_binmode

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

odbc_binmodeManipulação de dados de colunas binárias

Descrição

odbc_binmode(Odbc\Result $statement, int $mode): true

Controla a manipulação de dados de colunas binárias. Os tipos SQL ODBC afetados são BINARY, VARBINARY e LONGVARBINARY. O modo padrão pode ser definido usando a diretiva uodbc.defaultbinmode do php.ini.

Quando dados SQL binários são convertidos em dados de caracteres C (ODBC_BINMODE_CONVERT), cada byte (8 bits) dos dados de origem é representado como dois caracteres ASCII. Esses caracteres são a representação de caracteres ASCII do número em sua forma hexadecimal. Por exemplo, um binário 00000001 é convertido em "01" e um binário 11111111 é convertido em "FF" .

Embora o tratamento das colunas BINARY e VARBINARY dependa apenas do "binmode", o tratamento das colunas LONGVARBINARY também depende do "longreadlen":

Manipulação de LONGVARBINARY
binmode longreadlen resultado
ODBC_BINMODE_PASSTHRU 0 intermediário
ODBC_BINMODE_RETURN 0 intermediário
ODBC_BINMODE_CONVERT 0 intermediário
ODBC_BINMODE_PASSTHRU >0 intermediário
ODBC_BINMODE_RETURN >0 retorna como está
ODBC_BINMODE_CONVERT >0 retorna como char

Se odbc_fetch_into() for usada, "intermediário" significa que uma string vazia será retornada para essas colunas. Se odbc_result() for usada, "intermediário" significa que os dados são enviados diretamente ao cliente (ou seja, exibidos).

Parâmetros

statement

O objeto de resultado ODBC.

mode

Valores possíveis para mode são:

Nota: A manipulação de colunas de binários longos também é afetada por odbc_longreadlen().

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.4.0 statement agora espera uma instância de Odbc\Result; anteriormente, esperava um resource.
adicione uma nota

Notas Enviadas por Usuários (em inglês) 4 notes

up
1
yhalmoe at yahoo dot no
14 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.
up
0
mizmerize at yahoo dot com
18 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).

<?php
$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);
odbc_binmode($result,ODBC_BINMODE_PASSTHRU);
//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...

<?php
function hex2bin($data){
$len = strlen($data);
return
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);
odbc_binmode($result,ODBC_BINMODE_CONVERT);
$m_FValue=odbc_result($result, 1);
$out=hex2bin($m_FValue);
}
?>

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...
up
0
andrea dot galli at acotel dot com
21 years ago
Example: retrieve image from database.

<?php

$Link_ID
= 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);

echo
$Images;

?>
up
-1
bortuzar
15 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