トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→MySQL　→MySQL (最初の API)

関数・クラス解説

mysql_list_fields

version:PHP 4, PHP 5 (公式)

MySQL テーブルのフィールドのリストを得る

公式リファレンス

書式

mysql_list_fields ( string $database_name , string $table_name [, resource $link_identifier = NULL ] ) : resource

説明

指定された名前のテーブルについての情報を取得します。

この関数は非推奨です。かわりに mysql_query() を利用して SHOW COLUMNS FROM table [LIKE 'name'] 文を発行することを推奨します。

パラメータ

database_name: クエリの対象となるデータベース名。
table_name: クエリの対象となるテーブル名。
link_identifier: MySQL 接続。指定されない場合、mysql_connect() により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、引数を指定せずにmysql_connect() がコールした時と同様にリンクを確立します。リンクが見付からない、または、確立できない場合、E_WARNING レベルのエラーが生成されます。

返値

成功した場合に結果ポインタ resource 、失敗した場合に FALSE を返します。返された結果は mysql_field_flags(), mysql_field_len(), mysql_field_name() そして mysql_field_type() で利用可能です。

注意

注意: 下位互換のために、次の非推奨別名を使用してもいいでしょう。 mysql_listfields()

警告この関数は PHP 5.4.0 で非推奨になり、PHP 7.0.0 でMySQL 拡張モジュール全体とあわせて削除されました。MySQLi あるいはPDO_MySQL を使うべきです。詳細な情報はMySQL: API の選択やそれに関連する FAQ を参照ください。この関数の代替として、これらが使えます。

SQL クエリー: SHOW COLUMNS FROM sometable

サンプル

例1 非推奨である mysql_list_fields() の代替例 

$result = mysql_query("SHOW COLUMNS FROM sometable");
if (!$result) {
    echo 'Could not run query: ' . mysql_error();
    exit;
}
if (mysql_num_rows($result) > 0) {
    while ($row = mysql_fetch_assoc($result)) {
        print_r($row);
    }
}

 上の例の出力は、たとえば以下のようになります。 
Array
(
    [Field] => id
    [Type] => int(7)
    [Null] =>  
    [Key] => PRI
    [Default] =>
    [Extra] => auto_increment
)
Array
(
    [Field] => email
    [Type] => varchar(100)
    [Null] =>
    [Key] =>
    [Default] =>
    [Extra] =>
)