PHAR(1) User Commands PHAR(1)

phar, phar.phar - ابزار خط فرمان PHAR (آرشیو PHP)

phar <command> [options] ...

قالب فایل PHAR روشی برای قرار دادن کل برنامه‌های PHP درون یک فایل واحد به نام «phar» (آرشیو PHP) به منظور توزیع و نصب آسان فراهم می‌کند.

با دستور phar می‌توانید آرشیوهای PHP را ایجاد کرده، به‌روزرسانی کنید یا استخراج نمایید.

دستورها: add compress delete extract help help-list info list meta-del meta-get meta-set pack sign stub-get stub-set tree version

افزودن ورودی‌ها به یک بسته PHAR.

آرگومان‌های الزامی:

-f file
فایل phar (file) مورد نظر برای کار را مشخص می‌کند.
...
هر تعداد از فایل‌ها و دایرکتوری‌های ورودی. اگر -i استفاده شود، تنها فایل‌های منطبق با عبارت باقاعده داده‌شده بسته‌بندی می‌شوند. اگر -x مشخص شود، فایل‌های منطبق با آن عبارت باقاعده بسته‌بندی نخواهند شد.

آرگومان‌های اختیاری:

-a alias
یک نام مستعار (alias) برای فایل phar تعیین می‌کند.
-c algo
الگوریتم فشرده‌سازی (نگاه کنید به COMPRESSION )
-i regex
یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند.
-l level
تعداد زیردایرکتوری‌های ابتدایی برای حذف از ورودی‌های فایل.
-x regex
عبارت باقاعده برای مستثنی کردن فایل‌های ورودی.

فشرده‌سازی یا خارج کردن از حالت فشرده تمام فایل‌ها یا یک ورودی انتخاب‌شده.

آرگومان‌های الزامی:

-c algo
الگوریتم فشرده‌سازی (نگاه کنید به COMPRESSION )
-f file
فایل phar (file) مورد نظر برای کار را مشخص می‌کند.

آرگومان‌های اختیاری:

-e entry
نام entry مورد نظر برای کار (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد)..SH "دستور delete (delete command)" حذف مدخل از یک آرشیو PHAR

آرگومان‌های الزامی:

-e entry
نام entry برای کار بر روی آن (در صورت وجود، باید شامل نام دایرکتوری درونی PHAR باشد).
-f file
file مربوط به phar را برای کار بر روی آن مشخص می‌کند.

استخراج یک بستهٔ PHAR در یک دایرکتوری.

آرگومان‌های الزامی:

-f file
file مربوط به phar را برای کار بر روی آن مشخص می‌کند.

آرگومان‌های اختیاری:

-i regex
یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند.
-x regex
عبارت باقاعده برای مستثنی کردن فایل‌های ورودی.
...
دایرکتوری مقصد برای استخراج (پیش‌فرض '.' است).

این راهنما یا راهنمای یک دستور انتخاب‌شده.

آرگومان‌های اختیاری:

...
دستور اختیاری برای دریافت راهنمای آن.

دستورهای موجود را فهرست می‌کند.

دریافت اطلاعات دربارهٔ یک بستهٔ PHAR.

با استفاده از -k، بازگرداندن تنها یک مقدار امکان‌پذیر است.

آرگومان‌های الزامی:

-f file
file مربوط به phar را برای کار بر روی آن مشخص می‌کند.

آرگومان‌های اختیاری:

-k index
اندیس (index) اشتراک برای کار بر روی آن.

فهرست کردن محتویات یک آرشیو PHAR.

آرگومان‌های الزامی:

-f file
file مربوط به phar را برای کار بر روی آن مشخص می‌کند.

آرگومان‌های اختیاری:

-i regex
یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند.
-x regex
عبارت باقاعده برای مستثنی کردن فایل‌های ورودی..SH "دستور meta-del (meta-del command)" حذف فراداده‌های یک مدخل PHAR یا یک بستهٔ PHAR.

اگر -k مشخص شده باشد، انتظار می‌رود که فراداده یک آرایه باشد و نمایهٔ مشخص‌شده حذف می‌شود.

اگر موردی حذف شود مقدار بازگشتی 0 است، در غیر این صورت 1 خواهد بود.

آرگومان‌های الزامی:

-f file
file مربوط به phar را برای کار روی آن مشخص می‌کند.

آرگومان‌های اختیاری:

-e entry
نام entry برای کار روی آن (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد).
-k index
نمایهٔ (index) برای کار روی آن.

