MySQLi エラー関数を使用してエラーを表示する

Mehvish Ashiq 2023年1月30日 MySQLi MySQL Error
  1. PHP MySQLi エラー関数
  2. まとめ
MySQLi エラー関数を使用してエラーを表示する

MySQLi は、MySQL データベースサーバーにアクセスするために使用される PHP 関数です。MySQL バージョン 4.1.13 以降を使用している場合は、この拡張機能を使用できます。

PHP でさまざまな機能を実行するために使用できるさまざまな MySQLi 関数があります。この記事では、MySQLi エラー関数について学習します。

また、コード例を使用する方法と場所を確認し、出力を観察します。このチュートリアルでは、MySQL バージョン 8.0.27 と PHP バージョン 7.4.1 を使用します。

PHP MySQLi エラー関数

このチュートリアルでは、次の PHPMySQLi エラー関数について学習します。

  • mysqli_error()
  • mysqli_errno()
  • mysqli_error_list()
  • mysqli_connect_error()
  • mysqli_connect_errno()

これらの関数はすべて、オブジェクト指向スタイルと手続き型スタイルで使用できます。mysqli_error() 関数を使用して両方の構文を理解しましょう。

オブジェクト指向スタイルの mysqli_error() 関数の構文

string $mysqli->error;

手続き型の mysqli_error() 関数の構文

string mysqli_error ( mysqli $link )

MySQL の mysqli_error() 関数

この関数は、最新の関数呼び出し(存在する場合)の最後のエラーの説明を出力するために使用されます。SQL クエリにエラーがあるかどうかを知りたい場合に使用します。

mysqli_error() は、エラーの説明と、エラーがない場合は空の文字列を返します。次の例を参照してください。

手続き型スタイルを使用したコード例:

<?php
    $host = "localhost";
    $username = "root";
    $password = "";
    $database = "person";

    $connection = mysqli_connect($host, $username, $password, $database) 
    or die("Connection Failed"); 

    $sql = "SELECT * FROM teacher";
    $result = mysqli_query($connection, $sql);
    $error_message = mysqli_error($connection);

    if($error_message == ""){
        echo "No error related to SQL query.";
    }else{
        echo "Query Failed: ".$error_message;
    }
    mysqli_close($connection);
?>

上記のコードは、$host$username$password$database 変数を使用して接続を確立し、この接続を $connection 変数に保存しようとします。

mysqli_error() 関数は、この接続変数 $connection をパラメーターとして受け取り、ここで mysqli_query($connection, $sql) である最近の MySQLi 関数呼び出しによって引き起こされたエラーがあるかどうかをチェックします。

出力:

mysqli エラー関数を使用してエラーを表示します-mysqli_error を使用してエラーはありません

次に、SQL クエリのテーブル名を teacher から person に変更し、以下の出力を確認します。

出力:

mysqli エラー関数を使用してエラーを表示する-mysqli_error を使用してエラーを表示する

開発者として、person データベースに person テーブルがないことを簡単に理解できます(これは、上記のエラーでの意味です)。

テーブル名を変更したまま、行 $error_message = mysqli_error($connection); を置き換えます。$error_message = $connection->error; を使用 MySQLi エラー関数を使用してオブジェクト指向スタイルを練習し、理解する。

MySQL の mysqli_errno() 関数

mysqli_errno()mysqli_error() と同じように機能しますが、エラーの説明ではなくエラーコードを返します。

練習して理解するために、次のコードを記述します。この関数を実行するために手続き型スタイルを使用していることに気付いたかもしれません。

<?php
     $host = "localhost";
     $username = "root";
     $password = "";
     $database = "person";

     $connection = mysqli_connect($host, $username, $password, $database) 
     or die("Connection Failed"); 

     $sql = "SELECT * FROM person";
     $result = mysqli_query($connection, $sql);
     $error_message = mysqli_errno($connection);

     if($error_message == ""){
     	echo "No error related to SQL query.";
     }else{
     	echo "Query Failed: ".$error_message;
     }
    mysqli_close($connection);
?>

上記のコードは次の出力を示し、エラーコードとして数値が表示されます。

出力:

msyqli エラー関数を使用してエラーを表示する-mysqli_errno を使用してエラーを表示する

問題は、なぜこの関数を使用して数値のみを表示するのかということです。ユーザーフレンドリーなエラーメッセージ(カスタムメッセージ)を出力する場合は、このエラーコードを if-else ステートメントで使用できるためです。

以下のコードとその出力を参照してください。

<?php
     $host = "localhost";
     $username = "root";
     $password = "";
     $database = "person";

     $connection = mysqli_connect($host, $username, $password, $database) 
     or die("Connection Failed"); 

     $sql = "SELECT * FROM person";
     $result = mysqli_query($connection, $sql);
     $error_message = mysqli_errno($connection);

     if($error_message == 1146){
     	echo "You are trying to read the data from a table which doesn't exist in your 			database "."'".$database."'";
     }
    mysqli_close($connection);
