PHP เข้าใจ error, warning และ error reporting
PHP มีระบบ error 2 ยุคซ้อนกัน: exception (บทที่ 24) สำหรับโค้ดสมัยใหม่ และ error/warning/notice แบบเดิมที่ฟังก์ชันในตัวหลายตัวยังใช้ ต้องรู้จักทั้งคู่
ระดับของ error แบบเดิม
| ระดับ | ความรุนแรง | ตัวอย่าง | สคริปต์ตายไหม |
|---|---|---|---|
E_ERROR | ร้ายแรง | เรียกฟังก์ชันที่ไม่มี, out of memory | ตาย |
E_WARNING | เตือน | fopen() ไฟล์ไม่มี, หารด้วย 0 (บางกรณี) | ไม่ตาย ทำงานต่อ |
E_NOTICE / E_WARNING | เล็กน้อย | อ่านตัวแปร/key ที่ไม่มี | ไม่ตาย |
E_DEPRECATED | จะเลิกใช้ | ใช้ฟีเจอร์ที่จะถูกลบเวอร์ชันหน้า | ไม่ตาย |
PHP 8 ยกระดับหลายอย่างที่เคยเป็น notice ให้เป็น warning หรือ
Errorเช่น อ่าน array key ที่ไม่มีเป็น warning, เรียกเมธอดบน null เป็นError(สคริปต์ตาย)
<?php
declare(strict_types=1);
$data = ['name' => 'อร'];
echo $data['age']; // Warning: Undefined array key "age" (ทำงานต่อ ได้ null)
$obj = null;
echo $obj->name; // Error: Attempt to read property on null (ตาย)error_reporting และ display_errors
2 ค่านี้คุมพฤติกรรม (ตั้งใน php.ini หรือด้วยโค้ด):
<?php
// บนสุดของ entry point ตอน dev
error_reporting(E_ALL); // รายงานทุกระดับ
ini_set('display_errors', '1'); // แสดง error ออกจอ; php.ini สำหรับ development
error_reporting = E_ALL
display_errors = On; php.ini สำหรับ production
error_reporting = E_ALL
display_errors = Off ; ห้ามโชว์ error ให้ผู้ใช้เห็น (รั่ว path, โครงสร้าง)
log_errors = On
error_log = /var/log/php/error.logกฎเหล็ก: dev = แสดง error ทุกอย่างทันที, production = ซ่อนจากผู้ใช้ + เขียน log
ทำไม display_errors=Off บน production
error ที่โชว์ให้ผู้ใช้เห็นมักมี path เต็ม (/var/www/app/src/Db/...), query, ค่า config — เป็นข้อมูลให้คนไม่หวังดี และดูไม่โปรฟชันแนล ผู้ใช้ควรเห็นหน้า “ขออภัย เกิดข้อผิดพลาด” ส่วนรายละเอียดไปอยู่ใน log
เขียน log เอง
<?php
error_log('ชำระเงินล้มเหลว: order 1234, gateway timeout');
// เขียนไฟล์เจาะจง
error_log(
date('c') . " payment failed\n",
3,
__DIR__ . '/logs/payment.log',
);โปรเจกต์จริงมักใช้ Monolog (composer require monolog/monolog) ที่จัดการ log level, หมุนไฟล์, ส่งเข้า Slack/Sentry ได้
เปลี่ยน warning เป็น exception
warning จากฟังก์ชันเก่า ๆ ดักด้วย try/catch ไม่ได้ — แปลงเป็น exception ด้วย set_error_handler:
<?php
declare(strict_types=1);
set_error_handler(function (int $severity, string $message, string $file, int $line): bool {
// เคารพ error_reporting (เช่น @ operator หรือระดับที่ปิดไว้)
if (!(error_reporting() & $severity)) {
return false;
}
throw new \ErrorException($message, 0, $severity, $file, $line);
});
// ตอนนี้ warning กลายเป็น exception ที่ catch ได้
try {
$content = file_get_contents('/ไฟล์/ไม่มี/จริง');
} catch (\ErrorException $e) {
echo "อ่านไฟล์ไม่ได้: {$e->getMessage()}\n";
}ฟังก์ชันสมัยใหม่หลายตัวมี flag ให้ throw ตรง ๆ อยู่แล้ว เช่น
json_decode($s, flags: JSON_THROW_ON_ERROR),new DateTimeImmutable()(throw),intdiv()(throwDivisionByZeroError) — ใช้เวอร์ชันที่ throw ถ้ามี
จับ exception และ error ที่หลุดถึง top-level
<?php
// bootstrap.php
set_exception_handler(function (\Throwable $e): void {
error_log(sprintf(
"Uncaught %s: %s in %s:%d\n%s",
$e::class, $e->getMessage(), $e->getFile(), $e->getLine(),
$e->getTraceAsString(),
));
http_response_code(500);
if (PHP_SAPI === 'cli') {
fwrite(STDERR, "เกิดข้อผิดพลาด\n");
} else {
echo "ขออภัย เกิดข้อผิดพลาด กรุณาลองใหม่ภายหลัง";
}
exit(1);
});register_shutdown_function() จับ fatal error (เช่น out of memory) ที่ handler ปกติจับไม่ได้:
<?php
register_shutdown_function(function (): void {
$err = error_get_last();
if ($err !== null && in_array($err['type'], [E_ERROR, E_PARSE, E_COMPILE_ERROR], true)) {
error_log("Fatal: {$err['message']} in {$err['file']}:{$err['line']}");
http_response_code(500);
}
});@ operator — อย่าใช้
@ หน้า expression ปิด error ของบรรทัดนั้น:
<?php
$data = @file_get_contents($url); // ปิด warning — แล้วเราไม่รู้ว่าพังเพราะอะไรปัญหา: กลืน error ทุกอย่างรวมถึงที่เราอยากรู้ และช้า ใช้การเช็คเงื่อนไขหรือ try/catch แทน:
<?php
$data = file_get_contents($url);
if ($data === false) {
throw new RuntimeException("โหลด $url ไม่ได้");
}dev เทียบ production สรุปเป็นตาราง
| development | production | |
|---|---|---|
display_errors | On | Off |
error_reporting | E_ALL | E_ALL |
log_errors | On (หรือดูจอ) | On |
| แสดงให้ผู้ใช้ | error เต็ม ๆ | หน้า error สุภาพ |
| opcache | ปิด/revalidate | เปิด |
เรื่องที่คนมักพลาด
display_errors=Onบน production — รั่วข้อมูลระบบ ต้องOff+ logerror_reportingต่ำกว่าE_ALLเพื่อ “ให้เงียบ” — ซ่อนบั๊กจริง เก็บE_ALLไว้แล้วแก้ให้หมด- ใช้
@ดับ warning — ดีบั๊กภายหลังแทบเป็นไปไม่ได้ - คิดว่า
try/catchจับ warning จากฟังก์ชันเก่าได้ — ไม่ได้ ต้องset_error_handlerแปลงก่อน หรือใช้ฟังก์ชันที่ throw - ไม่มี
set_exception_handlerที่ entry point — exception ที่หลุดจะโชว์ stack trace เต็ม ๆ ให้ผู้ใช้ - ตั้งค่าใน
php.iniแต่ลืมว่า CLI กับ php-fpm ใช้ ini คนละไฟล์ — เช็คด้วยphp --iniและphpinfo()ในหน้าเว็บ
สรุป
- PHP มี error/warning/notice แบบเก่า (ฟังก์ชันในตัว) + exception แบบใหม่ — PHP 8 ยกหลายอย่างเป็น
Errorที่ทำสคริปต์ตาย - dev:
display_errors=On+E_ALL/ production:display_errors=Off+log_errors=On - ห้ามโชว์ error ให้ผู้ใช้ production เห็น — เขียน log แทน (Monolog สำหรับงานจริง)
set_error_handlerแปลง warning เป็นErrorExceptionที่ catch ได้ — หรือใช้ฟังก์ชันที่ throw เองset_exception_handler+register_shutdown_functionที่ entry point เพื่อจับทุกอย่างที่หลุด- อย่าใช้
@
จบเฟส 4 บทถัดไปเข้าเฟสเว็บ เริ่มที่วงจร request–response และ superglobals — พื้นฐานที่ต้องเข้าใจก่อนทำเว็บด้วย PHP