mysql_fetch_field

(PHP 4, PHP 5)

mysql_fetch_field — 从结果中获取列信息并作为对象返回

警告

此扩展在 PHP 5.5.0 中已弃用，并在 PHP 7.0.0 中被移除。应改用 MySQLi 或 PDO_MySQL 扩展。另请参阅 MySQL：选择 API 指南。此函数的替代方法包括

描述

mysql_fetch_field(资源 $result, 整数 $field_offset = 0): 对象

返回一个包含字段信息的オブジェクト。此函数可用于获取有关提供的查询结果中的字段的信息。

参数

result: 正在评估的结果资源。此结果来自对 mysql_query() 的调用。
field_offset: 数字字段偏移量。如果未指定字段偏移量，则检索尚未通过此函数检索的下一个字段。 field_offset 从 0 开始。

返回值

返回一个包含字段信息的对象。对象的属性为

name - 列名
table - 列所属表的名称，如果定义了别名，则为别名
max_length - 列的最大长度
not_null - 如果列不能为 null，则为 1
primary_key - 如果列是主键，则为 1
unique_key - 如果列是唯一键，则为 1
multiple_key - 如果列是非唯一键，则为 1
numeric - 如果列是数值型，则为 1
blob - 如果列是 BLOB，则为 1
type - 列的类型
unsigned - 如果列是无符号的，则为 1
zerofill - 如果列是零填充的，则为 1

示例

示例 #1 mysql_fetch_field() 示例

<?php
$conn = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$conn) {
 die('无法连接: ' . mysql_error());
}
mysql_select_db('database');
$result = mysql_query('select * from table');
if (!$result) {
 die('查询失败: ' . mysql_error());
}
/* 获取列元数据 */
$i = 0;
while ($i < mysql_num_fields($result)) {
 echo "列 $i 的信息:<br />\n";
 $meta = mysql_fetch_field($result, $i);
 if (!$meta) {
 echo "无可用信息<br />\n";
 }
 echo "<pre>
blob: $meta->blob
max_length: $meta->max_length
multiple_key: $meta->multiple_key
name: $meta->name
not_null: $meta->not_null
numeric: $meta->numeric
primary_key: $meta->primary_key
table: $meta->table
type: $meta->type
unique_key: $meta->unique_key
unsigned: $meta->unsigned
zerofill: $meta->zerofill
</pre>";
 $i++;
}
mysql_free_result($result);
?>

备注

注意: 此函数返回的字段名称是区分大小写的。

备注:
如果字段或表名称在 SQL 查询中被别名化，则将返回别名化的名称。例如，可以使用 mysqli_result::fetch_field() 检索原始名称。

参见

mysql_field_seek() - 将结果指针设置为指定的字段偏移量

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加备注

用户贡献的备注 13 个备注

向上

向下

david at vitam dot be ¶

16 年前

一个帮助程序员区分多选查询中的表名的简单函数，其中一些字段在不同的表中具有相同的名称。


<?php 
public function sql($sql) { 
 $T_Return=array(); 
 $result=@mysql_query($sql); 
 
 $i=0; 
 while ($i < mysql_num_fields($result)) { 
 $fields[]=mysql_fetch_field($result, $i); 
 $i++; 
 } 
 
 while ($row=mysql_fetch_row($result)) { 
 $new_row=array(); 
 for($i=0;$i<count($row); $i++) { 
 $new_row[ $fields[$i]->table][$fields[$i]->name]=$row[$i]; 
 } 
 $T_Return[]=$new_row; 
 } 
 
 
 return $T_Return; 
} 
?>

向上

向下

krang at krang dot org dot uk ¶

22 年前

字段类型返回的是 PHP 对该字段中找到的数据的分类，而不是它在数据库中的存储方式；使用以下示例检索有关该字段的 MySQL 信息......


<?php 
$USERNAME = ''; 
$PASSWORD = ''; 
 
$DATABASE = ''; 
$TABLE_NAME = ''; 
 
mysql_connect('localhost', $USERNAME, $PASSWORD) 
 or die ("Could not connect"); 
 
$result = mysql_query("SHOW FIELDS FROM $DATABASE.$TABLE_NAME"); 
 
