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() (throw DivisionByZeroError) — ใช้เวอร์ชันที่ 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 สรุปเป็นตาราง

developmentproduction
display_errorsOnOff
error_reportingE_ALLE_ALL
log_errorsOn (หรือดูจอ)On
แสดงให้ผู้ใช้error เต็ม ๆหน้า error สุภาพ
opcacheปิด/revalidateเปิด

เรื่องที่คนมักพลาด

  • display_errors=On บน production — รั่วข้อมูลระบบ ต้อง Off + log
  • error_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