.TH PHAR 1 "2024" "The PHP Group" "User Commands" .SH "نام (NAME)" phar, phar.phar \- ابزار خط فرمان PHAR (آرشیو PHP) .SH "خلاصه دستور (SYNOPSIS)" .B phar [options] ... .LP .SH "توضیحات (DESCRIPTION)" قالب فایل \fBPHAR\fP روشی برای قرار دادن کل برنامه‌های PHP درون یک فایل واحد به نام «phar» (آرشیو PHP) به منظور توزیع و نصب آسان فراهم می‌کند. .P با دستور \fBphar\fP می‌توانید آرشیوهای PHP را ایجاد کرده، به‌روزرسانی کنید یا استخراج نمایید. .P دستورها: add compress delete extract help help-list info list meta-del meta-get meta-set pack sign stub-get stub-set tree version .SH "دستور add (ADD COMMAND)" افزودن ورودی‌ها به یک بسته PHAR. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP فایل phar (\fIfile\fP) مورد نظر برای کار را مشخص می‌کند. .TP .PD .B ... هر تعداد از فایل‌ها و دایرکتوری‌های ورودی. اگر \-i استفاده شود، تنها فایل‌های منطبق با عبارت باقاعده داده‌شده بسته‌بندی می‌شوند. اگر \-x مشخص شود، فایل‌های منطبق با آن عبارت باقاعده بسته‌بندی نخواهند شد. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-a \fIalias\fP یک نام مستعار (\fIalias\fP) برای فایل phar تعیین می‌کند. .TP .PD .B \-c \fIalgo\fP الگوریتم فشرده‌سازی (نگاه کنید به .SM .B COMPRESSION ) .TP .PD .B \-i \fIregex\fP یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B \-l \fIlevel\fP تعداد زیردایرکتوری‌های ابتدایی برای حذف از ورودی‌های فایل. .TP .PD .B \-x \fIregex\fP عبارت باقاعده برای مستثنی کردن فایل‌های ورودی. .SH "دستور compress (COMPRESS COMMAND)" فشرده‌سازی یا خارج کردن از حالت فشرده تمام فایل‌ها یا یک ورودی انتخاب‌شده. .P آرگومان‌های الزامی: .TP 15 .PD .B \-c \fIalgo\fP الگوریتم فشرده‌سازی (نگاه کنید به .SM .B COMPRESSION ) .TP .PD .B -f \fIfile\fP فایل phar (\fIfile\fP) مورد نظر برای کار را مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -e \fIentry\fP نام \fIentry\fP مورد نظر برای کار (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد)..SH "دستور delete (delete command)" حذف مدخل از یک آرشیو PHAR .P آرگومان‌های الزامی: .TP 15 .PD .B \-e \fIentry\fP نام \fIentry\fP برای کار بر روی آن (در صورت وجود، باید شامل نام دایرکتوری درونی PHAR باشد). .TP .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار بر روی آن مشخص می‌کند. .SH "دستور extract (extract command)" استخراج یک بستهٔ PHAR در یک دایرکتوری. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار بر روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -i \fIregex\fP یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B -x \fIregex\fP عبارت باقاعده برای مستثنی کردن فایل‌های ورودی. .TP .PD .B ... دایرکتوری مقصد برای استخراج (پیش‌فرض \(aq.\(aq است). .SH "دستور help (help command)" این راهنما یا راهنمای یک دستور انتخاب‌شده. .P آرگومان‌های اختیاری: .TP 15 .PD .B ... دستور اختیاری برای دریافت راهنمای آن. .SH "دستور help-list (help-list command)" دستورهای موجود را فهرست می‌کند. .SH "دستور info (info command)" دریافت اطلاعات دربارهٔ یک بستهٔ PHAR. .P با استفاده از \-k، بازگرداندن تنها یک مقدار امکان‌پذیر است. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار بر روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -k \fIindex\fP اندیس (\fIindex\fP) اشتراک برای کار بر روی آن. .SH "دستور list (list command)" فهرست کردن محتویات یک آرشیو PHAR. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار بر روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -i \fIregex\fP یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B -x \fIregex\fP عبارت باقاعده برای مستثنی کردن فایل‌های ورودی..SH "دستور meta-del (meta-del command)" حذف فراداده‌های یک مدخل PHAR یا یک بستهٔ PHAR. .P اگر \-k مشخص شده باشد، انتظار می‌رود که فراداده یک آرایه باشد و نمایهٔ مشخص‌شده حذف می‌شود. .P اگر موردی حذف شود مقدار بازگشتی 0 است، در غیر این صورت 1 خواهد بود. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -e \fIentry\fP نام \fIentry\fP برای کار روی آن (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد). .TP .PD .B -k \fIindex\fP نمایهٔ (\fIindex\fP) برای کار روی آن. .SH "دستور meta-get (meta-get command)" دریافت فراداده‌های یک مدخل PHAR یا یک بستهٔ PHAR در قالب سریال‌شده (serialized). اگر هیچ فایل خروجی برای فراداده مشخص نشده باشد، از stdout استفاده می‌شود. همچنین می‌توانید با استفاده از \-k یک نمایهٔ خاص را مشخص کنید. در این حالت انتظار می‌رود که فراداده یک آرایه باشد و مقدار نمایهٔ مشخص‌شده به‌جای استفاده از serialize، با استفاده از echo بازگردانده می‌شود. اگر آن نمایه وجود نداشته باشد یا هیچ فراداده‌ای موجود نباشد، مقدار بازگشتی 1 خواهد بود. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -e \fIentry\fP نام \fIentry\fP برای کار روی آن (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد). .TP .PD .B -k \fIindex\fP نمایهٔ (\fIindex\fP) برای کار روی آن. .SH "دستور meta-set (meta-set command)" تنظیم فراداده‌های یک مدخل PHAR یا یک بستهٔ PHAR با استفاده از ورودی سریال‌شده. اگر هیچ فایل ورودی برای فراداده مشخص نشده باشد، از stdin استفاده می‌شود. همچنین می‌توانید با استفاده از \-k یک نمایهٔ خاص را مشخص کنید. در این حالت انتظار می‌رود که فراداده یک آرایه باشد و مقدار نمایهٔ مشخص‌شده تنظیم می‌شود. اگر فراداده وجود نداشته باشد یا خالی باشد، یک آرایهٔ جدید ایجاد خواهد شد. اگر فراداده موجود بوده و یک مقدار تخت (flat value) باشد، مقدار بازگشتی 1 خواهد بود. همچنین با استفاده از \-k، ورودی به‌جای این‌که سریال شود، مستقیماً دریافت می‌شود. .P آرگومان‌های الزامی: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار روی آن مشخص می‌کند. .TP .PD .B -m \fImeta\fP فراداده جهت ذخیره به همراه مدخل (داده‌های php سریال‌شده). .P آرگومان‌های اختیاری: .TP 15 .PD .B -e \fIentry\fP نام \fIentry\fP برای کار روی آن (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد). .TP .PD .B -k \fIindex\fP نمایهٔ (\fIindex\fP) برای کار روی آن..SH "دستور pack (pack command)" بسته‌بندی فایل‌ها در یک بایگانی PHAR. .P هنگام استفاده از \-s ، فایل stub از فهرست فایل‌ها/دایرکتوری‌های ورودی کنار گذاشته می‌شود. برای ساخت یک بایگانی حاوی کلاس PEAR به نام PHP_Archive، آرگومان \-p را به PHP/Archive.php ارجاع دهید. .P آرگومان‌های ضروری: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار با آن مشخص می‌کند. .TP .PD .B ... هر تعداد فایل و دایرکتوری ورودی. اگر \-i استفاده شود، تنها فایل‌های منطبق با عبارت باقاعده داده‌شده بسته‌بندی می‌شوند. اگر \-x مشخص شود، فایل‌های منطبق با آن عبارت باقاعده بسته‌بندی نخواهند شد. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-a \fIalias\fP یک نام مستعار (\fIalias\fP) برای فایل phar تعیین می‌کند. .TP .PD .B \-b \fIbang\fP خط hash-bang برای آغاز بایگانی (مانند #!/usr/bin/php). خود علامت هش '#!' و نویسه خط جدید اختیاری هستند. .TP .PD .B \-c \fIalgo\fP الگوریتم فشرده‌سازی (نگاه کنید به .SM .B COMPRESSION ) .TP .PD .B \-h \fIhash\fP الگوریتم \fIhash\fP را انتخاب می‌کند (نگاه کنید به .SM .B HASH ) .TP .PD .B \-i \fIregex\fP یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B \-l \fIlevel\fP تعداد زیردایرکتوری‌های ابتدایی برای حذف از مدخل‌های فایل .TP .PD .B \-p \fIloader\fP مکان فایل کلاس PHP_Archive (دستور pear list-files PHP_Archive). می‌توانید از '0' یا '1' برای یافتن خودکار آن با دستور ذکرشده pear استفاده کنید. هنگام استفاده از '0'، در صورتی که فایل کلاس پیدا نشود، دستور با خطا متوقف نمی‌شود. این سوییچ همچنین کدی در اطراف stub اضافه می‌کند تا در صورت نیاز، کلاس PHP_Archive به عنوان stream wrapper برای phar:// ثبت شود. و در نهایت این سوییچ فایل phar.inc را از این بسته اضافه کرده و بارگذاری می‌کند تا از در دسترس بودن کلاس Phar اطمینان حاصل شود. .TP .PD .B \-s \fIstub\fP فایل \fIstub\fP را انتخاب می‌کند. .TP .PD .B \-x \fIregex\fP عبارت باقاعده برای فایل‌های ورودی جهت کنار گذاشته شدن. .TP .PD .B \-y \fIkey\fP کلید خصوصی (\fIkey\fP) برای امضای OpenSSL. .SH "دستور sign (sign command)" تنظیم الگوریتم درهم‌سازی امضا. .P آرگومان‌های ضروری: .TP 15 .PD .B -f \fIfile\fP \fIfile\fP مربوط به phar را برای کار با آن مشخص می‌کند. .TP .PD .B \-h \fIhash\fP الگوریتم \fIhash\fP را انتخاب می‌کند (نگاه کنید به .SM .B HASH ) .P آرگومان‌های اختیاری: .TP 15 .PD .B \-y \fIkey\fP کلید خصوصی (\fIkey\fP) برای امضای OpenSSL..SH "دستور stub-get (stub-get command)" دریافت استاب (stub) یک فایل PHAR. اگر هیچ فایل خروجی به عنوان stub مشخص نشود، از stdout استفاده خواهد شد. .P آرگومان‌های ضروری: .TP 15 .PD .B -f \fIfile\fP مشخص کردن فایل phar (\fIfile\fP) برای پردازش. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-s \fIstub\fP انتخاب فایل \fIstub\fP. .SH "دستور stub-set (stub-set command)" تنظیم استاب (stub) یک فایل PHAR. اگر هیچ فایل ورودی به عنوان stub مشخص نشود، از stdin استفاده خواهد شد. .P آرگومان‌های ضروری: .TP 15 .PD .B -f \fIfile\fP مشخص کردن فایل phar (\fIfile\fP) برای پردازش. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-b \fIbang\fP خط Hash-bang برای شروع آرشیو (مانند ‎#!/usr/bin/php). خود علامت هش «#!» و نویسه خط جدید اختیاری هستند. .TP .PD .B \-p \fIloader\fP محل فایل کلاس PHP_Archive (با دستور pear list-files PHP_Archive). می‌توانید از '0' یا '1' برای تعیین خودکار مکان آن با استفاده از دستور ذکر شده pear استفاده کنید. در صورت استفاده از '0'، در صورتی که فایل کلاس پیدا نشود، دستور با خطا متوقف نمی‌شود. این گزینه همچنین کدی را پیرامون stub اضافه می‌کند تا در صورت نیاز، کلاس PHP_Archive به عنوان stream wrapper پروتکل phar:// ثبت شود. در نهایت، این گزینه فایل phar.inc را از این بسته اضافه و بارگذاری می‌کند تا از در دسترس بودن کلاس Phar اطمینان حاصل شود. .TP .PD .B \-s \fIstub\fP انتخاب فایل \fIstub\fP. .SH "دستور tree (tree command)" دریافت درخت دایرکتوری برای یک آرشیو PHAR. .P آرگومان‌های ضروری: .TP 15 .PD .B -f \fIfile\fP مشخص کردن فایل phar (\fIfile\fP) برای پردازش. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-i \fIregex\fP مشخص کردن یک عبارت منظم (regex) برای فایل‌های ورودی. .TP .PD .B \-x \fIregex\fP عبارت منظم (regex) برای مستثنی کردن فایل‌های ورودی. .SH "دستور version (version command)" دریافت اطلاعات درباره محیط PHAR و نسخه ابزار. .SH "فشرده‌سازی (COMPRESSION)" الگوریتم‌ها: .TP 15 .PD .B 0 بدون فشرده‌سازی .TP .PD .B none بدون فشرده‌سازی .TP .PD .B auto انتخاب خودکار الگوریتم فشرده‌سازی .TP .PD .B gz فشرده‌سازی GZip .TP .PD .B gzip فشرده‌سازی GZip .TP .PD .B bz2 فشرده‌سازی BZip2 .TP .PD .B bzip2 فشرده‌سازی BZip2.SH "هش (HASH)" الگوریتم‌ها: .TP 15 .PD .TP .PD .B md5 MD5 .TP .PD .B sha1 SHA1 .TP .PD .B sha256 SHA256 .TP .PD .B sha512 SHA512 .TP .PD .B openssl OpenSSL با استفاده از SHA-1 .TP .PD .B openssl_sha256 OpenSSL با استفاده از SHA-256 .TP .PD .B openssl_sha512 OpenSSL با استفاده از SHA-512 .SH "همچنین ببینید (SEE ALSO)" برای توضیحات کم‌وبیش کامل دربارهٔ PHAR اینجا را ببینید: .PD 0 .P .B https://www.php.net/phar .PD 1 .P .SH "گزارش باگ‌ها (BUGS)" می‌توانید فهرست باگ‌های شناخته‌شده را مشاهده کنید یا هر باگ جدیدی را که یافتید در اینجا گزارش دهید: .PD 0 .P .B https://github.com/php/php-src/issues .PD 1 .SH "نویسندگان (AUTHORS)" The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski. .P توسعهٔ بایگانی PHP توسط Gregory Beaver و Marcus Boerger انجام شده است. .P فهرست توسعه‌دهندگان فعال را می‌توانید در اینجا بیابید: .PD 0 .P .B https://www.php.net/credits.php .PD 1 .P و در نهایت، PHP به کمک خیل عظیمی از مشارکت‌کنندگان در سراسر جهان توسعه یافته است. .SH "اطلاعات نسخه (VERSION INFORMATION)" این صفحه راهنما \fBphar\fP، نسخهٔ 8.5.10 را شرح می‌دهد. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" حق نشر \(co The PHP Group .LP این فایل منبع مشمول نسخهٔ 3.01 از مجوز PHP است که همراه با این بسته در فایل LICENSE ارائه شده و از طریق وب جهان‌گستر در نشانی زیر در دسترس است: .PD 0 .P .B https://www.php.net/license/3_01.txt .PD 1 .P اگر نسخه‌ای از مجوز PHP دریافت نکرده‌اید و قادر به دریافت آن از طریق وب نیستید، لطفاً پیامی به .B license@php.net ارسال کنید تا بلافاصله یک نسخه را برای شما بفرستیم.