الدالة umask()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تغيِّر الدالة umask()‎ قيمة القناع umask الحاليَّة.

الوصف

int umask ([ int $mask ] )

تضبط هذه الدالة قيمة القناع umask في PHP إلى القيمة mask & 0777 ثمَّ تعيد قيمة umask السابقة. عندما تُستعمل PHP كوحدة من وحدات الخادم، فستُستعاد قيمة umask عند انتهاء كلِّ طلب.

المعاملات

mask

قيمة umask الجديدة.

القيم المعادة

تُعاد قيمة umask الحاليَّة إن لم يُمرَّر أيُّ معامل، أو ستُعاد قيمة umask السابقة خلافًا لذلك.

أمثلة

المثال 1: استعمال الدالة umask()‎

<?php
$old = umask(0);
chmod("/path/some_dir/some_file.txt", 0755);
umask($old);

// إجراء عملية التحقق
if ($old != umask()) {
    die('An error occurred while changing back the umask');
}
?>

ملاحظات

تجنَّب استعمال هذه الدالة مع خوادم الويب متعدِّدة الخيوط (multithreaded). من الأفضل تغيير أذونات الملف باستعمال الدالة chmod()‎ بعد إنشاء الملف. يمكن أن يؤدِّي استعمال الدالة umask()‎ آنذاك إلى سلوك غير متوقع للسكربتات التي تعمل في آن واحد ولخادم الويب بذاته لأنها تستعمل جميعها القيمة umask نفسها.

مصادر

• صفحة الدالة umask في توثيق PHP الرسمي.