الدالة pclose() في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تغلق الدالة pclose() عمليَّة مفتوحة.
الوصف
int pclose ( resource $handle )
تغلق هذه الدالة العمليَّة التي يشير إليها المؤشِّر handle والمفتوحة باستعمال الدالة popen().
المعاملات
handle
مؤشِّر (pointer) شبيه بمؤشِّر الملف يشير إلى عمليَّة. يجب أن يكون سليمًا، وأُعيد بطريقة صحيحة باستدعاء الدالة popen().
القيم المعادة
تُعاد الحالة ذاتها التي تعيدها العمليَّة التي كانت تعمل عند إنهائها. إن وُجد خطأ ما، فستُعاد القيمة -1.
ملاحظة: إن صُرِّف مفسِّر (compil) PHP مع تمرير الخيار --enable-sigchild، فستكون القيم التي تعيدها هذه الدالة غير معروفة.
أمثلة
المثال 1: استعمال الدالة pclose()
<?php
$handle = popen('/bin/ls', 'r');
pclose($handle);
?>
ملاحظات
ملاحظة لأنظمة يونكس أو الشبيه بها فقط:
تنفَّذ الدالة pclose() داخليًّا عبر استدعاء النظام للدالة waitpid(3). يجب للحصول على الرمز الحقيقي لحالة الخروج باستعمال الدالة pcntl_wexitstatus().
انظر أيضًا
- الدالة
popen(): تفتح عمليَّة وتشير إليها بمؤشِّر شبيه بمؤشِّر ملف.