توابع error_log() PHP

مثال

پیام خطا را به لاگ سرور وب و آدرس ایمیل حساب کاربری ارسال کنید:

<?php
// اگر به پایگاه داده اشتباهی متصل شد، پیام خطا را به لاگ سرور ارسال کنید
if (!mysqli_connect("localhost","bad_user","bad_password","my_db")) {
    error_log("Failed to connect to database!", 0);
}
// اگر FOO تمام شد، به مدیر ارسال ایمیل
if (!($foo = allocate_new_foo())) {
    error_log("Oh no! We are out of FOOs!", 1, "admin@example.com");
}
?> 

تعریف و استفاده

error_log() فنکشن پیام‌های خطا را به لاگ‌های سرور، فایل یا هدف‌های دوربرد ارسال می‌کند.

قوانین دستور زبان

error_log(message,type,destination,headers);
پارامتر توضیح
message ضروری. پیام خطایی که باید ثبت شود را مشخص می‌کند.
type

اختیاری. مشخص می‌کند که خطا باید به کجا ارسال شود. مقادیر ممکن:

  • 0 - پیش‌فرض. پیام به لاگ سیستم PHP ارسال می‌شود، از طریق مکانیزم لاگ سیستم عامل یا یک فایل، بسته به تنظیمات error_log در php.ini بستگی دارد.
  • 1 - پیام به پارامتر ارسال می‌شود destination آدرس پست الکترونیکی تنظیم شده. چهارمین پارامتر extra_headers فقط در این نوع استفاده می‌شود.
  • 2 - دیگر استفاده نمی‌شود (فقط در PHP 3 استفاده می‌شود)
  • 3 - پیام به مکان destination در فایل. کاراکتر message به طور پیش‌فرض به عنوان یک خط جدید در نظر گرفته نمی‌شود.
  • 4 - پیام مستقیماً به پردازنده‌ی لاگ SAPI ارسال می‌شود.
destination اختیاری. هدف پیام خطا را مشخص می‌کند. این مقدار توسط type مقدار پارامتر تعیین می‌کند.
headers

اختیاری. سربرگ‌های اضافی را مشخص می‌کند، مانند From،Cc و Bcc. این نوع اطلاعات از همان فرمول داخلی mail() استفاده می‌کند.

تنها زمانی که message_type وقتی که تنظیم به 1 شود استفاده می‌شود.

باید از CRLF (\r\n) برای جدا کردن چندین سربرگ استفاده شود.

جزئیات فنی

مقدار بازگشتی: اگر موفق شد TRUE برمی‌گرداند، اگر شکست خورد FALSE برمی‌گرداند.
نسخه PHP: 4.0+
لوگ‌های به‌روزرسانی PHP: PHP 5.2.7: مقادیر ممکن: 4 اضافه شد به type پارامترها.