?>

出力:

mysqli エラー関数を使用してエラーを表示する-mysqli_errno.png を使用したカスタムエラーメッセージ

MySQL の mysqli_error_list() 関数

この関数は、必要なすべての情報を含む配列を返すため、エラーコード、SQL 状態、およびエラーの説明を知るのに非常に役立ちます。

サンプルコード:

<?php
     $host = "localhost";
     $username = "root";
     $password = "";
     $database = "person";

     $connection = mysqli_connect($host, $username, $password, $database) 
     or die("Connection Failed"); 

     $sql = "SELECT * FROM person";
     $result = mysqli_query($connection, $sql);
     print_r(mysqli_error_list($connection));
     mysqli_close($connection);
?>

出力:

mysqli エラー関数を使用してエラーを表示する-mysqli_error_list を使用してエラーリスト

MySQL の mysqli_connect_error() 関数

mysqli_connect_error() は、最後の接続がある場合は、最後の接続からのエラーの説明を返します。ただし、die() 関数は接続の失敗を通知しますが、mysqli_connect_error() は簡単に理解できるエラーを返します。

最初に次のコードを記述し、その出力を確認してから、mysqli_connect_error() によって生成された出力と比較します。

<?php
     $host = "localhost";
     $username = "root";
     $password = "";
     $database = "person";

     $connection = mysqli_connect($host, $username, $password, $database) 
     or die("Connection Failed"); 

     $sql = "SELECT * FROM person";
     $result = mysqli_query($connection, $sql);
     $error_message = mysqli_error($connection);

     if($error_message != ""){
     	echo "Query Failed: ".$error_message;
      }
    mysqli_close($connection);
?>

出力:

mysqli エラー関数を使用してエラーを表示する-mysqli_connect_error を使用したエラーを表示する

上記の出力を参照してください。理解できるエラーは途中にあることがわかります。

想像してみてください。2つまたは 3つのエラーがある場合、それを見つけるのは簡単ではありません。ここで、mysqli_connect_error() を使用し、次のコードと出力を使用して違いを確認します。

<?php
     $host = "localhost";
     $username = "newroot";
     $password = "";
     $database = "person";

     $connection = mysqli_connect($host, $username, $password, $database) 
     or die("Connection Failed: ".mysqli_connect_error()); 

     $sql = "SELECT * FROM teacher";
     $result = mysqli_query($connection, $sql);
     $error_message = mysqli_error($connection);

     if($error_message != ""){
     	echo "SQL Query Failed: ".$error_message;
    }
    mysqli_close($connection);
?>

出力:

mysqli エラー関数を使用したエラーの表示-mysqli_connect_error パート b を使用したエラー

上記の出力は、データベースへのアクセスを許可しない newroot という名前のユーザーがいないことを明確に示しています。

MySQL の mysqli_connect_errno() 関数

この関数は mysqli_connect_error() のように動作しますが、エラーメッセージではなくエラーコードを表示します。このエラーコードを使用して、カスタムエラーメッセージを作成できます。

サンプルコード:

<?php
     $host = "localhost";
     $username = "newroot";
     $password = "";
     $database = "person";

     $connection = mysqli_connect($host, $username, $password, $database) 
     or die("Connection Failed: ".mysqli_connect_errno()); 

     $sql = "SELECT * FROM teacher";
     $result = mysqli_query($connection, $sql);
     $error_message = mysqli_error($connection);

     if($error_message != ""){
	     echo "SQL Query Failed: ".$error_message;
     }
     mysqli_close($connection);
?>

出力:

mysqli エラー関数を使用してエラーを表示する-mysqli_connect_errno を使用してエラーを表示する

まとめ

すべての議論と例を考慮して、2つの主要なカテゴリーを結論付けました。最初のカテゴリは SQL クエリに関するエラーを示し、他のカテゴリはデータベース接続に関するエラーを示します。

プロジェクトのニーズに応じて、各カテゴリのエラーメッセージまたはエラーコードを出力できます。

チュートリアルを楽しんでいますか? <a href="https://www.youtube.com/@delftstack/?sub_confirmation=1" style="color: #a94442; font-weight: bold; text-decoration: underline;">DelftStackをチャンネル登録</a> して、高品質な動画ガイドをさらに制作するためのサポートをお願いします。 Subscribe
著者: Mehvish Ashiq
Mehvish Ashiq avatar Mehvish Ashiq avatar

Mehvish Ashiq is a former Java Programmer and a Data Science enthusiast who leverages her expertise to help others to learn and grow by creating interesting, useful, and reader-friendly content in Computer Programming, Data Science, and Technology.

LinkedIn GitHub Facebook

関連記事 - MySQL Error