نتائج البحث

(PHP 4 >= 4.0.3, PHP 5, PHP 7) تنقل الدالة move_uploaded_file()‎ ملفًا مرفوعًا إلى موقع جديد. الوصف bool move_uploaded_file ( string $filename , string $destination ) تتحقَّق هذه الدالة إن كان الملف filename مرفوعًا بطريقة صحيحة (أي أنَّه رُفِع باستعمال الطريقة POST) ثمَّ تنقله إلى الموقع destination المعطى. التحقُّق الذي تجريه الدالة له أهمية كبيرة إذ يمكن مصادفةً أن تؤدي أي عمليَّة تُجرى على الملفات المرفوعة إلى إظهار محتواها للمستخدم أو المستخدمين الآخرين الموجودين على النظام ذاته. المعاملات filename اسم الملف ...

مقدمة تُوفِّر الواجهات الساكنة واجهة "ساكنة" (static) للأصناف المتوافرة في حاوي خدمات تطبيقك. يأتي Laravel مع عدة واجهات تمكنك من استخدام كل خاصيات Laravel تقريبًا. تمثل واجهات Laravel الساكنة "وسطاء ساكنات" (static proxies) للأصناف الأساسية بحاوي الخدمات مما يوفر كل فوائد الصِّيغ (syntax) المقتضبة والمُعبِّرة مع الحفاظ على قابلية الاختبار ومرونة أكبر من الدالات الساكنة التقليدية. كل واجهات Laravel الساكنة مُعرَّفةٌ في مجال الأسماء Illuminate\Support\Facades. يمكننا الوصول لواجهة ساكنة بهذه الطريقة: use Illuminate\Support\Facades\Cache; Route::get('/cache', function () { return ...

مقدمة حاوي خدمات Laravel (أي Laravel service container) هو أداةٌ قوية لإدارة اعتِماديَّات (dependencies) الصِّنف والقيام بإضافة اعتِماديَّات (dependency injection)." إضافة الاعتِماديَّات" هو مصطلح تقني يعني في مُجمله "إضافة" اعتماديات الصنف باستخدام التابع الباني (constructor) أو في بعض الحالات توابع ضبط القيم (setter). لنلقِ نظرة على هذا المثال البسيط: <?php namespace App\Http\Controllers; use App\User; use App\Repositories\UserRepository; use App\Http\Controllers\Controller; class UserController extends Controller { /** * مستودع المُستخدِم تطبيق * * @var ...

مقدمة عقود Laravel هي مجموعة من الواجهات (interfaces) التي تعرِّف الخدمات المركزية التي يوفرها إطار العمل. على سبيل المثال، يعرِّف العقد Illuminate\Contracts\Queue\Queue  الدوال اللازمة لصف الأعمال في الطوابير، بينما يعرِّف عقد Illuminate\Contracts\Mail \Mailer الدوال اللازمة لإرسال رسائل البريد الإلكتروني. لكل عقد تعريف استخدام (implementation) يوفره إطار العمل. على سبيل المثال، يوفِّر Laravel تعريف استخدام للطابور لعدة أنواع من المشغلات (drivers) كما يوفِّر تعريف استخدام للمُرسِل مشغل بواسطة SwiftMailer. توجد كل عقود Laravel في مستودعات في GitHub. هذا يوفر نقطة مرجعية سريعة لكل ...

يبحث التّابع find عن ترميزٍ باسمٍ محدّد. الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية: "external": يمثل الترميز الخارجي الافتراضي (default external encoding). "internal": يمثل الترميز الداخلي الافتراضي (default external encoding). "locale": يمثل الترميز المحدد في المحلية (locale encoding). "filesystem": يمثل ترميز نظام الملفات (filesystem encoding). البنية العامة find(string) → enc المعاملات string سلسلة نصية تمثل اسم الترميز المراد البحث عنه. القيم المعادة يعاد الترميز ذو الاسم string في حال ...

مقدمة يوفّر Laravel تجريدًا قويًا لنظام الملفات بفضل الحزمة Flysystem. يوفّر تضمين أنظمة الملفات في Laravel مشغّلات سهلة الاستعمال للتعامل مع الأنظمة المحلية و Amazon S3 والتخزين السحابي Rackspace، بل من السهل جدًا تغيير خيارات التخزين إذ تبقى وصلة API نفسها مع كل الأنظمة. الضبط يوجد ملف ضبط نظام الملفات في config/filesystems.php. يمكنك في هذا الملف ضبط كل الأقراص "disks". يمثّل كل قرص مشغّل تخزين ومكان تخزين خاص. يحتوي الملف على أمثلة ضبط لكل مشغّل مدعوم. لذا غيّر الملف حسب ...

توفر Sass عددًا من التّخصيصات المتقدِّمة لأجل المستخدمين ذوي المتطلبات الفريدة. استخدام هذه الميزات يتطلب فهمًا جيدًا للغة Ruby. تعريف دوال مخصَّصةٍ في Sass يمكن للمستخدمين تعريف دوال Sass خاصةً بهم باستخدام Ruby API. انظر لمزيدٍ من المعلومات توثيق الدوال. التخزين المؤقت (Cache Stores) تُخزِّن Sass مؤقتًا الملفّات المُحلّلة (parsed documents) وبذلك يمكن إعادة استخدامها دون إعادة تحليلها إلّا إن حدثت تغيرات في الملف. افتراضيًا، ستكتب Sass هذه الملفات المُخزّنة مؤقتًا في مكانٍ في نظام الملفات (filesystem) المشار إليه في ...

(PHP 5 >=5.3.2,  PHP 7) تجلب الدالة realpath_cache_get()‎ محتويات المسار الحقيقي المخزَّنة. الوصف array realpath_cache_get ( void ) تجلب هذه الدالة محتويات المسار الحقيقي المُخزنَّة. القيم لمعادة تُعاد مصفوفة تحتوي على مدخلات المسار الحقيقي المُخزنَّة. قيم مفاتيح تلك المصفوفة هي المدخلات الأساسيَّة للمسار ومحتواها هو مصفوفات تحتوي على عناصر البيانات من ضمنها المسار المستبين (resolved path)، وتاريخ انتهاء الصلاحيَّة، والخيارات الأخرى التي ما تزال مخزَّنة. أمثلة المثال 1: استعمال الدالة realpath_cache_get()‎ <?php var_dump(realpath_cache_get()); ?> سيُظهر المثال السابق نتيجة مشابهة للتالي: array(2) { ["/test"]=> ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chown()‎ مالك الملف. الوصف bool chown ( string $filename , mixed $user ) تحاول هذه الدالة تغيير مالك الملف filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. user اسم المالك الجديد أو رقم مُعرِّفه. القيم المعادة تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة ...

(PHP 4, PHP 5, PHP 7) تمسح الدالة clearstatcache()‎ حالة الملف المُخزَّنة. الوصف void clearstatcache ([ bool $clear_realpath_cache = FALSE [, string$filename ]] ) تُخزِّن PHP المعلومات التي تعيدها بعض الدوال المُستخدمة مثل الدالة stat()‎ والدالة lstat()‎، أو أي دالة من الدوال المذكورة في الأسفل، وذلك من أجل رفع الأداء؛ لكن قد تضطر في بعض الحالات إلى مسح تلك المعلومات المخزَّنة. إن تحققنا من حالة ملفٍ ما عدَّة مرات في سكربت واحد، وكان ذلك الملف عرضةً للحذف أو النقل خلال عمل ...

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تبحث الدالة glob()‎ عن مسارات محدَّدة لملفات أو مجلَّدات والتي تتطابق مع نمط مُعطى. الوصف array glob ( string $pattern [, int $flags = 0 ] ) تبحث هذه الدالة عن جميع المسارات التي تُطابق النمط pattern وفقًا للقواعد التي تستخدمها المكتبة libc للدالة glob()‎، والتي تشبه نظيرتها المستخدمة من قبل أشهر الصدفات (shells). المعاملات pattern التعبير النمطي المُعطى. الرمز ~ (المَدَّة [tilde]) غير مدعوم، كما أنَّه لا يُجرى أي عملية استبدال للمعاملات. ...

(PHP 4, PHP 5, PHP 7) تضبط الدالة touch()‎ وقت الوصول والتعديل للملف. الوصف bool touch ( string $filename [, int $time = time() [, int $atime ]] ) تحاول هذه الدالة ضبط وقت الوصول والتعديل للملف ذو المسار filename إلى القيمة time المعطاة. الجدير بالذكر أنَّ وقت الوصول يُعدَّل دومًا بغض النظر عن عدد المعاملات الممرَّرة إلى الدالة. إن لم يكن الملف موجودًا، فسيُنشأ آنذاك. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. time وقت الوصول والتعديل المراد تغييره للملف ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة tempnam()‎ ملفًا ذو اسم فريد من نوعه. الوصف string tempnam ( string $dir , string $prefix ) تنشئ هذه الدالة ملفًا ذو اسم مميَّز في مجلَّد محدَّد، وتكون أذوناته مضبوطة إلى القيمة 0600. إن لم يكن ذاك المجلَّد موجودًا أو كان موجودًا ولكنَّه غير قابل للكتابة، فقد تنشئ الدالة الملف في المجلَّد المؤقَّت الإفتراضي للنظام المستعمل ثمَّ تعيد مساره كاملًا والذي يتضمن اسمه أيضًا. المعاملات dir المجلَّد المراد إنشاء الملف المؤقَّت ضمنه. prefix ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة file_exists()‎ من وجود ملف أو مجلَّد محدَّد. الوصف bool file_exists ( string $filename ) تتحقَّق هذه الدالة إن كان الملف أو المجلَّد filename موجودًا أو لا. المعاملات filename مسار الملف أو المجلَّد المُراد التحقُّق من وجوده. استعمل على ويندوز المسار ‎//computername/share/filename أو ‎\\computername\share\filename للتحقُّق من الملفات المُشاركة على الشبكة. القيم المعادة تُعاد القيمة TRUE إن كان الملف أو المجلَّد المحدَّد بوساطة المعامل filename موجودًا، وتُعاد القيمة FALSE إن لم يكن. ملاحظة: ستعيد هذه ...

(PHP 4, PHP 5, PHP 7) تحمي الدالة flock()‎ ملفًا محدَّدًا أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. الوصف bool flock ( resource $handle , int $operation [, int &$wouldblock ] ) تُتيح لك هذه الدالة قفل أيَّ ملف ومنع الآخرين من القراءة منه أو الكتابة عليه وذلك أثناء إجراء عمليَّة ما على هذا الملف. يمكن استعمال هذه الدالة نظريًا على جميع الأنظمة (من ضمنها أغلب توزيعات لينكس وحتى ويندوز). كان ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetcsv()‎ سطرًا واحدًا من ملف ذي الصيغة CSV (اختصارًا للعبارة comma-separated values) وتحلِّله ثمَّ تعيد مصفوفة بالقيم التي قرأتها. الوصف array fgetcsv ( resource $handle [, int $length = 0 [, string$delimiter = "," [, string $enclosure = '"' [, string $escape = "\\"]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة fgets()‎ باستثناء أنَّها تحلِّل السطر الذي تجلبه من ملف بصيغة CSV إلى حقول ثمَّ تعيد مصفوفةً تحوي تلك الحقول التي قرأتها ...

(PHP 4, PHP 5, PHP 7) تجلب الدالة fileatime()‎ آخر وقت جرى فيه الوصول إلى الملف. الوصف int fileatime ( string $filename ) تعيد هذه الدالة آخر وقت جرى فيه الوصول إلى الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد وقت آخر وصول إلى الملف filename أو تُعاد القيمة FALSE عند فشل العمليَّة. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp). أمثلة المثال 1: استعمال الدالة fileatime()‎ <?php $filename = 'somefile.txt'; if (file_exists($filename)) { ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fileinode()‎ رقم مؤشِّر الفهرسة (inode) لملف محدَّد. الوصف int fileinode ( string $filename ) تعيد هذه الدالة رقم مؤشِّر الفهرسة للملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم مؤشِّر الفهرسة (inode) للملف filename أو القيمة FALSE عند حصول أي خطأ. أمثلة المثال 1: موازنة رقم مؤشِّر الفهرسة لملف مع نظيره للملف الحالي <?php $filename = 'index.php'; if (getmyinode() == fileinode($filename)) { echo 'You are checking the ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_link()‎ إن كان الملف وصلةً رمزيَّةً أم لا. الوصف bool is_link ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename هو وصلة رمزيَّة. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا ونوعه هو وصلة رمزيَّة، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ. أمثلة المثال 1: التحقُّق إن كان الملف المُنشأ وصلةً رمزيَّة <?php $link = 'uploads'; if (is_link($link)) { ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chdir()‎ مجلَّد PHP الحالي إلى مجلَّد آخر معطى. الوصف bool chdir ( string $directory ) تغيِّر هذه الدالة مجلَّد PHP الحالي إلى المجلَّد directory المعطى. المعاملات directory المجلَّد الحالي الجديد. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، والقيمة FALSE خلاف ذلك. الأخطاء والاستثناءات سيُصدر خطأ من المستوى E_WARNING عند فشل العمليَّة. أمثلة المثال 1: استعمال الدالة chdir()‎ <?php // معرفة المجلَّد الحالي echo getcwd() . "\n"; chdir('public_html'); // معرفة المجلَّد الحالي بعد تغييره echo getcwd() . "\n"; ?> سيُظهر ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_writable()‎ إن كان الملف قابلًا للكتابة أو لا. الوصف bool is_writable ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للكتابة. تسمح الدالة بأن تكون قيمة المعامل filename اسم مجلَّد للتأكُّد من أنَّ هذا المجلَّد قابلٌ للكتابة. تذكَّر دومًا أنَّ PHP قد تصل إلى الملف باستعمال مُعرِّف المستخدم (UID) إلا أنَّ خادم الويب يعمل على أنَّه "nobody" غالبًا. على أي حال، لا تؤخذ قيود الوضع الآمن بالحسبان قبل ...

(PHP 4, PHP 5, PHP 7) تنسخ الدالة copy()‎ ملفًا محدَّدًا وتضعه في الموقع المعطى. الوصف bool copy ( string $source , string $dest [, resource $context ] ) تُنشئ الدالة نسخةً من الملف source وتضعها في المسار dest المعطى. إن أردت نقل الملف وليس نسخه فاستعمل الدالة rename()‎. المعاملات source مسار الملف المُراد نسخه. dest المسار الذي سيُنسخ الملف إليه. إن كان هذا المعامل هو رابط URL، فقد تفشل عملية النسخ إذا كان البروتوكول المُغلِّف للمسار لا يدعم عمليَّة استبدال ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_executable()‎ إن كان الملف قابلًا للتنفيذ أم لا. الوصف bool is_executable ( string $filename ) تتحقق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للتنفيذ. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وقابلًا للتنفيذ، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ. أمثلة المثال 1: استعمال الدالة is_executable()‎ <?php $file = '/home/vincent/somefile.sh'; if (is_executable($file)) { echo $file.' is executable'; } ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filemtime()‎ وقت آخر تعديل أُجري على الملف. الوصف int filemtime ( string $filename ) تعيد هذه الدالة وقت آخر مرَّةٍ أُضيفت فيها بيانات إلى الملف filename أي وقت آخر تعديل أُجري على محتوى ذاك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد وقت آخر تعديل طُبِّقَ على محتوى الملف filename أو القيمة FALSE عند حصول أي خطأ. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp) وهو مناسب ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة symlink()‎ وصلة رمزيَّة. الوصف bool symlink ( string $target , string $link ) تنشئ هذه الدالة وصلة رمزيَّة للملف target الموجود، ويكون لها الاسم link المعطى. المعاملات target الملف المستهدف الذي ستشير إليه الوصلة. link اسم الوصلة. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. سجل التغييرات الإصدار الوصف 5.3.0 أصبحت هذه الدالة الآن متاحة على منصات ويندوز (إصدار Vista، وإصدار الخادم 2008 أو الإصدارات اللاحقة). أمثلة المثال ...

(PHP 4 >= 4.0.3, PHP 5, PHP 7) تعيد الدالة pathinfo()‎ معلومات عن مسار الملف. الوصف mixed pathinfo ( string $path [, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME ] ) تعيد هذه الدالة معلومات عن المسار path المعطى، وتكون تلك المعلومات إمَّا مصفوفة من القيم أو سلسلة نصيَّة فقط بناءً على قيمة المعامل options. ملاحظة: اقرأ للمزيد من التفاصيل حول استرجاع معلومات المسار الحالي قسم المتغيرات المُعرَّفة مسبقًا. تحذير: تأخذ الدالة pathinfo()‎ قيمة المحليَّة (locale) بالحسبان، لذا ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filesize()‎ حجم الملف. الوصف int filesize ( string $filename ) تعيد هذه الدالة حجم الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد حجم الملف filename بواحدة البايت أو القيمة FALSE مع توليد خطأ من المستوى E_WARNING عند حصول أي خطأ. ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد تعيد بعض دوال نظام الملفات نتائج مخالفة ...

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تحلِّل الدالة fscanf()‎ المدخلات من الملف وفقًا لتنسيق محدَّد. الوصف mixed fscanf ( resource $handle , string $format [, mixed &$... ] ) تشبه هذه الدالة الدالة sscanf()‎ باستثناء أنَّها تأخذ مدخلاتها من الملف الذي يشير إليه المورد handle ثمَّ تُفسِّر هذه المدخلات وفقًا للتنسيق format المُعطى الذي شُرح بالتفصيل في صفحة الدالة sprintf()‎. ملاحظة: أيُّ فراغ أبيض (whitespace) موجود في السلسلة النصيَّة format سيتطابق مع أي محرف فراغ أبيض يُعثر عليه في ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة ftell()‎ الموقع الحالي لمؤشِّر القراءة من أو الكتابة على الملف. الوصف int ftell ( resource $handle ) تعيد هذه الدالة الموقع الحالي لمؤشِّر الملف المُشار إليه باستعمال المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة popen()‎. ستعيد الدالة نتائج غير متوقَّعة عند فتح الملف باستعمال الوضع 'a' (إضافة البيانات إلى الملف فقط). القيم المعادة يُعاد عدد صحيح ...

(PHP 4, PHP 5, PHP 7) تكتب الدالة fwrite()‎ على ملف معيَّن بطريقة آمنة ثنائيًّا. الوصف int fwrite ( resource $handle , string $string [, int $length ] ) تكتب هذه الدالة محتوى السلسلة النصيَّة string على الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎. string السلسلة النصيَّة المراد كتابتها على الملف. length إن أُعطيت قيمة هذا المعامل، فستتوقف عمليَّة القراءة عند كتابة ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة readlink()‎ مسار الملف أو المجلَّد المستهدف الذي تشير إليه الوصلة الرمزيَّة. الوصف string readlink ( string $path ) تطابق هذه الدالة تمامًا الدالة readlink()‎ في لغة C. المعاملات path مسار الوصلة الرمزيَّة. القيم المعادة يُعاد محتوى الوصلة الرمزيَّة التي يشير إليها المسار أو القيمة FALSE عند حصول خطأ ما. سجل التغييرات الإصدار الوصف 5.3.0 أصبحت هذه الدالة الآن متاحة على منصات ويندوز (إصدار Vista، وإصدار الخادم 2008 أو الإصدارات اللاحقة). أمثلة المثال 1: ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة fread()‎ من ملف معيَّن بطريقة آمنة ثنائيًّا. الوصف string fread ( resource $handle , int $length ) تقرأ هذه الدالة عددًا محدودًا من البايتات (التي تحدَّدها قيمة المعامل length) من الملف الذي يشير إليه المورد handle. ستتوقَّف عمليَّة القراءة حال تحقُّق أحد الشروط التالية: إكمال قراءة البايتات التي تحدِّدها قيمة المعامل length. الوصول إلى نهاية الملف (EOF). حزمة من البيانات أًصبحت متاحة أو انتهاء مهلة المقبس (socket، وذلك عند القراءة من مجرى شبكة). ...

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تفرِّغ الدالة fflush()‎ ما في مخزن المخرجات في ملف محدَّد. الوصف bool fflush ( resource $handle ) تفرِّغ هذه الدالة جميع المخرجات المخرَّنة في الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fcolse()‎. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ذلك. أمثلة ...

(PHP 4, PHP 5, PHP 7) أصبحت الدالة fputs()‎ اسمًا بديلًا للدالة fwrite()‎. الوصف أصبحت هذه الدالة اسمًا بديلًا للدالة fwrite()‎. مصادر صفحة الدالة fputs في توثيق PHP الرسمي.

(PHP 5 >= 5.1.3, PHP 7) تغيِّر الدالة lchgrp()‎ المجموعة المالكة لوصلة رمزيَّة (symlink). الوصف bool lchgrp ( string $filename , mixed $group ) تحاول هذه الدالة تغيير المجموعة المالكة للوصلة الرمزيَّة filename إلى المجموعة group. الجدير بالذكر أنَّ المستخدم ذا امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير المجموعة المالكة لوصلة رمزيَّة إلى أيِّ مجموعة كانت. من جهة أخرى، يستطيع المستخدمون الآخرون تغيير المجموعة المالكة لوصلة رمزيَّة إلى أي مجموعة شرط أن يكونوا أعضاء فيها. ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chmod()‎ أذونات الملف. الوصف bool chmod ( string $filename , int $mode ) تغيِّر هذه الدالة أذونات الملف filename إلى النمط mode، يُشار عادةً إلى mode بالأذونات. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. mode نمط الأذونات المحدَّد. تُمثَّل الأذونات بالنظام الثماني ولا تفترض الدالة تلقائيًّا أنَّ العدد المُمرَّر إليها هو قيمة ثمانيَّة إلا إذا سُبقت تلك القيمة بالرقم 0، لذا يجب إضافة 0 دومًا لتصبح القيمة بالنظام الثماني ولتعمل الدالة بطريقة ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetc()‎ محرفًا من ملف محدَّد ثمَّ تعيده. الوصف string fgetc ( resource $handle ) تجلب هذه الدالة محرفًا واحدًا من الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎. القيم المعادة تُعاد سلسلة نصيَّة تحتوي على حرف واحد قُرِءَ من الملف الذي يشير إليه المورد handle، أو ...

(PHP 5 >=5.3.2,  PHP 7) تعيد الدالة realpath_cache_size()‎ حجم محتويات المسار الحقيقي المخزَّنة. الوصف int realpath_cache_size ( void ) تعيد هذه الدالة حجم الذاكرة الذي يستخدمه مخزن المسار الحقيقي. القيم لمعادة يُعاد حجم الذاكرة الذي يستخدمه مخزن المسار الحقيقي. أمثلة المثال 1: استعمال الدالة realpath_cache_size()‎ <?php var_dump(realpath_cache_size()); ?> سيُظهر المثال السابق نتيجة مشابهة للتالي: int(412) انظر أيضًا الدالة realpath_cache_get()‎: تعيد محتويات المسار الحقيقي المخزَّنة. مصادر صفحة الدالة realpath_cache_size في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) تنشئ الدالة link()‎ وصلةً صلبةً (hard link). الوصف bool link ( string $target , string $link ) تُنشئ هذه الدالة وصلةً صلبةً. المعاملات target الملف المستهدف الذي ستشير إليه الوصلة. link اسم الوصلة. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. سجل التغييرات الإصدار الوصف 5.3.0 أصبحت هذه الدالة الآن متاحة على منصات ويندوز (إصدار Vista، وإصدار الخادم 2008 أو الإصدارات اللاحقة). أمثلة المثال 1: إنشاء وصلة صلبة بسيطة <?php $target ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chgrp()‎ المجموعة المالكة لملف. الوصف bool chgrp ( string $filename , mixed $group ) تحاول هذه الدالة تغيير المجموعة المالكة للملف fileneame إلى المجموعة group. الجدير بالذكر أنَّ المستخدم ذا امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير المجموعة المالكة لملف إلى أي مجموعة كانت. من جهة أخرى، يستطيع المستخدمون الآخرون تغيير المجموعة المالكة لملف إلى أي مجموعة شرط أن يكونوا أعضاء فيها. المعاملات filename مسار الملف الذي ...

(PHP 4, PHP 5, PHP 7) تحذف الدالة unlink()‎ ملفًا محدَّدًا. الوصف bool unlink ( string $filename [, resource $context ] ) تحاول هذه الدالة حذف الملف ذو المسار filename المُعطى. تشبه هذه الدالة الدالة unlink()‎ في لغة C في يونكس. سيُصدر تحذير من المستوى E_WARNING عند فشل العلميَّة. المعاملات pathname مسار المجلَّد المُراد حذفه. context ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context). القيم المعادة تُعاد القيمة TRUE عند نجاح ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة dir()‎ نسخةً (instance) من الصنف Directory. الوصف Directory dir ( string $directory [, resource $context ] ) تملك هذه الدالة آلية شبه كائنيَّة التوجه لقراءة المجلَّد. سيُفتح المجلد directory المعطى. المعاملات directory مسار المجلَّد المراد فتحه. context ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context). القيم المعادة تُعاد نسخةٌ من الصنف Directory عند نجاح العمليَّة، أو القيمة NULL إن كان هنالك خطأ في ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة feof()‎ من الوصول إلى نهاية ملف (EOF) بتمرير المقبض الذي يشير إلى الملف. الوصف bool feof ( resource $handle ) تتحقَّق هذه الدالة من الوصول إلى نهاية ملف (EOF) بتمرير المقبض handle الذي يشير إلى الملف. المعاملات handle مقبض (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎. القيم المعادة تُعاد القيمة TRUE إن وصل مقبض ...

(PHP 4, PHP 5, PHP 7) مقدمة تُنشأ نُسخ (instances) الصنف Directory باستدعاء الدالة dir()‎ وليس باستعمال الكلمة المفتاحية new. ملخص الصنف Directory { // الخاصِّيات public string $path ; public resource $handle ; // التوابع public void close ([ resource $dir_handle ] ) public string read ([ resource $dir_handle ] ) public void rewind ([ resource $dir_handle ] ...

(PHP 4, PHP 5, PHP 7) تحذف الدالة rmdir()‎ مجلَّدًا محدَّدًا. الوصف bool rmdir ( string $dirname [, resource $context ] ) تحاول هذه الدالة حذف المجلَّد ذو المسار pathname المُعطى. يجب أن يكون هذا المجلَّد فارغًا ويملك أذونات تسمح بإجراء هذه العمليَّة. سيُصدر تحذير من المستوى E_WARNING عند فشل العلميَّة. المعاملات pathname مسار المجلَّد المُراد حذفه. context ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context). القيم المعادة تُعاد القيمة TRUE ...

راجع صفحة الدالة unlink()‎ والدالة unset()‎. الوصف هذه الصفحة ليست سوى صفحة وهمية هدفها إرشاد أولئك الأشخاص إلى الدالة unlink()‎ والدالة unset()‎ إن بحثوا عنهما في المكان الخطأ. انظر أيضًا الدالة unlink()‎: تحذف ملفًا. الدالة unset()‎: تلغي تعريف متغيِّر محدَّد. مصادر صفحة delete في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) تعيد الدالة realpath()‎ المسار المجرَّد الأساسي للمسار المُمرَّر إليها. الوصف string realpath ( string $path ) توسِّع هذه الدالة جميع الوصلات الرمزيَّة وتستبين المراجع التي تشير إلى /./ وإلى /../ وتزيل المحارف / (الخط المائل) الزائدة الموجودة في المسار path المعطى ثمَّ تعيد بعدئذٍ المسار المجرَّد الأساسي. المعاملات path المسار المراد فحصه. ملاحظة: لمَّا كان من الواجب تمرير المسار path، يمكن في هذه الحالة أن تكون قيمته فارغة أو القيمة NULL إذ ستُفسَّر تلك القيمة ...

(PHP 4, PHP 5, PHP 7) ترجع الدالة rewind()‎ مؤشِّر الملف إلى موقع بداية الملف. الوصف bool rewind ( resource $handle ) ترجع هذه الدالة موقع المؤشِّر للملف الذي يشير إليه المورد handle إلى بداية مجرى الملف. ملاحظة: إن فتحت الملف في وضع إضافة البيانات (الوضع a أو الوضع a+)، فإنَّ أي بيانات تكتبها على الملف ستضاف إلى نهايته دومًا بغض النظر عن موقع المؤشِّر الحالي. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة readfile()‎ من ملف معيَّن وتُظهر محتواه. الوصف int readfile ( string $filename [, bool $use_include_path = FALSE [, resource $context ]] ) تقرأ هذه الدالة كامل محتوى الملف ثمَّ تكتب محتواه على مخزن الخرج (مجرى الخرج القياسي). المعاملات filename اسم الملف المراد قراءته. use_include_path يمكنك استعمال هذا المعامل الاختياري بتمرير القيمة TRUE إن أردت البحث عن الملف في المسار المُضمَّن include_path أيضًا. context مورد مجرى المحتوى. القيم المعادة يُعاد عدد البايتات التي قُرأت ...

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تُعدُّ الدالة diskfreespace()‎ اسمًا بديلًا للدالة disk_free_space()‎. الوصف تُعدُّ هذه الدالة اسمًا بديلًا للدالة disk_free_space()‎. مصادر صفحة الدالة diskfreespace في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) تطبع الدالة fpassthru()‎ جميع محتويات الملف المتبقِّية على المخزن المؤقت للخرج. الوصف int fpassthru ( resource $handle ) تقرأ هذه الدالة الملف الذي يشير إليه المورد handle من موقع المؤشِّر الحالي وحتى نهاية الملف (EOF) ثمَّ تكتب هذه البيانات المقروءة على المخزن المؤقت للخرج. قد تحتاج إلى استدعاء الدالة rewind()‎ لإعادة موقع المؤشِّر إلى بداية الملف إن أضفت بعض البيانات إلى هذا الملف. إن أردت طباعة كامل محتوى الملف على المخزن المؤقت للخرج دون التعديل ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة dirname()‎ مسار المجلَّد الأب لمسار الملف أو المجلَّد الممرَّر إليها. الوصف string dirname ( string $path [, int $levels = 1 ] ) تعيد هذه الدالة عند تمرير مسار ملف أو مجلَّد إليها سلسلةً نصيةً تحتوي على مسار المجلَّد الأب ذو المستوى levels بدءًا من المجلَّد الحالي. ملاحظة: تُجري الدالة dirname()‎ عمليتها على السلسلة النصيَّة المرَّرة إليها بسذاجة ولا تتعرَّف على نظام الملفات الحالي ولا على عناصر المسار مثل "..". تحذير: تأخذ الدالة ...

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تقرأ الدالة file_get_contents()‎ الملف ثمَّ تضع كلَّ محتوياته في سلسلة نصيَّة. الوصف string file_get_contents ( string $filename [, bool $use_include_path= FALSE [, resource $context [, int $offset = 0 [, int $maxlen ]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة file()‎ باستثناء أنَّها تعيد محتوى الملف في سلسلة نصيَّة. يبدأ ذلك المحتوى عند الموقع offset ويكون بطول maxlen بايت. تعيد هذه الدالة عندما تفشل القيمة FALSE. تعدُّ الدالة file_get_contents()‎ وسيلة مفضَّلة لقراءة ...

(PHP 4, PHP 5, PHP 7) ترجع الدالة rewinddir()‎ مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. الوصف void rewinddir ([ resource $dir_handle ] ) ترجع هذه الدالة موقع المؤشِّر للمجلَّد الذي يشير إليه المورد dir_handle إلى بداية مجرى المجلَّد. المعاملات dir_handle مورد مقبض المجلَّد الذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل (أي لم يحدَّد المجلَّد)، فسيكون آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة تُعاد القيمة NULL عند نجاح العمليَّة. خلا ذلك، تُعاد ...

(PHP 4, PHP 5, PHP 7) الدالة set_file_buffer()‎ هي اسم بديل للدالة stream_set_write_buffer()‎. الوصف هذه الدالة هي اسم بديل للدالة stream_set_write_buffer()‎. مصادر صفحة الدالة set_file_buffer في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) تعيد الدالة fileowner()‎ رقم معرِّف المستخدم المالك (usre ID) لملف محدَّد. الوصف int fileowner ( string $filename ) تعيد هذه الدالة رقم معرِّف المستخدم المالك (UID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getpwuid()‎ للحصول على اسم المستخدم المالك بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم معرِّف المستخدم المالك (UID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_readable()‎ إن كان الملف قابلًا للقراءة. الوصف bool is_readable ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للقراءة. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وقابلًا للقراءة، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ. أمثلة المثال 1: استعمال الدالة is_readable()‎ <?php $filename = 'test.txt'; if (is_readable($filename)) { echo 'The file is readable'; } else ...

(PHP 5 >= 5.1.3, PHP 7) تغيِّر الدالة lchown()‎ المستخدم المالك لوصلة رمزيَّة. الوصف bool lchown ( string $filename , mixed $user ) تحاول هذه الدالة تغيير مالك الوصلة الرمزيَّة filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الوصلة الرمزيَّة. المعاملات filename مسار الوصلة الرمزيَّة التي ستُجرى عليها العمليَّة. user اسم المالك الجديد أو رقم مُعرِّفه. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ...

(PHP 4, PHP 5, PHP 7) تفتح الدالة fopen()‎ ملفًا أو عنوان URL. الوصف resource fopen ( string $filename , string $mode [, bool$use_include_path = FALSE [, resource $context ]] ) تربط هذه الدالة المورد filename المحدَّد مع مجرى (stream). المعاملات filename إن كانت قيمة هذا المعامل بالشكل "scheme://..‎"، فستعاملها PHP على أنَّها عنوان URL وستبحث حينئذٍ على معالج البروتوكول (portocol handler) من أجل ذلك المخطَّط (scheme). إن لم يكن هنالك بروتوكول مُسجَّل، فستُصدر PHP ملاحظةً لتساعدك على تعقُّب المشكلة المحتملة ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة lstat()‎ معلومات عن ملف أو وصلة رمزيَّة. الوصف array lstat ( string $filename ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف أو الوصلة الرمزيَّة التي يشير إليها المعامل filename. المعاملات filename مسار الملف أو الوصلة الرمزيَّة. القيم المعادة تُعاد مصفوفة تحتوي على معلومات إحصائيَّة عن الملف أو الوصلة الرمزيَّة. بنية تلك المصفوفة مشروحة بالتفصيل في توثيق الدالة stat()‎. هذه الدالة مطابقة تمامًا للدالة stat()‎ باستثناء أنَّه إن كان المعامل filename وصلة رمزيَّة، ...

(PHP 4, PHP 5, PHP 7) تفتح الدالة opendir()‎ مجلَّدًا محدَّدًا. الوصف resource opendir ( string $path [, resource $context ] ) تفتح هذه الدالة المجلَّد ذي المسار path ثمَّ تعيد مقبضًا له يمكن أن يُستعمل لاحقًا مع الدالة closedir()‎ والدالة readdir()‎ والدالة rewinddir()‎. المعاملات path مسار المجلَّد المُراد فتحه. context راجع قسم المجرى (stream) للمزيد من الشرح عن المعامل context. القيم المعادة يُعاد مورد مقبض المجلَّد عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. إن كان المسار path خطأً ولا ...

(PHP 5, PHP 7) تكتب الدالة file_put_contents()‎ سلسلة نصيَّة على ملف. الوصف int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] ) عمل هذه الدالة مشابه تمامًا لعمليَّة استدعاء الدالة fopen()‎ والدالة fwrite()‎ والدالة fclose()‎ على التوالي وذلك لكتابة بيانات على ملف. إن لم يكن الملف filename موجودًا، فسيُنشأ ويضاف إليه البيانات. إن كان موجودًا، فسيُستبدل إلا إذا كانت إحدى قيم المعامل flags هي الراية FILE_APPEND. المعاملات filename مسار الملف المراد كتابة البيانات ...

(PHP 4, PHP 5, PHP 7) تفتح الدالة popen()‎ عمليَّة وتشير إليها بمؤشِّر شبيه بمؤشِّر ملف. الوصف resource popen ( string $command , string $mode ) تفتح هذه الدالة أنبوبًا (pipe) يتصل مع العمليَّة المراد تنفيذها باستعمال الأمر command الفرعي المعطى. المعاملات command الأمر المراد تنفيذه. mode يُحدِّد هذا المعامل نوع الوصول المطلوب إلى المجرى. القيم المعادة يُعاد مؤشِّر ملف مطابق تمامًا للمؤشِّر المعاد بوساطة الدالة fopen()‎ باستثناء أنَّه أحادي الاتجاه (unidirectional) (أي يمكن استعماله إمَّا للقراءة أو للكتابة فقط) ويجب ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fileperms()‎ الأذونات الحاليَّة لملف محدَّد. الوصف int fileperms ( string $filename ) تعيد هذه الدالة الأذونات التي تخصُّ الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة تُعاد أذونات الملف filename في الصيغة العدديَّة. الأرقام المُعادة التي تمثِّل الأذونات هي نفسها التي تحاول الدالة chmod()‎ تغييرها (راجع شرح المعامل mode في تلك الدالة)، وتتضمَّن أحيانًا القيمة المُعادة في بعض المنصات معلوماتٍ عن نوع الملف filename أيضًا. يوضِّح المثال 2 كيفيَّة ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fstat()‎ معلومات عن ملف باستعمال مؤشِّر ملف مفتوح يشير إليه. الوصف array fstat ( resource $handle ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف المفتوح الذي يشير إليه المورد handle. تشبه هذه الدالة إلى حدٍّ كبير الدالة stat()‎ باستثناء أنَّها تتعامل مع مؤشِّر ملف مفتوح عوضًا عن مسار الملف. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎. القيم المعادة تُعاد ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة scandir()‎ أسماء جميع الملفات والمجلَّدات الموجودة في مجلَّد محدَّد. الوصف array scandir ( string $directory [, int $sorting_order = SCANDIR_SORT_ASCENDING [, resource $context ]] ) تعيد هذه الدالة مصفوفةً تحتوي على أسماء الملفات والمجلَّدات الموجودة في المجلَّد directory المعطى. المعاملات directory المجلَّد المراد مسح جميع محتوياته وإعادتها. sorting_order طريقة ترتيب الناتج الافتراضيَّة هي وفقًا للحروف الهجائية بشكل تصاعدي (أي عندما لا تمرَّر قيمة للمعامل). إن كانت قيمة هذا المعامل هي SCANDIR_SORT_DESCENDING، فستكون طريقة ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة rename()‎ تسمية الملف أو المجلَّد. الوصف bool rename ( string $oldname , string $newname [, resource $context ] ) تحاول هذه الدالة تغيير الاسم oldname القديم للملف أو المجلَّد إلى الاسم newname الجديد، ونقله إلى موقع آخر إن تطلَّب الأمر. إن ظهر عند تغيير اسم الملف إلى اسمه الجديد newname أنَّه موجود مسبقًا، فسيستبدل حينئذٍ. إن ظهر عند تغيير اسم المجلَّد إلى اسمه الجديد newname أنَّه موجود مسبقًا أيضًا، فستُصدر هذه الدالة تحذيرًا ...

(PHP 4 >= 4.0.3, PHP 5, PHP 7) تعيد الدالة basename()‎ اسم الملف أو المجلَّد الأساسي (basename) بعد تمرير مساره إليها. الوصف string basename ( string $path [, string $suffix ] ) تعيد هذه الدالة اسم الملف أو المجلد للسلسلة النصيَّة path التي تمثِّل مسار ذلك الملف أو المجلَّد؛ بعبارة أخرى، تستخلص هذه الدالة اسم العنصر الأساسي من مساره المُعطى. ملاحظة: تُعامِل الدالة basename()‎ السلسلة النصيَّة الممرَّرة إليها بكلِّ بساطةٍ إذ لا تميِّز حقيقةً نوع نظام الملفات المستعمل أو بعض عناصر ...

(PHP 4, PHP 5, PHP 7) تغلق الدالة pclose()‎ عمليَّة مفتوحة. الوصف int pclose ( resource $handle ) تغلق هذه الدالة العمليَّة التي يشير إليها المؤشِّر handle والمفتوحة باستعمال الدالة popen()‎. المعاملات handle مؤشِّر (pointer) شبيه بمؤشِّر الملف يشير إلى عمليَّة. يجب أن يكون سليمًا، وأُعيد بطريقة صحيحة باستدعاء الدالة popen()‎. القيم المعادة تُعاد الحالة ذاتها التي تعيدها العمليَّة التي كانت تعمل عند إنهائها. إن وُجد خطأ ما، فستُعاد القيمة ‎-1. ملاحظة: إن صُرِّف مفسِّر PHP‎ مع تمرير الخيار ‎--enable-sigchild، فستكون ...

(PHP 4, PHP 5, PHP 7) تجلب الدالة linkinfo()‎ معلومات عن وصلة محدَّدة. الوصف int linkinfo ( string $path ) تجلب هذه الدالة معلومات عن الوصلة ذات المسار path. تُستعمل هذه الدالة للتأكُّد من وجود الوصلة التي يشير إليها المسار path. المعاملات path مسار الوصلة. القيم المعادة تعيد هذه الدالة الحقل st_dev من البنية C stat في يونكس المُعادة باستدعاء النظام lstat‎. تعيد الدالة القيمة 0، أو القيمة FALSE عند وجود خطأ. سجل التغييرات الإصدار الوصف 5.3.0 أصبحت هذه الدالة الآن ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة tmpfile()‎ ملفًا مؤقَّتًا. الوصف resource tmpfile ( void ) تنشئ هذه الدالة ملفًا مؤقَّتًا ذو اسم مميَّز وتفتحه في وضع الكتابة والقراءة (الوضع w+‎) ثمَّ تعيد موردًا يشير إليه. سيُحذف الملف تلقائيًّا عند إغلاقه باستدعاء الدالة fclose()‎ مثلًا أو عندما لا يتبقى مرجع لمورد هذا الملف -المعاد باستعمال الدالة tmpfile()‎- أو عندما ينتهي السكربت. راجع للمزيد من التفاصيل توثيق الدالة tmpfile(3)‎ في نظامك بالإضافة إلى الملف stdio.h. القيم المعادة يُعاد مورد الملف المنشئ ...

(PHP 4, PHP 5, PHP 7) تغلق الدالة fclose()‎ ملفًا مفتوحًا. الوصف bool fclose ( resource $handle ) تغلق هذه الدالة الملف المفتوح الذي يشير إليه المؤشر handle. المعاملات handle مؤشر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة fclose()‎ <?php $handle = fopen('somefile.txt', 'r'); fclose($handle); ?> انظر أيضًا الدالة fopen()‎: تفتح ملفًا جديدًا ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filetype()‎ نوع الملف المحدَّد. الوصف string filetype ( string $filename ) تعيد هذه الدالة نوع الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد نوع الملف filename. القيم المتوقَّعة لنوع الملف هي إمَّا أنبوبة مسماة (FIFO وتدعى أحيانًا named pipe) أو ملف محرفي خاص (char) أو مجلد (dir) أو ملف كتلي خاص (block) أو وصلة رمزية (link) أو ملف عادي (file) أو مقبس (socket) أو نوع غير معروف (unknown). ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة getcwd()‎ مجلَّد العمل الحالي. الوصف string getcwd ( void ) تعيد هذه الدالة مجلَّد العمل الحالي. القيم المعادة يُعاد مسار مجلَّد العمل الحالي عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. ستعيد الدالة getcwd()‎ في الأنظمة الشبيهة بيونكس القيمة FASLE إن كان أيُّ مجلِّد أبٍ للمجلَّد المُعاد لا يملك أذنًا للقراءة حتى لو كان ذلك المجلَّد -مجلَّد العمل الحالي- يملك ذلك. راجع صفحة الدالة chmod()‎ للمزيد من التفاصيل حول الأذونات. أمثلة المثال 1: ...

(PHP 4, PHP 5, PHP 7) تقلِّص الدالة ftruncate()‎ حجم الملف إلى حجم محدَّد. الوصف bool ftruncate ( resource $handle , int $size ) تقلِّص هذه الدالة حجم الملف الذي يشير إليه المورد handle إلى الحجم size المعطى. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. ملاحظة: يجب أن يُفتح الملف في وضع الكتابة. size الحجم المراد تقليص الملف إليه. ملاحظة: إن كان الحجم size المُعطى أكبر من حجم الملف، فسيُمدَّد حجم الملف إلى الحجم size بإضافة بايتات فارغة (null bytes) إليه. ...

الثوابت المعرَّفة مسبقًا الثوابت المعرَّفة مسبقًا الخاصَّة بهذا الملحق. chdir()‎ تغيِّر مجلَّد PHP الحالي إلى مجلَّد آخر معطى. chroot()‎ تغيِّر مجلَّد الجذر (root directory) الحالي. closedir()‎ تغلق مجلَّدًا مفتوحًا. dir()‎ تعيد نسخةً (instance) من الصنف Directory. getcwd()‎ تعيد مجلَّد العمل الحالي. opendir()‎ تفتح مجلَّدًا محدَّدًا. readdir()‎ تقرأ عنصرًا واحدًا من محتويات المجلَّد وتعيده. rewinddir()‎ ترجع مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. scandir()‎ تعيد أسماء جميع الملفات والمجلَّدات الموجودة في مجلَّد محدَّد. الصنف Directory تُنشأ نُسخ (instances) الصنف Directory باستدعاء ...

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة disk_free_space()‎ المساحة المتوافرة (المتاحة) على نظام الملفات أو أحد الأقسام (disk partition). الوصف float disk_free_space ( string $directory ) تعيد هذه الدالة عدد البايتات المتاحة على نظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. المعاملات directory مسار القسم أو حرف القرص المراد معرفة مساحته المتاحة. ملاحظة: إن أعُطي اسم ملفٍ عوضًا عن المسار أو حرف القرص، فسيكون سلوك هذه الدالة ...

(PHP 4, PHP 5, PHP 7) تجلب الدالة filectime()‎ آخر وقت جرى فيه تعديل مؤشِّر الفهرسة (inode) لملف محدَّد. الوصف int filectime ( string $filename ) تعيد هذه الدالة آخر وقت جرى فيه تعديل مؤشر الفهرسة (inode) للملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد وقت آخر تعديل جرى على الملف filename أو تُعاد القيمة FALSE عند فشل العمليَّة. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp). أمثلة المثال 1: استعمال الدالة filectime()‎ <?php $filename ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_file()‎ إن كان الملف ملفًّا عاديًّا. الوصف bool is_file ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename ملفًّا عاديًّا. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وهو ملفٌّ عاديٌّ، أو القيمة FALSE خلاف ذلك أو عند وجود خطأ. ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد ...

(PHP 4 >= 4.3.0,PHP 5, PHP 7) تتحقَّق الدالة fnmatch()‎ من تطابق اسم ملف محدَّد مع نمط معيّن. الوصف bool fnmatch ( string $pattern , string $string [, int $flags = 0 ] ) تتحقَّق هذه الدالة من تطابق السلسلة النصيَّة string المُمرَّرة مع النمط pattern الذي يمكن أن يُستعمل معه محارف البدل الخاصة (wildcard) المُستخدمة في الصدفة. المعاملات pattern النمط المراد مُطابقته مع السلسلة النصيَّة string. يمكن استعمال محارف الصدفة الخاصة (wildcard ويشار إليها أيضًا meta characters) لإنشاء النمط. string ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة stat()‎ معلومات عن ملف محدَّد. الوصف array stat ( string $filename ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف filename. إن كان الملف filename وصلة رمزيَّة، فستعاد معلومات إحصائيَّة عن الملف ذاته الذي تشير إليه الوصلة وليست عن الوصلة الرمزيَّة تلك. الدالة lstat()‎ مطابقة تمامًا للدالة stat()‎ باستثناء أنَّها تعيد معلومات إحصائيَّة عن الوصلات الرمزيَّة أيضًا. المعاملات filename مسار الملف المراد جلب معلومات عنه. القيم المعادة يوضِّح الجدول التالي تنسيق المصفوفة التي ...

(PHP 4, PHP 5, PHP 7) تنسِّق الدالة fputcsv()‎ سطرًا واحدًا من البيانات بالصيغة CSV (اختصارًا للعبارة comma-separated values) ثمَّ تكتبه على الملف. الوصف int fputcsv ( resource $handle , array $fields [, string $delimiter = "," [, string $enclosure = '"' [, string $escape_char = "\\" ]]] ) تنسق هذه الدالة سطرًا من البيانات المُمرَّرة عبر المصفوفة fields بالصيغة CSV ثمَّ تكتبها على الملف الذي يشير إليه المورد handle (بعد أن تضيف في نهاية ذلك السطر محرف سطر جديد). المعاملات ...

(PHP 4, PHP 5, PHP 7) تحرِّك الدالة fseek()‎ مؤشِّر الملف الحالي إلى موقع محدَّد. الوصف int fseek ( resource $handle , int $offset [, int $whence = SEEK_SET ] ) تغيِّر هذه الدالة دليل موقع المؤشِّر للملف الذي يشير إليه المورد handle. يُحدَّد الموقع الجديد للمؤشِّر، والذي يقاس بالبايت انطلاقًا من بداية الملف، بإضافة قيمة الإزاحة offset إلى الموقع الذي يُحدِّده المعامل whence. يُسمح عمومًا بالانتقال إلى موقعٍ يأتي بعد نهاية الملف (EOF). إن أُضيفت بيانات إلى ذاك الموقع، فإنَّ ...

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة disk_total_space()‎ المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام (disk partition). الوصف float disk_total_space ( string $directory ) تعيد هذه الدالة عدد البايتات الكلِّيَّة لنظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. المعاملات directory مسار القسم أو حرف القرص المُراد معرفة مساحته الكلِّيَّة. القيم المعادة يُعاد عدد عشري (float) يمثِّل المساحة الكلِّيَّة بواحدة البايت، أو تُعاد القيمة FALSE عند فشل العمليَّة. ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة umask()‎ قيمة القناع umask الحاليَّة. الوصف int umask ([ int $mask ] ) تضبط هذه الدالة قيمة القناع umask في PHP إلى القيمة mask & 0777 ثمَّ تعيد قيمة umask السابقة. عندما تُستعمل PHP كوحدة من وحدات الخادم، فستُستعاد قيمة umask عند انتهاء كلِّ طلب. المعاملات mask قيمة umask الجديدة. القيم المعادة تُعاد قيمة umask الحاليَّة إن لم يُمرَّر أيُّ معامل، أو ستُعاد قيمة umask السابقة خلافًا لذلك. أمثلة المثال 1: استعمال الدالة ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة mkdir()‎ مجلَّدًا جديدًا. الوصف bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = FALSE [, resource $context ]]] ) تحاول هذه الدالة إنشاء مجلَّد جديد في المسار pathname المُعطى. المعاملات pathname مسار المجلَّد المُراد إنشاؤه. mode أذونات المجلَّد الجديد، وقيمة هذا المعامل الإفتراضيَّة هي 0777 أي أوسع مجال لأذونات الوصول للمجلَّد. للمزيد من المعلومات حول الأذونات، راجع صفحة الدالة chmod()‎. ملاحظة: يُتجاهل المعامل mode على منصات ويندوز. الجدير ...

(PHP 4, PHP 5, PHP 7) تغلق الدالة closedir()‎ مجلَّدًا مفتوحًا. الوصف void closedir ([ resource $dir_handle ] ) تغلق هذه الدالة المجلَّد المفتوح الذي يشير إليه المورد dir_handle. يجب أن يكون المجلَّد قد فُتح مسبقًا باستعمال الدالة opendir()‎. المعاملات dir_handle مورد مقبض المجلَّد المراد إغلاقه، ويشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل أي لم يحدَّد المجلَّد المراد إغلاقه، فسيُغلق آخر مجلَّد فُتح باستعمال الدالة opendir()‎. أمثلة المثال 1: استعمال الدالة closedir()‎ <?php $dir = ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة file()‎ الملف ثمَّ تضع كلَّ محتوياته في مصفوفة. الوصف array file ( string $filename [, int $flags = 0 [, resource $context]] ) تعيد هذه الدالة مصفوفة تضم كلَّ محتويات الملف filename. ملاحظة: يمكنك استعمال الدالة file_get_contents()‎ لجلب كلِّ محتويات الملف ووضعها في سلسلة نصيَّة عوضًا عن مصفوفة. المعاملات filename اسم الملف المراد جلب محتوياته. فائدة: يمكن استعمال عنوان URL عوضًا عن اسم الملف مع المعامل filename شرط أن يُفعَّل الضبط "fopen wrapper". ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetss()‎ سطرًا واحدًا من ملف معيَّن وتزيل وسوم HTML من النصِّ الذي تقرؤه. الوصف string fgetss ( resource $handle [, int $length [, string$allowable_tags ]] ) تشبه هذه الدالة تمامًا الدالة fgets()‎ باستثناء أنَّها تحاول إزالة بايتات العدم (NULL)، ووسوم HTML، ووسوم PHP التي تعثر عليها أثناء قراءتها للنص. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filegroup()‎ رقم معرِّف المجموعة المالكة (group ID) لملف محدَّد. الوصف int filegroup ( string $filename ) تعيد هذه الدالة رقم معرِّف المجموعة المالكة (GID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getgrgif()‎ للحصول على اسم المجموعة بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم معرِّف المجموعة المالكة (GID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة posix_getgrgif()‎ ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_dir()‎ إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلَّدًا أم لا. الوصف bool is_dir ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename هو مجلَّد. المعاملات filename مسار الملف المراد التحقُّق منه. إن كان المعامل filename مسارًا نسبيًّا، فسيُتحقَّق منه نسبةً إلى مجلَّد العمل الحالي. إن كان المعامل filename وصلةً رمزيَّة أو صلبة، فسيُستبين المسار الذي تُشير إليه تلك الوصلة حينئذٍ ويُتحقَّق منه. إن كان الوضع الآمن أو  الخيار ...

(PHP 4, PHP 5, PHP 7) الدالة is_writeable()‎ هي اسم بديل للدالة is_writable()‎. الوصف هذه الدالة هي اسم بديل للدالة is_writable()‎. مصادر صفحة الدالة is_writeable في توثيق PHP الرسمي.

(PHP 4, PHP 5, PHP 7) تقرأ الدالة readdir()‎ عنصرًا واحدًا من محتويات المجلَّد وتعيده. الوصف string readdir ([ resource $dir_handle ] ) تعيد هذه الدالة اسم العنصر التالي الموجود في المجلَّد. تُعاد العناصر بالترتيب الذي خُزَّنت فيه بوساطة نظام الملفات. المعاملات dir_handle مورد مقبض المجلَّد المراد القراءة منه والذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل أي لم يحدَّد المجلَّد، فسيُقرأ من آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة يُعاد اسم عنصر ...

(PHP 4 >= 4.0.5, PHP 5, PHP 7) تغيِّر الدالة chroot()‎ مجلَّد الجذر (root directory) الحالي. الوصف bool chroot ( string $directory ) تغيِّر هذه الدالة مجلَّد الجذر للعمليَّة الحالية إلى المجلَّد directory المعطى، وتغيِّر مجلَّد العمل الحالي إلى /. هذه الدالة متاحةٌ فقط على أنظمة غنو (GNU)، وأنظمة BSD، وعند استعمال CLI أو CGI أو SAPI المضمَّنة. تتطلَّب هذه الدالة أيضًا صلاحيات مدير النظام (المستخدم الجذر، root) لتنفيذ العمليَّة. المعاملات directory مسار المجلَّد المراد تغيير المجلَّد الجذر إليه. القيم المعادة ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgets()‎ سطرًا واحدًا من ملف معيَّن. الوصف string fgets ( resource $handle [, int $length ] ) تجلب هذه الدالة سطرًا واحدًا من الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fclose()‎. length إن حُدِّدت قيمة هذا المعامل، فستتوقف عمليَّة القراءة عند البايت length - 1 أو ...

(PHP 4 >= 4.0.3, PHP 5, PHP 7) تتحقَّق الدالة is_uploaded_file()‎ إن كان الملف مرفوعًا باستعمال HTTP POST. الوصف bool is_uploaded_file ( string $filename ) تعيد هذه الدالة القيمة TRUE إن رُفع الملف الذي يُدعى filename بوساطة HTTP POST، وهذا الأمر مفيد لأنَّه يساعد على التأكُّد من عدم احتيال المستخدمين الخبيثين على السكربت لإجباره على العمل على ملفات لا يُفترض العمل عليها مثل الملف ‎/etc/passwd. هذا النوع من التحقُّق مهمٌّ جدًا إذ يساعد على التأكُّد من عدم وجود أي فرصة تسنح ...

(PHP 4, PHP 5, PHP 7) تعدّ حلقات for النوع الأكثر تعقيدًا من الحلقات في PHP، وهي مشابهة لنظيرتها في لغة C، وتأخذ الصيغة التالية: for (expr1; expr2; expr3) statement ينفّذ التعبير expr1 مرة واحدة دون قيد أو شرط في بداية الحلقة، وينفّذ التعبير expr2 في بداية كل دورة، فإن كانت النتيجة هي TRUE فتستمر الحلقة في عملها وتنفّذ العبارات المضمّنة فيها، أما إن كانت النتيجة هي FALSE فتتوقف الحلقة عن العمل، أما التعبير expr3 فينفّذ في ...

(PHP 4, PHP 5, PHP 7) بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات البرمجية، ومن ضمنها PHP. إذ تتيح تنفيذ أجزاء من الشيفرة اعتمادًا على شروط معينة. تعتمد PHP بنية if المعتمدة في لغة C: if (expr) statement تُحسب التعابير -كما ورد في الفصل المتعلّق بالتعابير في هذا الدليل- إلى قيمة منطقية (Boolean)، فإن كانت نتيجة الحساب هي TRUE تنفذ PHP العبارة، وإن كانت نتيجة الحساب هي FALSE تتجاهل اللغة ذلك التعبير. يمكن الحصول ...

(PHP 4, PHP 5, PHP 7) تعدّ حلقات for النوع الأكثر تعقيدًا من الحلقات في PHP، وهي مشابهة لنظيرتها في لغة C، وتأخذ الصيغة التالية: for (expr1; expr2; expr3) statement ينفّذ التعبير expr1 مرة واحدة دون قيد أو شرط في بداية الحلقة، وينفّذ التعبير expr2 في بداية كل دورة، فإن كانت النتيجة هي TRUE فتستمر الحلقة في عملها وتنفّذ العبارات المضمّنة فيها، أما إن كانت النتيجة هي FALSE فتتوقف الحلقة عن العمل، أما التعبير expr3 فينفّذ في ...

(PHP 4, PHP 5, PHP 7) بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات البرمجية، ومن ضمنها PHP. إذ تتيح تنفيذ أجزاء من الشيفرة اعتمادًا على شروط معينة. تعتمد PHP بنية if المعتمدة في لغة C: if (expr) statement تُحسب التعابير -كما ورد في الفصل المتعلّق بالتعابير في هذا الدليل- إلى قيمة منطقية (Boolean)، فإن كانت نتيجة الحساب هي TRUE تنفذ PHP العبارة، وإن كانت نتيجة الحساب هي FALSE تتجاهل اللغة ذلك التعبير. يمكن الحصول ...