معالجة الأخطاء

الإصدار: v2.3.0

الأخطاء ومعالجة الأخطاء

يوفر PDO ثلاثة أوضاع لمعالجة الأخطاء يمكنك تكوينها على الاتصال. اقرأ المزيد على https://www.php.net/manual/en/pdo.error-handling.php.

$database = new Medoo([
	// مطلوب.
	'type' => 'mysql',
	'host' => 'localhost',
	'database' => 'name',
	'username' => 'your_username',
	'password' => 'your_password',

	// اختياري.
	// PDO::ERRMODE_SILENT (الافتراضي) | PDO::ERRMODE_WARNING | PDO::ERRMODE_EXCEPTION
	'error' => PDO::ERRMODE_SILENT,
]);

PDO::ERRMODE_SILENT (افتراضي)

في هذا الوضع، يقوم PDO بتعيين رموز الخطأ بدون مطالبة. يمكنك قراءة رسالة الخطأ من $database->error ومعلومات الخطأ التفصيلية من $database->errorInfo.

$database = new Medoo([
	// ...
	'error' => PDO::ERRMODE_SILENT
]);

$database->select("bccount", "*");

var_dump($database->error);
var_dump($database->errorInfo);

// string(36) "Table 'master.bccount' doesn't exist"
//
// array(3) {
//   [0]=> string(5) "42S02"
//   [1]=> int(1146)
//   [2]=> string(36) "Table 'master.bccount' doesn't exist"
// }

PDO::ERRMODE_WARNING

PDO يرسل رسالة تحذير E_WARNING تقليدية. وهذا مفيد أثناء التطوير لأن التنفيذ مستمر. لا يزال بإمكانك قراءة الأخطاء من خلال $database->error، تمامًا كما في PDO::ERRMODE_SILENT.

$database = new Medoo([
	// ...
	'error' => PDO::ERRMODE_WARNING
]);

$database->select("bccount", "*");

var_dump($database->error);
var_dump($database->errorInfo);

// Warning:  PDOStatement::execute(): SQLSTATE[42S02]: Base table or view not found:
// 1146 Table 'bccount' doesn't exist in /src/Medoo.php on line 10
//
// string(36) "Table 'master.bccount' doesn't exist"
//
// array(3) {
//   [0]=> string(5) "42S02"
//   [1]=> int(1146)
//   [2]=> string(36) "Table 'master.bccount' doesn't exist"
// }

PDO::ERRMODE_EXCEPTION

PDO يطرح PDOException ويوقف التنفيذ اللاحق، مما يساعدك على تحديد مسارات التعليمات البرمجية الفاشلة بسرعة.

$database = new Medoo([
	// ...
	'error' => PDO::ERRMODE_EXCEPTION
]);

$database->select("bccount", "*");

// لن يتم تنفيذ هذا السطر.
var_dump($database->error);

// Fatal error:  Uncaught PDOException: SQLSTATE[42S02]: Base table or view not found
// 1146 Table 'master.bccount' doesn't exist in /src/Medoo.php:10
// Stack trace:
// #0 /src/Medoo.php(564): PDOStatement->execute()
// #1 /src/Medoo.php(1652): Medoo\Medoo->exec(Object(PDOStatement), Array)
// #2 /var/www/playground/index.php(44): Medoo\Medoo->select('bccount', Array, Array)
// #3 {main}
// thrown in /src/Medoo.php line 10

// استخدم try-catch لمعالجة رسالة الاستثناء وطباعتها.
try {
	$database->select("bccount", "*");
} catch (PDOException $e) {
	echo $e->getMessage();
}

// SQLSTATE[42S02]: Base table or view not found: 1146 Table 'master.bccount' doesn't exist

التحقق من الخطأ

في PDO::ERRMODE_SILENT وPDO::ERRMODE_WARNING، يكون $database->error و$database->errorInfo null عند عدم حدوث أي خطأ. يمكنك التحقق من null لتحديد ما إذا كان هناك خطأ ما.

$database->select("bccount", "*");

if ($database->error) {
	echo "حدث خطأ.";
}

// حدث خطأ.

$database->select("account", "*");

if (!$database->error) {
    echo "لا يوجد خطأ.";
}

// لا يوجد خطأ.