.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 فایل phar مد نظر (\fIfile\fP) را برای کار روی آن مشخص می‌کند. .SH "دستور extract (extract command)" استخراج یک بسته PHAR در یک دایرکتوری. .P آرگومان‌های ضروری: .TP 15 .PD .B -f \fIfile\fP فایل phar مد نظر (\fIfile\fP) را برای کار روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B -i \fIregex\fP یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B -x \fIregex\fP عبارت باقاعده برای مستثنی کردن فایل‌های ورودی. .TP .PD .B ... دایرکتوری مقصد جهت استخراج (پیش‌فرض '.' است). .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 فایل phar موردنظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-k \fIindex\fP نمایهٔ اشتراک (\fIindex\fP) موردنظر برای پردازش. .SH "دستور list (list command)" فهرست کردن محتویات یک بایگانی PHAR. .P آرگومان‌های الزامی: .TP 15 .PD .B \-f \fIfile\fP فایل phar موردنظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-i \fIregex\fP یک عبارت منظم (regular expression) را برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B \-x \fIregex\fP عبارت منظم برای مستثنی کردن فایل‌های ورودی. .SH "دستور meta-del (meta-del command)" حذف اطلاعات فراداده یک مدخل یا بسته PHAR. .P اگر \-k داده شود، انتظار می‌رود که فراداده یک آرایه (array) باشد و نمایهٔ داده‌شده حذف می‌شود. .P در صورتی که چیزی حذف شود مقدار بازگشتی 0 و در غیر این صورت 1 خواهد بود. .P آرگومان‌های الزامی: .TP 15 .PD .B \-f \fIfile\fP فایل phar موردنظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .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 به صورت سریال‌سازی‌شده (serialized). اگر هیچ فایل خروجی برای فراداده مشخص نشده باشد، از stdout استفاده خواهد شد. همچنین می‌توانید با استفاده از \-k یک نمایهٔ خاص را مشخص کنید؛ در این صورت انتظار می‌رود که فراداده یک آرایه باشد و مقدار نمایهٔ ارائه‌شده به‌جای سریال‌سازی با استفاده از echo بازگردانده می‌شود. اگر آن نمایه وجود نداشته باشد یا فراداده‌ای موجود نباشد، مقدار بازگشتی 1 خواهد بود. .P آرگومان‌های الزامی: .TP 15 .PD .B \-f \fIfile\fP فایل phar موردنظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .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 با استفاده از ورودی سریال‌سازی‌شده. اگر هیچ فایل ورودی برای فراداده مشخص نشده باشد، از stdin استفاده می‌شود. همچنین می‌توانید یک نمایهٔ خاص را با استفاده از \-k مشخص کنید؛ در این حالت انتظار می‌رود فراداده یک آرایه باشد و مقدار نمایهٔ مشخص‌شده تنظیم می‌شود. اگر فراداده وجود نداشته باشد یا خالی باشد، یک آرایه جدید ایجاد خواهد شد. اگر فراداده موجود و یک مقدار ساده (flat value) باشد، مقدار بازگشتی 1 خواهد بود. همچنین با استفاده از \-k، ورودی به‌جای آن‌که سریال‌سازی شود، مستقیماً دریافت می‌شود. .P آرگومان‌های الزامی: .TP 15 .PD .B \-f \fIfile\fP فایل phar موردنظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .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 فایل phar مورد نظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .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 به عنوان پوشش‌دهنده جریان 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 فایل phar مورد نظر (\fIfile\fP) را برای پردازش مشخص می‌کند. .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 به عنوان پوشش‌دهنده جریان 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 \fIfile\fP مربوط به phar را برای کار روی آن مشخص می‌کند. .P آرگومان‌های اختیاری: .TP 15 .PD .B \-i \fIregex\fP یک عبارت منظم برای فایل‌های ورودی مشخص می‌کند. .TP .PD .B \-x \fIregex\fP عبارت منظم برای فایل‌های ورودی که باید مستثنی شوند. .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 http://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 http://www.php.net/credits.php .PD 1 .P و در نهایت، PHP با کمک خیل عظیمی از مشارکت‌کنندگان در سراسر جهان توسعه یافته است. .SH "اطلاعات نسخه (VERSION INFORMATION)" این صفحه راهنما \fBphar\fP، نسخه 8.3.33 را توضیح می‌دهد. .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 ارسال کنید تا بلافاصله یک نسخه را با ایمیل برای شما ارسال کنیم.