$i = 0; 
 
while ($row = mysql_fetch_array($result)) { 
 echo $row['Field'] . ' ' . $row['Type']; 
} 
?>

向上

向下

Nick Baicoianu ¶

18 年前

请务必注意，$max_length 是返回的数据集中该字段的最长值的长度，而不是该列设计用于保存数据的最大长度。

向上

向下

-1

lucien at ocia dot nl ¶

12 年前

性能注意事项！

我使用此脚本进行测试，该表有 26 列。

<?php
$t_start = microtime(true);
$sql = mysql_query("SELECT * FROM `table` LIMIT 1") or trigger_error(mysql_error(), E_USER_WARNING);
for ($i = 0; $i < mysql_num_fields($sql); $i++) {
 $meta = mysql_fetch_field($sql, $i);
 echo "Information for column ".$meta->name.":\n";
 echo 
"\tblob: $meta->blob
\tmax_length: $meta->max_length
\tmultiple_key: $meta->multiple_key
\tname: $meta->name
\tnot_null: $meta->not_null
\tnumeric: $meta->numeric
\tprimary_key: $meta->primary_key
\ttable: $meta->table
\ttype: $meta->type
\tunique_key: $meta->unique_key
\tunsigned: $meta->unsigned
\tzerofill: $meta->zerofill
";
}
$t_stop = microtime(true);
$t_proc = $t_stop - $t_start;
echo "processing time query 1: ".number_format($t_proc * 1000, 3)." ms\n";
unset($t_start);
unset($t_stop);
unset($t_proc);
$t_start = microtime(true);
$sql = mysql_query("DESCRIBE `table`");
while ($res = mysql_fetch_array($sql, MYSQL_ASSOC)) {
 print_r($res);
}
$t_stop = microtime(true);
$t_proc = $t_stop - $t_start;
echo "processing time query 2: ".number_format($t_proc * 1000, 3)." ms\n";
?>

查询 1 => 0.444 毫秒
查询 2 => 1.146 毫秒

因此，为了方便使用，建议使用查询 2... 但是，如果您是性能爱好者，则应使用查询 1。

向上

向下

-1

mwwaygoo AT hotmail DOT com ¶

12 年前

使用 mysql_fetch_field，您可以生成更强大的 mysql_fetch_assoc 版本。


当查询具有相同字段名的两个表时，通常需要使用 mysql_fetch_row 获取整数键数组，而不是关联键数组。这是因为第二个表中具有相同名称的字段将覆盖从第一个表返回的数据。
但是，这个简单的函数将在键之前插入表名，并防止交叉。


即 SELECT *，'test' AS test 4 FROM table AS T_1，table AS T_2 WHERE T_1.a=T_2.b


可能会产生


mysql_fetch_assoc() 返回
array(
'index'=>2,
'a'=>'pear',
'b'=>'apple',
'test'=>'test',
4=>4

)



mysql_fetch_table_assoc() 返回
array(
'T_1.index' =>1,
'T_1.a'=>'apple',
'T_1.b'=>'banana',
'T_2.index'=>2,
'T_2.a'=>'pear',
'T_2.b'=>'apple',
'test'=>'test',
4=>4

)



<?php 
function mysql_fetch_table_assoc($resource) 
{ 
 // 获取查询中的所有数据，而不会覆盖相同字段 
 // 通过使用表名和字段名作为索引 
 
 // 首先获取数据 
 $data=mysql_fetch_row($resource); 
 if(!$data) return $data; // 数据结束 
 
 // 获取字段信息 
 $fields=array(); 
 $index=0; 
 $num_fields=mysql_num_fields($resource); 
 while($index<$num_fields) 
 { 
 $meta=mysql_fetch_field($resource, $index); 
 if(!$meta) 
 { 
 // 如果没有字段信息，则默认情况下只使用索引号 
 $fields[$index]=$index; 
 } 
 else 
 { 
 $fields[$index]=''; 
 // 处理字段别名 - 即没有表名 (SELECT T_1.a AS temp) 
 if(!empty($meta->table)) $fields[$index]=$meta->table.'.'; 
 // 处理原始数据 - 即没有字段名 (SELECT 1) 
 if(!empty($meta->name)) $fields[$index].=$meta->name; else $fields[$index].=$index; 
 } 
 $index++; 
 } 
 $assoc_data=array_combine($fields, $data); 
 return $assoc_data; 
} 
?>

