توابع setlocale() PHP

مثال

تنظیم جغرافیا به US English و سپس تنظیم به تنظیمات پیش‌فرض سیستم:

<?php
echo setlocale(LC_ALL,"US");
echo "<br>";
echo setlocale(LC_ALL,NULL);
?>

مثال‌های اجرایی

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

توابع setlocale() اطلاعات جغرافیایی (اطلاعات جغرافیایی) را تنظیم می‌کند.

اطلاعات جغرافیایی شامل زبان، پول، زمان و سایر اطلاعات مربوط به یک منطقه جغرافیایی است.

نکات:توابع setlocale() تنها اطلاعات جغرافیایی را برای اسکریپت فعلی تغییر می‌دهد.

توضیحات:می‌توان اطلاعات جغرافیایی را با استفاده از setlocale(LC_ALL,NULL) به تنظیمات پیش‌فرض سیستم تنظیم کرد.

توضیحات:برای اطلاعات فرمت اعداد، لطفاً به localeconv() توابع.

نحوه استفاده

setlocale(ثابت,مکان)
پارامترها توضیحات
ثابت

ضروری. مشخص می‌کند که باید چه اطلاعات جغرافیایی‌ای تنظیم شود.

مقدارهای موجود:

  • LC_ALL - شامل تمامی گزینه‌های زیر
  • LC_COLLATE - مرتب‌سازی ترتیب
  • LC_CTYPE - دسته‌بندی و تبدیل کاراکترها (مثلاً همه کاراکترها بزرگ یا کوچک)
  • LC_MESSAGES - قالب پیام‌های سیستم
  • LC_MONETARY - قالب پول
  • LC_NUMERIC - قالب عدد
  • LC_TIME - قالب تاریخ و زمان
مکان

ضروری. تنظیم اطلاعات منطقه‌ای برای کشور/منطقه. می‌تواند یک رشته یا آرایه باشد. می‌توان چندین مکان را ارسال کرد.

اگر مکان پارامتر NULL یا رشته خالی "" است، نام مکان به مقدار محیطی مشابه یکی از مقادیر ثابت‌های بالا یا بر اساس "LANG" تنظیم می‌شود.

اگر مکان پارامتر "0" است، تنظیمات مکان تأثیری ندارد و تنظیمات فعلی برمی‌گردانده می‌شود.

اگر مکان پارامتر یک آرایه است، setlocale() سعی می‌کند هر عنصر آرایه را امتحان کند تا یک زبان یا کد منطقه‌ای معتبر پیدا کند. اگر نام یک منطقه در سیستم‌های مختلف نام‌گذاری شده باشد، این نکته مفید است.

نکات:برای مشاهده تمام کد زبان‌های موجود، لطفاً بهدستورالعمل‌های کد زبان.

جزئیات فنی

مقدار برمی‌گردانده: تنظیمات منطقه‌ای فعلی را برمی‌گرداند، اگر شکست بخورد FALSE برمی‌گرداند. مقدار برمی‌گردانده بستگی به سیستم اجرای PHP دارد.
نسخه PHP: 4+
گزارش به‌روزرسانی‌ها:

در PHP 4.2.0 ارسال یک ثابت به عنوان رشته مستهلک شده است، این کار مستهلک شده است. از مقادیر ثابت موجود استفاده کنید. ارسال یک ثابت به عنوان رشته باعث ارسال یک اخطار هشدار می‌شود.

در PHP 4.3.0 می‌توان چندین مکان را ارسال کرد.

از PHP 5.3.0 به بعد، اگر به ثابت پارامتر یک رشته است، نه یکی از مقادیر LC_، این فنکشن یک اخطار E_DREPRECATED ارسال می‌کند.