عرض مصدر PHP/mkdir

<noinclude>{{DISPLAYTITLE:الدالة <code>mkdir()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تنشئ الدالة <code>mkdir()‎</code> مجلَّدًا جديدًا.

== الوصف ==
<syntaxhighlight lang="php">
bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = FALSE [, resource $context ]]] )
</syntaxhighlight>تحاول هذه الدالة إنشاء مجلَّد جديد في المسار <code>pathname</code> المُعطى.

== المعاملات ==

=== <code>pathname</code> ===
مسار المجلَّد المُراد إنشاؤه.

=== <code>mode</code> ===
أذونات المجلَّد الجديد، وقيمة هذا المعامل الإفتراضيَّة هي 0777 أي أوسع مجال لأذونات الوصول للمجلَّد. للمزيد من المعلومات حول الأذونات، راجع صفحة الدالة <code>[[PHP/chmod|chmod()‎]]</code>.

'''ملاحظة''': يُتجاهل المعامل <code>mode</code> على منصات ويندوز.

الجدير بالملاحظة أنَّه يجب عليك غالبًا تمثيل الأذونات المُختارة باستعمال الأرقام في النظام الثماني إذ يجب بناءً على ذلك البدء بالرقم 0 دومًا. يمكن أيضًا تعديل الأذونات باستعمال القيمة <code>umask</code> الحاليَّة التي يمكن تغييرها باستخدام الدالة <code>[[PHP/umask|umask()‎]]</code>.

=== <code>recursive</code> ===
السماح بإنشاء مجلَّدات متشعِّبة -مجلَّد داخل مجلَّد آخر- في المسار <code>pathname</code> المعطى.

=== <code>context</code> ===
'''ملاحظة''': أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم [[PHP/streams|المجرى]] (stream) للمزيد من الشرح عن المحتوى (context).

== القيم المعادة ==
تُعاد القيمة <code>TRUE</code> عند نجاح العمليَّة، أو القيمة <code>FALSE</code> عند فشلها.

== أمثلة ==
المثال 1: استعمال الدالة <code>mkdir()‎</code><syntaxhighlight lang="php">
<?php

mkdir("/path/to/my/dir", 0700);

?>
</syntaxhighlight>المثال 2: استعمال الدالة <code>mkdir()‎</code> مع المعامل <code>recursive</code><syntaxhighlight lang="php">
<?php
// البنية المطلوبة للمجلد
$structure = './depth1/depth2/depth3/';

//mkdir() إلى الدالة recursive يجب من أجل إنشاء مجلدات ذات بنية متشعبة تمرير قيمة المعامل

if (!mkdir($structure, 0777, true)) {
    die('Failed to create folders...');
}

// ...
?>
</syntaxhighlight>

== الأخطاء والاستثناءات ==
سيُولَّد خطأ من المستوى <code>E_WARNING</code> إن كان المجلَّد المراد إنشاؤه موجودًا مسبقًا.

سيُولَّد خطأ من المستوى <code>E_WARNING</code> إن كنت لا تملك صلاحيات لإنشاء المجلَّد في المسار المعطى، أي قد لا تسمح لك الأذونات بذلك.

== ملاحظات ==
* ستُخزَّن نتيجة هذه الدالة. راجع الدالة <code>[[PHP/clearstatcache|clearstatcache()‎]]</code> للمزيد من التفاصيل.
* يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

== انظر أيضًا ==
* الدالة <code>[[PHP/is dir|is_dir()‎]]</code>: تتحقَّق إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلدًا.
* الدالة <code>[[PHP/rmdir|rmdir()‎]]</code>: تحذف مجلَّدًا محدَّدًا.

== مصادر ==
* [http://php.net/manual/en/function.mkdir.php صفحة الدالة mkdir في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Filesystem]]