دریافت فراداده‌های یک مدخل PHAR یا یک بستهٔ PHAR در قالب سریال‌شده (serialized). اگر هیچ فایل خروجی برای فراداده مشخص نشده باشد، از stdout استفاده می‌شود. همچنین می‌توانید با استفاده از -k یک نمایهٔ خاص را مشخص کنید. در این حالت انتظار می‌رود که فراداده یک آرایه باشد و مقدار نمایهٔ مشخص‌شده به‌جای استفاده از serialize، با استفاده از echo بازگردانده می‌شود. اگر آن نمایه وجود نداشته باشد یا هیچ فراداده‌ای موجود نباشد، مقدار بازگشتی 1 خواهد بود.

آرگومان‌های الزامی:

-f file
file مربوط به phar را برای کار روی آن مشخص می‌کند.

آرگومان‌های اختیاری:

-e entry
نام entry برای کار روی آن (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد).
-k index
نمایهٔ (index) برای کار روی آن.

تنظیم فراداده‌های یک مدخل PHAR یا یک بستهٔ PHAR با استفاده از ورودی سریال‌شده. اگر هیچ فایل ورودی برای فراداده مشخص نشده باشد، از stdin استفاده می‌شود. همچنین می‌توانید با استفاده از -k یک نمایهٔ خاص را مشخص کنید. در این حالت انتظار می‌رود که فراداده یک آرایه باشد و مقدار نمایهٔ مشخص‌شده تنظیم می‌شود. اگر فراداده وجود نداشته باشد یا خالی باشد، یک آرایهٔ جدید ایجاد خواهد شد. اگر فراداده موجود بوده و یک مقدار تخت (flat value) باشد، مقدار بازگشتی 1 خواهد بود. همچنین با استفاده از -k، ورودی به‌جای این‌که سریال شود، مستقیماً دریافت می‌شود.

آرگومان‌های الزامی:

-f file
file مربوط به phar را برای کار روی آن مشخص می‌کند.
-m meta
فراداده جهت ذخیره به همراه مدخل (داده‌های php سریال‌شده).

آرگومان‌های اختیاری:

-e entry
نام entry برای کار روی آن (در صورت وجود، باید شامل نام دایرکتوری داخلی PHAR باشد).
-k index
نمایهٔ (index) برای کار روی آن..SH "دستور pack (pack command)" بسته‌بندی فایل‌ها در یک بایگانی PHAR.

هنگام استفاده از -s <stub>، فایل stub از فهرست فایل‌ها/دایرکتوری‌های ورودی کنار گذاشته می‌شود. برای ساخت یک بایگانی حاوی کلاس PEAR به نام PHP_Archive، آرگومان -p را به PHP/Archive.php ارجاع دهید.

آرگومان‌های ضروری:

-f file
file مربوط به phar را برای کار با آن مشخص می‌کند.
...
هر تعداد فایل و دایرکتوری ورودی. اگر -i استفاده شود، تنها فایل‌های منطبق با عبارت باقاعده داده‌شده بسته‌بندی می‌شوند. اگر -x مشخص شود، فایل‌های منطبق با آن عبارت باقاعده بسته‌بندی نخواهند شد.

آرگومان‌های اختیاری:

-a alias
یک نام مستعار (alias) برای فایل phar تعیین می‌کند.
-b bang
خط hash-bang برای آغاز بایگانی (مانند #!/usr/bin/php). خود علامت هش '#!' و نویسه خط جدید اختیاری هستند.
-c algo
الگوریتم فشرده‌سازی (نگاه کنید به COMPRESSION )
-h hash
الگوریتم hash را انتخاب می‌کند (نگاه کنید به HASH )
-i regex
یک عبارت باقاعده برای فایل‌های ورودی مشخص می‌کند.
-l level
تعداد زیردایرکتوری‌های ابتدایی برای حذف از مدخل‌های فایل
-p loader
مکان فایل کلاس PHP_Archive (دستور pear list-files PHP_Archive). می‌توانید از '0' یا '1' برای یافتن خودکار آن با دستور ذکرشده pear استفاده کنید. هنگام استفاده از '0'، در صورتی که فایل کلاس پیدا نشود، دستور با خطا متوقف نمی‌شود. این سوییچ همچنین کدی در اطراف stub اضافه می‌کند تا در صورت نیاز، کلاس PHP_Archive به عنوان stream wrapper برای phar:// ثبت شود. و در نهایت این سوییچ فایل phar.inc را از این بسته اضافه کرده و بارگذاری می‌کند تا از در دسترس بودن کلاس Phar اطمینان حاصل شود.
-s stub
فایل stub را انتخاب می‌کند.
-x regex
عبارت باقاعده برای فایل‌های ورودی جهت کنار گذاشته شدن.
-y key
کلید خصوصی (key) برای امضای OpenSSL.

تنظیم الگوریتم درهم‌سازی امضا.

آرگومان‌های ضروری:

-f file
file مربوط به phar را برای کار با آن مشخص می‌کند.
-h hash
الگوریتم hash را انتخاب می‌کند (نگاه کنید به HASH )

آرگومان‌های اختیاری:

-y key
کلید خصوصی (key) برای امضای OpenSSL..SH "دستور stub-get (stub-get command)" دریافت استاب (stub) یک فایل PHAR. اگر هیچ فایل خروجی به عنوان stub مشخص نشود، از stdout استفاده خواهد شد.

آرگومان‌های ضروری:

-f file
مشخص کردن فایل phar (file) برای پردازش.

آرگومان‌های اختیاری:

-s stub
انتخاب فایل stub.

تنظیم استاب (stub) یک فایل PHAR. اگر هیچ فایل ورودی به عنوان stub مشخص نشود، از stdin استفاده خواهد شد.

آرگومان‌های ضروری:

-f file
مشخص کردن فایل phar (file) برای پردازش.

آرگومان‌های اختیاری:

-b bang
خط Hash-bang برای شروع آرشیو (مانند ‎#!/usr/bin/php). خود علامت هش «#!» و نویسه خط جدید اختیاری هستند.
-p loader
محل فایل کلاس PHP_Archive (با دستور pear list-files PHP_Archive). می‌توانید از '0' یا '1' برای تعیین خودکار مکان آن با استفاده از دستور ذکر شده pear استفاده کنید. در صورت استفاده از این گزینه همچنین کدی را پیرامون stub اضافه می‌کند تا در صورت نیاز، کلاس PHP_Archive به عنوان stream wrapper پروتکل phar:// ثبت شود. در نهایت، این گزینه فایل phar.inc را از این بسته اضافه و بارگذاری می‌کند تا از در دسترس بودن کلاس Phar اطمینان حاصل شود.
-s stub
انتخاب فایل stub.

دریافت درخت دایرکتوری برای یک آرشیو PHAR.

آرگومان‌های ضروری:

-f file
مشخص کردن فایل phar (file) برای پردازش.

آرگومان‌های اختیاری:

-i regex
مشخص کردن یک عبارت منظم (regex) برای فایل‌های ورودی.
-x regex
عبارت منظم (regex) برای مستثنی کردن فایل‌های ورودی.

دریافت اطلاعات درباره محیط PHAR و نسخه ابزار.

الگوریتم‌ها:

0
بدون فشرده‌سازی
none
بدون فشرده‌سازی
auto
انتخاب خودکار الگوریتم فشرده‌سازی
gz
فشرده‌سازی GZip
gzip
فشرده‌سازی GZip
bz2
فشرده‌سازی BZip2
bzip2
فشرده‌سازی BZip2.SH "هش (HASH)" الگوریتم‌ها:
md5
MD5
sha1
SHA1
sha256
SHA256
sha512
SHA512
openssl
OpenSSL با استفاده از SHA-1
openssl_sha256
OpenSSL با استفاده از SHA-256
openssl_sha512
OpenSSL با استفاده از SHA-512

برای توضیحات کم‌وبیش کامل دربارهٔ PHAR اینجا را ببینید:

https://www.php.net/phar

می‌توانید فهرست باگ‌های شناخته‌شده را مشاهده کنید یا هر باگ جدیدی را که یافتید در اینجا گزارش دهید:

https://github.com/php/php-src/issues

The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski.

توسعهٔ بایگانی PHP توسط Gregory Beaver و Marcus Boerger انجام شده است.

فهرست توسعه‌دهندگان فعال را می‌توانید در اینجا بیابید:

https://www.php.net/credits.php

و در نهایت، PHP به کمک خیل عظیمی از مشارکت‌کنندگان در سراسر جهان توسعه یافته است.

این صفحه راهنما phar، نسخهٔ 8.5.10 را شرح می‌دهد.

حق نشر © The PHP Group

این فایل منبع مشمول نسخهٔ 3.01 از مجوز PHP است که همراه با این بسته در فایل LICENSE ارائه شده و از طریق وب جهان‌گستر در نشانی زیر در دسترس است:

https://www.php.net/license/3_01.txt

اگر نسخه‌ای از مجوز PHP دریافت نکرده‌اید و قادر به دریافت آن از طریق وب نیستید، لطفاً پیامی به license@php.net ارسال کنید تا بلافاصله یک نسخه را برای شما بفرستیم.

2024 The PHP Group