向上

向下

-1

jorachim at geemail dot com ¶

15 年前

如果您想要表中的字段，简单的 DESCRIBE 查询就可以。

<?php
$query ="DESCRIBE Users";
$result = mysql_query($query);

echo "<ul>";

while($i = mysql_fetch_assoc($result))
 echo "<li>{$i['Field']}</li>";

echo "</ul>";
?>

应该可以解决问题。

向上

向下

-2

Jonathan ¶

14 年前

需要注意的是，只有当表的 primary_key 成员变量设置为 1 时，该表的主键才仅在该 1 个字段上。如果您有一个具有多列主键的表，那么您将不会得到您预期的结果。

例如
CREATE TABLE `line_item_table` (
`liForeignKey1` int(11) unsigned not null,
`liForeignKey2` int(11) unsigned not null,
PRIMARY KEY (`liForeignKey1`, `liForeignKey2`)
) ENGINE=MyISAM;

虽然您可能期望 primary_key == 1 适用于这两个列；var_dump() 将向您显示您为这两个字段获得以下内容
["primary_key"]=>int(0)

这是截至 PHP 5.2.13 和 MySQL 5.0.51 的情况

向上

向下

-3

Daniel B ¶

12 年前

简单函数来显示查询中的所有数据......

function dumpquery($query) {
$numfields = mysql_num_fields($query);
echo '<table border="1" bgcolor="white"><tr>';
for ($i = 0; $i<$numfields; $i += 1) {
$field = mysql_fetch_field($query, $i);
echo '<th>' . $field->name . '</th>';
    }
echo '</tr>';
while ($fielddata = mysql_fetch_array($query)) {
echo '<tr>';
for ($i = 0; $i<$numfields; $i += 1) {
$field = mysql_fetch_field($query, $i);
echo '<td>' . $fielddata[$field->name] . '</td>';
        }
echo '</tr>';
    }
echo '</table>';
}

向上

向下

-3

TALU ¶

15 年前

XML 生成。

允许参数在实时服务器上选择数据库和表存在安全风险（除非用户受到限制或用固定值替换 $_GET）。

输出带有标准格式的 xml，用于 <config> 部分，以在 flash 中生成表单。

<?php
 //
 // makeXML.php?db=dbname&table=tablename
 //
 
 set_time_limit(300);
 
 $host = "localhost";
 $user = "root";
 $password = "root";
 
 $database = $_GET['db']; 
 $table = $_GET['table'];
 
 mysql_connect($host,$user,$password);
 @mysql_select_db($database) or die( "无法选择数据库");
 

 $querytext="SELECT * FROM ".$table; 
 $result=mysql_query($querytext);
 
 if ($result){
 $num=mysql_num_rows($result);
 }else{
 $num=0;
 }
 
?>
<?php 
 header('Content-Type: text/xml');
 echo "<?xml version='1.0'?>"; 
 
 if ($num > 0){
 ?>
<<?php echo $table?>>
<config>
        <?php
 // 显示字段数量
 echo "<numFields>".mysql_num_fields($result)."</numFields>";
 $i = 0;
 $primaryKey = "";
 $nameArray = array(); 
 $maxLengthArray = array(); 
 $typeArray = array(); 
 while ($i < mysql_num_fields($result)) {
 $meta = mysql_fetch_field($result, $i);
 $nameArray[$i] = $meta->name;
 $maxLengthArray[$i] = $meta->max_length;
 $typeArray[$i] = $meta->type;
 if ($meta->primary_key){
 $primaryKey = $meta->name;
 }
 $i++;
 }
 $i = 0;
 echo "<fieldNames>";
 while ($i < count($nameArray)) {
 echo "<field".$i.">".$nameArray[$i]."</field".$i.">";
 $i++;
 }
 echo "</fieldNames>";
 $i = 0;
 echo "<fieldMaxLength>";
 while ($i < count($maxLengthArray)) {
 echo "<field".$i.">".$maxLengthArray[$i]."</field".$i.">";
 $i++;
 }
 echo "</fieldMaxLength>";
 $i = 0;
 echo "<fieldType>";
 while ($i < count($typeArray)) {
 echo "<field".$i.">".$typeArray[$i]."</field".$i.">";
 $i++;
 }
 echo "</fieldType>";
 ?>
 <primaryKey><?php echo $primaryKey?></primaryKey>
<numRecords><?php echo $num?></numRecords>
</config>
<?php 
 $i=0;
 while ($i < $num) {
 $ID=mysql_result($result,$i,"ID");
 $value=mysql_result($result,$i,"value");
 $title=mysql_result($result,$i,"title");
 $description=mysql_result($result,$i,"description");
?>
 <row>
<ID><?php echo $ID?></ID>
<weighting><?php echo $value?></weighting>
<title><?php echo $title?></title>
<description><?php echo $description?></description>
</row>
<?php 
 $i = $i + 1;
 } 
?>
</<?php echo $table?>>

<?php 
 } 
?>

向上

向下

-3

php at brayra dot com ¶

22 年前

我需要获取字段信息和枚举/集合值。这是我创建的函数，用于扩展 mysql_fetch_field 返回的对象。我还决定以类似于 mysql_fetch_array 的方式，通过“名称”和位置将表中的所有字段返回到一个字段对象数组中。


您可以使用以下方法测试它


<?php 
$myfields = GetFieldInfo('test_table'); 
print "<pre>"; 
print_r($myfields); 
print "</pre>"; 
?> 



字段对象现在具有 'len'、'values' 和 'flags' 参数。
注意：'values' 仅对集合和枚举字段具有数据。


<?php 
// 假设数据库连接已打开 
// 我还使用常量 DB_DB 来表示当前数据库。 
function GetFieldInfo($table) 
{ 
 if($table == '') return false; 
 $fields = mysql_list_fields(DB_DB, $table); 
 if($fields){ 
 $columns = mysql_query('show columns from ' . $table); 
 if($columns){ 
 $num = mysql_num_fields($fields); 
 for($i=0; $i < $num; ++$i){ 
 $column = mysql_fetch_array($columns); 
 $field = mysql_fetch_field($fields, $i); 
 $flags = mysql_field_flags($fields, $i); 
 if($flags == '') $flags=array(); 
 else $flags = explode(' ',$flags); 
 if (ereg('enum.(.*).',$column['Type'],$match)) 
 $field->values = explode(',',$match[1]); 
 if (ereg('set.(.*).',$column['Type'],$match)) 
 $field->values = explode(',',$match[1]); 
 if(!$field->values) $field->values = array(); 
 $field->flags = $flags; 
 $field->len = mysql_field_len($fields, $i); 
 $result_fields[$field->name] = $field; 
 $result_fields[$i] = $field; 
 } 
 mysql_free_result($columns); 
 } 
 mysql_free_result($fields); 
 return $result_fields; 
 } 
 return false; 
} 
?> 

希望其他人会发现这很有用。

向上

向下

-2

php [spat] hm2k.org ¶

15 年前

对早期 mysql_column_exists 函数的改进。

<?php

function mysql_column_exists($table_name, $column_name, $link=false) {
 $result = @mysql_query("SHOW COLUMNS FROM $table_name LIKE '$column_name'", $link);
 return (mysql_num_rows($result) > 0);
}

?>

向上

向下

-5

eviltofu at gmail dot com ¶

13 年前

MYSQLI_TYPE_BLOB 表示字段是 BLOB 或 TEXT。我认为您需要检查 blob 值。如果是真的，那么它是一个 BLOB，否则它是一个 TEXT。有人可以确认吗？

向上

向下

-6

dheep ¶

16 年前

用于显示字段名称的简单 PHP 脚本。假设数据库已选择。


<?php 
$sql = "SELECT * FROM table_name;"; 
$result = mysql_query($sql); 
$i = 0; 
while($i<mysql_num_fields($result)) 
{ 
 $meta=mysql_fetch_field($result,$i); 
 echo $i.".".$meta->name."<br />"; 
 $i++; 
} 
?> 

输出
0.id
1.todo
2.due date
3.priority
4.type
5.status
6.notes


希望这有用。